Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/134735/?format=api
{ "id": 134735, "url": "https://patches.dpdk.org/api/patches/134735/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/20231130163215.666239-2-michaelba@nvidia.com/", "project": { "id": 1, "url": "https://patches.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": "<20231130163215.666239-2-michaelba@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20231130163215.666239-2-michaelba@nvidia.com", "date": "2023-11-30T16:32:14", "name": "[v3,1/2] ethdev: add random item support", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "e6515841fbc8ea502c72a6baadfb6c3869000f5b", "submitter": { "id": 1949, "url": "https://patches.dpdk.org/api/people/1949/?format=api", "name": "Michael Baum", "email": "michaelba@nvidia.com" }, "delegate": { "id": 319, "url": "https://patches.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "https://patches.dpdk.org/project/dpdk/patch/20231130163215.666239-2-michaelba@nvidia.com/mbox/", "series": [ { "id": 30424, "url": "https://patches.dpdk.org/api/series/30424/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=30424", "date": "2023-11-30T16:32:13", "name": "ethdev: add random item support", "version": 3, "mbox": "https://patches.dpdk.org/series/30424/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/134735/comments/", "check": "success", "checks": "https://patches.dpdk.org/api/patches/134735/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 A1F7D43412;\n\tThu, 30 Nov 2023 17:32:52 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 7291542EEF;\n\tThu, 30 Nov 2023 17:32:48 +0100 (CET)", "from NAM12-BN8-obe.outbound.protection.outlook.com\n (mail-bn8nam12on2085.outbound.protection.outlook.com [40.107.237.85])\n by mails.dpdk.org (Postfix) with ESMTP id 6F64C42DA1\n for <dev@dpdk.org>; Thu, 30 Nov 2023 17:32:46 +0100 (CET)", "from BL1PR13CA0211.namprd13.prod.outlook.com (2603:10b6:208:2bf::6)\n by PH7PR12MB6393.namprd12.prod.outlook.com (2603:10b6:510:1ff::15)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7046.22; Thu, 30 Nov\n 2023 16:32:43 +0000", "from BL6PEPF0001AB75.namprd02.prod.outlook.com\n (2603:10b6:208:2bf:cafe::ea) by BL1PR13CA0211.outlook.office365.com\n (2603:10b6:208:2bf::6) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7046.22 via Frontend\n Transport; Thu, 30 Nov 2023 16:32:43 +0000", "from mail.nvidia.com (216.228.117.160) by\n BL6PEPF0001AB75.mail.protection.outlook.com (10.167.242.168) with Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.7046.17 via Frontend Transport; Thu, 30 Nov 2023 16:32:42 +0000", "from rnnvmail204.nvidia.com (10.129.68.6) by mail.nvidia.com\n (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.41; Thu, 30 Nov\n 2023 08:32:24 -0800", "from rnnvmail204.nvidia.com (10.129.68.6) by rnnvmail204.nvidia.com\n (10.129.68.6) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.41; Thu, 30 Nov\n 2023 08:32:24 -0800", "from nvidia.com (10.127.8.13) by mail.nvidia.com (10.129.68.6) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.41 via Frontend\n Transport; Thu, 30 Nov 2023 08:32:22 -0800" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=acij5QCoOooKzctiB3lF60UvtmSKkBMOp5ItxmSMW3ZZSTFP0BeuQGQUkaBcx8O5E8i9v/QpwonfgQQLYwAJAkdgm+X+7Ty97UCb+B6tRBt/EXd7Xd3CvCDTn6pYa55RhPqQptQZCCYLVwTlAU5Ay2k5O1+/MnbSs2z3RSDlbpVqq2zEDWtGV7gzD2/afWeuTm7T4UeO5CC+YzvB95PaxYU1skk7qtg6CeYpysLu9lvPBEFEUlo0ugmB/u41XxtyRHOXlUrzZAqjYQ1WMnby9dcryZVjPaTL0Aicjkh9CfzT7DBf8rxcdXKZuMKnTqYWfLuO2eo9RmsL7yXswUmE8A==", "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=ViDFTBi6rZPsG9NY/hE2mO0MinW3AnOn42yRtXxPmZc=;\n b=JRULbJ23ToeA9iDI9aZFUatjv3RJEYWH6jwSyVEsA5vOm6TSl89n+433img/dsl3ZTM1fTFkSI1XXmjpXy6RQJn+EgYlbPg0JkOUCHocHuRJKlNnQsKl/NZ4X3RxAuIe0VV4WAQB49dK3Mb4XfDYmQ5HJY7atKq45T9a8uMyw0WZvMmvkEgVp//Nw2quu1FYJCbBrGhBKcmCQeHhDwbZb5dOuXOHTf98/BbU1FizX9Ai8bm9Vd1kO8ME9XuCSUZ/JVFqrCShl71+usthk/ENnzuZv++rWqzpvvIeWCA3aWkuASeSK4OInjztQ5Wjv0yJtJ9K6Ic7WPxaH3evBmyw+w==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 216.228.117.160) smtp.rcpttodomain=dpdk.org smtp.mailfrom=nvidia.com;\n dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com;\n dkim=none (message not signed); arc=none (0)", "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=ViDFTBi6rZPsG9NY/hE2mO0MinW3AnOn42yRtXxPmZc=;\n b=PVXqOZguMCZN/F96NVprDvceN713eqeVjEIYyfknutDWIkl5NJD1fahNO/T+jd/37DkL/mmvChcJPJ6BQjksLqBY0AKHGYLK2rKhsEG//MPBpDWUcKxk18JNjgTpK5TwoxGnqFB21zJJFEqMeip3bra6IARNKZuUCzGdBMcNc/jq3yS2K7tXU5H3hkw8up7N+hxpXaRL17tvT88pvEqOVxpunVR/C0xUH9a2wE9xq6pDAkkfHn78AdVPyUJK5dyI0RxkhvzAEXUzDkp4h+ATnI24xJcwtjbHBmNBAnv3IwOz3DZ6ZumOIgyU9sylQbcMjxqBlElZpZ2IkLTCuI0DYA==", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 216.228.117.160)\n smtp.mailfrom=nvidia.com;\n 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.117.160 as permitted sender) receiver=protection.outlook.com;\n client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C", "From": "Michael Baum <michaelba@nvidia.com>", "To": "<dev@dpdk.org>", "CC": "Ori Kam <orika@nvidia.com>, Aman Singh <aman.deep.singh@intel.com>,\n \"Yuying Zhang\" <yuying.zhang@intel.com>, Ferruh Yigit <ferruh.yigit@amd.com>,\n \"Thomas Monjalon\" <thomas@monjalon.net>", "Subject": "[PATCH v3 1/2] ethdev: add random item support", "Date": "Thu, 30 Nov 2023 18:32:14 +0200", "Message-ID": "<20231130163215.666239-2-michaelba@nvidia.com>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20231130163215.666239-1-michaelba@nvidia.com>", "References": "<20230911074149.697944-1-michaelba@nvidia.com>\n <20231130163215.666239-1-michaelba@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": "BL6PEPF0001AB75:EE_|PH7PR12MB6393:EE_", "X-MS-Office365-Filtering-Correlation-Id": "c0d670f6-93c9-4c2d-89ff-08dbf1c1fa16", "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "\n nW+SxBhq4QQdmCoF0vaDD0u8nzxeX23Lv3F1FMTAdtr/UKQ2DkdsjATTgidK09I+6lXl8LAZI4GdNfSPT1Xf1KYZDOtAV6H8QYNrFA5bLyg515hIlM508tuyS2V7TqkytyNeom+/qT9YF+BLahbwotKytx5R9IOO1zSbnZpnrKcezaTZ6iLCDl/X13w6Ni3zb7XmwP1RilsjMU4ZKaQvSGmKrlt+Nc6OEg5lQEhwLfwASdq/2aAJ2XHh43uTOcU8gC8cS0qqX+gl3054yRuNVK2gtEbViDi3wm/FKFmcukUp5AAOhfE21WyFGCY2E/zfVCLn4JDrk6qBN7VfYTtc9A1DetoqYgL4w7Q9/oP4FMaMs/qHHecBk9ZOpt63l+Es4ObkvjcF/f4Ju+rUfjLgq26P9dqiiMwoT5t3qzG5XedH8YZhdbBGouQ4VmPthQVKpJoAQ5NRv28iHrP/ZKPoLsL6afZKn/Z8WaF+rgiTlQI8OwAHajG2fJmUhdB90DtENaA3iv3Fb7113eDpz9TsXJeEVo8jli5K/qMMMgtjWcs9FkaMn1BZJpBJumI33kS7eMnyuGa1kRh9Or/9rTPEKhUipOepIfuOJrh0eVz/G4EvpWmqkjknN2hQ+Tdu71om7bhGeuzrwXz+IQW+/4c6pTSfKWJ4i6CyfT/KB2PhYn5eQ/T8bZZhQZPbAwk7s6NREXouwDsJGD1HzAkYmAFVAPy+vzOLPUORYH/oB0ZE6rD8/BG+iuPb2tKVIUmabnjmHB9hhJvnrZXu6g6YmKRWuA==", "X-Forefront-Antispam-Report": "CIP:216.228.117.160; CTRY:US; LANG:en; SCL:1;\n SRV:;\n IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE;\n SFS:(13230031)(4636009)(39860400002)(346002)(136003)(376002)(396003)(230922051799003)(230273577357003)(230173577357003)(186009)(64100799003)(82310400011)(1800799012)(451199024)(46966006)(36840700001)(40470700004)(478600001)(6666004)(40460700003)(2616005)(26005)(356005)(6286002)(426003)(82740400003)(1076003)(336012)(36860700001)(5660300002)(2906002)(70206006)(8676002)(8936002)(70586007)(54906003)(6916009)(4326008)(316002)(83380400001)(7636003)(41300700001)(36756003)(7696005)(47076005)(86362001)(55016003)(40480700001);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "Nvidia.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "30 Nov 2023 16:32:42.7945 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n c0d670f6-93c9-4c2d-89ff-08dbf1c1fa16", "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.117.160];\n Helo=[mail.nvidia.com]", "X-MS-Exchange-CrossTenant-AuthSource": "\n BL6PEPF0001AB75.namprd02.prod.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "PH7PR12MB6393", "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": "Add support for a new item type \"RTE_FLOW_ITEM_TYPE_RANDOM\".\nThis item enables to match on some random value as a part of flow rule.\n\nSigned-off-by: Michael Baum <michaelba@nvidia.com>\n---\n doc/guides/nics/features/default.ini | 1 +\n doc/guides/prog_guide/rte_flow.rst | 13 ++++++++++\n doc/guides/rel_notes/release_24_03.rst | 4 +++\n lib/ethdev/rte_flow.c | 1 +\n lib/ethdev/rte_flow.h | 35 +++++++++++++++++++++++++-\n 5 files changed, 53 insertions(+), 1 deletion(-)", "diff": "diff --git a/doc/guides/nics/features/default.ini b/doc/guides/nics/features/default.ini\nindex 806cb033ff..6d50236292 100644\n--- a/doc/guides/nics/features/default.ini\n+++ b/doc/guides/nics/features/default.ini\n@@ -140,6 +140,7 @@ pppoe_proto_id =\n ptype =\n quota =\n raw =\n+random =\n represented_port =\n sctp =\n tag =\ndiff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst\nindex 627b845bfb..fd7fddb6cd 100644\n--- a/doc/guides/prog_guide/rte_flow.rst\n+++ b/doc/guides/prog_guide/rte_flow.rst\n@@ -1573,6 +1573,19 @@ Matches the packet type as defined in rte_mbuf_ptype.\n \n - ``packet_type``: L2/L3/L4 and tunnel information.\n \n+Item: ``RANDOM``\n+^^^^^^^^^^^^^^^^\n+\n+Matches a random value.\n+\n+The rundom number is generated by PMD,\n+application can match on either exact value or range of values.\n+This value is not based on the packet data/headers.\n+Application shouldn't assume that this value is kept during the life time of\n+the packet.\n+\n+- ``value``: Specific value to match.\n+\n Actions\n ~~~~~~~\n \ndiff --git a/doc/guides/rel_notes/release_24_03.rst b/doc/guides/rel_notes/release_24_03.rst\nindex e9c9717706..ab91ce2b21 100644\n--- a/doc/guides/rel_notes/release_24_03.rst\n+++ b/doc/guides/rel_notes/release_24_03.rst\n@@ -55,6 +55,10 @@ New Features\n Also, make sure to start the actual text at the margin.\n =======================================================\n \n+* **Added flow matching of random value.**\n+\n+ Added ``RTE_FLOW_ITEM_RANDOM`` to match random value.\n+\n \n Removed Items\n -------------\ndiff --git a/lib/ethdev/rte_flow.c b/lib/ethdev/rte_flow.c\nindex 549e329558..090b936ca9 100644\n--- a/lib/ethdev/rte_flow.c\n+++ b/lib/ethdev/rte_flow.c\n@@ -136,6 +136,7 @@ static const struct rte_flow_desc_data rte_flow_desc_item[] = {\n \t\t sizeof(struct rte_flow_item_icmp6_nd_opt_tla_eth)),\n \tMK_FLOW_ITEM(MARK, sizeof(struct rte_flow_item_mark)),\n \tMK_FLOW_ITEM(META, sizeof(struct rte_flow_item_meta)),\n+\tMK_FLOW_ITEM(RANDOM, sizeof(struct rte_flow_item_random)),\n \tMK_FLOW_ITEM(TAG, sizeof(struct rte_flow_item_tag)),\n \tMK_FLOW_ITEM(GRE_KEY, sizeof(rte_be32_t)),\n \tMK_FLOW_ITEM(GRE_OPTION, sizeof(struct rte_flow_item_gre_opt)),\ndiff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h\nindex affdc8121b..887401bb86 100644\n--- a/lib/ethdev/rte_flow.h\n+++ b/lib/ethdev/rte_flow.h\n@@ -704,6 +704,19 @@ enum rte_flow_item_type {\n \t *\n \t */\n \tRTE_FLOW_ITEM_TYPE_PTYPE,\n+\n+\t/**\n+\t * [META]\n+\t *\n+\t * Matches a random value.\n+\t *\n+\t * This value is not based on the packet data/headers.\n+\t * Application shouldn't assume that this value is kept during the life\n+\t * time of the packet.\n+\t *\n+\t * @see struct rte_flow_item_random.\n+\t */\n+\tRTE_FLOW_ITEM_TYPE_RANDOM,\n };\n \n /**\n@@ -2047,6 +2060,25 @@ static const struct rte_flow_item_ib_bth rte_flow_item_ib_bth_mask = {\n };\n #endif\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this structure may change without prior notice\n+ *\n+ * RTE_FLOW_ITEM_TYPE_RANDOM\n+ *\n+ * Matches a random value.\n+ */\n+struct rte_flow_item_random {\n+\tuint32_t value;\n+};\n+\n+/** Default mask for RTE_FLOW_ITEM_TYPE_RANDOM. */\n+#ifndef __cplusplus\n+static const struct rte_flow_item_random rte_flow_item_random_mask = {\n+\t.value = UINT32_MAX,\n+};\n+#endif\n+\n /**\n * Matching pattern item definition.\n *\n@@ -3903,7 +3935,8 @@ enum rte_flow_field_id {\n \tRTE_FLOW_FIELD_TCP_DATA_OFFSET,\t/**< TCP data offset. */\n \tRTE_FLOW_FIELD_IPV4_IHL,\t/**< IPv4 IHL. */\n \tRTE_FLOW_FIELD_IPV4_TOTAL_LEN,\t/**< IPv4 total length. */\n-\tRTE_FLOW_FIELD_IPV6_PAYLOAD_LEN\t/**< IPv6 payload length. */\n+\tRTE_FLOW_FIELD_IPV6_PAYLOAD_LEN,/**< IPv6 payload length. */\n+\tRTE_FLOW_FIELD_RANDOM\t\t/**< Random value. */\n };\n \n /**\n", "prefixes": [ "v3", "1/2" ] }