summaryrefslogtreecommitdiffstats
path: root/doc/cephfs/file-layouts.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/cephfs/file-layouts.rst')
-rw-r--r--doc/cephfs/file-layouts.rst3
1 files changed, 3 insertions, 0 deletions
diff --git a/doc/cephfs/file-layouts.rst b/doc/cephfs/file-layouts.rst
index 3bb6ddeae9b..306bbc6eb08 100644
--- a/doc/cephfs/file-layouts.rst
+++ b/doc/cephfs/file-layouts.rst
@@ -6,6 +6,9 @@ File layouts
The layout of a file controls how its contents are mapped to Ceph RADOS objects. You can
read and write a file's layout using *virtual extended attributes* or xattrs.
+Clients must use the ``p`` flag when writing a file's layout. See :ref:`Layout
+and Quota restriction (the 'p' flag) <cephfs-layout-and-quota-restriction>`.
+
The name of the layout xattrs depends on whether a file is a regular file or a directory. Regular
files' layout xattrs are called ``ceph.file.layout``, whereas directories' layout xattrs are called
``ceph.dir.layout``. Where subsequent examples refer to ``ceph.file.layout``, substitute ``dir`` as appropriate