From 07c334a2ca5ac7da7d7797888d045a35ee0cabf7 Mon Sep 17 00:00:00 2001 From: Cilang Zhao Date: Tue, 8 Dec 2015 03:45:34 -0500 Subject: [PATCH] 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 --- doc/cephfs/file-layouts.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/cephfs/file-layouts.rst b/doc/cephfs/file-layouts.rst index 95be8ae3e577..c09d8f548ed3 100644 --- a/doc/cephfs/file-layouts.rst +++ b/doc/cephfs/file-layouts.rst @@ -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 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 ---------------------- -- 2.47.3