diff options
author | Karel Zak | 2016-09-06 14:49:48 +0200 |
---|---|---|
committer | Karel Zak | 2016-09-06 14:49:48 +0200 |
commit | 7208ef864bf903ae4eb16491e7cfd24cf792baad (patch) | |
tree | 152f94e230b391cf22b3277be484c49ec73e5413 /disk-utils/fsck.8 | |
parent | libsmartcols: extend wrapnl sample (diff) | |
download | kernel-qcow2-util-linux-7208ef864bf903ae4eb16491e7cfd24cf792baad.tar.gz kernel-qcow2-util-linux-7208ef864bf903ae4eb16491e7cfd24cf792baad.tar.xz kernel-qcow2-util-linux-7208ef864bf903ae4eb16491e7cfd24cf792baad.zip |
fsck: remove fs-specific options from man page
Let's force users to read fs-specific man pages rather than try to be
smart and maintain some non-fsck options in fsck.8.
Reported-by: Matej Cepl <mcepl@redhat.com>
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'disk-utils/fsck.8')
-rw-r--r-- | disk-utils/fsck.8 | 77 |
1 files changed, 12 insertions, 65 deletions
diff --git a/disk-utils/fsck.8 b/disk-utils/fsck.8 index 2b3efef5c..ca83ce91a 100644 --- a/disk-utils/fsck.8 +++ b/disk-utils/fsck.8 @@ -309,23 +309,22 @@ Don't show the title on startup. .B \-V Produce verbose output, including all filesystem-specific commands that are executed. -.TP -.B fs-specific-options -Options which are not understood by -.B fsck -are passed to the filesystem-specific checker. These options +.SH FILESYSTEM SPECIFIC OPTIONS +.B Options which are not understood by fsck are passed to the filesystem-specific checker! +.PP +These options .B must not take arguments, as there is no way for .B fsck to be able to properly guess which options take arguments and which don't. -.IP +.PP Options and arguments which follow the .B \-\- are treated as filesystem-specific options to be passed to the filesystem-specific checker. -.IP +.PP Please note that \fBfsck\fR is not designed to pass arbitrarily complicated options to filesystem-specific checkers. If you're doing something complicated, please just @@ -337,62 +336,9 @@ what you expect, You're almost certainly doing something that you shouldn't be doing with .BR fsck . -.PP Options to different filesystem-specific fsck's are not standardized. -If in doubt, please consult the man pages of the filesystem-specific -checker. Although not guaranteed, the following options are supported -by most filesystem checkers: -.TP -.B \-a -Automatically repair the filesystem without any questions (use -this option with caution). Note that -.BR e2fsck (8) -supports -.B \-a -for backward compatibility only. This option is mapped to -.BR e2fsck 's -.B \-p -option which is safe to use, unlike the -.B \-a -option that some filesystem checkers support. -.TP -.B \-n -For some filesystem-specific checkers, the -.B \-n -option will cause the fs-specific fsck to avoid attempting to repair any -problems, but simply report such problems to stdout. This is however -not true for all filesystem-specific checkers. In particular, -.BR fsck.reiserfs (8) -will not report any corruption if given this option. -.BR fsck.minix (8) -does not support the -.B \-n -option at all. -.TP -.B \-r -Interactively repair the filesystem (ask for confirmations). Note: It -is generally a bad idea to use this option if multiple fsck's are being -run in parallel. Also note that this is -.BR e2fsck 's -default behavior; it supports this option for backward compatibility -reasons only. -.TP -.B \-y -For some filesystem-specific checkers, the -.B \-y -option will cause the fs-specific fsck to always attempt to fix any -detected filesystem corruption automatically. Sometimes an expert may -be able to do better driving the fsck manually. Note that -.B not -all filesystem-specific checkers implement this option. In particular -.BR fsck.minix (8) -and -.BR fsck.cramfs (8) -do not support the -.B \-y -option as of this writing. .SH FILES -.IR /etc/fstab . +.IR /etc/fstab .SH ENVIRONMENT VARIABLES The .B fsck @@ -454,10 +400,11 @@ or .BR fsck.xfs (8), .BR reiserfsck (8). .ad -.SH AUTHOR -.MT tytso@mit.edu -Theodore Ts'o -.ME +.SH AUTHORS +.nf +Theodore Ts'o <tytso@mit.edu> +Karel Zak <kzak@redhat.com> +.fi. .SH AVAILABILITY The fsck command is part of the util-linux package and is available from .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |