From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <stable-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
	by inbox.dpdk.org (Postfix) with ESMTP id AE9E445694
	for <public@inbox.dpdk.org>; Wed, 24 Jul 2024 09:59:21 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
	by mails.dpdk.org (Postfix) with ESMTP id E930E42F29;
	Wed, 24 Jul 2024 09:59:14 +0200 (CEST)
Received: from NAM11-DM6-obe.outbound.protection.outlook.com
 (mail-dm6nam11on2057.outbound.protection.outlook.com [40.107.223.57])
 by mails.dpdk.org (Postfix) with ESMTP id 1FD2641611;
 Wed, 24 Jul 2024 09:36:43 +0200 (CEST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=Xh7iIU8Pcv/FBEExEU9B87jdMB85DGzXmro+WXs2VGs1UTymUxX9zADZNT2rG0ajo7og8kpRFIspnaf+GnVAOLftMrj3AbOTv2m045nXIpZvtEYFAbghCBmqHZYIDQEmglMGFtnB2/yei/OmvamyvpC9ZVyx7jBTcv2xLZ0btaaj+HF+RtMNd+vy9Xil6AJp+yojoD9G34nXnd/rXx95cGKSV2rJp2+tRIF3JpGeSXn8uLNN5DoLSK6/yvosJMDE2cHzhNdunMGM/9czKSReY4wTLuANbpY92OEI6My4uLFO4iCrGIMR1J5m9p0f16T0T7MWlRxI3DjVURv4R5mgoQ==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector10001;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;
 bh=sLFsBZDK1v+PvXuG7kvhdK+I+gySFG2xz0zODz+dZwg=;
 b=CyHm+XyNuAPCKtOkh/u5wKwWKmjekH2GBnnMk6VWd5cxv+4KfCljfFXcCEUiSKO1rxY2tN4Y37Ijyz6EFnxFYetNl8kL/1YW6BtYOY5UVhw7InQ0+w9E5Z5hc7rsXnTx+0mmRVxbvh8zdyplzZLBvGNYhaNPKGoG5tMyg+cD8kKONB9SVlmI/I3XYHwI4xV3wurq2+TJ4UstLWlK6uGz+ome+HOVOg5FuwanFLugSdwscNNIIORZZ1N+FaGuzUQ3YULnsIN6A64lGjL4QYLbgJeD/qHImkZaNqKjCjQFWVRlF7lf4n4ppKTYVblR9eU03tvWwmJfi80OjRl0d5At8Q==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is
 216.228.118.232) smtp.rcpttodomain=dpdk.org smtp.mailfrom=nvidia.com;
 dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com;
 dkim=none (message not signed); arc=none (0)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com;
 s=selector2;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;
 bh=sLFsBZDK1v+PvXuG7kvhdK+I+gySFG2xz0zODz+dZwg=;
 b=ZSYv5iLmc0ruUKoWL8n3rbVKaouw2p0YnJYdqscXtKIUhMDKP4tLwjt/76Tx7cI/j8PvGJZopcWD/FwgBqKNW0XRfoolo4YHFnVm7SdaVdS8xk5rIMKf79dV1USNWJauzUv6oEVZpamUTjTzwiQ+WwZ9FOOtDSFI5scsvDznmc/U6LROROqgfFi/i5pHefrwT8Jyt5b+r4o56z0jgH58O9kfQdnpYumHMXjpaQOeAD7IPC0g38QtU4/W0DG+xkqfgwnmmhJ4Q6MhZxbCLAL9aT4+wg6hOEwS2VrvwUMaA+SHD5WvNLpWeUZ8EcMdMA8jZVCNWAgT3Sppe7D71DAPKQ==
Received: from MN2PR05CA0057.namprd05.prod.outlook.com (2603:10b6:208:236::26)
 by SJ0PR12MB7081.namprd12.prod.outlook.com (2603:10b6:a03:4ae::17)
 with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7784.20; Wed, 24 Jul
 2024 07:36:39 +0000
Received: from BL6PEPF0001AB50.namprd04.prod.outlook.com
 (2603:10b6:208:236:cafe::cc) by MN2PR05CA0057.outlook.office365.com
 (2603:10b6:208:236::26) with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7784.18 via Frontend
 Transport; Wed, 24 Jul 2024 07:36:38 +0000
X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.118.232)
 smtp.mailfrom=nvidia.com;
 dkim=none (message not signed)
 header.d=none;dmarc=pass action=none header.from=nvidia.com;
Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates
 216.228.118.232 as permitted sender) receiver=protection.outlook.com;
 client-ip=216.228.118.232; helo=mail.nvidia.com; pr=C
Received: from mail.nvidia.com (216.228.118.232) by
 BL6PEPF0001AB50.mail.protection.outlook.com (10.167.242.74) with Microsoft
 SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id
 15.20.7784.11 via Frontend Transport; Wed, 24 Jul 2024 07:36:38 +0000
Received: from drhqmail201.nvidia.com (10.126.190.180) by mail.nvidia.com
 (10.127.129.5) with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1544.4; Wed, 24 Jul
 2024 00:36:25 -0700
Received: from drhqmail201.nvidia.com (10.126.190.180) by
 drhqmail201.nvidia.com (10.126.190.180) with Microsoft SMTP Server
 (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id
 15.2.1544.4; Wed, 24 Jul 2024 00:36:24 -0700
Received: from nvidia.com (10.127.8.14) by mail.nvidia.com (10.126.190.180)
 with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1544.4 via Frontend
 Transport; Wed, 24 Jul 2024 00:36:21 -0700
From: Maayan Kashani <mkashani@nvidia.com>
To: <dev@dpdk.org>
CC: <mkashani@nvidia.com>, <rasland@nvidia.com>, <stable@dpdk.org>, "Dariusz
 Sosnowski" <dsosnowski@nvidia.com>, Viacheslav Ovsiienko
 <viacheslavo@nvidia.com>, Bing Zhao <bingz@nvidia.com>, Ori Kam
 <orika@nvidia.com>, Suanming Mou <suanmingm@nvidia.com>, Matan Azrad
 <matan@nvidia.com>, Alex Vesker <valex@nvidia.com>
Subject: [PATCH v2] doc: document mlx5 HWS actions order
Date: Wed, 24 Jul 2024 10:36:16 +0300
Message-ID: <20240724073617.132973-1-mkashani@nvidia.com>
X-Mailer: git-send-email 2.21.0
In-Reply-To: <20240717125622.909-1-mkashani@nvidia.com>
References: <20240717125622.909-1-mkashani@nvidia.com>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
X-NV-OnPremToCloud: ExternallySecured
X-EOPAttributedMessage: 0
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: BL6PEPF0001AB50:EE_|SJ0PR12MB7081:EE_
X-MS-Office365-Filtering-Correlation-Id: 58aa8219-c20c-4af4-afcd-08dcabb35a60
X-MS-Exchange-SenderADCheck: 1
X-MS-Exchange-AntiSpam-Relay: 0
X-Microsoft-Antispam: BCL:0;
 ARA:13230040|1800799024|36860700013|376014|82310400026; 
X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?ucFshrx4SZJaJz+NbGXWJ7KZIzvZ0PXq1Rb/V2wkUGb9pA79dMwAZO2gZNQH?=
 =?us-ascii?Q?XXr5cQfD+QI39OUV9nCYuqfTDYZ+0LLVqKYLtYCDVjdupo5/rqWHiwTLQeOZ?=
 =?us-ascii?Q?9Gicnnq6WAp8yll6YibaMVg3qh9pU+wo5IlmRZkxFg3O8mJw4K/3M+zuDXsU?=
 =?us-ascii?Q?vi66qC2D7nv6VJdXKB1eY2YIL+M2RUx7yCGzYmaeqTgMlAYlBljPHGbxkkRe?=
 =?us-ascii?Q?wZ0kuVmzF74GOr1U9xUFeVnNtXgKaiCP1swn2nsDvU3dzZz+T6Kh6OgJ48mv?=
 =?us-ascii?Q?9m/x/Z953MlCm0BK7qUKsIvRPXbNQvbKPxsPuIBPuafmLhxsSiCMYyBHNZ2Q?=
 =?us-ascii?Q?8ncSf2USC8HGn6lgMsJ49IoFwJ4gihDk5c52WrvplV5dZcCZmUbuVe4XQoqR?=
 =?us-ascii?Q?v/tPpWJev/m7UKwpS+oyHaSWqagaPWuPU98yGK5x1IljHbwghrPQCZ934otR?=
 =?us-ascii?Q?SRdLT88zVxwNWPb80JuWyk9aaPT2Evjiv2/oujzJqsbapgOr0u+hPV4uJSiV?=
 =?us-ascii?Q?rV+gSMLOLtkxeacqVlb/ju6MVPE+ZxraICdetVR2EmVsI6SPcRs/ommYEFBP?=
 =?us-ascii?Q?iaI2HyOxayPf1BGQNoMSpIIIvaUyvzt3585hOGQKSd8iKc40Vh+7c4dglPcq?=
 =?us-ascii?Q?PIdur3ta6lZFKVksrBmCfDvM5lFyaNh6V3ljr8p3Ig59sTl6MdcQMQOAlonO?=
 =?us-ascii?Q?M/n6E/ACUWpVQL5XdifYevQcJC46YV5gs95gTiNgRl5bKTN0fu75h7cZn2XB?=
 =?us-ascii?Q?sIFcsyUwgiTqUxaNUzoELLua/1Cy8+FZbyRCfzXlADkh4nwXKF87a7LVpi0Y?=
 =?us-ascii?Q?LDDE4lnnuC0Tz2svpBzHIiAEqX5HOEJ4oqXILTmHQw0i+BDS2MAz34CqQl4P?=
 =?us-ascii?Q?AW01vr86WH3kC+E0oJ6RJneR/N/0W0kVXwt/pgzQ7RYwxV7o84t3WBQVyPKJ?=
 =?us-ascii?Q?kkaw2N0at10C+J/GaxAlPwc1x+FhcmyjGMhVDb7fETdFz9TVHoI6mZ3V69F9?=
 =?us-ascii?Q?khh0vCkPiG0yCoo2LqWDz4U+UKi7vkQdd0/UZBN1r/6DGpj0EzuZA8FWdLiT?=
 =?us-ascii?Q?S3IBpZIO3vBXYQipwcg2ks+vCocFPpU26dGU3J1n0QjCOyazpFkZA0+TF2kZ?=
 =?us-ascii?Q?XgS/hSEaylwOoc0ZxlITuKvrJD3sFLS86HKQxJnr2ZAP+PdO5EbhcG4yOQkt?=
 =?us-ascii?Q?ZEfs1/puxf7UOLjxtXDeyunXWtxEomvvoA0of+SQe61T5OSdLAeEPbmw/+YU?=
 =?us-ascii?Q?C7YlZ9gHxoZkvoC1OGjgoG34tyR3abRMplOou2vC3dr3jpKbLJROS/27+idx?=
 =?us-ascii?Q?ZcfBj51mGcJUgsCIURIMtxXMPHBacuJpX9JhpUWPrqgEbjGbacs96njAOBq9?=
 =?us-ascii?Q?VKRPQVrUKaM9QbVbOIv2SvE+oxz0iznwkKPLU+/HwgCQVFuy0OYMa2/8I1zm?=
 =?us-ascii?Q?yA/uZPUqT61VdiskPYcE7G412eMwZ8Yu?=
X-Forefront-Antispam-Report: CIP:216.228.118.232; CTRY:US; LANG:en; SCL:1; SRV:;
 IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc7edge1.nvidia.com; CAT:NONE;
 SFS:(13230040)(1800799024)(36860700013)(376014)(82310400026); DIR:OUT;
 SFP:1101; 
X-OriginatorOrg: Nvidia.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jul 2024 07:36:38.1830 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: 58aa8219-c20c-4af4-afcd-08dcabb35a60
X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a
X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.118.232];
 Helo=[mail.nvidia.com]
X-MS-Exchange-CrossTenant-AuthSource: BL6PEPF0001AB50.namprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Anonymous
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR12MB7081
X-BeenThere: stable@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: patches for DPDK stable branches <stable.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/stable>,
 <mailto:stable-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/stable/>
List-Post: <mailto:stable@dpdk.org>
List-Help: <mailto:stable-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/stable>,
 <mailto:stable-request@dpdk.org?subject=subscribe>
Errors-To: stable-bounces@dpdk.org

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")
Cc: stable@dpdk.org
Signed-off-by: Maayan Kashani <mkashani@nvidia.com>
Acked-by: Dariusz Sosnowski <dsosnowski@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 43fc181d8dc..4c00bb7755c 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -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``).
 
+  - 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.21.0