From 55a96e1f8b21403eb678d66257e034918e356223 Mon Sep 17 00:00:00 2001
From: lissav <lissav@8638fb3e-16cb-4fca-ae20-7b5d299a9bcd>
Date: Fri, 9 Apr 2010 17:11:24 +0000
Subject: [PATCH] manpage for tabprune

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

diff --git a/xCAT-client/pods/man8/tabprune.8.pod b/xCAT-client/pods/man8/tabprune.8.pod
new file mode 100644
index 000000000..bc0c8245c
--- /dev/null
+++ b/xCAT-client/pods/man8/tabprune.8.pod
@@ -0,0 +1,99 @@
+=head1 NAME
+
+B<tabprune> - Deletes records from the eventlog or auditlog tables.
+
+=head1 SYNOPSIS
+
+B<tabprune> B<eventlog | auditlog>  [B<-V>] B<-i> I<recid> |B<-n> I<number of records> | B<-p> I<percentage> | B<-a>  
+
+B<tabprune> [B<-h>|B<--help>] [B<-v>|B<--version>] 
+
+=head1 DESCRIPTION
+
+The tabprune command is used to delete records from the auditlog or eventlog. As an option, the table header and all the rows pruned from the specified table will be displayed in CSV (comma separated values) format.  
+
+=head1 OPTIONS
+
+=over 10
+
+=item B<-h|--help>
+
+Display usage message.
+
+=item B<-a>
+
+Remove all records.
+
+=item B<-i>  I<recid number>
+
+Remove the records whose recid is less than the input recid number.
+
+=item B<-n> I<number>
+
+Remove the number of records input.
+
+=item B<-p> I<percent>
+
+Remove the percentage of records input.
+
+=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 remove all the records in the eventlog table:
+
+B<tabprune> I<eventlog> -a
+
+=item *
+
+To remove all the records in the eventlog table saving the deleted records in eventlog.csv:
+
+B<tabprune> I<eventlog> -V -a > eventlog.csv
+
+=item *
+
+To remove all the records before recid=200 in the auditlog table:
+
+B<tabprune> I<auditlog> -i 200
+
+=item *
+
+To remove 400 records from the auditlog table and display the remove records: 
+
+B<tabprune> I<auditlog> -V -n 400
+
+=item *
+
+To remove 50% of the  eventlog table: 
+
+B<tabprune> I<eventlog>  -p 50 
+
+
+
+=back
+
+=head1 FILES
+
+/opt/xcat/sbin/tabprune
+
+=head1 SEE ALSO
+
+L<tabrestore(8)|tabrestore.8>, L<tabedit(8)|tabedit.8>,L<tabdump(8)|tabdump.8>