[1/1] btrfs-progs: docs: document btrfs-balance exit status in detail
diff mbox series

Message ID 20190825060256.20529-2-git@vladimir.panteleev.md
State New
Headers show
Series
  • btrfs-progs: docs: document btrfs-balance exit status in detail
Related show

Commit Message

Vladimir Panteleev Aug. 25, 2019, 6:02 a.m. UTC
Signed-off-by: Vladimir Panteleev <git@vladimir.panteleev.md>
---
 Documentation/btrfs-balance.asciidoc | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

Patch
diff mbox series

diff --git a/Documentation/btrfs-balance.asciidoc b/Documentation/btrfs-balance.asciidoc
index bfb76742..8afd76da 100644
--- a/Documentation/btrfs-balance.asciidoc
+++ b/Documentation/btrfs-balance.asciidoc
@@ -354,8 +354,16 @@  This should lead to decrease in the 'total' numbers in the *btrfs filesystem df*
 
 EXIT STATUS
 -----------
-*btrfs balance* returns a zero exit status if it succeeds. Non zero is
-returned in case of failure.
+Unless indicated otherwise below, all *btrfs balance* subcommands
+return a zero exit status if they succeed, and non zero in case of
+failure.
+
+The *pause*, *cancel*, and *resume* subcommands exit with a status of
+*2* if they fail because a balance operation was not running.
+
+The *status* subcommand exits with a status of *0* if a balance
+operation is not running, *1* if the command-line usage is incorrect
+or a balance operation is still running, and *2* on other errors.
 
 AVAILABILITY
 ------------