diff options
Diffstat (limited to 'winsup/doc/pathnames.sgml')
| -rw-r--r-- | winsup/doc/pathnames.sgml | 32 |
1 files changed, 23 insertions, 9 deletions
diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml index 86b537b7e..6234ee8f4 100644 --- a/winsup/doc/pathnames.sgml +++ b/winsup/doc/pathnames.sgml @@ -2,10 +2,15 @@ <sect2 id="pathnames-intro"><title>Introduction</title> -<para>Cygwin supports both Win32- and POSIX-style paths, where -directory delimiters may be either forward or back slashes. UNC -pathnames (starting with two slashes and a network name) are also -supported.</para> +<para>Cygwin supports both Win32- and POSIX-style paths. Directory +delimiters may be either forward slashes or backslashes. Paths using +backslashes are always handled as Win32 paths. POSIX paths must only +use forward slashes as delimiter, otherwise they are treated as Win32 +paths and file access might fail in surprising ways. Note that the +usage of Win32 paths, though possible, is deprecated, since it +circumvents important internal path handling mechanisms. UNC pathnames +(starting with two slashes and a network name) are also supported. +</para> <para>POSIX operating systems (such as Linux) do not have the concept of drive letters. Instead, all absolute paths begin with a @@ -71,6 +76,7 @@ posix=[0|1]. The meaning of the options is as follows.</para> implement real POSIX permissions (default). This flag only affects filesystems supporting ACLs (NTFS) and is ignored otherwise. + auto - Ignored. binary - Files default to binary mode (default). cygexec - Treat all files below mount point as cygwin executables. exec - Treat all files below mount point as executable. @@ -117,6 +123,14 @@ doing. In this case, use the <literal>override</literal> flag in the options field in the <filename>/etc/fstab</filename> file. Since this is a dangerous thing to do, do so at your own risk.</para> +<para><filename>/usr/bin</filename> and <filename>/usr/lib</filename> are +by default also automatic mount points generated by the Cygwin DLL similar +to the way the root directory is evaluated. <filename>/usr/bin</filename> +points to the directory the Cygwin DLL is installed in, +<filename>/usr/lib</filename> is suppsoed to point to the +<filename>/lib</filename> directory. This choice is safe and usually +shouldn't be changed. An fstab entry for them is not required.</para> + <para><literal>nouser</literal> mount points are not overridable by a later call to <command>mount</command>. Mount points given in <filename>/etc/fstab</filename> are by default @@ -181,12 +195,12 @@ arguments:</para> <title>Displaying the current set of mount points</title> <screen> <prompt>bash$</prompt> <userinput>mount</userinput> -f:/cygwin/bin on /usr/bin type system (binary) -f:/cygwin/lib on /usr/lib type system (binary) -f:/cygwin on / type system (binary) +f:/cygwin/bin on /usr/bin type system (binary,auto) +f:/cygwin/lib on /usr/lib type system (binary,auto) +f:/cygwin on / type system (binary,auto) e:/src on /usr/src type system (binary) -c: on /cygdrive/c type user (binary,noumount) -e: on /cygdrive/e type user (binary,noumount) +c: on /cygdrive/c type user (binary,posix=0,user,noumount,auto) +e: on /cygdrive/e type user (binary,posix=0,user,noumount,auto) </screen> </example> |