import ceph quincy 17.2.4

[ceph.git] / ceph / doc / cephfs / quota.rst

diff --git a/ceph/doc/cephfs/quota.rst b/ceph/doc/cephfs/quota.rst
index 951982d16431a250e7a5924d7a07b0d44ac04f0b..777298f911cd116f2646b0b2ee7053cb2a83dc3d 100644 (file)
--- a/ceph/doc/cephfs/quota.rst
+++ b/ceph/doc/cephfs/quota.rst
@@ -41,6 +41,18 @@ Limitations
    the directory the client is restricted too (e.g., ``/home/user``)
    or something nested beneath it.
 
+   In case of a kernel client, it needs to have 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