1gfs2_tool(8) System Manager's Manual gfs2_tool(8)
2
6 gfs2_tool - interface to gfs2 ioctl/sysfs calls
7
10 gfs2_tool COMMAND [OPTION]...
11
14 gfs2_tool is an interface to a variety of the GFS2 ioctl/sysfs calls.
15 Some of the functions of gfs_tool have been replaced by standard system
16 tools such as mount and chattr, so gfs2_tool doesn't have as many
17 options as gfs_tool used to.
18
21 clearflag Flag File1 File2 ...
22 Clear an attribute flag on a file. This is now obsolete and kept
23 only for backward compatibility, chattr is the preferred way to
24 clear attribute flags. See setflag for available flags. This
25 option will probably be removed at a future date.
26 freeze MountPoint
28 Freeze (quiesce) a GFS2 cluster.
29 gettune MountPoint
31 Print out the current values of the tuning parameters in a run‐
32 ning filesystem. A better source of similar (more comprehensive)
33 information is that in the /proc/mounts file. Running the mount
34 command with no arguments will also provide the same informa‐
35 tion. This option is considered obsolete and will probably be
36 removed at some future date.
37 journals MountPoint
39 Print out information about the journals in a mounted filesys‐
40 tem.
41 lockdump MountPoint
43 Print out information about the locks this machine holds for a
44 given filesystem. This information is also available via the
45 debugfs glock dump file, and accessing that file is the pre‐
46 ferred method of obtaining a dump of the glock state.
47 sb device proto [newvalue]
49 View (and possibly replace) the name of the locking protocol in
50 the file system superblock. The file system shouldn't be
51 mounted by any client when you do this.
52 sb device table [newvalue]
54 View (and possibly replace) the name of the locking table in the
55 file system superblock. The file system shouldn't be mounted by
56 any client when you do this.
57 sb device ondisk [newvalue]
59 View (and possibly replace) the ondisk format number in the file
60 system superblock. The file system shouldn't be mounted by any
61 client when you do this. No one should have to use this.
62 sb device multihost [newvalue]
64 View (and possibly replace) the multihost format number in the
65 file system superblock. The file system shouldn't be mounted by
66 any client when you do this. No one should have to use this.
67 sb device uuid [newvalue]
69 View (and possibly replace) the uuid in the file system
70 superblock. The file system shouldn't be mounted by any client
71 when you do this. The new uuid value should be in the standard
72 uuid format. For example: 1AEA8269-15C5-72BD-6D83-8720B17AA4EE
73 sb device all
75 Print out the superblock.
76 setflag Flag File1 File2 ...
78 Set an attribute flag on a file. The currently supported flags
79 are jdata, immutable, appendonly, noatime, and sync. The chattr
80 command is the preferred way to set attributes on files. This
81 option will probably be removed at a future date.
82 The jdata flag causes all the data written to a file to be jour‐
84 naled. If the jdata flag is set for a directory, all files and
85 directories subsequently created within that directory are also
86 journaled. This behavior replaces the old inherit_jdata flag
87 from gfs. Same as chattr +j.
88 The immutable flag marks the file immutable. The behavior is
90 similar to the immutable flag in the ext2/3 filesystems. All
91 write access is denied. Same as chattr +i.
92 The appendonly flag causes all data to be written at the end of
94 the file. Same as chattr +a.
95 The noatime flag disables updates to the file's access time.
97 Same as chattr +A.
98 The sync flag causes data written to the file to be sync'ed to
100 stable storage immediately. Same as chattr +S.
101 settune MountPoint parameter newvalue
103 Set the value of tuning parameter. Use gettune for a listing of
104 tunable parameters. The mount -oremount command is the preferred
105 way to set the values of tunable parameters. At some future
106 stage, when all parameters can be set via mount, this option
107 will be removed.
108 unfreeze MountPoint
110 Unfreeze a GFS2 cluster.
111 version
113 Print out the version of GFS2 that this program goes with.
114 withdraw MountPoint
116 Cause GFS2 to abnormally shutdown a given filesystem on this
117 node. This feature is only useful for testing and should not be
118 used during normal filesystem operation.
119 gfs2_tool(8)