HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
s
swlist(1M) swlist(1M)
Software Listing
A listing of software objects is controlled by the specified software_selections, and also by the -l option (
swlist.level=). swlist lists the contents of each software object specified in the
software_selections. For example, if you specify product selections, the subproducts and/or filesets con-
tained immediately below each product will be listed. If you specify fileset selections, the files contained in
each fileset will be listed.
The depth of objects listed is controlled with the -l option. This option can expand or restrict the depth in
concert with the specified software selections. By default, the contents of a specified software selection are
always listed (as described above). The -l option can defeat this listing by specifying a level equivalent to
the level of objects in the software_selections. For example, if you want to list specific product selections
but not their contents, use -l product. If you want to list specific fileset selections but not their con-
tained files, use -l fileset. The software_selection options only apply if the level is bundle, product,
subproduct, fileset, file, or patch.
Depot Listing
Another class of objects that swlist can display are software depots. For example, the user can list all
registered depots on a given host. A combination of the -l depot option and target_selections operands
can produce a variety of depot listings.
Multiple Targets Listing
Multiple target_selections (i.e. root filesystems, alternate roots, or depots) are listed sequentially: list all
the requested objects and attributes from the first target_selection, followed by the second target_selection,
etc.
Verbose Listing
The
-v option causes a verbose listing to be generated. A verbose listing includes all attributes defined for
an object. The swlist command prints the keyword and value for each attribute. The attributes are
listed one per line. The user can post-process (filter) the output with grep(1), awk(1), and/or sed(1) to get
the fields of interest.
The depot’s attributes are displayed if
swlist is called with the -v and -l depot options, and a
specific depot target_selection.
Attributes for a particular software level (
product/subproduct/fileset/file
) are displayed
based on the depth of the specified software_selections. For example, swlist -v product1.fileset1 will give all
fileset attributes for fileset1. If the
-v option is used with the -l option, the different listing are:
• To display attributes for all products, use
swlist -v -l product
• To display attributes for all products and subproducts, use swlist -v -l subproduct
• To display attributes for all products and filesets, use swlist -v -l fileset
• To display attributes for all products, filesets, and files, use
swlist -v -l file
RETURN VALUE
The swlist command returns:
0 The software_selections and/or target_selections were successfully listed.
1 The list operation failed on all target_selections.
2 The list operation failed on some target_selections.
DIAGNOSTICS
The
swlist command writes to stdout, stderr, and to the agent logfile.
Standard Output
All listings are printed to stdout.
Standard Error
The swlist command writes messages for all WARNING and ERROR conditions to stderr.
Logging
The swlist command does not log summary events. It logs events about each read task to the
swagent logfile associated with each target_selection.
You can use the
swlist interactive interface (swlist -i -d) to view the
swaudit.log file.
Section 1M−−902 − 9 − HP-UX Release 11i: December 2000
___
___