Skip to main content

system controller pci show

Contributors
Suggest changes

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|ethernet-switch}] - 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