@@ -117,15 +117,33 @@ partition after reducing the size of the filesystem. This can done using
it with the new desired size. When recreating the partition make sure to use
the same starting disk cylinder as before.
-*show* [--mounted|--all-devices|<path>|<uuid>|<device>|<label>]::
+*show* [options] [<path>|<uuid>|<device>|<label>]::
Show the btrfs filesystem with some additional info.
+
If no option nor <path>|<uuid>|<device>|<label> is passed, btrfs shows
information of all the btrfs filesystem both mounted and unmounted.
-If '--mounted' is passed, it would probe btrfs kernel to list mounted btrfs
-filesystem(s);
-If '--all-devices' is passed, all the devices under /dev are scanned;
-otherwise the devices list is extracted from the /proc/partitions file.
++
+`Options`
++
+--mounted::::
+probe btrfs kernel to list mounted btrfs filesystems(s)
+--all-devices::::
+scan all devices under /dev, otherwise the devices list is extracted from the
+/proc/partitions file.
+--human-readable::::
+print human friendly numbers, base 1024, this is the default
+--iec::::
+select the 1024 base for the following options, according to the IEC standard
+--si::::
+select the 1000 base for the following options, according to the SI standard
+--kbytes::::
+show sizes in KiB, or kB with --si
+--mbytes::::
+show sizes in MiB, or MB with --si
+--gbytes::::
+show sizes in GiB, or GB with --si
+--tbytes::::
+show sizes in TiB, or TB with --si
*sync* <path>::
Force a sync for the filesystem identified by <path>.
@@ -820,6 +820,14 @@ static const char * const cmd_show_usage[] = {
"Show the structure of a filesystem",
"-d|--all-devices show only disks under /dev containing btrfs filesystem",
"-m|--mounted show only mounted btrfs",
+ "--raw raw numbers in bytes",
+ "-human-readable human friendly numbers, base 1024(default)",
+ "--iec use 1024 as a base (KiB, MiB, GiB, TiB)",
+ "--si use 1000 as a base (kB, MB, GB, TB)",
+ "--kbytes show sizes in KiB, or kB with --si",
+ "--mbytes show sizes in MiB, or MB with --si",
+ "--gbytes show sizes in GiB, or GB with --si",
+ "--tbytes show sizes in TiB, or TB with --si",
"If no argument is given, structure of all present filesystems is shown.",
NULL
};
Signed-off-by: Qu Wenruo <quwenruo@cn.fujitsu.com> --- Documentation/btrfs-filesystem.asciidoc | 28 +++++++++++++++++++++++----- cmds-filesystem.c | 8 ++++++++ 2 files changed, 31 insertions(+), 5 deletions(-)