path: root/Documentation
diff options
authorDavid Sterba <>2016-05-02 10:26:29 +0200
committerDavid Sterba <>2016-05-02 14:44:56 +0200
commitc54b5a545efd2c7076e1fa8863b3ec4f00cdb216 (patch)
treecca99c332cc94f581eec945d6f4b4d1ef51180bd /Documentation
parentaeda5acb4f25d89e5bf60bf728b82b9f583c9833 (diff)
btrfs-progs: add safety delay before starting full balance
A short delay with a warning before starting a full balance should improve usability. We have been getting reports from people who run full balance after following some random advice and then get surprised by the performance impact. The countdown is done even when run from scripts, but as the whole balance takes significanly more time, this shouldn't be an issue. 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 8b5df96a..7df40b9c 100644
--- a/Documentation/btrfs-balance.asciidoc
+++ b/Documentation/btrfs-balance.asciidoc
@@ -67,6 +67,12 @@ resume interrupted balance
start the balance operation according to the specified filters, no filters
will rewrite the entire filesystem. The process runs in the foreground.
+NOTE: the balance command without filters will basically rewrite everything
+in the filesystem. The run time is potentially very long, depending on the
+filesystem size. To prevent starting a full balance by accident, the user is
+warned and has a few seconds to cancel the operation before it starts. The
+warning and delay can be skipped with '--full-balance' option.