doc: Update quota kclient limitation

Fixes: https://tracker.ceph.com/issues/53509
Signed-off-by: Kotresh HR <khiremat@redhat.com>
(cherry picked from commit cd92ea0cb459ffd31d164a661634f913eab59594)

diff --git a/doc/cephfs/quota.rst b/doc/cephfs/quota.rst
index 951982d16431a250e7a5924d7a07b0d44ac04f0b..78c0887d9d5f6ebb6007b69461df92f528d58e2d 100644 (file)
--- a/doc/cephfs/quota.rst
+++ b/doc/cephfs/quota.rst
@@ -41,6 +41,17 @@ Limitations
    the directory the client is restricted too (e.g., ``/home/user``)
    or something nested beneath it.
 
+   Kernel clients need access to the parent of the directory inode on
+   which quotas are configured in order to enforce them. If quota is
+   configured on a directory path (e.g., ``/home/volumes/group``), the
+   kclient needs to have access to the parent (e.g., ``/home/volumes``).
+
+   An example command to create such an user is as below::
+
+     $ ceph auth get-or-create client.guest mds 'allow r path=/home/volumes, allow rw path=/home/volumes/group' mgr 'allow rw' osd 'allow rw tag cephfs metadata=*' mon 'allow r'
+
+   See also: https://tracker.ceph.com/issues/55090
+
 #. *Snapshot file data which has since been deleted or changed does not count
    towards the quota.* See also: http://tracker.ceph.com/issues/24284