From Fedora Project Wiki


Description

This test case verifies that the interface names for adapters on Add-in PCI slots are of the form pci<slot>#<port>_<virtual function instance>.

Setup

  1. Make sure your system is booted into a Fedora 41 or Rawhide kernel and has at least one add-in network controller plugged into the available PCI slot.

How to test

  1. Identify the add-in network adapters in your system. Use instructions here to identify the on-board network devices. Any remaining network devices are add-in network adapters. Output from the command lspci can help identify add-in adapters. For example, on a Dell PowerEdge system with four BCM5709 on-board network adapters, a 82572EI single port adapter and a 82576 dual port network adapter, on-board network adapters would display as follows:
    01:00.0 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
    01:00.1 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
    02:00.0 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
    02:00.1 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)

    While, PCI add-in network adapters would appear as noted below:

    06:00.0 Ethernet controller: Intel Corporation 82572EI Gigabit Ethernet Controller (Copper) (rev 06)
    07:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
    07:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
  2. Verify that the add-in network adapters are named as per their physical location on the system board. The command ls /sys/class/net/pci* can be used to list add-in network adapters.
    # ls /sys/class/net/
    lo  pci3#1 pci3#2 pci4#1

    You can further inspect each add-in network adapter using the command ethtool -i pciN#M. For example, to inspect add-in network adapter on PCI Slot 4 Port 1 (pci4#1) ...

    # ethtool -i pci4#1
    driver: e1000e
    version: 1.2.7-k2
    firmware-version: 5.6-8
    bus-info: 0000:06:00.0

    Alternatively, to inspect add-in network adapter on PCI Slot 3 Port 2 (pci3#2) ...

    # ethtool -i pci3#2
    driver: igb
    version: 2.1.0-k2
    firmware-version: 1.5-1
    bus-info: 0000:07:00.1

    Expected Results

    1. All the add-in PCI network interfaces should get named as per their physical location in the system motherboard. The expected naming format is pciM#N where M is the PCI slot number, and N is the port number on the device.