=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>
