Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/104646/?format=api
http://patchwork.dpdk.org/api/patches/104646/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20211124080610.2430-1-viacheslavo@nvidia.com/", "project": { "id": 1, "url": "http://patchwork.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20211124080610.2430-1-viacheslavo@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20211124080610.2430-1-viacheslavo@nvidia.com", "date": "2021-11-24T08:06:10", "name": "[v2] ethdev: deprecate header fields and metadata flow actions", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "8b887c1417834128d11f028640fb56c5ef4fc063", "submitter": { "id": 1926, "url": "http://patchwork.dpdk.org/api/people/1926/?format=api", "name": "Slava Ovsiienko", "email": "viacheslavo@nvidia.com" }, "delegate": { "id": 319, "url": "http://patchwork.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20211124080610.2430-1-viacheslavo@nvidia.com/mbox/", "series": [ { "id": 20730, "url": "http://patchwork.dpdk.org/api/series/20730/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=20730", "date": "2021-11-24T08:06:10", "name": "[v2] ethdev: deprecate header fields and metadata flow actions", "version": 2, "mbox": "http://patchwork.dpdk.org/series/20730/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/104646/comments/", "check": "fail", "checks": "http://patchwork.dpdk.org/api/patches/104646/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 39ADBA0C52;\n\tWed, 24 Nov 2021 09:06:31 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 22EE940DF7;\n\tWed, 24 Nov 2021 09:06:31 +0100 (CET)", "from NAM12-MW2-obe.outbound.protection.outlook.com\n (mail-mw2nam12on2063.outbound.protection.outlook.com [40.107.244.63])\n by mails.dpdk.org (Postfix) with ESMTP id 5BE9940688\n for <dev@dpdk.org>; Wed, 24 Nov 2021 09:06:29 +0100 (CET)", "from DM5PR07CA0159.namprd07.prod.outlook.com (2603:10b6:3:ee::25) by\n BN6PR12MB1346.namprd12.prod.outlook.com (2603:10b6:404:1e::16) with\n Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.4734.20; Wed, 24 Nov 2021 08:06:27 +0000", "from DM6NAM11FT037.eop-nam11.prod.protection.outlook.com\n (2603:10b6:3:ee:cafe::32) by DM5PR07CA0159.outlook.office365.com\n (2603:10b6:3:ee::25) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4713.21 via Frontend\n Transport; Wed, 24 Nov 2021 08:06:26 +0000", "from mail.nvidia.com (216.228.112.34) by\n DM6NAM11FT037.mail.protection.outlook.com (10.13.172.122) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id\n 15.20.4713.20 via Frontend Transport; Wed, 24 Nov 2021 08:06:26 +0000", "from nvidia.com (172.20.187.6) by HQMAIL107.nvidia.com\n (172.20.187.13) with Microsoft SMTP Server (TLS) id 15.0.1497.18; Wed, 24 Nov\n 2021 08:06:24 +0000" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=JkUT/mDAbfq4qRdJEIFiWv7yMGoGh3wPqOy4aGY4yylZ3ejTlQiogMwP5l08XpgPGP078h2CjHxOu7cvkAr4qpLPeB7GRwWuDSb/kjis1n2Ed+6yr0TO4zBHe1LCkA3izqgAT0XrNbgTx1H0IxDPxEQV6AWpMuFc/FHP6mReNfmEHTsrn3L7RMkDg8dGfgrflSoVlk0oF9BJ/QwXwZheJ47eTOZi+ygTUG3+e2Fovi56xShMgAs+LjjdHZE/o+zhlxyLnp7Scy27e/SLg37Ev6fB4j1UeOpXeeAZ42f+qA+2zCcbp6IJfNESFGTlrL16FkqCRWW/oOlNqQtChPQL2g==", "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n 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;\n bh=an1QMAvTKkDAcpVidFLVLHrO6xhybyvWXvnJzjtot8Y=;\n b=lUvJJ2ijwweVRF+ajTKoRU0C5ZeIlfFeyHD73oGipRO4+o57sFgLM56Tk3Con28dZR2V9J1BFqMd4dOM3htLI+wExICB0Z5kxQ4mg8jDLeujgVw/Ukn57LGztCkHl1JI0NDv6cONUmIQ/fcQNx7mVWZ87SccO5V0eznXLBG8ONRfgGAW+ZkIaON3Px/S0ifGBiXQIgG0FZbEl/WuZlRmdIJ3/KEFEsc5reAGBBv8xdg8jIt8QT4O3LK0k+3YTFt22/1FESvSi7pP9gjOeXXpdbZsfGK0Q9FjGxAlqMGUkA8kp2i0cVECX1AgI0BRAp95vkDd0gew8iPk0mHW5kFPWw==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 216.228.112.34) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com;\n dmarc=pass (p=quarantine sp=quarantine pct=100) action=none\n header.from=nvidia.com; dkim=none (message not signed); arc=none", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com;\n s=selector2;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=an1QMAvTKkDAcpVidFLVLHrO6xhybyvWXvnJzjtot8Y=;\n b=RVc/qu2Zurxr9SdnyIF9vi3q4Tvf0N/mMuWu2EKSC/iVkmUv9Bxo+COhEKSMrJ2PN2aPjQb2ySiUegHeTHQheKIBaoWyEKpHN5YnjQWZbrZ77Q1lNCw999GfIwVTLKcWLYQQtZ2FI9yqCSlSo3DE7IcTCqN+d0rVv4eplHxxDasosEo+7ameglKHhIAYSdZzppn4ExrMVSzpiz9UP2ksPWJvPIeZd2V1Q/q+TMBabkZbQ4U1Hphlg5W4tKdMxg3uVZ1+5LP6BGQ4fvfwhF1KbFLNLoqBRPUii4IiEiYlyyOWm4hsiL1GL9kSLwWHbOQMl3p0Ck5b75+s3QoUPwhPYQ==", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 216.228.112.34)\n smtp.mailfrom=nvidia.com; dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=nvidia.com;", "Received-SPF": "Pass (protection.outlook.com: domain of nvidia.com designates\n 216.228.112.34 as permitted sender) receiver=protection.outlook.com;\n client-ip=216.228.112.34; helo=mail.nvidia.com;", "From": "Viacheslav Ovsiienko <viacheslavo@nvidia.com>", "To": "<dev@dpdk.org>", "CC": "<ferruh.yigit@intel.com>, <thomas@monjalon.net>", "Subject": "[PATCH v2] ethdev: deprecate header fields and metadata flow actions", "Date": "Wed, 24 Nov 2021 10:06:10 +0200", "Message-ID": "<20211124080610.2430-1-viacheslavo@nvidia.com>", "X-Mailer": "git-send-email 2.18.1", "In-Reply-To": "<20211123075940.5521-1-viacheslavo@nvidia.com>", "References": "<20211123075940.5521-1-viacheslavo@nvidia.com>", "MIME-Version": "1.0", "Content-Type": "text/plain", "X-Originating-IP": "[172.20.187.6]", "X-ClientProxiedBy": "HQMAIL101.nvidia.com (172.20.187.10) To\n HQMAIL107.nvidia.com (172.20.187.13)", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-Office365-Filtering-Correlation-Id": "914220ba-05d6-4902-8fa6-08d9af21503a", "X-MS-TrafficTypeDiagnostic": "BN6PR12MB1346:", "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr", "X-Microsoft-Antispam-PRVS": "\n <BN6PR12MB1346CA1762E004B0635F8CD9DF619@BN6PR12MB1346.namprd12.prod.outlook.com>", "X-MS-Oob-TLC-OOBClassifiers": "OLM:1122;", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "\n 4BF7PvLnrN+cI/UD9H3cENEmmcvrkRbY7gWGXJLTUi7h0SNZvEcLp/NltOEXxnMLLD0USHrxX1afcF9Y9ujLBDVj2zMX3A4Kv0HvAZQT8bqAdLzHEhgwc51B6FmADX7sdBLF0Ogvj2Y/rdUgIx93Dm/FygBUaB3PEgOSs11hfP/CUgw3+SrSB8rD+5Ad7eAci/TUpbwMPQyC9bQDVoT4OZprk4TX9hZM0AX9ETAfnl8dulFKPLsuvkPkTraegldKTeTUteH2PnbF4EKMtPIn8AA5Dk9KAhv/MM5v0nFKDkRgI+idFLw2zsVGXaajLZlSewW+fwbKAAXE6tPD70nk4rOuPF/k3OveDORrGeqeUY7hIllwL9VnSnPsZZFWMnHMsWrKvOwWQlzBbbbkKVyBYFQ02jTri5wFQWW65OL+v1w+ax2O8XXPYe/18NQ5DkQU78P9nOZNh/uQyRRHrRXzxmd/iZwY2fUtgs9exzmwaR5YzQbL9ODguPgSwrH9uTbvdbVHQA6a8AMvozh3w/kKBjRnqZ6JlbPPHkh1csov7NTLfMnJFew/BweF3Jh695csubM2Z/AErrszI4aTPKlCogCGdA5Xxu7c2TCFzLIPIZbilqMyJ8kSPIEa2on7DpOTuiZ+yfJCEdBoAeNUf8jLUf7LRrGq/AnfoRodKRGP8AyUeXzXz9IUDyDomxfkGcwqvgJrZnHwnfQKDW27ZiQCCQ==", "X-Forefront-Antispam-Report": "CIP:216.228.112.34; CTRY:US; LANG:en; SCL:1;\n SRV:;\n IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:schybrid03.nvidia.com; CAT:NONE;\n SFS:(4636009)(46966006)(36840700001)(26005)(336012)(55016003)(1076003)(4326008)(8936002)(6916009)(508600001)(16526019)(426003)(6666004)(36860700001)(2906002)(7636003)(2616005)(82310400004)(356005)(5660300002)(54906003)(7696005)(8676002)(30864003)(47076005)(86362001)(70206006)(316002)(186003)(70586007)(83380400001)(6286002)(36756003);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "Nvidia.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "24 Nov 2021 08:06:26.3003 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 914220ba-05d6-4902-8fa6-08d9af21503a", "X-MS-Exchange-CrossTenant-Id": "43083d15-7273-40c1-b7db-39efd9ccc17a", "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.112.34];\n Helo=[mail.nvidia.com]", "X-MS-Exchange-CrossTenant-AuthSource": "\n DM6NAM11FT037.eop-nam11.prod.protection.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "BN6PR12MB1346", "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>,\n <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>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "There generic RTE_FLOW_ACTION_TYPE_MODIFY_FIELD action was\nintroduced by [1]. This action provides the unified way\nto perform various arithmetic and transfer operations over\npacket network header fields and packet metadata.\n\n[1] commit 641dbe4fb053 (\"net/mlx5: support modify field flow action\")\n\nOn other side there are a bunch of multiple legacy actions,\nthat can be superseded by the generic modify field action:\n\nRTE_FLOW_ACTION_TYPE_OF_SET_MPLS_TTL bnxt*\nRTE_FLOW_ACTION_TYPE_OF_DEC_MPLS_TTL bnxt*\nRTE_FLOW_ACTION_TYPE_OF_SET_NW_TTL bnxt*\nRTE_FLOW_ACTION_TYPE_OF_DEC_NW_TTL bnxt*, sfc\nRTE_FLOW_ACTION_TYPE_OF_COPY_TTL_OUT bnxt*\nRTE_FLOW_ACTION_TYPE_OF_COPY_TTL_IN bnxt*\nRTE_FLOW_ACTION_TYPE_SET_IPV4_SRC bnxt, cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_IPV4_DST bnxt, cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_IPV6_SRC bnxt*, cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_IPV6_DST bnxt*, cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_TP_SRC bnxt, cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_TP_DST bnxt, cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_DEC_TTL bnxt, mlx5, sfc\nRTE_FLOW_ACTION_TYPE_SET_TTL bnxt*, mlx5\nRTE_FLOW_ACTION_TYPE_SET_MAC_SRC bnxt*, cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_MAC_DST bnxt*, cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_INC_TCP_SEQ bnxt*, mlx5\nRTE_FLOW_ACTION_TYPE_DEC_TCP_SEQ bnxt*, mlx5\nRTE_FLOW_ACTION_TYPE_INC_TCP_ACK bnxt*, mlx5\nRTE_FLOW_ACTION_TYPE_DEC_TCP_ACK bnxt*, mlx5\nRTE_FLOW_ACTION_TYPE_SET_IPV4_DSCP mlx5\nRTE_FLOW_ACTION_TYPE_SET_IPV6_DSCP mlx5\nRTE_FLOW_ACTION_TYPE_OF_SET_VLAN_VID bnxt, cnxk, cxgbe, enic,\n mlx5, octeontx2, sfc\nRTE_FLOW_ACTION_TYPE_OF_SET_VLAN_PCP bnxt, cnxk, cxgbe, enic,\n mlx5, octeontx2, sfc\nRTE_FLOW_ACTION_TYPE_SET_TAG mlx5\nRTE_FLOW_ACTION_TYPE_SET_META mlx5\n\n[bnxt*] means the PMD source code references the action, but there\n is no support implemented (actions rejected with ENOTSUP error)\n\nThis note deprecates the following RTE Flow actions:\n1. As not supported by any of PMDs:\n\nRTE_FLOW_ACTION_TYPE_OF_SET_MPLS_TTL\nRTE_FLOW_ACTION_TYPE_OF_DEC_MPLS_TTL\nRTE_FLOW_ACTION_TYPE_OF_SET_NW_TTL\nRTE_FLOW_ACTION_TYPE_OF_COPY_TTL_OUT\nRTE_FLOW_ACTION_TYPE_OF_COPY_TTL_IN\n\n2. As supposed to be replaced by generig field modify action:\nRTE_FLOW_ACTION_TYPE_OF_DEC_NW_TTL\nRTE_FLOW_ACTION_TYPE_SET_IPV4_SRC\nRTE_FLOW_ACTION_TYPE_SET_IPV4_DST\nRTE_FLOW_ACTION_TYPE_SET_IPV6_SRC\nRTE_FLOW_ACTION_TYPE_SET_IPV6_DST\nRTE_FLOW_ACTION_TYPE_SET_TP_SRC\nRTE_FLOW_ACTION_TYPE_SET_TP_DST\nRTE_FLOW_ACTION_TYPE_DEC_TTL\nRTE_FLOW_ACTION_TYPE_SET_TTL\nRTE_FLOW_ACTION_TYPE_SET_MAC_SRC\nRTE_FLOW_ACTION_TYPE_SET_MAC_DST\nRTE_FLOW_ACTION_TYPE_INC_TCP_SEQ\nRTE_FLOW_ACTION_TYPE_DEC_TCP_SEQ\nRTE_FLOW_ACTION_TYPE_INC_TCP_ACK\nRTE_FLOW_ACTION_TYPE_DEC_TCP_ACK\nRTE_FLOW_ACTION_TYPE_SET_IPV4_DSCP\nRTE_FLOW_ACTION_TYPE_SET_IPV6_DSCP\nRTE_FLOW_ACTION_TYPE_SET_TAG\nRTE_FLOW_ACTION_TYPE_SET_META\n\nThe VLAN set actions are interrelated to VLAN header insertion/removal\nand supported by multiple PMDs and supposed not to be deprecated.\n\nSigned-off-by: Viacheslav Ovsiienko <viacheslavo@nvidia.com>\n\n--\nv2 deprecation.rst is updated\n---\n doc/guides/prog_guide/rte_flow.rst | 43 ++++++++++++\n doc/guides/rel_notes/deprecation.rst | 11 ++++\n lib/ethdev/rte_flow.h | 99 ++++++++++++++++++++++++++++\n 3 files changed, 153 insertions(+)", "diff": "diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst\nindex 77de8da973..37321de14f 100644\n--- a/doc/guides/prog_guide/rte_flow.rst\n+++ b/doc/guides/prog_guide/rte_flow.rst\n@@ -2238,6 +2238,7 @@ fields in the pattern items.\n \n Action: ``OF_SET_MPLS_TTL``\n ^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated as there are no PMDs supporting this.\n \n Implements ``OFPAT_SET_MPLS_TTL`` (\"MPLS TTL\") as defined by the `OpenFlow\n Switch Specification`_.\n@@ -2254,6 +2255,7 @@ Switch Specification`_.\n \n Action: ``OF_DEC_MPLS_TTL``\n ^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated as there are no PMDs supporting this.\n \n Implements ``OFPAT_DEC_MPLS_TTL`` (\"decrement MPLS TTL\") as defined by the\n `OpenFlow Switch Specification`_.\n@@ -2270,6 +2272,7 @@ Implements ``OFPAT_DEC_MPLS_TTL`` (\"decrement MPLS TTL\") as defined by the\n \n Action: ``OF_SET_NW_TTL``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated as there are no PMDs supporting this.\n \n Implements ``OFPAT_SET_NW_TTL`` (\"IP TTL\") as defined by the `OpenFlow\n Switch Specification`_.\n@@ -2286,6 +2289,8 @@ Switch Specification`_.\n \n Action: ``OF_DEC_NW_TTL``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Implements ``OFPAT_DEC_NW_TTL`` (\"decrement IP TTL\") as defined by the\n `OpenFlow Switch Specification`_.\n@@ -2302,6 +2307,7 @@ Implements ``OFPAT_DEC_NW_TTL`` (\"decrement IP TTL\") as defined by the\n \n Action: ``OF_COPY_TTL_OUT``\n ^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated as there are no PMDs supporting this.\n \n Implements ``OFPAT_COPY_TTL_OUT`` (\"copy TTL \"outwards\" -- from\n next-to-outermost to outermost\") as defined by the `OpenFlow Switch\n@@ -2319,6 +2325,7 @@ Specification`_.\n \n Action: ``OF_COPY_TTL_IN``\n ^^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated as there are no PMDs supporting this.\n \n Implements ``OFPAT_COPY_TTL_IN`` (\"copy TTL \"inwards\" -- from outermost to\n next-to-outermost\") as defined by the `OpenFlow Switch Specification`_.\n@@ -2589,6 +2596,8 @@ valid packet.\n \n Action: ``SET_IPV4_SRC``\n ^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set a new IPv4 source address in the outermost IPv4 header.\n \n@@ -2607,6 +2616,8 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_IPV4_DST``\n ^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set a new IPv4 destination address in the outermost IPv4 header.\n \n@@ -2625,6 +2636,8 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_IPV6_SRC``\n ^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set a new IPv6 source address in the outermost IPv6 header.\n \n@@ -2643,6 +2656,8 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_IPV6_DST``\n ^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set a new IPv6 destination address in the outermost IPv6 header.\n \n@@ -2661,6 +2676,8 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_TP_SRC``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set a new source port number in the outermost TCP/UDP header.\n \n@@ -2679,6 +2696,8 @@ flow pattern item. Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_TP_DST``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set a new destination port number in the outermost TCP/UDP header.\n \n@@ -2716,6 +2735,8 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``DEC_TTL``\n ^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Decrease TTL value.\n \n@@ -2734,6 +2755,8 @@ in pattern, Some PMDs will reject rule because behavior will be undefined.\n \n Action: ``SET_TTL``\n ^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Assigns a new TTL value.\n \n@@ -2752,6 +2775,8 @@ in pattern, Some PMDs will reject rule because behavior will be undefined.\n \n Action: ``SET_MAC_SRC``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set source MAC address.\n \n@@ -2770,6 +2795,8 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_MAC_DST``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set destination MAC address.\n \n@@ -2788,6 +2815,8 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``INC_TCP_SEQ``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Increase sequence number in the outermost TCP header.\n Value to increase TCP sequence number by is a big-endian 32 bit integer.\n@@ -2796,6 +2825,8 @@ Using this action on non-matching traffic will result in undefined behavior.\n \n Action: ``DEC_TCP_SEQ``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Decrease sequence number in the outermost TCP header.\n Value to decrease TCP sequence number by is a big-endian 32 bit integer.\n@@ -2804,6 +2835,8 @@ Using this action on non-matching traffic will result in undefined behavior.\n \n Action: ``INC_TCP_ACK``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Increase acknowledgment number in the outermost TCP header.\n Value to increase TCP acknowledgment number by is a big-endian 32 bit integer.\n@@ -2812,6 +2845,8 @@ Using this action on non-matching traffic will result in undefined behavior.\n \n Action: ``DEC_TCP_ACK``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Decrease acknowledgment number in the outermost TCP header.\n Value to decrease TCP acknowledgment number by is a big-endian 32 bit integer.\n@@ -2820,6 +2855,8 @@ Using this action on non-matching traffic will result in undefined behavior.\n \n Action: ``SET_TAG``\n ^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set Tag.\n \n@@ -2842,6 +2879,8 @@ application. Multiple tags are supported by specifying index.\n \n Action: ``SET_META``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set metadata. Item ``META`` matches metadata.\n \n@@ -2876,6 +2915,8 @@ used to connect the Rx and Tx flows if it can be propagated from Rx to Tx path.\n \n Action: ``SET_IPV4_DSCP``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set IPv4 DSCP.\n \n@@ -2896,6 +2937,8 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_IPV6_DSCP``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider:\n+ - `Action: MODIFY_FIELD`_\n \n Set IPv6 DSCP.\n \ndiff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst\nindex 6d087c64ef..8ee284ee61 100644\n--- a/doc/guides/rel_notes/deprecation.rst\n+++ b/doc/guides/rel_notes/deprecation.rst\n@@ -101,6 +101,17 @@ Deprecation Notices\n is deprecated as ambiguous with respect to the embedded switch. The use of\n these attributes will become invalid starting from DPDK 22.11.\n \n+* ethdev: Actions ``OF_SET_MPLS_TTL``, ``OF_DEC_MPLS_TTL``, ``OF_SET_NW_TTL``,\n+ ``OF_COPY_TTL_OUT``, ``OF_COPY_TTL_IN`` are deprecated as not supported by\n+ PMDs, will be removed in DPDK 22.11.\n+\n+* ethdev: Actions ``OF_DEC_NW_TTL``, ``SET_IPV4_SRC``, ``SET_IPV4_DST``,\n+ ``SET_IPV6_SRC``, ``SET_IPV6_DST``, ``SET_TP_SRC``, ``SET_TP_DST``,\n+ ``DEC_TTL``, ``SET_TTL``, ``SET_MAC_SRC``, ``SET_MAC_DST``, ``INC_TCP_SEQ``,\n+ ``DEC_TCP_SEQ``, ``INC_TCP_ACK``, ``DEC_TCP_ACK``, ``SET_IPV4_DSCP``,\n+ ``SET_IPV6_DSCP``, ``SET_TAG``, ``SET_META`` are deprecated as superseded\n+ by generic MODIFY_FIELD action, will be removed in DPDK 22.11.\n+\n * cryptodev: Hide structures ``rte_cryptodev_sym_session`` and\n ``rte_cryptodev_asym_session`` to remove unnecessary indirection between\n session and the private data of session. An opaque pointer can be exposed\ndiff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h\nindex 650376c16d..267c11b332 100644\n--- a/lib/ethdev/rte_flow.h\n+++ b/lib/ethdev/rte_flow.h\n@@ -2363,6 +2363,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SECURITY,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Implements OFPAT_SET_MPLS_TTL (\"MPLS TTL\") as defined by the\n \t * OpenFlow Switch Specification.\n \t *\n@@ -2371,6 +2374,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_OF_SET_MPLS_TTL,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Implements OFPAT_DEC_MPLS_TTL (\"decrement MPLS TTL\") as defined\n \t * by the OpenFlow Switch Specification.\n \t *\n@@ -2379,6 +2385,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_OF_DEC_MPLS_TTL,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Implements OFPAT_SET_NW_TTL (\"IP TTL\") as defined by the OpenFlow\n \t * Switch Specification.\n \t *\n@@ -2395,6 +2404,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_OF_DEC_NW_TTL,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Implements OFPAT_COPY_TTL_OUT (\"copy TTL \"outwards\" -- from\n \t * next-to-outermost to outermost\") as defined by the OpenFlow\n \t * Switch Specification.\n@@ -2404,6 +2416,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_OF_COPY_TTL_OUT,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Implements OFPAT_COPY_TTL_IN (\"copy TTL \"inwards\" -- from\n \t * outermost to next-to-outermost\") as defined by the OpenFlow\n \t * Switch Specification.\n@@ -2509,6 +2524,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_RAW_DECAP,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Modify IPv4 source address in the outermost IPv4 header.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV4,\n@@ -2519,6 +2537,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_IPV4_SRC,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Modify IPv4 destination address in the outermost IPv4 header.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV4,\n@@ -2529,6 +2550,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_IPV4_DST,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Modify IPv6 source address in the outermost IPv6 header.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV6,\n@@ -2539,6 +2563,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_IPV6_SRC,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Modify IPv6 destination address in the outermost IPv6 header.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV6,\n@@ -2549,6 +2576,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_IPV6_DST,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Modify source port number in the outermost TCP/UDP header.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_TCP\n@@ -2560,6 +2590,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_TP_SRC,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Modify destination port number in the outermost TCP/UDP header.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_TCP\n@@ -2582,6 +2615,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_MAC_SWAP,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Decrease TTL value directly\n \t *\n \t * No associated configuration structure.\n@@ -2589,6 +2625,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_DEC_TTL,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Set TTL value\n \t *\n \t * See struct rte_flow_action_set_ttl\n@@ -2596,6 +2635,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_TTL,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Set source MAC address from matched flow.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_ETH,\n@@ -2606,6 +2648,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_MAC_SRC,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Set destination MAC address from matched flow.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_ETH,\n@@ -2616,6 +2661,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_MAC_DST,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Increase sequence number in the outermost TCP header.\n \t *\n \t * Action configuration specifies the value to increase\n@@ -2630,6 +2678,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_INC_TCP_SEQ,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Decrease sequence number in the outermost TCP header.\n \t *\n \t * Action configuration specifies the value to decrease\n@@ -2644,6 +2695,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_DEC_TCP_SEQ,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Increase acknowledgment number in the outermost TCP header.\n \t *\n \t * Action configuration specifies the value to increase\n@@ -2658,6 +2712,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_INC_TCP_ACK,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Decrease acknowledgment number in the outermost TCP header.\n \t *\n \t * Action configuration specifies the value to decrease\n@@ -2672,6 +2729,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_DEC_TCP_ACK,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Set Tag.\n \t *\n \t * Tag is for internal flow usage only and\n@@ -2682,6 +2742,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_TAG,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Set metadata on ingress or egress path.\n \t *\n \t * See struct rte_flow_action_set_meta.\n@@ -2689,6 +2752,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_META,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Modify IPv4 DSCP in the outermost IP header.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV4,\n@@ -2699,6 +2765,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_SET_IPV4_DSCP,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Modify IPv6 DSCP in the outermost IP header.\n \t *\n \t * If flow pattern does not define a valid RTE_FLOW_ITEM_TYPE_IPV6,\n@@ -3069,6 +3138,9 @@ struct rte_flow_action_security {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * RTE_FLOW_ACTION_TYPE_OF_SET_MPLS_TTL\n *\n * Implements OFPAT_SET_MPLS_TTL (\"MPLS TTL\") as defined by the OpenFlow\n@@ -3079,6 +3151,9 @@ struct rte_flow_action_of_set_mpls_ttl {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * RTE_FLOW_ACTION_TYPE_OF_SET_NW_TTL\n *\n * Implements OFPAT_SET_NW_TTL (\"IP TTL\") as defined by the OpenFlow Switch\n@@ -3253,6 +3328,9 @@ struct rte_flow_action_raw_decap {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * @warning\n * @b EXPERIMENTAL: this structure may change without prior notice\n *\n@@ -3268,6 +3346,9 @@ struct rte_flow_action_set_ipv4 {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * @warning\n * @b EXPERIMENTAL: this structure may change without prior notice\n *\n@@ -3283,6 +3364,9 @@ struct rte_flow_action_set_ipv6 {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * @warning\n * @b EXPERIMENTAL: this structure may change without prior notice\n *\n@@ -3298,6 +3382,9 @@ struct rte_flow_action_set_tp {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * RTE_FLOW_ACTION_TYPE_SET_TTL\n *\n * Set the TTL value directly for IPv4 or IPv6\n@@ -3307,6 +3394,9 @@ struct rte_flow_action_set_ttl {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * RTE_FLOW_ACTION_TYPE_SET_MAC\n *\n * Set MAC address from the matched flow\n@@ -3316,6 +3406,9 @@ struct rte_flow_action_set_mac {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * @warning\n * @b EXPERIMENTAL: this structure may change without prior notice\n *\n@@ -3331,6 +3424,9 @@ struct rte_flow_action_set_tag {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * @warning\n * @b EXPERIMENTAL: this structure may change without prior notice\n *\n@@ -3355,6 +3451,9 @@ struct rte_flow_action_set_meta {\n };\n \n /**\n+ * @deprecated\n+ * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+ *\n * RTE_FLOW_ACTION_TYPE_SET_IPV4_DSCP\n * RTE_FLOW_ACTION_TYPE_SET_IPV6_DSCP\n *\n", "prefixes": [ "v2" ] }{ "id": 104646, "url": "