| 1 |
.\" -*- nroff -*- |
| 2 |
.\" This file may be copied under the terms of the GNU Public License. |
| 3 |
.\" |
| 4 |
.TH E2MMPSTATUS 8 "March 2025" "E2fsprogs version 1.47.4" |
| 5 |
.SH NAME |
| 6 |
e2mmpstatus \- Check MMP status of an ext4 file system |
| 7 |
.SH SYNOPSIS |
| 8 |
.BR e2mmpstatus " [" \-i ] |
| 9 |
.RI < file system > |
| 10 |
.SH OPTIONS |
| 11 |
.TP |
| 12 |
.B \-i |
| 13 |
prints out the MMP information rather than check it. |
| 14 |
.SH DESCRIPTION |
| 15 |
.B e2mmpstatus |
| 16 |
is used to check Multiple-Mount Protection (MMP) status of an ext4 |
| 17 |
file system with the |
| 18 |
.B mmp |
| 19 |
feature enabled. The specified |
| 20 |
.I file system |
| 21 |
can be a device name (e.g. |
| 22 |
.IR /dev/hdc1 ", " /dev/sdb2 ), |
| 23 |
or an ext4 file system label or UUID, for example |
| 24 |
.B UUID=8868abf6-88c5-4a83-98b8-bfc24057f7bd |
| 25 |
or |
| 26 |
.BR LABEL=root . |
| 27 |
By default, the |
| 28 |
.B e2mmpstatus |
| 29 |
program checks whether it is safe to mount the file system without taking |
| 30 |
the risk of mounting it more than once. |
| 31 |
.PP |
| 32 |
MMP (multiple-mount protection) is a feature that adds protection against |
| 33 |
the file system being modified simultaneously by more than one node. |
| 34 |
It is NOT safe to mount a file system when one of the following conditions |
| 35 |
is true: |
| 36 |
.br |
| 37 |
1. e2fsck is running on the file system. |
| 38 |
.br |
| 39 |
2. the file system is in use by another node. |
| 40 |
.br |
| 41 |
3. The MMP block is corrupted or cannot be read for some reason. |
| 42 |
.br |
| 43 |
The |
| 44 |
.B e2mmpstatus |
| 45 |
program might wait for some time to see whether the MMP block is being |
| 46 |
updated by any node during this period. The time taken depends on how |
| 47 |
frequently the MMP block is being written by the other node. |
| 48 |
.SH EXIT CODE |
| 49 |
The exit code returned by |
| 50 |
.B e2mmpstatus |
| 51 |
is 0 when it is safe to mount the file system, 1 when the MMP block shows |
| 52 |
the file system is in use on another node and it is NOT safe to mount |
| 53 |
the file system, and 2 if some other failure occurred that prevents the |
| 54 |
check from properly detecting the current MMP status. |
| 55 |
.SH SEE ALSO |
| 56 |
.BR dumpe2fs (8), |
| 57 |
.BR e2fsck (8), |
| 58 |
.BR fstab (5), |
| 59 |
.BR fsck (8), |