[  Previous  |
Next  |
Contents  |
Glossary  |
Home  |
Search  ]
AIX Version 4.3 Commands Reference, Volume 3
lslpp Command
Purpose
Lists software products.
lslpp { -d | -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 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. | 
| -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. | 
| -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 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
- 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.*"
 
- To list the installation state for the base level and 
updates for the fileset bos.rte.filesystem
, enter:
lslpp -La bos.rte.filesystem
 
- To list the installation history information of all the 
filesets in the bos.net
 software package, enter:
lslpp -ha 'bos.net.*'
 
- To list the names of all the files of the 
bos.rte.lvm
 fileset, enter:
lslpp -f bos.rte.lvm
 
- 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
 
- 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 
- 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.
[  Previous  |
Next  |
Contents  |
Glossary  |
Home  |
Search  ]