diff options
author | Corinna Vinschen <corinna@vinschen.de> | 2020-04-03 22:44:00 +0300 |
---|---|---|
committer | Corinna Vinschen <corinna@vinschen.de> | 2020-04-03 22:44:00 +0300 |
commit | 44fe41a766b1f4dbb6d2f16523aea3507d10b6ef (patch) | |
tree | 8054357c09aa5584d68969de99c9e7844b0f45d6 /winsup/doc/faq-using.xml | |
parent | 44da5e4b8c89bfcee79eb83fd3b7142720489940 (diff) |
Cygwin: docs: revamp docs explaining symlinks
The descriptions of symlink handling are a bit dated, so
revamp them and add the new WSL symlink type.
Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
Diffstat (limited to 'winsup/doc/faq-using.xml')
-rw-r--r-- | winsup/doc/faq-using.xml | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml index 4fca00525..4c6d8c76d 100644 --- a/winsup/doc/faq-using.xml +++ b/winsup/doc/faq-using.xml @@ -853,7 +853,7 @@ because they do not always work on Samba drives. Also, mounts are faster to process because no disk access is required to resolve them. </para> <para>Note that non-cygwin applications will not observe Cygwin mounts (or -symlinks for that matter). For example, if you use WinZip to unpack the +most symlinks for that matter). For example, if you use WinZip to unpack the tar distribution of a Cygwin package, it may not get installed to the correct Cygwin path. <emphasis>So don't do this!</emphasis> </para> @@ -967,10 +967,10 @@ set you're using in future.</para> <question><para>Why don't symlinks work on Samba-mounted filesystems?</para></question> <answer> -<para>Symlinks are marked with "system" file attribute. Samba does not -enable this attribute by default. To enable it, consult your Samba -documentation and then add these lines to your samba configuration -file: +<para>Default symlinks on Samba are marked with DOS SYSTEM file +attribute. Samba does not enable this attribute by default. To enable +it, consult your Samba documentation and then add these lines to your +samba configuration file: </para> <screen> map system = yes @@ -980,8 +980,10 @@ file: <para>Note that the 0775 can be anything as long as the 0010 bit is set. </para> <para>Alternatively, use Windows shortcuts as symlinks. See the CYGWIN -environment variable option "winsymlinks" +environment variable option "winsymlinks:lnk" <ulink url="https://cygwin.com/cygwin-ug-net/using-cygwinenv.html"/> +Note that Samba does not support reparse points so some methods to +create symlinks are just not available. </para> </answer></qandaentry> |