diff options
author | Qu Wenruo <quwenruo@cn.fujitsu.com> | 2014-04-02 16:29:15 +0800 |
---|---|---|
committer | David Sterba <dsterba@suse.cz> | 2014-04-22 14:15:20 +0200 |
commit | db413a0c489a00f0bd3e30605e8a3e519f113c3e (patch) | |
tree | 55cce1da25c66f2fdcedb560fbf67d0a2fc62f16 /Documentation | |
parent | 1762675f6769707fd27daf8bb7588e025ed1e2ab (diff) |
btrfs-progs: Convert man page for btrfs-balance.
Convert man page for btrfs-balance.
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-balance.txt | 77 |
2 files changed, 78 insertions, 1 deletions
diff --git a/Documentation/Makefile b/Documentation/Makefile index 1fa2b352..4839b6dd 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -18,7 +18,7 @@ MAN8_TXT += btrfs.txt # Sub commands for btrfs MAN8_TXT += btrfs-subvolume.txt MAN8_TXT += btrfs-filesystem.txt -#MAN8_TXT += btrfs-balance.txt +MAN8_TXT += btrfs-balance.txt #MAN8_TXT += btrfs-device.txt #MAN8_TXT += btrfs-scrub.txt #MAN8_TXT += btrfs-check.txt diff --git a/Documentation/btrfs-balance.txt b/Documentation/btrfs-balance.txt new file mode 100644 index 00000000..2289fdfb --- /dev/null +++ b/Documentation/btrfs-balance.txt @@ -0,0 +1,77 @@ +btrfs-balance(8) +================ + +NAME +---- +btrfs-balance - balance btrfs filesystem + +SYNOPSIS +-------- +'btrfs [filesystem] balance' <subcommand>|<args> + +DESCRIPTION +----------- +'btrfs balance' is used to balance chunks in a btrfs filesystem across +multiple or even single device. + +SUBCOMMAND +---------- +<path>:: +Balance chunks across the devices *online*. ++ +'btrfs balance <path>' is deprecated, +please use 'btrfs balance start' command instead. + +'start' [options] <path>:: +Balance chunks across the devices *online*. ++ +Balance and/or convert (change allocation profile of) chunks that +passed all filters in a comma-separated list of filters for a +particular chunk type. +If filter list is not given balance all chunks of that type. +In case none of the -d, -m or -s options is +given balance all chunks in a filesystem. ++ +`Options` ++ +-d[filters]:::: +act on data chunks +-m[filters]:::: +act on metadata chunks +-s[filters]:::: +act on system chunks (only under -f) +-v:::: +be verbose +-f:::: +force reducing of metadata integrity + +'pause' <path>:: +Pause running balance. + +'cancel' <path>:: +Cancel running or paused balance. + +'resume' <path>:: +Resume interrupted balance. + +'status' [-v] <path>:: +Show status of running or paused balance. ++ +If '-v' option is given, output will be verbose. + +EXIT STATUS +----------- +'btrfs balance' 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), |