diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-16 22:55:45 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-16 22:55:45 +0000 |
| commit | 04aecf1372d30eb709d8de65152535ab66dcb74a (patch) | |
| tree | d1e4d8c453a76465e8b63119314a28d39b474479 /doc/manual/en_US/user_GuestAdditions.xml | |
| parent | Adding upstream version 7.0.14-dfsg. (diff) | |
| download | virtualbox-04aecf1372d30eb709d8de65152535ab66dcb74a.tar.xz virtualbox-04aecf1372d30eb709d8de65152535ab66dcb74a.zip | |
Adding upstream version 7.0.16-dfsg.upstream/7.0.16-dfsg
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'doc/manual/en_US/user_GuestAdditions.xml')
| -rw-r--r-- | doc/manual/en_US/user_GuestAdditions.xml | 27 |
1 files changed, 22 insertions, 5 deletions
diff --git a/doc/manual/en_US/user_GuestAdditions.xml b/doc/manual/en_US/user_GuestAdditions.xml index f2d4d5d9..ff5284be 100644 --- a/doc/manual/en_US/user_GuestAdditions.xml +++ b/doc/manual/en_US/user_GuestAdditions.xml @@ -1287,8 +1287,9 @@ <listitem> <para> - Currently only Linux and Oracle Solaris Guest Additions - support symlinks. + The guest VM must have a version of the Guest Additions + installed which supports symlinks. Currently only the Linux and + Oracle Solaris Guest Additions support symlinks. </para> </listitem> @@ -1296,15 +1297,31 @@ <para> For security reasons the guest OS is not allowed to create symlinks by default. If you trust the guest OS to not abuse - the functionality, you can enable creation of symlinks for a - shared folder as follows: + the functionality, you can enable the creation of symlinks for + a shared folder as follows: </para> -<screen>VBoxManage setextradata "VM name" VBoxInternal2/SharedFoldersEnableSymlinksCreate/<replaceable>sharename</replaceable> 1</screen> +<screen>VBoxManage setextradata <replaceable>VM-name</replaceable> VBoxInternal2/SharedFoldersEnableSymlinksCreate/<replaceable>sharename</replaceable> 1</screen> </listitem> </itemizedlist> + <para> + If a symbolic link is created inside a shared folder on the host + and the installed Guest Additions don't support symbolic links + then the guest will see the target of the symlink as a file + inside the shared folder. For example, if a symlink is created + to a file on a Linux host: + </para> + +<screen>$ cd /SharedFolder && ln -s filename symlink-to-filename</screen> + + <para> + And then the shared folder is viewed on a Windows guest there + will be two identical files listed, <emphasis>filename</emphasis> + and <emphasis>symlink-to-filename</emphasis>. + </para> + <sect2 id="sf_mount_manual"> <title>Manual Mounting</title> |