[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 3
lslpp Command
Purpose
Lists software products.
Syntax
lslpp { -d | -E | -f | -h | -i | -l |
-L | -p } ] [ -a] [ -c]
[ -J ] [ -q ] [ -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 a formatted fileset.
When only the -l (lowercase L)
flag is entered, the lslpp command displays the latest
installed level of the fileset specified for formatted filesets. The base
level fileset is displayed for 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, and -q flags specify the amount
and format of the information that is displayed in the report.
The -O flag specifies that data is to come from a
specified part of the fileset. The part may be the root part, -Or, the share part, -Os, or the usr part, -Ou.
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 quotation marks). However, using
single quotation marks 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 the
operating system 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. |
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. |
-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. |
-E |
Lists license agreements. |
-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. |
-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. |
-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 formatted filesets, it 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 4.2
or later. |
You must specify one of the mutually exclusive flags:
-d, -E, -f, -h, -i, -L, -l, -p, and -w.
Examples
- To list the installation state for the most
recent level of installed filesets for all of the bos.rte filesets, type:
lslpp -l "bos.rte.*"
- To list the installation state for the base
level and updates for the fileset bos.rte.filesystem,
type:
lslpp -La bos.rte.filesystem
- To list the installation history information
of all the filesets in the bos.net software package,
type:
lslpp -ha 'bos.net.*'
- To list the names of all the files of the
bos.rte.lvm fileset, type:
lslpp -f bos.rte.lvm
- To list the fileset that owns installp, type:
lslpp -w /usr/sbin/installp
Output similar to the following displays:
File Fileset
Type
-----------------------------------------------------------------
/usr/sbin/installp bos.rte.install File
- To list the fileset that owns all file names
that contain installp, type:
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
- To display all files in the inventory database,
type:
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, inulag
command, nim command.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]