Displaying PCI Slot Configuration Information

Language:

The cfgadm command displays only hot-pluggable PCI devices and slots. It does not provide information about PCI devices that are not hot-pluggable.

Note - The logical Ap_Id in most cases should match the slot label that is silk-screened on the system chassis. Refer to your platform guide for the cfgadm output of the hot-pluggable slots. The Busy field can be displayed to ensure that the Ap_Id is not transitioning to another state before a hot-plug operation is attempted.

You can also use the prtconf command to display additional configuration information that pertains to the hardware, such as verifying that added hardware is correctly configured.For example, after a configure operation, use the prtconf –D command to verify that the driver is attached to the newly installed hardware device. If the device driver has not been added to the system prior to hardware configuration, you can manually add it by using the add_drv command.

For more information, see prtconf(8) and add_drv(8).

The following examples show how to display the status of PCI hot-pluggable devices and slots on the system. You must have the appropriate administrator rights to run these commands.

Note - For brevity, the examples on this section list only PCI attachment points. The attachment points that are displayed on your system depend on your system configuration.

Example 11 Displaying PCI Slot Configuration Information

# cfgadm
Ap_Id                Type         Receptacle   Occupant     Condition
pci1:hpc0_slot0      unknown      empty        unconfigured unknown
pci1:hpc0_slot1      unknown      empty        unconfigured unknown
pci1:hpc0_slot2      unknown      empty        unconfigured unknown
pci1:hpc0_slot3      ethernet/hp  connected    configured   ok
pci1:hpc0_slot4      unknown      empty        unconfigured unknown

Example 12 Displaying Specific PCI Device Information

# cfgadm -s "cols=ap_id:type:info" pci
Ap_Id                Type         Information
pci1:hpc0_slot0      unknown      Slot 7
pci1:hpc0_slot1      unknown      Slot 8
pci1:hpc0_slot2      unknown      Slot 9
pci1:hpc0_slot3      ethernet/hp  Slot 10
pci1:hpc0_slot4      unknown      Slot 11

In the output, pci1:hpc0_slot0 is the logical Ap_Id for the hot-pluggable slot, Slot 7. The component hpc0 indicates the hot-pluggable adapter card for this slot, and pci1 indicates the PCI bus instance. The Type field indicates the type of PCI adapter card that is present in the slot.

Example 13 Displaying PCIe Slot Configuration Information

# cfgadm pci
Ap_Id                Type         Receptacle   Occupant     Condition
pcie1                unknown      empty        unconfigured unknown
pcie2                unknown      empty        unconfigured unknown
pcie3                unknown      empty        unconfigured unknown
pcie4                etherne/hp   connected    configured   ok
pcie5                pci-pci/hp   connected    configured   ok
pcie6                unknown      disconnected unconfigured unknown

Example 14 Displaying Specific PCIe Device Information

# cfgadm -s "cols=ap_id:busy:o_state" pci
Ap_Id               Busy     Occupant
pcie1               n        unconfigured
pcie2               n        unconfigured
pcie3               n        unconfigured
pcie4               n        configured
pcie5               n        configured
pcie6               n        configured

Displaying PCI slot configuration information.
Displaying specific PCI device information.
Displaying PCIe slot configuration information.
Displaying specific PCIe device information.