From: Patrick Donnelly Date: Tue, 18 Mar 2025 15:24:52 +0000 (-0400) Subject: doc: add clarification note on how charmap is applied X-Git-Tag: testing/wip-pdonnell-testing-20250324.181635-debug~41^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=37b70581d896fa08075385460a416b860e3c0a0c;p=ceph-ci.git doc: add clarification note on how charmap is applied There was confusion about whether setting the charmap on a directory also affects the name of the directory itself. Signed-off-by: Patrick Donnelly --- diff --git a/doc/cephfs/charmap.rst b/doc/cephfs/charmap.rst index d49b2706778..208100f37c3 100644 --- a/doc/cephfs/charmap.rst +++ b/doc/cephfs/charmap.rst @@ -33,6 +33,9 @@ Note the following restrictions on manipulating any of these extended attributes New subdirectories created under a directory with a ``charmap`` configuration will inherit (copy) the parent's configuration. +.. note:: The charmap configuration applies only to the entries in the + directory not the name of the directory itself. + .. note:: You can remove a ``charmap`` on a subdirectory which inherited the configuration so long as the preconditions apply: it is empty and not part of an existing snapshot. @@ -101,10 +104,10 @@ configuration. Case Folding ------------ -The ``ceph.dir.casesensitive`` attribute accepts a boolean value. By -default, names are case-sensitive (as normal in a POSIX file system). Setting -this value to false will make the directory (and its children) -case-insensitive. +The ``ceph.dir.casesensitive`` attribute accepts a boolean value. By default, +names are case-sensitive (as normal in a POSIX file system). Setting this value +to false will make the named entries in the directory (and its descendent +directories) case-insensitive. Case folding requires that names are also normalized. By default, after setting a directory to be case-insensitive, the ``charmap`` will be: