patch 'doc: describe mlx5 HWS actions order' has been queued to stable release 23.11.2

[Xueming Li]

Hi,

FYI, your patch has been queued to stable release 23.11.2

Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet.
It will be pushed if I get no objections before 08/14/24. So please
shout if anyone has objections.

Also note that after the patch there's a diff of the upstream commit vs the
patch applied to the branch. This will indicate if there was any rebasing
needed to apply to the stable branch. If there were code changes for rebasing
(ie: not only metadata diffs), please double check that the rebase was
correctly done.

Queued patches are on a temporary branch at:
https://git.dpdk.org/dpdk-stable/log/?h=23.11-staging

This queued commit can be viewed at:
https://git.dpdk.org/dpdk-stable/commit/?h=23.11-staging&id=d01561713d129d848444e764430c4be1fb133d17

Thanks.

Xueming Li <xuemingl at nvidia.com>

---
>From d01561713d129d848444e764430c4be1fb133d17 Mon Sep 17 00:00:00 2001
From: Maayan Kashani <mkashani at nvidia.com>
Date: Wed, 24 Jul 2024 10:36:16 +0300
Subject: [PATCH] doc: describe mlx5 HWS actions order
Cc: Xueming Li <xuemingl at nvidia.com>

[ upstream commit 88596e96f0efbe1bde4eeeb1cc196fd0d8627885 ]

Add actions order supported in mlx5 PMD
when HW steering flow engine is used.
This limitation existed since HW Steering flow engine was introduced.

Fixes: 22681deead3e ("net/mlx5/hws: enable hardware steering")

Signed-off-by: Maayan Kashani <mkashani at nvidia.com>
Acked-by: Dariusz Sosnowski <dsosnowski at nvidia.com>
---
 doc/guides/nics/mlx5.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index d0ebc101b4..2c59b24d78 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -245,6 +245,26 @@ Limitations
   - Matching on ICMP6 following IPv6 routing extension header,
     should match ``ipv6_routing_ext_next_hdr`` instead of ICMP6.
 
+  - The supported actions order is as below::
+
+          MARK (a)
+          *_DECAP (b)
+          OF_POP_VLAN
+          COUNT | AGE
+          METER_MARK | CONNTRACK
+          OF_PUSH_VLAN
+          MODIFY_FIELD
+          *_ENCAP (c)
+          JUMP | DROP | RSS (a) | QUEUE (a) | REPRESENTED_PORT (d)
+
+    a. Only supported on ingress.
+    b. Any decapsulation action, including the combination of RAW_ENCAP and RAW_DECAP actions
+       which results in L3 decapsulation.
+       Not supported on egress.
+    c. Any encapsulation action, including the combination of RAW_ENCAP and RAW_DECAP actions
+       which results in L3 encap.
+    d. Only in transfer (switchdev) mode.
+
 - When using Verbs flow engine (``dv_flow_en`` = 0), flow pattern without any
   specific VLAN will match for VLAN packets as well:
 
-- 
2.34.1

---
  Diff of the applied patch vs upstream commit (please double-check if non-empty:
---
--- -	2024-08-12 20:44:07.338984715 +0800
+++ 0154-doc-describe-mlx5-HWS-actions-order.patch	2024-08-12 20:44:02.595069393 +0800
@@ -1 +1 @@
-From 88596e96f0efbe1bde4eeeb1cc196fd0d8627885 Mon Sep 17 00:00:00 2001
+From d01561713d129d848444e764430c4be1fb133d17 Mon Sep 17 00:00:00 2001
@@ -4,0 +5,3 @@
+Cc: Xueming Li <xuemingl at nvidia.com>
+
+[ upstream commit 88596e96f0efbe1bde4eeeb1cc196fd0d8627885 ]
@@ -11 +13,0 @@
-Cc: stable at dpdk.org
@@ -20 +22 @@
-index 43fc181d8d..1dccdaad50 100644
+index d0ebc101b4..2c59b24d78 100644
@@ -23,3 +25,3 @@
-@@ -251,6 +251,26 @@ Limitations
-     IPv6 routing extension matching is not supported in flow template relaxed
-     matching mode (see ``struct rte_flow_pattern_template_attr::relaxed_matching``).
+@@ -245,6 +245,26 @@ Limitations
+   - Matching on ICMP6 following IPv6 routing extension header,
+     should match ``ipv6_routing_ext_next_hdr`` instead of ICMP6.