xcat-core/xCAT-client/pods/man1/lskit.1.pod

=head1 NAME

B<lskit> - Lists information for one or more Kits.


=head1 SYNOPSIS

B<lskit> [B<-V> | B<--verbose>] 
      [B<-F> | B<--framework> I<kitattr_names>]
      [B<-x> | B<--xml> | B<--XML>]
      [B<-K> | B<--kitattr> I<kitattr_names>]
      [B<-R> | B<--repoattr> I<repoattr_names>]
      [B<-C> | B<--compattr> I<compattr_names>]
      [kit_names]

B<lskit> [B<-?> | B<-h> | B<--help> | B<-v> | B<--version>]

B<lskit> [B<-F> | B<--framework> I<kit_path_name>]


=head1 DESCRIPTION

The B<lskit> command is used to list information for one or more kits. A kit is a special kind of package that is used to install a software product on one or more nodes in an xCAT cluster.

Note: The xCAT support for Kits is only available for Linux operating systems.

The B<lskit> command outputs the following info for each kit: the kit's basic info, the kit's repositories, and the kit's components.  The command outputs the info in two formats: human-readable format (default), and XML format.  Use the -x option to view the info in XML format.

Input to the command can specify any number or combination of the input options.

=head1 OPTIONS

=over 10

=item B<-F|--framework> I<kit_path_name>

Use this option to display the framework values of the specified Kit tarfile.  This information is retreived directly from the tarfile and can be done before the Kit has been defined in the xCAT database.  This option cannot be combined with other options.

=item B<-K|--kitattr> I<kitattr_names>

Where I<kitattr_names> is a comma-delimited list of kit attribute names. The names correspond to attribute names in the B<kit> table. The B<lskit> command will only display the specified kit attributes.


=item B<-R|--repoattr> I<repoattr_names>

Where I<repoattr_names> is a comma-delimited list of kit repository attribute names. The names correspond to attribute names in the B<kitrepo> table. The B<lskit> command will only display the specified kit repository attributes.


=item B<-C|--compattr> I<compattr_names>

where I<compattr_names> is a comma-delimited list of kit component attribute names. The names correspond to attribute names in the B<kitcomponent> table. The B<lskit> command will only display the specified kit component attributes.


=item I<kit_names>

is a comma-delimited list of kit names. The B<lskit> command will only display the kits matching these names.


=item B<-x|--xml|--XML>

Need XCATXMLTRACE=1 env when using -x|--xml|--XML, for example: XCATXMLTRACE=1  lskit -x testkit-1.0.0
Return the output with XML tags.  The data is returned as:
  <data>
    <kitinfo>
       ...
    </kitinfo>
  </data>
  ...
  <data>
    <kitinfo>
       ...
    </kitinfo>
  </data>

Each <kitinfo> tag contains info for one kit.  The info inside <kitinfo> is structured as follows:
  The <kit> sub-tag contains the kit's basic info.
  The <kitrepo> sub-tags store info about the kit's repositories.
  The <kitcomponent> sub-tags store info about the kit's components.

The data inside <kitinfo> is returned as:
  <kitinfo>
     <kit>
       ...
     </kit>

     <kitrepo>
       ...
     </kitrepo>
     ...

     <kitcomponent>
       ...
     </kitcomponent>
     ...
  </kitinfo>


=item B<-V|--verbose>

Display additional progress and error messages. 

=item B<-v|--version>

Command Version.

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

=item 1.

To list all kits, enter:

  lskit

=item 2.

To list the kit "kit-test1-1.0-Linux", enter:

  lskit kit-test1-1.0-Linux

=item 3.

To list the kit "kit-test1-1.0-Linux" for selected attributes, enter:

  lskit -K basename,description -R kitreponame -C kitcompname kit-test1-1.0-Linux

=item 4.

To list the framework value of a Kit tarfile.

  lskit -F /myhome/mykits/pperte-1.3.0.2-0-x86_64.tar.bz2

  Extracting the kit.conf file from /myhome/mykits/pperte-1.3.0.2-0-x86_64.tar.bz2. Please wait.
  
        kitframework=2
        compatible_kitframeworks=0,1,2

=item 5.

To list kit "testkit-1.0-1" with XML tags, enter:

  XCATXMLTRACE=1 lskit -x testkit-1.0-1

=back


=head1 FILES

/opt/xcat/bin/lskit

=head1 SEE ALSO

L<lskitcomp(1)|lskitcomp.1>, L<lskitdeployparam(1)|lskitdeployparam.1>, L<addkit(1)|addkit.1>, L<rmkit(1)|rmkit.1>, L<addkitcomp(1)|addkitcomp.1>, L<rmkitcomp(1)|rmkitcomp.1>