Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/107185/?format=api
{ "id": 107185, "url": "http://patches.dpdk.org/api/patches/107185/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220209213809.1208269-3-akozyrev@nvidia.com/", "project": { "id": 1, "url": "http://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": "<20220209213809.1208269-3-akozyrev@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220209213809.1208269-3-akozyrev@nvidia.com", "date": "2022-02-09T21:38:01", "name": "[v4,02/10] ethdev: add flow item/action templates", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "26e41d8f0eb51b564b2f89522aba61be9475c1dd", "submitter": { "id": 1873, "url": "http://patches.dpdk.org/api/people/1873/?format=api", "name": "Alexander Kozyrev", "email": "akozyrev@nvidia.com" }, "delegate": { "id": 319, "url": "http://patches.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20220209213809.1208269-3-akozyrev@nvidia.com/mbox/", "series": [ { "id": 21577, "url": "http://patches.dpdk.org/api/series/21577/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=21577", "date": "2022-02-09T21:37:59", "name": "ethdev: datapath-focused flow rules management", "version": 4, "mbox": "http://patches.dpdk.org/series/21577/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/107185/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/107185/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 C74A8A0032;\n\tWed, 9 Feb 2022 22:38:47 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id D376241159;\n\tWed, 9 Feb 2022 22:38:41 +0100 (CET)", "from NAM11-DM6-obe.outbound.protection.outlook.com\n (mail-dm6nam11on2073.outbound.protection.outlook.com [40.107.223.73])\n by mails.dpdk.org (Postfix) with ESMTP id 9A86041155\n for <dev@dpdk.org>; Wed, 9 Feb 2022 22:38:40 +0100 (CET)", "from CH0PR12MB5251.namprd12.prod.outlook.com (2603:10b6:610:d2::23)\n by MN0PR12MB6002.namprd12.prod.outlook.com (2603:10b6:208:37e::10)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4951.18; Wed, 9 Feb\n 2022 21:38:38 +0000", "from CO1PR15CA0079.namprd15.prod.outlook.com (2603:10b6:101:20::23)\n by CH0PR12MB5251.namprd12.prod.outlook.com (2603:10b6:610:d2::23)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4951.12; Wed, 9 Feb\n 2022 21:38:37 +0000", "from CO1NAM11FT035.eop-nam11.prod.protection.outlook.com\n (2603:10b6:101:20:cafe::bc) by CO1PR15CA0079.outlook.office365.com\n (2603:10b6:101:20::23) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4975.11 via Frontend\n Transport; Wed, 9 Feb 2022 21:38:37 +0000", "from mail.nvidia.com (12.22.5.236) by\n CO1NAM11FT035.mail.protection.outlook.com (10.13.175.36) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id\n 15.20.4975.11 via Frontend Transport; Wed, 9 Feb 2022 21:38:37 +0000", "from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL109.nvidia.com\n (10.27.9.19) with Microsoft SMTP Server (TLS) id 15.0.1497.18;\n Wed, 9 Feb 2022 21:38:36 +0000", "from pegasus01.mtr.labs.mlnx (10.126.231.35) by\n rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.9;\n Wed, 9 Feb 2022 13:38:33 -0800" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=mdcucfL30wOrLWxE/qfdfYiygSQ41pv97VuNlwk8EGQQlfR0XQjvo+G+V67Lk2ef/8a4GNdQsiSKrKSpFwMzt2k7rX8KT6iCqZ4K6qpVhQUFtm7FiC/7CBoNtiN4d1o9kDhUyqMXSVXklFDDKj2ea1re4SeZ14EBYn872RbkhzYwXX8pV8jHlXOMkkDK7WVKBmszFRtwdjN3vpb5mNUpO27yApgV7jXWmomGidpky1P0sUDlsTVnAb39/8RJk0h7i+isIGqQC+UqLgOxAWjP8GNzWfBj7iOEsLBtPQzbVSz1MK70suQzyUwe914g14fcmjFsFiR8C/DZllGXtRw0mA==", "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=isiEYEaTlshEsYStErvIsBY/NJ0oN9oMtH/Xcfqt+6o=;\n b=OJ2qSArH/6eKRFZw5SmW1TvD95nhXEPTI94BDTPSIwhacehbn9NLJp18WAjOnGCbrZM2O/iD/5zMXpi8V9wCPNadooBCEaPJhgQnimtqzcaIPm6mi/GD43j8VO6swxTfdnjvXFCWZkEfKULQSAkcB3fCIKV7Bewc3tvuSl9pF66mASvfJQk/GxyTKsmm6kCbMAt4RlcDO/LuGZSzgy6tNS5A1caZWcRlGKnouL6YJG8f4/Z6pcVGqJTXL/wjWH3GPU0gpb5Zg+tClqT4mkDUX10GSTKKWP46GvZ8xkwqWV+4qySmB3w0zHxMLe+KMeI3OHOqbrX2jHZnNHvf8hYeyg==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 12.22.5.236) smtp.rcpttodomain=intel.com smtp.mailfrom=nvidia.com; dmarc=pass\n (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none\n (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=isiEYEaTlshEsYStErvIsBY/NJ0oN9oMtH/Xcfqt+6o=;\n b=WtVzjGyoe+XiesEMYJi2OSt6/WzR1qp7LOfTjL3S1Zg8ay9kxfBEA1GfzVQDTtLlqNCoMB4IpfxXsX65d0j71tMAE/JvQtGcxMgf9z0M2QAeRlpFSs4vNG22F2A/UuiocRdN/m4nlZwITJxFQVVNvKvYc29CjYuEJohLrtjzaO3CMfMteKYmbNN4PV6E0o6Gsuui9e7s/0qH72P+GEBJAzmQWwJFZwwmVqjSC5B1emcI2T3ym92GcP5BkHGytUn11qogRIgdWjRkswWzKkiJNbwb5jV0dbpujEsspqMtniiSd8QRYnw/twWQcoSt8tPgZa4Ew60UnuF3uiazaDh7yg==", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 12.22.5.236)\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 12.22.5.236 as permitted sender) receiver=protection.outlook.com;\n client-ip=12.22.5.236; helo=mail.nvidia.com;", "From": "Alexander Kozyrev <akozyrev@nvidia.com>", "To": "<dev@dpdk.org>", "CC": "<orika@nvidia.com>, <thomas@monjalon.net>, <ivan.malov@oktetlabs.ru>,\n <andrew.rybchenko@oktetlabs.ru>, <ferruh.yigit@intel.com>,\n <mohammad.abdul.awal@intel.com>, <qi.z.zhang@intel.com>,\n <jerinj@marvell.com>, <ajit.khaparde@broadcom.com>,\n <bruce.richardson@intel.com>", "Subject": "[PATCH v4 02/10] ethdev: add flow item/action templates", "Date": "Wed, 9 Feb 2022 23:38:01 +0200", "Message-ID": "<20220209213809.1208269-3-akozyrev@nvidia.com>", "X-Mailer": "git-send-email 2.18.2", "In-Reply-To": "<20220209213809.1208269-1-akozyrev@nvidia.com>", "References": "<20220206032526.816079-1-akozyrev@nvidia.com >\n <20220209213809.1208269-1-akozyrev@nvidia.com>", "MIME-Version": "1.0", "Content-Type": "text/plain", "X-Originating-IP": "[10.126.231.35]", "X-ClientProxiedBy": "rnnvmail202.nvidia.com (10.129.68.7) To\n rnnvmail201.nvidia.com (10.129.68.8)", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-Office365-Filtering-Correlation-Id": "de554ee3-2249-4d79-ce49-08d9ec1487e6", "X-MS-TrafficTypeDiagnostic": "CH0PR12MB5251:EE_|MN0PR12MB6002:EE_", "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr,ExtAddr", "X-Microsoft-Antispam-PRVS": "\n <CH0PR12MB5251F07E5999A44F3DCE938AAF2E9@CH0PR12MB5251.namprd12.prod.outlook.com>", "X-MS-Oob-TLC-OOBClassifiers": "OLM:8273;", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "\n aK2AmgNERzTZeYaFmAq5LxH080RfgxTvLn6DZ19Jh2R1qn+SX7eK1M9rz1jlSQ+GBoCqkyHp2gQkx/AkvnS9i6hNRTY0rg162flkCW5Td+ajryv0Gulu4n0Jv98EsmVJcMaX1C2l1+7B2Vg6N8Sn0F4w/JNVXHes36tg+oIlyBiaaiLK7x72f0MGBQ9YI6Dg/UEcccGyNodPK/B44BMlC7UhcefsSr6I2/s0cw7gVO2aWBjTTG2+FQMpgXYerVXPqzEC/55JsGdVbWoYVHLmmamTdGKOMz4FRBhhKMMLDIsoZ5nkjs36nF4eUOCiY00OCGTO5BaujHCa7axlhL6Dq94uEiQMvXbYH0K5iLvP3UmEPYnlWvBscjzauqW7se7WxGlWoUNBcEK+vh+58N4dvvs/Y+NWPziKh/GxkuAoqhNUocgextUve+TSyJP0UwLJyrIb+yuGjBUKWUNXOpczumDD1NDD6ELdJZidTfqA7bfPQGmcDzgFrujR+4qrOExJouCro3wmRwV4vI1Nsbg8B2zk8w8G62z3dywdQtaalNRAIsFWeIVKpmLKNvmRMGPr4Pj5efZ6Ce5Td0i5/aLfxs7p3YCt0gJZWmmgix84jphHRPpoeYk9Q0PsbzrcEwfwWGx0Nh9oh8nr1w7WKHIJ20MHDJcYG/oNnZsbMkS4EDvCufr6atMZSGpuFJQLG9+sE1jXwiBJ3I+bQtCBVwJU7Q==", "X-Forefront-Antispam-Report": "CIP:12.22.5.236; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:CAL; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE;\n SFS:(13230001)(4636009)(36840700001)(40470700004)(46966006)(36860700001)(186003)(26005)(1076003)(2616005)(8936002)(8676002)(2906002)(336012)(47076005)(426003)(4326008)(16526019)(82310400004)(70586007)(83380400001)(70206006)(86362001)(30864003)(81166007)(7416002)(356005)(5660300002)(316002)(508600001)(36756003)(40460700003)(6666004)(54906003)(6916009)(36900700001);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "Nvidia.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "09 Feb 2022 21:38:37.1937 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n de554ee3-2249-4d79-ce49-08d9ec1487e6", "X-MS-Exchange-CrossTenant-Id": "43083d15-7273-40c1-b7db-39efd9ccc17a", "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.236];\n Helo=[mail.nvidia.com]", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-CrossTenant-AuthSource": "\n CO1NAM11FT035.eop-nam11.prod.protection.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "MN0PR12MB6002", "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": "Treating every single flow rule as a completely independent and separate\nentity negatively impacts the flow rules insertion rate. Oftentimes in an\napplication, many flow rules share a common structure (the same item mask\nand/or action list) so they can be grouped and classified together.\nThis knowledge may be used as a source of optimization by a PMD/HW.\n\nThe pattern template defines common matching fields (the item mask) without\nvalues. The actions template holds a list of action types that will be used\ntogether in the same rule. The specific values for items and actions will\nbe given only during the rule creation.\n\nA table combines pattern and actions templates along with shared flow rule\nattributes (group ID, priority and traffic direction). This way a PMD/HW\ncan prepare all the resources needed for efficient flow rules creation in\nthe datapath. To avoid any hiccups due to memory reallocation, the maximum\nnumber of flow rules is defined at the table creation time.\n\nThe flow rule creation is done by selecting a table, a pattern template\nand an actions template (which are bound to the table), and setting unique\nvalues for the items and actions.\n\nSigned-off-by: Alexander Kozyrev <akozyrev@nvidia.com>\nAcked-by: Ori Kam <orika@nvidia.com>\n---\n doc/guides/prog_guide/rte_flow.rst | 124 ++++++++++++\n doc/guides/rel_notes/release_22_03.rst | 8 +\n lib/ethdev/rte_flow.c | 147 ++++++++++++++\n lib/ethdev/rte_flow.h | 260 +++++++++++++++++++++++++\n lib/ethdev/rte_flow_driver.h | 37 ++++\n lib/ethdev/version.map | 6 +\n 6 files changed, 582 insertions(+)", "diff": "diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst\nindex 72fb1132ac..5391648833 100644\n--- a/doc/guides/prog_guide/rte_flow.rst\n+++ b/doc/guides/prog_guide/rte_flow.rst\n@@ -3626,6 +3626,130 @@ of pre-configurable resources for a given port on a system.\n struct rte_flow_port_info *port_info,\n struct rte_flow_error *error);\n \n+Flow templates\n+~~~~~~~~~~~~~~\n+\n+Oftentimes in an application, many flow rules share a common structure\n+(the same pattern and/or action list) so they can be grouped and classified\n+together. This knowledge may be used as a source of optimization by a PMD/HW.\n+The flow rule creation is done by selecting a table, a pattern template\n+and an actions template (which are bound to the table), and setting unique\n+values for the items and actions. This API is not thread-safe.\n+\n+Pattern templates\n+^^^^^^^^^^^^^^^^^\n+\n+The pattern template defines a common pattern (the item mask) without values.\n+The mask value is used to select a field to match on, spec/last are ignored.\n+The pattern template may be used by multiple tables and must not be destroyed\n+until all these tables are destroyed first.\n+\n+.. code-block:: c\n+\n+\tstruct rte_flow_pattern_template *\n+\trte_flow_pattern_template_create(uint16_t port_id,\n+\t\t\t\tconst struct rte_flow_pattern_template_attr *template_attr,\n+\t\t\t\tconst struct rte_flow_item pattern[],\n+\t\t\t\tstruct rte_flow_error *error);\n+\n+For example, to create a pattern template to match on the destination MAC:\n+\n+.. code-block:: c\n+\n+\tstruct rte_flow_item pattern[2] = {{0}};\n+\tstruct rte_flow_item_eth eth_m = {0};\n+\tpattern[0].type = RTE_FLOW_ITEM_TYPE_ETH;\n+\teth_m.dst.addr_bytes = \"\\xff\\xff\\xff\\xff\\xff\\xff\";\n+\tpattern[0].mask = ð_m;\n+\tpattern[1].type = RTE_FLOW_ITEM_TYPE_END;\n+\n+\tstruct rte_flow_pattern_template *pattern_template =\n+\t\trte_flow_pattern_template_create(port, &itr, &pattern, &error);\n+\n+The concrete value to match on will be provided at the rule creation.\n+\n+Actions templates\n+^^^^^^^^^^^^^^^^^\n+\n+The actions template holds a list of action types to be used in flow rules.\n+The mask parameter allows specifying a shared constant value for every rule.\n+The actions template may be used by multiple tables and must not be destroyed\n+until all these tables are destroyed first.\n+\n+.. code-block:: c\n+\n+\tstruct rte_flow_actions_template *\n+\trte_flow_actions_template_create(uint16_t port_id,\n+\t\t\t\tconst struct rte_flow_actions_template_attr *template_attr,\n+\t\t\t\tconst struct rte_flow_action actions[],\n+\t\t\t\tconst struct rte_flow_action masks[],\n+\t\t\t\tstruct rte_flow_error *error);\n+\n+For example, to create an actions template with the same Mark ID\n+but different Queue Index for every rule:\n+\n+.. code-block:: c\n+\n+\tstruct rte_flow_action actions[] = {\n+\t\t/* Mark ID is constant (4) for every rule, Queue Index is unique */\n+\t\t[0] = {.type = RTE_FLOW_ACTION_TYPE_MARK,\n+\t\t\t .conf = &(struct rte_flow_action_mark){.id = 4}},\n+\t\t[1] = {.type = RTE_FLOW_ACTION_TYPE_QUEUE},\n+\t\t[2] = {.type = RTE_FLOW_ACTION_TYPE_END,},\n+\t};\n+\tstruct rte_flow_action masks[] = {\n+\t\t/* Assign to MARK mask any non-zero value to make it constant */\n+\t\t[0] = {.type = RTE_FLOW_ACTION_TYPE_MARK,\n+\t\t\t .conf = &(struct rte_flow_action_mark){.id = 1}},\n+\t\t[1] = {.type = RTE_FLOW_ACTION_TYPE_QUEUE},\n+\t\t[2] = {.type = RTE_FLOW_ACTION_TYPE_END,},\n+\t};\n+\n+\tstruct rte_flow_actions_template *at =\n+\t\trte_flow_actions_template_create(port, &atr, &actions, &masks, &error);\n+\n+The concrete value for Queue Index will be provided at the rule creation.\n+\n+Template table\n+^^^^^^^^^^^^^^\n+\n+A template table combines a number of pattern and actions templates along with\n+shared flow rule attributes (group ID, priority and traffic direction).\n+This way a PMD/HW can prepare all the resources needed for efficient flow rules\n+creation in the datapath. To avoid any hiccups due to memory reallocation,\n+the maximum number of flow rules is defined at table creation time.\n+Any flow rule creation beyond the maximum table size is rejected.\n+Application may create another table to accommodate more rules in this case.\n+\n+.. code-block:: c\n+\n+\tstruct rte_flow_template_table *\n+\trte_flow_template_table_create(uint16_t port_id,\n+\t\t\t\tconst struct rte_flow_template_table_attr *table_attr,\n+\t\t\t\tstruct rte_flow_pattern_template *pattern_templates[],\n+\t\t\t\tuint8_t nb_pattern_templates,\n+\t\t\t\tstruct rte_flow_actions_template *actions_templates[],\n+\t\t\t\tuint8_t nb_actions_templates,\n+\t\t\t\tstruct rte_flow_error *error);\n+\n+A table can be created only after the Flow Rules management is configured\n+and pattern and actions templates are created.\n+\n+.. code-block:: c\n+\n+\trte_flow_configure(port, *port_attr, *error);\n+\n+\tstruct rte_flow_pattern_template *pattern_templates[0] =\n+\t\trte_flow_pattern_template_create(port, &itr, &pattern, &error);\n+\tstruct rte_flow_actions_template *actions_templates[0] =\n+\t\trte_flow_actions_template_create(port, &atr, &actions, &masks, &error);\n+\n+\tstruct rte_flow_template_table *table =\n+\t\trte_flow_template_table_create(port, *table_attr,\n+\t\t\t\t*pattern_templates, nb_pattern_templates,\n+\t\t\t\t*actions_templates, nb_actions_templates,\n+\t\t\t\t*error);\n+\n .. _flow_isolated_mode:\n \n Flow isolated mode\ndiff --git a/doc/guides/rel_notes/release_22_03.rst b/doc/guides/rel_notes/release_22_03.rst\nindex 2a47a37f0a..6656b35295 100644\n--- a/doc/guides/rel_notes/release_22_03.rst\n+++ b/doc/guides/rel_notes/release_22_03.rst\n@@ -75,6 +75,14 @@ New Features\n engine, allowing to pre-allocate some resources for better performance.\n Added ``rte_flow_info_get`` API to retrieve pre-configurable resources.\n \n+ * ethdev: Added ``rte_flow_template_table_create`` API to group flow rules\n+ with the same flow attributes and common matching patterns and actions\n+ defined by ``rte_flow_pattern_template_create`` and\n+ ``rte_flow_actions_template_create`` respectively.\n+ Corresponding functions to destroy these entities are:\n+ ``rte_flow_template_table_destroy``, ``rte_flow_pattern_template_destroy``\n+ and ``rte_flow_actions_template_destroy``.\n+\n * **Updated AF_XDP PMD**\n \n * Added support for libxdp >=v1.2.2.\ndiff --git a/lib/ethdev/rte_flow.c b/lib/ethdev/rte_flow.c\nindex 66614ae29b..b53f8c9b89 100644\n--- a/lib/ethdev/rte_flow.c\n+++ b/lib/ethdev/rte_flow.c\n@@ -1431,3 +1431,150 @@ rte_flow_configure(uint16_t port_id,\n \t\t\t\t RTE_FLOW_ERROR_TYPE_UNSPECIFIED,\n \t\t\t\t NULL, rte_strerror(ENOTSUP));\n }\n+\n+struct rte_flow_pattern_template *\n+rte_flow_pattern_template_create(uint16_t port_id,\n+\t\tconst struct rte_flow_pattern_template_attr *template_attr,\n+\t\tconst struct rte_flow_item pattern[],\n+\t\tstruct rte_flow_error *error)\n+{\n+\tstruct rte_eth_dev *dev = &rte_eth_devices[port_id];\n+\tconst struct rte_flow_ops *ops = rte_flow_ops_get(port_id, error);\n+\tstruct rte_flow_pattern_template *template;\n+\n+\tif (unlikely(!ops))\n+\t\treturn NULL;\n+\tif (likely(!!ops->pattern_template_create)) {\n+\t\ttemplate = ops->pattern_template_create(dev, template_attr,\n+\t\t\t\t\t\t pattern, error);\n+\t\tif (template == NULL)\n+\t\t\tflow_err(port_id, -rte_errno, error);\n+\t\treturn template;\n+\t}\n+\trte_flow_error_set(error, ENOTSUP,\n+\t\t\t RTE_FLOW_ERROR_TYPE_UNSPECIFIED,\n+\t\t\t NULL, rte_strerror(ENOTSUP));\n+\treturn NULL;\n+}\n+\n+int\n+rte_flow_pattern_template_destroy(uint16_t port_id,\n+\t\tstruct rte_flow_pattern_template *pattern_template,\n+\t\tstruct rte_flow_error *error)\n+{\n+\tstruct rte_eth_dev *dev = &rte_eth_devices[port_id];\n+\tconst struct rte_flow_ops *ops = rte_flow_ops_get(port_id, error);\n+\n+\tif (unlikely(!ops))\n+\t\treturn -rte_errno;\n+\tif (likely(!!ops->pattern_template_destroy)) {\n+\t\treturn flow_err(port_id,\n+\t\t\t\tops->pattern_template_destroy(dev,\n+\t\t\t\t\t\t\t pattern_template,\n+\t\t\t\t\t\t\t error),\n+\t\t\t\terror);\n+\t}\n+\treturn rte_flow_error_set(error, ENOTSUP,\n+\t\t\t\t RTE_FLOW_ERROR_TYPE_UNSPECIFIED,\n+\t\t\t\t NULL, rte_strerror(ENOTSUP));\n+}\n+\n+struct rte_flow_actions_template *\n+rte_flow_actions_template_create(uint16_t port_id,\n+\t\t\tconst struct rte_flow_actions_template_attr *template_attr,\n+\t\t\tconst struct rte_flow_action actions[],\n+\t\t\tconst struct rte_flow_action masks[],\n+\t\t\tstruct rte_flow_error *error)\n+{\n+\tstruct rte_eth_dev *dev = &rte_eth_devices[port_id];\n+\tconst struct rte_flow_ops *ops = rte_flow_ops_get(port_id, error);\n+\tstruct rte_flow_actions_template *template;\n+\n+\tif (unlikely(!ops))\n+\t\treturn NULL;\n+\tif (likely(!!ops->actions_template_create)) {\n+\t\ttemplate = ops->actions_template_create(dev, template_attr,\n+\t\t\t\t\t\t\tactions, masks, error);\n+\t\tif (template == NULL)\n+\t\t\tflow_err(port_id, -rte_errno, error);\n+\t\treturn template;\n+\t}\n+\trte_flow_error_set(error, ENOTSUP,\n+\t\t\t RTE_FLOW_ERROR_TYPE_UNSPECIFIED,\n+\t\t\t NULL, rte_strerror(ENOTSUP));\n+\treturn NULL;\n+}\n+\n+int\n+rte_flow_actions_template_destroy(uint16_t port_id,\n+\t\t\tstruct rte_flow_actions_template *actions_template,\n+\t\t\tstruct rte_flow_error *error)\n+{\n+\tstruct rte_eth_dev *dev = &rte_eth_devices[port_id];\n+\tconst struct rte_flow_ops *ops = rte_flow_ops_get(port_id, error);\n+\n+\tif (unlikely(!ops))\n+\t\treturn -rte_errno;\n+\tif (likely(!!ops->actions_template_destroy)) {\n+\t\treturn flow_err(port_id,\n+\t\t\t\tops->actions_template_destroy(dev,\n+\t\t\t\t\t\t\t actions_template,\n+\t\t\t\t\t\t\t error),\n+\t\t\t\terror);\n+\t}\n+\treturn rte_flow_error_set(error, ENOTSUP,\n+\t\t\t\t RTE_FLOW_ERROR_TYPE_UNSPECIFIED,\n+\t\t\t\t NULL, rte_strerror(ENOTSUP));\n+}\n+\n+struct rte_flow_template_table *\n+rte_flow_template_table_create(uint16_t port_id,\n+\t\t\tconst struct rte_flow_template_table_attr *table_attr,\n+\t\t\tstruct rte_flow_pattern_template *pattern_templates[],\n+\t\t\tuint8_t nb_pattern_templates,\n+\t\t\tstruct rte_flow_actions_template *actions_templates[],\n+\t\t\tuint8_t nb_actions_templates,\n+\t\t\tstruct rte_flow_error *error)\n+{\n+\tstruct rte_eth_dev *dev = &rte_eth_devices[port_id];\n+\tconst struct rte_flow_ops *ops = rte_flow_ops_get(port_id, error);\n+\tstruct rte_flow_template_table *table;\n+\n+\tif (unlikely(!ops))\n+\t\treturn NULL;\n+\tif (likely(!!ops->template_table_create)) {\n+\t\ttable = ops->template_table_create(dev, table_attr,\n+\t\t\t\t\tpattern_templates, nb_pattern_templates,\n+\t\t\t\t\tactions_templates, nb_actions_templates,\n+\t\t\t\t\terror);\n+\t\tif (table == NULL)\n+\t\t\tflow_err(port_id, -rte_errno, error);\n+\t\treturn table;\n+\t}\n+\trte_flow_error_set(error, ENOTSUP,\n+\t\t\t RTE_FLOW_ERROR_TYPE_UNSPECIFIED,\n+\t\t\t NULL, rte_strerror(ENOTSUP));\n+\treturn NULL;\n+}\n+\n+int\n+rte_flow_template_table_destroy(uint16_t port_id,\n+\t\t\t\tstruct rte_flow_template_table *template_table,\n+\t\t\t\tstruct rte_flow_error *error)\n+{\n+\tstruct rte_eth_dev *dev = &rte_eth_devices[port_id];\n+\tconst struct rte_flow_ops *ops = rte_flow_ops_get(port_id, error);\n+\n+\tif (unlikely(!ops))\n+\t\treturn -rte_errno;\n+\tif (likely(!!ops->template_table_destroy)) {\n+\t\treturn flow_err(port_id,\n+\t\t\t\tops->template_table_destroy(dev,\n+\t\t\t\t\t\t\t template_table,\n+\t\t\t\t\t\t\t error),\n+\t\t\t\terror);\n+\t}\n+\treturn rte_flow_error_set(error, ENOTSUP,\n+\t\t\t\t RTE_FLOW_ERROR_TYPE_UNSPECIFIED,\n+\t\t\t\t NULL, rte_strerror(ENOTSUP));\n+}\ndiff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h\nindex 92be2a9a89..e87db5a540 100644\n--- a/lib/ethdev/rte_flow.h\n+++ b/lib/ethdev/rte_flow.h\n@@ -4961,6 +4961,266 @@ rte_flow_configure(uint16_t port_id,\n \t\t const struct rte_flow_port_attr *port_attr,\n \t\t struct rte_flow_error *error);\n \n+/**\n+ * Opaque type returned after successful creation of pattern template.\n+ * This handle can be used to manage the created pattern template.\n+ */\n+struct rte_flow_pattern_template;\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Flow pattern template attributes.\n+ */\n+__extension__\n+struct rte_flow_pattern_template_attr {\n+\t/**\n+\t * Relaxed matching policy.\n+\t * - PMD may match only on items with mask member set and skip\n+\t * matching on protocol layers specified without any masks.\n+\t * - If not set, PMD will match on protocol layers\n+\t * specified without any masks as well.\n+\t * - Packet data must be stacked in the same order as the\n+\t * protocol layers to match inside packets, starting from the lowest.\n+\t */\n+\tuint32_t relaxed_matching:1;\n+};\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Create pattern template.\n+ *\n+ * The pattern template defines common matching fields without values.\n+ * For example, matching on 5 tuple TCP flow, the template will be\n+ * eth(null) + IPv4(source + dest) + TCP(s_port + d_port),\n+ * while values for each rule will be set during the flow rule creation.\n+ * The number and order of items in the template must be the same\n+ * at the rule creation.\n+ *\n+ * @param port_id\n+ * Port identifier of Ethernet device.\n+ * @param[in] template_attr\n+ * Pattern template attributes.\n+ * @param[in] pattern\n+ * Pattern specification (list terminated by the END pattern item).\n+ * The spec member of an item is not used unless the end member is used.\n+ * @param[out] error\n+ * Perform verbose error reporting if not NULL.\n+ * PMDs initialize this structure in case of error only.\n+ *\n+ * @return\n+ * Handle on success, NULL otherwise and rte_errno is set.\n+ */\n+__rte_experimental\n+struct rte_flow_pattern_template *\n+rte_flow_pattern_template_create(uint16_t port_id,\n+\t\tconst struct rte_flow_pattern_template_attr *template_attr,\n+\t\tconst struct rte_flow_item pattern[],\n+\t\tstruct rte_flow_error *error);\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Destroy pattern template.\n+ *\n+ * This function may be called only when\n+ * there are no more tables referencing this template.\n+ *\n+ * @param port_id\n+ * Port identifier of Ethernet device.\n+ * @param[in] pattern_template\n+ * Handle of the template to be destroyed.\n+ * @param[out] error\n+ * Perform verbose error reporting if not NULL.\n+ * PMDs initialize this structure in case of error only.\n+ *\n+ * @return\n+ * 0 on success, a negative errno value otherwise and rte_errno is set.\n+ */\n+__rte_experimental\n+int\n+rte_flow_pattern_template_destroy(uint16_t port_id,\n+\t\tstruct rte_flow_pattern_template *pattern_template,\n+\t\tstruct rte_flow_error *error);\n+\n+/**\n+ * Opaque type returned after successful creation of actions template.\n+ * This handle can be used to manage the created actions template.\n+ */\n+struct rte_flow_actions_template;\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Flow actions template attributes.\n+ */\n+struct rte_flow_actions_template_attr;\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Create actions template.\n+ *\n+ * The actions template holds a list of action types without values.\n+ * For example, the template to change TCP ports is TCP(s_port + d_port),\n+ * while values for each rule will be set during the flow rule creation.\n+ * The number and order of actions in the template must be the same\n+ * at the rule creation.\n+ *\n+ * @param port_id\n+ * Port identifier of Ethernet device.\n+ * @param[in] template_attr\n+ * Template attributes.\n+ * @param[in] actions\n+ * Associated actions (list terminated by the END action).\n+ * The spec member is only used if @p masks spec is non-zero.\n+ * @param[in] masks\n+ * List of actions that marks which of the action's member is constant.\n+ * A mask has the same format as the corresponding action.\n+ * If the action field in @p masks is not 0,\n+ * the corresponding value in an action from @p actions will be the part\n+ * of the template and used in all flow rules.\n+ * The order of actions in @p masks is the same as in @p actions.\n+ * In case of indirect actions present in @p actions,\n+ * the actual action type should be present in @p mask.\n+ * @param[out] error\n+ * Perform verbose error reporting if not NULL.\n+ * PMDs initialize this structure in case of error only.\n+ *\n+ * @return\n+ * Handle on success, NULL otherwise and rte_errno is set.\n+ */\n+__rte_experimental\n+struct rte_flow_actions_template *\n+rte_flow_actions_template_create(uint16_t port_id,\n+\t\tconst struct rte_flow_actions_template_attr *template_attr,\n+\t\tconst struct rte_flow_action actions[],\n+\t\tconst struct rte_flow_action masks[],\n+\t\tstruct rte_flow_error *error);\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Destroy actions template.\n+ *\n+ * This function may be called only when\n+ * there are no more tables referencing this template.\n+ *\n+ * @param port_id\n+ * Port identifier of Ethernet device.\n+ * @param[in] actions_template\n+ * Handle to the template to be destroyed.\n+ * @param[out] error\n+ * Perform verbose error reporting if not NULL.\n+ * PMDs initialize this structure in case of error only.\n+ *\n+ * @return\n+ * 0 on success, a negative errno value otherwise and rte_errno is set.\n+ */\n+__rte_experimental\n+int\n+rte_flow_actions_template_destroy(uint16_t port_id,\n+\t\tstruct rte_flow_actions_template *actions_template,\n+\t\tstruct rte_flow_error *error);\n+\n+/**\n+ * Opaque type returned after successful creation of a template table.\n+ * This handle can be used to manage the created template table.\n+ */\n+struct rte_flow_template_table;\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Table attributes.\n+ */\n+struct rte_flow_template_table_attr {\n+\t/**\n+\t * Flow attributes to be used in each rule generated from this table.\n+\t */\n+\tstruct rte_flow_attr flow_attr;\n+\t/**\n+\t * Maximum number of flow rules that this table holds.\n+\t */\n+\tuint32_t nb_flows;\n+};\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Create template table.\n+ *\n+ * A template table consists of multiple pattern templates and actions\n+ * templates associated with a single set of rule attributes (group ID,\n+ * priority and traffic direction).\n+ *\n+ * Each rule is free to use any combination of pattern and actions templates\n+ * and specify particular values for items and actions it would like to change.\n+ *\n+ * @param port_id\n+ * Port identifier of Ethernet device.\n+ * @param[in] table_attr\n+ * Template table attributes.\n+ * @param[in] pattern_templates\n+ * Array of pattern templates to be used in this table.\n+ * @param[in] nb_pattern_templates\n+ * The number of pattern templates in the pattern_templates array.\n+ * @param[in] actions_templates\n+ * Array of actions templates to be used in this table.\n+ * @param[in] nb_actions_templates\n+ * The number of actions templates in the actions_templates array.\n+ * @param[out] error\n+ * Perform verbose error reporting if not NULL.\n+ * PMDs initialize this structure in case of error only.\n+ *\n+ * @return\n+ * Handle on success, NULL otherwise and rte_errno is set.\n+ */\n+__rte_experimental\n+struct rte_flow_template_table *\n+rte_flow_template_table_create(uint16_t port_id,\n+\t\tconst struct rte_flow_template_table_attr *table_attr,\n+\t\tstruct rte_flow_pattern_template *pattern_templates[],\n+\t\tuint8_t nb_pattern_templates,\n+\t\tstruct rte_flow_actions_template *actions_templates[],\n+\t\tuint8_t nb_actions_templates,\n+\t\tstruct rte_flow_error *error);\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Destroy template table.\n+ *\n+ * This function may be called only when\n+ * there are no more flow rules referencing this table.\n+ *\n+ * @param port_id\n+ * Port identifier of Ethernet device.\n+ * @param[in] template_table\n+ * Handle to the table to be destroyed.\n+ * @param[out] error\n+ * Perform verbose error reporting if not NULL.\n+ * PMDs initialize this structure in case of error only.\n+ *\n+ * @return\n+ * 0 on success, a negative errno value otherwise and rte_errno is set.\n+ */\n+__rte_experimental\n+int\n+rte_flow_template_table_destroy(uint16_t port_id,\n+\t\tstruct rte_flow_template_table *template_table,\n+\t\tstruct rte_flow_error *error);\n+\n #ifdef __cplusplus\n }\n #endif\ndiff --git a/lib/ethdev/rte_flow_driver.h b/lib/ethdev/rte_flow_driver.h\nindex 7c29930d0f..2d96db1dc7 100644\n--- a/lib/ethdev/rte_flow_driver.h\n+++ b/lib/ethdev/rte_flow_driver.h\n@@ -162,6 +162,43 @@ struct rte_flow_ops {\n \t\t(struct rte_eth_dev *dev,\n \t\t const struct rte_flow_port_attr *port_attr,\n \t\t struct rte_flow_error *err);\n+\t/** See rte_flow_pattern_template_create() */\n+\tstruct rte_flow_pattern_template *(*pattern_template_create)\n+\t\t(struct rte_eth_dev *dev,\n+\t\t const struct rte_flow_pattern_template_attr *template_attr,\n+\t\t const struct rte_flow_item pattern[],\n+\t\t struct rte_flow_error *err);\n+\t/** See rte_flow_pattern_template_destroy() */\n+\tint (*pattern_template_destroy)\n+\t\t(struct rte_eth_dev *dev,\n+\t\t struct rte_flow_pattern_template *pattern_template,\n+\t\t struct rte_flow_error *err);\n+\t/** See rte_flow_actions_template_create() */\n+\tstruct rte_flow_actions_template *(*actions_template_create)\n+\t\t(struct rte_eth_dev *dev,\n+\t\t const struct rte_flow_actions_template_attr *template_attr,\n+\t\t const struct rte_flow_action actions[],\n+\t\t const struct rte_flow_action masks[],\n+\t\t struct rte_flow_error *err);\n+\t/** See rte_flow_actions_template_destroy() */\n+\tint (*actions_template_destroy)\n+\t\t(struct rte_eth_dev *dev,\n+\t\t struct rte_flow_actions_template *actions_template,\n+\t\t struct rte_flow_error *err);\n+\t/** See rte_flow_template_table_create() */\n+\tstruct rte_flow_template_table *(*template_table_create)\n+\t\t(struct rte_eth_dev *dev,\n+\t\t const struct rte_flow_template_table_attr *table_attr,\n+\t\t struct rte_flow_pattern_template *pattern_templates[],\n+\t\t uint8_t nb_pattern_templates,\n+\t\t struct rte_flow_actions_template *actions_templates[],\n+\t\t uint8_t nb_actions_templates,\n+\t\t struct rte_flow_error *err);\n+\t/** See rte_flow_template_table_destroy() */\n+\tint (*template_table_destroy)\n+\t\t(struct rte_eth_dev *dev,\n+\t\t struct rte_flow_template_table *template_table,\n+\t\t struct rte_flow_error *err);\n };\n \n /**\ndiff --git a/lib/ethdev/version.map b/lib/ethdev/version.map\nindex f1235aa913..5fd2108895 100644\n--- a/lib/ethdev/version.map\n+++ b/lib/ethdev/version.map\n@@ -262,6 +262,12 @@ EXPERIMENTAL {\n \trte_eth_dev_priority_flow_ctrl_queue_info_get;\n \trte_flow_info_get;\n \trte_flow_configure;\n+\trte_flow_pattern_template_create;\n+\trte_flow_pattern_template_destroy;\n+\trte_flow_actions_template_create;\n+\trte_flow_actions_template_destroy;\n+\trte_flow_template_table_create;\n+\trte_flow_template_table_destroy;\n };\n \n INTERNAL {\n", "prefixes": [ "v4", "02/10" ] }