Skip to main content

system controller pci show

Display the PCI Device Table

Availability: This command is available to cluster administrators at the admin privilege level.

Description​

The system controller pci show command displays details of the PCI devices present in all of the nodes in a cluster. These commands are available for 80xx, 25xx and later systems. Earlier models are not supported. By default, the command displays the following information about the PCI devices:

  • Node name

  • Display name

  • Correctable error count

  • Functional link width

  • Functional link speed

  • Health monitor status

To display more details, use the -instance parameter.

Parameters​

{ [-fields <fieldname>, ...]
Selects the fields that you specify.
| [-instance ]}
Displays detailed information for all of the PCI devices.
[-node {<nodename>|local}] - Node
Selects the PCI devices that are present in the specified node.
[-bus-number <integer>] - Bus Number
Selects the PCI devices with the specified bus number.
[-device-number <integer>] - Device Number
Selects the PCI devices with the specified device number.
[-function-number <integer>] - Function Number
Selects the PCI devices with the specified function number.
[-slot-number <integer>] - Slot Info
Selects the PCI devices with the specified slot number.
[-monitor {node-connect|system-connect|system|controller|chassis|cluster-switch|example}] - Health Monitor Name
Selects the PCI devices monitored by the specified health monitor.
[-vendor-id <Hex Integer>] - Vendor ID
Selects the PCI devices with the specified vendor ID.
[-device-id <Hex Integer>] - Device ID
Selects the PCI devices with the specified device ID.
[-physical-link-width <integer>] - Physical Link Width
Selects the PCI devices with the specified physical link width.
[-functional-link-width <integer>] - Functional Link Width
Selects the PCI devices with the specified functional link width.
[-physical-link-speed <text>] - Physical Link Speed(GT/s)
Selects the PCI devices with the specified physical link speed.
[-functional-link-speed <text>] - Functional Link Speed(GT/s)
Selects the PCI devices with the specified functional link speed.
[-unique-name <text>] - Unique Name
Selects the PCI devices with the specified unique name.
[-corr-err-count <integer>] - Correctable Error Count
Selects the PCI devices with the specified correctable error count.
[-health {ok|ok-with-suppressed|degraded|unreachable|unknown}] - Status
Selects the PCI devices with the specified health monitor status.
[-display-name <text>] - Display Name
Selects the PCI devices with the specified display name.
[-cerr-diff <integer>] - Correctable Error Difference
Selects the PCI devices with the specified difference in correctable error count.

Examples​

The example below displays the information about the PCIe devices present in all of the nodes in the cluster. 

cluster1::> system controller pci show
              Display                  Correctable Functional Functional
Node          Name                     Error Count Link Width Link Speed Status
------------- ------------------------ ----------- ---------- ---------- ------
cluster1-01   Ontap PCI Device 0                 0          4      5GT/s ok
cluster1-02   Ontap PCI Device 4                 0          4      5GT/s ok

The example below displays detailed information about a PCIe device in a node.
cluster1::> system controller pcie show -instance -node cluster1-01 -bus-number 1

                        Node: cluster1-01
                  Bus Number: 1
               Device Number: 0
             Function Number: 0
                   Slot Info: 0
         Health Monitor Name: controller
                   Vendor ID: 11f8
                   Device ID: 8001
         Physical Link Width: 4
       Functional Link Width: 4
   Physical Link Speed(GT/s): 5GT/s
 Functional Link Speed(GT/s): 5GT/s
                 Unique Name: ontap0@pci0:1:0:0
     Correctable Error Count: 0
                      Status: ok
                Display Name: Ontap PCI Device 0
Correctable Error Difference: 0