btrfs-progs: docs: update formatting and wording for btrfs(5)

- emphasize features in the list
- minor whitespace fixes

Signed-off-by: David Sterba <dsterba@suse.com>
master
David Sterba 2017-04-20 18:50:02 +02:00
parent da76d52947
commit 3ab900a04e
1 changed files with 19 additions and 17 deletions

View File

@ -452,35 +452,36 @@ means the feature can be enabled.
List of features (see also `mkfs.btrfs`(8) section 'FILESYSTEM FEATURES'): List of features (see also `mkfs.btrfs`(8) section 'FILESYSTEM FEATURES'):
big_metadata:: *big_metadata*::
(since: 3.4) (since: 3.4)
+ +
the filesystem uses 'nodesize' bigger than the page size the filesystem uses 'nodesize' for metadata blocks, this can be bigger than the
page size
compress_lzo:: *compress_lzo*::
(since: 2.6.38) (since: 2.6.38)
+ +
the 'lzo' compression has been used on the filesystem, either as a mount option the 'lzo' compression has been used on the filesystem, either as a mount option
or via *btrfs filesystem defrag*. or via *btrfs filesystem defrag*.
default_subvol:: *default_subvol*::
(since: 2.6.34) (since: 2.6.34)
+ +
the default subvolume has been set on the filesystem the default subvolume has been set on the filesystem
extended_iref:: *extended_iref*::
(since: 3.7) (since: 3.7)
+ +
increased hardlink limit per file in a directory to 65536, older kernels increased hardlink limit per file in a directory to 65536, older kernels
supported a varying number of hardlinks depending on the sum of all file name supported a varying number of hardlinks depending on the sum of all file name
sizes that can be stored into one metadata block sizes that can be stored into one metadata block
mixed_backref:: *mixed_backref*::
(since: 2.6.31) (since: 2.6.31)
+ +
the last major disk format change, improved backreferences the last major disk format change, improved backreferences, now default
mixed_groups:: *mixed_groups*::
(since: 2.6.37) (since: 2.6.37)
+ +
mixed data and metadata block groups, ie. the data and metadata are not mixed data and metadata block groups, ie. the data and metadata are not
@ -492,17 +493,18 @@ and vice versa)
on the other hand, the final layout is quite unpredictable and possibly highly on the other hand, the final layout is quite unpredictable and possibly highly
fragmented, which means worse performance fragmented, which means worse performance
no_holes:: *no_holes*::
(since: 3.14) (since: 3.14)
+
improved representation of file extents where holes are not explicitly improved representation of file extents where holes are not explicitly
stored as an extent, saves a few percent of metadata if sparse files are used stored as an extent, saves a few percent of metadata if sparse files are used
raid56:: *raid56*::
(since: 3.9) (since: 3.9)
+ +
the filesystem contains or contained a raid56 profile of block groups the filesystem contains or contained a raid56 profile of block groups
+
skinny_metadata:: *skinny_metadata*::
(since: 3.10) (since: 3.10)
+ +
reduced-size metadata for extent references, saves a few percent of metadata reduced-size metadata for extent references, saves a few percent of metadata
@ -578,16 +580,16 @@ filesystem module:
for a given filesystem for a given filesystem
* get the supported features (can be also found under '/sys/fs/btrfs/features') * get the supported features (can be also found under '/sys/fs/btrfs/features')
The device is usually created by a system device node manager (eg. udev), but
The device is usually created by ..., but can be created manually: can be created manually:
-------------------- --------------------
# mknod --mode=600 c 10 234 /dev/btrfs-control # mknod --mode=600 c 10 234 /dev/btrfs-control
-------------------- --------------------
The device is not strictly required but the device scanning will not work and a The control device is not strictly required but the device scanning will not
workaround would need to be used to mount a multi-device filesystem. The mount work and a workaround would need to be used to mount a multi-device filesystem.
option 'device' can trigger the device scanning during mount. The mount option 'device' can trigger the device scanning during mount.
SEE ALSO SEE ALSO
-------- --------