lslpp
lslpp Command
Purpose
Lists software products.
Syntax
lslpp { -d | -f | -h | -i | -l | -L | -p } ] [ -a ] [ -c ]
[ -J ] [ -q ] [ -B | -I ] [ -O { [ r ] [ s ] [ u ] }
] [ FilesetName ... | FixID ... | all ]
OR
lslpp -w [ -c ] [ -q ] [ -O { [ r ] [ s ] [ u ] } ]
[ FileName ... | all ]
Description
The lslpp command displays information about installed filesets or
fileset updates. The FilesetName parameter is the name of a software
product. The FixID (also known as PTF or program temporary fix ID)
parameter specifies the identifier of an update to an AIX 3.2 formatted
fileset.
When only the -l (lowercase L) flag is entered, the lslpp command
displays the latest installed level of the fileset specified for AIX
3.1 and 4 formatted filesets. The base level fileset is displayed
for AIX 3.2 formatted filesets. When the -a flag is entered along
with the -l flag, the lslpp command displays information about all
installed filesets for the FilesetName specified. The -I (uppercase
i) flag combined with the -l (lowercase L) flag specifies that the
output from the lslpp command should be limited to base level filesets.
The -d, -f, -h, -i, -l (lowercase L), -L, and -p flags request different
types of output reports.
The -a, -c, -J, -O, and -q flags specify the amount and format of
the information that is displayed in the report.
The default value for the FilesetName parameter is all, which displays
information about all installed software products. Pattern matching
characters, such as * (asterisk) and ? (question mark), are valid
in the ProductName and FixID parameters. You don't have to enclose
these characters in '' (single quotes). However, using single quotes
prevents you from searching the contents of your present directory.
Output Values
Much of the output from the lslpp command is understandable without
an explanation. Other fields contain data that needs to be defined.
The following sections define terms used in several of the output
fields.
State Values
The state field in the lslpp output gives the state of the fileset
on your system. It can have the following values:
State Definition
APPLIED The specified fileset is installed on the system. The APPLIED
state means that the fileset can be rejected with the installp command
and the previous level of the fileset restored. This state is only
valid for Version 4 fileset updates and 3.2 migrated filesets.
APPLYING An attempt was made to apply the specified fileset, but it
did not complete successfully, and cleanup was not performed.
BROKEN The specified fileset or fileset update is broken and should
be reinstalled before being used.
COMMITTED The specified fileset is installed on the system. The COMMITTED
state means that a commitment has been made to this level of the software.
A committed fileset update cannot be rejected, but a committed fileset
base level and its updates (regardless of state) can be removed or
deinstalled by the installp command.
OBSOLETE The specified fileset was installed with an earlier version
of AIX, (for example, 3.2) but has been replaced by a repackaged (renamed)
newer version. Some of the files that belonged to this fileset have
been replaced by versions from the repackaged fileset.
COMMITTING An attempt was made to commit the specified fileset, but
it did not complete successfully, and cleanup was not performed.
REJECTING An attempt was made to reject the specified fileset, but
it did not complete successfully, and cleanup was not performed.
Action Values
The action field in the lslpp output identifies the installation action
that was taken for the fileset. The following values may be found
in this field:
Action Definition
APPLY An attempt was made to apply the specified fileset.
CLEANUP An attempt was made to perform cleanup for the specified fileset.
COMMIT An attempt was made to commit the specified fileset.
REJECT An attempt was made to reject the specified fileset.
Status Values
The status field in the lslpp output identifies the resultant status
in the history of installation actions. The following values may be
found in this field:
Status Definition
BROKEN The fileset was left in a broken state after the specified
action.
CANCELED The specified action was canceled before it completed.
COMPLETE The commitment of the fileset has completed successfully.
NONE This fileset update has not been installed but a superseding
update has (applicable to AIX 3.2 formatted fileset updates only).
Flags
-a Displays all the information about filesets specified when combined
with other flags. This flag shows all updates when combined with the
-l flag and all history when combined with the -h flag. This flag
cannot be specified with the -f flag, and can only be specified with
the -B flag when the -h flag is also specified.
-B Limits the inputs to PTF fix ID numbers (for example U412345).
This flag cannot be specified with the -f or the -I (uppercase i)
flag.
-c Displays information as a list separated by colons. This flag cannot
be specified with the -J flag.
-d Displays filesets that are dependents of the specified software.
A dependent fileset is one that has the specified software as a prerequisite,
corequisite, ifrequisite, or installed requisite.
-f Displays the names of the files added to the system during installation
of the specified fileset. This flag cannot be specified with the -a
flag or the -B flag.
-h Displays the installation and update history information for the
specified fileset. You cannot use this flag with the -J flag.
-I (uppercase i)Limits the inputs to software products. This flag
cannot be specified with the -B flag.
-i Displays the product information for the specified fileset.
-J Generates output in a form suitable for the System Management Interface
Tool (SMIT) command to list output. This flag can only be specified
with the -l (lowercase L) and -L flags.
-l (lowercase L) Displays the name, most recent level, state, and
description of the specified fileset.
-L Displays the name, most recent level, state, and description of
the specified fileset. Part information (usr, root, and share) is
consolidated into the same listing. For AIX 3.2 formatted filesets,
displays the most recent maintenance level for the specified filesets.
In addition, this flag lists any subsystem selective fixes that were
installed on top of the maintenance level.
-O Lists information for the specified part of the fileset. When the
-O flag is not specified information is listed for all parts. This
option is designed for use by the nim command to list software product
information for diskless or dataless workstations. You can use the
following flags with this flag:
-r Indicates to list information for the root part.
-s Indicates to list information for the /usr/share part.
-u Indicates to list information for the /usr part.
-p Displays requisite information for the specified fileset.
-q Suppresses the display of column headings.
-w Lists fileset that owns this file. This flag applies to AIX Version
4.2 or later.
You must specify one of the mutually exclusive flags: -d, -f, -h,
-i, -L, -l, -p, and -w.
Examples
1. To list the installation state for the most recent level of installed
filesets for all of the bos.rte filesets, enter:
lslpp -l "bos.rte.*"
2. To list the installation state for the base level and updates for
the fileset bos.rte.filesystem, enter:
lslpp -La bos.rte.filesystem
3. To list the installation history information of all the filesets
in the bos.net software package, enter:
lslpp -ha 'bos.net.*'
4. To list the names of all the files of the bos.rte.lvm fileset,
enter:
lslpp -f bos.rte.lvm
5. To list the fileset that owns installp, enter:
lslpp -w /usr/sbin/installp"
Output similar to the following displays:
File Fileset Type
-----------------------------------------------------------------
/usr/sbin/installp bos.rte.install File
6. To list the fileset that owns all file names that contain installp,
enter:
lslpp -w "*installp*"
Output similar to the following displays:
File Fileset Type
-----------------------------------------------------------------
/usr/sbin/installp bos.rte.install File
/usr/clvm/sbin/linstallpv prpq.clvm File
/usr/lpp/bos.sysmgt/nim/methods/c_installp
bos.sysmgt.nim.client File
7. To display all files in the inventory database, enter:
lslpp -w
Files
/etc/objrepos/history Specifies installation and update history information
of all software products on the root.
/usr/lib/objrepos/history Specifies installation and update history
information of all software products on the /usr file system.
/usr/share/lib/objrepos/history Specifies installation and update
history information of all software products on the /usr/share file
system.
/etc/objrepos/lpp Specifies installation information of all software
products on the root.
/usr/lib/objrepos/lpp Specifies installation information of all software
products on the /usr file system.
/usr/share/lib/objrepos/lpp Specifies installation information of
all software products on the /usr/share file system.
/etc/objrepos/product Specifies installation and update information
of all software products on the root.
/usr/lib/objrepos/product Specifies installation and update information
of all software products on the /usr file system.
/usr/share/lib/objrepos/product Specifies installation and update
information of all the software products on the /usr/share file system.
/etc/objrepos/inventory Specifies names and locations of files in
a software product on the root.
/usr/lib/objrepos/inventory Specifies names and locations of files
in a software product on the /usr file system.
/usr/share/lib/objrepos/inventory Specifies names and locations of
files in a software product on the /usr/share file system.
Related Information
The installp command, nim command.
Installing Optional Software and Service Updates in AIX Installation
Guide.