From f78a09de0a877b19ba12b0721fa0548118b1f748 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Niklas=20Hamb=C3=BCchen?= Date: Sat, 27 Dec 2025 14:05:19 +0100 Subject: [PATCH] doc: Document that client_dirsize_rbytes confuses rsync MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit 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 --- doc/man/8/mount.ceph.rst | 2 +- src/common/options/mds-client.yaml.in | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) 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 -- 2.47.3