Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/107858/?format=api
{ "id": 107858, "url": "http://patches.dpdk.org/api/patches/107858/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220220034409.2226860-2-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": "<20220220034409.2226860-2-akozyrev@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220220034409.2226860-2-akozyrev@nvidia.com", "date": "2022-02-20T03:43:59", "name": "[v8,01/11] ethdev: introduce flow engine configuration", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "5769be0edfb2c2a13660ea2c25e1874c48ccd87d", "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/20220220034409.2226860-2-akozyrev@nvidia.com/mbox/", "series": [ { "id": 21750, "url": "http://patches.dpdk.org/api/series/21750/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=21750", "date": "2022-02-20T03:43:58", "name": "ethdev: datapath-focused flow rules management", "version": 8, "mbox": "http://patches.dpdk.org/series/21750/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/107858/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/107858/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 6141DA00C2;\n\tSun, 20 Feb 2022 04:44:44 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 098A54114E;\n\tSun, 20 Feb 2022 04:44:40 +0100 (CET)", "from NAM10-BN7-obe.outbound.protection.outlook.com\n (mail-bn7nam10on2048.outbound.protection.outlook.com [40.107.92.48])\n by mails.dpdk.org (Postfix) with ESMTP id 7B7D14114E\n for <dev@dpdk.org>; Sun, 20 Feb 2022 04:44:38 +0100 (CET)", "from MW5PR12MB5682.namprd12.prod.outlook.com (2603:10b6:303:19f::20)\n by DM5PR12MB2405.namprd12.prod.outlook.com (2603:10b6:4:b2::20) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.16; Sun, 20 Feb\n 2022 03:44:36 +0000", "from DM6PR03CA0087.namprd03.prod.outlook.com (2603:10b6:5:333::20)\n by MW5PR12MB5682.namprd12.prod.outlook.com (2603:10b6:303:19f::20) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.24; Sun, 20 Feb\n 2022 03:44:34 +0000", "from DM6NAM11FT006.eop-nam11.prod.protection.outlook.com\n (2603:10b6:5:333:cafe::dc) by DM6PR03CA0087.outlook.office365.com\n (2603:10b6:5:333::20) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.17 via Frontend\n Transport; Sun, 20 Feb 2022 03:44:34 +0000", "from mail.nvidia.com (12.22.5.235) by\n DM6NAM11FT006.mail.protection.outlook.com (10.13.173.104) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id\n 15.20.4995.15 via Frontend Transport; Sun, 20 Feb 2022 03:44:33 +0000", "from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL107.nvidia.com\n (10.27.9.16) with Microsoft SMTP Server (TLS) id 15.0.1497.18;\n Sun, 20 Feb 2022 03:44:33 +0000", "from pegasus01.mtr.labs.mlnx (10.126.230.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 Sat, 19 Feb 2022 19:44:29 -0800" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=hTnR+LygHT0Ohu0ZFHkWWT7cGvjvwKbpm7WqS/sYbuDA9ZImo54ifN+DaFhmIWanLnZpfhTFHqTk7BRuPaTBd1KjSdetQzq1kcbcM4QpctaQt4RudnuUeJaKkGkcalyLd+6Cv1gZhwWPq66A3Jna8bgyNrbnrmgfnCdYD1CzOOwCLQqF0fuewy4aZB5Yndj4tSanqnr8KeVgbqhuZ6dC6R4/sheEbwtqUpHja2BhwgEYgYPA3Sg4QHNaXaNRukY+F49P4Oqh9nAxS+cnLFcpaLw7iLjX1bayDNgGTGoxpkoPemzDUptfSP+25tzDQtJ/5H1lJ6r95QXAXr88SyvgMQ==", "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=UAPbBBk9Vf59LbcnsDPBz9S05kMkMGCCKymhJzi4j8I=;\n b=XWQ+yPI2ddbVbmkvxw4DaVKr3c1/ts1E0WDN3Id1peKc0Y/Ms529Db2l6OTVQ/uNNdsCVQnByDYJMODehpVusJPT4vW3cEHdh1e/JN48/B6heLViJ6fZbNW8OSI/GpGRlYW3ccDIxuzUgHpl4g4tglpNHZYm3B0yb67WS7OXyF7s6wgjjdK8pE/Cug8Mn9tus7wEdCUB3JERbdj47mlh8EshrvZexIGHcNGXg47GNPofEBrMyFy7dKz6CsWjaIScN+OnkT15j5NKCdB9NXYnGSTNX0TZyRlG0hhAm3oOQQZuMHxt8LyQPVl8MUUNTy2UBu9t3ed08Fgy4+UVSdKIDA==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 12.22.5.235) 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=UAPbBBk9Vf59LbcnsDPBz9S05kMkMGCCKymhJzi4j8I=;\n b=sOQE9smUmFfbCMqL6Dnp6sKMASREqTmu50mL+Nnv+/eA4GFHstOFhxPlQoZCknlz951fUZ8DX1Al3eMQvjrEA7gvs3GrnWGXwGAKD+wwklnrG2WsaXAlizejWDw4Fa76XdzhZEMldFHtXEOE0VHU8Ki87krbikR+ENkBmNWqOS07J+BJBycuHiASFzpIDyV8nNHWkJqD+b3KnLBIb2Cn81DgVyDiz+hHICq+R8yPzIdgr/859gmNiSqd5DsRnlFTxqa/DBt9fvsKz4yWQKrwqyksSS6kLFK7ThdT22Vhk+SZOm4Q1e/52pwSgZLpBQlypzej20d5QkMGA3QKhnn/Yg==", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 12.22.5.235)\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.235 as permitted sender) receiver=protection.outlook.com;\n client-ip=12.22.5.235; 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 v8 01/11] ethdev: introduce flow engine configuration", "Date": "Sun, 20 Feb 2022 05:43:59 +0200", "Message-ID": "<20220220034409.2226860-2-akozyrev@nvidia.com>", "X-Mailer": "git-send-email 2.18.2", "In-Reply-To": "<20220220034409.2226860-1-akozyrev@nvidia.com>", "References": "<20220219041144.2145380-1-akozyrev@nvidia.com>\n <20220220034409.2226860-1-akozyrev@nvidia.com>", "MIME-Version": "1.0", "Content-Type": "text/plain", "X-Originating-IP": "[10.126.230.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": "5d640029-7a6c-4c1a-0e3e-08d9f4234f4c", "X-MS-TrafficTypeDiagnostic": "MW5PR12MB5682:EE_|DM5PR12MB2405:EE_", "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr,ExtAddr", "X-Microsoft-Antispam-PRVS": "\n <MW5PR12MB56828D7CD3FA4C29D44EC48FAF399@MW5PR12MB5682.namprd12.prod.outlook.com>", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "\n 9Rgg5pnfZgltPztQ2XkBAdMGRYdTvghAjTlah8cjkgz69g8Vvwywx/cb39isjj300K0AEBOZIuKTNqehZF+i2MKEwRyQhyPmON8eCDwmo6m3RsL1reMgbWbnDkAWUoo0GF90qNzakhVVEPuYhDID7KGSwrcdsSrCyseEBT9eRJ83GRadg0vqO/gMbvGNYaAjzEjLp/AKTku9Vk2BwMcAYAVNrzOWBlpY+y9ppUOrLduchqzeQplhiM30TK0T33C0IqWn5ZhzXMS9ZlTJ43IGNIAWUCgL5nhknTDmdd2WMIFAJ7BWSjwAZ+PDw90AQ27w/Gj4fXnTGgJzzLkRNeosnWiOQz1uMwBkSWONF1b19W+ACUsRkLY86fjGGoSMd8v2xaEBxlx0P9PdsLuKYfOLd3xig9MOvLHbeNIYYIkjTqJjRHO2NCXXHOnY8H2Uc1FNthBXKu3EbhwKVW55hpmg+UykVeCeu0zjubzeNWvQ8THR3zr5dBnHLICgzo8wMaj3SY7TPkfy8rMo/G+TmQJGbnDOvAPMBbnEMUw2n59zJsLHOC7Qn3z0bN5dp9lU/xBeXIiGNVvcca8FMHXoqpDT6Wuxq2aNB0XUA7UBQeYgLtd0IAOwZRAH0xLMqRZRcdLYsMxq+ejHN0acmYFFLr+hNX/ZI8LDyLS6FjRwqq4YZQOvYo/y4dB0PISIv0Rp32ZLLQV52+mxocWW4DS2zUVtEg==", "X-Forefront-Antispam-Report": "CIP:12.22.5.235; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:CAL; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE;\n SFS:(13230001)(4636009)(40470700004)(36840700001)(46966006)(36860700001)(83380400001)(356005)(81166007)(47076005)(4326008)(82310400004)(316002)(6916009)(86362001)(54906003)(5660300002)(70206006)(70586007)(26005)(30864003)(8676002)(40460700003)(8936002)(2906002)(336012)(186003)(6666004)(1076003)(2616005)(7416002)(16526019)(36756003)(426003)(508600001)(36900700001);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "Nvidia.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "20 Feb 2022 03:44:33.9490 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 5d640029-7a6c-4c1a-0e3e-08d9f4234f4c", "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.235];\n Helo=[mail.nvidia.com]", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-CrossTenant-AuthSource": "\n DM6NAM11FT006.eop-nam11.prod.protection.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "DM5PR12MB2405", "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 flow rules creation/destruction at a large scale incurs a performance\npenalty and may negatively impact the packet processing when used\nas part of the datapath logic. This is mainly because software/hardware\nresources are allocated and prepared during the flow rule creation.\n\nIn order to optimize the insertion rate, PMD may use some hints provided\nby the application at the initialization phase. The rte_flow_configure()\nfunction allows to pre-allocate all the needed resources beforehand.\nThese resources can be used at a later stage without costly allocations.\nEvery PMD may use only the subset of hints and ignore unused ones or\nfail in case the requested configuration is not supported.\n\nThe rte_flow_info_get() is available to retrieve the information about\nsupported pre-configurable resources. Both these functions must be called\nbefore any other usage of the flow API engine.\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 | 36 ++++++++\n doc/guides/rel_notes/release_22_03.rst | 6 ++\n lib/ethdev/ethdev_driver.h | 7 +-\n lib/ethdev/rte_flow.c | 69 +++++++++++++++\n lib/ethdev/rte_flow.h | 111 +++++++++++++++++++++++++\n lib/ethdev/rte_flow_driver.h | 10 +++\n lib/ethdev/version.map | 2 +\n 7 files changed, 240 insertions(+), 1 deletion(-)", "diff": "diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst\nindex 0e475019a6..c89161faef 100644\n--- a/doc/guides/prog_guide/rte_flow.rst\n+++ b/doc/guides/prog_guide/rte_flow.rst\n@@ -3606,6 +3606,42 @@ Return values:\n \n - 0 on success, a negative errno value otherwise and ``rte_errno`` is set.\n \n+Flow engine configuration\n+-------------------------\n+\n+Configure flow API management.\n+\n+An application may provide some parameters at the initialization phase about\n+rules engine configuration and/or expected flow rules characteristics.\n+These parameters may be used by PMD to preallocate resources and configure NIC.\n+\n+Configuration\n+~~~~~~~~~~~~~\n+\n+This function performs the flow API engine configuration and allocates\n+requested resources beforehand to avoid costly allocations later.\n+Expected number of resources in an application allows PMD to prepare\n+and optimize NIC hardware configuration and memory layout in advance.\n+``rte_flow_configure()`` must be called before any flow rule is created,\n+but after an Ethernet device is configured.\n+\n+.. code-block:: c\n+\n+ int\n+ rte_flow_configure(uint16_t port_id,\n+ const struct rte_flow_port_attr *port_attr,\n+ struct rte_flow_error *error);\n+\n+Information about the number of available resources can be retrieved via\n+``rte_flow_info_get()`` API.\n+\n+.. code-block:: c\n+\n+ int\n+ rte_flow_info_get(uint16_t port_id,\n+ struct rte_flow_port_info *port_info,\n+ struct rte_flow_error *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 ff3095d742..eceab07576 100644\n--- a/doc/guides/rel_notes/release_22_03.rst\n+++ b/doc/guides/rel_notes/release_22_03.rst\n@@ -99,6 +99,12 @@ New Features\n The information of these properties is important for debug.\n As the information is private, a dump function is introduced.\n \n+* ** Added functions to configure Flow API engine\n+\n+ * ethdev: Added ``rte_flow_configure`` API to configure Flow Management\n+ engine, allowing to pre-allocate some resources for better performance.\n+ Added ``rte_flow_info_get`` API to retrieve available resources.\n+\n * **Updated AF_XDP PMD**\n \n * Added support for libxdp >=v1.2.2.\ndiff --git a/lib/ethdev/ethdev_driver.h b/lib/ethdev/ethdev_driver.h\nindex 6d697a879a..06f0896e1e 100644\n--- a/lib/ethdev/ethdev_driver.h\n+++ b/lib/ethdev/ethdev_driver.h\n@@ -138,7 +138,12 @@ struct rte_eth_dev_data {\n \t\t * Indicates whether the device is configured:\n \t\t * CONFIGURED(1) / NOT CONFIGURED(0)\n \t\t */\n-\t\tdev_configured : 1;\n+\t\tdev_configured:1,\n+\t\t/**\n+\t\t * Indicates whether the flow engine is configured:\n+\t\t * CONFIGURED(1) / NOT CONFIGURED(0)\n+\t\t */\n+\t\tflow_configured:1;\n \n \t/** Queues state: HAIRPIN(2) / STARTED(1) / STOPPED(0) */\n \tuint8_t rx_queue_state[RTE_MAX_QUEUES_PER_PORT];\ndiff --git a/lib/ethdev/rte_flow.c b/lib/ethdev/rte_flow.c\nindex 7f93900bc8..ffd48e40d5 100644\n--- a/lib/ethdev/rte_flow.c\n+++ b/lib/ethdev/rte_flow.c\n@@ -1392,3 +1392,72 @@ rte_flow_flex_item_release(uint16_t port_id,\n \tret = ops->flex_item_release(dev, handle, error);\n \treturn flow_err(port_id, ret, error);\n }\n+\n+int\n+rte_flow_info_get(uint16_t port_id,\n+\t\t struct rte_flow_port_info *port_info,\n+\t\t struct 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 (port_info == NULL) {\n+\t\tRTE_FLOW_LOG(ERR, \"Port %\"PRIu16\" info is NULL.\\n\", port_id);\n+\t\treturn -EINVAL;\n+\t}\n+\tif (dev->data->dev_configured == 0) {\n+\t\tRTE_FLOW_LOG(INFO,\n+\t\t\t\"Device with port_id=%\"PRIu16\" is not configured.\\n\",\n+\t\t\tport_id);\n+\t\treturn -EINVAL;\n+\t}\n+\tif (unlikely(!ops))\n+\t\treturn -rte_errno;\n+\tif (likely(!!ops->info_get)) {\n+\t\treturn flow_err(port_id,\n+\t\t\t\tops->info_get(dev, port_info, 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+int\n+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+\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+\tint ret;\n+\n+\tdev->data->flow_configured = 0;\n+\tif (port_attr == NULL) {\n+\t\tRTE_FLOW_LOG(ERR, \"Port %\"PRIu16\" info is NULL.\\n\", port_id);\n+\t\treturn -EINVAL;\n+\t}\n+\tif (dev->data->dev_configured == 0) {\n+\t\tRTE_FLOW_LOG(INFO,\n+\t\t\t\"Device with port_id=%\"PRIu16\" is not configured.\\n\",\n+\t\t\tport_id);\n+\t\treturn -EINVAL;\n+\t}\n+\tif (dev->data->dev_started != 0) {\n+\t\tRTE_FLOW_LOG(INFO,\n+\t\t\t\"Device with port_id=%\"PRIu16\" already started.\\n\",\n+\t\t\tport_id);\n+\t\treturn -EINVAL;\n+\t}\n+\tif (unlikely(!ops))\n+\t\treturn -rte_errno;\n+\tif (likely(!!ops->configure)) {\n+\t\tret = ops->configure(dev, port_attr, error);\n+\t\tif (ret == 0)\n+\t\t\tdev->data->flow_configured = 1;\n+\t\treturn flow_err(port_id, ret, error);\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 765beb3e52..cdb7b2be68 100644\n--- a/lib/ethdev/rte_flow.h\n+++ b/lib/ethdev/rte_flow.h\n@@ -43,6 +43,9 @@\n extern \"C\" {\n #endif\n \n+#define RTE_FLOW_LOG(level, ...) \\\n+\trte_log(RTE_LOG_ ## level, rte_eth_dev_logtype, \"\" __VA_ARGS__)\n+\n /**\n * Flow rule attributes.\n *\n@@ -4872,6 +4875,114 @@ rte_flow_flex_item_release(uint16_t port_id,\n \t\t\t const struct rte_flow_item_flex_handle *handle,\n \t\t\t struct rte_flow_error *error);\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Information about flow engine resources.\n+ * The zero value means a resource is not supported.\n+ *\n+ */\n+struct rte_flow_port_info {\n+\t/**\n+\t * Maximum number of counters.\n+\t * @see RTE_FLOW_ACTION_TYPE_COUNT\n+\t */\n+\tuint32_t max_nb_counters;\n+\t/**\n+\t * Maximum number of aging objects.\n+\t * @see RTE_FLOW_ACTION_TYPE_AGE\n+\t */\n+\tuint32_t max_nb_aging_objects;\n+\t/**\n+\t * Maximum number traffic meters.\n+\t * @see RTE_FLOW_ACTION_TYPE_METER\n+\t */\n+\tuint32_t max_nb_meters;\n+};\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Get information about flow engine resources.\n+ *\n+ * @param port_id\n+ * Port identifier of Ethernet device.\n+ * @param[out] port_info\n+ * A pointer to a structure of type *rte_flow_port_info*\n+ * to be filled with the resources information of the port.\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_info_get(uint16_t port_id,\n+\t\t struct rte_flow_port_info *port_info,\n+\t\t struct rte_flow_error *error);\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Flow engine resources settings.\n+ * The zero value means on demand resource allocations only.\n+ *\n+ */\n+struct rte_flow_port_attr {\n+\t/**\n+\t * Number of counters to configure.\n+\t * @see RTE_FLOW_ACTION_TYPE_COUNT\n+\t */\n+\tuint32_t nb_counters;\n+\t/**\n+\t * Number of aging objects to configure.\n+\t * @see RTE_FLOW_ACTION_TYPE_AGE\n+\t */\n+\tuint32_t nb_aging_objects;\n+\t/**\n+\t * Number of traffic meters to configure.\n+\t * @see RTE_FLOW_ACTION_TYPE_METER\n+\t */\n+\tuint32_t nb_meters;\n+};\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Configure the port's flow API engine.\n+ *\n+ * This API can only be invoked before the application\n+ * starts using the rest of the flow library functions.\n+ *\n+ * The API can be invoked multiple times to change the\n+ * settings. The port, however, may reject the changes.\n+ *\n+ * Parameters in configuration attributes must not exceed\n+ * numbers of resources returned by the rte_flow_info_get API.\n+ *\n+ * @param port_id\n+ * Port identifier of Ethernet device.\n+ * @param[in] port_attr\n+ * Port configuration attributes.\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_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 #ifdef __cplusplus\n }\n #endif\ndiff --git a/lib/ethdev/rte_flow_driver.h b/lib/ethdev/rte_flow_driver.h\nindex f691b04af4..7c29930d0f 100644\n--- a/lib/ethdev/rte_flow_driver.h\n+++ b/lib/ethdev/rte_flow_driver.h\n@@ -152,6 +152,16 @@ struct rte_flow_ops {\n \t\t(struct rte_eth_dev *dev,\n \t\t const struct rte_flow_item_flex_handle *handle,\n \t\t struct rte_flow_error *error);\n+\t/** See rte_flow_info_get() */\n+\tint (*info_get)\n+\t\t(struct rte_eth_dev *dev,\n+\t\t struct rte_flow_port_info *port_info,\n+\t\t struct rte_flow_error *err);\n+\t/** See rte_flow_configure() */\n+\tint (*configure)\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 };\n \n /**\ndiff --git a/lib/ethdev/version.map b/lib/ethdev/version.map\nindex d5cc56a560..0d849c153f 100644\n--- a/lib/ethdev/version.map\n+++ b/lib/ethdev/version.map\n@@ -264,6 +264,8 @@ EXPERIMENTAL {\n \trte_eth_ip_reassembly_capability_get;\n \trte_eth_ip_reassembly_conf_get;\n \trte_eth_ip_reassembly_conf_set;\n+\trte_flow_info_get;\n+\trte_flow_configure;\n };\n \n INTERNAL {\n", "prefixes": [ "v8", "01/11" ] }