]> git.openfabrics.org - ~tnikolova/docs/.git/commitdiff
Updated mlx4 readme and RN
authorYevgeny Petrilin <yevgenyp@mellanox.co.il>
Thu, 24 Dec 2009 08:04:48 +0000 (10:04 +0200)
committerVladimir Sokolovsky <vlad@mellanox.co.il>
Thu, 24 Dec 2009 08:04:48 +0000 (10:04 +0200)
Signed-off-by: Yevgeny Petrilin <yevgenyp@mellanox.co.il>
MLNX_EN_README.txt
mlx4_release_notes.txt

index 01d043a8a4705e83f000afe95790888f92464343..bca75861f319f49b9cdb62bac4ba37be900f6270 100644 (file)
@@ -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<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)
@@ -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.
index 707e0336dca1d5094c2ea59616b2ccbc4458e0b6..917edf637af0887dd87e1f6632f1a3790600fefa 100644 (file)
@@ -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<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.
@@ -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=<value>
@@ -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].