Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/107913/?format=api
{ "id": 107913, "url": "http://patches.dpdk.org/api/patches/107913/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220221230240.2409665-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": "<20220221230240.2409665-2-akozyrev@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220221230240.2409665-2-akozyrev@nvidia.com", "date": "2022-02-21T23:02:30", "name": "[v9,01/11] ethdev: introduce flow engine configuration", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "9954db79ea226552f016174cf619f9894e6e6e5f", "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/20220221230240.2409665-2-akozyrev@nvidia.com/mbox/", "series": [ { "id": 21774, "url": "http://patches.dpdk.org/api/series/21774/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=21774", "date": "2022-02-21T23:02:29", "name": "ethdev: datapath-focused flow rules management", "version": 9, "mbox": "http://patches.dpdk.org/series/21774/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/107913/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/107913/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 3C6D8A034F;\n\tTue, 22 Feb 2022 00:03:09 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 25AD241142;\n\tTue, 22 Feb 2022 00:03:08 +0100 (CET)", "from NAM04-BN8-obe.outbound.protection.outlook.com\n (mail-bn8nam08on2055.outbound.protection.outlook.com [40.107.100.55])\n by mails.dpdk.org (Postfix) with ESMTP id DF0C24113C\n for <dev@dpdk.org>; Tue, 22 Feb 2022 00:03:06 +0100 (CET)", "from MWHPR12MB1248.namprd12.prod.outlook.com (2603:10b6:300:12::21)\n by BN6PR1201MB0196.namprd12.prod.outlook.com (2603:10b6:405:4d::16)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.16; Mon, 21 Feb\n 2022 23:03:05 +0000", "from MW4PR03CA0252.namprd03.prod.outlook.com (2603:10b6:303:b4::17)\n by MWHPR12MB1248.namprd12.prod.outlook.com (2603:10b6:300:12::21)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.16; Mon, 21 Feb\n 2022 23:03:03 +0000", "from CO1NAM11FT047.eop-nam11.prod.protection.outlook.com\n (2603:10b6:303:b4:cafe::ad) by MW4PR03CA0252.outlook.office365.com\n (2603:10b6:303:b4::17) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4995.16 via Frontend\n Transport; Mon, 21 Feb 2022 23:03:01 +0000", "from mail.nvidia.com (12.22.5.234) by\n CO1NAM11FT047.mail.protection.outlook.com (10.13.174.132) 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; Mon, 21 Feb 2022 23:03:01 +0000", "from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL101.nvidia.com\n (10.27.9.10) with Microsoft SMTP Server (TLS) id 15.0.1497.18;\n Mon, 21 Feb 2022 23:03:01 +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 Mon, 21 Feb 2022 15:02:58 -0800" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=hunei6lR30tzUErpRq5MpgTuQVAzF41j9SZcIBjN2XQ61HWcpkpzgiWGCZ/pKdxtAGzdCewPudP3IDMl6ei8CZs6nvG2DKS9FAmB7N14d3xhvYzx+mciVV9DTpO1xJeTN3ti6DLc6hYj8YrgqthlpxOojSCCNVwFVN4yxy2TeXR+RJz8Sg8edZr0V37jd/twyzWLKQBthrX1ex+IidsrBdcF6EGKWnos2zLBG7s8d85U3CBsZfgUqMjulDfWS/NPXNxTRLcYmlG2YXpQOPk31GWUqCAI1EZFuvKv6mZDAEM155yYb4ewP4ESQHmc83sIKfrgVtcxSECJ5ROTpyqytg==", "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=zJJTY3q//oNn0aMbSvN6koNyaNC7HCcrze9YsPsNh24=;\n b=YN12JeBup1Qo2YNkBQ948mhQ0qguhIzrtJE5+nyZ0vcjiAZB5egewt+pc/jbD5Zm4XvEzFgeAxnnIOt/4Eq3UeAQwRlfT25RoiqO+eX+CSQX3TzPFh2eWqThrjxH3ZB+3TycrLa0pGMrIizK3iEELelK9cRyhRRATeORmbFc11I2tTi81PxMuu9T2HD2iMDSmGuE76UXHvOiyq/ny6B4Iwt1JFbXNT9cK/N9tHDWzD6Yk5C4pRRKrsmoFBTRi4JypP+uv4a+8pktVdCJ39Q8w9SucXU+/o1hJrX4xzgvNC6a1YUTRlxW1Yal8ZMvot1+6DRRU/YGIVLUKsl+rqdYhA==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 12.22.5.234) 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=zJJTY3q//oNn0aMbSvN6koNyaNC7HCcrze9YsPsNh24=;\n b=Lq6B2QmPPliNj6t1wwZnKEoFT2jMw79qKPerbeiTuB7EM6azGK0MsbjnB8vUv93kK/s1oyFUjdGjRfTo272nNhfuxni29T/S92OROiJ33J12gef4gR1Fmo2IB5AXuv7KjVVEfqiAk+Z4a2eWCR5Ufn1CnBUf/6uqySZXUWFZ8BwLTM7pbehdNVtOg6eWhlxuZwEAv8u4uRte6AT1KWFpenpP8+v3EVZltq7E9M10B05cvl4SQAN88GbtHl8H3N1lbqMh8MS1B6L9O+MSIMn42Qrf0fCgk4oYkxwG2lbhqxA/QLOY+8DsRs2niRZR08zaraI+ZRCC7KR7sAYgFU2Mdw==", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 12.22.5.234)\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.234 as permitted sender) receiver=protection.outlook.com;\n client-ip=12.22.5.234; 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 v9 01/11] ethdev: introduce flow engine configuration", "Date": "Tue, 22 Feb 2022 01:02:30 +0200", "Message-ID": "<20220221230240.2409665-2-akozyrev@nvidia.com>", "X-Mailer": "git-send-email 2.18.2", "In-Reply-To": "<20220221230240.2409665-1-akozyrev@nvidia.com>", "References": "<20220220034409.2226860-1-akozyrev@nvidia.com>\n <20220221230240.2409665-1-akozyrev@nvidia.com>", "MIME-Version": "1.0", "Content-Type": "text/plain", "X-Originating-IP": "[10.126.230.35]", "X-ClientProxiedBy": "rnnvmail203.nvidia.com (10.129.68.9) To\n rnnvmail201.nvidia.com (10.129.68.8)", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-Office365-Filtering-Correlation-Id": "8e2995f9-9ddc-4f4b-8967-08d9f58e4f73", "X-MS-TrafficTypeDiagnostic": "MWHPR12MB1248:EE_|BN6PR1201MB0196:EE_", "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr,ExtAddr", "X-Microsoft-Antispam-PRVS": "\n <MWHPR12MB1248B9992F8C8385EEECC8BBAF3A9@MWHPR12MB1248.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 r79EneVNQP+3N7rZAPMK/SjFYEVXKPmQVji4ZPzib+xsIri8QCenpa5rV3Q9swdt6dJCqG8N5QCEgbQfPY1eek/KcE988+6JnxOqOBfZrBM0Zbbxm+1tZm3w16X/Oa26PtnPxkSR6TLT4SZ0KvImyX0aFQm2uh4XmtsgxJfJblE/8RGjmtGvRK5xGctSzlSiPhph7IyqXHXWfAa2pQA9EQsY88Aqd1DuTuS1yKaUY49Nd1UPUPImn1NfqOnkX59DHxzdmxBOILusJo7uGeZdt3l7tPCiw/OSN36MHV+CJuz3wJ7wdbHPfVKe/DouTbXIDdHz/dqeiuuaeHZSqWIZwoYwOvDL8jTpTcuawT2MTwb2a7oxkBZC1Fby0uTF3VB8G5ItGBg4UKsJ5+PL8+ZFsaErPTGSqVkck/5vzVxNxYzqemtMlIEbG7h/HH7n4utYaLZnKMXgcv64Ez7DpRj0sIE/39uz9BjD2yk9SuH8vVUGsrne6G7d5QvVagRSpKvjgNUC4Iqmhj+r4Qlw9wYBr920yhGMJon0GEE505sa5fU74me7JlwqjlFhPzMQ1C+48YihGj1T7+OM8G7gfoBSql2bTW4/RJZqyDxSEFDA3NahiYfvNoEL6/TsZcjFmgcpzcQgf085eIcwUB90cd7IrpIyz1bJHSM/L/lpJc8PP3C/sr2fUsK8ZlzOD6vREfDT66aO9QgPN8AHuAaeApzjIg==", "X-Forefront-Antispam-Report": "CIP:12.22.5.234; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:CAL; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE;\n SFS:(13230001)(4636009)(46966006)(40470700004)(36840700001)(8936002)(70586007)(70206006)(82310400004)(2906002)(8676002)(4326008)(30864003)(81166007)(356005)(6666004)(508600001)(316002)(336012)(6916009)(36860700001)(86362001)(426003)(1076003)(16526019)(2616005)(5660300002)(36756003)(186003)(26005)(40460700003)(83380400001)(47076005)(54906003)(7416002)(36900700001);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "Nvidia.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "21 Feb 2022 23:03:01.5518 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 8e2995f9-9ddc-4f4b-8967-08d9f58e4f73", "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.234];\n Helo=[mail.nvidia.com]", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-CrossTenant-AuthSource": "\n CO1NAM11FT047.eop-nam11.prod.protection.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "BN6PR1201MB0196", "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 | 68 +++++++++++++++\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, 239 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 41923f50e6..68b41f2062 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..42f0a3981e 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..7ec7a95a6b 100644\n--- a/lib/ethdev/rte_flow.c\n+++ b/lib/ethdev/rte_flow.c\n@@ -1392,3 +1392,71 @@ 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 (unlikely(!ops))\n+\t\treturn -rte_errno;\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 (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 (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+\tif (unlikely(!ops))\n+\t\treturn -rte_errno;\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 (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 (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..7e6f5eba46 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 settings.\n+ * The port, however, may reject changes and keep the old config.\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": [ "v9", "01/11" ] }