 |
» |
|
|
|
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.
|
|
Printable version
