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