add manpge

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@10463 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd

xCAT-client/pods/man8/tabch.8.pod

@@ -0,0 +1,75 @@
+=head1 NAME
+
+B<tabch> - Add, delete or update rows in the database tables.
+
+=head1 SYNOPSIS
+
+I<tabch [-h| --help]>
+
+I<tabch [-v| --version]>
+
+I<tabch [keycolname=keyvalue] [tablename.colname=newvalue] >
+
+I<tabch [keycolname=keyvalue] [tablename.colname+=newvalue] >
+
+I<tabch -d [keycolname=keyvalue] [tablename.colname=newvalue] >
+
+=head1 DESCRIPTION
+
+The tabch command adds, deletes or updates the attribute value in the specified table.column for the specified keyvalue.  The difference between tabch and chtab is tabch runs as a plugin under the xcatd daemon. This give the additional security of being authorized by the daemon. Normally, the given value will completely replace the current attribute value.  But if "+=" is used instead of "=", the specified value will be appended to the coma separated list of the attribute, if it is not already there.
+
+
+=head1 OPTIONS
+
+
+B<-h>          Display usage message.
+
+B<-v>          Command Version.
+
+B<-d>          Delete option.
+
+
+
+=head1 RETURN VALUE
+
+0 The command completed successfully.
+
+1 An error has occurred.
+
+=head1 EXAMPLES
+
+1. To add a node=node1 to the nodelist table with groups=all:
+
+I<tabch  node=node1 nodelist.groups=all >
+
+2. To add a keyword (tftpdir) and value (/tftpboot) to the site table:
+
+I<tabch  key=tftpdir site.value=/tftpboot >
+
+
+3. To add node1 to the  nodetype table with os=rhel5:
+
+I<tabch  node=node1 nodetype.os=rhel5>
+
+
+4. To change node1 in nodetype table setting os=sles:
+
+I<tabch  node=node1 nodetype.os=sles>
+
+5. To change node1 by appending otherpkgs to the postbootscripts field in the postscripts table:
+
+I<tabch node=node1 postscripts.postbootscripts+=otherpkgs>
+
+6. To delete node1 from nodetype table:
+
+I<tabch -d node=node1 nodetype>
+
+
+=head1 FILES
+
+/opt/xcat/sbin/tabch
+
+
+=head1 SEE ALSO
+
+L<tabdump(8)|tabdump.8>, L<tabedit(8)|tabedit.8>