| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="guestadd-clipboard">
|
|---|
| 4 | <title>Clipboard</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> enables you to copy clipboard content from the GUI on the host to the GUI on the guest, and vice versa. For this to work the latest version of the Guest Additions must be installed on the guest.</p>
|
|---|
| 8 | <p>For security reasons drag and drop can be configured at runtime on a per-VM basis either using the <b
|
|---|
| 9 | outputclass="bold">Shared Clipboard</b> menu item in the <b outputclass="bold">Devices</b> menu of the virtual
|
|---|
| 10 | machine, or the <userinput>VBoxManage</userinput> command. </p>
|
|---|
| 11 | <p>The following shared clipboard settings are available: </p>
|
|---|
| 12 | <ul id="ul_onq_r24_hcc">
|
|---|
| 13 | <li>
|
|---|
| 14 | <p><b outputclass="bold">Disabled</b>. Disables the copy feature entirely. This is the default when creating a
|
|---|
| 15 | new VM. </p>
|
|---|
| 16 | </li>
|
|---|
| 17 | <li>
|
|---|
| 18 | <p><b outputclass="bold">Host To Guest</b>. Enables text copy operations from the host to the guest only. </p>
|
|---|
| 19 | </li>
|
|---|
| 20 | <li>
|
|---|
| 21 | <p><b outputclass="bold">Guest To Host</b>. Enables text copy operations from the guest to the host only. </p>
|
|---|
| 22 | </li>
|
|---|
| 23 | <li>
|
|---|
| 24 | <p><b outputclass="bold">Bidirectional</b>. Enables text copy operations in both directions: from the host to
|
|---|
| 25 | the guest, and from the guest to the host. </p>
|
|---|
| 26 | </li>
|
|---|
| 27 | <li><b>Enable Clipboard File Transfers</b>. Allows files, in addition to text, to be copied to or from the VM. <ul>
|
|---|
| 28 | <li>
|
|---|
| 29 | <p>On Linux hosts and guests, Shared Clipboard file transfers are limited to files only, one file per transfer. Transferring symbolic links is not supported.</p>
|
|---|
| 30 | </li>
|
|---|
| 31 | <li>
|
|---|
| 32 | <p>Shared Clipboard file transfers are only tested and supported with the official default file managers of the guest and host operating systems.</p>
|
|---|
| 33 | </li>
|
|---|
| 34 | </ul></li>
|
|---|
| 35 | </ul>
|
|---|
| 36 | <p>To use the <userinput>VBoxManage</userinput> command to control the current clipboard mode, see <xref
|
|---|
| 37 | href="vboxmanage.dita#vboxmanage"/>. The <userinput>modifyvm</userinput> and <userinput>controlvm</userinput>
|
|---|
| 38 | commands enable setting of a VM's current clipboard mode from the command line.</p>
|
|---|
| 39 | </body>
|
|---|
| 40 | </topic>
|
|---|
