gfs_controld

NAME

gfs_controld - daemon that manages mounting, unmounting, recovery and posix locks

SYNOPSIS

gfs_controld [OPTION]...

DESCRIPTION

GFS lives in the kernel, and the cluster infrastructure (cluster membership and group management) lives in user space. GFS in the kernel needs to adjust/recover for certain cluster events. It's the job of gfs_controld to receive these events and reconfigure gfs as needed. gfs_controld controls and configures gfs through sysfs files that are considered gfs-internal interfaces; not a general API/ABI. Mounting, unmounting and node failure are the main cluster events that gfs_controld controls. It also manages the assignment of journals to different nodes. The mount.gfs and umount.gfs programs communicate with gfs_controld to join/leave the mount group and receive the necessary options for the kernel mount. GFS also sends all posix lock operations to gfs_controld for processing. gfs_controld manages cluster-wide posix locks for gfs and passes results back to gfs in the kernel.

OPTIONS

-l <num>
Limit the rate at which posix lock messages are sent to <num> messages per second. 0 disables the limit and results in the maximum performance of posix locks. Default is 100.
-w
Disable the "withdraw" feature.
-p
Disable posix lock handling.
-D
Run the daemon in the foreground and print debug statements to stdout.
-P
Enable posix lock debugging messages.
-V
Print the version information and exit.
-h
Print out a help message describing available options, then exit.

DEBUGGING

The gfs_controld daemon keeps a circular buffer of debug messages that can be dumped with the 'group_tool dump gfs' command. The state of all gfs posix locks can also be dumped from gfs_controld with the 'group_tool dump plocks <fsname>' command.

SEE ALSO

groupd(8), group_tool(8)