]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc: clarify superuser note for ceph-fuse
authorPatrick Donnelly <pdonnell@redhat.com>
Mon, 15 Jul 2024 14:12:24 +0000 (10:12 -0400)
committerZac Dover <zac.dover@proton.me>
Tue, 16 Jul 2024 04:54:02 +0000 (14:54 +1000)
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
(cherry picked from commit d100de9c9ce884beee6e9551b2b221c686b775b5)

doc/cephfs/mount-using-fuse.rst

index f3ac054c9be15d8a55c22e01e04f6000dd53ffa0..31ef9e3472b5f322afb6811905079d624900d6ec 100644 (file)
@@ -12,8 +12,11 @@ Prerequisites
 Go through the prerequisites required by both, kernel as well as FUSE mounts,
 in `Mount CephFS: Prerequisites`_ page.
 
-.. note:: Mounting CephFS using FUSE requires superuser privileges to trim dentries
-   by issuing a remount of itself.
+.. note:: Mounting CephFS using FUSE requires superuser privileges (sudo/root).
+          The libfuse interface does not provide a mechanism to trim cache entries in the
+          kernel so a remount (``mount(2)``) system call is required to force the kernel
+          to drop the cached metadata. ``ceph-fuse`` issues these remount system calls
+          periodically in response to cache pressure in the MDS or due to metadata cache revocations.
 
 Synopsis
 ========