cluster: STABLE3 - rgmanager: Fix man pages

Lon Hohberger lon at fedoraproject.org
Wed May 5 17:21:43 UTC 2010


Gitweb:        http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=fdc717eb3ac4c05073708750de1a55ee58247d2e
Commit:        fdc717eb3ac4c05073708750de1a55ee58247d2e
Parent:        82faccc5e341c9e7131d8db5a5e524a8ebfe30dc
Author:        Lon Hohberger <lhh at redhat.com>
AuthorDate:    Wed May 5 13:16:17 2010 -0400
Committer:     Lon Hohberger <lhh at redhat.com>
CommitterDate: Wed May 5 13:16:17 2010 -0400

rgmanager: Fix man pages

Resolves: bz588010

Signed-off-by: Lon Hohberger <lhh at redhat.com>
---
 rgmanager/man/Makefile    |    2 +-
 rgmanager/man/clurgmgrd.8 |   42 +-----------------------------------------
 rgmanager/man/clurmtabd.8 |   37 -------------------------------------
 rgmanager/man/rgmanager.8 |   43 +++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 45 insertions(+), 79 deletions(-)

diff --git a/rgmanager/man/Makefile b/rgmanager/man/Makefile
index 791c8a7..0d8f3aa 100644
--- a/rgmanager/man/Makefile
+++ b/rgmanager/man/Makefile
@@ -2,8 +2,8 @@ MANTARGET= \
 	clubufflush.8 \
 	clufindhostname.8 \
 	clulog.8 \
+	rgmanager.8 \
 	clurgmgrd.8 \
-	clurmtabd.8 \
 	clustat.8 \
 	clusvcadm.8
 
diff --git a/rgmanager/man/clurgmgrd.8 b/rgmanager/man/clurgmgrd.8
index 7b43925..7541418 100644
--- a/rgmanager/man/clurgmgrd.8
+++ b/rgmanager/man/clurgmgrd.8
@@ -1,41 +1 @@
-.TH "clusvcmgrd" "8" "Jan 2005" "" "Red Hat Cluster Suite"
-.SH "NAME"
-Clurgmgrd \- Resource Group (Cluster Service) Manager Daemon
-.SH "DESCRIPTION"
-.PP 
-.B Clurgmgrd
-handles management of user-defined cluster services (also known as resource
-groups).  This includes handling of user requests including service start,
-service disable, service relocate, and service restart.  The service
-manager daemon also handles restarting and relocating services in the
-event of failures.
-.SH "HOW IT WORKS"
-.PP
-The service manager is spawned by an init script after the cluster
-infrastructure has been started and ccsd has been spawned, and only
-functions when the cluster is quorate.
-.LP 
-During initialization, the service manager runs scripts which ensure that all
-services are clear to be started.  After that, it determines which services
-need to be started and starts them.
-.LP
-When an event is received, members which are no longer online have their
-services taken away from them.  The event should only occur in the case that
-the member has been fenced whenever fencing is available.
-.LP
-When a cluster member determines that it is no longer in the cluster quorum,
-the service manager stops all services and waits for a new quorum to form.
-
-.SH "COMMAND LINE OPTIONS"
-.IP \-f
-Run in the foreground (do not fork).
-.IP \-d
-Enable debug-level logging.
-.IP \-N
-Do not perform stop-before-start.  Combined with the
-.I -Z
-flag to clusvcadm, this can be used to allow rgmanager to be upgraded
-without stopping a given user service or set of services.
-
-.SH "SEE ALSO"
-clusvcadm(8), ccsd(8)
+.so man8/rgmanager.8
diff --git a/rgmanager/man/clurmtabd.8 b/rgmanager/man/clurmtabd.8
deleted file mode 100644
index 3094499..0000000
--- a/rgmanager/man/clurmtabd.8
+++ /dev/null
@@ -1,37 +0,0 @@
-.TH "clurmtabd" "8" "Jan 2005" "" "Red Hat Cluster Suite"
-.SH "NAME"
-clurmtabd \- Cluster NFS Remote Mount Table Daemon
-.SH "DESCRIPTION"
-.PP 
-Instances of 
-.B clurmtabd
-keep entries relevant to a given mount point in sync cluster-wide.  It does
-this by polling /var/lib/nfs/rmtab periodically.
-.SH "HOW IT WORKS"
-.PP
-A single instance of 
-.B clurmtabd
-is spawned by the service manager (clusvcmgrd(8)) for each mount point in a
-given user service.  Each instance polls /var/lib/nfs/rmtab every few seconds,
-looking for changes.  When changes are detected, they are merged in with the
-current in-memory view.  The entries are filtered according to the mount point
-being monitored and are subsequently written out synchronously to that
-mount point.
-.LP
-When a user service is relocated (or after a fail-over), clurmtabd reads the
-entries on a given mount point and synchronizes them with the new member's
-/var/lib/nfs/rmtab.  This is done prior to running the exportfs(8) command
-so that clients of the given service do not receive "Stale NFS file handle"
-errors.
-.SH "NOTES"
-.PP
-Clurmtabd is not a part of NFS and can not ensure that "Stale NFS file handle"
-errors are never received.  It is a best-effort attempt.  To fully prevent
-"Stale NFS file handle" errors, it is necessary to modify the Linux kernel
-as well as nfs-utils.
-
-.SH "FILES"
-/var/lib/nfs/rmtab
-
-.SH "SEE ALSO"
-clurgmgrd(8), rpc.mountd(8), exportfs(8)
diff --git a/rgmanager/man/rgmanager.8 b/rgmanager/man/rgmanager.8
new file mode 100644
index 0000000..60ba6f7
--- /dev/null
+++ b/rgmanager/man/rgmanager.8
@@ -0,0 +1,43 @@
+.TH "clusvcmgrd" "8" "Jan 2005" "" "Red Hat Cluster Suite"
+.SH "NAME"
+rgmanager \- Resource Group (Cluster Service) Manager Daemon
+.SH "DESCRIPTION"
+.PP 
+.B rgmanager
+handles management of user-defined cluster services (also known as resource
+groups).  This includes handling of user requests including service start,
+service disable, service relocate, and service restart.  The service
+manager daemon also handles restarting and relocating services in the
+event of failures.
+.SH "HOW IT WORKS"
+.PP
+The service manager is spawned by an init script after the cluster
+infrastructure has been started and only functions when the cluster
+is quorate and locks are working.
+.LP 
+During initialization, the service manager runs scripts which ensure that all
+services are clear to be started.  After that, it determines which services
+need to be started and starts them.
+.LP
+When an event is received, members which are no longer online have their
+services taken away from them.  The event should only occur in the case that
+the member has been fenced whenever fencing is available.
+.LP
+When a cluster member determines that it is no longer in the cluster quorum,
+the service manager stops all services and waits for a new quorum to form.
+
+.SH "COMMAND LINE OPTIONS"
+.IP \-f
+Run in the foreground (do not fork).
+.IP \-d
+Enable debug-level logging.
+.IP \-w
+Disable internal process monitoring (for debugging).
+.IP \-N
+Do not perform stop-before-start.  Combined with the
+.I -Z
+flag to clusvcadm, this can be used to allow rgmanager to be upgraded
+without stopping a given user service or set of services.
+
+.SH "SEE ALSO"
+clusvcadm(8)


More information about the cluster-commits mailing list