From: Jannis Speer <Jannis.speer@tutanota.com>
Date: Thu, 14 Aug 2025 16:49:48 +0000 (+0200)
Subject: doc/cephfs: Update quota.rst
X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=90c5f2e740128459db679fb55c64e42a8cedf86f;p=ceph.git

doc/cephfs: Update quota.rst

Make the user aware to adapt the client capabilities to enable the configuration of quotas.

Signed-off-by: Jannis Speer <Jannis.speer@tutanota.com>

doc/cephfs: fix broken link

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 99fe86670fc23dd98b6e583ac4de6a5dcd8f8e28)
---

diff --git a/doc/cephfs/quota.rst b/doc/cephfs/quota.rst
index b3d0d63b3b192..da68a60d8ab3a 100644
--- a/doc/cephfs/quota.rst
+++ b/doc/cephfs/quota.rst
@@ -29,6 +29,12 @@ value::
 .. note:: Values will be strictly cast to IEC units even when SI units
    are input, e.g. 1K to 1024 bytes.
 
+.. note:: To enable a client to set a quota by modifying the corresponding
+   extended attribute, in the client's authentication capabilities the ``p``
+   flag needs to be set in addition to ``rw``. See :ref:`CephFS Client
+   Capabilities - Layout and Quota restriction (the 'p'
+   flag)<cephfs-layout-and-quota-restriction>` for more details.
+
 To view quota limit::
 
   $ getfattr -n ceph.quota.max_bytes /some/dir