QA:Testcase biosdevname add-in network interface names

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Expected Results)
m (add autolang to page)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Description ==
+
{{autolang|base=yes}}
  
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>.
+
{{QA/Test_Case
 +
|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=
 +
# Make sure your system is booted into a {{FedoraVersion|long|next}} or [[Releases/Rawhide|Rawhide]] kernel and has at least one add-in network controller plugged into the available PCI slot.
 +
|actions=
 +
<ol>
 +
<li> Identify the add-in network adapters in your system.  Use instructions [[QA:Testcase biosdevname on-board network interface names|here]] to identify the on-board network devices.  Any remaining network devices are add-in network adapters.  Output from the command {{command|lspci}} can help identify add-in adapters. 
  
== Setup ==
+
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:
Make sure your system is booted into Rawhide kernel and has at least one add-in network controller plugged into the available PCI slot.
+
<pre>01:00.0 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
 
+
== Howto Test ==
+
 
+
1. Identify the add-in network adapters in your system. Use instructions from the link 'https://fedoraproject.org/wiki/QA:Testcase_Onboard_Network_Interface_Names' to identify the onboard network devices. The rest are add-in network adapters.
+
 
+
On a PowerEdge with 4 BCM5709 onboard network adapters, 1 82572EI single port adapter, 1  82576 dual port network adapter, 'lspci' listing helps identify add-in adapters.
+
 
+
 
+
* Onboard Network Adapters
+
<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.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)
 
02:00.0 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)</pre>
 
02:00.1 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)</pre>
  
* PCI Add-in Network Adapters
+
While, PCI add-in network adapters would appear as noted below:
 
<pre>06:00.0 Ethernet controller: Intel Corporation 82572EI Gigabit Ethernet Controller (Copper) (rev 06)
 
<pre>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.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
 
07:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)</pre>
 
07:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)</pre>
  
2. Verify that the add-in network adapters are named as per their physical location on the system board.
+
<li> Verify that the add-in network adapters are named as per their physical location on the system board.  The command {{command|ls /sys/class/net/pci*}} can be used to list add-in network adapters.
  
<pre>[root@fedora-14-r710 ~]# ls /sys/class/net/
+
<pre># ls /sys/class/net/
em1  em2  em3  em4  lo  pci3#1 pci3#1_0  pci3#1_1  pci3#2 pci3#2_0  pci3#2_1  pci4#1</pre>
+
lo  pci3#1 pci3#2 pci4#1</pre>
  
 
+
You can further inspect each add-in network adapter using the command {{command|ethtool -i pciN#M}}.  For example, to inspect add-in network adapter on PCI Slot 4 Port 1 (<code>pci4#1</code>) ...
* pci4#1 - add-in network adapter on PCI Slot 4 Port 1
+
<pre># ethtool -i pci4#1
<pre>[root@fedora-14-r710 ~]# ethtool -i pci4#1
+
 
driver: e1000e
 
driver: e1000e
 
version: 1.2.7-k2
 
version: 1.2.7-k2
Line 38: Line 32:
 
bus-info: 0000:06:00.0</pre>
 
bus-info: 0000:06:00.0</pre>
  
* pci3#1 - add-in network adapter on PCI Slot 3 Port 1
+
Alternatively, to inspect add-in network adapter on PCI Slot 3 Port 2 (<code>pci3#2</code>) ...
<pre>[root@fedora-14-r710 ~]# ethtool -i pci3#1
+
<pre># ethtool -i pci3#2
driver: igb
+
version: 2.1.0-k2
+
firmware-version: 1.5-1
+
bus-info: 0000:07:00.0</pre>
+
 
+
* pci3#2 - add-in network adapter on PCI Slot 3 Port 2
+
<pre>[root@fedora-14-r710 ~]# ethtool -i pci3#2
+
 
driver: igb
 
driver: igb
 
version: 2.1.0-k2
 
version: 2.1.0-k2
Line 52: Line 39:
 
bus-info: 0000:07:00.1</pre>
 
bus-info: 0000:07:00.1</pre>
  
== Expected Results ==
+
|results=
All the add-in PCI network interfaces should get named as per their physical location in the system motherboard.
+
# All the add-in PCI network interfaces should get named as per their physical location in the system motherboard. The expected naming format is <code>pciM#N</code> where <code>M</code> is the PCI slot number, and <code>N</code> is the port number on the device.
 +
}}
 +
[[Category:Package biosdevname test cases]]

Latest revision as of 19:59, 21 January 2011


Contents

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 21 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.