[PATCH v2] xfs_repair: update the manual content about xfs_repair exit status
Zorro Lang
zlang at redhat.com
Tue Sep 13 10:54:36 CDT 2016
The man 8 xfs_repair said "xfs_repair run without the -n option will
always return a status code of 0". That's not correct.
xfs_repair will return 2 if it finds a fs log which needs to be
replayed or cleared, 1 if runtime error is encountered, and 0 for
all other cases.
Signed-off-by: Zorro Lang <zlang at redhat.com>
---
Hi,
V2 patch did below things:
- change the description for xfs_repair
- remove the description for "xfs_repair -L"
Thanks,
Zorro
man/man8/xfs_repair.8 | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)
diff --git a/man/man8/xfs_repair.8 b/man/man8/xfs_repair.8
index 1b4d9e3..e45fd90 100644
--- a/man/man8/xfs_repair.8
+++ b/man/man8/xfs_repair.8
@@ -504,12 +504,17 @@ that is known to be free. The entry is therefore invalid and is deleted.
This message refers to a large directory.
If the directory were small, the message would read "junking entry ...".
.SH EXIT STATUS
+.TP
.B xfs_repair \-n
(no modify node)
will return a status of 1 if filesystem corruption was detected and
0 if no filesystem corruption was detected.
+.TP
.B xfs_repair
-run without the \-n option will always return a status code of 0.
+run without the \-n option will return a status code of 2 if it finds a
+filesystem log which needs to be replayed(by a mount/umount cycle) or
+cleared(by -L option), 1 if a runtime error is encountered, and 0 in all
+other cases, whether or not filesystem corruption was detected.
.SH BUGS
The filesystem to be checked and repaired must have been
unmounted cleanly using normal system administration procedures
--
2.7.4
More information about the xfs
mailing list