Which Patches Are on a System?

SD-UX is included with the HP-UX operating system and provides a powerful set of tools for centralized HP-UX software management. Many SD-UX commands start with sw; for example: swlist, swinstall, swreg, swremove, swcopy, and swverify. For more information about SD-UX, see the Software Distributor Administration Guide on the HP Technical documentation Web site at http://docs.hp.com.

The swlist command can be invaluable in determining which patches and patch bundles are on an HP-UX system. You can use the swlist command to display information about software products that are installed on a local or remote host, or that are stored in a local or remote depot. You can use the various command arguments and options to customize the information returned. See the swlist(1M) manpage.

This section presents some examples of swlist to display information about patches, bundles, and depots.




	NOTE: For brevity and improved readability, some lines of SD-UX command output have been shortened or removed.

Examples of the swlist Command

Use the swlist command with no arguments to get a default listing of all top-level software installed on the local host:

swlist

For example:

$ swlist
# Initializing...
# Contacting target "some_system"...
#
# Target: some_system:/

# Bundle(s):
BUNDLE11i    B.11.11.0102.2  Required Patch Bundle for HP-UX 11i, February 2001
GOLDAPPS11i  B.11.11.0312.4  Gold Applications Patches for HP-UX 11i v1, Dec 2003
GOLDBASE11i  B.11.11.0312.4  Gold Base Patches for HP-UX 11i v1, December 2003
HWEnable11i  B.11.11.0309.4  Hardware Enablement Patches for HP-UX 11i, Sep 2003
MOZILLA      1.4.0.00.00     Mozilla 1.4 for HP-UX
T1471AA      A.03.50.000     HP-UX Secure Shell 

# Product(s) not contained in a Bundle:
PHCO_28848  1.0  Software Distributor Cumulative Patch
PHCO_29010  1.0  shar(1) patch
PHCO_29495  1.0  libc cumulative patch
PHSS_28677  1.0  CDE Applications Periodic Patch
vim         5.8  Vi IMproved

The swlist command has many arguments. This chapter considers only the following arguments and operands:

swlist [-d] [-l level] [-a attribute] [-s source] [software_selections] [-x option=value] [@ target_selections]

-d
Directs the swlist command to operate on a software depot rather than on software currently installed on the system. When you use this argument, you must also use the @ target_selections argument to specify the depot.
-l level
- Lists all software objects down to the specified level. The following is a partial list of supported level values:
  depot: Lists software available from registered depots.
  bundle: Shows only bundles.
  product: Shows only products.
  patch: Shows all applied patches.
  fileset: Shows products and filesets.
  file: Shows products, filesets, files, and numbers (used in software licensing).
  category: Shows all categories of available patches for patches that have included category objects in their definition.
- Specifies multiple values for level:
  -l bundle -l product: Shows bundles and the products they contain.
-a attribute
Specifies one or more attributes to display. For more information about attributes, see “Patch-Related Attributes”.
-s source
Specifies the software source to list. Use this argument as an alternative way to list a depot.
software_selections
- Specifies software objects to be listed.
- Applies only if the level is bundle, product, fileset, file, or patch.
- Use wildcards [ ], *, ? in the specification of the software_selections if you want to make multiple selections. For example:
  A specification of bun[12] selects software bun1 and bun2.
  A specification of \* selects all software.
- Views the manpages for sd(5) using the command:
  man 5 sd
-x option=value
- Sets the option to specified value.
- The default behavior of the swlist command is to show only the latest patches installed on a system. It does not show patches that have been superseded. To list superseded patches, set the show_superseded_patches option to true:
  swlist -x show_superseded_patches=true
- Specifies multiple -x options if needed.
@ target_selections
- Specifies the target of the command. You can specify the swlist command operate on a system other than the local host or on a depot. For example, to specify the swlist command operate on the system host1:
  swlist @ host1
- Operates on the software depot depot1 located in directory some_directory on the local host:
  swlist @ /some_directory/depot1
- Operates on the depot depot2 located in directory some_directory on the system host1:
  swlist @ host1:/some_directory/depot2

For a complete list of swlist arguments, consult the swlist(1M) manpage or the Software Distributor Administration Guide on the HP Technical documentation Web site at http://docs.hp.com.

To filter the output to display only patches, use the -l argument in combination with a software selection using the category tag patch:

swlist -l level *,c=category_tag

For example:

$ swlist -l product *,c=patch
# Initializing...
# Contacting target "some_system"...
#
# Target:  some_system:/
PHCO_28848   1.0   Software Distributor Cumulative Patch
PHCO_29010   1.0   shar(1) patch
PHCO_29495   1.0   libc cumulative patch
PHSS_28677   1.0   CDE Applications Periodic Patch
...

The following command shows patches that have a manual_dependencies category tag:

swlist -l level *,c=category_tag

For example:

$ swlist -l product *,c=manual_dependencies
# Initializing...
# Contacting target "chb26006"...
#
# Target: chb26006:/
PHCO_24198   1.0   ioscan(1M) patch 
PHCO_25831   1.0   SCSI Ultra160 driver Online Addition script
PHCO_25841   1.0   Add Rock Ridge extension to mount_cdfs(1M)
PHCO_26252   1.0   mount_vxfs(1M) cumulative patch
...

The following command shows bundles on the system specified:

swlist -l level @ target_selections

For example:

$ swlist -l bundle @ some_system
# Initializing...
# Contacting target "some_system"...
#
# Target:  some_system:/
BUNDLE11i   B.11.11.0102.2 Required Patch Bundle for HP-UX 11i, Feb 2001
GOLDAPPS11i B.11.11.0312.4 Gold Applications Patches for HP-UX 11i v1, Dec 2003
GOLDBASE11i B.11.11.0312.4 Gold Base Patches for HP-UX 11i v1, Dec 2003
HWEnable11i B.11.11.0309.4 Hardware Enablement Patches for HP-UX 11i, Sep 2003
MOZILLA     1.4.0.00.00    Mozilla 1.4 for HP-UX
T1471AA     A.03.50.000    HP-UX Secure Shell

Table 3-1: “Variations of the swlist Command” lists numerous swlist command variations that you may find useful. These examples can also help you learn how to combine various swlist arguments.

Table 3-1 Variations of the swlist Command

swlist Commands	Description
swlist -l depot	Displays the registered depots located on the local system.
swlist -l depot @ `some_host`	Displays the registered depots located on the system `some_host`.
swlist -d -l product @ \`some_host:/some_directory/some_depot` swlist -l product -s \`some_host:/some_directory/some_depot`	Alternates commands that list the products stored in the software depot `/some_directory/some_depot` on the system `some_host`.
swlist -d -l product ,c=patch @ \`some_host:/some_directory/some_depot`*	Lists all patches in the depot `/some_directory/some_depot` on the system `some_host`.
swlist -d -l category @ \`some_host:/some_directory/some_depot`	Lists all category tags associated with the contents of the depot `/some_directory/some_depot` on the system `some_host`.
swlist -a readme -l product `patch_id`	Displays the readme documentation for patch `patch_id`.
*swlist -a readme -l product ,c=critical**	Displays the readme documentation for all patches installed on the local system which contain critical functionality.
swlist -l product `some_bundle`	Lists the products contained in bundle `some_bundle`.
swlist -l product -a category_tag `patch_id`	Lists the category tags for patch `patch_id`.
*swlist -l product -a category_tag \,c=patch**	Lists the patches installed on the local system and their corresponding category tags.

Which Patches Are on a System?

Technical documentation

» Table of Contents

» Glossary

» Index

Examples of the swlist Command