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>
This commit is contained in:
Qu Wenruo 2014-04-02 16:29:15 +08:00 committed by David Sterba
parent 1762675f67
commit db413a0c48
2 changed files with 78 additions and 1 deletions

View File

@ -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

View File

@ -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),