| 1 | <?xml version="1.0" encoding="UTF-8"?>
|
|---|
| 2 | <!DOCTYPE topic
|
|---|
| 3 | PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 4 | <topic xml:lang="en-us" id="sf_mount_manual">
|
|---|
| 5 | <title>Manual Mounting</title>
|
|---|
| 6 |
|
|---|
| 7 | <body>
|
|---|
| 8 | <p>
|
|---|
| 9 | You can mount the shared folder from inside a VM, in the same
|
|---|
| 10 | way as you would mount an ordinary network share:
|
|---|
| 11 | </p>
|
|---|
| 12 | <ul>
|
|---|
| 13 | <li>
|
|---|
| 14 | <p>
|
|---|
| 15 | In a Windows guest, shared folders are browseable and
|
|---|
| 16 | therefore visible in Windows Explorer. To attach the host's
|
|---|
| 17 | shared folder to your Windows guest, open Windows Explorer
|
|---|
| 18 | and look for the folder in <b outputclass="bold">My
|
|---|
| 19 | Networking Places</b>, <b outputclass="bold">Entire
|
|---|
| 20 | Network</b>, <b outputclass="bold"><ph conkeyref="vbox-conkeyref-phrases/product-name"/>
|
|---|
| 21 | Shared Folders</b>. By right-clicking on a shared
|
|---|
| 22 | folder and selecting <b outputclass="bold">Map Network
|
|---|
| 23 | Drive</b> from the menu that pops up, you can assign
|
|---|
| 24 | a drive letter to that shared folder.
|
|---|
| 25 | </p>
|
|---|
| 26 | <p>
|
|---|
| 27 | Alternatively, on the Windows command line, use the
|
|---|
| 28 | following command:
|
|---|
| 29 | </p>
|
|---|
| 30 | <pre xml:space="preserve">net use x: \\vboxsvr\sharename</pre>
|
|---|
| 31 | <p>
|
|---|
| 32 | While <codeph>vboxsvr</codeph> is a fixed name, note that
|
|---|
| 33 | <codeph>vboxsrv</codeph> would also work, replace
|
|---|
| 34 | <varname>x:</varname> with the drive letter that you
|
|---|
| 35 | want to use for the share, and
|
|---|
| 36 | <varname>sharename</varname> with the share name
|
|---|
| 37 | specified with <userinput>VBoxManage</userinput>.
|
|---|
| 38 | </p>
|
|---|
| 39 | </li>
|
|---|
| 40 | <li>
|
|---|
| 41 | <p>
|
|---|
| 42 | In a Linux guest, use the following command:
|
|---|
| 43 | </p>
|
|---|
| 44 | <pre xml:space="preserve">mount -t vboxsf [-o OPTIONS] sharename mountpoint</pre>
|
|---|
| 45 | <p>
|
|---|
| 46 | To mount a shared folder during boot, add the following
|
|---|
| 47 | entry to <filepath>/etc/fstab</filepath>:
|
|---|
| 48 | </p>
|
|---|
| 49 | <pre xml:space="preserve">sharename mountpoint vboxsf defaults 0 0</pre>
|
|---|
| 50 | </li>
|
|---|
| 51 | <li>
|
|---|
| 52 | <p>
|
|---|
| 53 | In a Oracle Solaris guest, use the following command:
|
|---|
| 54 | </p>
|
|---|
| 55 | <pre xml:space="preserve">mount -F vboxfs [-o OPTIONS] sharename mountpoint</pre>
|
|---|
| 56 | <p>
|
|---|
| 57 | Replace <varname>sharename</varname>, use a
|
|---|
| 58 | lowercase string, with the share name specified with
|
|---|
| 59 | <userinput>VBoxManage</userinput> or <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/>. Replace
|
|---|
| 60 | <varname>mountpoint</varname> with the path where
|
|---|
| 61 | you want the share to be mounted on the guest, such as
|
|---|
| 62 | <filepath>/mnt/share</filepath>. The usual mount rules
|
|---|
| 63 | apply. For example, create this directory first if it does
|
|---|
| 64 | not exist yet.
|
|---|
| 65 | </p>
|
|---|
| 66 | <p>
|
|---|
| 67 | Here is an example of mounting the shared folder for the
|
|---|
| 68 | user jack on Oracle Solaris:
|
|---|
| 69 | </p>
|
|---|
| 70 | <pre xml:space="preserve">$ id
|
|---|
| 71 | uid=5000(jack) gid=1(other)
|
|---|
| 72 | $ mkdir /export/home/jack/mount
|
|---|
| 73 | $ pfexec mount -F vboxfs -o uid=5000,gid=1 jackshare /export/home/jack/mount
|
|---|
| 74 | $ cd ~/mount
|
|---|
| 75 | $ ls
|
|---|
| 76 | sharedfile1.mp3 sharedfile2.txt
|
|---|
| 77 | $</pre>
|
|---|
| 78 | <p>
|
|---|
| 79 | Beyond the standard options supplied by the
|
|---|
| 80 | <userinput>mount</userinput> command, the following are
|
|---|
| 81 | available:
|
|---|
| 82 | </p>
|
|---|
| 83 | <pre xml:space="preserve">iocharset CHARSET</pre>
|
|---|
| 84 | <p>
|
|---|
| 85 | This option sets the character set used for I/O operations.
|
|---|
| 86 | Note that on Linux guests, if the
|
|---|
| 87 | <codeph>iocharset</codeph> option is not specified, then
|
|---|
| 88 | the Guest Additions driver will attempt to use the character
|
|---|
| 89 | set specified by the CONFIG_NLS_DEFAULT kernel option. If
|
|---|
| 90 | this option is not set either, then UTF-8 is used.
|
|---|
| 91 | </p>
|
|---|
| 92 | <pre xml:space="preserve">convertcp CHARSET</pre>
|
|---|
| 93 | <p>
|
|---|
| 94 | This option specifies the character set used for the shared
|
|---|
| 95 | folder name. This is UTF-8 by default.
|
|---|
| 96 | </p>
|
|---|
| 97 | <p>
|
|---|
| 98 | The generic mount options, documented in the
|
|---|
| 99 | <userinput>mount</userinput> manual page, apply also. Especially
|
|---|
| 100 | useful are the options <codeph>uid</codeph>,
|
|---|
| 101 | <codeph>gid</codeph> and <codeph>mode</codeph>, as they
|
|---|
| 102 | can allow access by normal users in read/write mode,
|
|---|
| 103 | depending on the settings, even if root has mounted the
|
|---|
| 104 | filesystem.
|
|---|
| 105 | </p>
|
|---|
| 106 | </li>
|
|---|
| 107 | <li>
|
|---|
| 108 | <p>
|
|---|
| 109 | In an OS/2 guest, use the <userinput>VBoxControl</userinput>
|
|---|
| 110 | command to manage shared folders. For example:
|
|---|
| 111 | </p>
|
|---|
| 112 | <pre xml:space="preserve">VBoxControl sharedfolder use D: MyShareName
|
|---|
| 113 | VBoxControl sharedfolder unuse D:
|
|---|
| 114 | VBoxControl sharedfolder list</pre>
|
|---|
| 115 | <p> As with Windows guests, shared folders can also be accessed using UNC ,
|
|---|
| 116 | with <filepath>\\VBoxSF\</filepath>, <filepath>\\VBoxSvr\</filepath> or
|
|---|
| 117 | <filepath>\\VBoxSrv\</filepath> as the server name and the shared folder name as
|
|---|
| 118 | <varname>sharename</varname>. </p>
|
|---|
| 119 | </li>
|
|---|
| 120 | </ul>
|
|---|
| 121 | </body>
|
|---|
| 122 |
|
|---|
| 123 | </topic>
|
|---|
