diff options
Diffstat (limited to 'Documentation/btrfs-device.asciidoc')
-rw-r--r-- | Documentation/btrfs-device.asciidoc | 21 |
1 files changed, 15 insertions, 6 deletions
diff --git a/Documentation/btrfs-device.asciidoc b/Documentation/btrfs-device.asciidoc index d05fc457..eedcac85 100644 --- a/Documentation/btrfs-device.asciidoc +++ b/Documentation/btrfs-device.asciidoc @@ -27,7 +27,7 @@ The device management works on a mounted filesystem. Devices can be added, removed or replaced, by commands profided by *btrfs device* and *btrfs replace*. The profiles can be also changed, provided there's enough workspace to do the -conversion, using the *btrfs balance* comand and namely the filter 'convert'. +conversion, using the *btrfs balance* command and namely the filter 'convert'. Profile:: A profile describes an allocation policy based on the redundancy/replication @@ -98,16 +98,22 @@ remain as such. Reloading the kernel module will drop this information. There's an alternative way of mounting multiple-device filesystem without the need for prior scanning. See the mount option 'device'. -*stats* [-z] <path>|<device>:: +*stats* [options] <path>|<device>:: Read and print the device IO error statistics for all devices of the given -filesystem identified by <path> or for a single <device>. See section *DEVICE -STATS* for more information. +filesystem identified by <path> or for a single <device>. The filesystem must +be mounted. See section *DEVICE STATS* for more information about the reported +statistics and the meaning. + `Options` + --z:::: +-z|--reset:::: Print the stats and reset the values to zero afterwards. +-c|--check:::: +Check if the stats are all zeros and return 0 it it is so. Set bit 6 of the +return code if any of the statistics is no-zero. The error values is 65 if +reading stats from at least one device failed, otherwise it's 64. + *usage* [options] <path> [<path>...]:: Show detailed information about internal allocations in devices. + @@ -180,7 +186,7 @@ logial mappings). What changed: -* available data space decreased by 3GiB, usable rougly (50 - 3) + (100 - 3) = 144 GiB +* available data space decreased by 3GiB, usable roughly (50 - 3) + (100 - 3) = 144 GiB * metadata redundancy increased IOW, the unequal device sizes allow for combined space for data yet improved @@ -231,6 +237,9 @@ EXIT STATUS *btrfs device* returns a zero exit status if it succeeds. Non zero is returned in case of failure. +If the '-s' option is used, *btrfs device stats* will add 64 to the +exit status if any of the error counters is non-zero. + AVAILABILITY ------------ *btrfs* is part of btrfs-progs. |