c9151502b9
- added usage support to tabgrep - fixed 2 uninitialized var msgs in xcatd git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@4045 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
80 lines
1.5 KiB
Plaintext
80 lines
1.5 KiB
Plaintext
=head1 NAME
|
|
|
|
B<gettab> - select table rows, based on attribute criteria, and display specific attributes.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<gettab> [B<-H> | B<--with-fieldname>] I<key=value,... table.attribute ...>
|
|
|
|
B<gettab> [B<-?> | B<-h> | B<--help>]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The B<gettab> command uses the specified key values to select a row in each of the tables requested.
|
|
For each selected row, the specified attributes are displayed. The B<gettab> command can be used instead
|
|
of B<nodels> for tables that are not keyed by nodename (e.g. the B<site> table), or to select rows based
|
|
on an attribute value other than nodename.
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 10
|
|
|
|
=item B<-H|--with-fieldname>
|
|
|
|
Always display table.attribute name next to result. By default, this is done only if more than
|
|
one table.attribute is requested.
|
|
|
|
=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 display setting for B<master> (management node) in the site table:
|
|
|
|
B<gettab -H> I<key=master site.value>
|
|
|
|
The output would be similar to:
|
|
|
|
site.value: mgmtnode.cluster.com
|
|
|
|
=item *
|
|
|
|
To display the first node or group name that has B<mgt> set to B<blade> in the nodehm table:
|
|
|
|
B<gettab> I<mgt=blade nodehm.node>
|
|
|
|
The output would be similar to:
|
|
|
|
blades
|
|
|
|
=back
|
|
|
|
=head1 FILES
|
|
|
|
/opt/xcat/bin/gettab
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<nodels(1)|nodels.1>, L<chtab(8)|chtab.8>, L<tabdump(8)|tabdump.8>
|