This is the mail archive of the
cluster-cvs@sourceware.org
mailing list for the cluster.
cluster: STABLE3 - man pages: group_tool
- From: David Teigland <teigland at fedoraproject dot org>
- To: cluster-cvs-relay at redhat dot com
- Date: Tue, 7 Apr 2009 20:08:55 +0000 (UTC)
- Subject: cluster: STABLE3 - man pages: group_tool
Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=7adbe0ef27635a0139b5d3789e12a3cc2019ae5e
Commit: 7adbe0ef27635a0139b5d3789e12a3cc2019ae5e
Parent: abc092893125eae0cfdd87f4671f62a05507310e
Author: David Teigland <teigland@redhat.com>
AuthorDate: Fri Mar 20 13:50:30 2009 -0500
Committer: David Teigland <teigland@redhat.com>
CommitterDate: Tue Apr 7 15:03:55 2009 -0500
man pages: group_tool
Signed-off-by: David Teigland <teigland@redhat.com>
---
group/man/group_tool.8 | 60 ++++++++++++++++++++++++++---------------------
1 files changed, 33 insertions(+), 27 deletions(-)
diff --git a/group/man/group_tool.8 b/group/man/group_tool.8
index 6cf5e7f..2665ea6 100644
--- a/group/man/group_tool.8
+++ b/group/man/group_tool.8
@@ -10,52 +10,58 @@ group_tool
.SH DESCRIPTION
-The group_tool program displays the status of fence, dlm and gfs groups.
-The information is read from the groupd daemon which controls the fenced,
-dlm_controld and gfs_controld daemons. group_tool will also dump debug
-logs from various daemons.
+The group_tool program displays information about fence, dlm and gfs groups.
.SH SUBCOMMANDS
-.TP
-\fBls\fP
-displays the list of groups and their membership. It is the default
-subcommand if none is specified.
+group_tool ls -a [-n]
-.TP
-\fBdump\fP
-dumps the debug log from groupd.
+ Queries individual daemons, and displays full daemon and group state.
+ It is a shortcut for:
+ fence_tool ls [-n]
+ dlm_tool ls [-n]
+ gfs_control ls [-n]
-.TP
-\fBdump fence\fP
-dumps the debug log from fenced.
+group_tool ls [-v]
-.TP
-\fBdump gfs\fP
-dumps the debug log from gfs_controld.
+ Queries groupd or individual daemons, depending on groupd compat mode.
+ Displays limited cluster2-style output of daemon and group state.
+
+group_tool compat
+
+ Queries groupd about compatibility mode currently running. Any ls command
+ also includes this query and displays the result. Possible results:
+ groupd not running
+ groupd compatibility mode 0
+ groupd compatibility mode 1
+ groupd compatibility mode 2 (pending)
+
+group_tool dump [gfs|dlm|fence|plocks] [name]
+
+ Dumps debug info from daemons:
+
+ group_tool dump gfs: dump gfs_controld debug log
+ (same as gfs_control dump)
+ group_tool dump dlm: dump dlm_controld debug log
+ (same as dlm_tool dump)
+ group_tool dump fence: dump fenced debug log
+ (same as fence_tool dump)
+ group_tool dump plocks <x>: dump plock state
+ (same as dlm_tool plocks <x>)
+ group_tool dump: dump groupd debug log
-.TP
-\fBdump plocks\fP <fsname>
-prints the posix locks on the named gfs fs from gfs_controld.
.SH OPTIONS
.TP
\fB-v\fP
Verbose output, used with the 'ls' subcommand.
.TP
-\fB-D\fP
-Run the daemon in the foreground and print debug statements to stdout.
-.TP
\fB-V\fP
Print the version information and exit.
.TP
\fB-h\fP
Print out a help message describing available options, then exit.
-.SH DEBUGGING
-The groupd daemon keeps a circular buffer of debug messages that can be
-dumped with the 'group_tool dump' command.
-
.SH SEE ALSO
groupd(8)