QA:Testcase biosdevname add-in network interface names

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Created page with '== Description == == Setup == == Howto Setup == == Expected Results ==')
 
m (add autolang to page)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Description ==
+
{{autolang|base=yes}}
== Setup ==
+
 
== Howto Setup ==
+
{{QA/Test_Case
== Expected Results ==
+
|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. 
 +
 
 +
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:
 +
<pre>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)</pre>
 +
 
 +
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)
 +
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>
 +
 
 +
<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># ls /sys/class/net/
 +
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>) ...
 +
<pre># ethtool -i pci4#1
 +
driver: e1000e
 +
version: 1.2.7-k2
 +
firmware-version: 5.6-8
 +
bus-info: 0000:06:00.0</pre>
 +
 
 +
Alternatively, to inspect add-in network adapter on PCI Slot 3 Port 2 (<code>pci3#2</code>) ...
 +
<pre># ethtool -i pci3#2
 +
driver: igb
 +
version: 2.1.0-k2
 +
firmware-version: 1.5-1
 +
bus-info: 0000:07:00.1</pre>
 +
 
 +
|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


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.