gfs2_tool

Section: Maintenance Commands (8)
Index Return to Main Contents

 

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.

 

COMMANDS

clearflag Flag File1 File2 ...
Clear an attribute flag on a file. See setflag for available flags.
counters MountPoint [-c]
Print out statistics about a filesystem. If -c is used, gfs2_tool continues to run printing out the stats once a second.
freeze MountPoint
Freeze (quiesce) a GFS2 cluster.
getargs MountPoint
Get the GFS-specific mount arguments used to mount a filesystem.
gettune MountPoint
Print out the current values of the tuning parameters in a running filesystem.
list
List the currently mounted GFS2 filesystems. Each line represents a filesystem. The columns represent (in order): 1) An identifier that represents the mounted filesystem. 2) The name of the device that holds the filesystem (well, the name as the Linux kernel knows it).
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 all
Print out the superblock.
setflag Flag File1 File2 ...
Set an attribute flag on a file. There are five currently supported flags. They are directio, immutable, appendonly, noatime, and sync. In most cases, the chattr command may be used rather than gfs2_tool to set attributes.

The directio flag causes all I/O to a regular file to be Direct I/O, even if the O_DIRECT flag isn't used on the open() command.

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.

Note: Unlike the original gfs_tool, the journaled data (jdata) flag is set with chattr +j and reset with chattr -j. Likewise, the inherit_jdata flag is set on a directory with chattr +j.

settune MountPoint parameter newvalue
Set the value of tuning parameter. Use gettune for a listing of tunable parameters.
shrink MountPoint
Causes any unused locks to be thrown out of memory.
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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
COMMANDS

linux.jgfs.net manual pages