From d52de4755143ee2ff19148e91c002bb30c475435 Mon Sep 17 00:00:00 2001 From: Yevgeny Petrilin Date: Thu, 24 Dec 2009 10:04:48 +0200 Subject: [PATCH] Updated mlx4 readme and RN Signed-off-by: Yevgeny Petrilin --- MLNX_EN_README.txt | 47 +++++++++++++++++++++++------------------- mlx4_release_notes.txt | 43 ++++++++++++++++++++++++++++---------- 2 files changed, 58 insertions(+), 32 deletions(-) diff --git a/MLNX_EN_README.txt b/MLNX_EN_README.txt index 01d043a..bca7586 100644 --- a/MLNX_EN_README.txt +++ b/MLNX_EN_README.txt @@ -1,17 +1,16 @@ =============================================================================== 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 @@ -21,7 +20,7 @@ MLNX_EN driver is composed from mlx4_core and mlx4_en kernel modules. 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 @@ -40,14 +39,7 @@ The MLNX_EN driver release exposes the following capabilities: - 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: @@ -61,8 +53,8 @@ The MLNX_EN driver release exposes the following capabilities: 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: @@ -91,9 +83,24 @@ The MLNX_EN driver release exposes the following capabilities: - To set pause frame settings run: #> ethtool -A eth [rx on|off] [tx on|off] +- To query ring size values run: + #> ethtool -g eth + +- To modify rings size run: + #> ethtool -G eth [rx ] [tx ] + +- To view card's vpd run: + #> ethtool -e eth + +- To modify card's vpd run: + #> ethtool -E eth + - To obtain additional device statistics, run: #> ethtool -S eth +- To perform a self diagnostics test, run: + #> ethtool -t eth + The driver defaults to the following parameters: - Both ports are activated (i.e., a net device is created for each port) @@ -112,7 +119,7 @@ added to /etc/modprobe.conf file: 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: @@ -121,9 +128,7 @@ Values of all parameters can be observed in /sys/module/mlx4_en/parameters/. - 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. diff --git a/mlx4_release_notes.txt b/mlx4_release_notes.txt index 707e033..917edf6 100644 --- a/mlx4_release_notes.txt +++ b/mlx4_release_notes.txt @@ -1,7 +1,7 @@ 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 =============================================================================== @@ -14,8 +14,9 @@ Table of Contents 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 @@ -35,15 +36,14 @@ configurations, the driver is split into three modules: 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) @@ -182,9 +182,29 @@ Bug Fixes - 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. +- 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. @@ -220,7 +240,7 @@ Bug Fixes =============================================================================== -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= @@ -257,6 +277,7 @@ mlx4_en parameters: 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]. -- 2.41.0