From mboxrd@z Thu Jan  1 00:00:00 1970
From: teigland@sourceware.org <teigland@sourceware.org>
Date: 25 Sep 2007 20:10:12 -0000
Subject: [Cluster-devel] cluster/cman/man cman_tool.8
Message-ID: <20070925201012.14758.qmail@sourceware.org>
List-Id: <cluster-devel.redhat.com>
To: cluster-devel.redhat.com
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit

CVSROOT:	/cvs/cluster
Module name:	cluster
Branch: 	RHEL4
Changes by:	teigland at sourceware.org	2007-09-25 20:10:12

Modified files:
	cman/man       : cman_tool.8 

Log message:
	add some info about services output

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/cman/man/cman_tool.8.diff?cvsroot=cluster&only_with_tag=RHEL4&r1=1.4.2.4&r2=1.4.2.5

--- cluster/cman/man/cman_tool.8	2005/02/23 16:43:08	1.4.2.4
+++ cluster/cman/man/cman_tool.8	2007/09/25 20:10:12	1.4.2.5
@@ -218,3 +218,79 @@
 is prepared to wait. If the operation times out then a status of 2 is returned.
 Note that just because cman_tool has given up, does not mean that cman itself
 has stopped trying to join a cluster.
+
+.br
+.SH "SERVICES" OUTPUT
+
+Lists the gfs, dlm, fence and rgmanager (user) groups registered locally
+with cman.  Cman manages the membership of each group, and coordinates
+their recovery.  The group name, global ID, local ID, State and Code are
+shown for each group.  The nodeid's of the current group members are shown
+on the second line within "[ ... ]".
+
+The following details relate to the internal cman group states and can be
+useful for debugging.
+
+\fBGroup states\fP include:
+.TP 8
+.I run
+normal operation, no transition in progress
+.TP
+.I join
+local node is joining the group
+.TP
+.I update
+local node is adding/removing another node to/from the group
+.TP
+.I recover
+group is being recovered from the failure of a member
+
+
+.TP 0
+\fBRecovery codes\fP indicating the local state of recovery:
+
+.TP 2
+1
+STOP the group has been told to stop in preparation for a recovery
+.TP
+2
+START the group has been told to do recovery
+.TP
+3
+STARTDONE the group has finished recovery locally
+.TP
+4
+BARRIERWAIT the group has finished recovery locally and is waiting for
+remote nodes to finish their recovery, too
+.TP
+5
+BARRIERDONE recovery for the group has completed on all nodes, and all
+nodes have joined the completion barrier
+
+.TP 0
+\fBEvent codes\fP related to nodes joining and leaving the group.  There
+are two forms these codes can take:
+
+.TP 0
+S-se_state,se_flags,se_reply_count
+.TP 4
+"S" indicates that the local node is joining or leaving the group.
+.br
+se_state is the state of the sevent, see SEST_* in sm_internal.h.
+.br
+se_flags are flags in the sevent, see SEFL_* in sm_internal.h.
+.br
+se_reply_count is the number of ack's received for the sevent.
+
+.TP 0
+U-ue_state,ue_flags,ue_nodeid
+.TP 4
+"U" indicates that the local node is processing the join or leave of
+another node.
+.br
+ue_state is the state of the uevent, see UEST_* in sm_internal.h.
+.br
+ue_flags are flags in the uevent, see UEFL_* in sm_internal.h.
+.br
+ue_nodeid is the node whose join or leave the uevent relates to.
+