swlist.1m (2010 09)

s
swlist(1M) swlist(1M)
TZ Determines the time zone for use when displaying dates and times.
Signals
The
swlist command catches the signals SIGQUIT and SIGINT. If these signals are received,
swlist prints a message, sends a Remote Procedure Call (RPC) to the agents to wrap up, and then exits.
Each agent will complete the list task (if the execution phase has already started) before it wraps up.
OPERATION
The output from swlist follows this rule with all options: only the lowest level listed (product, subpro-
duct, fileset or file) will be uncommented. Among other things, this allows the output from
swlist to be
used as input to other commands. The one exception is the list that contains files; file-level output is not
accepted by other commands.
The types of listings that can be selected are given below. Some of these listings are not exclusive choices,
but rather ways to view the objects while controlling the amount of output.
• Default Listing
• Software Listing
• Root Listing
• Depot Listing
• Multiple Targets Listing
• Verbose Listing
Default Listing
If
swlist is invoked with no software_selections and no target_selections, a listing of all installed pro-
ducts on the local host is produced. This listing contains one line for each product. The line includes the
product tag attributes and all other attributes selected via the
one_liner option.
If target_selections (that is, target hosts) are specified, this same format listing is produced for the
installed software at each of the specified hosts.
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 pro-
duct selections but not their contents, use
-l product. If you want to list specific fileset selections but
not their contained files, use -l fileset. The software_selection options only apply if the level is bun-
dle, 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 (that is, 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, awk,and/orsed 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.
HP-UX 11i Version 3: September 2010 − 9 − Hewlett-Packard Company 9