filesystem freeze: add error handling of write_super_lockfs/unlockfs
Subsystems (6)
PATCH 5/8 filesystem freeze: add error handling of write_super_lockfs/unlockfs
From: Takashi Sato <[email protected]>
Currently, ext3 in mainline Linux doesn't have the freeze feature which suspends write requests. So, we cannot take a backup which keeps the filesystem's consistency with the storage device's features (snapshot and replication) while it is mounted.
In many case, a commercial filesystem (e.g. VxFS) has the freeze feature and it would be used to get the consistent backup.
If Linux's standard filesystem ext3 has the freeze feature, we can do it without a commercial filesystem.
So I have implemented the ioctls of the freeze feature. I think we can take the consistent backup with the following steps.
1. Freeze the filesystem with the freeze ioctl.
2. Separate the replication volume or create the snapshot with the storage device's feature.
3. Unfreeze the filesystem with the unfreeze ioctl.
4. Take the backup from the separated replication volume or the snapshot.
This patch:
VFS:
Changed the type of write_super_lockfs and unlockfs from "void" to "int" so that they can return an error.
Rename write_super_lockfs and unlockfs of the super block operation freeze_fs and unfreeze_fs to avoid a confusion.
ext3, ext4, xfs, gfs2, jfs:
Changed the type of write_super_lockfs and unlockfs from "void" to "int" so that write_super_lockfs returns an error if needed, and unlockfs always returns 0.
reiserfs:
Changed the type of write_super_lockfs and unlockfs from "void" to "int" so that they always return 0 (success) to keep a current behavior.
---
Documentation/filesystems/Locking | 8 ++-- Documentation/filesystems/vfs.txt | 8 ++-- fs/buffer.c | 8 ++-- fs/ext3/super.c | 45 ++++++++++++++++++---------- fs/ext4/super.c | 45 +++++++++++++++++++--------- fs/gfs2/ops_super.c | 16 +++++---- fs/jfs/super.c | 10 +++--- fs/reiserfs/super.c | 10 +++--- fs/xfs/linux-2.6/xfs_super.c | 8 ++-- fs/xfs/xfs_fsops.c | 11 ++++-- fs/xfs/xfs_fsops.h | 2 - include/linux/fs.h | 4 +- 12 files changed, 107 insertions(+), 68 deletions(-)
Documentation/filesystems/Locking renamed from Documentation/filesystems/Locking~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +4 -4
@@ -97,8 +97,8 @@ prototypes: void (*put_super) (struct super_block *); void (*write_super) (struct super_block *); int (*sync_fs)(struct super_block *sb, int wait); - void (*write_super_lockfs) (struct super_block *); - void (*unlockfs) (struct super_block *); + int (*freeze_fs) (struct super_block *); + int (*unfreeze_fs) (struct super_block *); int (*statfs) (struct dentry *, struct kstatfs *); int (*remount_fs) (struct super_block *, int *, char *); void (*clear_inode) (struct inode *);
@@ -119,8 +119,8 @@ delete_inode: no put_super: yes yes no write_super: no yes read sync_fs: no no read -write_super_lockfs: ? -unlockfs: ? +freeze_fs: ? +unfreeze_fs: ? statfs: no no no remount_fs: yes yes maybe (see below) clear_inode: no
Documentation/filesystems/vfs.txt renamed from Documentation/filesystems/vfs.txt~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +4 -4
@@ -210,8 +210,8 @@ struct super_operations { void (*put_super) (struct super_block *); void (*write_super) (struct super_block *); int (*sync_fs)(struct super_block *sb, int wait); - void (*write_super_lockfs) (struct super_block *); - void (*unlockfs) (struct super_block *); + int (*freeze_fs) (struct super_block *); + int (*unfreeze_fs) (struct super_block *); int (*statfs) (struct dentry *, struct kstatfs *); int (*remount_fs) (struct super_block *, int *, char *); void (*clear_inode) (struct inode *);
@@ -270,11 +270,11 @@ or bottom half). a superblock. The second parameter indicates whether the method should wait until the write out has been completed. Optional. - write_super_lockfs: called when VFS is locking a filesystem and + freeze_fs: called when VFS is locking a filesystem and forcing it into a consistent state. This method is currently used by the Logical Volume Manager (LVM). - unlockfs: called when VFS is unlocking a filesystem and making it writable + unfreeze_fs: called when VFS is unlocking a filesystem and making it writable again. statfs: called when the VFS needs to get filesystem statistics. This
fs/buffer.c renamed from fs/buffer.c~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +4 -4
@@ -221,8 +221,8 @@ struct super_block *freeze_bdev(struct bsync_blockdev (sb->s_bdev); -if (sb->s_op->write_super_lockfs) - sb->s_op->write_super_lockfs (sb); +if (sb->s_op->freeze_fs) + sb->s_op->freeze_fs (sb); }sync_blockdev (bdev);
@@ -242,8 +242,8 @@ void thaw_bdev(struct block_device *bdevif (sb) {BUG_ON (sb->s_bdev != bdev); -if (sb->s_op->unlockfs) - sb->s_op->unlockfs (sb); +if (sb->s_op->unfreeze_fs) + sb->s_op->unfreeze_fs (sb); sb->s_frozen =SB_UNFROZEN ;smp_wmb ();wake_up (&sb->s_wait_unfrozen);
fs/ext3/super.c renamed from fs/ext3/super.c~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +29 -16
113 lines not on this page · raw message
fs/ext4/super.c renamed from fs/ext4/super.c~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +31 -14
121 lines not on this page · raw message
fs/gfs2/ops_super.c renamed from fs/gfs2/ops_super.c~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +9 -7
@@ -211,18 +211,18 @@ static int gfs2_sync_fs(struct super_blo }/** -* gfs2_write_super_lockfs - prevent further writes to the filesystem +* gfs2_freeze - prevent further writes to the filesystem * @sb: the VFS structure for the filesystem * */ -static void gfs2_write_super_lockfs (struct super_block *sb) +static int gfs2_freeze (struct super_block *sb) {struct gfs2_sbd *sdp = sb->s_fs_info;int error;if (test_bit (SDF_SHUTDOWN , &sdp->sd_flags)) -return ; +return -EINVAL ;for (;;) { error =gfs2_freeze_fs (sdp);
@@ -242,17 +242,19 @@ static void gfs2_write_super_lockfs(strufs_err (sdp,"retrying...\n" );msleep (1000 ); } +return 0 ; }/** -* gfs2_unlockfs - reallow writes to the filesystem +* gfs2_unfreeze - reallow writes to the filesystem * @sb: the VFS structure for the filesystem * */ -static void gfs2_unlockfs (struct super_block *sb) +static int gfs2_unfreeze (struct super_block *sb) {gfs2_unfreeze_fs (sb->s_fs_info); +return 0 ; }/**
@@ -688,8 +690,8 @@ const struct super_operations gfs2_super .put_super = gfs2_put_super, .write_super = gfs2_write_super, .sync_fs = gfs2_sync_fs, - .write_super_lockfs = gfs2_write_super_lockfs, - .unlockfs = gfs2_unlockfs, + .freeze_fs = gfs2_freeze, + .unfreeze_fs = gfs2_unfreeze, .statfs = gfs2_statfs, .remount_fs = gfs2_remount_fs, .clear_inode = gfs2_clear_inode,
fs/jfs/super.c renamed from fs/jfs/super.c~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +6 -4
@@ -543,7 +543,7 @@ out_kfree:return ret; } -static void jfs_write_super_lockfs (struct super_block *sb) +static int jfs_freeze (struct super_block *sb) {struct jfs_sb_info *sbi =JFS_SBI (sb);struct jfs_log *log = sbi->log;
@@ -553,9 +553,10 @@ static void jfs_write_super_lockfs(struclmLogShutdown (log);updateSuper (sb,FM_CLEAN ); } +return 0 ; } -static void jfs_unlockfs (struct super_block *sb) +static int jfs_unfreeze (struct super_block *sb) {struct jfs_sb_info *sbi =JFS_SBI (sb);struct jfs_log *log = sbi->log;
@@ -568,6 +569,7 @@ static void jfs_unlockfs(struct super_blelse txResume (sb); } +return 0 ; } static int jfs_get_sb(struct file_system_type *fs_type,
@@ -735,8 +737,8 @@ static const struct super_operations jfs .delete_inode = jfs_delete_inode, .put_super = jfs_put_super, .sync_fs = jfs_sync_fs, - .write_super_lockfs = jfs_write_super_lockfs, - .unlockfs = jfs_unlockfs, + .freeze_fs = jfs_freeze, + .unfreeze_fs = jfs_unfreeze, .statfs = jfs_statfs, .remount_fs = jfs_remount, .show_options = jfs_show_options,
fs/reiserfs/super.c renamed from fs/reiserfs/super.c~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +6 -4
@@ -83,7 +83,7 @@ static void reiserfs_write_super(structreiserfs_sync_fs (s,1 ); } -static void reiserfs_write_super_lockfs (struct super_block *s) +static int reiserfs_freeze (struct super_block *s) {struct reiserfs_transaction_handle th;reiserfs_write_lock (s);
@@ -101,11 +101,13 @@ static void reiserfs_write_super_lockfs( } s->s_dirt =0 ;reiserfs_write_unlock (s); +return 0 ; } -static void reiserfs_unlockfs (struct super_block *s) +static int reiserfs_unfreeze (struct super_block *s) {reiserfs_allow_writes (s); +return 0 ; }extern const struct in_core_key MAX_IN_CORE_KEY ;
@@ -613,8 +615,8 @@ static const struct super_operations rei .put_super = reiserfs_put_super, .write_super = reiserfs_write_super, .sync_fs = reiserfs_sync_fs, - .write_super_lockfs = reiserfs_write_super_lockfs, - .unlockfs = reiserfs_unlockfs, + .freeze_fs = reiserfs_freeze, + .unfreeze_fs = reiserfs_unfreeze, .statfs = reiserfs_statfs, .remount_fs = reiserfs_remount, .show_options = generic_show_options,
fs/xfs/linux-2.6/xfs_super.c renamed from fs/xfs/linux-2.6/xfs_super.c~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +4 -4
@@ -1269,14 +1269,14 @@ xfs_fs_remount(* need to take care of the metadata. Once that's done write a dummy * record to dirty the log in case of a crash while frozen. */ -STATIC void -xfs_fs_lockfs ( +STATIC int +xfs_fs_freeze (struct super_block *sb) {struct xfs_mount *mp =XFS_M (sb);xfs_quiesce_attr (mp); -xfs_fs_log_dummy (mp); +return -xfs_fs_log_dummy (mp); }STATIC int
@@ -1557,7 +1557,7 @@ static struct super_operations xfs_super .put_super = xfs_fs_put_super, .write_super = xfs_fs_write_super, .sync_fs = xfs_fs_sync_super, - .write_super_lockfs = xfs_fs_lockfs, + .freeze_fs = xfs_fs_freeze, .statfs = xfs_fs_statfs, .remount_fs = xfs_fs_remount, .show_options = xfs_fs_show_options,
fs/xfs/xfs_fsops.c renamed from fs/xfs/xfs_fsops.c~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +7 -4
@@ -595,17 +595,19 @@ out:return 0 ; } -void +int xfs_fs_log_dummy (xfs_mount_t *mp) {xfs_trans_t *tp;xfs_inode_t *ip; +int error; tp =_xfs_trans_alloc (mp,XFS_TRANS_DUMMY1 ); -if (xfs_trans_reserve (tp,0 ,XFS_ICHANGE_LOG_RES (mp),0 ,0 ,0 )) { + error =xfs_trans_reserve (tp,0 ,XFS_ICHANGE_LOG_RES (mp),0 ,0 ,0 ); +if (error) {xfs_trans_cancel (tp,0 ); -return ; +return error; } ip = mp->m_rootip;
@@ -615,9 +617,10 @@ xfs_fs_log_dummy(xfs_trans_ihold (tp, ip);xfs_trans_log_inode (tp, ip,XFS_ILOG_CORE );xfs_trans_set_sync (tp); -xfs_trans_commit (tp,0 ); + error =xfs_trans_commit (tp,0 );xfs_iunlock (ip,XFS_ILOCK_EXCL ); +return error; }int
fs/xfs/xfs_fsops.h renamed from fs/xfs/xfs_fsops.h~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +1 -1
@@ -25,6 +25,6 @@ extern int xfs_fs_counts(xfs_mount_t *mpextern int xfs_reserve_blocks (xfs_mount_t *mp,__uint64_t *inval,xfs_fsop_resblks_t *outval);extern int xfs_fs_goingdown (xfs_mount_t *mp,__uint32_t inflags); -extern void xfs_fs_log_dummy (xfs_mount_t *mp); +extern int xfs_fs_log_dummy (xfs_mount_t *mp);#endif /* __XFS_FSOPS_H__ */
include/linux/fs.h renamed from include/linux/fs.h~filesystem-freeze-add-error-handling-of-write_super_lockfs-unlockfs +2 -2
@@ -1377,8 +1377,8 @@ struct super_operations {void (*put_super) (struct super_block *);void (*write_super) (struct super_block *);int (*sync_fs)(struct super_block *sb,int wait); -void (*write_super_lockfs) (struct super_block *); -void (*unlockfs) (struct super_block *); +int (*freeze_fs) (struct super_block *); +int (*unfreeze_fs) (struct super_block *);int (*statfs) (struct dentry *,struct kstatfs *);int (*remount_fs) (struct super_block *,int *,char *);void (*clear_inode) (struct inode *);
_