swlist.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

swlist(1M) swlist(1M)

NAME

swlist - display information about software products

SYNOPSIS

swlist [-d|-r][-i

][-R][-v][-a attribute ][-C session_ﬁle ][

-f software_ﬁle ][-l level ]

[

-s source ][-S session_ﬁle ][

-t target_ﬁle ][-x option=value ][-X option_ﬁle ]

[software_selections][

@ target_selections]

Remarks

• This command supports operation on remote systems. See Operations on Remote Systems below.

•

swlist supports an interactive user interface that can be invoked by the

swlist -i com-

mand. See Interactive Operation below.

• For an overview of all SD commands, see the sd(5) man page by typing

man5sdon the com-

mand line.

DESCRIPTION

The

swlist command displays information about software products installed at or available from the

speciﬁed target_selections. It supports these features:

• Specify bundles, products, subproducts, and/or ﬁlesets to list.

• Display the ﬁles contained in each ﬁleset.

• Display a table of contents from a software source.

• Specify the attributes to display for each software object.

• Display all attributes for bundles, products, subproducts, ﬁlesets and/or ﬁles.

• Display the full software_spec

to be used with software selections.

• Display the

readme ﬁle for products.

• Display the depots on a speciﬁed host.

• Create a list of products, subproducts, and/or ﬁlesets to use as input to the other commands.

• List the categories of available or applied patches.

• List applied patches and their state (applied or committed).

Operations on Remote Systems

swlist supports operations on remote systems. By default, any user can list depots available or

software installed on a remote target.

The

swacl command may be used to change Access Control Lists (ACLs) to prevent a system from being

accessed remotely. For example, entering both of the following commands:

swacl -D any_other -l root

swacl -M other:r -l root

replaces the default ACL that protects the root ﬁlesystem with one that only allows local users to list

software installed.

Interactive Operation

swlist supports an optional graphical user interface (GUI). (If your terminal or display cannot support

the GUI, the command also provides a terminal user interface, in which screen navigation is done with

the keyboard and no mouse.)

To invoke the GUI, type:

swlist -i or add the -i option with any other command-line options when you invoke the

swlist.

Previewing Product and OS Update Information

To preview information about new software in the depot, you can use

swlist to view the readme ﬁle

for each product, including OS update information contained in the SD (SW-DIST product) readme.For

example, to display the latest OS update information:

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (12 pages)

PAGE 1
swlist(1M) swlist(1M) NAME swlist - display information about software products SYNOPSIS swlist [-d|-r] [-i] [-R] [-v] [-a attribute ] [-C session_file ] [-f software_file ] [-l level ] [-s source ] [-S session_file ] [-t target_file ] [-x option=value ] [-X option_file ] [software_selections] [@ target_selections] Remarks • This command supports operation on remote systems. See Operations on Remote Systems below.
PAGE 2
swlist(1M) swlist(1M) swlist -d -a readme -l product SW-DIST @ hostA:/depot11 Options When no options or operands are specified, swlist lists the software bundles (and products which are not part of a bundle) that are installed at the local host. swlist supports the following options: -d List software available from a depot (instead of software installed on a root filesystem). -i Invoke the swlist interactive user interface. The interactive interface lets you browse SD software objects.
PAGE 3
swlist(1M) swlist(1M) (Note that session management does not apply to the swlist interactive user interface invoked by the -i option.) -t target_file Read the list of target_selections from target_file instead of (or in addition to) the command line. -x option=value Set the session option to value and override the default value (or a value in an alternate option_file specified with the -X option). Multiple -x options can be specified.
PAGE 4
swlist(1M) swlist(1M) [instance_id ] within the context of an exported catalog, where instance_id is an integer that distinguishes versions of products and bundles with the same tag. Target Selections swlist supports this syntax for each target_selection. [host][:][/directory] | [./relative_path] | [../relative_path] A host may be specified by its host name, domain name, or Internet address. If host is specified, the directory must be an absolute path.
PAGE 5
swlist(1M) swlist(1M) system or patches to it. For a full explanation of nonprivileged SD, see the Software Distributor Administration Guide , available at the http://www.hp.com/go/hpuxcore-docs web site. See also the installed_software_catalog and run_as_superuser options. agent_timeout_minutes=10000 Causes a target agent to exit if it has been inactive for the specified time.
PAGE 6
swlist(1M) swlist(1M) This option permits the simultaneous installation and removal of multiple software applications by multiple users or multiple processes, with each application or group of applications using a different IPD. Caution: use a specific installed_software_catalog to manage a specific application. SD does not support multiple descriptions of the same application in multiple IPDs. See also the admin_directory and run_as_superuser options, which control SD’s nonprivileged mode.
PAGE 7
swlist(1M) swlist(1M) return_warning_exitcode=false This option controls the exit code returned by SD’s controller commands. This option is applicable only for a single target operation, and ignored when multiple targets are used. When set to the default value of false, swlist returns: 0 If there were no errors, with or without warnings. 1 If there were errors. When set to true, swlist returns : 0 If there were no warnings and no errors. 1 If there were errors. 2 If there were warnings but no errors.
PAGE 8
swlist(1M) swlist(1M) software= Defines the default software_selections. There is no supplied default. If there is more than one software selection, they must be separated by spaces. software_view=all_bundles Indicates the software view to be used as the default level for the software listing in the GUI. It can be set to all_bundles, products, or a bundle category tag (to indicate to show only bundles of that category). targets= Defines the default target_selections.
PAGE 9
swlist(1M) TZ swlist(1M) 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.
PAGE 10
swlist(1M) swlist(1M) 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.
PAGE 11
swlist(1M) swlist(1M) swlist -s .
PAGE 12
swlist(1M) swlist(1M) /var/adm/sw/ The directory which contains all of the configurable (and non-configurable) data for SD. This directory is also the default location of logfiles. /var/adm/sw/defaults Contains the active system-wide default values for some or all SD options. /var/adm/sw/host_object The file which stores the list of depots registered at the local host. /var/adm/sw/products/ The Installed Products Database (IPD), a catalog of all products installed on a system.