Index: /trunk/doc/manual/en_US/user_BasicConcepts.xml =================================================================== --- /trunk/doc/manual/en_US/user_BasicConcepts.xml (revision 51256) +++ /trunk/doc/manual/en_US/user_BasicConcepts.xml (revision 51257) @@ -370,5 +370,5 @@ - Snapshot folder + Snapshot Folder @@ -381,5 +381,5 @@ - Shared clipboard + Shared Clipboard @@ -396,5 +396,5 @@ details. - The shared clipboard is disabled by default. See + The shared clipboard is disabled by default. See for an explanation. This setting can be changed at any time using the "Shared Clipboard" @@ -406,27 +406,33 @@ Drag'n'Drop - This setting allows to enable Drag and Drop: Select a file - on the desktop, click the left mouse button, move the mouse - to the VM window and release the mouse button. The file is - copied from the host to the guest. This feature is currently - only implemented for Linux guests and only for copying files - from the host to the guest.Support - for Drag'n'Drop was added with VirtualBox 4.2 + This setting allows to enable support for drag'n drop: Select + an object (e.g. a file) from the host or guest and directly copy + or open it on the guest or host. Multiple per-VM drag'n drop modes + allow restricting access in either direction. + + For drag'n drop to work the Guest Additions need to be + installed on the guest. + + Drag'n drop is disabled by default. This setting can be + changed at any time using the "Drag'n'Drop" menu item in the + "Devices" menu of the virtual machine. + + See for more information. + + Experimental support for drag and drop was added + with VirtualBox 4.2. - Removable media: remember runtime changes - + Removable Media If this is checked, VirtualBox will save the state of what - media has been mounted between several runs of a virtual - machine. + media has been mounted between several runs of a virtual machine. - Mini toolbar - + Mini ToolBar In full screen or seamless mode, VirtualBox can display a @@ -717,5 +723,5 @@ as of the activation of 3D acceleration and 2D video acceleration. A rough estimate - is (color depth / 8) x + is (color depth / 8) x vertical pixels x horizontal pixels x @@ -1027,6 +1033,6 @@ equipped with one or two serial ports (also called COM ports by DOS and Windows). Serial ports were commonly used with modems, and some - computer mice used to be connected to serial ports before USB became - commonplace. + computer mice used to be connected to serial ports before USB became + commonplace. @@ -1042,5 +1048,5 @@ If a virtual serial port is enabled, the guest operating system sees a standard 16550A compatible UART device. Both receiving and transmitting - data is supported. How this virtual serial port is then connected to the + data is supported. How this virtual serial port is then connected to the host is configurable, and the details depend on your host operating system. @@ -1053,5 +1059,5 @@ --uartmode options. - In either case, you can configure up to two virtual serial ports per + In either case, you can configure up to two virtual serial ports per virtual machine. For each such device, you will need to determine @@ -1113,8 +1119,8 @@ On a Windows host, data will be sent and received through a named pipe. The pipe name must be in the format - \\.\pipe\<name> + \\.\pipe\<name> where <name> should - identify the virtual machine but may be freely - chosen. + identify the virtual machine but may be freely + chosen. For forwarding serial traffic, you can use a helper program called VMware Serial Line Gateway, available for @@ -1132,10 +1138,10 @@ On a Mac, Linux or Solaris host, a local domain socket is used instead. The socket filename must be - chosen such that the user running VirtualBox has - sufficient privileges to create and write to it. The - /tmp directory is often a + chosen such that the user running VirtualBox has + sufficient privileges to create and write to it. The + /tmp directory is often a good candidate. - On Linux there are various tools which can connect - to a local domain socket or create one in server mode. The + On Linux there are various tools which can connect + to a local domain socket or create one in server mode. The most flexible tool is socat and is available @@ -1153,5 +1159,5 @@ For a direct connection between two virtual machines - (corresponding to a null-modem cable), simply configure one VM + (corresponding to a null-modem cable), simply configure one VM to create a pipe/socket and another to attach to it. @@ -1159,8 +1165,8 @@ - You can send the virtual serial port output to a file. - This option is very useful for capturing diagnostic output from - a guest. Any file may be used for this purpose, as long as the - user running VirtualBox has sufficient privileges to create and + You can send the virtual serial port output to a file. + This option is very useful for capturing diagnostic output from + a guest. Any file may be used for this purpose, as long as the + user running VirtualBox has sufficient privileges to create and write to the file. @@ -1168,8 +1174,8 @@ - Up to two serial ports can be configured per virtual + Up to two serial ports can be configured per virtual machine, but you can pick any port numbers out of the above. However, - serial ports cannot reliably share interrupts; if both ports are to be - used at the same time, they must use different interrupt levels, for + serial ports cannot reliably share interrupts; if both ports are to be + used at the same time, they must use different interrupt levels, for example COM1 and COM2, but not COM1 and COM3. Index: /trunk/doc/manual/en_US/user_GuestAdditions.xml =================================================================== --- /trunk/doc/manual/en_US/user_GuestAdditions.xml (revision 51256) +++ /trunk/doc/manual/en_US/user_GuestAdditions.xml (revision 51257) @@ -1246,4 +1246,108 @@ manually.) + + + + Drag'n Drop + + Starting with version 4.4, VirtualBox supports to drag'n drop content + from the host to the guest and vice versa. For this to work the latest Guest + Additions must be installed on the guest. + + Drag'n drop transparently allows copying or opening files, directories + and even certain clipboard formats from one end to the other, e.g. from the + host to the guest or from the guest to the host. One then can perform drag'n + drop operations between the host and a VM as it would be a native drag'n drop + operation on the host OS. + + At the moment drag'n drop is implemented for Windows- and X-Windows-based + systems, both, on host and guest side. As X-Windows sports different drag'n drop + protocols only the most used one, XDND, is supported for now. Applications using + other protocols (such as Motif or OffiX) will not be recognized by VirtualBox. + + In context of using drag'n drop the origin of the data is called + source, that is, where the actual data comes + from and is specified. On the other hand there is the + target, which specifies where the data from + the source should go to. Transferring data from the source to the target can + be done in various ways, e.g. copying, moving or linking.At + the moment VirtualBox only copying data is supported. Moving or linking from + data currently is not implemented yet. + + When transferring data from the host to the guest OS, the host in this + case is the source, whereas the guest OS is the target. However, when doing + it the other way around, that is, transferring data from the guest OS to the + host, the guest OS this time became the source and the host is the target. + + For security reasons drag'n drop can be configured at runtime + on a per-VM basis either using the "Drag'n'Drop" menu item in the "Devices" menu + of the virtual machine or VBoxManage: The following four modes are available: + + + + + + + + + + Disabled disables the drag'n drop + entirely. This is the default when creating new VMs. + + + Host To Guest enables performing + drag'n drop operations from the host to the guest only. + + + Guest To Host enables performing + drag'n drop operations from the guest to the host only. + + + Bidirectional enables performing + drag'n drop operations to both directions, e.g. from the host to the guest + and vice versa. + + + + Drag'n drop support depends on the frontend being used; at the + moment only the VirtualBox Manager frontend provides this + functionality. + + To use VBoxManage for controlling the current drag'n drop mode, see . The commands modifyvm + and controlvm allow setting the VM's current + drag'n drop mode via command line. + + + Supported formats + + As VirtualBox can run on a variety of host OSes and also supports a wide + range of guests, certain data formats must be translated after those + got transfered over so that the target OS (that is, the side which receiving the + data) is able to handle them in an appropriate manner. + + When dragging files however, no data conversion is done in any way, e.g. + when transferring a file from a Linux guest to a Windows host the Linux-specific + line endings won't be converted to Windows ones. + + The following formats are handled by the VirtualBox drag'n drop service: + + + Plain text, from applications such as + text editors, internet browsers and terminal windows + + + Files, from file managers such + as Windows explorer, Nautilus and Finder + + + Directories, where the same applies + as for files + + + + + Index: /trunk/doc/manual/en_US/user_VBoxManage.xml =================================================================== --- /trunk/doc/manual/en_US/user_VBoxManage.xml (revision 51256) +++ /trunk/doc/manual/en_US/user_VBoxManage.xml (revision 51257) @@ -938,7 +938,8 @@ - Serial port, audio, clipboard and USB settings - - The following other hardware settings are available through + Miscellaneous settings + + The following other hardware settings, such as serial port, audio, + clipboard, drag'n drop, monitor and USB settings are available through VBoxManage modifyvm: @@ -1008,7 +1009,16 @@ --clipboard disabled|hosttoguest|guesttohost|bidirectional: - With this setting, you can select whether the guest operating - system's clipboard should be shared with the host; see . This requires that the Guest + With this setting, you can select if and how the guest or host + operating system's clipboard should be shared with the host or guest; + see . This requires that the Guest + Additions be installed in the virtual machine. + + + + --draganddrop + disabled|hosttoguest|guesttohost|bidirectional: + With this setting, you can select the current drag'n drop mode + being used between the host and the virtual machine; + see . This requires that the Guest Additions be installed in the virtual machine. @@ -1032,4 +1042,6 @@ + + @@ -1048,4 +1060,6 @@ default. + + @@ -1510,4 +1524,6 @@ + + The setlinkstate<1-N> @@ -1534,4 +1550,41 @@ + With the "nictrace" options, you can optionally trace + network traffic by dumping it to a file, for debugging + purposes. + + With --nictrace<1-N> + on|off, you can enable network tracing for a + particular virtual network card. + + If enabled, you must specify with + --nictracefile<1-N> + <filename> what file the trace should be + logged to. + + + + + + nicproperty<1-N> + <paramname>="paramvalue": + This option, in combination with "nicgenericdrv" allows you to + pass parameters to rarely-used network backends. + Those parameters are backend engine-specific, and are different + between UDP Tunnel and the VDE backend drivers. For example, + please see . + + + + + The guestmemoryballoon + operation changes the size of the guest memory balloon, that is, + memory allocated by the VirtualBox Guest Additions from the guest + operating system and returned to the hypervisor for re-use by other + virtual machines. This must be specified in megabytes. For details, + see . + + + usbattach and usbdettach make host USB devices @@ -1542,4 +1595,22 @@ You can use VBoxManage list usbhost to locate this information. + + + + clipboard + disabled|hosttoguest|guesttohost|bidirectional: + With this setting, you can select if and how the guest or host + operating system's clipboard should be shared with the host or guest; + see . This requires that the Guest + Additions be installed in the virtual machine. + + + + draganddrop + disabled|hosttoguest|guesttohost|bidirectional: + With this setting, you can select the current drag'n drop mode + being used between the host and the virtual machine; + see . This requires that the Guest + Additions be installed in the virtual machine. @@ -1558,4 +1629,5 @@ + setvideomodehint requests that @@ -1570,4 +1642,6 @@ + + The setcredentials operation is @@ -1576,11 +1650,13 @@ + + - The guestmemoryballoon - operation changes the size of the guest memory balloon, that is, - memory allocated by the VirtualBox Guest Additions from the guest - operating system and returned to the hypervisor for re-use by other - virtual machines. This must be specified in megabytes. For details, - see . + --plugcpu|unplugcpu + <id>: If CPU hot-plugging is enabled, this adds + a virtual CPU to the virtual machines (or removes one). + <id> specifies the index of + the virtual CPU to be added or removed and must be a number from 0 + to the maximum no. of CPUs configured. CPU 0 can never be removed. @@ -1591,4 +1667,7 @@ can use up to 50% of a single host CPU. + + + @@ -2733,6 +2812,6 @@ VBoxManage guestcontrol - The "guestcontrol" commands allow you to control certain things - inside a guest from the host. Please see The guestcontrol commands allow you + to control certain things inside a guest from the host. Please see for an introduction.