From b79683252a1c702edafe04bf53be619c09b27e84 Mon Sep 17 00:00:00 2001 From: David Sterba Date: Fri, 5 Jun 2020 11:53:26 +0200 Subject: [PATCH] btrfs-progs: docs: update balance - note the faster cancellation - redundancy reduction - system also gets converted with metadata conversion Signed-off-by: David Sterba --- Documentation/btrfs-balance.asciidoc | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/Documentation/btrfs-balance.asciidoc b/Documentation/btrfs-balance.asciidoc index 8afd76da..b588d737 100644 --- a/Documentation/btrfs-balance.asciidoc +++ b/Documentation/btrfs-balance.asciidoc @@ -34,7 +34,12 @@ The filters can be used to perform following actions: - perform actions only on a given device (filters 'devid', 'drange') The filters can be applied to a combination of block group types (data, -metadata, system). Note that changing 'system' needs the force option. +metadata, system). Note that changing only the 'system' type needs the force +option. Otherwise 'system' gets automatically converted whenver 'metadata' +profile is converted. + +When metadata redundancy is reduced (eg. from RAID1 to single) the force option +is also required and it is noted in system log. NOTE: the balance operation needs enough work space, ie. space that is completely unused in the filesystem, otherwise this may lead to ENOSPC reports. @@ -66,6 +71,10 @@ SUBCOMMAND *cancel* :: cancels a running or paused balance, the command will block and wait until the current blockgroup being processed completes ++ +Since kernel 5.7 the response time of the cancellation is significantly +improved, on older kernels it might take a long time until currently +processed chunk is completely finished. *pause* :: pause running balance operation, this will store the state of the balance @@ -73,8 +82,8 @@ progress and used filters to the filesystem *resume* :: resume interrupted balance, the balance status must be stored on the filesystem -from previous run, eg. after it was forcibly interrupted and mounted again with -'skip_balance' +from previous run, eg. after it was paused or forcibly interrupted and mounted +again with 'skip_balance' *start* [options] :: start the balance operation according to the specified filters, no filters