diff options
author | Qu Wenruo <quwenruo@cn.fujitsu.com> | 2014-04-02 16:29:16 +0800 |
---|---|---|
committer | David Sterba <dsterba@suse.cz> | 2014-04-22 14:15:20 +0200 |
commit | ba42a2e67fd35939f686459738eca49c174c3fa6 (patch) | |
tree | 7583d6e8fa603ab3a03ab047c3759e3f4b219a85 /Documentation | |
parent | db413a0c489a00f0bd3e30605e8a3e519f113c3e (diff) |
btrfs-progs: Convert man page for btrfs-device subcommand.
Convert man page for btrfs-device subcommand.
Signed-off-by: Qu Wenruo <quwenruo@cn.fujitsu.com>
Signed-off-by: David Sterba <dsterba@suse.cz>
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/Makefile | 2 | ||||
-rw-r--r-- | Documentation/btrfs-device.txt | 75 |
2 files changed, 76 insertions, 1 deletions
diff --git a/Documentation/Makefile b/Documentation/Makefile index 4839b6dd..79ae9deb 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -19,7 +19,7 @@ MAN8_TXT += btrfs.txt MAN8_TXT += btrfs-subvolume.txt MAN8_TXT += btrfs-filesystem.txt MAN8_TXT += btrfs-balance.txt -#MAN8_TXT += btrfs-device.txt +MAN8_TXT += btrfs-device.txt #MAN8_TXT += btrfs-scrub.txt #MAN8_TXT += btrfs-check.txt #MAN8_TXT += btrfs-rescue.txt diff --git a/Documentation/btrfs-device.txt b/Documentation/btrfs-device.txt new file mode 100644 index 00000000..20d7bcd7 --- /dev/null +++ b/Documentation/btrfs-device.txt @@ -0,0 +1,75 @@ +btrfs-device(8) +=============== + +NAME +---- +btrfs-device - control btrfs devices + +SYNOPSIS +-------- +'btrfs device' <subcommand> <args> + +DESCRIPTION +----------- +'btrfs device' is used to control the btrfs devices, since btrfs can be used +across several devices, 'btrfs device' is used for multiple device management. + +SUBCOMMAND +---------- +'add' [-Kf] <dev> [<dev>...] <path>:: +Add device(s) to the filesystem identified by <path>. ++ +If applicable, a whole device discard (TRIM) operation is performed. ++ +`Options` ++ +-K|--nodiscard:::: +do not perform discard by default +-f|--force:::: +force overwrite of existing filesystem on the given disk(s) + +'delete' <dev> [<dev>...] <path>:: +Remove device(s) from a filesystem identified by <path>. + +'scan' [(--all-devices|-d)|<device> [<device>...]]:: +Scan devices for a btrfs filesystem. ++ +If one or more devices are passed, these are scanned for a btrfs filesystem. +If no devices are passed, btrfs uses block devices containing btrfs +filesystem as listed by blkid. +Finally, if '--all-devices' or '-d' is passed, all the devices under /dev are +scanned. + +'disk-usage' [-b] <path> [<path>..]:: +Show which chunks are in a device. ++ +If '-b' is given, byte will be set as unit. + +'ready' <device>:: +Check device to see if it has all of it's devices in cache for mounting. + +'stats' [-z] <path>|<device>:: +Read and print the device IO stats for all devices of the filesystem +identified by <path> or for a single <device>. ++ +`Options` ++ +-z:::: +Reset stats to zero after reading them. + +EXIT STATUS +----------- +'btrfs device' returns a zero exist status if it succeeds. Non zero is +returned in case of failure. + +AVAILABILITY +------------ +'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy +development, +and not suitable for any uses other than benchmarking and review. +Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for +further details. + +SEE ALSO +-------- +`mkfs.btrfs`(8), |