From: Niklas Hambüchen Date: Sat, 27 Dec 2025 13:05:19 +0000 (+0100) Subject: doc: Document that client_dirsize_rbytes confuses rsync X-Git-Tag: v21.0.1~76^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F66748%2Fhead;p=ceph.git doc: Document that client_dirsize_rbytes confuses rsync This is important to document because otherwise the immediate question one has is "why _wouldn't_ I enable this?". At the same time, being able to use tools like rsync is a common motivation for using CephFS. Unfortunately the only source to this I could find is the presentation "CephFS: Architecture Introduction & New Features" by Greg Farnum: https://ceph.io/assets/pdfs/events/2025/ceph-days-silicon-valley/10%20-%20Greg%20-%20CephFS.pdf Signed-off-by: Niklas Hambüchen --- diff --git a/doc/man/8/mount.ceph.rst b/doc/man/8/mount.ceph.rst index 6e960594fdd..ba4d0bb918c 100644 --- a/doc/man/8/mount.ceph.rst +++ b/doc/man/8/mount.ceph.rst @@ -165,7 +165,7 @@ Advanced :command:`rbytes` Report the recursive size of the directory contents for st_size on - directories. Default: off + directories. May confuse programs such as rsync. Default: off :command:`norbytes` Do not report the recursive size of the directory contents for diff --git a/src/common/options/mds-client.yaml.in b/src/common/options/mds-client.yaml.in index 3603c67393e..2e7ee29bc3b 100644 --- a/src/common/options/mds-client.yaml.in +++ b/src/common/options/mds-client.yaml.in @@ -320,7 +320,7 @@ options: desc: set the directory size as the number of file bytes recursively used long_desc: This option enables a CephFS feature that stores the recursive directory size (the bytes used by files in the directory and its descendents) in the st_size - field of the stat structure. + field of the stat structure. May confuse programs such as ``rsync``. default: true services: - mds_client