doc:file must be empty when writing layout fields of file use "setfattr"

When the layout fields of a file are modified, this file must be empty, otherwise an error would occur.

Signed-off-by:Cilang Zhao zhao.cilang@h3c.com
This commit is contained in:
Cilang Zhao 2015-12-08 03:45:34 -05:00
parent 2af7c9f719
commit 07c334a2ca

View File

@ -95,7 +95,22 @@ Layout fields are modified using ``setfattr``:
$ setfattr -n ceph.file.layout.pool -v 1 file2 # Setting pool by ID $ setfattr -n ceph.file.layout.pool -v 1 file2 # Setting pool by ID
$ setfattr -n ceph.file.layout.pool -v cephfs_data file2 # Setting pool by name $ setfattr -n ceph.file.layout.pool -v cephfs_data file2 # Setting pool by name
.. note::
When the layout fields of a file are modified using ``setfattr``, this file must be empty, otherwise an error will occur.
.. code-block:: bash
# touch an empty file
$ touch file1
# modify layout field successfully
$ setfattr -n ceph.file.layout.stripe_count -v 3 file1
# write something to file1
$ echo "hello world" > file1
$ setfattr -n ceph.file.layout.stripe_count -v 4 file1
setfattr: file1: Directory not empty
Inheritance of layouts Inheritance of layouts
---------------------- ----------------------