diff options
| author | Corinna Vinschen <corinna@vinschen.de> | 2023-04-03 23:41:07 +0300 |
|---|---|---|
| committer | Corinna Vinschen <corinna@vinschen.de> | 2023-04-03 23:41:07 +0300 |
| commit | be2749cd4eb6e7ea1b70eaf7cd78f683db21c8ec (patch) | |
| tree | 14f847e09a49055a0d226349b360f24fb223505a /winsup/doc | |
| parent | cc8404039f50c36100fbad85a3af22d579d3576a (diff) | |
Cygwin: chattr: fix description of requirements for casesensitive directories
Preconditions of WSL or empty directories dependent on Windows
versions was totally screwed up. Drop the description from
--help, describe the preconditions for case-sensitive dirs in the
man page instead.
Fixes: fc6e89c937c1 ("Cygwin: chattr: clarify requirements for casesensitive directories")
Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
Diffstat (limited to 'winsup/doc')
| -rw-r--r-- | winsup/doc/utils.xml | 22 |
1 files changed, 19 insertions, 3 deletions
diff --git a/winsup/doc/utils.xml b/winsup/doc/utils.xml index a90db5e66..0390db20f 100644 --- a/winsup/doc/utils.xml +++ b/winsup/doc/utils.xml @@ -89,11 +89,27 @@ content indexing service 'e', 'Encrypted': file is encrypted 'C', 'Casesensitive': directory is handled case sensitive - - local NTFS only - - Windows 10 1803 or later: requires installed WSL - - Windows 11: enabling requires empty dir </screen> </refsect1> + + <refsect1 id="chattr-Cprec"> + <title>Case-sensitive directories</title> + <para>Case-sensitive directories are supported starting with + Windows 10 1803. They are only supported on local NTFS filesystems. + </para> + <para>The system-wide availability of case-sensitive directories + depends on the setting of the registry value of type DWORD called + HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem\NtfsEnableDirCaseSensitivity. The value 0 disables case-sensitive directories. + The value 1 enables case-sensitive directories. The value 3 + enables case-sensitive directories, too, with the additional + requirement that a directory can only be set to case-sensitive + if it's empty. No other value is supported.</para> + <para>Removing case-sensitivity on a directory requires that the + directory does not contain files only differing by case.</para> + <para>Trying to access a case-sensitive directory on a remote NTFS leads + to all kinds of weird errors and is therefore + <emphasis>not</emphasis> recommended.</para> + </refsect1> </refentry> <refentry id="cygcheck"> |