170 lines
4.3 KiB
HTML
170 lines
4.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of FSFREEZE</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>FSFREEZE</H1>
|
|
Section: System Administration (8)<BR>Updated: July 2014<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
fsfreeze - suspend access to a filesystem (Ext3/4, ReiserFS, JFS, XFS)
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>fsfreeze</B>
|
|
|
|
<B>--freeze</B>|<B>--unfreeze</B>
|
|
|
|
<I>mountpoint</I>
|
|
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>fsfreeze</B>
|
|
|
|
suspends or resumes access to a filesystem.
|
|
<P>
|
|
|
|
<B>fsfreeze</B>
|
|
|
|
halts any new access to the filesystem and creates a stable image on disk.
|
|
<B>fsfreeze</B>
|
|
|
|
is intended to be used with hardware RAID devices that support the creation
|
|
of snapshots.
|
|
<P>
|
|
|
|
<B>fsfreeze</B>
|
|
|
|
is unnecessary for
|
|
<B>device-mapper</B>
|
|
|
|
devices. The device-mapper (and LVM) automatically freezes a filesystem
|
|
on the device when a snapshot creation is requested.
|
|
For more details see the
|
|
<B><A HREF="/cgi-bin/man/man2html?8+dmsetup">dmsetup</A></B>(8)
|
|
|
|
man page.
|
|
<P>
|
|
|
|
The
|
|
<I>mountpoint</I>
|
|
|
|
argument is the pathname of the directory where the filesystem
|
|
is mounted.
|
|
The filesystem must be mounted to be frozen (see
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mount">mount</A></B>(8)).
|
|
|
|
<P>
|
|
|
|
Note that access-time updates are also suspended if the filesystem is mounted with
|
|
the traditional atime behavior (mount option <B>strictatime</B>, for more details see
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mount">mount</A></B>(8)).
|
|
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-f</B>,<B> --freeze</B>
|
|
|
|
<DD>
|
|
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.
|
|
<P>
|
|
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.
|
|
<DT id="2"><B>-u</B>,<B> --unfreeze</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="3"><B>-V</B>,<B> --version</B>
|
|
|
|
<DD>
|
|
Display version information and exit.
|
|
<DT id="4"><B>-h</B>,<B> --help</B>
|
|
|
|
<DD>
|
|
Display help text and exit.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILESYSTEM SUPPORT</H2>
|
|
|
|
This command will work only if filesystem supports has support for freezing.
|
|
List of these filesystems include (2016-12-18)
|
|
<B>btrfs</B>,
|
|
|
|
<B>ext2/3/4</B>,
|
|
|
|
<B>f2fs</B>,
|
|
|
|
<B>jfs</B>,
|
|
|
|
<B>nilfs2</B>,
|
|
|
|
<B>reiserfs</B>,
|
|
|
|
and
|
|
<B>xfs</B>.
|
|
|
|
Previous list may be incomplete, as more filesystems get support. If in
|
|
doubt easiest way to know if a filesystem has support is create a small
|
|
loopback mount and test freezing it.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
|
|
Written by Hajime Taira.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
<P>
|
|
|
|
This man page is based on
|
|
<B><A HREF="/cgi-bin/man/man2html?8+xfs_freeze">xfs_freeze</A></B>(8).
|
|
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+mount">mount</A></B>(8)
|
|
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AVAILABILITY</H2>
|
|
|
|
The fsfreeze command is part of the util-linux package and is available from
|
|
<A HREF="https://www.kernel.org/pub/linux/utils/util-linux/.">https://www.kernel.org/pub/linux/utils/util-linux/.</A>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="5"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="6"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="7"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="8"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="9"><A HREF="#lbAF">FILESYSTEM SUPPORT</A><DD>
|
|
<DT id="10"><A HREF="#lbAG">AUTHOR</A><DD>
|
|
<DT id="11"><A HREF="#lbAH">NOTES</A><DD>
|
|
<DT id="12"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
<DT id="13"><A HREF="#lbAJ">AVAILABILITY</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:12 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|