summaryrefslogtreecommitdiffstats
path: root/disk-utils/fsck.8
diff options
context:
space:
mode:
authorKarel Zak2016-09-06 14:49:48 +0200
committerKarel Zak2016-09-06 14:49:48 +0200
commit7208ef864bf903ae4eb16491e7cfd24cf792baad (patch)
tree152f94e230b391cf22b3277be484c49ec73e5413 /disk-utils/fsck.8
parentlibsmartcols: extend wrapnl sample (diff)
downloadkernel-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.877
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/