mirror of
https://git.kernel.org/pub/scm/fs/ext2/e2fsprogs.git
synced 2024-11-24 18:43:53 +08:00
5ce368f07c
Implement online fsck for ext* filesystems which live on LVM-managed logical volumes. The basic strategy mirrors that of e2croncheck -- create a snapshot, fsck the snapshot, report whatever errors appear, remove snapshot. Unlike e2croncheck, this utility accepts any LVM device path, knows about snapshots running out of space, and can call fstrim having validated that the fs metadata is ok. Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com> Signed-off-by: Theodore Ts'o <tytso@mit.edu>
61 lines
1.7 KiB
Groff
61 lines
1.7 KiB
Groff
.TH E2SCRUB 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
|
|
.SH NAME
|
|
e2scrub - check the contents of a mounted ext[234] filesystem
|
|
.SH SYNOPSYS
|
|
.B
|
|
e2scrub [OPTION] MOUNTPOINT | DEVICE
|
|
.SH DESCRIPTION
|
|
.B e2scrub
|
|
attempts to check (but not repair) all metadata in a mounted ext[234]
|
|
filesystem if the filesystem resides on a 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
|
|
.IR lvname ".e2scrub"
|
|
and
|
|
.B udev
|
|
will not create symbolic links to it under
|
|
.IR /dev/disk .
|
|
Every attempt will be made to remove the snapshots prior to running
|
|
.BR e2scrub ,
|
|
but in a dire situation it may be necessary to remove the snapshot manually.
|
|
|
|
If no errors are found,
|
|
.B 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 filesystem should be taken offline and
|
|
.B e2fsck
|
|
run as soon as possible, because
|
|
.B e2scrub
|
|
does not fix corruptions.
|
|
If the filesystem is not repaired,
|
|
.B e2fsck
|
|
will be run before the next mount.
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB-r\fR
|
|
Remove the e2scrub snapshot and exit without checking anything.
|
|
.TP
|
|
\fB-t\fR
|
|
Run
|
|
.B
|
|
fstrim(1)
|
|
on the mounted filesystem if no errors are found.
|
|
.TP
|
|
\fB-V\fR
|
|
Print version information and exit.
|
|
.SH EXIT CODE
|
|
The exit codes are the same as in
|
|
.BR e2fsck (8)
|
|
.SH SEE ALSO
|
|
.BR e2fsck (8)
|
|
.SH AUTHOR
|
|
Darrick J. Wong <darrick.wong@oracle.com>
|
|
.SH COPYRIGHT
|
|
Copyright ©2018 Oracle. License is GPLv2+. <http://www.gnu.org/licenses/gpl-2.0.html>
|