From 1a431b0837fd8866df78d883a4626d11968dd934 Mon Sep 17 00:00:00 2001 From: David Sterba Date: Thu, 12 May 2022 20:33:03 +0200 Subject: [PATCH] btrfs-progs: docs: document paused balance Signed-off-by: David Sterba --- Documentation/btrfs-man5.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) 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 -----------------