master - cman: Some edits to the cmannotifyd man page

master - cman: Some edits to the cmannotifyd man page

[Christine Caulfield]

Gitweb:        http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=e879db770593a7535dfc0f39a874f99053749096
Commit:        e879db770593a7535dfc0f39a874f99053749096
Parent:        83114068b1cada01c63015ddfa5401938c8500b1
Author:        Christine Caulfield <ccaulfie@redhat.com>
AuthorDate:    Tue Nov 4 09:00:27 2008 +0000
Committer:     Christine Caulfield <ccaulfie@redhat.com>
CommitterDate: Tue Nov 4 09:00:27 2008 +0000

cman: Some edits to the cmannotifyd man page

Signed-off-by: Christine Caulfield <ccaulfie@redhat.com>
---
 cman/man/cmannotifyd.8 |   34 +++++++++++++++++++++++-----------
 1 files changed, 23 insertions(+), 11 deletions(-)

diff --git a/cman/man/cmannotifyd.8 b/cman/man/cmannotifyd.8
index 7cfbae9..8712654 100644
--- a/cman/man/cmannotifyd.8
+++ b/cman/man/cmannotifyd.8
@@ -19,27 +19,39 @@ cluster.
 \- CMAN_REASON_CONFIG_UPDATE when a configuration change event has been
 detected/requested.
 
-Those notifications are then dispatches to cman_notify shell script in form of
-environmental variables (CMAN_NOTIFICATION=).
+These notifications are then dispatched to the shell script 
+.B cman_notify 
+in the environment variable CMAN_NOTIFICATION.
 
-Important notes: cmannotifyd does not block on cman_notify nor check the exit
-status of the script. Notifications are dispatched in the same order as they
-arrive, one by one.
-
-cman_notify will then execute all the scripts in the configured notification
+.B cman_notify
+will then execute all the scripts in the configured notification
 directory (default: /etc/cluster/cman-notify.d) passing a very minimal set of
 envvars including, of course, the CMAN_NOTIFICATION= type.
 The execution order is set by the filename as shown by "LC_ALL=C ls -las".
 
-cmannotifyd logs are stored in the default log file
+.B cmannotifyd 
+logs are stored in the default log file
 (/var/log/cluster/cmannotifyd.log).
 
-cman_notify logs are stored in the default log file
+.B cman_notify 
+logs are stored in the default log file
 (/var/log/cluster/cman_notify.log). By default the output from the scripts
-executed by cman_notify.log is redirected to /dev/null.
+executed by 
+.B cman_notify
+is redirected to /dev/null.
 Users can either set CMAN_NOTIFICATION_DEBUG=1 in their environment or
 set proper debug configuration in cluster.conf to redirect scripts output
-to cman_notify log file.
+to the cman_notify log file.
+
+.SH "NOTES"
+cmannotifyd does not block on cman_notify nor check the exit
+status of the script. 
+
+Notifications are dispatched in the same order as they
+arrive, one by one.
+
+CMAN_REASON_TRY_SHUTDOWN is passed to scripts for information only, they
+can not influence cman's decsion about whether or not to shut down.
 
 A template for cman_notify scripts can be found in the doc/ directory.