|
 |
d9305b |
commit f81fd07bdf8cf9f87c603754e3e5b89ed5445bf8
|
|
|
d9305b |
Author: Andrew Price <anprice@redhat.com>
|
|
|
d9305b |
Date: Thu Oct 17 13:12:31 2019 +0100
|
|
|
d9305b |
|
|
|
d9305b |
fsck.gfs2(8): Manpage updates
|
|
|
d9305b |
|
|
|
d9305b |
- Improve style consistency with the other manpages
|
|
|
d9305b |
- Remove an unnecessary paragraph that gives a misleading impression of
|
|
|
d9305b |
gfs2's device atomicity requirements (rhbz#1693000)
|
|
|
d9305b |
- Add "See Also" section
|
|
|
d9305b |
- "fsck.gfs" -> "fsck.gfs2"
|
|
|
d9305b |
- Various other language tweaks
|
|
|
d9305b |
|
|
|
d9305b |
Signed-off-by: Andrew Price <anprice@redhat.com>
|
|
|
d9305b |
|
|
|
d9305b |
diff --git a/gfs2/man/fsck.gfs2.8 b/gfs2/man/fsck.gfs2.8
|
|
|
d9305b |
index b2b326fb..9e9f9250 100644
|
|
|
d9305b |
--- a/gfs2/man/fsck.gfs2.8
|
|
|
d9305b |
+++ b/gfs2/man/fsck.gfs2.8
|
|
|
d9305b |
@@ -1,11 +1,11 @@
|
|
|
d9305b |
.TH fsck.gfs2 8
|
|
|
d9305b |
|
|
|
d9305b |
.SH NAME
|
|
|
d9305b |
-fsck.gfs2 - Offline GFS and GFS2 file system checker
|
|
|
d9305b |
+fsck.gfs2 - offline GFS and GFS2 file system checker
|
|
|
d9305b |
|
|
|
d9305b |
.SH SYNOPSIS
|
|
|
d9305b |
.B fsck.gfs2
|
|
|
d9305b |
-[\fIOPTION\fR]... \fIDEVICE\fR
|
|
|
d9305b |
+[\fIoptions\fR] \fIdevice\fR
|
|
|
d9305b |
|
|
|
d9305b |
.SH WARNING
|
|
|
d9305b |
All computers \fImust\fP have the filesystem unmounted before running
|
|
|
d9305b |
@@ -13,30 +13,22 @@ fsck.gfs2. Failure to unmount from all nodes in a cluster will likely result
|
|
|
d9305b |
in filesystem corruption.
|
|
|
d9305b |
|
|
|
d9305b |
.SH DESCRIPTION
|
|
|
d9305b |
-fsck.gfs2 will check that the GFS or GFS2 file system on a device is structurally valid.
|
|
|
d9305b |
-It should not be run on a mounted file system. If file system corruption is
|
|
|
d9305b |
-detected, it will attempt to repair the file system. There is a limit to what
|
|
|
d9305b |
-fsck.gfs2 can do. If important file system structures are destroyed, such that
|
|
|
d9305b |
-the checker cannot determine what the repairs should be, reparations could
|
|
|
d9305b |
-fail.
|
|
|
d9305b |
+fsck.gfs2 will check that the GFS or GFS2 file system on a device is
|
|
|
d9305b |
+structurally valid. It should not be run on a mounted file system. If file
|
|
|
d9305b |
+system corruption is detected, it will attempt to repair the file system.
|
|
|
d9305b |
+There is a limit to what fsck.gfs2 can do. If important file system structures
|
|
|
d9305b |
+are destroyed, such that the checker cannot determine what the repairs should
|
|
|
d9305b |
+be, reparations could fail.
|
|
|
d9305b |
|
|
|
d9305b |
-GFS2 is a journaled file system, and as such should be able to repair damage to
|
|
|
d9305b |
-the file system on its own. However, faulty hardware has the ability to write
|
|
|
d9305b |
-incomplete blocks to a file system thereby causing corruption that GFS2 cannot
|
|
|
d9305b |
-fix. The first step to ensuring a healthy file system is the selection of
|
|
|
d9305b |
-reliable hardware (i.e. storage systems that will write complete blocks - even
|
|
|
d9305b |
-in the event of power failure).
|
|
|
d9305b |
-
|
|
|
d9305b |
-Note: Most file system checkers will not check the file system if it is
|
|
|
d9305b |
-"clean" (i.e. unmounted since the last use). The fsck.gfs program behaves
|
|
|
d9305b |
-differently because the storage may be shared among several nodes in a
|
|
|
d9305b |
-cluster, and therefore problems may have been introduced on a different
|
|
|
d9305b |
-computer. Therefore, fsck.gfs2 will always check the file system unless
|
|
|
d9305b |
-the -p (preen) option is used, in which case it follows special rules
|
|
|
d9305b |
+Other file system checkers will not check the file system if it is "clean"
|
|
|
d9305b |
+(i.e. unmounted since the last use). With gfs2, storage may be shared among
|
|
|
d9305b |
+several nodes in a cluster, and therefore problems may have been introduced on
|
|
|
d9305b |
+a different computer. Therefore, fsck.gfs2 will always check the file system
|
|
|
d9305b |
+unless the -p (preen) option is used, in which case it follows special rules
|
|
|
d9305b |
(see below).
|
|
|
d9305b |
|
|
|
d9305b |
-fsck.gfs2 will log to the system log on start and exit to aid debugging and
|
|
|
d9305b |
-administration.
|
|
|
d9305b |
+fsck.gfs2 will log a message to the system log on start and exit to aid
|
|
|
d9305b |
+debugging and administration.
|
|
|
d9305b |
.SH OPTIONS
|
|
|
d9305b |
.TP
|
|
|
d9305b |
\fB-a\fP
|
|
|
d9305b |
@@ -86,3 +78,8 @@ Yes to all questions. By specifying this option, fsck.gfs2 will not prompt befor
|
|
|
d9305b |
changes.
|
|
|
d9305b |
|
|
|
d9305b |
This option may not be used with the \fB-n\fP or \fB-p\fP/\fB-a\fP options.
|
|
|
d9305b |
+
|
|
|
d9305b |
+.SH SEE ALSO
|
|
|
d9305b |
+.BR gfs2 (5),
|
|
|
d9305b |
+.BR gfs2_jadd (8),
|
|
|
d9305b |
+.BR gfs2_grow (8)
|