path: root/Documentation
diff options
authorAustin S. Hemmelgarn <>2016-06-21 11:16:59 -0400
committerDavid Sterba <>2016-07-26 19:26:29 +0200
commitfe520b5cdc46bc7f34d55b16292d5be805ffd339 (patch)
tree661b1fec603b30711be21fa13e88e5fc208580be /Documentation
parent1d6c7cb725bb7d25981d44915b316e24751b7b72 (diff)
btrfs-progs: add option to run balance as daemon
Currently, balance operations are run synchronously in the foreground. This is nice for interactive management, but is kind of crappy when you start looking at automation and similar things. This patch adds an option to `btrfs balance start` to tell it to daemonize prior to running the balance operation, thus allowing us to preform balances asynchronously. The two biggest use cases I have for this are starting a balance on a remote server without establishing a full shell session, and being able to background the balance in a recovery shell (which usually has no job control) so I can still get progress information. Because it simply daemonizes prior to calling the balance ioctl, this doesn't actually need any kernel support. Signed-off-by: Austin S. Hemmelgarn <> Signed-off-by: David Sterba <>
Diffstat (limited to 'Documentation')
1 files changed, 2 insertions, 0 deletions
diff --git a/Documentation/btrfs-balance.asciidoc b/Documentation/btrfs-balance.asciidoc
index fff8a321..9c6f52bc 100644
--- a/Documentation/btrfs-balance.asciidoc
+++ b/Documentation/btrfs-balance.asciidoc
@@ -104,6 +104,8 @@ act on system chunks (requires '-f'), see `FILTERS` section for details about 'f
be verbose and print balance filter arguments
force reducing of metadata integrity, eg. when going from 'raid1' to 'single'
+run the balance operation asynchronously in the background
*status* [-v] <path>::
Show status of running or paused balance.