Skip to content

Commit 13c7c9d

Browse files
truongsinhzdover23
andcommitted
doc/cephfs: use 'p' flag to set layouts or quotas
Remind users that clients must use the 'p' flag when writing file layouts. This PR is made in response to https://www.reddit.com/r/ceph/comments/1gbad51/comment/ltkgd5v/ Co-authored-by: Zac Dover <[email protected]> Signed-off-by: TruongSinh Tran-Nguyen <[email protected]>
1 parent 25d9bed commit 13c7c9d

File tree

2 files changed

+5
-0
lines changed

2 files changed

+5
-0
lines changed

doc/cephfs/client-auth.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,8 @@ If quotas are not enabled or if no quota is set on the mounted sub-directory,
106106
then the overall usage of the file system will be reported irrespective of the
107107
value of this setting.
108108

109+
.. _cephfs-layout-and-quota-restriction:
110+
109111
Layout and Quota restriction (the 'p' flag)
110112
===========================================
111113

doc/cephfs/file-layouts.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,9 @@ File layouts
66
The layout of a file controls how its contents are mapped to Ceph RADOS objects. You can
77
read and write a file's layout using *virtual extended attributes* or xattrs.
88

9+
Clients must use the ``p`` flag when writing a file's layout. See :ref:`Layout
10+
and Quota restriction (the 'p' flag) <cephfs-layout-and-quota-restriction>`.
11+
912
The name of the layout xattrs depends on whether a file is a regular file or a directory. Regular
1013
files' layout xattrs are called ``ceph.file.layout``, whereas directories' layout xattrs are called
1114
``ceph.dir.layout``. Where subsequent examples refer to ``ceph.file.layout``, substitute ``dir`` as appropriate

0 commit comments

Comments
 (0)