QA:Testcase biosdevname on-board network interface names

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

Description

This test case verifies that onboard network interfaces are named emN.

Setup

1. Make sure your system is booted into a Fedora 41 or Rawhide kernel.

How to test

1. Identify the onboard network interfaces in your system using the command lspci | grep -i ethernet

   # lspci | grep -i ether
   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)
   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)
   

   On Dell PowerEdge systems, SMBIOS type 41 record provides additional details on onboard devices. For example, using the command dmidecode -t 41, you can further inspect on-board devices.

   # dmidecode -t 41
   # dmidecode 2.10
   SMBIOS 2.6 present.
   
   Handle 0x2900, DMI type 41, 11 bytes
   Onboard Device
           Reference Designation: Embedded NIC 1
           Type: Ethernet
           Status: Enabled
           Type Instance: 1
           Bus Address: 0000:01:00.0
   
   Handle 0x2901, DMI type 41, 11 bytes
   Onboard Device
           Reference Designation: Embedded NIC 2
           Type: Ethernet
           Status: Enabled
           Type Instance: 2
           Bus Address: 0000:01:00.1
   Handle 0x2902, DMI type 41, 11 bytes
   Onboard Device
           Reference Designation: Embedded NIC 3
           Type: Ethernet
           Status: Enabled
           Type Instance: 3
           Bus Address: 0000:02:00.0
   
   Handle 0x2903, DMI type 41, 11 bytes
   Onboard Device
           Reference Designation: Embedded NIC 4
           Type: Ethernet
           Status: Enabled
           Type Instance: 4
           Bus Address: 0000:02:00.1

   The output from this command tells you that there are 4 onboard network interfaces in this system. Compare the Bus Address field to the lspci output to determine the network adapters.

2. Run the command ls /sys/class/net and make sure that onboard network adapters identified in step 1 are named em1, em2, em3 and em4.
3. Verify that the first on-board network interface has an index 1 and label Embedded NIC 1. The commands cat /sys/class/net/em1/device/index and cat /sys/class/net/em1/device/label can be used to identify the index and label respectively
4. Physically identify the interface by issuing the command ethtool -p em1. This makes the onboard network interaface LED blink.

Expected Results

1. The on-board network inferfaces are named with the prefix em. For example:

   # ls /sys/class/net/
   em1  em2  em3  em4  lo

2. The first onboard network interface, as per SMBIOS type 41 record, should be named em1 in the OS, the second onboard network interface, as per SMBIOS type 41 record, should be named em2 and so on.

   # cat /sys/class/net/em1/device/index
   1
   # cat /sys/class/net/em1/device/label
   Embedded NIC 1 
   
   # cat /sys/class/net/em2/device/index
   2
   # cat /sys/class/net/em2/device/label
   Embedded NIC 2

3. The ethtool -p emN command causes the network interface LED corresponding to the device name to blink. For example, em2 would cause the second on-board network interface device to blink.