diff --git a/Documentation/Status.rst b/Documentation/Status.rst index 37128797f0..808b6250d3 100644 --- a/Documentation/Status.rst +++ b/Documentation/Status.rst @@ -298,9 +298,9 @@ Subpage block size ------------------ Most commonly used page sizes are 4KiB, 16KiB and 64KiB. All combinations with -a 4KiB sector size filesystems are supported. Some features are not compatible +a 4KiB block size filesystems are supported. Some features are not compatible with subpage or require another feature to work. Since btrfs-progs 6.7 the default -sector size is 4KiB as this allows cross-architecture compatibility. +block size is 4KiB as this allows cross-architecture compatibility. .. list-table:: :header-rows: 1 @@ -317,9 +317,9 @@ sector size is 4KiB as this allows cross-architecture compatibility. * - Compression - :statusok:`partial support` - Only page-aligned ranges can be compressed - * - Sectorsize + * - Blocksize - :statusok:`supported` - - The list of supported sector sizes on a given version can be found + - The list of supported block sizes on a given version can be found in file :file:`/sys/fs/btrfs/features/supported_sectorsizes` .. _status-zoned: diff --git a/Documentation/Subpage.rst b/Documentation/Subpage.rst index 4116f86ee8..44ae55b7bf 100644 --- a/Documentation/Subpage.rst +++ b/Documentation/Subpage.rst @@ -2,16 +2,17 @@ Subpage support =============== Subpage block size support, or just *subpage* for short, is a feature to allow -using a filesystem that has different size of data block size (*sectorsize*) +using a filesystem that has different size of data block size +(*blocksize*, previously called *sectorsize*) and the host CPU page size. For easier implementation the support was limited to the exactly same size of the block and page. On x86_64 this is typically 4KiB, but there are other architectures commonly used that make use of larger pages, like 64KiB on 64bit ARM or PowerPC or 16KiB on Apple Silicon. This means -filesystems created with 64KiB sector size cannot be mounted on a system with +filesystems created with 64KiB block size cannot be mounted on a system with 4KiB page size. -Since btrfs-progs 6.7, filesystems are created with a 4KiB sector size by -default, though it remains possible to create filesystems with other sector sizes +Since btrfs-progs 6.7, filesystems are created with a 4KiB block size by +default, though it remains possible to create filesystems with other block sizes (such as 64KiB with the "-s 64k" option for :command:`mkfs.btrfs`). This ensures that new filesystems are compatible across other architecture variants using larger page sizes. @@ -21,7 +22,7 @@ Requirements, limitations The initial subpage support has been added in kernel 5.15. Most features are already working without problems. On a 64KiB page system, a filesystem with -4KiB sectorsize can be mounted and used as long as the initial mount succeeds. +4KiB blocksize can be mounted and used as long as the initial mount succeeds. Subpage support is used by default for systems with a non-4KiB page size since btrfs-progs 6.7. diff --git a/Documentation/btrfs-convert.rst b/Documentation/btrfs-convert.rst index 973025aba0..0be54ac4d4 100644 --- a/Documentation/btrfs-convert.rst +++ b/Documentation/btrfs-convert.rst @@ -30,8 +30,8 @@ OPTIONS -N|--nodesize set filesystem nodesize, the tree block size in which btrfs stores its metadata. The default value is 16KiB (16384) or the page size, whichever is bigger. - Must be a multiple of the sectorsize, but not larger than 65536. See - :doc:`mkfs.btrfs` for more details. + Must be a multiple of the block size (previously called "sector size), + but not larger than 65536. See :doc:`mkfs.btrfs` for more details. -r|--rollback rollback to the original ext2/3/4 filesystem if possible -l|--label