From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
	by inbox.dpdk.org (Postfix) with ESMTP id B7A0B45635;
	Wed, 17 Jul 2024 14:56:48 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
	by mails.dpdk.org (Postfix) with ESMTP id 4DD7140289;
	Wed, 17 Jul 2024 14:56:48 +0200 (CEST)
Received: from NAM02-DM3-obe.outbound.protection.outlook.com
 (mail-dm3nam02on2079.outbound.protection.outlook.com [40.107.95.79])
 by mails.dpdk.org (Postfix) with ESMTP id 1E55740261;
 Wed, 17 Jul 2024 14:56:47 +0200 (CEST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=iyTW1UKyd/UasGO4w6GrvPkAWtNv0d8ub29674RgV5E4xhC6ksxYKAR8bawe19y8v6TumVgTRKpdnmEb/5i7BTC6BkhGanIeQLw6pWrH5uFBWwForxxV/0ODaVJCfo95fnVENoZuyYRACcgtQfv7UYeFRTIDJYvi6mtkQa8x7YPsCCY+uQdlHO8g/VU5/WkUqMnfMUUg5ZtymDnZ10B8aWEW9H4VuaWLFEUVKuh4tJI0VnVokK6ZzWjoYH/JGyTulkQFbc/Jrys5dd1sj7RcVUxRvUmsyA7qvQ8kj+uZo2mJbb6WKz3VXX0ElBOTNOerWQ/npG/xf0nr+NjomPKQfw==
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=/mmVoZN/PV+ABoCren0ejfabFkJxC2a2n04vOwt1dmk=;
 b=pdIkJIpc22TRoMuRrqSzNCx/MZaoNvdrGNDreX9yEY0ub2/ep2PbVaAO78pyklw2/yhUrA79h/ZSnOGsArA68r6gnzoXY/UE+vdCTYAFzLNZeUZId42I/Fdm8prgydrG4HivQo1hYLz8io6Rv09dV8r3v7QqKgU0n422CuhXPdtQDtAQ8VlHEtzOZu/XYseIpcVPSCQ3VdOP74ztvwQmAM2j9Txq6t25ul2u9U3REehJUCMQC1A/XT8d8juDIJY5mqUOjsA65Hpnwl8ckRRrALAeRMUoOetA79+meOmopCxQeVyfLXa3DWCaateuzbC9b/TXhU7eQr7tmC2Vgw7gcw==
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=/mmVoZN/PV+ABoCren0ejfabFkJxC2a2n04vOwt1dmk=;
 b=JFROwaP23xuS3v/gXqGVBe0EyeQKK+2dMj0/CltWHtWWuJn/wPMnXosqk5di+CArdkJiYgRhk04goTcx3tWodqlFsjMSZUIOaRyquI/v35moTkWdXQ1DXVaPrvxE9TAoFfCLpzH5/M8CpYdx0cAjjFfY9K+zRSDmCoF/jjZjrsnbL4UiyEMlcJYS2qSWVpvzOEmePRfqOpRd+qDtoUg44QzDHdBcPT2MMgrECN1qZpCcwXSRYp5MmRC0K+V8TiNUwFL+rJ3pNb3A/ejLz5Vf6yg/DyfuD96J4ukKgwZYLaMC3FpKvafvqcNUl+1jopTMTMAlxJHrg95YHhgVmzTygQ==
Received: from DM6PR02CA0158.namprd02.prod.outlook.com (2603:10b6:5:332::25)
 by MW3PR12MB4458.namprd12.prod.outlook.com (2603:10b6:303:5d::10) with
 Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7784.16; Wed, 17 Jul
 2024 12:56:43 +0000
Received: from DS3PEPF000099E1.namprd04.prod.outlook.com
 (2603:10b6:5:332:cafe::7e) by DM6PR02CA0158.outlook.office365.com
 (2603:10b6:5:332::25) with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7762.29 via Frontend
 Transport; Wed, 17 Jul 2024 12:56:43 +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
 DS3PEPF000099E1.mail.protection.outlook.com (10.167.17.196) 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, 17 Jul 2024 12:56:42 +0000
Received: from drhqmail203.nvidia.com (10.126.190.182) 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, 17 Jul
 2024 05:56:32 -0700
Received: from drhqmail203.nvidia.com (10.126.190.182) by
 drhqmail203.nvidia.com (10.126.190.182) with Microsoft SMTP Server
 (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id
 15.2.1544.4; Wed, 17 Jul 2024 05:56:31 -0700
Received: from nvidia.com (10.127.8.14) by mail.nvidia.com (10.126.190.182)
 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, 17 Jul 2024 05:56:28 -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] doc: document mlx5 HWS actions order
Date: Wed, 17 Jul 2024 15:56:22 +0300
Message-ID: <20240717125622.909-1-mkashani@nvidia.com>
X-Mailer: git-send-email 2.21.0
In-Reply-To: <20240717123620.245635-1-mkashani@nvidia.com>
References: <20240717123620.245635-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: DS3PEPF000099E1:EE_|MW3PR12MB4458:EE_
X-MS-Office365-Filtering-Correlation-Id: 4c3ca26a-53e8-4031-6b92-08dca65fe851
X-MS-Exchange-SenderADCheck: 1
X-MS-Exchange-AntiSpam-Relay: 0
X-Microsoft-Antispam: BCL:0;
 ARA:13230040|36860700013|82310400026|1800799024|376014; 
X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?jxWBdLbJ9aQbgLC0r7JeNmGdELWEtOgl3bhbFUhhaTaH7o1hia65SghSwqt/?=
 =?us-ascii?Q?+hnafZQvz1os4cqqyirXNxOWHogi0OoTYMp/uBuRXhdRWusknimqT33x3QnN?=
 =?us-ascii?Q?5WMizq2wFjuQcHu67RoeXov5ygwF5ArApcswQoUGUzIfznpN5BJa42M/M///?=
 =?us-ascii?Q?c2evBbYOOZwUf6/0TF9GX325MkPYvqp9byfxKOY7jysqnkGCtxpQYrWh7JmB?=
 =?us-ascii?Q?d30V1vY0JZsKt0nfPt9CTnM35PmFzBeR7OCZivi7QnySDCoL0vEVEWngeUUo?=
 =?us-ascii?Q?QzscHtwFSd1HscVuSSQ9QrrfKyBzYvfsUaacIUO3QrCE9TjRH2UwAbIK/MNd?=
 =?us-ascii?Q?tlImTyZ/SNnS8nQuxR0RLwQQWnj+Vajp61kOUds9ApqcXStC83jZ1wNd6RKB?=
 =?us-ascii?Q?x8NWciRJhaUoUe5R5lU1Ubodg2SCfFWd05c5VxSAI18O4zB7VUTO/ZqY8NEb?=
 =?us-ascii?Q?tHirNVssZFmN13cybpPeCKPwK3hot4zJ1aJjGrddaVjGGY4l+CF71QuHXsfu?=
 =?us-ascii?Q?YxDc28deFcQ9+EqcSuwrs/6ic7g7q/+fLtlvDbxFWtGZBpCbNmd9ejK0ASGA?=
 =?us-ascii?Q?gTXmWWyurx8nL8GJguLymx6mXl7/Ws9n23Xmbwe1XR95WZESGE/YNWEX+KUn?=
 =?us-ascii?Q?QtTKWae/cZOvVFmZYF89RUY4cAk4cPFC4g59OSkEaFsGdJttzngDtgQq3Hg8?=
 =?us-ascii?Q?Ms3CnbK32fhgdFM5lSBJFQn25U/gzkRmdkHCPbXIMKJGQ7TNWbckO4fRJXSa?=
 =?us-ascii?Q?PEJg/cLCTJ8iZAmwsOKpXjoU1eZistuw8MG7QGJrIc1Y+SzaCovIKBcqPE/y?=
 =?us-ascii?Q?nme/LZGj3q6v6MyGAf6jm2QrX4uKtpQYr1z47bjeAz5cb+rVt/B8cNbycGew?=
 =?us-ascii?Q?3l71Fsjl7bXuPRsFvs4a3hpa0tP26XJAkXCOtuezDE2H0rhHM1EfDjxn04mw?=
 =?us-ascii?Q?7CVzADNjbqALtB6RxMnzKqjMWICZdUhnD92sOqQDgtKkzlZlPjFvyvBxfnKy?=
 =?us-ascii?Q?5EJNpBfYsZCyXq6iVp/2IGqF/p0+jJMdkypYBG6JWpUSV/XUWgjpHl9JAtYm?=
 =?us-ascii?Q?ihgWT2HmFOCDiFzzEbZ7ALs5hcO/b8iiEuKrXKiolrXKSKl9ra/2SUExcy1o?=
 =?us-ascii?Q?2qTZ41i+Xp7WBeraUyJwjwN27wmWlTU7kxYiPNB/Sz533IOdPN3JFwjMuvhN?=
 =?us-ascii?Q?mJWh9l8Q+e5mWTFQO+xQeRvIxhH9WAXdExpoFWkXeNgh/xvxak5C3BXM0UwB?=
 =?us-ascii?Q?v42S9kDmVlNfXKEsiG07qsApr8Wpz/8K2ulnTqp5livZlBZKnb5zsmnf0m17?=
 =?us-ascii?Q?DF1XuQzDKSpMC5iRcQ6uM8EQWMIvCEAOWR1WfrzEBkXk08tLUkYCH8rvSKeH?=
 =?us-ascii?Q?uD5y74Y3PJ/vR8clHTGXETIrFSbuRvX+BMQcCa3Za3tqOWYoFOOaHrAai+FI?=
 =?us-ascii?Q?V7PNLo51EY+rFyFzoubePCbCMcW+QFjb?=
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)(36860700013)(82310400026)(1800799024)(376014); DIR:OUT;
 SFP:1101; 
X-OriginatorOrg: Nvidia.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jul 2024 12:56:42.8115 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: 4c3ca26a-53e8-4031-6b92-08dca65fe851
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: DS3PEPF000099E1.namprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Anonymous
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW3PR12MB4458
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-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 | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index 43fc181d8dc..01f6f7aa6ab 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -251,6 +251,25 @@ 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.
+    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.25.1