mirror of
https://git.kernel.org/pub/scm/fs/ext2/e2fsprogs.git
synced 2024-11-27 12:04:43 +08:00
6a9c8e0b96
Change a two-fonts macro to a one-font one, when there is only one genuine argument. Separate a punctuation mark or a section number from the only argument to make two for a two-fonts macro. Remove an unneeded escape in front of a horizontal tab character. Correct the unit for distance from 'in' to 'i'. Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is> Signed-off-by: Theodore Ts'o <tytso@mit.edu>
60 lines
1.8 KiB
Groff
60 lines
1.8 KiB
Groff
.\" -*- nroff -*-
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
.\"
|
|
.TH E2MMPSTATUS 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
|
|
.SH NAME
|
|
e2mmpstatus \- Check MMP status of an ext4 filesystem
|
|
.SH SYNOPSIS
|
|
.BR e2mmpstatus " [" \-i ]
|
|
.RI < filesystem >
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-i
|
|
prints out the MMP information rather than check it.
|
|
.SH DESCRIPTION
|
|
.B e2mmpstatus
|
|
is used to check Multiple-Mount Protection (MMP) status of an ext4
|
|
filesystem with the
|
|
.B mmp
|
|
feature enabled. The specified
|
|
.I filesystem
|
|
can be a device name (e.g.
|
|
.IR /dev/hdc1 ", " /dev/sdb2 ),
|
|
or an ext4 filesystem label or UUID, for example
|
|
.B UUID=8868abf6-88c5-4a83-98b8-bfc24057f7bd
|
|
or
|
|
.BR LABEL=root .
|
|
By default, the
|
|
.B e2mmpstatus
|
|
program checks whether it is safe to mount the filesystem without taking
|
|
the risk of mounting it more than once.
|
|
.PP
|
|
MMP (multiple-mount protection) is a feature that adds protection against
|
|
the filesystem being modified simultaneously by more than one node.
|
|
It is NOT safe to mount a filesystem when one of the following conditions
|
|
is true:
|
|
.br
|
|
1. e2fsck is running on the filesystem.
|
|
.br
|
|
2. the filesystem is in use by another node.
|
|
.br
|
|
3. The MMP block is corrupted or cannot be read for some reason.
|
|
.br
|
|
The
|
|
.B e2mmpstatus
|
|
program might wait for some time to see whether the MMP block is being
|
|
updated by any node during this period. The time taken depends on how
|
|
frequently the MMP block is being written by the other node.
|
|
.SH EXIT CODE
|
|
The exit code returned by
|
|
.B e2mmpstatus
|
|
is 0 when it is safe to mount the filesystem, 1 when the MMP block shows
|
|
the filesystem is in use on another node and it is NOT safe to mount
|
|
the filesystem, and 2 if some other failure occurred that prevents the
|
|
check from properly detecting the current MMP status.
|
|
.SH SEE ALSO
|
|
.BR dumpe2fs (8),
|
|
.BR e2fsck (8),
|
|
.BR fstab (5),
|
|
.BR fsck (8),
|