From c869a712bd85a5f620ac93ee9395548d046e9870 Mon Sep 17 00:00:00 2001
From: lissav <lissav@8638fb3e-16cb-4fca-ae20-7b5d299a9bcd>
Date: Wed, 30 Mar 2011 15:01:42 +0000
Subject: [PATCH]  new man page for tabdump

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@9188 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
---
 xCAT-client/pods/man8/tabdump.8.pod | 35 +++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/xCAT-client/pods/man8/tabdump.8.pod b/xCAT-client/pods/man8/tabdump.8.pod
index 128eeba04..11535dd3a 100644
--- a/xCAT-client/pods/man8/tabdump.8.pod
+++ b/xCAT-client/pods/man8/tabdump.8.pod
@@ -6,8 +6,16 @@ B<tabdump> - display an xCAT database table in CSV format.
 
 B<tabdump> [I<-d>] [I<table>]
 
+B<tabdump> [I<table>]
+
+B<tabdump> [I<-w> I<attr>==I<val>] [B<-w> I<attr>=~I<val>] ...] [I<table>]
+
+B<tabdump> [I<-v> | I<--version>]
+
 B<tabdump> [I<-?> | I<-h> | I<--help>]
 
+B<tabdump> 
+
 =head1 DESCRIPTION
 
 The tabdump command displays the header and all the rows of the specified table in CSV (comma separated values) format.
@@ -26,6 +34,21 @@ Display usage message.
 
 Show descriptions of the tables, instead of the contents of the tables.  If a table name is also specified, descriptions of the columns (attributes) of the table will be displayed.  Otherwise, a summary of each table will be displayed.
 
+=item B<-w> I<attr==val> B<-w> I<attr=~val> ...
+
+Use one or multiple -w flags to specify the selection string that can be used to select objects. The operators ==, !=, =~ and !~ are available. Use the help option to get a list of valid attributes for each object type.
+
+Operator descriptions:
+        ==        Select nodes where the attribute value is exactly this value.
+        !=        Select nodes where the attribute value is not this specific value.
+        >         Select nodes where the attribute value is greater than this  specific value.
+        >=        Select nodes where the attribute value is greater than or equal to this  specific value.
+        <         Select nodes where the attribute value is less than this  specific value.
+        <=        Select nodes where the attribute value is less than or equal to this  specific value.
+        =~        Select nodes where the attribute value matches the SQL LIKE value.
+        !~        Select nodes where the attribute value matches the SQL NOT LIKE value.
+
+
 =back
 
 =head1 RETURN VALUE
@@ -54,6 +77,18 @@ B<tabdump> I<site>
 
 =item *
 
+To display the contents of the nodelist table where the groups attribute is compute :
+
+B<tabdump>  I<-w groups==compute> I<nodelist>
+
+=item *
+
+To display the contents of the nodelist table where the groups attribute is comput% where % is a wildcard and can represent any string  and the status attribute is booted :
+
+B<tabdump>  I<-w groups=~comput%> I<-w status==booted> I<nodelist>
+
+=item *
+
 To see what tables exist in the xCAT database:
 
 B<tabdump>