b8de1ad00b
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@387 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
107 lines
2.7 KiB
Plaintext
107 lines
2.7 KiB
Plaintext
=head1 NAME
|
|
|
|
B<lsdef> - Use this command to list xCAT data object definitions.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
I<lsdef [-h | --help ] [-t object-types]>
|
|
|
|
I<lsdef [-V | --verbose] [ -l | --long] [-a | --all] [-t object-types] >
|
|
I<[-o object-names] [-z | --stanza] [-x | --xml] [-i attr-list]>
|
|
I<[-w attr=val,[attr=val...] [noderange]>
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This command is used to display xCAT object definitions which are stored
|
|
in the xCAT database.
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
B<-a | --all> Display all definitions.
|
|
|
|
B<-h|--help> Display usage message.
|
|
|
|
B<-i attr-list> Comma separated list of attribute names to display.
|
|
|
|
B<-l | --long> List the complete object definition. (The default for some options is to give only a list of object names.)
|
|
|
|
B<noderange> A set of comma delimited node names and/or group names.
|
|
See the "noderange" man page for details on supported formats.
|
|
|
|
B<-o object-names> A set of comma delimited object names.
|
|
|
|
B<-t object-types> A set of comma delimited object types. Use the help option to get a list of valid objects.
|
|
|
|
B<-V|--verbose> Verbose mode.
|
|
|
|
B<-w attr=val,[attr=val...]> A comma-separated list of attributes and values that can be used to select items to display. Use the help option to get a list of valid attributes.
|
|
|
|
B<-x | --xml> Display output in XML format.
|
|
|
|
B<-z | --stanza> Display output in stanza format.
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
0 The command completed successfully.
|
|
|
|
1 An error has occurred.
|
|
|
|
=head1 EXAMPLES
|
|
|
|
1. To get a list of all object names.
|
|
|
|
I<lsdef -a>
|
|
|
|
2. To get a list of all the network definitions.
|
|
|
|
I<lsdef -t network>
|
|
|
|
3. To get a complete listing of all network definitions.
|
|
|
|
I<lsdef -l -t network >
|
|
|
|
4. To list the whole xCAT database and write it to a stanza file. (backup database)
|
|
|
|
I<< lsdef -a -l -z > mydbstanzafile >>
|
|
|
|
5. To list the MAC and install adapter name for each node.
|
|
|
|
I<lsdef -t node -i mac,installnic>
|
|
|
|
6. To list an osimage definition named "aix53J".
|
|
|
|
I<lsdef -t osimage -l -o aix53J>
|
|
|
|
7. To list all adapter definitions for node "clstrn03".
|
|
|
|
I<lsdef -t adapter -w nodename=clstrn03>
|
|
|
|
8. To list all the attributes of the group "servicenodes".
|
|
|
|
I<lsdef -l -t group -o servicenodes>
|
|
|
|
9. To list all the attributes of the nodes that are members of the group "servicenodes".
|
|
|
|
I<lsdef -t node -l servicenodes>
|
|
|
|
10. To list all nodes that have a service node called "FMS01".
|
|
|
|
I<lsdef -t node -w nfsserver=FMS01>
|
|
|
|
=head1 FILES
|
|
|
|
$XCATROOT/bin/lsdef
|
|
|
|
(The XCATROOT environment variable is set when xCAT is installed. The
|
|
default value is "/opt/xcat".)
|
|
|
|
|
|
=head1 NOTES
|
|
|
|
This command is part of the xCAT software product.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
See the mkdef, chdef and rmdef commands.
|