Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/104676/?format=api
{ "id": 104676, "url": "http://patchwork.dpdk.org/api/patches/104676/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20211124153756.12198-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": "<20211124153756.12198-1-viacheslavo@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20211124153756.12198-1-viacheslavo@nvidia.com", "date": "2021-11-24T15:37:56", "name": "[v3] ethdev: deprecate header fields and metadata flow actions", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "027c9b9c5c19421afc4f48211ffe5893a608055c", "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/20211124153756.12198-1-viacheslavo@nvidia.com/mbox/", "series": [ { "id": 20757, "url": "http://patchwork.dpdk.org/api/series/20757/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=20757", "date": "2021-11-24T15:37:56", "name": "[v3] ethdev: deprecate header fields and metadata flow actions", "version": 3, "mbox": "http://patchwork.dpdk.org/series/20757/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/104676/comments/", "check": "fail", "checks": "http://patchwork.dpdk.org/api/patches/104676/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 BD571A0C52;\n\tWed, 24 Nov 2021 16:38:26 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 376FA426F5;\n\tWed, 24 Nov 2021 16:38:26 +0100 (CET)", "from NAM11-CO1-obe.outbound.protection.outlook.com\n (mail-co1nam11on2080.outbound.protection.outlook.com [40.107.220.80])\n by mails.dpdk.org (Postfix) with ESMTP id CD19E4117E\n for <dev@dpdk.org>; Wed, 24 Nov 2021 16:38:23 +0100 (CET)", "from DM6PR12CA0014.namprd12.prod.outlook.com (2603:10b6:5:1c0::27)\n by BN6PR12MB1569.namprd12.prod.outlook.com (2603:10b6:405:6::18) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4734.21; Wed, 24 Nov\n 2021 15:38:16 +0000", "from DM6NAM11FT017.eop-nam11.prod.protection.outlook.com\n (2603:10b6:5:1c0:cafe::fa) by DM6PR12CA0014.outlook.office365.com\n (2603:10b6:5:1c0::27) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4734.21 via Frontend\n Transport; Wed, 24 Nov 2021 15:38:16 +0000", "from mail.nvidia.com (216.228.112.34) by\n DM6NAM11FT017.mail.protection.outlook.com (10.13.172.145) 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 15:38:15 +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 15:38:11 +0000" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=UTXJS16GjEIesHA9JjPm2BEoW8BNRc2m5KHaw/fweWbR1RoUgAM6U/FwazN1ZxAqwDu4iBpF7f+KlOhnii6biTBr+XXUW7zWNfRfv/gIMdtM/x8LBVnHmbqckV0g9VdMekeCtOXuTmA/If+VV0FVNoYXZIep4XFm1q48SVAuoR8tbKXeiqKxaeY6xREFvsaKjuiOQb6SdnJOw07ft09NyPDjhuiMsaR1RYEE0EoCEPrGI6LbQoPfcs/u9On0VndG40iaL4Ep/VYFG29pkHYMNHwpTvU9Eonc0NMByd48FYS13/HxQekB2/+Hm1Jry+2wYQsvihQKUW46KBwttbM0xg==", "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=iqgGKBuGdcxVtNHXajPV2sv1VfcLMLrKwStq0nZppFs=;\n b=hNos2Ochkt8fS53pbNx7G0MCctMoDm5wdiFNyucVeHjEA0QMPVE6MgOQAXc2GRdT+dca+iqHYMFJeqqBi3Q1TCQPx5vVaHOxdujVwVkcWX0TU+Ygw3hF/IFn8CFfuTm+sz4QAgE3EPuUAlBF3PjQTAW5SbakXbOkE/Cieo1+Odx98dSDqvlhuQMIJRxbPnrxfkGqhid2tacc9sYtO5085W/WMutDlWtAjf4sS06hCatrPE8ngzn1bGUfzlzzzdB+ub+6Yz5ScsIqFaY8dmEPdjFIftzGJS3d5i3zDWQo+yvIX/0LCO2EPoLIpfB8ErTXSKgNffhKSVA9t90AxA5teg==", "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=iqgGKBuGdcxVtNHXajPV2sv1VfcLMLrKwStq0nZppFs=;\n b=k0zscaxBqyjAblsaFzIvMVdfiOOQlGYsxOFAPxqXsMFEUKTj0yoE+LEDjAYSbJh1r47XXKkMh4wEELWvcJUO34Y1miR69dginuyS9irbWeu4tHysiEm8OXqM8MwzsxutMss2jcBtcPfvgqfBiQX+McGWAWZDFzrbT7T7OJPcM8XSPkhzLh7JVgPNVe6bFPuchAcLk4t2pWIUz+ktrThANfT/Vsa1UyCvZZqwzl0uvueMWdP96DMJWxzzfLP/iVIOI+X4bJHrHTawH2Fk0BwU5/ZbNXIRX4Kr2UKH/uXpVoiHOZYGJPs+11YeRP/3FtlGtrICErRcSJqkhevASvi/zA==", "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 v3] ethdev: deprecate header fields and metadata flow actions", "Date": "Wed, 24 Nov 2021 17:37:56 +0200", "Message-ID": "<20211124153756.12198-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": "HQMAIL107.nvidia.com (172.20.187.13) To\n HQMAIL107.nvidia.com (172.20.187.13)", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-Office365-Filtering-Correlation-Id": "23f3d42d-0b12-482c-2072-08d9af606eaf", "X-MS-TrafficTypeDiagnostic": "BN6PR12MB1569:", "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr", "X-Microsoft-Antispam-PRVS": "\n <BN6PR12MB1569DEE0D7EE6A73C44C9A75DF619@BN6PR12MB1569.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 4xyTEKNUtVXwdvMMLgv/MPWkrjYOHJnlw3+3Cduf/MNUox35egyi109kJ+kQZCWmLshzERHddYosWuqyKMZ8YR6xnJWgr46JuGC4XfpjcvylaZLaGYbPZf289rGXi1MDyR2il+P5N4n7DqwrOXbYL34eb1w+uGSB+LwKvw2Yv6IPay5M5zCfQPvGo8/l7FZ7jcZlXlFqy7LI+GINM2r9kFFaEx6cX6EJWOt8Ar1VYEpuHtndG2QSp1ubD4uDRU63ncTkWVmqYj1F0GobaXIgFDbiQn1TkoTdYep4DAPQkiXpLGhQpcQNu9OUh2xoyvlVzZ5gBBlt5DjOX9uoPBtCa1ElYzY4a3yhviIavOju+zSHrB03FDtUQqUbzQxJSlDvLLBc+6wfB5BbBHVBmF6VXBAhyHc9dE2nj4XEM2RmgTRa1eV4CdA08QyqB8AyIufUVcNtjN6t5YsqFiFm7gohxi3TqFsWg5QAxZmsOZwO11VH7T01nJUOudwbywQo/NCaoqCfcZsGJbgfzG2+DfUz2N3ikMT889OAPFBwkg+NQ/D24/Cl7wyQ2WkA4BHJOEpdk2pCzY/M/1vMkPOERnRpameOLM7AlNzZCfOIM9zp8RYsgGTyC58qNT0GYhXY0Y0pl93k1u2Ay+05PfgNgfabA15LPetjlRu+jrYsn45cTAzMT5Jgdvm664AtKYDDtXCCEYvF8Qj2WZb9eYG0a07ktQ==", "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)(36840700001)(46966006)(1076003)(26005)(36860700001)(2906002)(6666004)(16526019)(186003)(86362001)(54906003)(70586007)(4326008)(5660300002)(8676002)(6286002)(8936002)(7696005)(70206006)(6916009)(426003)(55016003)(30864003)(356005)(47076005)(2616005)(83380400001)(36756003)(508600001)(336012)(82310400004)(7636003)(316002);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "Nvidia.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "24 Nov 2021 15:38:15.7348 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 23f3d42d-0b12-482c-2072-08d9af606eaf", "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 DM6NAM11FT017.eop-nam11.prod.protection.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "BN6PR12MB1569", "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": "The generic RTE_FLOW_ACTION_TYPE_MODIFY_FIELD action was\nintroduced by [1]. This action provides an 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\nRTE_FLOW_ACTION_TYPE_OF_DEC_MPLS_TTL\nRTE_FLOW_ACTION_TYPE_OF_SET_NW_TTL\nRTE_FLOW_ACTION_TYPE_OF_DEC_NW_TTL sfc\nRTE_FLOW_ACTION_TYPE_OF_COPY_TTL_OUT\nRTE_FLOW_ACTION_TYPE_OF_COPY_TTL_IN\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 cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_IPV6_DST cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_TP_SRC cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_TP_DST cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_DEC_TTL mlx5, sfc\nRTE_FLOW_ACTION_TYPE_SET_TTL mlx5\nRTE_FLOW_ACTION_TYPE_SET_MAC_SRC cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_SET_MAC_DST cxgbe, mlx5\nRTE_FLOW_ACTION_TYPE_INC_TCP_SEQ mlx5\nRTE_FLOW_ACTION_TYPE_DEC_TCP_SEQ mlx5\nRTE_FLOW_ACTION_TYPE_INC_TCP_ACK mlx5\nRTE_FLOW_ACTION_TYPE_DEC_TCP_ACK 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\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 to be just deprecated but\nnot be removed in 22.11.\n\nSigned-off-by: Viacheslav Ovsiienko <viacheslavo@nvidia.com>\n\n--\nv2 - deprecation.rst is updated\nv3 - doc comments addressed\n - commit message comments addressed\n - SET_VLAN_VID and SET_VLAN_PCP actions deprecated, but will not\n be removed in 22.11\n---\n doc/guides/prog_guide/rte_flow.rst | 26 +++++++\n doc/guides/rel_notes/deprecation.rst | 14 ++++\n lib/ethdev/rte_flow.h | 105 +++++++++++++++++++++++++++\n 3 files changed, 145 insertions(+)", "diff": "diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst\nindex 77de8da973..dbed183b6c 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. Consider `Action: MODIFY_FIELD`_.\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. Consider `Action: MODIFY_FIELD`_.\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. Consider `Action: MODIFY_FIELD`_.\n \n Implements ``OFPAT_SET_NW_TTL`` (\"IP TTL\") as defined by the `OpenFlow\n Switch Specification`_.\n@@ -2286,6 +2289,7 @@ Switch Specification`_.\n \n Action: ``OF_DEC_NW_TTL``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Implements ``OFPAT_DEC_NW_TTL`` (\"decrement IP TTL\") as defined by the\n `OpenFlow Switch Specification`_.\n@@ -2302,6 +2306,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. Consider `Action: MODIFY_FIELD`_.\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 +2324,7 @@ Specification`_.\n \n Action: ``OF_COPY_TTL_IN``\n ^^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\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@@ -2367,6 +2373,7 @@ Implements ``OFPAT_PUSH_VLAN`` (\"push a new VLAN tag\") as defined by the\n \n Action: ``OF_SET_VLAN_VID``\n ^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Implements ``OFPAT_SET_VLAN_VID`` (\"set the 802.1q VLAN id\") as defined by\n the `OpenFlow Switch Specification`_.\n@@ -2383,6 +2390,7 @@ the `OpenFlow Switch Specification`_.\n \n Action: ``OF_SET_VLAN_PCP``\n ^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Implements ``OFPAT_SET_LAN_PCP`` (\"set the 802.1q priority\") as defined by\n the `OpenFlow Switch Specification`_.\n@@ -2589,6 +2597,7 @@ valid packet.\n \n Action: ``SET_IPV4_SRC``\n ^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Set a new IPv4 source address in the outermost IPv4 header.\n \n@@ -2607,6 +2616,7 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_IPV4_DST``\n ^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Set a new IPv4 destination address in the outermost IPv4 header.\n \n@@ -2625,6 +2635,7 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_IPV6_SRC``\n ^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Set a new IPv6 source address in the outermost IPv6 header.\n \n@@ -2643,6 +2654,7 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_IPV6_DST``\n ^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Set a new IPv6 destination address in the outermost IPv6 header.\n \n@@ -2661,6 +2673,7 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_TP_SRC``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Set a new source port number in the outermost TCP/UDP header.\n \n@@ -2679,6 +2692,7 @@ 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 `Action: MODIFY_FIELD`_.\n \n Set a new destination port number in the outermost TCP/UDP header.\n \n@@ -2716,6 +2730,7 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``DEC_TTL``\n ^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Decrease TTL value.\n \n@@ -2734,6 +2749,7 @@ in pattern, Some PMDs will reject rule because behavior will be undefined.\n \n Action: ``SET_TTL``\n ^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Assigns a new TTL value.\n \n@@ -2752,6 +2768,7 @@ 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 `Action: MODIFY_FIELD`_.\n \n Set source MAC address.\n \n@@ -2770,6 +2787,7 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_MAC_DST``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Set destination MAC address.\n \n@@ -2788,6 +2806,7 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``INC_TCP_SEQ``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `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 +2815,7 @@ 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 `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 +2824,7 @@ 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 `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 +2833,7 @@ 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 `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 +2842,7 @@ Using this action on non-matching traffic will result in undefined behavior.\n \n Action: ``SET_TAG``\n ^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Set Tag.\n \n@@ -2842,6 +2865,7 @@ application. Multiple tags are supported by specifying index.\n \n Action: ``SET_META``\n ^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `Action: MODIFY_FIELD`_.\n \n Set metadata. Item ``META`` matches metadata.\n \n@@ -2876,6 +2900,7 @@ 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 `Action: MODIFY_FIELD`_.\n \n Set IPv4 DSCP.\n \n@@ -2896,6 +2921,7 @@ Otherwise, RTE_FLOW_ERROR_TYPE_ACTION error will be returned.\n \n Action: ``SET_IPV6_DSCP``\n ^^^^^^^^^^^^^^^^^^^^^^^^^\n+This action is deprecated. Consider `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..d04a606b7d 100644\n--- a/doc/guides/rel_notes/deprecation.rst\n+++ b/doc/guides/rel_notes/deprecation.rst\n@@ -101,6 +101,20 @@ 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+* ethdev: Actions ``OF_SET_VLAN_VID``, ``OF_SET_VLAN_PCP`` are deprecated\n+ as superseded by generic MODIFY_FIELD action.\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..42699b5b03 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@@ -2429,6 +2444,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_OF_PUSH_VLAN,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Implements OFPAT_SET_VLAN_VID (\"set the 802.1q VLAN ID\") as\n \t * defined by the OpenFlow Switch Specification.\n \t *\n@@ -2437,6 +2455,9 @@ enum rte_flow_action_type {\n \tRTE_FLOW_ACTION_TYPE_OF_SET_VLAN_VID,\n \n \t/**\n+\t * @deprecated\n+\t * @see RTE_FLOW_ACTION_TYPE_MODIFY_FIELD\n+\t *\n \t * Implements OFPAT_SET_LAN_PCP (\"set the 802.1q priority\") as\n \t * defined by the OpenFlow Switch Specification.\n \t *\n@@ -2509,6 +2530,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 +2543,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 +2556,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 +2569,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 +2582,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 +2596,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 +2621,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 +2631,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 +2641,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 +2654,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 +2667,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 +2684,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 +2701,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 +2718,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 +2735,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 +2748,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 +2758,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 +2771,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 +3144,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 +3157,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 +3334,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 +3352,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 +3370,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 +3388,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 +3400,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 +3412,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 +3430,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 +3457,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": [ "v3" ] }