Release Notes Change Log History

Feature/Change

Description

5.4-1.0.3.0

ASAP2

Enlarge Switchdev Tables

[ConnectX-5 and above] Added support for allowing OVS kernel to support up to 128 matches (groups) per table and 16M entries per group.

Offloading Extended ct_state Flags

[ConnectX-5 and above] Added support to offload ct_state flags rpl, inv, and rel.

  • For rpl, support was added for both set and not set matching offload (i.e., +rpl and -rpl).

  • For inv and rel, support was added only for the not set option (i.e., -rel and -inv).

Core

Scalable Functions (Subfunctions)

[ConnectX-5 and above] Added support for scalable functions (also called subfunctions). The feature enables the user to create, configure, and deploy a scalable functions (e.g., RDMA and networking applications) and to assign them to a container when a container is started via mlxdevm tool.

A scalable function can also be deployed in an untrusted guest/host system from the NIC/DPU. This enables full configuration of the function and its representors from the NIC/DPU before giving the function for a container to run in a host system.

For more information, see https://github.com/Mellanox/scalablefunctions/wiki/MLNX_OFED-step-by-step-guide.

Scalable Function QoS

[ConnectX-5 and above] Added support for scalable function QoS and QoS group via mlxdevm's rate commands. Run "man mlxdevm port" for details.

Auxiliary Bus in mlx5 Driver

[ConnectX-4] Updated mlx5 driver to use auxiliary bus in order to integrate different driver components into driver core and optimize module load/unload sequences.

Installation

Script Removal from mlnx-ofa_kernel

[General] Moved all Python scripts and some other common scripts out of the mlnx-ofa_kernel packages. This removed the python dependency from that package when rebuilding it and avoided unnecessary errors when rebuilding them for custom kernels.

Netdev

What-Just-Happened (WJH) in NICs

[ConnectX-4] Added support for WJH in NICs. WJH allows for visibility of dropped packets (i.e., receiving notice of drop counters increase, seeing content of the dropped packets, debugging, and more).
WJH is a service in devlink context and it is already implemented in the switch.
Note: processing dropped packets (even for visibility purposes) may cause a degradation in performance and leaves the driver vulnerable for malicious attacks. The feature is disabled by default.

Supported traps:

  • VLAN mismatch: existing generic trap DEVLINK_TRAP_GENERIC_ID_DMAC_MISMATCH
    Traps received packets with wrong VLAN tag

  • DMAC mismatch: new generic trap DEVLINK_TRAP_GENERIC_ID_DMAC_MISMATCH
    Traps received packets with wrong destination MAC

Support added in user-space (N/A or package name + version): Devlink infrastructure (man7.org/linux/man-pages/man8/devlink-trap.8.html)

Devlink provides an infrastructure called devlink trap which allow a device to register/unregister and to enable/disable traps. Devlink traps also provide traps grouping and policing. The trapped packets are monitored and then forward to the drop monitor. Drop monitor is used to send notifications to user space about dropped packets.Note: For this release, NIC WJH will not implement the policy.

ethtool Extended Link State

[General] Added ethtool extended link state to mlx5e.
ethtool can be used to get more information to help troubleshoot the state.
For example, if there is no link due to missing cable, run the following:
$ ethtool eth1
...
Link detected: no (No cable)

Besides the general extended state, drivers can pass additional information about the link state using the sub-state field.
Example:
$ ethtool eth1
...
Link detected: no (Autoneg, No partner detected)

The extended state is available only for some cases of no link. In other cases, ethtool will print only "Link detected: no" as it did before.

RDMA

DV "Signature API"

[ConnectX-5 and above] Added support for "Signature API" which, on supported devices, allows application-level data-integrity checks via a signature handover mechanism. Various signature types, including CRC32 and T10-DIF, can be automatically calculated and checked, stripped, or appended during the transfer at full wire speed.

ibv_query_qp_data_in_order() verb

[General] Added support for ibv_query_qp_data_in_order() API. This API enables an application to check if the given QP data is guaranteed to be in order, enabling poll for data instead of poll for completion.

Relaxed Ordering for Kernel ULPs

[ConnectX-4] Added support for enabling Relaxed Ordering for Kernel ULPs. Using relaxed ordering can improve performance in some setups. Since kernel ULPs are expected to support RO, it is enabled for them by default so they can benefit from it.

ah_to_qp Mapping

[ConnectX-6 Dx] Added support for mapping a QP to AH over DEVX API, which enables DC/UD QPs to use multiple CC algorithms in the same data center.

Steering UserSpace

Matching on RAW Tunnel Headers

[ConnectX-5 and above] Added DR support for matching on RAW tunnel headers using the misc5 parameters, This feature allows matching on each bit of the header, inducing reserved fields.

Software Steering Insertion Rate Optimizations

[ConnectX-6 Dx] Added support for better insertion rate in software steering. This includes multi-QP which skips areas in the code that may be for debug only.

Software Steering Rule Optimization

[ConnectX-6 Dx] Improved rate of updating steering rules, insertion, and deletion. The feature includes definers, multi-qp approach, and better memory usage.

Duplicate Rules Insertion

[ConnectX-5 and above] Added support for ability to allow or prevent insertion of duplicate rules, so the user can choose one of the following behaviors:
1. Prevent duplicate rules, so that already-existing rule and fail can be detected.
2. Allow duplicate rules, to enable updating the rule's action (this will only take effect once the previous rule is deleted).

By default, duplicate rules are allowed.

Improved Software Steering Rule Creation Stability

[ConnectX-6 Dx] Made it so that all rule's insertion occur in a defined time using defined (export) size of Htble and decreased use of dynamic allocation.

Feature/Change

Description

5.3-1.0.0.1

Supported NICs: ConnectX-5 and above

MLX5DR SF

Added support for up to 512 SFs with the mlx5dv_dr API.

Supported NICs: ConnectX-5 & ConnectX-6 Dx

Dump Single Flow

Added support to dump single flow/rule with flow-id.

Supported NICs: ConnectX-5* & ConnectX-6 Dx/ BlueField* & BlueField 2

Local/Remote Mirroring

OVS-DPDK added support for local and remote mirroring for offloaded traffic.

*Enabling the port mirroring feature on a ConnectX-5 NIC and BlueField will break Connection Tracking.

Supported NICs: BlueField-2

Connection Tracking Replay State

Added support for matching on CT state replay.

Kernel TLS Offload

Added support for TX and RX kTLS offloads on the ARM in switchdev mode via a sub-function.

Supported NICs: ConnectX-6 Dx & BlueField-2

Increased Number of Virtio Functions

Added support for up to 504 Virtio functions. 512 total functions are supported, but some are consumed by PF, Host PF, and RSHIM.

Supported NICs: ConnectX-6 Dx

VF Metering

Added support for RX/TX metering per VF using sysfs API.

PTP Hardware Translation Offload

Added support for the hardware clock device to be adjusted and provide timestamps which are translated into real-time nanoseconds. This can be used by the driver for PTP protocol.

For further information, see PTP Cyc2time Hardware Translation Offload section.

TLS Rx Hardware Offload

Added GA-level support for hardware offload decryption of TLS Rx traffic over crypto-enabled ConnectX-6 Dx NICs and above.

MLX5DR Match Definer

Added support for match definers which are used internally in the mlx5dv_dr API. Definers allow filtering on more packet fields, improving the packet rate and accelerates mlx5dv_dr API.

MLX5DR Packet OK and Checksum Checks

Added support for new matching fields ipv4_checksum_ok and l4_checksum_ok. l3_ok, l4_ok.

Pop VLAN on VF/SF Tx Direction

Added support to pop VLAN on VF/SF Tx direction.

Connection Tracking Window Validation

Added support for ASO connection tracking of action creation and modification. This action allows performing TCP connection tracking using hardware offloads.
Using this offload, the validity of the connection state of the incoming or outgoing packets on this TCP connection can be examined.
Also added the ability for an ASO CT action created on one GVMI to be used on different GVMI.

Supported NICs: All

Pyverbs

Pyverbs are no longer being built for Debian 9.

Bug Fixes

See Bug Fixes in This Version section.

Category

Description

5.2-2.2.0.0

Supported NICs: ConnectX-5 and above

DCT Support for Connection Establishment with RDMA_CM

[Alpha level] Added support for the dv APIs to allocate/deallocate a unique QP number that can be used as DC QPN in RDMA_CM connection establishment.

Supported NICs: All

MXM

The MXM package is deprecated and removed from MLNX_OFED.

Devlink Firmware Reset

In MLNX_OFED v5.2-1.0.4.0, it was noted that MLNX_OFED did not include the latest iproute2 that provided support for this feature, and that the latest iproute2 must be installed from Github (see Release Notes Change Log History section). This note is no longer relevant.

Bug Fixes

See Bug Fixes in This Version section.

5.2-1.0.4.0

Supported NICs: ConnectX-5 and above

Rx Multi-strides CQE Compression

Added CQE compression support for Rx multi-strides packets.

Multi-application QoS

Added support for configuring QoS on a single QP or on a group of QPs.

MPLS-over-UDP Hardware Offload Support

Added support for encap/decap hardware offload of IPv4 traffic over MPLS-over-UDP. This can be used in networks with MPLS routers to achieve more efficient routing.

Connection Tracking with Hairpin

Added support for adding connection tracking rules on VFs to forward traffic from one VF to the other.

sFlow Sampling Rules Offload

Added support for offloading sFlow sampling rules.
sFlow is an industry standard technology for monitoring high speed switched networks.Open vSwitch integrated sFlow to extend the visibility into virtual servers, ensuring data center visibility and control. Added support for offloading sFlow sampling rules.

Supported NICs: BlueField/BlueField-2, ConnectX-5 & ConnectX-6 Dx

mlx5dv_dr Software Steering Parallel Rules Insertion

Added support for a locking mechanism to enable parallel insertion of rules into the software steering using the mlx5dv_dr API. The parallel insertion improves the insertion rate and takes place when adding Rx and Tx rules via the FDB domain.

mlx5dv_dr API Matching on Geneve Tunnel

Added support for the option to match mlx5dv_dr API on Geneve tunnel using a dynamic flex parser. The option header consists of class, type, length and data. The parser should be configured using devx command, after which a rule can be created to match on parser ID and data.

OVS-DPDK Geneve Encap/Decap

Added support for Geneve tunneling offload, including matching on extension header.

OVS-DPDK Parallel Offloads

Added support for parallel insertion and deletion of offloaded rules using multiple OVS threads.

Supported NICs: BlueField-2 & ConnectX-6 Dx

GTP-U TEID Modification

[Beta] Added support to modify GTP-U TEID. This support requires flex parser configuration.

OVS-DPDK E2E Cache Support

[Beta] Improved performance of OVS Connection Tracking flows by enabling the merge of the multi-table flow matches and actions into one joint flow.

Supported NICs: ConnectX-6 Dx and above

Tx Port Time-Stamping

Transmitted packet timestamping accuracy can be improved when using a timestamp generated at the port level instead of a timestamp generated upon CQE creation. Tx port time-stamping better reflects the actual time of a packet's transmission.

This feature is disabled by default. The feature can be enabled or disabled using the following command.

ethtool --set-priv-flags <ifs-name> tx_port_ts on / off

For further information on this feature, please see Tx Port Time-Stamping.

Tunnel Rules Offload

Added support for offloading tunnel rules when the source interface is VF (in addition to uplink) in the Hypervisor.

Added support for offloading tunnel rules when the source interface is OpenvSwitch bridge (internal port).

Connection Tracking Mirroring Offload

Added support for using Mirroring Offload with Connection Tracking.

mlx5dv_dr API ASO Flow Meter

Added support for ASO flow meter using the mlx5dv_dr API, which allows for monitoring the packet rate for specific flows. When a packet hits a flow that is connected to a flow meter, the rate of packets through this meter is evaluated, and the packet is marked with a color copied into one of the C registers, according to the current rate compared to the reference rate.

mlx5dv_dr API ASO First Hit

Added support for ASO first hit using the mlx5dv_dr API, which allows for tracking rule hits by packets. When a packet hits a rule with the ASO first hit action, a flag is set indicating this event, and the original value of the flag is copied to one of the C registers.

mlx5dv_dr API GTP-U Extension Header

Added mlx5dv_dr API support for matching on a new field "gtpu_first_ext_dw_0". This field enables packet filtering based on the GTP-U first extension header (first dword only). To enable parsing of tunnel GTP-U extension header, run the following command.

./cloud_fw_reset.py FLEX_PARSER_PROFILE_ENABLE=3

Supported NICs: ConnectX-6 Lx and above

IPsec Offload

Added IPsec full offload support for extended sequence number, replay protection window and lifetime packet limit.

Supported NICs: All

Firmware Upgrade

Firmware upgrade during MLNX_OFED installation is now done on all supported devices simultaneously rather than consecutively.

RDMA-CM Disassociate Support

Added support for connecting kernel and RDMA-CM in a reliable way based on device index.

New Query GID API

Added support for a new query GID API that allows for querying a single GID entry by its port and GID index, or querying for all GID tables of a specific device. This API works over ioctl instead of sysfs, which accelerates the querying process.

Multi-Host Firmware Reset

Added support for performing multi-host firmware reset in order to upgrade the device firmware.

Firmware reset loads the new firmware in case it was burnt on the flash and was pending activation, and reloads the current firmware image from the flash in case no new firmware was pending.

Firmware Live Patching

[Alpha] Added support for firmware live patching in the driver. Live patching updates the firmware without the need to perform firmware reset. However, it can only be applied in scenarios where the difference between the current and new firmware versions are minor, which is decided upon by the firmware itself.

Devlink Firmware Reset

Added support in the devlink tool for performing firmware reset in order to upgrade the device firmware.

Firmware reset loads the new firmware in case it was burnt on the flash and was pending activation, and reloads the current firmware image from the flash in case no new firmware was pending.

For further information, please refer to the the devlink man page.

Note: In order for the firmware reset to run successfully, the following conditions should be met.

  • Each function should have the driver up and active with a version that supports this feature

  • None of the functions has the devlink parameter enable_remote_dev_reset set to False.

Warning

The current MLNX_OFED does not include the latest iproute2 version that provides support for this feature. Therefore, to be able to work with it, make sure to install the latest iproute2 version available on Github.

Command Interface Resiliency

Added a resiliency mechanism for the driver to manually poll the command event queue (EQ) in case of a command timeout. In case the resiliency mechanism finds unhandled event queue entry (EQE) due to a lost interrupt, the driver will handle it, after which the command interface returns to a healthy state.

Offloaded Traffic Sniffer

Setting a sniffer private flag is deprecated and no longer required. In order to capture offloaded/RoCE traffic, tcpdump can now be run on the RDMA device.

Devlink Port Health Reporters

Added per-port reporters to devlink health to manage per-port health activities. Users can now access the devlink port reporters by specifying the port index in addition to the device devlink name through the devlink health commands API. This update was first introduced in iproute2 v5.8. As part of this feature, mlx5e Tx and Rx reporters are now redefined as devlink port reporters. For examples, please see devlink-health manpage.

Memory Registration Optimization

Optimized memory consumption of memory registration in huge page systems. As an example, in a 2MB huge page system, 600 MB would be saved for 100 GB memory registration.

mlx5dv API

Added support for mlx5dv API to modify the configured UDP source port for RoCE packets of a given RC/UC QP when QP is in RTS state.

Enhanced Tx Multi-packet WQE (MPWQE)

Added support for accelerating Tx datapath by saving PCI bandwidth and CPU utilization. The savings are achieved by aggregating multiple packets into a single WQE. The feature is driven by xmit_more for certain traffic types, such as UDP.

Innova IPsec

Innova IPsec NIC Support

Removed support for the network adapter Innova IPsec (EN).

Supported NICs: All

Bug Fixes

See Bug Fixes in This Version section.

Category

Description

5.1-0.6.6.0

Adapters: ConnectX-4 and above

IP-in-IP RSS Offload

Added support for receive side scaling (RSS) offload in IP-in-IP (IPv4 and IPv6).

Devlink Port Support in Non-representor Mode

Added support for viewing the mlx5e physical devlink ports using the 'devlink port' command. This also may affect network interface names, if predictable naming scheme is configured. Suffix indicating a port number will be added to interface name.

Devlink Health State Notifications

Added support for receiving notifications on devlink health state changes when an error is reported or recovered by one of the reporters. These notifications can be seen using the userspace ‘devlink monitor’ command.

Legacy SR-IOV VF LAG Load Balancing

When VF LAG is in use, round-robin the Tx affinity of channels among the different ports, if supported by the firmware, enables all SQs of a channel to share the same port affinity. This allows the distribution of traffic sent from a VF between two ports, as well as round-robin the starting port among VFs to distribute traffic originating from single-core VMs.

RDMA-CM DevX Support

Added support for DevX in RDMA-CM applications.

RoCEv2 Flow Label and UDP Source Port Definition

This feature provides flow label and UDP source port definition in RoCE v2. Those fields are used to create entropy for network routes (ECMP), load balancers and 802.3ad link aggregation switching that are not aware of RoCE headers.

RDMA Tx Steering

Enabled RDMA Tx steering flow table. Rules in this flow table will allow for steering transmitted RDMA traffic.

Custom Parent-Domain Allocators for CQ

Enabled specific custom allocations for CQs.

mlx5dv Helper APIs for Tx Affinity Port Selection

Added support for the following mlx5dv helper APIs which enable the user application to query or set a RAW QP's Tx affinity port number in a LAG configuration.

  • mlx5dv_query_qp_lag_port

  • mlx5dv_modify_qp_lag_port

RDMA-CM Path Alignment

Added support for RoCE network path alignment between RDMA-CM message and QP data. The drivers and network components in RoCE calculate the same hash results for egress port selection both on the NICs and the switches.

IPoIB QP Number Creation

Enabled setting the QP number of an IPoIB PKey interface in Enhanced mode. This is done using the standard ip link add command while padding the hardware address of the newly created interface. The QP number is the 2nd-4th bytes. To enable the feature, the MKEY_BY_NAME configuration should firstly be enabled in the NvConfig.

CQ and QP Context Exposure

Exposed QP, CQ and MR context in raw format via RDMA tool.

In-Driver xmit_more

Enabled xmit_more feature by default in kernels that lack Rx bulking support (v4.19 and above) to ensure optimized IP forwarding performance when stress from Rx to Tx flow is insufficient.

In kernels with Rx bulking support, xmit_more is disabled in the driver by default, but can be enabled to achieve enhanced IP forwarding performance.

Relaxed Ordering

Relaxed ordering is a PCIe feature which allows flexibility in the transaction order over the PCIe. This reduces the number of retransmissions on the lane, and increases performance up to 4 times.

By default, mlx5e buffers are created with Relaxed Ordering support when firmware capabilities are on and the PCI subsystem reports that CPU is not on the kernel's blocklist.

Note: Some CPUs which are not listed in the kernel's blocklist may suffer from buggy implementation of relaxed ordering, in which case the user may experience a degradation in performance and even unexpected behavior. To turn off relaxed ordering and restore previous behavior, run setpci command as instructed here. Example:

"RlxdOrd-“ : setpci -s82:00.0 CAP_EXP+8.w=294e

ODP Huge Pages Support

Enabled ODP Memory Region (MR) to work with huge pages by exposing IBV_ACCESS_HUGETLB access flag to indicate that the MR range is mapped by huge pages.

The flag is applicable only in conjunction with IBV_ACCESS_ON_DEMAND.

Offloaded Traffic Sniffer

Removed support for Offloaded Traffic Sniffer feature and replaced its function with Upstream solution tcpdump tool.

Adapters: ConnectX-5 and above

Connection Tracking Offload

Added support for offloading TC filters containing connection tracking matches and actions.

Dual-Port RoCE Support

Enabled simultaneous operation of dual-port RoCE and Ethernet in SwitchDev mode.

IP-in-IP Tunnel Offload for Checksum and TSO

Added support for the driver to offload checksum and TSO in IP-in-IP tunnels.

Packet Pacing DevX Support

Enabled RiverMax to work over DevX with packet pacing functionality by exposing a few DV APIs from rdma-core to enable allocating/destroying a packet pacing index. For further details on usage, see man page for: mlx5dv_pp_alloc() and mlx5dv_pp_free().

Software Steering Support for Memory Reclaiming

Added support for reclaiming device memory to the system when it is not in use. This feature is disabled by default and can be enabled using the command mlx5dv_dr_domain_set_reclaim_device_memory().

SR-IOV Live Migration

[Beta] Added support for performing a live migration for a VM with an SR-IOV NIC VF attached to it and with minimal to no traffic disruption. This feature is supported in SwitchDev mode; enabling users to fully leverage VF TC/OVS offloads, where the failover inbox driver is in the Guest VM, and the bonding driver is in the Hypervisor.

Note that you must use the latest QEMU and libvirt from the Upstream github.com sources.

Uplink Representor Modes

Removed support for new_netdev mode in SwitchDev mode. The new default behaviour is to always keep the NIC netdev.

OVS-DPDK Offload Statistics

Added support for dumping connection tracking offloaded statistics.

OVS-DPDK Connection Tracking Labels Exact Matching

Added support for labels exact matching in OVS-DPDK CT openflow rules.

Adapters: ConnectX-5 & ConnectX-6 Dx

OVS-DPDK LAG Support

Added support for LAG (modes 1,2,4) with OVS-DPDK.

Adapters: ConnectX-6 and above

Get FEC Status on PAM4/50G

Allowed configuration of Reed Solomon and Low Latency Reed Solomon over PAM4 link modes.

RDMA-CM Enhanced Connection Establishment (ECE)

Added support for allowing automatic enabling/disabling of vendor specific features during connection establishment between network nodes, which is performed over RDMA-CM messaging interface.

RoCE Selective Repeat

This feature introduces a new QP retransmission mode in RoCE in which dropped packet recovery is done by re-sending the packet instead of re-sending the PSN window only (Go-Back-N protocol). This feature is enabled by default when RDMA-CM is being used and both connection nodes support it.

Adapters: ConnectX-6 Dx & BlueField-2

IPsec Full Offload

[Beta] Added support for IPsec full offload (VxLAN over ESP transport).

Hardware vDPA on OVS-DPDK

Added support for configuring hardware vDPA on OVS-DPDK. This support includes the option to fall back to Software vDPA in case the NIC installed on the driver does not support hardware vDPA.

Adapters: ConnectX-6 Dx

IPsec Crypto Offloads

Support for IPsec Crypto Offloads feature over ConnectX-6 Dx devices and up is now at GA level.

TLS Tx Hardware Offload

Support for TLS Tx Hardware Offload feature over ConnectX-6 Dx devices and up is now at GA level.

TLS Rx Hardware Offload

[Alpha] Added support for hardware offload decryption of TLS Rx traffic over crypto-enabled ConnectX-6 Dx NICs and above.

Userspace Software Steering ConnectX-6 Dx Support

Support for software steering on ConnectX-6 Dx adapter cards in the user-space RDMA-Core library through the mlx5dv_dr API is now at GA level.

Kernel Software Steering ConnectX-6 Dx Support

[Beta] Added support for kernel software steering on ConnectX-6 Dx adapter cards.

Adapters: ConnectX-6 Lx

Adapters

Added support for ConnectX-6 Lx adapter cards.

Adapters: All

RDMA-Core Migration

As of MLNX_OFED v5.1, Legacy verbs libraries have been fully replaced by RDMA-Core library.

For the list of new APIs used for various MLNX_OFED features, please refer to the Migration to RDMA-Core document.

Firmware Reactivation

Added support for safely inserting consecutive firmware images without the need to reset the NIC in between.

UCX-CUDA Support

UCX-CUDA is now supported on the following OSs and platforms.

OS

Platform

RedHat 7.6 ALT

PPC64LE

RedHat 7.7

x86_64

RedHat 7.8

PPC64LE/x86_64

RedHat 7.9

x86_64

RedHat 8.1

x86_64

RedHat 8.2

x86_64

HCOLL-CUDA

The hcoll package includes a CUDA plugin (hmca_gpu_cuda.so). As of MLNX_OFED v5.1, it is built on various platforms as the package hcoll-cuda. It will be installed by default if the system has CUDA 10-2 installed.

Notes:

  • If you install MLNX_OFED from a package repository, you will need to install the package hcoll-cuda explicitly to be able to use it.

  • HCOLL-CUDA is supported on the same OSs that include support for UCX-CUDA (listed in the table above), except for RedHat 8.1 and 8.2.

GPUDirect Storage (GDS)

[Beta] Added support for the new technology of GDS (GPUDirect Storage) which enables a direct data path between local or remote storage, such as NFS, NVMe or NVMe over Fabric (NVMe-oF), and GPU memory. Both GPUDirect RDMA and GPUDirect Storage avoid extra copies through a bounce buffer in the CPU's memory. They enable the direct memory access (DMA) engine near the NIC or storage to move data on a direct path into or out of GPU memory, without burdening the CPU or GPU.

To enable the feature, run ./mlnxofedinstall --with-nfsrdma –-with-nvmf --enable-gds --add-kernel-support

To get access to GDS Beta, please reach out to the GDS team at GPUDirectStorageExt@nvidia.com.

For the list of operating systems on which GDS is supported, see here.

Category

Description

5.0-2.1.8.0

Adapters: ConnectX-5 and above

Kernel Software Managed Flow Steering (SMFS) Performance

Improved the performance of Kernel software steering by reducing its memory consumption.

Adapters: All

NEO-Host SDK

Added support for NEO-Host SDK installation on MLNX_OFED.

Bug Fixes

See Bug Fixes in This Version.

5.0-1.0.0.0

Adapters: ConnectX-6 Dx

Adapters

Added support for ConnectX-6 Dx adapter cards.

Userspace Software Steering ConnectX-6 Dx Support

[Beta] Added support for software steering on ConnectX-6 Dx adapter cards in the user-space RDMA-Core library through the mlx5dv_dr API.

Adapters: ConnectX-6 Dx and above

Virtual Output Queuing (VoQ) Counters

Exposed rx_prio[p]_buf_discard, rx_prio[p]_wred_discard and rx_prio[p]_marked firmware counters that count the number of packets that were dropped due to insufficient resources.

IPsec Crypto Offloads

[Beta] IPsec crypto offloads are now supported on ConnectX-6 Dx devices and up. The offload functions use the existing ip xfrm tool to activate offloads on the device. It supports transport/tunnel mode with AES-GCM IPsec scheme.

TLS TX Hardware Offload

[Alpha] Added support for hardware offload encryption of TLS traffic.

VirtIO Acceleration through Datapath I/O Processor (vDPA)

Added support to enable mapping the VirtIO access region (VAR) to be used for doorbells by vDPA applications. Specifically, the following DV APIs were introduced (see man page for more details):

  • mlx5dv_alloc_var()

  • mlx5dv_free_var()

Adapters: ConnectX-5 and above

Resource Allocation on External Memory

Added support to enable overriding mlx5 internal allocations in order to let applications allocate some resources on external memory, such as that of the GPU.

The above is achieved by extending the parent domain object with custom allocation callbacks. Currently supported verbs objects are: QP, DBR, RWQ, SRQ.

Hardware Clock Exposure

Added support for querying the adapter clock via mlx5dv_query_device.

ODP Diagnostic Counters

Added ODP diagnostics counters for the following items per MR (memory region) within IB/mlx5 driver:

  1. Page faults: Total number of faulted pages.

  2. Page invalidations: Total number of pages invalidated by the OS during all invalidation events. The translations can no longer be valid due to either non-present pages or mapping changes.

  3. Prefetched pages: When prefetching a page, a page fault is generated in order to bring the page to the main memory.

Devlink Health CR-Space Dump

Added the option to dump configuration space via the devlink tool in order to improve debug capabilities.

Multi-packet TX WQE Support for XDP Transmit Flows

The conventional TX descriptor (WQE or Work Queue Element) describes a single packet for transmission. Added driver support for the HW feature of multi-packet TX WQEs in XDP transmit flows. With this, the HW becomes capable of working with a new and improved WQE layout that describes several packets. In effect, this feature saves PCI bandwidth and transactions, and improves transmit packet rate.

OVS-Kernel ToS Rewrite

Added support for Type of Service (ToS) rewrite in the OVS-Kernel.

OVS-Kernel Mirroring

Added support for mirroring output in SwitchDev mode in the OVS-Kernel. The mirroring port may either be a local or a remote VF, using VxLAN or GRE encapsulations.

GENEVE Encap/Decap Rules Offload

Added support for GENEVE encapsulation/decapsulation rules offload.

GPRS Tunneling Protocol (GTP) Header

[Beta] Added support for matching (filtering) GTP header-based packets using mlx5dv_dr API over user-space RDMA-Core library.

Multi Packet Tx WQE Support for XDP Transmit Flows

Added driver support for the hardware feature of multi-packet Tx to work with a new and improved WQE layout that describes several packets instead of a single packet for XDP transmission flows. This saves PCI bandwidth and transactions, and improves transmit packet rate.

Userspace Software Steering Debugging API

[Beta] Added support for software steering to dump flows for debugging purposes in the user-space RDMA-Core library through the mlx5dv_dr API.

Kernel Software Steering for Connection Tracking (CT)

[Beta] Added support for updating CT rules using the software steering mechanism.

Kernel Software Steering Remote Mirroring

[Beta] Added support for updating remote mirroring rules using the software steering mechanism.

Adapters: ConnectX-5 and BlueField

OVS-DPDK Support

Added OVS-DPDK component as part of the MLNX_OFED package with hardware offload capabilities.

OVS-DPDK Connection Tracking

[Beta] Added support for OvS-DPDK Connection Tracking hardware offload.

OVS-DPDK VirtIO Acceleration through VF Relay

Added support for OVS-DPDK VirtIO Acceleration through VF Relay (also known as Software vDPA) forwarding of traffic from VF to Virtio VM and vice-versa.

OVS-DPDK VXLAN Encap/Decap

Added support for OVS-DPDK VXLAN encapsulation and decapsulation hardware offload.

Adapters: ConnectX-4 and above

Discard Counters

Exposed rx_prio[p]_discards discard counters per priority that count the number of received packets dropped due to lack of buffers on the physical port.

MPLS Traffic

Added support for reporting TSO and CSUM offload capabilities for MPLS tagged traffic and, allowed the kernel stack to use these offloads.

mlx5e Max Combined Channels

Increased the driver’s maximal combined channels value from 64 to 128 (however, note that OOB value will not cross 64).
128 is the upper bound. Lower maximal value can be seen on the host, depending on the number of cores and MSIX's configured by the firmware.

RoCE Accelerator Counters

Added the following RoCE accelerator counters:

  • roce_adp_retrans - counts the number of adaptive retransmissions for RoCE traffic

  • roce_adp_retrans_to - counts the number of times RoCE traffic reached timeout due to adaptive retransmission

  • roce_slow_restart - counts the number of times RoCE slow restart was used

  • roce_slow_restart_cnps - counts the number of times RoCE slow restart generated CNP packets

  • roce_slow_restart_trans - counts the number of times RoCE slow restart changed state to slow restart

All Adapters

Migration to RDMA-Core

The default installation of the userspace is now the RDMA-Core library instead of the legacy verbs. This achieves most of the legacy experimental verbs’ functionalities, and more.

For NVIDIA VMA or NVIDIA RiverMax, use experimental verbs (prefix “ibv_exp”).

For further information on the migration to RDMA-Core and the list of new APIs used for various MLNX_OFED features, please refer to the Migration to RDMA-Core document.

ibdev2netdev Tool Output

ibdev2netdev tool output was changed such that the bonding device now points at the bond instead of the slave interface.

Memory Region

Added support for the user to register memory regions with a relaxed ordering access flag. This can enhance performance, depending on architecture and scenario.

Devlink Health Reporters

Added support for monitoring and recovering from errors that occur on the RX queue, such as cookie errors and timeout.

GSO Optimization

Improved GSO (Generic Segmentation Offload) workload performance by decreasing doorbells usage to the minimum required.

TX CQE Compression

Added support for TX CQE (Completion Queue Element) compression. Saves on outgoing PCIe bandwidth by compressing CQEs together. Disabled by default. Configurable via private flags of ethtool.

Firmware Versions Query via Devlink

Added the option to query for running and stored firmware versions using the devlink tool.

Firmware Flash Update via Devlink

Added the option to update the firmware image in the flash using the devlink tool.

Usage: devlink dev flash <dev> file <file_name>.mfa2

For further information on how to perform this update, see "Updating Firmware Using ethtool/devlink and .mfa2 File" section in MFT User Manual.

Devlink Health WQE Dump

Added support for WQE (Work Queue Element) dump, triggered by an error on Rx/Tx reporters. In addition, some dumps (not triggered by an error) can be retrieved by the user via devlink health reporters.

GENEVE Tunnel Stateless Offload

Added support for GENEVE tunneled hardware offloads of TSO, CSUM and RSS.

TCP Segmentation and Checksum Offload

Added TCP segmentation and checksum offload support for MPLS-tagged traffic.

Category

Description

4.7-3.2.9.0

HCAs: ConnectX-5 and above

Uplink Representor Modes

Added support for new_netdev and nic_netdev uplink representor modes.

For further information on how to configure these modes, please refer to Configuring Uplink Representor Mode.

mlx5_core

Added new mlx5_core module parameter "num_of_groups", which controls the number of large groups in the FDB flow table.

Note: The default value of num_of_groups may change per MLNX_OFED driver version. The following table lists the values that must be set when upgrading the MLNX_OFED version prior to driver load, in order to achieve the same OOB experience.

MLNX_OFED Version

num_of_groups Default Value

v4.7-3.2.9.0

4

v4.6-3.1.9.0.14

15

v4.6-3.1.9.0.15

15

v4.5-1.0.1.0.19

63

For further information, please refer to Performance Tuning Based on Traffic Patterns section in MLNX_OFED User Manual.

ConnectX-5

VFs Groups Minimum Bandwidth Rate

Added support for setting a minimum bandwidth rate on a group of VFs (BW guarantee) to ensure this group is able to transmit at least the amount of bandwidth specified on the wire.

Direct Verbs Support for Batch Counters on Root Table

Added support for mlx5dv_dr API to set batch counters for root tables.

ConnectX-5 & BlueField

Modify Header

Added support for mlx5dv_dr_actions to support up to 32 modify actions.

mlx5dv_dr Memory Consumption

Reduced the mlx5dv_dr API memory consumption by improving the memory allocator.

mlx5dv_dr Memory Allocation

Reduced memory allocation time when using the mlx5dv_dr API. This is particularly significant for the first inserted rules on which memory is allocated.

BlueField

Mediated Devices

Added support for mediated devices that allows the creation of accelerated devices without SR-IOV on the Bluefield® system.

For further information on mediated devices and how to configure them, please refer to Mediated Devices section in MLNX_OFED User Manual.

4.7-1.0.0.1

HCAs: ConnectX-4 and above

Counters Monitoring

Added support for monitoring selected counters and generating a notification event (Monitor_Counter_Change event) upon changes made to these counters.
The counters to be monitored are selected using the SET_MONITOR_COUNTER command.

Signature Offload Kernel Verbs Enhancements

Added a new API which enables posting a single WR that completes the Protection Information (PI) operation internally. This reduces CPU utilization for posting and processing multiple WRs and improves performance by choosing the optimal mkey for the hardware according to the buffer memory layout.

EEPROM Device Thresholds via Ethtool

Added support to read additional EEPROM information from high pages of modules such as SFF-8436 and SFF-8636. Such information can be: 1. Application Select table 2. User writable EEPROM 3. Thresholds and alarms - Ethtool dump works on active cables only (e.g. optic), but thresholds and alarms can be read with “offset” and “length” parameters in any cable by running: ethtool -m <DEVNAME> offset X length Y

Performance Improvements

  • Updated Blueflame capability reporting to prevent redundant use of Blueflame when Write-combining is not supported.

  • Added Blueflame capabilities over VFs.

RDMA_RX RoCE Steering Support

Added the ability to create rules to steer RDMA traffic, with two destinations supported: DevX object and QP. Multiple priorities are also supported.

SRQ and XRC Support on On Demand Paging (ODP) Memory Region (MR)

Added support for using ODP MR with SRQ WQEs and XRC transport.

Indirect Mkey ODP

Added the ability to create indirect Mkeys with ODP support over DevX interface.

DevX Asynchronous Query Commands

Added support for running QUERY commands over the DevX interface in an asynchronous mode. This enables applications to issue many commands in parallel while firmware processes the commands.

Implicit ODP

Added support for reporting implicit ODP support to user applications in order to allow better granularity over ODP creation.

Devlink Health Utility

Added support for real-time alerting of functionality issues that may be found in a system component (reporter). This utility helps detect and recover from a problem with a PCI device. It provides a centralize status of drivers' health activities in the generic Devlink instance and inter alia, supports the following:

  • Storing real-time error dumps

  • Performing automatic (configurable) real-time reporter recovery

  • Performing real-time reporter diagnosis

  • Indicating real-time reporter's health status

  • Providing admins with the ability to dump, diagnose and recover a reporter

  • Providing admins with the ability to configure a reporter

User-Mode Memory Registration (UMR)

Enabled registration of memory patterns that can be used for future RDMA operations.

GENEVE Tunnel Stateless Offload

Added support for Generic Network Virtualization Encapsulation (GENEVE) tunneled hardware offload of TSO, CSUM and RSS.

ODP Pre-fetch

Added support for pre-fetching a range of an on-demand paging (ODP) memory region (MR), this way reducing latency by making pages present with RO/RW permissions before the actual IO is conducted.

Fragmented
QPs Buffer

Added the ability to allocate a fragmented buffer to in-kernel QP creation requests, in cases of large QP size requests that used to fail due to low memory resources on the host.

Flow Counters Batch Query

Allowed flow counters created with the DevX interface to be attached to flows created with the raw flow creation API.

DevX Privilege Enforcement

Enforced DevX privilege by firmware. This enables future device functionality without the need to make driver changes unless a new privilege type is introduced.

DevX Interoperability APIs

Added support for modifying and/or querying for a verb object (including CQ, QP, SRQ, WQ, and IND_TBL APIs) via the DevX interface.

This enables interoperability between verbs and DevX.

Counters Monitoring

Added support for monitoring selected counters and generating a notification event (Monitor_Counter_Change event) upon changes made to these counters.

The counters to be monitored are selected using the SET_MONITOR_COUNTER command.

Rx Hash Fields Configuration

Added the ability to configure Rx hash fields used for traffic spreading into Rx queues using ETHTOOL_SRXFH and ETHTOOL_GRXFH ethtool commands. Built-in Receive Side Scaling (RSS) profiles can now be changed on the following traffic types: UDP4, UDP6, TCP4 and TCP6. This configuration affects both outer and inner headers.

HCAs: ConnectX-4 Lx and above

Equal Cost Multi-Path (ECMP)

Added support for offloading ECMP rules by tracking software multipath route and related next-hops, and reflecting this as port affinity to the hardware.

VF LAG

Added support for High Availability and load balancing for Virtual Functions of different physical ports in SwitchDev SR-IOV mode.

Uplink Representors

Exposed PF (uplink) representors in SwitchDev mode, similarly to VF representors, as an infrastructure improvement for SmartNICs.

HCAs: ConnectX-5

Userspace Software Steering for eSwitch

Added software steering capabilities to the SR-IOV eSwitch. Software steering enables better rules insertion rate compared to the current firmware-based solution. This is achieved by performing calculations on the main CPU which allows for higher insertion rates.

Userspace Software Steering for NICs

Added software steering capabilities to NIC Rx/Tx. Software steering enables better rules insertion rate compared to the current firmware-based solution. This is achieved by performing calculations on the main CPU which allows for higher insertion rates. This solution was designed to work with Virtio DPDK.

Note: Support will be enabled by default once the support for GID change is added.

HCAs: ConnectX-5 and above

ASAP2

Incorporated the documentation of Accelerated Switching And Packet Processing (ASAP2): Hardware Offloading for vSwitches into MLNX_OFED Release Notes and User Manual.

QP Counters and Firmware Errors per PID

QP counters and flow counters are now set per Process ID (PID) to allow better visibility of RDMA error states. Users will be able to manually tune the Q counter to monitor specific QPs, or automatically monitor QPs according to predefined criteria, such as the QP type.

ODP over DC

Added support for On-Demand Paging (ODP) over DC transport.

Address Translation Services

Added support for Address Translation Services (ATS) feature, which improves performance for virtualized PeerDirect applications by caching PA-> MA translations and preventing PCI transactions from going to the root complex.

XDP Inline Transmission of Small Packets

Added support for when forwarding packets with XDP, a packet smaller than 256 bytes would be sent inline within its WQE Tx descriptor for better performance. The number of packets that are transmitted inline depends on CPUs load, where lower load leads to a higher number of inline transmission.

VLAN Rewrite

Added support for offloading VLAN ID modify operation, allowing the user to replace the VLAN tag of the incoming frame with a user-specified VLAN tag value.

CQE Padding

Added support for padding 64B CQEs to 128B cache lines to improve performance on 128B cache line systems, such as PPC.

XDP Multi-Packet Tx Work Queue Element (WQE)

Added support for Multi-Packet Tx WQEs in XDP transmit flows to work with a new and improved WQE layout that describes several packets.This saves PCI bandwidth and transactions, and improves transmit packet rate.

HCAs: ConnectX-6

ConnectX Device IDs

Added support for the following new device IDs:

  • ConnectX-6 Dx (PF)

  • ConnectX Family mlx5Gen Virtual Function (VF)
    Note that every new device (adapter) VF will be identified with this device ID. Different VF models will be distinguished by their revision ID.

HCAs: ConnectX-6 and above

Ethtool 200Gbps

ConnectX-6 hardware introduces support for 200Gbps and 50Gbps-per-lane link mode. The driver supports full backward compatibility with previous configurations. Note that in order to advertise newly added link-modes, the full bitmap related to the link modes must be advertised from ethtool man page.

NOTE: This feature is firmware-dependent. Currently, ConnectX-6 Ethernet firmware supports up to 100Gbps only. Thus, this capability may not function properly using the current driver and firmware versions.

HDR Link Speed Exposure

Added support for HDR link speed in CapabilityMask2 field in port attributes.

QP Packet Based Credit Mode

Added support for an alternative end-to-end credit mode for QP creation. Credits transported from the responder to the requester are now issued per packet. This is particularly useful for sending large RDMA messages from HCA to switches that are short in memory.

HCAs: BlueField

Device Emulation Infrastructure

Added support for Device Emulation in BlueField. This mechanism allows function-A to perform operations on behalf of function-B. The emulation manager creates a channel (named VHCA_TUNNEL general object) that acts as the direct command interface between the emulated function host and the HCA hardware. The emulation software creates this tunnel for every managed function and issues commands via the DevX general command interface.

HCAs: All

Verbs Migration to RDMA-Core

Legacy verbs remain the default userspace installation option in the MLNX_OFED. However, as of MLNX_OFED v4.7, you can opt to install full RDMA-Core based userspace by adding the
--upstream-libs flag to the mlnxofedinstall script.

MLNX_OFED Installation via Repository

The repository providing legacy verbs has been moved from RPMS or DEBS folders to RPMS/MLNX_LIBS and DEBS/MLNX_LIBS.

In addition, a new repository providing RDMA-Core based userspace has been added to RPMS/UPSTREAM_LIBS and DEBS/UPSTREAM_LIBS.

NFSoRDMA

Added support for NFS over RDMA (NFSoRDMA) module over the OSs listed in NFSoRDMA Supported OSs section.

As of MLNX_OFED v4.7, NFSoRDMA driver is no longer installed by default. In order to install it over a supported kernel, add the “--with-nfsrdma” installation option to the “mlnxofedinstall” script.

RDMA-CM QP Timeout Control

Added a new option to rdma_set_option that allows applications to override the RDMA-CM's QP ACK timeout value.

Object IDs Exportation

Added a unique ID for each verbs object to allow direct query over rdma-tool and rdma-netlink for enhanced debuggability.

RDMA-CM Application Managed QP

Added support for the RDMA application to manage its own QPs and use RDMA-CM only for exchanging Address information.

Bug Fixes

See “Bug Fixes in This Version" section.

Category

Description

4.6-1.0.1.0

HCAs: ConnectX-3/ConnectX-3 Pro

Devlink Configuration Parameters Tool

Added support for a set of configuration parameters that can be changed by the user through the Devlink user interface.

HCAs: ConnectX-4 and above

ODP Pre-fetch

Added support for pre-fetching a range of an on-demand paging (ODP) memory region (MR), this way reducing latency by making pages present with RO/RW permissions before the actual IO is conducted.

DevX Privilege Enforcement

Enforced DevX privilege by firmware. This enables future device functionality without the need to make driver changes unless a new privilege type is introduced.

DevX Interoperability APIs

Added support for modifying and/or querying for a verb object (including CQ, QP, SRQ, WQ, and IND_TBL APIs) via the DevX interface.

This enables interoperability between verbs and DevX.

DevX Asynchronous Query Commands

Added support for running QUERY commands over the DevX interface in an asynchronous mode. This enables applications to issue many commands in parallel while firmware processes the commands.

DevX User-space PRM Handles Exposure

Exposed all PRM handles to user-space so DevX user application can mix verbs objects with DevX objects.

For example: Take the cqn from the created ibv_cq and use it on a devx)create(QP).

Indirect Mkey ODP

Added the ability to create indirect Mkeys with ODP support over DevX interface.

XDP Redirect

Added support for XDP_REDIRECT feature for both ingress and egress sides. Using this feature, incoming packets on one interface can be redirected very quickly into the transmission queue of another capable interface. Typically used for load balancing.

RoCE Disablement

Added the option to disable RoCE traffic handling. This enables forwarding of traffic over UDP port 4791 that is handled as RoCE traffic when RoCE is enabled.

When RoCE is disabled, there is no GID table, only Raw Ethernet QP type is supported and RoCE traffic is handled as regular Ethernet traffic.

Forward Error Correction (FEC) Encoding

Added the ability to query and modify Forward Error Correction (FEC) encoding, as well as disabling it via Ethtool.

RAW Per-Lane Counters Exposure

Exposed RAW error counters per cable-module lane via ethtool stats. The counters show the number of errors before FEC correction (if enabled).

For further information, please see phy_raw_errors_lane[i] under Physical Port Counters section in Understanding mlx5 ethtool Counters Community post.

HCAs: ConnectX-4 Lx and above

VF LAG

Added support for High Availability and load balancing for Virtual Functions of different physical ports in SwitchDev SR-IOV mode.

HCAs: ConnectX-5 and above

ASAP2 Offloading VXLAN Decapsulation with HW LRO

Added support for performing hardware Large Receive Offload (HW LRO) on VFs with HW-decapsulated VXLAN.
For further information on the VXLAN decapsulation feature, please refer to ASAP2 User Manual under nvidia.com/en-us/networking/.com → Products → Software → ASAP2.

PCI Atomic Operations

Added the ability to run atomic operations on local memory without involving verbs API or compromising the operation's atomicity.

Equal-Cost Multi-Path (ECMP) Routing Offloading

Enabled Equal-Cost Multi-Path (ECMP) Routing offloading.
Equal-Cost Multi-Path (ECMP) is a forwarding mechanism for routing packets along multiple paths of equal cost with the goal to achieve almost equally distributed link load sharing.

VXLAN over VLAN

VXLAN over VLAN enables the user to use VXLAN offloads' benefit to offload VLAN tagged tunnels thus boost system's performance.

VLAN Rewrite

Rewriting VLAN tags allows the user to replace the VLAN tag of the incoming frame with a user-specified VLAN tag value.

HCAs: ConnectX-5

Virtual Ethernet Port Aggregator (VEPA)

Added support for activating/deactivating Virtual Ethernet Port Aggregator (VEPA) mode on a single virtual function (VF). To turn on VEPA on the second VF, run:
echo ON > /sys/class/net/enp59s0/device/sriov/1/vepa

VFs Rate Limit

Added support for setting a rate limit on groups of Virtual Functions rather on an individual Virtual Function.

HCAs: ConnectX-6

ConnectX-6 Support

[Beta] Added support for ConnectX-6 (VPI only) adapter cards.

NOTE: In HDR installations that are built with remotely managed Quantum-based switches, the switch’s firmware must be upgraded to version 27.2000.1142 prior to upgrading the HCA’s (ConnectX-6) firmware to version 20.25.1500. When using ConnectX-6 HCAs with firmware v20.25.1500 and connecting them to Quantum-based switches, make sure the Quantum firmware version is 27.2000.1142 in order to avoid any critical link issues.

Ethtool 200Gbps

ConnectX-6 hardware introduces support for 200Gbps and 50Gbps-per-lane link mode. MLNX_OFED supports full backward compatibility with previous configurations.

Note that in order to advertise newly added link-modes, the full bitmap related to the link modes must be advertised from ethtool man page. For the full bitmap list per link mode, please refer to MLNX_OFED User Manual.

NOTE: This feature is firmware-dependent. Currently, ConnectX-6 Ethernet firmware supports up to 100Gbps only. Thus, this capability may not function properly using the current driver and firmware versions.

PCIe Power State

Added support for the following PCIe power state indications to be printed to dmesg:

  1. Info message #1: PCIe slot power capability was not advertised.

  2. Warning message: Detected insufficient power on the PCIe slot (xxxW).

  3. Info message #2: PCIe slot advertised sufficient power (xxxW).
    When indication #1 or #2 appear in dmesg, user should make sure to use a PCIe slot that is capable of supplying the required power.

HCAs: mlx5

Message Signaled
Interrupts-X (MSI-X)
Vectors

Added support for using a single MSI-X vector for all control event queues instead of one MSI-X vector per queue in a virtual function driver. This frees extra MSI-X vectors to be used for completion event queue, allowing for additional traffic channels in the network device.

Send APIs

Introduced a new set of QP Send operations (APIs) which allows extensibility for new Send opcodes.

DC Data-path

Added DC QP data-path support using new Send APIs introduced in Direct Verbs (DV).

HCAs: BlueField

BlueField Support

BlueField is now fully supported as part of the NVIDIA OFED mainstream version sharing the same code baseline with all the adapters product line.

Representor Name Change

In SwitchDev mode:

  • Uplink representors are now called p0/p1

  • Host PF representors are now called pf0hpf/pf1hpf

  • VF representors are now called pf0vfN/pf1vfN

ECPF Net Devices

In SwitchDev mode, net devices enp3s0f0 and enp3s0f1 are no longer created.

Setting Host MAC and Tx Rate Limit from ECPF

Expanded to support VFs as well as the host PFs.

HCAs: All

RDMA-CM Application Managed QP

Added support for the RDMA application to manage its own QPs and use RDMA-CM only for exchanging Address information.

RDMA-CM QP Timeout Control

Added a new option to rdma_set_option that allows applications to override the RDMA-CM's QP ACK timeout value.

MLNX_OFED Verbs API

As of MLNX_OFED v5.0 release (Q1 2020) onwards, MLNX_OFED Verbs API will be migrated from the legacy version of the user space verbs libraries (libibervs, libmlx5 ..) to the upstream version rdma-core.
More details are available in MLNX_OFED user manual under Installing Upstream rdma-core Libraries.

Bug Fixes

See Bug Fixes in This Version section.

Category

Description

4.5-1.0.1.0

HCAs: ConnectX-5

VFs per PF

Increased the amount of maximum virtual functions (VF) that can be allocated to a physical function (PF) to 127 VF.

HCAs: ConnectX-4/ ConnectX-4 Lx/ConnectX-5

SW-Defined UDP Source Port for RoCE v2

UDP source port for RoCE v2 packets is now calculated by the driver rather than the firmware, achieving better distribution and less congestion. This mechanism works for RDMA- CM QPs only, and ensures that RDMA connection messages and data messages have the same UDP source port value.

HCAs: mlx5 Driver

Local Loopback Disable

Added the ability to manually disable Local Loopback regardless of the number of open user-space transport domains.

HCAs: ConnectX-6

Adapter Cards

Added support for ConnectX-6 Ready. For further information, please contact support networking-support@nvidia.com.
.

HCAs: All

NEO-Host

Integrated NEO-Host for orchestration and management of host networking into MLNX_OFED package.

Bug Fixes

See Bug Fixes in This Version section.

4.4-2.0.7.0

HCAs: All

Bug Fixes

See Bug Fixes in This Version section.

4.4-1.0.0.0

HCAs: ConnectX-4/ConnectX-4 Lx/ConnectX-5

Adaptive Interrupt Moderation

Added support for adaptive Tx, which optimizes the moderation values of the Tx CQs on runtime for maximum throughput with minimum CPU overhead.

This mode is enabled by default.

Updated Adaptive Rx to ignore ACK packets so that queues that only handle ACK packets remain with the default moderation.

Docker Containers [Beta]

Added support for Docker containers to run over Virtual RoCE and InfiniBand devices using SR-IOV mode.

VF Statistics

Performed the following virtual function statistics changes:

  • Added tx_broadcast and tx_multicast counters

  • Included RDMA statistics for existing counters

Force TTL

Added support for setting a global TTL value for all RC QPs and rdma-cm QPs.

Firmware Tracer

Added a new mechanism for the device’s FW/HW to log important events into the event tracing system (/sys/kernel/debug/tracing) without requiring any NVIDIA-specific tool.

Note: This feature is enabled by default.

CR-Dump

Accelerated the original cr-dump by optimizing the reading process of the device’s CR-Space snapshot.

RoCE ICRC Error Counter

Added support for a new counter that exposes the amount of corrupted RoCE packets that arrive with bad Invariant Cyclic Redundancy Code (ICRC).

HCAs: ConnectX-4/ConnectX-4 Lx

VST Q-in-Q

Added support for C-tag (0x8100) VLAN insertion to tagged packets in VST mode.

HCAs: ConnectX-4

Ethernet Tunneling Over IPoIB Driver (eIPoIB)

Re-added support for eth_ipoib driver, which provides a standard Ethernet interface to be used as a Physical Interface (PIF) into the Hypervisor virtual network, and serves one or more Virtual Interfaces (VIF).

HCAs: ConnectX-4 Lx/ConnectX-5

OVS Offload using ASAP2

Added support for NVIDIA Accelerated Switching And Packet Processing (ASAP2) technology, which allows OVS offloading by handling OVS data-plane, while maintaining OVS control-plane unmodified. OVS Offload using ASAP2 technology provides significantly higher OVS performance without the associated CPU load.

For further information, refer to ASAP2 Release Notes under nvidia.com/en-us/networking/.com → Products → Software → ASAP2.

HCAs: All

Upstream Libraries

Added a repository repodata to support installing upstream libraries (based on upstream rdma-core), using he Operating System's standard package manager (yum, apt-get, etc.).

For further information, please refer to “Installing Upstream rdma-core Libraries” section in MLNX_OFED User Manual

Note: This is intended only for DPDK users.

Installation

Added support for new metadata packages that only install userspace packages at a time (without any kernel packages), using the Operating System's standard package manager (yum, apt-get, etc.). These metadata packages will have the suffix “-user-only”. For example: “mlnx-ofed-all-user-only”.

Bug Fixes

See Bug Fixes in This Version section.

4.3-1.0.1.0

HCAs: ConnectX-4/ConnectX-4 Lx/ConnectX-5

Adaptive Interrupt Moderation

Added support for adaptive Tx, which optimizes the moderation values of the Tx CQs on runtime for maximum throughput with minimum CPU overhead.

This mode is enabled by default.

Updated Adaptive Rx to ignore ACK packets so that queues that only handle ACK packets remain with the default moderation.

Docker Containers [Beta]

Added support for Docker containers to run over Virtual RoCE and InfiniBand devices using SR-IOV mode.

VF Statistics

Performed the following virtual function statistics changes:

  • Added tx_broadcast and tx_multicast counters

  • Included RDMA statistics for existing counters

Force TTL

Added support for setting a global TTL value for all RC QPs and rdma-cm QPs.

Firmware Tracer

Added a new mechanism for the device’s FW/HW to log important events into the event tracing system (/sys/kernel/debug/tracing) without requiring any NVIDIA-specific tool.

Note: This feature is enabled by default.

CR-Dump

Accelerated the original cr-dump by optimizing the reading process of the device’s CR-Space snapshot.

RoCE ICRC Error Counter

Added support for a new counter that exposes the amount of corrupted RoCE packets that arrive with bad Invariant Cyclic Redundancy Code (ICRC).

HCAs: ConnectX-4/ConnectX-4 Lx

VST Q-in-Q

Added support for C-tag (0x8100) VLAN insertion to tagged packets in VST mode.

HCAs: ConnectX-4

Ethernet Tunneling Over IPoIB Driver (eIPoIB)

Re-added support for eth_ipoib driver, which provides a standard Ethernet interface to be used as a Physical Interface (PIF) into the Hypervisor virtual network, and serves one or more Virtual Interfaces (VIF).

HCAs: ConnectX-5/ConnectX-4 Lx

OVS Offload using ASAP2

Added support for NVIDIA Accelerated Switching And Packet Processing (ASAP2) technology, which allows OVS offloading by handling OVS data-plane, while maintaining OVS control-plane unmodified. OVS Offload using ASAP2 technology provides significantly higher OVS performance without the associated CPU load.

For further information, refer to ASAP2 Release Notes under nvidia.com/en-us/networking/.com → Products → Software → ASAP2.

HCAs: All

Upstream Libraries

Added a repository repodata to support installing upstream libraries (based on upstream rdma-core), using the Operating System's standard package manager (yum, apt-get, etc.).

For further information, please refer to “Installing Upstream rdma-core Libraries” section in MLNX_OFED User Manual

Note: This is intended only for DPDK users.

Installation

Added support for new metadata packages that only install userspace packages at a time (without any kernel packages), using the Operating System's standard package manager (yum, apt-get, etc.). These metadata packages will have the suffix “-user-only”. For example: “mlnx-ofed-all-user-only”.

Bug Fixes

See Bug Fixes in This Version section.

4.3-1.0.1.0

HCAs: ConnectX-5

Multi-Packet Work Request (WR)

Added support for the following multi-packet WR related verbs for control path:

  • ibv_exp_query_device

  • ibv_exp_create_srq

For further information on the use of these verbs, please refer to the Verbs man page.

Coherent Accelerator Processor Interface (CAPI) [beta]

Added support for CAPI, an interface that enables
ConnectX-5 adapter cards to provide the best performance for Power and OpenPower based platforms.

Tunneled Atomic

Added support for RDMA atomic commands offload so that when an RDMA Write operation is issued, the payload indicates which atomic operation to perform, instead of being written to the Memory Region (MR).

Packet Pacing

Added support for the following advanced burst control parameters:

  • max_burst_sz - for indicating the maximal burst size of packets

  • typical_pkt_sz - for improving the accuracy of the rate limiter

Erasure Coding
Offload verbs

Added support for erasure coding offload software verbs (encode/decode/update API) supporting a number of redundancy blocks (m) greater than 4.

HCAs: ConnectX-4/ConnectX-4 Lx/ConnectX-5

Virtual MAC

Removed support for Virtual MAC feature.

RoCE LAG

Added out of box RoCE LAG support for RHEL 7.2 and RHEL 6.9.

Dropped Counters

Added a new counter rx_steer_missed_packets which provides the number of packets that were received by the NIC, yet were discarded/dropped since they did not match any flow in the NIC steering flow table.

Added the ability for SR-IOV counter rx_dropped to count the number of packets that were dropped while vport was down.

Relaxed Ordering (RSYNC)

Added support for RSYNC feature to ensure correct ordering of memory operations between the GPU and HCA.

HCAs: mlx5 Driver

Reset Flow

Added support for triggering software reset for firmware/driver recovery. When fatal errors occur, firmware can be reset and driver reloaded.

HCAs: ConnectX-4 Lx/ConnectX-5

Striding RQ with HW Time-Stamping

Added the option to retrieve the HW timestamp when polling for completions from a completion queue that is attached to a multi-packet RQ (Striding RQ).

HCAs: ConnectX-4/ConnectX-4 Lx/ConnectX-5

4.2-1.2.0.0

DSCP Trust Mode

Added support for automatically setting the number of TC to 8 when the Trust state is changed to DSCP.

Receive Buffer

Added xon and xoff columns to the Receive Buffer configuration display.

4.2-1.0.0.0

HCAs: mlx5 Driver

Physical Address Memory Allocation

Added support to register a specific physical address range.

HCAs: Innova IPsec EN

Innova IPsec Adapter Cards

Added support for NVIDIA Innova IPsec EN adapter card, that provides security acceleration for IPsec-enabled networks.

HCAs: ConnectX-4/ConnectX-4 Lx/ConnectX-5

Precision Time Protocol (PTP)

Added support for PTP feature over PKEY interfaces.

This feature allows for accurate synchronization between the distributed entities over the network. The synchronization is based on symmetric Round Trip Time (RTT) between the master and slave devices, and is enabled by default.

1PPS Time Synchronization

Added support for One Pulse Per Second (1PPS) over IPoIB interfaces.

Virtual MAC

Added support for Virtual MAC feature, which allows users to add up to 4 virtual MACs (VMACs) per VF. All traffic that is destined to the VMAC will be forwarded to the relevant VF instead of PF. All traffic going out from the VF with source MAC equal to VMAC will go to the wire also when Spoof Check is enabled.

For further information, please refer to “Virtual MAC” section in MLNX_OFED User Manual.

Receive Buffer

Added the option to change receive buffer size and cable length. Changing cable length will adjust the receive buffer's xon and xoff thresholds.

For further information, please refer to “Receive Buffer” section in MLNX_OFED User Manual.

GRE Tunnel Offloads

Added support for the following GRE tunnel offloads:

  • TSO over GRE tunnels

  • Checksum offloads over GRE tunnels

  • RSS spread for GRE packets

NVMEoF

Added support for the host side (RDMA initiator) in RedHat 7.2 and above.

Dropless Receive Queue (RQ)

Added support for the driver to notify the FW when SW receive queues are overloaded.

PFC Storm Prevention

Added support for configuring PFC stall prevention in cases where the device unexpectedly becomes unresponsive for a long period of time. PFC stall prevention disables flow control mechanisms when the device is stalled for a period longer than the default pre-configured timeout. Users now have the ability to change the default timeout by moving to auto mode.

For further information, please refer to “PFC Stall Prevention” section in MLNX_OFEDUser Manual.

Force DSCP

Added support for this feature that enables setting a

global traffic_class value for all RC QPs.

HCAs: ConnectX-5

Q-in-Q

Added support for Q-in-Q VST feature in ConnectX-5 adapter cards family.

Device Memory Programming [beta]

Added support for on-chip memory allocation and usage in send/receive and RDMA operations at beta level.

Virtual Guest Tagging (VGT+)

Added support for VGT+ in ConnectX-4/ConnectX-5 HCAs. This feature is s an advanced mode of Virtual Guest Tagging (VGT), in which a VF is allowed to tag its own packets as in VGT, but is still subject to an administrative VLAN trunk policy. The policy determines which VLAN IDs are allowed to be transmitted or received. The policy does not determine the user priority, which is left unchanged.

For further information, please refer to “Virtual Guest Tagging (VGT+)” section in MLNX_OFED User Manual.

Tag Matching Offload

Added support for hardware Tag Matching offload with Dynamically Connected Transport (DCT).

HCAs: ConnectX-3/ConnectX-3 Pro

Shared Memory Region (MR)

Removed support for Shared MR feature on ConnectX-3/ConnectX-3 Pro adapter cards. As a result of this change, the following API/flags should not be used:

  • ibv_exp_reg_shared_mr

  • access shared flags for ibv_exp_reg_mr (IBV_EXP_ACCESS_SHARED_MR_XXX)

HCAs: All

CR-DUMP

Added support for the driver to take an automatic snapshot of the device’s CR-Space in cases of critical failures.

For further information, please refer to “CRDUMP” section in MLNX_OFED User Manual.

Upstream Libraries

Added the option to install upstream libraries (based on upstream rdma-core) for DPDK users only.

For further information, please refer to “Installing Upstream rdma-core Libraries” section in MLNX_OFED User Manual.

DiSNI

Added the option to install libdisni package as part of MLNX_OFED.

For further information, please refer to section “Installing libdisni Package” in MLNX_OFED User Manual.

Service Scripts

Added the ability to disable the ‘ stop ’ option in the openibd service script, by setting ALLOW_STOP=no in
/etc/infiniband/openib.conf.

Starting from the next release, ‘ stop ’ option will be disabled by default, and in order to enable it, ALLOW_STOP should be set to ‘yes’ in the conf file, or force-stop should be run.

4.1-1.0.2.0

HCAs: mlx5 Driver

RoCE Diagnostics and ECN Counters

Added support for additional RoCE diagnostics and ECN congestion counters under /sys/class/infiniband/mlx5_0/ports/1/hw_counters/ directory.

For further information, refer to the Understanding mlx5 Linux Counters and Status Parameters Community post.

rx-fcs Offload (ethtool)

Added support for rx-fcs ethtool offload configuration. Normally, the FCS of the packet will be truncated by the ASIC hardware before sending it to the application socket buffer (skb). Ethtool allows to set the rx-fcs not to be truncated, but to pass it to the application for analysis.

For more information and usage, refer to Understanding ethtool rx-fcs for mlx5 Drivers Community post.

DSCP Trust Mode

Added the option to enable PFC based on the DSCP value. Using this solution, VLAN headers will no longer be mandatory for use.

For further information, refer to the HowTo Configure Trust Mode on NVIDIA Adapters Community post.

RoCE ECN Parameters

ECN parameters have been moved to the following directory: /sys/kernel/debug/mlx5/<PCI BUS>/cc_params/

For more information, refer to the HowTo Configure DCQCN (RoCE CC) for ConnectX-4 (Linux) Community post.

Flow Steering Dump Tool

Added support for mlx_fs_dump, which is a python tool that prints the steering rules in a readable manner.

Secure Firmware Updates

Firmware binaries embedded in MLNX_OFED package now support Secure Firmware Updates. This feature provides devices with the ability to verify digital signatures of new firmware binaries, in order to ensure that only officially approved versions are installed on the devices.

For further information on this feature, refer to NVIDIA Firmware Tools (MFT) User Manual.

Enhanced IPoIB

Added support for Enhanced IPoIB feature, which enables better utilization of features supported in ConnectX-4 adapter cards, by optimizing IPoIB data path and thus, reaching peak performance in both bandwidth and latency.

Enhanced IPoIB is enabled by default.

PeerDirect

Added the ability to open a device and create a context while giving PCI peer attributes such as name and ID.

For further details, refer to the PeerDirect Programming Community post.

Probed VFs

Added the ability to disable probed VFs on the hypervisor. For further information, see HowTo Configure and Probe VFs on mlx5 Drivers Community post.

Local Loopback

Improved performance by rendering Local loopback (unicast and multicast) disabled by mlx5 driver by default while local loopback is not in use. The mlx5 driver keeps track of the number of transport domains that are opened by user-space applications. If there is more than one user-space transport domain open, local loopback will automatically be enabled.

1PPS Time Synchronization (at alpha level)

Added support for One Pulse Per Second (1PPS), which is a time synchronization feature that allows the adapter to send or receive 1 pulse per second on a dedicated pin on the adapter card.

For further information on this feature, refer to the HowTo Test 1PPS on NVIDIA Adapters Community post.

Precision Time Protocol (PTP)

Added support for PTP feature in IPoIB offloaded devices.

This feature allows for accurate synchronization between the distributed entities over the network.

The synchronization is based on symmetric Round Trip Time (RTT) between the master and slave devices.

The feature is enabled by default.

For further information, refer to Running Linux PTP with ConnectX-4 Community post.

Fast Driver Unload

Added support for fast driver teardown in shutdown and kexec flows.

HCAs: ConnectX-5/ConnectX-5 Ex

NVMEoF Target Offload

Added support for NVMe over fabrics (NVMEoF) offload, an implementation of the new NVMEoF standard target (server) side in hardware.

For further information on NVMEoF Target Offload, refer to HowTo Configure NVMEoF Target Offload .

MPI Tag Matching

Added support for offloading MPI tag matching to HCA.

HCAs: All

RDMA CM

Changed the default RoCE mode on which RDMA CM runs to RoCEv2 instead of RoCEv1.

RDMA_CM session requires both the client and server sides to support the same RoCE mode. Otherwise, the client will fail to connect to the server.

For further information, refer to RDMA CM and RoCE Version Defaults Community post.

Lustre

Added support for Lustre file system open-source project.

4.0-2.0.2.0

Operating Systems

Added support for Ubuntu v17.04.

4.0-2.0.0.1

PCIe Error Counting

[ConnectX-4/ConnectX-4 Lx] Added the ability to expose physical layer statistical counters to ethtool.

Multiprotocol Label Switching (MPLS) Tagged Packets Classification

[ConnectX-4/ConnectX-4 Lx] Enabled packet flow steering rules with IPv4/IPv6 classification (for raw packet QP (DPDK) only) to work on IPv4/IPv6 over MPLS (Ethertype 0x8847 and 0x8848) encapsulated packets.

RoCE VFs

[ConnectX-4/ConnectX-4 Lx] Added the ability to enable/disable RoCE on VFs.

RoCE LAG

[ConnectX-4/ConnectX-4 Lx] Added support for RoCE over LAG interface.

Standard ethtool

[ConnectX-4/ConnectX-4 Lx] Added support for flow steering and rx-all mode.

SR-IOV Bandwidth Share for Ethernet/RoCE (beta)

[ConnectX-4/ConnectX-4 Lx] Added the ability to guarantee the minimum rate of a certain VF in SR-IOV mode.

Adapter Cards

Added support for ConnectX-5 and ConnectX-5 Ex HCAs.

DSCP ConfigFS Control for RDMA-CM QPs

Added the ability to configure ToS/DSCP for RDMA-CM QPs only.

Soft RoCE (beta)

Add software implementation of RoCE that allows RoCE to run on any Ethernet network adapter whether it offers hardware acceleration or not.

NVMe over Fabrics (NVMEoF)

NVMEoF related module installation has been disabled by default. In order to enable it, add the “ --with-nvmf ” installation option to the “mlnxofedinstall” script.

NFS over RDMA (NFSoRDMA)

Removed support for NFSoRDMA drivers. These drivers are no longer provided along with the MLNX_OFED package.

Customer Affection Change

Description

5.4-1.0.3.0

udev Rules

As of version 5.4, the driver is set so that udev rules will change the names of network interfaces created from NVIDIA adapters.
The udev rules are shipped to "/lib/udev/rules.d" and may be overridden by placing a file with the same name in "/etc/udev/rules.d".
Example: /etc/udev/rules.d/82-net-setup-link.rules

Network Interface Names, udevd

[ConnectX-4 and above] In MLNX_OFED 5.4 GA, ConnectX-4/5/6 Ethernet network interfaces are now provided with permanent names.
Prior to this release, the default interface names were provided by the kernel and udevd (ethX) remained as-is.
From this release onwards, interface names are generated via new udevd rules.
The generated names are now predictable, and the default names are automatically renamed to the predictable names by the udevd daemon, according to udev rules files installed by OFED.

The new interface names look as follows: en[P][p<bus number]sf
For example, a ConnectX device with PCI address: 0005:01:00.1 will be named enP5p1s0f1

The advantage of such a scheme for interface naming is that device whose PCI address is 0005:01:00.1 will always get the same device name since that name now depends on the host geography.
(Previously there were race conditions which sometimes caused the same physical device to get a different interface name upon reboot).

Note: Ethernet interface renaming for ConnectX-4/5/6 is performed only when eswitch is supported.
eswitch is supported on kernels starting from kernel version 4.9; for Linux distro kernels earlier than 4.9.0, eswitch is supported only on RHEL7.x and on XenServer 7.1 CU2.

Deprecated, OvS-DPDK

OvS-DPDK deprecated the command "ovs-appctl dpctl/dump-e2e-stats".
Instead, the command has been integrated into the existing command "ovs-appctl dpctl/offload-stats-show -m" (when e2e-cache is enabled).

OvS-DPDK

OvS-DPDK ct-ct-nat offloads is now disabled by default.

A new knob in OvS was introduced: "ovs-vsctl set open_vswitch . other_config:ct-action-on-nat-conns=" (default value is false).
If disabled, ct-ct-nat configurations will not be fully offloaded, improving connection offloading rate for other cases (ct and ct-nat).
If enabled, ct-ct-nat configurations will be fully offloaded but ct and ct-nat offloading will be created more slowly.

mlnxofedinstall, udev, MLNX_OFED, umad

Before version 5.4, /etc/udev/rules.d/90-ib.rules was potentially automatically edited by installation scripts in case the options —umad-dev-rw or —umad-dev-na were used. From version 5.4 and above, those changes are made in /etc/udev/rules.d/91-ib-permissions.rules which (if exist) only include the settings for those command-line options.

© Copyright 2023, NVIDIA. Last updated on May 23, 2023.