Skip to contentSkip to conversation

doc: add outer UDP checksum limitations for mlx5

PATCH In review Dariusz Sosnowski 2 participants 2 messages Jul 10, 2023 – Jul 19, 2023

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: add outer UDP checksum limitations for mlx5

Currently available NVIDIA NICs and DPUs
do not have a capability to calculate the UDP checksum in the header added using encapsulation flow actions.

This limitation was not documented in mlx5 PMD docs. This patch adds this limitation to the docs and describes application requirements.

---
 doc/guides/nics/mlx5.rst | 8 ++++++++
 1 file changed, 8 insertions(+)
doc/guides/nics/mlx5.rst +8 -0
index 505873ecfd..43aef669e6 100644
@@ -480,6 +480,14 @@ Limitations
   - The input buffer, providing the removal size, is not validated.
   - The buffer size must match the length of the headers to be removed.
 
+- Outer UDP checksum calculation for encapsulation flow actions:
+
+  - Currently available NVIDIA NICs and DPUs do not have a capability to calculate
+    the UDP checksum in the header added using encapsulation flow actions.
+
+    Applications are required to use 0 in UDP checksum field in such flow actions.
+    Resulting packet will have outer UDP checksum equal to 0.
+
 - ICMP(code/type/identifier/sequence number) / ICMP6(code/type/identifier/sequence number) matching,
   IP-in-IP and MPLS flow matching are all mutually exclusive features which cannot be supported together
   (see :ref:`mlx5_firmware_config`).
Signature · 1 line
2.25.1
#1 lore raw

Hi,

Quoted 12 lines

-----Original Message-----
From: Dariusz Sosnowski <[email protected]>
Sent: Monday, July 10, 2023 11:49 AM
To: Matan Azrad <[email protected]>; Slava Ovsiienko <[email protected]>; Ori Kam <[email protected]>; Suanming Mou <[email protected]>
Cc: [email protected]
Subject: [PATCH] doc: add outer UDP checksum limitations for mlx5

Currently available NVIDIA NICs and DPUs do not have a capability to calculate the UDP checksum in the header added using encapsulation flow actions.

Quoted 6 lines

This limitation was not documented in mlx5 PMD docs.
This patch adds this limitation to the docs and describes application requirements.

Patch applied to next-net-mlx,

Kindest regards,
Raslan Darawsheh