linux:kernel:pci_devices
This is an old revision of the document!
Table of Contents
Linux - Kernel - PCI Devices
The PCI standard has become the de-facto standard for system buses.
Linux provide extensive support for PCI, and contains numerous drivers for network, storage and 3rd party adapters.
The Linux kernel represents PCI devices as pseudo-devices in the sysfs file system:
ls -la /sys/bus/pci/devices
returns:
total 0 drwxr-xr-x 2 root root 0 Jan 29 03:47 . drwxr-xr-x 5 root root 0 Jan 29 03:47 .. lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:00.0 -> ../../../devices/pci0000:00/0000:00:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:00.2 -> ../../../devices/pci0000:00/0000:00:00.2 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:01.0 -> ../../../devices/pci0000:00/0000:00:01.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:01.2 -> ../../../devices/pci0000:00/0000:00:01.2 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:02.0 -> ../../../devices/pci0000:00/0000:00:02.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:03.0 -> ../../../devices/pci0000:00/0000:00:03.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:03.1 -> ../../../devices/pci0000:00/0000:00:03.1 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:04.0 -> ../../../devices/pci0000:00/0000:00:04.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:05.0 -> ../../../devices/pci0000:00/0000:00:05.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:07.0 -> ../../../devices/pci0000:00/0000:00:07.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:07.1 -> ../../../devices/pci0000:00/0000:00:07.1 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:08.0 -> ../../../devices/pci0000:00/0000:00:08.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:08.1 -> ../../../devices/pci0000:00/0000:00:08.1 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:14.0 -> ../../../devices/pci0000:00/0000:00:14.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:14.3 -> ../../../devices/pci0000:00/0000:00:14.3 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:18.0 -> ../../../devices/pci0000:00/0000:00:18.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:18.1 -> ../../../devices/pci0000:00/0000:00:18.1 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:18.2 -> ../../../devices/pci0000:00/0000:00:18.2 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:18.3 -> ../../../devices/pci0000:00/0000:00:18.3 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:18.4 -> ../../../devices/pci0000:00/0000:00:18.4 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:18.5 -> ../../../devices/pci0000:00/0000:00:18.5 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:18.6 -> ../../../devices/pci0000:00/0000:00:18.6 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:18.7 -> ../../../devices/pci0000:00/0000:00:18.7 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:01:00.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:02:03.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:03.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:02:04.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:04.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:02:05.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:05.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:02:08.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:08.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:02:09.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:09.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:02:0a.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:0a.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:03:00.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:03.0/0000:03:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:04:00.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:04.0/0000:04:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:05:00.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:05.0/0000:05:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:06:00.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:08.0/0000:06:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:06:00.1 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:08.0/0000:06:00.1 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:06:00.3 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:08.0/0000:06:00.3 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:07:00.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:09.0/0000:07:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:08:00.0 -> ../../../devices/pci0000:00/0000:00:01.2/0000:01:00.0/0000:02:0a.0/0000:08:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:09:00.0 -> ../../../devices/pci0000:00/0000:00:03.1/0000:09:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:09:00.1 -> ../../../devices/pci0000:00/0000:00:03.1/0000:09:00.1 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:0a:00.0 -> ../../../devices/pci0000:00/0000:00:07.1/0000:0a:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:0b:00.0 -> ../../../devices/pci0000:00/0000:00:08.1/0000:0b:00.0 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:0b:00.1 -> ../../../devices/pci0000:00/0000:00:08.1/0000:0b:00.1 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:0b:00.3 -> ../../../devices/pci0000:00/0000:00:08.1/0000:0b:00.3 lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:0b:00.4 -> ../../../devices/pci0000:00/0000:00:08.1/0000:0b:00.4
Analyze one device
Take one example from the list:
lrwxrwxrwx 1 root root 0 Jan 29 03:47 0000:00:03.0 -> ../../../devices/pci0000:00/0000:00:03.0
NOTE: Break the device string 0000:03:00.0 down as follows:
- 0000 : PCI domain. Each domain can contain up to 256 PCI buses.
- 03 : The bus number the device is attached to.
- 00 : The device number.
- .0 : PCI device function.
Obtain Information on a specific PCI device
cd /sys/devices/pci0000:00/0000:00:03.0 ls -al
returns:
total 0 drwxr-xr-x 4 root root 0 Jan 29 03:47 . drwxr-xr-x 28 root root 0 Jan 23 13:03 .. -r--r--r-- 1 root root 4.0K Jan 29 10:35 ari_enabled -rw-r--r-- 1 root root 4.0K Jan 29 10:35 broken_parity_status -r--r--r-- 1 root root 4.0K Jan 29 10:35 class -rw-r--r-- 1 root root 4.0K Jan 29 10:35 config -r--r--r-- 1 root root 4.0K Jan 29 10:35 consistent_dma_mask_bits -rw-r--r-- 1 root root 4.0K Jan 29 10:35 d3cold_allowed -r--r--r-- 1 root root 4.0K Jan 29 03:47 device -r--r--r-- 1 root root 4.0K Jan 29 10:35 dma_mask_bits -rw-r--r-- 1 root root 4.0K Jan 29 10:35 driver_override -rw-r--r-- 1 root root 4.0K Jan 29 10:35 enable lrwxrwxrwx 1 root root 0 Jan 29 10:35 iommu -> ../0000:00:00.2/iommu/ivhd0 lrwxrwxrwx 1 root root 0 Jan 29 10:35 iommu_group -> ../../../kernel/iommu_groups/3 -r--r--r-- 1 root root 4.0K Jan 29 10:35 irq drwxr-xr-x 2 root root 0 Jan 29 10:35 link -r--r--r-- 1 root root 4.0K Jan 29 10:35 local_cpulist -r--r--r-- 1 root root 4.0K Jan 29 10:35 local_cpus -r--r--r-- 1 root root 4.0K Jan 29 10:35 modalias -rw-r--r-- 1 root root 4.0K Jan 29 10:35 msi_bus -rw-r--r-- 1 root root 4.0K Jan 29 10:35 numa_node drwxr-xr-x 2 root root 0 Jan 29 10:35 power --w--w---- 1 root root 4.0K Jan 29 10:35 remove --w------- 1 root root 4.0K Jan 29 10:35 rescan -r--r--r-- 1 root root 4.0K Jan 29 10:35 resource -r--r--r-- 1 root root 4.0K Jan 29 03:47 revision lrwxrwxrwx 1 root root 0 Jan 29 03:47 subsystem -> ../../../bus/pci -r--r--r-- 1 root root 4.0K Jan 29 10:35 subsystem_device -r--r--r-- 1 root root 4.0K Jan 29 10:35 subsystem_vendor -rw-r--r-- 1 root root 4.0K Jan 29 03:47 uevent -r--r--r-- 1 root root 4.0K Jan 29 03:47 vendor
NOTE: Each sysfs entry contains a unique piece of data, such as the PCI vendor id (vendor) the device class (class), the device identifier (device), and information on irq and resource assignments.
Get Vendor
cat vendor 0x14e4
returns:
0x1022
Get Device
cat device
returns:
0x1482
Get Class
cat class
returns:
0x060000
Viewing PCI data with lspci
View the devices connected to your system:
lspci | tail -10
returns:
06:00.3 USB controller: Advanced Micro Devices, Inc. [AMD] Matisse USB 3.0 Host Controller 07:00.0 SATA controller: Advanced Micro Devices, Inc. [AMD] FCH SATA Controller [AHCI mode] (rev 51) 08:00.0 SATA controller: Advanced Micro Devices, Inc. [AMD] FCH SATA Controller [AHCI mode] (rev 51) 09:00.0 VGA compatible controller: NVIDIA Corporation GP107 [GeForce GTX 1050 Ti] (rev a1) 09:00.1 Audio device: NVIDIA Corporation GP107GL High Definition Audio Controller (rev a1) 0a:00.0 Non-Essential Instrumentation [1300]: Advanced Micro Devices, Inc. [AMD] Starship/Matisse PCIe Dummy Function 0b:00.0 Non-Essential Instrumentation [1300]: Advanced Micro Devices, Inc. [AMD] Starship/Matisse Reserved SPP 0b:00.1 Encryption controller: Advanced Micro Devices, Inc. [AMD] Starship/Matisse Cryptographic Coprocessor PSPCPP 0b:00.3 USB controller: Advanced Micro Devices, Inc. [AMD] Matisse USB 3.0 Host Controller 0b:00.4 Audio device: Advanced Micro Devices, Inc. [AMD] Starship/Matisse HD Audio Controller
NOTE: lspci read through the sysfs entries and decoded the vendor and device numbers using the vendor and device information in /usr/share/hwdata/pci.ids.
lspci uses libpci, which returns the data using the PCI identification data in /usr/share/hwdata/pci.ids.
lspci -n | tail -10
returns:
06:00.3 0c03: 1022:149c 07:00.0 0106: 1022:7901 (rev 51) 08:00.0 0106: 1022:7901 (rev 51) 09:00.0 0300: 10de:1c82 (rev a1) 09:00.1 0403: 10de:0fb9 (rev a1) 0a:00.0 1300: 1022:148a 0b:00.0 1300: 1022:1485 0b:00.1 1080: 1022:1486 0b:00.3 0c03: 1022:149c 0b:00.4 0403: 1022:1487
NOTE: lspci displays the raw PCI identification data.
linux/kernel/pci_devices.1611917238.txt.gz · Last modified: 2021/01/29 10:47 by peter