1 Prevent an ext4 filesystem from being mounted multiple times.
2 A sequence number is stored on disk and is periodically updated (every 5
3 seconds by default) by a mounted filesystem.
4 At mount time, we now wait for s_mmp_update_interval seconds to make sure
5 that the MMP sequence does not change.
6 In case of failure, the nodename, bdevname and the time at which the MMP
7 block was last updated is displayed.
8 Move all mmp code to a dedicated file (mmp.c).
10 Signed-off-by: Andreas Dilger <adilger <at> whamcloud.com>
11 Signed-off-by: Johann Lombardi <johann <at> whamcloud.com>
13 fs/ext4/Makefile | 3 +-
14 fs/ext4/ext4.h | 76 ++++++++++++-
15 fs/ext4/mmp.c | 351 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
16 fs/ext4/super.c | 18 +++-
17 4 files changed, 444 insertions(+), 4 deletions(-)
18 create mode 100644 fs/ext4/mmp.c
20 Index: linux-stage/fs/ext4/Makefile
21 ===================================================================
22 --- linux-stage.orig/fs/ext4/Makefile
23 +++ linux-stage/fs/ext4/Makefile
24 @@ -6,7 +6,8 @@ obj-$(CONFIG_EXT4_FS) += ext4.o
26 ext4-y := balloc.o bitmap.o dir.o file.o fsync.o ialloc.o inode.o iopen.o \
27 ioctl.o namei.o super.o symlink.o hash.o resize.o extents.o \
28 - ext4_jbd2.o migrate.o mballoc.o block_validity.o move_extent.o
29 + ext4_jbd2.o migrate.o mballoc.o block_validity.o move_extent.o \
32 ext4-$(CONFIG_EXT4_FS_XATTR) += xattr.o xattr_user.o xattr_trusted.o
33 ext4-$(CONFIG_EXT4_FS_POSIX_ACL) += acl.o
34 Index: linux-stage/fs/ext4/ext4.h
35 ===================================================================
36 --- linux-stage.orig/fs/ext4/ext4.h
37 +++ linux-stage/fs/ext4/ext4.h
38 @@ -878,7 +878,7 @@ struct ext4_super_block {
39 __le16 s_want_extra_isize; /* New inodes should reserve # bytes */
40 __le32 s_flags; /* Miscellaneous flags */
41 __le16 s_raid_stride; /* RAID stride */
42 - __le16 s_mmp_interval; /* # seconds to wait in MMP checking */
43 + __le16 s_mmp_update_interval; /* # seconds to wait in MMP checking */
44 __le64 s_mmp_block; /* Block for multi-mount protection */
45 __le32 s_raid_stripe_width; /* blocks on all data disks (N*stride)*/
46 __u8 s_log_groups_per_flex; /* FLEX_BG group size */
47 @@ -1032,6 +1032,9 @@ struct ext4_sb_info {
49 /* workqueue for dio unwritten */
50 struct workqueue_struct *dio_unwritten_wq;
52 + /* Kernel thread for multiple mount protection */
53 + struct task_struct *s_mmp_tsk;
56 static inline struct ext4_sb_info *EXT4_SB(struct super_block *sb)
57 @@ -1169,7 +1172,8 @@ static inline void ext4_clear_inode_stat
58 EXT4_FEATURE_INCOMPAT_META_BG| \
59 EXT4_FEATURE_INCOMPAT_EXTENTS| \
60 EXT4_FEATURE_INCOMPAT_64BIT| \
61 - EXT4_FEATURE_INCOMPAT_FLEX_BG)
62 + EXT4_FEATURE_INCOMPAT_FLEX_BG| \
63 + EXT4_FEATURE_INCOMPAT_MMP)
64 #define EXT4_FEATURE_RO_COMPAT_SUPP (EXT4_FEATURE_RO_COMPAT_SPARSE_SUPER| \
65 EXT4_FEATURE_RO_COMPAT_LARGE_FILE| \
66 EXT4_FEATURE_RO_COMPAT_GDT_CSUM| \
67 @@ -1376,6 +1380,67 @@ void ext4_get_group_no_and_offset(struct
68 extern struct proc_dir_entry *ext4_proc_root;
71 + * This structure will be used for multiple mount protection. It will be
72 + * written into the block number saved in the s_mmp_block field in the
73 + * superblock. Programs that check MMP should assume that if
74 + * SEQ_FSCK (or any unknown code above SEQ_MAX) is present then it is NOT safe
75 + * to use the filesystem, regardless of how old the timestamp is.
77 +#define EXT4_MMP_MAGIC 0x004D4D50U /* ASCII for MMP */
78 +#define EXT4_MMP_SEQ_CLEAN 0xFF4D4D50U /* mmp_seq value for clean unmount */
79 +#define EXT4_MMP_SEQ_FSCK 0xE24D4D50U /* mmp_seq value when being fscked */
80 +#define EXT4_MMP_SEQ_MAX 0xE24D4D4FU /* maximum valid mmp_seq value */
83 + __le32 mmp_magic; /* Magic number for MMP */
84 + __le32 mmp_seq; /* Sequence no. updated periodically */
87 + * mmp_time, mmp_nodename & mmp_bdevname are only used for information
88 + * purposes and do not affect the correctness of the algorithm
90 + __le64 mmp_time; /* Time last updated */
91 + char mmp_nodename[64]; /* Node which last updated MMP block */
92 + char mmp_bdevname[32]; /* Bdev which last updated MMP block */
95 + * mmp_check_interval is used to verify if the MMP block has been
96 + * updated on the block device. The value is updated based on the
97 + * maximum time to write the MMP block during an update cycle.
99 + __le16 mmp_check_interval;
102 + __le32 mmp_pad2[227];
105 +/* arguments passed to the mmp thread */
107 + struct buffer_head *bh; /* bh from initial read_mmp_block() */
108 + struct super_block *sb; /* super block of the fs */
112 + * Check interval multiplier
113 + * The MMP block is written every update interval and initially checked every
114 + * update interval x the multiplier (the value is then adapted based on the
115 + * write latency). The reason is that writes can be delayed under load and we
116 + * don't want readers to incorrectly assume that the filesystem is no longer
119 +#define EXT4_MMP_CHECK_MULT 2UL
122 + * Minimum interval for MMP checking in seconds.
124 +#define EXT4_MMP_MIN_CHECK_INTERVAL 5UL
127 + * Maximum interval for MMP checking in seconds.
129 +#define EXT4_MMP_MAX_CHECK_INTERVAL 300UL
132 * Function prototypes
135 @@ -1547,6 +1612,10 @@ extern void __ext4_warning(struct super_
136 #define ext4_warning(sb, message...) __ext4_warning(sb, __func__, ## message)
137 extern void ext4_msg(struct super_block *, const char *, const char *, ...)
138 __attribute__ ((format (printf, 3, 4)));
139 +extern void __dump_mmp_msg(struct super_block *, struct mmp_struct *mmp,
140 + const char *, const char *);
141 +#define dump_mmp_msg(sb, mmp, msg) __dump_mmp_msg(sb, mmp, __func__, msg)
143 extern void ext4_grp_locked_error(struct super_block *, ext4_group_t,
144 const char *, const char *, ...)
145 __attribute__ ((format (printf, 4, 5)));
146 @@ -1784,6 +1853,9 @@ static inline void ext4_unlock_group(str
147 spin_unlock(ext4_group_lock_ptr(sb, group));
151 +extern int ext4_multi_mount_protect(struct super_block *, ext4_fsblk_t);
154 * Inodes and files operations
156 Index: linux-stage/fs/ext4/mmp.c
157 ===================================================================
159 +++ linux-stage/fs/ext4/mmp.c
161 +#include <linux/fs.h>
162 +#include <linux/random.h>
163 +#include <linux/buffer_head.h>
164 +#include <linux/utsname.h>
165 +#include <linux/kthread.h>
170 + * Write the MMP block using WRITE_SYNC to try to get the block on-disk
173 +static int write_mmp_block(struct buffer_head *bh)
175 + mark_buffer_dirty(bh);
177 + bh->b_end_io = end_buffer_write_sync;
179 + submit_bh(WRITE_SYNC, bh);
180 + wait_on_buffer(bh);
181 + if (unlikely(!buffer_uptodate(bh)))
188 + * Read the MMP block. It _must_ be read from disk and hence we clear the
189 + * uptodate flag on the buffer.
191 +static int read_mmp_block(struct super_block *sb, struct buffer_head **bh,
192 + ext4_fsblk_t mmp_block)
194 + struct mmp_struct *mmp;
197 + clear_buffer_uptodate(*bh);
199 + /* This would be sb_bread(sb, mmp_block), except we need to be sure
200 + * that the MD RAID device cache has been bypassed, and that the read
201 + * is not blocked in the elevator. */
203 + *bh = sb_getblk(sb, mmp_block);
207 + (*bh)->b_end_io = end_buffer_read_sync;
208 + submit_bh(READ_SYNC, *bh);
209 + wait_on_buffer(*bh);
210 + if (!buffer_uptodate(*bh)) {
216 + ext4_warning(sb, "Error while reading MMP block %llu",
221 + mmp = (struct mmp_struct *)((*bh)->b_data);
222 + if (le32_to_cpu(mmp->mmp_magic) != EXT4_MMP_MAGIC)
229 + * Dump as much information as possible to help the admin.
231 +void __dump_mmp_msg(struct super_block *sb, struct mmp_struct *mmp,
232 + const char *function, const char *msg)
234 + __ext4_warning(sb, function, "%s", msg);
235 + __ext4_warning(sb, function,
236 + "MMP failure info: last update time: %llu, last update "
237 + "node: %s, last update device: %s\n",
238 + (long long unsigned int) le64_to_cpu(mmp->mmp_time),
239 + mmp->mmp_nodename, mmp->mmp_bdevname);
243 + * kmmpd will update the MMP sequence every s_mmp_update_interval seconds
245 +static int kmmpd(void *data)
247 + struct super_block *sb = ((struct mmpd_data *) data)->sb;
248 + struct buffer_head *bh = ((struct mmpd_data *) data)->bh;
249 + struct ext4_super_block *es = EXT4_SB(sb)->s_es;
250 + struct mmp_struct *mmp;
251 + ext4_fsblk_t mmp_block;
253 + unsigned long failed_writes = 0;
254 + int mmp_update_interval = le16_to_cpu(es->s_mmp_update_interval);
255 + unsigned mmp_check_interval;
256 + unsigned long last_update_time;
257 + unsigned long diff;
260 + mmp_block = le64_to_cpu(es->s_mmp_block);
261 + mmp = (struct mmp_struct *)(bh->b_data);
262 + mmp->mmp_time = cpu_to_le64(get_seconds());
264 + * Start with the higher mmp_check_interval and reduce it if
265 + * the MMP block is being updated on time.
267 + mmp_check_interval = max(EXT4_MMP_CHECK_MULT * mmp_update_interval,
268 + EXT4_MMP_MIN_CHECK_INTERVAL);
269 + mmp->mmp_check_interval = cpu_to_le16(mmp_check_interval);
270 + bdevname(bh->b_bdev, mmp->mmp_bdevname);
272 + memcpy(mmp->mmp_nodename, init_utsname()->sysname,
273 + sizeof(mmp->mmp_nodename));
275 + while (!kthread_should_stop()) {
276 + if (++seq > EXT4_MMP_SEQ_MAX)
279 + mmp->mmp_seq = cpu_to_le32(seq);
280 + mmp->mmp_time = cpu_to_le64(get_seconds());
281 + last_update_time = jiffies;
283 + retval = write_mmp_block(bh);
285 + * Don't spew too many error messages. Print one every
286 + * (s_mmp_update_interval * 60) seconds.
288 + if (retval && (failed_writes % 60) == 0) {
289 + ext4_error(sb, "Error writing to MMP block");
293 + if (!(le32_to_cpu(es->s_feature_incompat) &
294 + EXT4_FEATURE_INCOMPAT_MMP)) {
295 + ext4_warning(sb, "kmmpd being stopped since MMP feature"
296 + " has been disabled.");
297 + EXT4_SB(sb)->s_mmp_tsk = NULL;
301 + if (sb->s_flags & MS_RDONLY) {
302 + ext4_warning(sb, "kmmpd being stopped since filesystem "
303 + "has been remounted as readonly.");
304 + EXT4_SB(sb)->s_mmp_tsk = NULL;
308 + diff = jiffies - last_update_time;
309 + if (diff < mmp_update_interval * HZ)
310 + schedule_timeout_interruptible(mmp_update_interval *
314 + * We need to make sure that more than mmp_check_interval
315 + * seconds have not passed since writing. If that has happened
316 + * we need to check if the MMP block is as we left it.
318 + diff = jiffies - last_update_time;
319 + if (diff > mmp_check_interval * HZ) {
320 + struct buffer_head *bh_check = NULL;
321 + struct mmp_struct *mmp_check;
323 + retval = read_mmp_block(sb, &bh_check, mmp_block);
325 + ext4_error(sb, "error reading MMP data: %d",
328 + EXT4_SB(sb)->s_mmp_tsk = NULL;
332 + mmp_check = (struct mmp_struct *)(bh_check->b_data);
333 + if (mmp->mmp_seq != mmp_check->mmp_seq ||
334 + memcmp(mmp->mmp_nodename, mmp_check->mmp_nodename,
335 + sizeof(mmp->mmp_nodename))) {
336 + dump_mmp_msg(sb, mmp_check,
337 + "Error while updating MMP info. "
338 + "The filesystem seems to have been"
339 + " multiply mounted.");
340 + ext4_error(sb, "abort");
347 + * Adjust the mmp_check_interval depending on how much time
348 + * it took for the MMP block to be written.
350 + mmp_check_interval = max(min(EXT4_MMP_CHECK_MULT * diff / HZ,
351 + EXT4_MMP_MAX_CHECK_INTERVAL),
352 + EXT4_MMP_MIN_CHECK_INTERVAL);
353 + mmp->mmp_check_interval = cpu_to_le16(mmp_check_interval);
357 + * Unmount seems to be clean.
359 + mmp->mmp_seq = cpu_to_le32(EXT4_MMP_SEQ_CLEAN);
360 + mmp->mmp_time = cpu_to_le64(get_seconds());
362 + retval = write_mmp_block(bh);
371 + * Get a random new sequence number but make sure it is not greater than
372 + * EXT4_MMP_SEQ_MAX.
374 +static unsigned int mmp_new_seq(void)
379 + get_random_bytes(&new_seq, sizeof(u32));
380 + } while (new_seq > EXT4_MMP_SEQ_MAX);
386 + * Protect the filesystem from being mounted more than once.
388 +int ext4_multi_mount_protect(struct super_block *sb,
389 + ext4_fsblk_t mmp_block)
391 + struct ext4_super_block *es = EXT4_SB(sb)->s_es;
392 + struct buffer_head *bh = NULL;
393 + struct mmp_struct *mmp = NULL;
394 + struct mmpd_data *mmpd_data;
396 + unsigned int mmp_check_interval = le16_to_cpu(es->s_mmp_update_interval);
397 + unsigned int wait_time = 0;
400 + if (mmp_block < le32_to_cpu(es->s_first_data_block) ||
401 + mmp_block >= ext4_blocks_count(es)) {
402 + ext4_warning(sb, "Invalid MMP block in superblock");
406 + retval = read_mmp_block(sb, &bh, mmp_block);
410 + mmp = (struct mmp_struct *)(bh->b_data);
412 + if (mmp_check_interval < EXT4_MMP_MIN_CHECK_INTERVAL)
413 + mmp_check_interval = EXT4_MMP_MIN_CHECK_INTERVAL;
416 + * If check_interval in MMP block is larger, use that instead of
417 + * update_interval from the superblock.
419 + if (mmp->mmp_check_interval > mmp_check_interval)
420 + mmp_check_interval = mmp->mmp_check_interval;
422 + seq = le32_to_cpu(mmp->mmp_seq);
423 + if (seq == EXT4_MMP_SEQ_CLEAN)
426 + if (seq == EXT4_MMP_SEQ_FSCK) {
427 + dump_mmp_msg(sb, mmp, "fsck is running on the filesystem");
431 + wait_time = min(mmp_check_interval * 2 + 1,
432 + mmp_check_interval + 60);
434 + /* Print MMP interval if more than 20 secs. */
435 + if (wait_time > EXT4_MMP_MIN_CHECK_INTERVAL * 4)
436 + ext4_warning(sb, "MMP interval %u higher than expected, please"
437 + " wait.\n", wait_time * 2);
439 + if (schedule_timeout_interruptible(HZ * wait_time) != 0) {
440 + ext4_warning(sb, "MMP startup interrupted, failing mount\n");
444 + retval = read_mmp_block(sb, &bh, mmp_block);
447 + mmp = (struct mmp_struct *)(bh->b_data);
448 + if (seq != le32_to_cpu(mmp->mmp_seq)) {
449 + dump_mmp_msg(sb, mmp,
450 + "Device is already active on another node.");
456 + * write a new random sequence number.
458 + mmp->mmp_seq = seq = cpu_to_le32(mmp_new_seq());
460 + retval = write_mmp_block(bh);
465 + * wait for MMP interval and check mmp_seq.
467 + if (schedule_timeout_interruptible(HZ * wait_time) != 0) {
468 + ext4_warning(sb, "MMP startup interrupted, failing mount\n");
472 + retval = read_mmp_block(sb, &bh, mmp_block);
475 + mmp = (struct mmp_struct *)(bh->b_data);
476 + if (seq != le32_to_cpu(mmp->mmp_seq)) {
477 + dump_mmp_msg(sb, mmp,
478 + "Device is already active on another node.");
482 + mmpd_data = kmalloc(sizeof(struct mmpd_data), GFP_KERNEL);
484 + ext4_warning(sb, "not enough memory for mmpd_data");
487 + mmpd_data->sb = sb;
488 + mmpd_data->bh = bh;
491 + * Start a kernel thread to update the MMP block periodically.
493 + EXT4_SB(sb)->s_mmp_tsk = kthread_run(kmmpd, mmpd_data, "kmmpd-%s",
494 + bdevname(bh->b_bdev,
495 + mmp->mmp_bdevname));
496 + if (IS_ERR(EXT4_SB(sb)->s_mmp_tsk)) {
497 + EXT4_SB(sb)->s_mmp_tsk = NULL;
499 + ext4_warning(sb, "Unable to create kmmpd thread for %s.",
512 Index: linux-stage/fs/ext4/super.c
513 ===================================================================
514 --- linux-stage.orig/fs/ext4/super.c
515 +++ linux-stage/fs/ext4/super.c
517 #include <linux/log2.h>
518 #include <linux/crc16.h>
519 #include <asm/uaccess.h>
520 +#include <linux/kthread.h>
521 +#include <linux/utsname.h>
524 #include "ext4_jbd2.h"
525 @@ -698,6 +700,8 @@ static void ext4_put_super(struct super_
526 invalidate_bdev(sbi->journal_bdev, 0);
527 ext4_blkdev_remove(sbi);
529 + if (sbi->s_mmp_tsk)
530 + kthread_stop(sbi->s_mmp_tsk);
531 sb->s_fs_info = NULL;
533 * Now that we are completely done shutting down the
534 @@ -2810,6 +2814,11 @@ static int ext4_fill_super(struct super_
535 EXT4_HAS_INCOMPAT_FEATURE(sb,
536 EXT4_FEATURE_INCOMPAT_RECOVER));
538 + if (EXT4_HAS_INCOMPAT_FEATURE(sb, EXT4_FEATURE_INCOMPAT_MMP) &&
539 + !(sb->s_flags & MS_RDONLY))
540 + if (ext4_multi_mount_protect(sb, le64_to_cpu(es->s_mmp_block)))
541 + goto failed_mount3;
544 * The first inode we look at is the journal inode. Don't try
545 * root first: it may be modified in the journal!
546 @@ -3048,6 +3057,8 @@ failed_mount3:
547 percpu_counter_destroy(&sbi->s_freeinodes_counter);
548 percpu_counter_destroy(&sbi->s_dirs_counter);
549 percpu_counter_destroy(&sbi->s_dirtyblocks_counter);
550 + if (sbi->s_mmp_tsk)
551 + kthread_stop(sbi->s_mmp_tsk);
553 for (i = 0; i < db_count; i++)
554 brelse(sbi->s_group_desc[i]);
555 @@ -3557,7 +3568,7 @@ static int ext4_remount(struct super_blo
556 struct ext4_mount_options old_opts;
558 unsigned int journal_ioprio = DEFAULT_JOURNAL_IOPRIO;
564 @@ -3676,6 +3687,13 @@ static int ext4_remount(struct super_blo
566 if (!ext4_setup_super(sb, es, 0))
567 sb->s_flags &= ~MS_RDONLY;
568 + if (EXT4_HAS_INCOMPAT_FEATURE(sb,
569 + EXT4_FEATURE_INCOMPAT_MMP))
570 + if (ext4_multi_mount_protect(sb,
571 + le64_to_cpu(es->s_mmp_block))) {
577 ext4_setup_system_zone(sb);