QA:Testcase biosdevname on-board network interface names

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Expected Results)
(Updated category and use test case template)
Line 1: Line 1:
== Description ==
+
{{QA/Test_Case
 +
|description=This test case verifies that onboard network interfaces are named emN.
 +
|setup=
 +
# Make sure your system is booted into a {{FedoraVersion|long|next}} or [[Releases/Rawhide|Rawhide]] kernel.
 +
|actions=
 +
<ol>
 +
<li> Identify the onboard network interfaces in your system using the command {{command|lspci {{!}} grep -i ethernet}}
  
This test case verifies that onboard network interfaces are named emN.
+
<pre># lspci | grep -i ether
 
+
== Setup ==
+
 
+
Make sure your system is booted into Rawhide kernel.
+
 
+
== Howto Test ==
+
 
+
1. Identify the onboard network interfaces in your system.
+
 
+
<pre>[root@fedora-14-r710 ~]# lspci | grep -i ether
+
 
01:00.0 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
 
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)
 
01:00.1 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
Line 21: Line 17:
 
</pre>
 
</pre>
  
On Dell PowerEdge systems SMBIOS type 41 record provides details on onboard devices.  
+
On Dell PowerEdge systems, SMBIOS type 41 record provides additional details on onboard devices.  For example, using the command {{command|dmidecode -t 41}}, you can further inspect on-board devices.
  
<pre>[root@fedora-14-r710 ~]# dmidecode -t 41
+
<pre># dmidecode -t 41
 
# dmidecode 2.10
 
# dmidecode 2.10
 
SMBIOS 2.6 present.
 
SMBIOS 2.6 present.
Line 58: Line 54:
 
         Bus Address: 0000:02:00.1</pre>
 
         Bus Address: 0000:02:00.1</pre>
  
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.  
+
The output from this command tells you that there are 4 onboard network interfaces in this system. Compare the <code>Bus Address</code> field to the {{command|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.
+
<li> Run the command {{command|ls /sys/class/net}} and make sure that onboard network adapters identified in step 1 are named <code>em1</code>, <code>em2</code>, <code>em3</code> and <code>em4</code>.
  
<pre>[root@fedora-14-r710 ~]# ls /sys/class/net/
+
<li> Verify that the first on-board network interface has an index <code>1</code> and label <code>Embedded NIC 1</code>.  The commands {{command|cat /sys/class/net/em1/device/index}} and {{command|cat /sys/class/net/em1/device/label}} can be used to identify the index and label respectively
em1 em2  em3  em4  lo
+
  
3. Verify that the first onboard network interface has an index 1 and label "Embedded NIC 1"
+
<li> Physically identify the interface by issuing the command {{command|ethtool -p em1}}. This makes the onboard network interaface LED blink.
 +
</ol>
  
<pre>[root@fedora-14-r710 ~]# cat /sys/class/net/em1/device/index
+
|results=
 +
<ol>
 +
<li> The on-board network inferfaces are named with the prefix <code>em</code>.  For example:
 +
<pre># ls /sys/class/net/
 +
em1  em2  em3  em4  lo</pre>
 +
<li> The first onboard network interface, as per SMBIOS type 41 record, should be named <code>em1</code> in the OS, the second onboard network interface, as per SMBIOS type 41 record, should be named <code>em2</code> and so on.
 +
<pre># cat /sys/class/net/em1/device/index
 
1
 
1
[root@fedora-14-r710 ~]# cat /sys/class/net/em1/device/label
+
# cat /sys/class/net/em1/device/label
 
Embedded NIC 1  
 
Embedded NIC 1  
  
[root@fedora-14-r710 ~]# cat /sys/class/net/em2/device/index
+
# cat /sys/class/net/em2/device/index
 
2
 
2
[root@fedora-14-r710 ~]# cat /sys/class/net/em2/device/label
+
# cat /sys/class/net/em2/device/label
 
Embedded NIC 2</pre>
 
Embedded NIC 2</pre>
 +
<li> The {{command|ethtool -p emN}} command causes the network interface LED corresponding to the device name to blink.  For example, <code>em2</code> would cause the second on-board network interface device to blink.
 +
</ol>
 +
}}
  
4. Physically identify the interface by issuing the command 'ethtool -p em1'. This makes the onboard network interaface LED blink.
+
[[Category:Package biosdevname test cases]]
 
+
<pre>[root@fedora-14-r710 ~]# ethtool -p em1</pre>
+
 
+
== Expected Results ==
+
 
+
The {{filename|first onboard network interface}} as per SMBIOS type 41 record should be named {{filename|em1}} in the OS, the {{filename| second onboard network interface}} as per SMBIOS type 41 record should be named {{filename|em2}} and so on.
+

Revision as of 19:17, 19 January 2011

Contents

Description

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

Setup

  1. Make sure your system is booted into a Fedora 21 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.