fsfreeze(8)

1FSFREEZE(8)                  System Administration                 FSFREEZE(8)
2
3
4

NAME

6       fsfreeze - suspend access to a filesystem (Ext3/4, ReiserFS, JFS, XFS)
7

SYNOPSIS

9       fsfreeze --freeze|--unfreeze mountpoint
10
11

DESCRIPTION

13       fsfreeze suspends or resumes access to a filesystem.
14
15       fsfreeze  halts  any  new access to the filesystem and creates a stable
16       image on disk.  fsfreeze is intended to  be  used  with  hardware  RAID
17       devices that support the creation of snapshots.
18
19       fsfreeze  is  unnecessary for device-mapper devices.  The device-mapper
20       (and LVM) automatically freezes a filesystem on the device when a snap‐
21       shot  creation  is  requested.  For more details see the dmsetup(8) man
22       page.
23
24       The mountpoint argument is the pathname  of  the  directory  where  the
25       filesystem  is  mounted.   The  filesystem must be mounted to be frozen
26       (see mount(8)).
27
28       Note that access-time updates are also suspended if the  filesystem  is
29       mounted  with the traditional atime behavior (mount option strictatime,
30       for more details see mount(8)).
31
32

OPTIONS

34       -f, --freeze
35              This option requests the specified a  filesystem  to  be  frozen
36              from  new  modifications.   When  this  is selected, all ongoing
37              transactions in the filesystem  are  allowed  to  complete,  new
38              write  system  calls  are  halted,  other calls which modify the
39              filesystem are halted, and all dirty  data,  metadata,  and  log
40              information  are  written  to  disk.   Any process attempting to
41              write to the  frozen  filesystem  will  block  waiting  for  the
42              filesystem to be unfrozen.
43
44              Note  that  even after freezing, the on-disk filesystem can con‐
45              tain information on files that  are  still  in  the  process  of
46              unlinking.   These files will not be unlinked until the filesys‐
47              tem is unfrozen or a clean mount of the snapshot is complete.
48
49       -u, --unfreeze
50              This option is used to un-freeze the filesystem and allow opera‐
51              tions  to  continue.   Any  filesystem  modifications  that were
52              blocked by the freeze are unblocked and allowed to complete.
53
54       -V, --version
55              Display version information and exit.
56
57       -h, --help
58              Display help text and exit.
59

FILESYSTEM SUPPORT

61       This command will work only if  filesystem  supports  has  support  for
62       freezing.   List  of  these  filesystems  include  (2016-12-18)  btrfs,
63       ext2/3/4, f2fs, jfs, nilfs2, reiserfs, and xfs.  Previous list  may  be
64       incomplete,  as  more filesystems get support.  If in doubt easiest way
65       to know if a filesystem has support is create a  small  loopback  mount
66       and test freezing it.
67

AUTHOR

69       Written by Hajime Taira.
70

NOTES

72       This man page is based on xfs_freeze(8).
73

AVAILABILITY

78       The fsfreeze command is part of the util-linux package and is available
79       from https://www.kernel.org/pub/linux/utils/util-linux/.
80
81
82
83util-linux                         July 2014                       FSFREEZE(8)