From 4409faa3499a369c98ec613eb457b68bd1c5be89 Mon Sep 17 00:00:00 2001 From: Patrick Donnelly Date: Mon, 15 Jul 2024 10:12:24 -0400 Subject: [PATCH] doc: clarify superuser note for ceph-fuse Signed-off-by: Patrick Donnelly (cherry picked from commit d100de9c9ce884beee6e9551b2b221c686b775b5) --- doc/cephfs/mount-using-fuse.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/cephfs/mount-using-fuse.rst b/doc/cephfs/mount-using-fuse.rst index f3ac054c9be15..31ef9e3472b5f 100644 --- a/doc/cephfs/mount-using-fuse.rst +++ b/doc/cephfs/mount-using-fuse.rst @@ -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 ======== -- 2.39.5