From Fedora Project Wiki
m (add autolang to page)
 
(7 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/
em1  em2  em3  em4  lo  pci3#1  pci3#1_0  pci3#1_1  pci3#2  pci3#2_0  pci3#2_1  pci4#1</pre>


<pre># ls /sys/class/net/
lo  pci3#1 pci3#2 pci4#1</pre>


* pci4#1 - add-in network adapter on PCI Slot 4 Port 1
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>) ...
<pre>[root@fedora-14-r710 ~]# ethtool -i pci4#1
<pre># 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># ethtool -i pci3#2
  pci3#2 - add-in network adapter on PCI Slot 3 Port 2
 
<pre>[root@fedora-14-r710 ~]# ethtool -i pci3#1
driver: igb
version: 2.1.0-k2
firmware-version: 1.5-1
bus-info: 0000:07:00.0
 
[root@fedora-14-r710 ~]# ethtool -i pci3#2
driver: igb
driver: igb
version: 2.1.0-k2
version: 2.1.0-k2
Line 54: 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.  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


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.
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_biosdevname_add-in_network_interface_names&oldid=216554"