NAME

       e2scrub - check the contents of a mounted ext[234] file system

SYNOPSYS

       e2scrub [OPTION] MOUNTPOINT | DEVICE

DESCRIPTION

       e2scrub  attempts to check (but not repair) all metadata in a mounted ext[234] file system
       if the file system resides on an LVM logical volume.  The block device of the LVM  logical
       volume can also be passed in.

       This program snapshots the volume and runs a file system check on the snapshot to look for
       corruption errors.  The LVM volume group must have at least 256MiB of unallocated space to
       dedicate  to  the  snapshot  or  the logical volume will be skipped.  The snapshot will be
       named lvname.e2scrub and udev will not create symbolic links to it under /dev/disk.  Every
       attempt  will  be  made  to  remove  the snapshots prior to running e2scrub, but in a dire
       situation it may be necessary to remove the snapshot manually.

       If no errors are found, fstrim can be called on the file system  if  it  is  mounted.   If
       errors are found, the file system will be marked as having errors.  The file system should
       be taken offline and e2fsck run  as  soon  as  possible,  because  e2scrub  does  not  fix
       corruptions.   If  the  file  system  is  not repaired, e2fsck will be run before the next
       mount.

OPTIONS

       -n     Print what commands e2scrub would execute to check the  file  system.   (Note:  the
              commands  will  not  actually be executed; however, since e2scrub needs to run some
              commands to query the system to determine what commands would be executed, it still
              needs to be run as root.)

       -r     Remove the e2scrub snapshot and exit without checking anything.

       -t     Run fstrim(1) on the mounted file system if no errors are found.

       -V     Print version information and exit.

EXIT CODE

       The exit codes are the same as in e2fsck(8)

SEE ALSO

       e2fsck(8)

AUTHOR

       Darrick J. Wong <darrick.wong@oracle.com>

COPYRIGHT

       Copyright ©2018 Oracle.  License is GPLv2+. <http://www.gnu.org/licenses/gpl-2.0.html>