2
0
mirror of https://github.com/xcat2/xcat-core.git synced 2025-06-12 17:30:19 +00:00

Remove trailing spaces in file docs/source/guides/admin-guides/references/man1/lsdef.1.rst

This commit is contained in:
GONG Jie
2017-12-31 23:59:59 +00:00
parent 2b0540fe8c
commit 7816dced6f

View File

@ -21,12 +21,12 @@ SYNOPSIS
\ **lsdef**\ [\ **-h | -**\ **-help**\ ] [\ **-t**\ \ *object-types*\ ] [\ **-i**\ \ *attr-list*\ ]
\ **lsdef**\ [\ **-V | -**\ **-verbose**\ ] [\ **-l | -**\ **-long**\ ] [\ **-s | -**\ **-short**\ ] [\ **-a | -**\ **-all**\ ] [\ **-S**\ ]
\ **lsdef**\ [\ **-V | -**\ **-verbose**\ ] [\ **-l | -**\ **-long**\ ] [\ **-s | -**\ **-short**\ ] [\ **-a | -**\ **-all**\ ] [\ **-S**\ ]
[\ **-t**\ \ *object-types*\ ] [\ **-o**\ \ *object-names*\ ] [\ **-z | -**\ **-stanza**\ ] [\ **-i**\ \ *attr-list*\ ]
[\ **-c | -**\ **-compress**\ ] [\ **-**\ **-osimage**\ ] [\ **-**\ **-nics**\ ] [[\ **-w**\ \ *attr*\ ==\ *val*\ ]
[\ **-w**\ \ *attr*\ =~\ *val*\ ] ...] [\ *noderange*\ ]
\ **lsdef**\ [\ **-l | -**\ **-long**\ ] [\ **-a | -**\ **-all**\ ] [\ **-t**\ \ *object-types*\ ] [\ **-z | -**\ **-stanza**\ ]
\ **lsdef**\ [\ **-l | -**\ **-long**\ ] [\ **-a | -**\ **-all**\ ] [\ **-t**\ \ *object-types*\ ] [\ **-z | -**\ **-stanza**\ ]
[\ **-i**\ \ *attr-list*\ ] [\ **-**\ **-template**\ [\ *template-object-name*\ ]]
@ -45,113 +45,113 @@ OPTIONS
\ **-a|-**\ **-all**\
\ **-a|-**\ **-all**\
Display all definitions.
For performance consideration, the auditlog and eventlog objects will not be listed.
To list auditlog or eventlog objects, use lsdef -t auditlog or lsdef -t eventlog instead.
\ **-c|-**\ **-compress**\
\ **-c|-**\ **-compress**\
Display information in compressed mode, each output line has format "<object name>: <data>".
The output can be passed to command xcoll or xdshbak for formatted output.
The output can be passed to command xcoll or xdshbak for formatted output.
The -c flag must be used with -i flag.
\ **-h|-**\ **-help**\
\ **-h|-**\ **-help**\
Display usage message.
\ **-i**\ \ *attr-list*\
\ **-i**\ \ *attr-list*\
Comma separated list of attribute names to display.
\ **-l|-**\ **-long**\
\ **-l|-**\ **-long**\
List the complete object definition.
\ **-s|-**\ **-short**\
\ **-s|-**\ **-short**\
Only list the object names.
\ **-S**\
\ **-S**\
List all the hidden nodes (FSP/BPA nodes) with other ones.
\ *noderange*\
\ *noderange*\
A set of comma delimited node names and/or group names.
See the "noderange" man page for details on supported formats.
\ **-o**\ \ *object-names*\
\ **-o**\ \ *object-names*\
A set of comma delimited object names.
\ **-**\ **-template**\ [\ *template-object-name*\ ]
Show the object definition templates \ *template-object-name*\ shipped in xCAT. If no \ *template-object-name*\ is specified, all the object definition templates of the specified type \ **-t**\ \ *object-types*\ will be listed. Use \ **-a|-**\ **-all**\ option to list all the object definition templates.
\ **-**\ **-osimage**\
\ **-**\ **-osimage**\
Show all the osimage information for the node.
\ **-**\ **-nics**\
\ **-**\ **-nics**\
Show the nics configuration information for the node.
\ **-t**\ \ *object-types*\
\ **-t**\ \ *object-types*\
A set of comma delimited object types. Use the help option to get a list of valid objects.
\ **-V|-**\ **-verbose**\
\ **-V|-**\ **-verbose**\
Verbose mode.
\ **-w**\ \ *attr==val*\ \ **-w**\ \ *attr=~val*\ ...
Use one or multiple -w flags to specify the selection string that can be used to select objects. The operators ==, !=, =~ and !~ are available. Use the help option to get a list of valid attributes for each object type.
Operator descriptions:
== 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 matches this regular expression.
!~ Select nodes where the attribute value does not match this regular expression.
Note: if the "val" fields includes spaces or any other characters that will be parsed by shell, the "attr<operator>val" needs to be quoted. If the operator is "!~", the "attr<operator>val" needs to be quoted using single quote.
\ **-z|-**\ **-stanza**\
\ **-z|-**\ **-stanza**\
Display output in stanza format. See the xcatstanzafile man page for details on using xCAT stanza files.
@ -172,253 +172,253 @@ EXAMPLES
1.
To display a description of all the valid attributes that could be used
when defining an xCAT node.
.. code-block:: perl
lsdef -t node -h
2.
To get a list of all the objects that have been defined.
.. code-block:: perl
lsdef
OR
lsdef -a
3.
To get all the attributes of the node1
.. code-block:: perl
lsdef node1
OR
lsdef -t node node1
OR
lsdef -t node -o node1
4.
To get the object name of node1 instead of all the attributes
.. code-block:: perl
lsdef -s node1
5.
To get a list of all the network definitions.
.. code-block:: perl
lsdef -t network
6.
To get a complete listing of all network definitions.
.. code-block:: perl
lsdef -l -t network
7.
To list the whole xCAT database and write it to a stanza file. (backup database)
.. code-block:: perl
lsdef -a -l -z > mydbstanzafile
8.
To list the MAC and install adapter name for each node.
.. code-block:: perl
lsdef -t node -i mac,installnic
9.
To list an osimage definition named "aix53J".
.. code-block:: perl
lsdef -t osimage -l -o aix53J
10.
To list all node definitions that have a status value of "booting".
.. code-block:: perl
lsdef -t node -w status==booting
11.
To list all the attributes of the group "service".
.. code-block:: perl
lsdef -l -t group -o service
12.
To list all the attributes of the nodes that are members of the group "service".
.. code-block:: perl
lsdef -t node -l service
13.
To get a listing of object definitions that includes information about
what xCAT database tables are used to store the data.
.. code-block:: perl
lsdef -V -l -t node -o node01
14.
To list the hidden nodes that can't be seen with other flags.
The hidden nodes are FSP/BPAs.
.. code-block:: perl
lsdef -S
15.
To list the nodes status and use xcoll to format the output.
.. code-block:: perl
lsdef -t node -i status -c | xcoll
16.
To display the description for some specific attributes that could be used
when defining an xCAT node.
.. code-block:: perl
lsdef -t node -h -i profile,pprofile
17.
To display the nics configuration information for node cn1.
.. code-block:: perl
lsdef cn1 --nics
18.
To list all the object definition templates shipped in xCAT.
.. code-block:: perl
lsdef --template -a
19.
To display the details of "node" object definition template "ppc64le-template" shipped in xCAT.
.. code-block:: perl
lsdef -t node --template ppc64le-template
20.
To list all the "node" object definition templates shipped in xCAT.
.. code-block:: perl
lsdef -t node --template