1
2gfs2_tool(8)                System Manager's Manual               gfs2_tool(8)
3
4
5

NAME

7       gfs2_tool - interface to gfs2 ioctl/sysfs calls
8
9

SYNOPSIS

11       gfs2_tool COMMAND [OPTION]...
12
13

DESCRIPTION

15       gfs2_tool is an interface to a variety of the GFS2 ioctl/sysfs calls.
16
17

COMMANDS

19       clearflag Flag File1 File2 ...
20              Clear  an  attribute  flag  on a file. See setflag for available
21              flags.
22
23       counters MountPoint [-c]
24              Print out  statistics  about  a  filesystem.   If  -c  is  used,
25              gfs2_tool continues to run printing out the stats once a second.
26
27       freeze MountPoint
28              Freeze (quiesce) a GFS2 cluster.
29
30       getargs MountPoint
31              Get the GFS-specific mount arguments used to mount a filesystem.
32
33       gettune MountPoint
34              Print  out the current values of the tuning parameters in a run‐
35              ning filesystem.
36
37       list   List the currently mounted GFS2 filesystems.  Each  line  repre‐
38              sents  a  filesystem.   The  columns represent (in order): 1) An
39              identifier that represents the mounted filesystem. 2)  The  name
40              of  the  device that holds the filesystem (well, the name as the
41              Linux kernel knows it).
42
43       sb device proto [newvalue]
44              View (and possibly replace) the name of the locking protocol  in
45              the  file  system  superblock.   The  file  system  shouldn't be
46              mounted by any client when you do this.
47
48       sb device table [newvalue]
49              View (and possibly replace) the name of the locking table in the
50              file system superblock.  The file system shouldn't be mounted by
51              any client when you do this.
52
53       sb device ondisk [newvalue]
54              View (and possibly replace) the ondisk format number in the file
55              system  superblock.  The file system shouldn't be mounted by any
56              client when you do this.  No one should have to use this.
57
58       sb device multihost [newvalue]
59              View (and possibly replace) the multihost format number  in  the
60              file system superblock.  The file system shouldn't be mounted by
61              any client when you do this.  No one should have to use this.
62
63       sb device all
64              Print out the superblock.
65
66       setflag Flag File1 File2 ...
67              Set an attribute flag on a file.  There are eight currently sup‐
68              ported  flags.  They are jdata, directio, immutable, appendonly,
69              noatime, sync, inherit_jdata, and inherit_directio.
70
71              The jdata flag causes all the data written to a regular file  to
72              be journaled. The jdata flag can only be set (or cleared) if the
73              file is zero length.
74
75              The directio flag causes all I/O to a regular file to be  Direct
76              I/O, even if the O_DIRECT flag isn't used on the open() command.
77
78              The  immutable  flag  marks  the file immutable. The behavior is
79              similar to the immutable flag in  the  ext2/3  filesystems.  All
80              write access is denied.
81
82              The  appendonly flag causes all data to be written at the end of
83              the file.
84
85              The noatime flag disables updates to the file's access time.
86
87              The sync flag causes data written to the file to be  sync'ed  to
88              stable storage immediately.
89
90              The inherit_jdata flag is set on a directory.  It causes all new
91              regular files created in that  directory  automatically  inherit
92              the  jdata flag.  The inherit_jdata is also inherited by any new
93              subdirectories created in that directory.
94
95              The inherit_directio flag is set on a directory.  It causes  all
96              new  regular  files  created  in  that  directory  automatically
97              inherit the directio flag.  The inherit_directio is also  inher‐
98              ited by any new subdirectories created in that directory.
99
100       settune MountPoint parameter newvalue
101              Set the value of tuning parameter.  Use gettune for a listing of
102              tunable parameters.
103
104       shrink MountPoint
105              Causes any unused locks to be thrown out of memory.
106
107       unfreeze MountPoint
108              Unfreeze a GFS2 cluster.
109
110       version
111              Print out the version of GFS2 that this program goes with.
112
113       withdraw MountPoint
114              Cause GFS2 to abnormally shutdown a  given  filesystem  on  this
115              node.
116
117
118
119
120                                                                  gfs2_tool(8)