diff mbox series

doc: ceph: update userspace command to get CephFS metadata

Message ID ZkkgZlRk+PbFBUOJ@kurwa
State New
Headers show
Series doc: ceph: update userspace command to get CephFS metadata | expand

Commit Message

Artem Ikonnikov May 18, 2024, 9:40 p.m. UTC
According to ceph documentation "getfattr -d /some/dir" no longer displays
the list of all extended attributes. Both CephFS kernel and FUSE clients
hide this information.

To retrieve the information you have to specify the particular attribute
name e.g. "getfattr -n ceph.dir.rbytes /some/dir"

Link: https://docs.ceph.com/en/latest/cephfs/quota/
Signed-off-by: Artem Ikonnikov <artem@datacrunch.io>
---
 Documentation/filesystems/ceph.rst | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

Comments

Xiubo Li May 21, 2024, 12:32 a.m. UTC | #1
On 5/19/24 05:40, Artem Ikonnikov wrote:
> According to ceph documentation "getfattr -d /some/dir" no longer displays
> the list of all extended attributes. Both CephFS kernel and FUSE clients
> hide this information.
>
> To retrieve the information you have to specify the particular attribute
> name e.g. "getfattr -n ceph.dir.rbytes /some/dir"
>
> Link: https://docs.ceph.com/en/latest/cephfs/quota/
> Signed-off-by: Artem Ikonnikov <artem@datacrunch.io>
> ---
>   Documentation/filesystems/ceph.rst | 15 +++++++++------
>   1 file changed, 9 insertions(+), 6 deletions(-)
>
> diff --git a/Documentation/filesystems/ceph.rst b/Documentation/filesystems/ceph.rst
> index 085f309ece60..6d2276a87a5a 100644
> --- a/Documentation/filesystems/ceph.rst
> +++ b/Documentation/filesystems/ceph.rst
> @@ -67,12 +67,15 @@ Snapshot names have two limitations:
>     more than 255 characters, and `<node-id>` takes 13 characters, the long
>     snapshot names can take as much as 255 - 1 - 1 - 13 = 240.
>   
> -Ceph also provides some recursive accounting on directories for nested
> -files and bytes.  That is, a 'getfattr -d foo' on any directory in the
> -system will reveal the total number of nested regular files and
> -subdirectories, and a summation of all nested file sizes.  This makes
> -the identification of large disk space consumers relatively quick, as
> -no 'du' or similar recursive scan of the file system is required.
> +Ceph also provides some recursive accounting on directories for nested files
> +and bytes.  You can run the commands::
> +
> + getfattr -n ceph.dir.rfiles /some/dir
> + getfattr -n ceph.dir.rbytes /some/dir
> +
> +to get the total number of nested files and their combined size, respectively.
> +This makes the identification of large disk space consumers relatively quick,
> +as no 'du' or similar recursive scan of the file system is required.
>   
>   Finally, Ceph also allows quotas to be set on any directory in the system.
>   The quota can restrict the number of bytes or the number of files stored

LGTM.

Reviewed-by: Xiubo Li <xiubli@redhat.com>
diff mbox series

Patch

diff --git a/Documentation/filesystems/ceph.rst b/Documentation/filesystems/ceph.rst
index 085f309ece60..6d2276a87a5a 100644
--- a/Documentation/filesystems/ceph.rst
+++ b/Documentation/filesystems/ceph.rst
@@ -67,12 +67,15 @@  Snapshot names have two limitations:
   more than 255 characters, and `<node-id>` takes 13 characters, the long
   snapshot names can take as much as 255 - 1 - 1 - 13 = 240.
 
-Ceph also provides some recursive accounting on directories for nested
-files and bytes.  That is, a 'getfattr -d foo' on any directory in the
-system will reveal the total number of nested regular files and
-subdirectories, and a summation of all nested file sizes.  This makes
-the identification of large disk space consumers relatively quick, as
-no 'du' or similar recursive scan of the file system is required.
+Ceph also provides some recursive accounting on directories for nested files
+and bytes.  You can run the commands::
+
+ getfattr -n ceph.dir.rfiles /some/dir
+ getfattr -n ceph.dir.rbytes /some/dir
+
+to get the total number of nested files and their combined size, respectively.
+This makes the identification of large disk space consumers relatively quick,
+as no 'du' or similar recursive scan of the file system is required.
 
 Finally, Ceph also allows quotas to be set on any directory in the system.
 The quota can restrict the number of bytes or the number of files stored