btrfs-progs: document 2K sector size

Update help text of mkfs and documentation mentioning that 2K size is
allowed in experimental mode.

Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
David Sterba 2025-03-19 22:39:44 +01:00
parent f033b8cc6c
commit c7fce0e6ef
2 changed files with 6 additions and 1 deletions

View File

@ -136,6 +136,8 @@ OPTIONS
advised unless you intend to mount it on a system with the suitable
page size.
In experimental build the size 2K (2048) is also allowed and needs
kernel that also allows that value, then it works in the subpage mode.
-L|--label <string>
Specify a label for the filesystem. The *string* should be less than 256

View File

@ -431,8 +431,11 @@ static const char * const mkfs_usage[] = {
"Features:",
OPTLINE("--csum TYPE", ""),
OPTLINE("--checksum TYPE", "checksum algorithm to use, crc32c (default), xxhash, sha256, blake2"),
OPTLINE("-n|--nodesize SIZE", "size of btree nodes (default 16K)"),
OPTLINE("-n|--nodesize SIZE", "size of btree nodes, 16K (default), 4K, 8K, 32K, 64K"),
OPTLINE("-s|--sectorsize SIZE", "data block size (default 4K, may not be mountable by current kernel if CPU page size is different)"),
#if EXPERIMENTAL
OPTLINE("","experimental: 2K (needs experimental subpage support for 2K on x86_64)"),
#endif
OPTLINE("-O|--features LIST", "comma separated list of filesystem features (use '-O list-all' to list features)"),
OPTLINE("-L|--label LABEL", "set the filesystem label (maximum length 255)"),
OPTLINE("-U|--uuid UUID", "specify the filesystem UUID (must be unique for a filesystem with multiple devices)"),