libs/newlib-cygwin
libs/newlib-cygwin
4
0
Fork 0
mirror of git://sourceware.org/git/newlib-cygwin.git synced 2025-01-19 04:49:25 +08:00
Code Issues Projects Releases Wiki Activity

* cygwinenv.sgml: Add text for `winsymlinks' option.

Browse Source 
* how-api.texinfo: Add text to explain new symlinks==shortcuts
        and the CYGWIN setting `(no)winsymlinks'.
        * how-using.texinfo: Add text that Cygwin now treats shortcuts
        as symlinks.
This commit is contained in:
Corinna Vinschen 2001-03-02 12:05:31 +00:00
parent e03f5f7338
commit 75c566fc64
4 changed files with 48 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
winsup/doc/ChangeLog
View File

@ -1,3 +1,11 @@
Fri Mar 2 12:42:00 2001 Corinna Vinschen <corinna@vinschen.de>
* cygwinenv.sgml: Add text for `winsymlinks' option.
* how-api.texinfo: Add text to explain new symlinks==shortcuts
and the CYGWIN setting `(no)winsymlinks'.
* how-using.texinfo: Add text that Cygwin now treats shortcuts
as symlinks.
2001-02-07 Eric M. Monsler <emonsler@beamreachnetworks.com>
* setup2.sgml: Add docs about domain accounts.

6
winsup/doc/cygwinenv.sgml
View File

@ -93,5 +93,11 @@ expected instead of ^Z, and is settable via stty.
This option must be specified before starting a Cygwin shell
and it cannot be changed in the shell.</para>
</listitem>
<listitem>
<para><FirstTerm>(no)winsymlinks</FirstTerm> - if set, Cygwin creates
symlinks as Windows shortcuts with a special header and the R/O attribute
set. If not set, Cygwin creates symlinks as plain files with a magic number,
a path and the system attribute set. Defaults to set.</para>
</listitem>
</itemizedlist>
</sect1>

39
winsup/doc/how-api.texinfo
View File

@ -141,15 +141,36 @@ Beware: globbing uses @code{malloc}. If your application defines
@subsection How do symbolic links work?
Cygwin generates link files with a magic header. When
you open a file or directory that is a link to somewhere else, it
opens the file or directory listed in the magic header. Because we
don't want to have to open every referenced file to check symlink
status, Cygwin marks symlinks with the system attribute. Files
without the system attribute are not checked. Because remote samba
filesystems do not enable the system attribute by default, symlinks do
not work on network drives unless you explicitly enable this
attribute.
Cygwin knows of two ways to create symlinks.
The old method is the only valid one up to but not including version 1.3.0.
If it's enabled (from 1.3.0 on by setting `nowinsymlinks' in the environment
variable CYGWIN) Cygwin generates link files with a magic header. When you
open a file or directory that is a link to somewhere else, it opens the file
or directory listed in the magic header. Because we don't want to have to
open every referenced file to check symlink status, Cygwin marks symlinks
with the system attribute. Files without the system attribute are not
checked. Because remote samba filesystems do not enable the system
attribute by default, symlinks do not work on network drives unless you
explicitly enable this attribute.
The new method which is introduced with Cygwin version 1.3.0 is enabled
by default or if `winsymlinks' is set in the environment variable CYGWIN.
Using this method, Cygwin generates symlinks by creating Windows shortcuts.
Cygwin created shortcuts have a special header (which is in that way never
created by Explorer) and the R/O attribute set. A DOS path is stored in
the shortcut as usual and the description entry is used to store the POSIX
path. While the POSIX path is stored as is, the DOS path has perhaps to be
rearranged to result in a valid path. This may result in a divergence
between the DOS and the POSIX path when symlinks are moved crossing mount
points. When a user changes the shortcut, this will be detected by Cygwin
and it will only use the DOS path then. While Cygwin shortcuts are shown
without the ".lnk" suffix in `ls' output, non-Cygwin shortcuts are shown
with the suffix. However, both are treated as symlinks.
Both, the old and the new symlinks can live peacefully together since Cygwin
treats both as symlinks regardless of the setting of `(no)winsymlinks' in
the environment variable CYGWIN.
@subsection Why do some files, which are not executables have the 'x' type.

4
winsup/doc/how-using.texinfo
View File

@ -98,6 +98,8 @@ or
@subsection Why can't I cd into a shortcut to a directory?
This is only valid up to but not including version 1.3.0:
Cygwin does not follow MS Windows Explorer Shortcuts (*.lnk files). It
sees a shortcut as a regular file and this you cannot "cd" into it.
@ -106,6 +108,8 @@ with shortcuts. The major problem with this is that .LNK files would
then be used to symlink Cygwin paths that may or may not be valid
under native Win32 non-Cygwin applications such as Explorer.
Since version 1.3.0, Cygwin treats shortcuts as symlinks.
@subsection I'm having basic problems with find. Why?
Make sure you are using the find that came with Cygwin and that you