QA:Testcase biosdevname add-in network interface names

In other languages: English (en) русский (ru) [edit]

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.