diff options
| author | Zac Dover <zac.dover@proton.me> | 2024-07-16 06:49:28 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-07-16 06:49:28 +0200 |
| commit | f890abb06d6cddacb71f53d6a9b2be857d5308e9 (patch) | |
| tree | 3e34c08f2c37e9d28aaaf9909ae45b46e43d4d84 | |
| parent | Merge pull request #55265 from vshankar/wip-58878 (diff) | |
| parent | doc: elide superuser discussion from mount prereq (diff) | |
| download | ceph-f890abb06d6cddacb71f53d6a9b2be857d5308e9.tar.xz ceph-f890abb06d6cddacb71f53d6a9b2be857d5308e9.zip | |
Merge pull request #58596 from batrick/superuser-doc
doc: clarify superuser note for ceph-fuse
Reviewed-by: Zac Dover <zac.dover@proton.me>
| -rw-r--r-- | doc/cephfs/mount-prerequisites.rst | 15 | ||||
| -rw-r--r-- | doc/cephfs/mount-using-fuse.rst | 7 |
2 files changed, 12 insertions, 10 deletions
diff --git a/doc/cephfs/mount-prerequisites.rst b/doc/cephfs/mount-prerequisites.rst index d1acbe081fa..02b22fb9ac6 100644 --- a/doc/cephfs/mount-prerequisites.rst +++ b/doc/cephfs/mount-prerequisites.rst @@ -1,12 +1,11 @@ Mount CephFS: Prerequisites =========================== -You can use CephFS by mounting it to your local filesystem or by using -:ref:`cephfs-shell <cephfs-shell>`. Mounting CephFS requires superuser -privileges to trim dentries by issuing a remount of itself. CephFS can be -mounted `using kernel`_ as well as `using FUSE`_. Both have their own -advantages. Read the following section to understand more about both of these -ways to mount CephFS. +You can use CephFS by mounting the file system on a machine or by using +:ref:`cephfs-shell <cephfs-shell>`. A system mount can be performed using `the +kernel driver`_ as well as `the FUSE driver`_. Both have their own advantages +and disadvantages. Read the following section to understand more about both of +these ways to mount CephFS. For Windows CephFS mounts, please check the `ceph-dokan`_ page. @@ -70,6 +69,6 @@ Ceph MON resides. .. _Client Authentication: ../client-auth .. _cephfs-shell: ..cephfs-shell -.. _using kernel: ../mount-using-kernel-driver -.. _using FUSE: ../mount-using-fuse +.. _the kernel driver: ../mount-using-kernel-driver +.. _the FUSE driver: ../mount-using-fuse .. _ceph-dokan: ../ceph-dokan diff --git a/doc/cephfs/mount-using-fuse.rst b/doc/cephfs/mount-using-fuse.rst index f3ac054c9be..31ef9e3472b 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 ======== |