path: root/Documentation
diff options
authorDavid Sterba <>2015-10-22 10:19:38 +0200
committerDavid Sterba <>2016-01-12 15:01:04 +0100
commit40db5cd7ffcbc4b58d6c82e9ddba01f7e26152ca (patch)
tree5f2b486ae544e16dd9678429f25746234554d09c /Documentation
parent0826a8ddb90e577c5c359d8bca2571f167029f7e (diff)
btrfs-progs: extend balance args to take min/max usage filter
Add the overlapping usage and [usage_min, usage_max] members to the balance args. The min/max values are interpreted iff the corresponding flag BTRFS_BALANCE_ARGS_USAGE_RANGE is set. The minimum boundary is inclusive, maximum is exclusive: * usage_min <= chunk_usage < usage_max Signed-off-by: David Sterba <>
Diffstat (limited to 'Documentation')
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/btrfs-balance.asciidoc b/Documentation/btrfs-balance.asciidoc
index 9adf7784..92a37784 100644
--- a/Documentation/btrfs-balance.asciidoc
+++ b/Documentation/btrfs-balance.asciidoc
@@ -106,6 +106,12 @@ Balances only block groups with usage under the given percentage. The
value of 0 is allowed and will clean up completely unused block groups, this
should not require any new space allocated. You may want to use 'usage=0' in
case balance is returnin ENOSPC and your filesystem is not too full.
+The argument may be a single value or a range. The single value *N* means *at
+most N percent used*, equivalent to *..N* range syntax. Kernels prior to 4.4
+accept only the single value format.
+The minimum boundary is inclusive, maximum is exclusive.
Balances only block groups which have at least one chunk on the given