Commands Reference, Volume 3

lscfg Command

Purpose

Displays configuration, diagnostic, and vital product data (VPD) information about the system.

Syntax

To Display Specific Data on all Systems

lscfg [ -v ] [ -p ] [ -s ] [ -l Name ]

Description

If you run the lscfg command without any flags, it displays the name, location and description of each device found in the current Customized VPD object class that is a child device of the sys0 object. It will not display any device that has been marked missing in the Customized Device Object Class. The list is sorted by parent, child, and device location. Information on a specific device can be displayed with the -l flag.

Use the lscfg command to display vital product data (VPD) such as part numbers, serial numbers, and engineering change levels from either the Customized VPD object class or platform specific areas. Not all devices contain VPD data.

VPD data that is preceded by ME signifies that the VPD data was entered manually using a diagnostic service aid. For some devices, the vital product data is collected automatically from the devices through methods and added to the Customized VPD object class.

If you run the lscfg command with the -p flag, it displays device information stored in the platform specific data areas. When used with the -v flag, VPD data stored for these devices is also displayed. This information is obtained on a Common Hardware Reference Platform (CHRP) system from the open firmware device tree.

-l Name	Displays device information for the named device.
-p	Displays the platform-specific device information. This flag only applies to AIX 4.2.1 or later.
-v	Displays the VPD found in the Customized VPD object class. Also, on AIX 4.2.1 or later, displays platform specific VPD when used with the -p flag.
-s	Displays the device description on a separate line from the name and location.

Examples

To display the system configuration, enter:

         lscfg

The system displays a message similar to the following:

INSTALLED RESOURCE LIST

The following resources are installed on the machine:

+/- = Added or deleted from Resource List.
*   = Diagnostic support not available.

  Model Architecture: chrp
  Model Implementation: Multiple Processor, PCI bus

+ sys0                             System Object
+ sysplanar0                       System Planar
+ mem0                             Memory
+ L2cache0                         L2 Cache
+ proc0            U1.1-P1-C1      Processor
* pci3             U0.2-P1         PCI Bus
+ scsi0            U0.1-P1/Z1      Wide/Ultra-2 SCSI I/O Controller
+ rmt0             U1.1-P1/Z1-A3   SCSI 4mm Tape Drive (12000 MB)
+ cd0              U1.1-P1/Z1-A5   SCSI Multimedia CD-ROM Drive (650 MB)
+ hdisk0           U1.1-P1/Z1-A9   16 Bit LVD SCSI Disk Drive (4500 MB)
+ fd0              U0.1-P1-D1      Diskette Drive
..
..

To display the system configuration with the device description on a separate line, enter:

         lscfg  -s

The system displays a message similar to the following:

INSTALLED RESOURCE LIST

The following resources are installed on the machine:

+/- = Added or deleted from Resource List.
*   = Diagnostic support not available.
        
  Model Architecture: chrp
  Model Implementation: Multiple Processor, PCI bus
        
+ sys0             U1.1-P1-C2      
        System Object
+ sysplanar0                       
        System Planar
+ mem0                             
        Memory
+ L2cache0                         
        L2 Cache
+ proc0            U1.1-P1-C1      
        Processor
+ proc1            U1.1-P1-C1      
        Processor
+ hdisk0           U1.1-P1/Z1-A9   16 Bit LVD SCSI Disk Drive (4500 MB)
+ fd0              U0.1-P1-D1      Diskette Drive
..
..

To display the name, location, and description for devices specified by the logical name proc without VPD, enter:

lscfg -lproc\*

The system displays information for all devices with logical names beginning with proc, as follows:

  proc0            U1.1-P1-C1  Processor
  proc1            U1.1-P1-C1  Processor
  proc2            U1.1-P1-C1  Processor
  proc3            U1.1-P1-C1  Processor
  proc4            U1.1-P1-C2  Processor
  proc5            U1.1-P1-C2  Processor
  proc6            U1.1-P1-C2  Processor
  proc7            U1.1-P1-C2  Processor

To display the VPD for a specific device specified by the logical name ent0, enter:

         lscfg  -v -l ent0

The system displays the following:

 ent0             U0.1-P1-I2/E1   Gigabit Ethernet-SX PCI Adapter (14100401)

        Network Address.............0004AC7C00C4
        Displayable Message.........Gigabit Ethernet-SX PCI Adapter (14100401)

        EC Level....................E77998
        Part Number.................07L8916
        FRU Number..................07L8918
        Device Specific.(YL)........U0.1-P1-I2/E1

To display the VPD in the open firmware device tree for the corresponding node to the ent0 device, enter:

 lscfg -vp -lent0

The following is displayed:

  ent0             U0.1-P1-I2/E1  Gigabit Ethernet-SX PCI Adapter (14100401)

        Network Address.............0004AC7C00C4
        Displayable Message.........Gigabit Ethernet-SX PCI Adapter (14100401)

        EC Level....................E77998
        Part Number.................07L8916
        FRU Number..................07L8918
        Device Specific.(YL)........U0.1-P1-I2/E1


  PLATFORM SPECIFIC

  Name:  ethernet
    Model:  Galaxy, EtherLink 1000-SX-IBM
    Node:  ethernet@1
    Device Type:  network
    Physical Location: U0.1-P1-I2/E1

Files

/usr/sbin/lscfg

Contains the lscfg command.

Related Information

The lsattr command, lsconn command, lsdev command, lsparent command.