aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorDavid Sterba <dsterba@suse.com>2022-05-12 20:33:03 +0200
committerDavid Sterba <dsterba@suse.com>2022-05-17 21:12:19 +0200
commit1a431b0837fd8866df78d883a4626d11968dd934 (patch)
treee028cb5b56d7e276b74a518feda35f18a7c3dcfc /Documentation
parent908a46085ccbd5f0dc178450144724e436b4a433 (diff)
downloadbtrfs-progs-1a431b0837fd8866df78d883a4626d11968dd934.tar.gz
btrfs-progs: docs: document paused balance
Signed-off-by: David Sterba <dsterba@suse.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/btrfs-man5.rst7
1 files changed, 6 insertions, 1 deletions
diff --git a/Documentation/btrfs-man5.rst b/Documentation/btrfs-man5.rst
index 4b927383..9632f513 100644
--- a/Documentation/btrfs-man5.rst
+++ b/Documentation/btrfs-man5.rst
@@ -196,12 +196,14 @@ FILESYSTEM EXCLUSIVE OPERATIONS
-------------------------------
There are several operations that affect the whole filesystem and cannot be run
-in parallel. Attempt to start one while another is running will fail.
+in parallel. Attempt to start one while another is running will fail (see
+exceptions below).
Since kernel 5.10 the currently running operation can be obtained from
*/sys/fs/UUID/exclusive_operation* with following values and operations:
* balance
+* balance paused (since 5.17)
* device add
* device delete
* device replace
@@ -212,6 +214,9 @@ Since kernel 5.10 the currently running operation can be obtained from
Enqueuing is supported for several btrfs subcommands so they can be started
at once and then serialized.
+There's an exception when a paused balance allows to start a device add
+operation as they don't really collide and this can be used to add more space
+for the balance to finish.
FILESYSTEM LIMITS
-----------------