public inbox for cluster-cvs@sourceware.org
help / color / mirror / Atom feed
From: "Fabio M. Di Nitto" <fabbione@fedoraproject.org>
To: cluster-cvs-relay@redhat.com
Subject: cluster: STABLE3 - config validate: add man page
Date: Fri, 11 Sep 2009 11:30:00 -0000	[thread overview]
Message-ID: <20090911112957.3F64E1201B0@lists.fedorahosted.org> (raw)

Gitweb:        http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=3f88e836e582c63938d2fd3862080a8e920a6f52
Commit:        3f88e836e582c63938d2fd3862080a8e920a6f52
Parent:        b25166629f95f0e3a4e0cd527fb17f25e8ca1699
Author:        Fabio M. Di Nitto <fdinitto@redhat.com>
AuthorDate:    Fri Sep 11 13:29:25 2009 +0200
Committer:     Fabio M. Di Nitto <fdinitto@redhat.com>
CommitterDate: Fri Sep 11 13:29:25 2009 +0200

config validate: add man page

Signed-off-by: Fabio M. Di Nitto <fdinitto@redhat.com>
---
 config/tools/man/Makefile              |    1 +
 config/tools/man/ccs_config_validate.8 |   52 ++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+), 0 deletions(-)

diff --git a/config/tools/man/Makefile b/config/tools/man/Makefile
index 7cb76ab..e29dbf0 100644
--- a/config/tools/man/Makefile
+++ b/config/tools/man/Makefile
@@ -1,4 +1,5 @@
 TARGET=	ccs_config_dump.8 \
+	ccs_config_validate.8 \
 	ccs_tool.8 \
 	confdb2ldif.8
 
diff --git a/config/tools/man/ccs_config_validate.8 b/config/tools/man/ccs_config_validate.8
new file mode 100644
index 0000000..8884952
--- /dev/null
+++ b/config/tools/man/ccs_config_validate.8
@@ -0,0 +1,52 @@
+.TH CCS_CONFIG_VALIDATE "8" "September 2009"
+.SH NAME
+ccs_config_validate
+.SH DESCRIPTION
+Usage:
+.PP
+ccs_config_validate [options]
+.SH OPTIONS
+.TP
+\fB\-h\fR
+Print this help, then exit
+.TP
+\fB\-V\fR
+Print program version information, then exit
+.TP
+\fB\-v\fR
+Produce verbose output
+.SS "Validating XML configuraton files:"
+.TP
+\fB\-f\fR configfile
+Validate an alternate config file without preloading it with default values.
+.TP
+\fB\-l\fR configfile
+Validate an alternate config file with preloading of default values (recommended option).
+.SS "Advanced options:"
+.TP
+\fB\-r\fR
+Force validation of runtime config
+.HP
+\fB\-C\fR config_loader
+Override config plugin loader
+.TP
+\fB\-t\fR tempfile
+Force temporay file to tempfile
+.TP
+\fB\-n\fR
+Do not remove temporary file
+.TP
+\fB\-o\fR
+Overwrite temporary file (dangerous)
+.SH "DEFAULT"
+Default operation for ccs_config_validate is to load the currently configured environment
+and verify the outcoming configuration.
+.TP
+Example 1: current environment uses a configuration file (/etc/cluster/cluster.conf).
+The user modifies cluser.conf and executes ccs_config_validate without options.
+The tool will validate the modified cluster.conf after including default values.
+.TP
+Example 2: current environment is set to load the configuration from LDAP. Users
+modifies LDAP databse and before pushing the change to the nodes, she/he can issue
+ccs_config_validate to verify the contents o the LDAP database automatically
+(as long as the correct LDAP environment is set in the cman/cluster sysconfig/defaults files).


                 reply	other threads:[~2009-09-11 11:30 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20090911112957.3F64E1201B0@lists.fedorahosted.org \
    --to=fabbione@fedoraproject.org \
    --cc=cluster-cvs-relay@redhat.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).