2014-04-02 08:29:15 +00:00
|
|
|
btrfs-balance(8)
|
|
|
|
|
================
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
btrfs-balance - balance btrfs filesystem
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs [filesystem] balance* <subcommand>|<args>
|
2014-04-02 08:29:15 +00:00
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs balance* is used to balance chunks in a btrfs filesystem across
|
2014-04-02 08:29:15 +00:00
|
|
|
multiple or even single device.
|
|
|
|
|
|
2014-04-11 02:43:52 +00:00
|
|
|
See `btrfs-device`(8) for more details about the effect on device management.
|
|
|
|
|
|
2014-04-02 08:29:15 +00:00
|
|
|
SUBCOMMAND
|
|
|
|
|
----------
|
|
|
|
|
<path>::
|
|
|
|
|
Balance chunks across the devices *online*.
|
|
|
|
|
+
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs balance <path>* is deprecated,
|
|
|
|
|
please use *btrfs balance start* command instead.
|
2014-04-02 08:29:15 +00:00
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*start* [options] <path>::
|
2014-04-02 08:29:15 +00:00
|
|
|
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`
|
|
|
|
|
+
|
2014-05-19 15:08:56 +00:00
|
|
|
-d[<filters>]::::
|
2014-04-02 08:29:15 +00:00
|
|
|
act on data chunks
|
2014-05-19 15:08:56 +00:00
|
|
|
-m[<filters>]::::
|
2014-04-02 08:29:15 +00:00
|
|
|
act on metadata chunks
|
2014-05-19 15:08:56 +00:00
|
|
|
-s[<filters>]::::
|
2014-04-02 08:29:15 +00:00
|
|
|
act on system chunks (only under -f)
|
|
|
|
|
-v::::
|
|
|
|
|
be verbose
|
|
|
|
|
-f::::
|
|
|
|
|
force reducing of metadata integrity
|
|
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*pause* <path>::
|
2014-04-02 08:29:15 +00:00
|
|
|
Pause running balance.
|
|
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*cancel* <path>::
|
2014-04-02 08:29:15 +00:00
|
|
|
Cancel running or paused balance.
|
|
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*resume* <path>::
|
2014-04-02 08:29:15 +00:00
|
|
|
Resume interrupted balance.
|
|
|
|
|
|
2014-05-19 15:49:35 +00:00
|
|
|
*status* [-v] <path>::
|
2014-04-02 08:29:15 +00:00
|
|
|
Show status of running or paused balance.
|
|
|
|
|
+
|
|
|
|
|
If '-v' option is given, output will be verbose.
|
|
|
|
|
|
|
|
|
|
EXIT STATUS
|
|
|
|
|
-----------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs balance* returns a zero exist status if it succeeds. Non zero is
|
2014-04-02 08:29:15 +00:00
|
|
|
returned in case of failure.
|
|
|
|
|
|
|
|
|
|
AVAILABILITY
|
|
|
|
|
------------
|
2014-05-19 15:49:35 +00:00
|
|
|
*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
|
2014-04-02 08:29:15 +00:00
|
|
|
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),
|
2014-04-11 02:43:52 +00:00
|
|
|
`btrfs-device`(8)
|
