path: root/man
diff options
authorAnand Jain <>2013-10-08 11:41:38 +0800
committerChris Mason <>2013-10-16 08:23:13 -0400
commit6c2c30ce03c0beba716b5a054b64c6bf62068cb6 (patch)
tree5eafea2455b483a06e7b473b1cd63b84805ce4b7 /man
parenta7131ad1241470829fd5b836ce6cb6c74cdbef45 (diff)
btrfs-progs: use kernel for mounted disk for show
As of now btrfs filesystem show reads directly from disks. So sometimes output can be stale, mainly when user wants to cross verify their operation like, label or device delete or add... etc. so this patch will read from the kernel ioctl if it finds that disk is mounted. Signed-off-by: Anand Jain <> Signed-off-by: David Sterba <> Signed-off-by: Chris Mason <>
Diffstat (limited to 'man')
1 files changed, 9 insertions, 7 deletions
diff --git a/man/ b/man/
index de356b09..6cb3662e 100644
--- a/man/
+++ b/man/
@@ -25,7 +25,7 @@ btrfs \- control a btrfs filesystem
\fBbtrfs\fP \fBfilesystem df\fP\fI <path>\fP
-\fBbtrfs\fP \fBfilesystem show\fP [--all-devices|\fI<uuid>\fP|\fI<label>\fP]\fP
+\fBbtrfs\fP \fBfilesystem show\fP [\fI--mounted\fP|\fI--all-devices\fP|\fI<uuid>\fP]\fP
\fBbtrfs\fP \fBfilesystem sync\fP\fI <path> \fP
@@ -51,7 +51,7 @@ btrfs \- control a btrfs filesystem
\fBbtrfs\fP \fBdevice delete\fP \fI<device>\fP [\fI<device>...\fP] \fI<path>\fP
-\fBbtrfs\fP \fBdevice scan\fP [--all-devices|\fI<device> \fP[\fI<device>...\fP]
+\fBbtrfs\fP \fBdevice scan\fP [\fI--all-devices\fP|\fI<device> \P[\fI<device>...\fP]
\fBbtrfs\fP \fBdevice ready\fP\fI <device>\fP
@@ -256,9 +256,11 @@ Show information of a given subvolume in the \fI<path>\fR.
Show space usage information for a mount point.
-\fBfilesystem show\fR [--all-devices|\fI<uuid>\fR|\fI<label>\fR]\fR
-Show the btrfs filesystem with some additional info. If no \fIUUID\fP or
-\fIlabel\fP is passed, \fBbtrfs\fR show info of all the btrfs filesystem.
+\fBfilesystem show\fR [\fI--mounted\fP|\fI--all-devices\fP|\fI<uuid>\fR]\fR
+Show the btrfs filesystem with some additional info. If no option or \fIUUID\fP
+is passed, \fBbtrfs\fR shows information of all the btrfs filesystem both mounted
+and unmounted.
+If \fB--mounted\fP is passed, it would probe btrfs kernel to list mounted btrfs filesystem(s);
If \fB--all-devices\fP is passed, all the devices under /dev are scanned;
otherwise the devices list is extracted from the /proc/partitions file.
@@ -405,8 +407,8 @@ Remove device(s) from a filesystem identified by \fI<path>\fR.
\fBdevice scan\fR [--all-devices|\fI<device> \fP[\fI<device>...\fP]\fR
If one or more devices are passed, these are scanned for a btrfs filesystem.
-If no devices are passed, \fBbtrfs\fR scans all the block devices listed
-in the /proc/partitions file.
+If no devices are passed, \fBbtrfs\fR uses block devices containing btrfs
+filesystem as listed by blkid.
Finally, if \fB--all-devices\fP is passed, all the devices under /dev are