From 0b25d40ef797a6321caef22ec721fa63d7bb0080 Mon Sep 17 00:00:00 2001
From: jbjohnso <jbjohnso@8638fb3e-16cb-4fca-ae20-7b5d299a9bcd>
Date: Wed, 30 Sep 2009 22:14:23 +0000
Subject: [PATCH] -Add a manpage for the new nodegrpch command

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@4274 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
---
 xCAT-client/pods/man1/nodegrpch.1.pod | 88 +++++++++++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 xCAT-client/pods/man1/nodegrpch.1.pod

diff --git a/xCAT-client/pods/man1/nodegrpch.1.pod b/xCAT-client/pods/man1/nodegrpch.1.pod
new file mode 100644
index 000000000..77b26486f
--- /dev/null
+++ b/xCAT-client/pods/man1/nodegrpch.1.pod
@@ -0,0 +1,88 @@
+=head1 NAME
+
+B<nodech> - Changes attributes at the group level in the xCAT cluster database.
+
+
+=head1 SYNOPSIS
+
+B<nodegrpch> I<group1,group2,...> I<table.column=value> [I<...>]
+
+B<nodegrpch> {B<-v> | B<--version>}
+
+B<nodegrpch> [B<-?> | B<-h> | B<--help>]
+
+
+=head1 DESCRIPTION
+
+The nodegrpch command is similar to the nodech command, but ensures that the parameters are
+declared at the group level rather than the node specific level, and clears conflicting node 
+specific overrides of the specified groups.   Using table.column=value will do a 
+verbatim assignment.  If ",=" is used instead of "=", the specified value will be prepended to the 
+attribute's comma separated list, if it is not already there.  If "^=" is used, the specified 
+value will be removed from the attribute's comma separated list, if it is there.  You can also 
+use "^=" and ",=" in the same command to essentially replace one item
+in the list with another.  (See the Examples section.)
+
+With these operators in mind, the unambiguous assignment operator is '=@'.  If you need, for example, to set
+the nodehm.comments to =foo, you would have to do I<nodegrpch group1 nodehm.comments=@=foo>.
+
+See the B<xcatdb> man page for an overview of each table.
+
+The nodegrpch command also supports some short cut names as aliases to common attributes.  See the
+B<nodels> man page for details.
+
+
+=head1 OPTIONS
+
+=over 10
+
+
+=item B<-v|--version>
+
+Command Version.
+
+=item B<-?|-h|--help>
+
+Display usage message.
+
+=back
+
+
+=head1 RETURN VALUE
+
+=over 3
+
+=item 0
+
+The command completed successfully.
+
+=item 1
+
+An error has occurred.
+
+=back
+
+
+=head1 EXAMPLES
+
+=over 2
+
+
+
+=item *
+
+To declare all members of ipmi group to have nodehm.mgt be ipmi
+
+B<  nodegrpch> I<ipmi nodehm.mgt=ipmi>
+
+=back
+
+
+=head1 FILES
+
+/opt/xcat/bin/nodegrpch
+
+
+=head1 SEE ALSO
+
+L<nodech(1)|nodech.1>, L<nodels(1)|nodels.1>, L<nodeadd(8)|nodeadd.8>, L<noderange(3)|noderange.3>