From: Zac Dover Date: Mon, 12 Aug 2024 12:38:14 +0000 (+1000) Subject: doc/cephfs: improve "layout fields" text X-Git-Tag: v19.2.1~288^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=fd33760ab2a0bd4498678e16dcde28540842d85c;p=ceph.git doc/cephfs: improve "layout fields" text Improve "layout fields" text in doc/cephfs/file-layouts.rst, as suggesed by Anthony D'Atri in these comments: https://github.com/ceph/ceph/pull/59021#discussion_r1704108581 https://github.com/ceph/ceph/pull/59021#discussion_r1704112320 Co-authored-by: Anthony D'Atri Signed-off-by: Zac Dover (cherry picked from commit 0949b410433837f0509fb73169fa7f22c8f6c256) --- diff --git a/doc/cephfs/file-layouts.rst b/doc/cephfs/file-layouts.rst index c347524f44834..3bb6ddeae9b9c 100644 --- a/doc/cephfs/file-layouts.rst +++ b/doc/cephfs/file-layouts.rst @@ -20,7 +20,7 @@ Layout fields ------------- pool - This is a string and returns either an ID or a name. Strings may contain + This is a string and contains either an ID or a name. Strings may contain only characters in the set ``[a-zA-Z0-9\_-.]``. This determines the RADOS pool that stores a file's data objects. @@ -41,9 +41,9 @@ pool_namespace stripe_unit This is an integer. The size (in bytes) of a block of data used in the distribution of a file. All stripe units for a file have equal size. The - last stripe unit is typically incomplete–that is, it represents the data at - the end of the file as well as unused “space” beyond the end of the file to - the end of the fixed stripe unit size. + last stripe unit is typically only partly full of data: it holds file data + through EOF as well as padding that fills the balance of the fixed stripe + unit size. stripe_count Integer. The number of consecutive stripe units that constitute a RAID 0