bionic (8) fsck.gfs2.8.gz

Provided by: gfs2-utils_3.1.9-2ubuntu1_amd64 bug

NAME

       fsck.gfs2 - Offline GFS and GFS2 file system checker

SYNOPSIS

       fsck.gfs2 [OPTION]... DEVICE

WARNING

       All  computers  must have the filesystem unmounted before running fsck.gfs2.  Failure to unmount from all
       nodes in a cluster will likely result in filesystem corruption.

DESCRIPTION

       fsck.gfs2 will check that the GFS or GFS2 file system on a device is structurally valid.  It  should  not
       be  run  on  a mounted file system.  If file system corruption is detected, it will attempt to repair the
       file system.  There is a limit to what fsck.gfs2  can  do.   If  important  file  system  structures  are
       destroyed, such that the checker cannot determine what the repairs should be, reparations could fail.

       GFS2  is  a  journaled file system, and as such should be able to repair damage to the file system on its
       own.  However, faulty hardware has the ability to write  incomplete  blocks  to  a  file  system  thereby
       causing  corruption  that  GFS2  cannot  fix.   The  first  step to ensuring a healthy file system is the
       selection of reliable hardware (i.e. storage systems that will write complete blocks - even in the  event
       of power failure).

       Note: Most file system checkers will not check the file system if it is "clean" (i.e. unmounted since the
       last use).  The fsck.gfs program behaves differently because the storage  may  be  shared  among  several
       nodes  in a cluster, and therefore problems may have been introduced on a different computer.  Therefore,
       fsck.gfs2 will always check the file system unless the -p (preen)  option  is  used,  in  which  case  it
       follows special rules (see below).

       fsck.gfs2 will log to the system log on start and exit to aid debugging and administration.

OPTIONS

       -a     Same as the -p (preen) option.

       -f     Force checking even if the file system seems clean.

       -h     Help.

              This prints out the proper command line usage syntax.

       -q     Quiet.

       -n     No to all questions.

              By  specifying  this option, fsck.gfs2 will only show the changes that would be made, but not make
              any changes to the filesystem.

       -p     Preen (same as -a: automatically repair the file system if  it  is  dirty,  and  safe  to  do  so,
              otherwise exit.)

              Note:  If  the  file system has locking protocol lock_nolock, the file system is considered a non-
              shared storage device and the fsck is deemed safe.  However, fsck.gfs2 does not  know  whether  it
              was called automatically from the init process, due to options in the /etc/fstab file.  Therefore,
              if the locking protocol is lock_dlm and -a or -p was specified, fsck.gfs2 cannot determine whether
              the disk is mounted by other nodes in the cluster.  Therefore, the fsck is deemed to be unsafe and
              a warning is given if any damage or dirty journals are found.   In  that  case,  the  file  system
              should be unmounted from all nodes in the cluster and fsck.gfs2 should be run manually without the
              -a or -p options.

       -V     Version.

              Print out the program version information.

       -v     Verbose operation.

              Print more information while running.

       -y     Yes to all questions.

              By specifying this option, fsck.gfs2 will not prompt before making changes.

                                                                                                    fsck.gfs2(8)