===============================================================================
MLNX_EN driver for Mellanox Adapter Cards with 10GigE Support
- README for MLNX_OFED 1.4
+ README for MLNX_OFED 1.5
- March 2009
+ December 2009
===============================================================================
Contents:
=========
1. Overview
-2. Software Dependencies
-3. Ethernet Driver Usage and Configuration
-4. Known Issues
-5. Troubleshooting
+2. Ethernet Driver Usage and Configuration
+3. Known Issues
+4. Troubleshooting
1. Overview
The MLNX_EN driver release exposes the following capabilities:
- Single/Dual port
- Fibre Channel over Ethernet (FCoE)
-- Up to 16 Rx queues per port
+- Up to 9 Rx queues per port
- Rx steering mode: Receive Core Affinity (RCA)
- Tx arbitration mode: VLAN user-priority (off by default)
- MSI-X or INTx
- CX4 connectors (XAUI) or XFP
-2. Software Dependencies
-========================
-- The mlx4_en module uses a Linux implementation for Large Receive Offload
- (LRO) in kernel 2.6.24 and later. These kernels require installing the
- "inet_lro" module.
-
-
-3. Ethernet Driver Usage and Configuration
+2. Ethernet Driver Usage and Configuration
==========================================
- To assign an IP address to the interface run:
Example:
#> ethtool -i eth2
driver: mlx4_en (MT_0BD0110004)
- version: 1.4.0 (Dec 2008)
- firmware-version: 2.6.0
+ version: 1.5.0 (Dec 2009)
+ firmware-version: 2.7.0
bus-info: 0000:0e:00.0
- To query stateless offload status run:
- To set pause frame settings run:
#> ethtool -A eth<x> [rx on|off] [tx on|off]
+- To query ring size values run:
+ #> ethtool -g eth<x>
+
+- To modify rings size run:
+ #> ethtool -G eth<x> [rx <N>] [tx <N>]
+
+- To view card's vpd run:
+ #> ethtool -e eth<x>
+
+- To modify card's vpd run:
+ #> ethtool -E eth<x>
+
- To obtain additional device statistics, run:
#> ethtool -S eth<x>
+- To perform a self diagnostics test, run:
+ #> ethtool -t eth<x>
+
The driver defaults to the following parameters:
- Both ports are activated (i.e., a net device is created for each port)
Values of all parameters can be observed in /sys/module/mlx4_en/parameters/.
-4. Known Issues
+3. Known Issues
===============
- For RedHat EL4, adding and removing multiple vlan interfaces over the network
interface created by the mlx4_en driver may lead to printing the following:
- iperf with multiple (> 100) streams may fail on kernel.org 2.6.25 versions
earlier than 2.6.25.9.
-- mlx4_en driver is not supported on PPC64 and IA64
-
-5. Troubleshooting
+4. Troubleshooting
==================
Problem: I restarted the driver and received the following error message:
mlx4_core 0000:13:00.0: PCI device did not come back after reset, aborting.
Open Fabrics Enterprise Distribution (OFED)
- ConnectX driver (mlx4) in OFED 1.5 Release Notes
+ ConnectX driver (mlx4) in OFED 1.5.0 Release Notes
- December 2009
+ Decenber 2009
===============================================================================
5. Infiniband (mlx4_ib) new features and bug fixes since OFED 1.4
6. Eth (mlx4_en) new features and bug fixes since OFED 1.4
7. New features and bug fixes since OFED 1.4.1
-8. Known Issues
-9. mlx4 Available Parameters
+8. New features and bug fixes since OFED 1.5.0
+9. Known Issues
+10. mlx4 Available Parameters
===============================================================================
1. Overview
Handles InfiniBand-specific functions and plugs into the InfiniBand
midlayer
- mlx4_en
- A new 10G driver named mlx4_en was added to drivers/net/mlx4.
- It handles Ethernet specific functions and plugs into the netdev mid-layer.
+ Handles Ethernet specific functions and plugs into the netdev mid-layer.
===============================================================================
2. Supported Firmware Versions
===============================================================================
-- This release was tested with FW 2.6.000.
+- This release was tested with FW 2.7.000.
- The minimal version to use is 2.3.000.
-- To use both IB and Ethernet (VPI) use FW version 2.6.0
+- To use both IB and Ethernet (VPI) use FW version 2.6.000 or higher
===============================================================================
3. VPI (Virtual Protocol Interconnect)
- Added support for new device ID: 0x6764: MT26468 ConnectX EN 10GigE PCIe gen2
===============================================================================
-8. Known Issues
+8. New features and bug fixes since OFED 1.4.2
+===============================================================================
+8.1 Changes and New Features
+----------------------------
+- mlx4_en is now supported on PPC and IA64.
+- Added self diagnostics feature: ethtool -t eth<x>.
+- Card's vpd can be accessed for read and write using ethtool interface.
+
+8.2 Bug Fixes
+-------------
+- mlx4 can now work with MSI-X on RH4 systems.
+- Enabled the driver to load on systems with 32 cores and higher.
+- The driver is being stuck if the HW/FW stops responding, reset is done
+ instead.
+- Fixed recovery flows from memory allocation failures.
+- When the system is low on memory, the mlx4_en driver now allocates smaller RX
+ rings.
+- The mlx4_coredriver now retries to obtain MSI-X vectors if the initial request is
+ rejected by the OS
+
+===============================================================================
+9. Known Issues
===============================================================================
-- mlx4_en driver is not supported on PPC64 and IA64
- The mlx4_en module uses a Linux implementation for Large Receive Offload
(LRO) in kernel 2.6.24 and later. These kernels require installing the
"inet_lro" module.
===============================================================================
-9. mlx4 Available Parameters
+10. mlx4 Available Parameters
===============================================================================
In order to set mlx4 parameters, add the following line(s) to /etc/modpobe.conf:
options mlx4_core parameter=<value>
rss_xor: Use XOR hash function for RSS 0 (default is xor)
rss_mask: RSS hash type bitmask (default is 0xf)
num_lro: Number of LRO sessions per ring or disabled (0) (default is 32)
+ ip_reasm: Allow reassembly of fragmented IP packets (default is enabled)
pfctx: Priority based Flow Control policy on TX[7:0].
Per priority bit mask (default is 0)
pfcrx: Priority based Flow Control policy on RX[7:0].