NAME
gfs2_tool - interface to gfs2 ioctl/sysfs calls
SYNOPSIS
gfs2_tool COMMAND [OPTION]...
DESCRIPTION
gfs2_tool is an interface to a variety of the GFS2 ioctl/sysfs calls.
Some of the functions of gfs_tool have been replaced by standard system
tools such as mount and chattr, so gfs2_tool doesn’t have as many
options as gfs_tool used to.
COMMANDS
clearflag Flag File1 File2 ...
Clear an attribute flag on a file. See setflag for available
flags.
freeze MountPoint
Freeze (quiesce) a GFS2 cluster.
gettune MountPoint
Print out the current values of the tuning parameters in a
running filesystem. A better source of similar (more
comprehensive) information is that in the /proc/mounts file.
Running the mount command with no arguments will also provide
the same information. This option is considered obsolete and
will probably be removed at some future date.
journals MountPoint
Print out information about the journals in a mounted
filesystem.
lockdump MountPoint
Print out information about the locks this machine holds for a
given filesystem. This information is also available via the
debugfs glock dump file.
sb device proto [newvalue]
View (and possibly replace) the name of the locking protocol in
the file system superblock. The file system shouldn’t be
mounted by any client when you do this.
sb device table [newvalue]
View (and possibly replace) the name of the locking table in the
file system superblock. The file system shouldn’t be mounted by
any client when you do this.
sb device ondisk [newvalue]
View (and possibly replace) the ondisk format number in the file
system superblock. The file system shouldn’t be mounted by any
client when you do this. No one should have to use this.
sb device multihost [newvalue]
View (and possibly replace) the multihost format number in the
file system superblock. The file system shouldn’t be mounted by
any client when you do this. No one should have to use this.
sb device uuid [newvalue]
View (and possibly replace) the uuid in the file system
superblock. The file system shouldn’t be mounted by any client
when you do this. The new uuid value should be in the standard
uuid format. For example: 1AEA8269-15C5-72BD-6D83-8720B17AA4EE
sb device all
Print out the superblock.
setflag Flag File1 File2 ...
Set an attribute flag on a file. The currently supported flags
are jdata, immutable, appendonly, noatime, and sync. The chattr
command is the preferred way to set attributes on files.
The jdata flag causes all the data written to a file to be
journaled. If the jdata flag is set for a directory, all files
and directories subsequently created within that directory are
also journaled. This behavior replaces the old inherit_jdata
flag from gfs. Same as chattr +j.
The immutable flag marks the file immutable. The behavior is
similar to the immutable flag in the ext2/3 filesystems. All
write access is denied. Same as chattr +i.
The appendonly flag causes all data to be written at the end of
the file. Same as chattr +a.
The noatime flag disables updates to the file’s access time.
Same as chattr +A.
The sync flag causes data written to the file to be sync’ed to
stable storage immediately. Same as chattr +S.
settune MountPoint parameter newvalue
Set the value of tuning parameter. Use gettune for a listing of
tunable parameters. The mount -oremount command is the preferred
way to set the values of tunable parameters. At some future
stage, when all parameters can be set via mount, this option
will be removed.
unfreeze MountPoint
Unfreeze a GFS2 cluster.
version
Print out the version of GFS2 that this program goes with.
withdraw MountPoint
Cause GFS2 to abnormally shutdown a given filesystem on this
node.
gfs2_tool(8)