STABLE2 - rgmanager: Fix up clusvcadm.8 manual page to show -M option

[Lon Hohberger <lon at fedoraproject dot org>]

Gitweb:        http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=4c79aea06bb46acbd2914bbb47d02a88aaced19e
Commit:        4c79aea06bb46acbd2914bbb47d02a88aaced19e
Parent:        573ebbb8ff9839a353d98fbbfbd306b43c49f623
Author:        Lon Hohberger <lhh@redhat.com>
AuthorDate:    Wed Sep 3 11:49:45 2008 -0400
Committer:     Lon Hohberger <lhh@redhat.com>
CommitterDate: Mon Sep 22 11:18:16 2008 -0400

rgmanager: Fix up clusvcadm.8 manual page to show -M option

rhbz#460032
---
 rgmanager/man/clusvcadm.8 |   38 +++++++++++++++++++++++++-------------
 1 files changed, 25 insertions(+), 13 deletions(-)

diff --git a/rgmanager/man/clusvcadm.8 b/rgmanager/man/clusvcadm.8
index 155ac88..d1435ef 100644
--- a/rgmanager/man/clusvcadm.8
+++ b/rgmanager/man/clusvcadm.8
@@ -18,10 +18,12 @@ clusvcadm \- Cluster User Service Administration Utility
 .B [\-r
 .I <service>
 .B ]
-.B [\-S]
 .B [\-R
 .I <service>
 .B ]
+.B [\-M
+.I <service>
+.B ]
 .B [\-Z
 .I <service>
 .B ]
@@ -52,11 +54,20 @@ Enables and starts the user service named
 .I
 service
 .IP \-l
-Lock the local resource group manager.  This should only be used if the 
-administrator intends to perform a global, cluster-wide shutdown.  This
-prevents starting resource groups on the local node, allowing 
-services will not fail over during the shutdown of the cluster.
-Once the cluster quorum is dissolved, this state is reset.
+Lock services in preparation for cluster shutdown.  This should only
+be used if the administrator intends to perform a global, cluster
+wide shutdown.  This prevents services from starting (but not stopping,
+like
+.B -Z
+does).  Once the cluster quorum is dissolved, this state is reset.
+If a new instance of rgmanager boots while others are locked, the
+behavior is undefined.
+.IP \-u
+Unlock resource group managers.  This allows services to start again. 
+.IP "\-S"
+Display whether the resource group managers are locked or not.  This
+can be used to verify the correct operation of the \fB-l\fR and \fB-u\fR 
+options, but is only useful for debugging.
 .IP "\-m <member>"
 When used in conjunction with either the
 .B
@@ -79,6 +90,14 @@ Restarts the user service named
 .I
 service
 on the cluster member on which it is currently running.
+.IP "\-M <service>"
+Use a special "migration" operation to move the user service named
+.I
+service
+to another cluster member.  Currently, this is only useful for
+virtual machines.  Use of migration usually requires special
+configuration of the local virtual machine manager in order
+to work correctly.
 .IP "\-Z <service>"
 Freezes the service named
 .I
@@ -92,18 +111,11 @@ Unfreezes the user service named
 service
 on the cluster member on which it is currently running.  This will
 re-enable status checks.
-.IP "\-S"
-Display whether each of the active service managers is locked or not.  This
-can be used to verify the correct operation of the \fB-l\fR and \fB-u\fR 
-options, but is only useful for debugging.
 .IP "\-s <service>"
 Stops the service named
 .I
 service
 until a member transition or until it is enabled again.
-.IP \-u
-Unlock the cluster's service managers.  This allows services to transition
-again. 
 
 .IP \-v
 Display version information and exit.