]> 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)
committerPatrick Donnelly <pdonnell@redhat.com>
Mon, 15 Jul 2024 14:12:52 +0000 (10:12 -0400)
Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
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
 ========