From f0bef3ca0fed141eff28f972c03c3a10ae01fcaf Mon Sep 17 00:00:00 2001 From: Hajime Taira Date: Thu, 13 May 2010 13:23:49 +0200 Subject: fsfreeze: new command [kzak@redhat.com: - cleanup - add long options - add note about DM to the man page - use err.h and nls.h] Signed-off-by: Hajime Taira Signed-off-by: Karel Zak --- sys-utils/fsfreeze.8 | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 sys-utils/fsfreeze.8 (limited to 'sys-utils/fsfreeze.8') diff --git a/sys-utils/fsfreeze.8 b/sys-utils/fsfreeze.8 new file mode 100644 index 000000000..4408bdddb --- /dev/null +++ b/sys-utils/fsfreeze.8 @@ -0,0 +1,75 @@ +.\" -*- nroff -*- +.TH FSFREEZE 8 "May 2010" +.SH NAME +fsfreeze \- suspend access to an filesystem (Linux Ext3/4, ReiserFS, JFS, XFS). +.SH SYNOPSIS +.B fsfreeze +.RB \-f +.I mountpoint + +.B fsfreeze +.RB \-u +.I mountpoint + +.SH DESCRIPTION +.B fsfreeze +suspends and resumes access to an filesystem +.PP +.B fsfreeze +halts new access to the filesystem and creates a stable image on disk. +.B fsfreeze +is intended to be used with hardware RAID devices that support the creation +of snapshots. +.PP +.B fsfreeze +is unncessary for +.B device-mapper +devices. The device-mapper (and LVM) +automatically freezes filesystem on the device when a snapshot creation is requested. +For more details see the +.BR dmsetup (8) +man page. +.PP +The +.I mount-point +argument is the pathname of the directory where the filesystem +is mounted. +The filesystem must be mounted to be frozen (see +.BR mount (8)). +.SH OPTIONS +.IP "\fB\-h, \-\-help\fP" +Print help and exit. +.IP "\fB\-f, \-\-freeze\fP" +This option requests the specified a filesystem to be frozen from new +modifications. When this is selected, all ongoing transactions in the +filesystem are allowed to complete, new write system calls are halted, other +calls which modify the filesystem are halted, and all dirty data, metadata, and +log information are written to disk. Any process attempting to write to the +frozen filesystem will block waiting for the filesystem to be unfrozen. + +Note that even after freezing, the on-disk filesystem can contain +information on files that are still in the process of unlinking. +These files will not be unlinked until the filesystem is unfrozen +or a clean mount of the snapshot is complete. +.IP "\fB\-u, \-\-unfreeze\fP +This option is used to un-freeze the filesystem and allow operations to +continue. Any filesystem modifications that were blocked by the freeze are +unblocked and allowed to complete. +.SH AUTHOR +.PP +Written by Hajime Taira. +.SH NOTES +.PP +This man page based on xfs_freeze. +One of +.B \-f +or +.B \-u +must be supplied to +.BR fsfreeze . +.SH SEE ALSO +.BR mount (8) +.SH AVAILABILITY +The fsfreeze command is part of the util-linux-ng package and is available from +ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/. + -- cgit v1.2.3-55-g7522