lspci Cheatsheet

📅 2020-Nov-02 ⬩ ✍️ Ashwin Nanjappa ⬩ 🏷️ cheatsheet, pci ⬩ 📚 Archive

lspci is the primary tool on Linux to get information about the PCI buses, bridges and devices on your system. I have primarily used lspci to find information about wired/wireless network adapters and graphics cards.

This and other PCI tools ship in the pciutils package. Installing it is easy:

$ sudo apt install pciutils

The source code of pciutils can be accessed here. I find it useful to sometimes go to the source to understand some of the lspci output.
To get a listing of all the buses, bridges and devices on your system:

$ lspci

I typically grep this output to find the specific type of devices I am looking for. For example, to find graphics cards I typically use:

$ lspci | grep -i vga
$ lspci | grep -i nvidia

Every output line of this command has information such as the domain/bus/device/function assigned to the device by the system/OS, the class of device and finally the vendor and device names looked up from the PCI ID database. Here is one example device output line:

ff:0b.0 System peripheral: Intel Corporation Xeon E7 v4/Xeon E5 v4/Xeon E3 v4/Xeon D R3 QPI Link 0/1 (rev 01)

[0000]: Domain. This is not shown when its value is 0x0000. Values are in the range 0x0000 - 0xFFFF.
ff: Bus. Values are in the range 0x00-0xFF.
0b: Device. Values are in the range 0x00-0x1F.
0: Function. Values are in the range 0x0-0x7.
System peripheral: Class of device. Other values I have seen are host bridge, PCI bridge, PIC,
                   USB controller, communication controller, ethernet controller, audio device,
                   ISA bridge, SATA controller, SMBus, VGA compatible controller, serial bus
                   controller, performance counters.
Intel Corporation Xeon E7 v4: Vendor and device name looked up from PCI ID database.

To list verbose information about the devices, use one of three levels of verbosity:

$ lspci -v
$ lspci -vv
$ lspci -vvv

Here is an example of the difference in verbose output between -v and -vv:

$ lspci -d 10de: -v
01:00.0 VGA compatible controller: NVIDIA Corporation GV100 [TITAN V] (rev a1) (prog-if 00 [VGA controller])
        Subsystem: NVIDIA Corporation GV100 [TITAN V]
        Physical Slot: 4
        Flags: bus master, fast devsel, latency 0, IRQ 37, NUMA node 0
        Memory at fa000000 (32-bit, non-prefetchable) [size=16M]
        Memory at e0000000 (64-bit, prefetchable) [size=256M]
        Memory at f0000000 (64-bit, prefetchable) [size=32M]
        I/O ports at e000 [size=128]
        [virtual] Expansion ROM at fb000000 [disabled] [size=512K]
        Capabilities: <access denied>
        Kernel driver in use: nvidia
        Kernel modules: nvidiafb, nouveau, nvidia_drm, nvidia

$ lspci -d 10de: -vv
01:00.0 VGA compatible controller: NVIDIA Corporation GV100 [TITAN V] (rev a1) (prog-if 00 [VGA controller])
        Subsystem: NVIDIA Corporation GV100 [TITAN V]
        Physical Slot: 4
        Control: I/O+ Mem+ BusMaster+ SpecCycle- MemWINV- VGASnoop- ParErr- Stepping- SERR+ FastB2B- DisINTx+
        Status: Cap+ 66MHz- UDF- FastB2B- ParErr- DEVSEL=fast >TAbort- <TAbort- <MAbort- >SERR- <PERR- INTx-
        Latency: 0
        Interrupt: pin A routed to IRQ 37
        NUMA node: 0
        Region 0: Memory at fa000000 (32-bit, non-prefetchable) [size=16M]
        Region 1: Memory at e0000000 (64-bit, prefetchable) [size=256M]
        Region 3: Memory at f0000000 (64-bit, prefetchable) [size=32M]
        Region 5: I/O ports at e000 [size=128]
        [virtual] Expansion ROM at fb000000 [disabled] [size=512K]
        Capabilities: <access denied>
        Kernel driver in use: nvidia
        Kernel modules: nvidiafb, nouveau, nvidia_drm, nvidia

Note that many of the capabilities of the devices may not be displayed in verbose output for non-root users. To get all the information use sudo:

$ sudo lspci -d 10de: -vv

Here is the super detailed output with sudo for the same card as above:

$ sudo lspci -d 10de: -vv
01:00.0 VGA compatible controller: NVIDIA Corporation GV100 [TITAN V] (rev a1) (prog-if 00 [VGA controller])
        Subsystem: NVIDIA Corporation GV100 [TITAN V]
        Physical Slot: 4
        Control: I/O+ Mem+ BusMaster+ SpecCycle- MemWINV- VGASnoop- ParErr- Stepping- SERR+ FastB2B- DisINTx+
        Status: Cap+ 66MHz- UDF- FastB2B- ParErr- DEVSEL=fast >TAbort- <TAbort- <MAbort- >SERR- <PERR- INTx-
        Latency: 0
        Interrupt: pin A routed to IRQ 37
        NUMA node: 0
        Region 0: Memory at fa000000 (32-bit, non-prefetchable) [size=16M]
        Region 1: Memory at e0000000 (64-bit, prefetchable) [size=256M]
        Region 3: Memory at f0000000 (64-bit, prefetchable) [size=32M]
        Region 5: I/O ports at e000 [size=128]
        [virtual] Expansion ROM at fb000000 [disabled] [size=512K]
        Capabilities: [60] Power Management version 3
                Flags: PMEClk- DSI- D1- D2- AuxCurrent=0mA PME(D0-,D1-,D2-,D3hot-,D3cold-)
                Status: D0 NoSoftRst+ PME-Enable- DSel=0 DScale=0 PME-
        Capabilities: [68] MSI: Enable+ Count=1/1 Maskable- 64bit+
                Address: 00000000fee00438  Data: 0000
        Capabilities: [78] Express (v2) Legacy Endpoint, MSI 00
                DevCap: MaxPayload 256 bytes, PhantFunc 0, Latency L0s unlimited, L1 <64us
                        ExtTag+ AttnBtn- AttnInd- PwrInd- RBE+ FLReset-
                DevCtl: Report errors: Correctable- Non-Fatal- Fatal- Unsupported-
                        RlxdOrd+ ExtTag+ PhantFunc- AuxPwr- NoSnoop-
                        MaxPayload 256 bytes, MaxReadReq 512 bytes
                DevSta: CorrErr- UncorrErr- FatalErr- UnsuppReq- AuxPwr- TransPend-
                LnkCap: Port #0, Speed 8GT/s, Width x16, ASPM L0s L1, Exit Latency L0s <512ns, L1 <4us
                        ClockPM+ Surprise- LLActRep- BwNot- ASPMOptComp+
                LnkCtl: ASPM Disabled; RCB 64 bytes Disabled- CommClk+
                        ExtSynch- ClockPM+ AutWidDis- BWInt- AutBWInt-
                LnkSta: Speed 2.5GT/s, Width x16, TrErr- Train- SlotClk+ DLActive- BWMgmt- ABWMgmt-
                DevCap2: Completion Timeout: Range AB, TimeoutDis+, LTR-, OBFF Via message
                DevCtl2: Completion Timeout: 50us to 50ms, TimeoutDis-, LTR-, OBFF Disabled
                LnkCtl2: Target Link Speed: 8GT/s, EnterCompliance- SpeedDis-
                         Transmit Margin: Normal Operating Range, EnterModifiedCompliance- ComplianceSOS-
                         Compliance De-emphasis: -6dB
                LnkSta2: Current De-emphasis Level: -6dB, EqualizationComplete+, EqualizationPhase1+
                         EqualizationPhase2+, EqualizationPhase3+, LinkEqualizationRequest-
        Capabilities: [100 v1] Virtual Channel
                Caps:   LPEVC=0 RefClk=100ns PATEntryBits=1
                Arb:    Fixed- WRR32- WRR64- WRR128-
                Ctrl:   ArbSelect=Fixed
                Status: InProgress-
                VC0:    Caps:   PATOffset=00 MaxTimeSlots=1 RejSnoopTrans-
                        Arb:    Fixed- WRR32- WRR64- WRR128- TWRR128- WRR256-
                        Ctrl:   Enable+ ID=0 ArbSelect=Fixed TC/VC=01
                        Status: NegoPending- InProgress-
        Capabilities: [258 v1] L1 PM Substates
                L1SubCap: PCI-PM_L1.2+ PCI-PM_L1.1+ ASPM_L1.2+ ASPM_L1.1+ L1_PM_Substates+
                          PortCommonModeRestoreTime=255us PortTPowerOnTime=10us
                L1SubCtl1: PCI-PM_L1.2- PCI-PM_L1.1- ASPM_L1.2- ASPM_L1.1-
                           T_CommonMode=0us LTR1.2_Threshold=0ns
                L1SubCtl2: T_PwrOn=10us
        Capabilities: [128 v1] Power Budgeting <?>
        Capabilities: [420 v2] Advanced Error Reporting
                UESta:  DLP- SDES- TLP- FCP- CmpltTO- CmpltAbrt- UnxCmplt- RxOF- MalfTLP- ECRC- UnsupReq- ACSViol-
                UEMsk:  DLP- SDES- TLP- FCP- CmpltTO- CmpltAbrt- UnxCmplt- RxOF- MalfTLP- ECRC- UnsupReq- ACSViol-
                UESvrt: DLP+ SDES+ TLP- FCP+ CmpltTO- CmpltAbrt- UnxCmplt- RxOF+ MalfTLP+ ECRC- UnsupReq- ACSViol-
                CESta:  RxErr- BadTLP- BadDLLP- Rollover- Timeout- NonFatalErr-
                CEMsk:  RxErr- BadTLP- BadDLLP- Rollover- Timeout- NonFatalErr+
                AERCap: First Error Pointer: 00, GenCap- CGenEn- ChkCap- ChkEn-
        Capabilities: [600 v1] Vendor Specific Information: ID=0001 Rev=1 Len=024 <?>
        Capabilities: [900 v1] #19
        Capabilities: [ac0 v1] #23
        Kernel driver in use: nvidia
        Kernel modules: nvidiafb, nouveau, nvidia_drm, nvidia

Some of the information I find useful in the sudo verbose output are:

LnkSta line: From this Link Status line above (source) I can see that this has a speed of 2.5GT/s. This means it is PCIe v1 (source). And I can see the width is x16 so it has 16 lanes. What this translates to is 2.5 / 8 * 16 = 5GB/s.
To list PCI information in a machine readable format, that is easy for parsing through scripts:

$ lspci -m

Here is an example output line showing the difference between the default and machine readable options:

ff:0b.0 System peripheral: Intel Corporation Xeon E7 v4/Xeon E5 v4/Xeon E3 v4/Xeon D R3 QPI Link 0/1 (rev 01)

ff:0b.0 "System peripheral" "Intel Corporation" "Xeon E7 v4/Xeon E5 v4/Xeon E3 v4/Xeon D R3 QPI Link 0/1" -r01 "ASRock Incorporation" "Xeon E7 v4/Xeon E5 v4/Xeon E3 v4/Xeon D R3 QPI Link 0/1"

To list PCI information including vendor and device PCI IDs:

$ lspci -nn

Example output line:

ff:0b.0 System peripheral [0880]: Intel Corporation Xeon E7 v4/Xeon E5 v4/Xeon E3 v4/Xeon D R3 QPI Link 0/1 [8086:6f81] (rev 01)

8086: Vendor ID for Intel Corporation. (Isn't it cool that Intel's ID is 0x8086?)
6f81: Device ID.

To filter by vendor ID or device ID:

$ lspci -d 8086:  # List Intel devices
$ lspci -d 10de:  # List NVIDIA devices

$ lspci -d :6f81

Filtering by vendor ID is useful to look at devices by popular vendors, like Intel or NVIDIA for example.

To list the kernel driver and kernel modules used by the devices:

$ lspci -k

To view the tree of PCI connections:

$ lspci -t

Here is an example output showing that roots are buses and leaf nodes are devices:

-+-[0000:ff]-+-0b.0
             +-0b.1
             +-0b.2
             +-0b.3
             +-0c.0
             +-0c.1
             +-0c.2
             +-0c.3

[0000.ff]: Domain 0x0000 and bus 0.FF.
0b.0: Device 0x0B and function 0x0.

This device will list in the default output as ff:0b.0.

References:

lspci manpage
lspci examples (The Geek Stuff)

Tried with: Ubuntu 18.04