diff --git a/docs/source/guides/admin-guides/references/man8/tabdump.8.rst b/docs/source/guides/admin-guides/references/man8/tabdump.8.rst index 1f5efbc42..7b67d827f 100644 --- a/docs/source/guides/admin-guides/references/man8/tabdump.8.rst +++ b/docs/source/guides/admin-guides/references/man8/tabdump.8.rst @@ -19,7 +19,7 @@ SYNOPSIS ******** -\ **tabdump**\ +\ **tabdump**\ \ **tabdump**\ [\ **-d**\ ] [\ *table*\ ] @@ -54,40 +54,40 @@ OPTIONS -\ **-?|-h|-**\ **-help**\ - +\ **-?|-h|-**\ **-help**\ + Display usage message. - -\ **-d**\ - + +\ **-d**\ + 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. - -\ **-n**\ - + +\ **-n**\ + Shows the most recent number of entries as supplied on the -n flag from the auditlog or eventlog table. - -\ **-f**\ - + +\ **-f**\ + File name or path to file in which to dump the table. Without this the table is dumped to stdout. Using the -f flag allows the table to be dumped one record at a time. If tables are very large, dumping to stdout can cause problems such as running out of memory. - + \ **-w**\ \ *'attr==val'*\ \ **-w**\ \ *'attr=~val'*\ ... - + Use one or multiple -w flags to specify the selection string that can be used to select particular rows of the table. See examples. - + Operator descriptions: - - + + .. code-block:: perl - + == 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. @@ -96,8 +96,8 @@ OPTIONS <= 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. - - + + @@ -123,105 +123,105 @@ EXAMPLES 1. To display the contents of the site table: - - + + .. code-block:: perl - + tabdump site - - + + 2. To display the contents of the nodelist table where the groups attribute is compute : - - + + .. code-block:: perl - + tabdump -w 'groups==compute' nodelist - - + + 3. 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 : - - + + .. code-block:: perl - + tabdump -w 'groups=~comput%' -w 'status==booted' nodelist - - + + 4. To display the records of the auditlog on date 2011-04-18 11:30:00 : - - + + .. code-block:: perl - + tabdump -w 'audittime==2011-04-18 11:30:00' auditlog - - + + 5. To display the records of the auditlog starting on 2011-04-18: - - + + .. code-block:: perl - + tabdump -w 'audittime>2011-04-18 11:30:00' auditlog - - + + 6. To display the 10 most recent entries in the auditlog: - - + + .. code-block:: perl - + tabdump -n 10 auditlog - - + + 7. To see what tables exist in the xCAT database: - - + + .. code-block:: perl - + tabdump - - + + 8. To back up all the xCAT database tables, instead of running \ **tabdump**\ multiple times, you can use the \ **dumpxCATdb**\ command as follows: - - + + .. code-block:: perl - + dumpxCATdb -p /tmp/xcatbak - - + + See the \ **dumpxCATdb**\ man page for details. - + 9. To display a summary description of each table: - - + + .. code-block:: perl - + tabdump -d - - + + 10. To display a description of each column in the nodehm table: - - + + .. code-block:: perl - + tabdump -d nodehm - - + +