Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/104868/?format=api
{ "id": 104868, "url": "http://patchwork.dpdk.org/api/patches/104868/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20211204172458.1904300-1-jerinj@marvell.com/", "project": { "id": 1, "url": "http://patchwork.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20211204172458.1904300-1-jerinj@marvell.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20211204172458.1904300-1-jerinj@marvell.com", "date": "2021-12-04T17:24:58", "name": "ethdev: support queue-based priority flow control", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "da2d5928c2ca734162426210bce6238e1971fc1c", "submitter": { "id": 1188, "url": "http://patchwork.dpdk.org/api/people/1188/?format=api", "name": "Jerin Jacob Kollanukkaran", "email": "jerinj@marvell.com" }, "delegate": { "id": 319, "url": "http://patchwork.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20211204172458.1904300-1-jerinj@marvell.com/mbox/", "series": [ { "id": 20855, "url": "http://patchwork.dpdk.org/api/series/20855/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=20855", "date": "2021-12-04T17:24:58", "name": "ethdev: support queue-based priority flow control", "version": 1, "mbox": "http://patchwork.dpdk.org/series/20855/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/104868/comments/", "check": "fail", "checks": "http://patchwork.dpdk.org/api/patches/104868/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 226A5A0C4E;\n\tSat, 4 Dec 2021 18:29:29 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 6CA1240DDD;\n\tSat, 4 Dec 2021 18:29:28 +0100 (CET)", "from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com\n [67.231.148.174])\n by mails.dpdk.org (Postfix) with ESMTP id 386174013F\n for <dev@dpdk.org>; Sat, 4 Dec 2021 18:29:26 +0100 (CET)", "from pps.filterd (m0045849.ppops.net [127.0.0.1])\n by mx0a-0016f401.pphosted.com (8.16.1.2/8.16.1.2) with ESMTP id\n 1B4E0Ibs014333;\n Sat, 4 Dec 2021 09:29:03 -0800", "from dc5-exch02.marvell.com ([199.233.59.182])\n by mx0a-0016f401.pphosted.com (PPS) with ESMTPS id 3cr6jrgw0w-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT);\n Sat, 04 Dec 2021 09:29:03 -0800", "from DC5-EXCH02.marvell.com (10.69.176.39) by DC5-EXCH02.marvell.com\n (10.69.176.39) with Microsoft SMTP Server (TLS) id 15.0.1497.18;\n Sat, 4 Dec 2021 09:29:01 -0800", "from maili.marvell.com (10.69.176.80) by DC5-EXCH02.marvell.com\n (10.69.176.39) with Microsoft SMTP Server id 15.0.1497.18 via Frontend\n Transport; Sat, 4 Dec 2021 09:29:01 -0800", "from jerin-lab.marvell.com (jerin-lab.marvell.com [10.28.34.14])\n by maili.marvell.com (Postfix) with ESMTP id B17B43F7088;\n Sat, 4 Dec 2021 09:28:43 -0800 (PST)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com;\n h=from : to : cc :\n subject : date : message-id : mime-version : content-transfer-encoding :\n content-type; s=pfpt0220; bh=JfXLgNL7AdNnkdOZrrZ7xJL4/1/FUrEQcVcvn9GqNI0=;\n b=ZxfV1/qYw6hX14IOmr+p5axDT4HBzg08quIYxSShCbPXj8QgZNitawFuZIW3tD1RukZf\n UDa0avXldjy5I+hLC7uRPHUVKUabqao/uVdFmXhk2xYRANYu5CPsW3kerBOk3mWAc02s\n 6wLoH1xHYW2Tx4gSGTr/cE8BBAFt3FprpYrjLYA1fGJnUiLclSPwqGi26bmzq/3Lu+uJ\n YEbNGLYz5B406FrA4fvljP/UkDJWC3LBAlnm6VeIP350nkkukjr91cJsWouC/bLjZhph\n bD1s3lj8e6WiTH8zLAAPUFtqQOqlATYzSuyJNJhecclga9TKSx7SmLJQ+YcTLUcFelrh gQ==", "From": "<jerinj@marvell.com>", "To": "<dev@dpdk.org>, Ray Kinsella <mdr@ashroe.eu>, Thomas Monjalon\n <thomas@monjalon.net>, Ferruh Yigit <ferruh.yigit@intel.com>, \"Andrew\n Rybchenko\" <andrew.rybchenko@oktetlabs.ru>", "CC": "<ajit.khaparde@broadcom.com>, <aboyer@pensando.io>,\n <beilei.xing@intel.com>, <bruce.richardson@intel.com>, <chas3@att.com>,\n <chenbo.xia@intel.com>, <ciara.loftus@intel.com>,\n <dsinghrawat@marvell.com>, <ed.czeck@atomicrules.com>,\n <evgenys@amazon.com>, <grive@u256.net>, <g.singh@nxp.com>,\n <zhouguoyang@huawei.com>, <haiyue.wang@intel.com>,\n <hkalra@marvell.com>, <heinrich.kuhn@corigine.com>,\n <hemant.agrawal@nxp.com>, <hyonkim@cisco.com>, <igorch@amazon.com>,\n <irusskikh@marvell.com>, <jgrajcia@cisco.com>,\n <jasvinder.singh@intel.com>, <jianwang@trustnetic.com>,\n <jiawenwu@trustnetic.com>, <jingjing.wu@intel.com>,\n <johndale@cisco.com>, <john.miller@atomicrules.com>,\n <linville@tuxdriver.com>, <keith.wiles@intel.com>,\n <kirankumark@marvell.com>, <oulijun@huawei.com>, <lironh@marvell.com>,\n <longli@microsoft.com>, <mw@semihalf.com>, <spinler@cesnet.cz>,\n <matan@nvidia.com>, <matt.peters@windriver.com>,\n <maxime.coquelin@redhat.com>, <mk@semihalf.com>, <humin29@huawei.com>,\n <pnalla@marvell.com>, <ndabilpuram@marvell.com>,\n <qiming.yang@intel.com>, <qi.z.zhang@intel.com>, <radhac@marvell.com>,\n <rahul.lakkireddy@chelsio.com>, <rmody@marvell.com>,\n <rosen.xu@intel.com>, <sachin.saxena@oss.nxp.com>,\n <skoteshwar@marvell.com>, <shshaikh@marvell.com>,\n <shaibran@amazon.com>, <shepard.siegel@atomicrules.com>,\n <asomalap@amd.com>, <somnath.kotur@broadcom.com>,\n <sthemmin@microsoft.com>, <steven.webster@windriver.com>,\n <skori@marvell.com>, <mtetsuyah@gmail.com>, <vburru@marvell.com>,\n <viacheslavo@nvidia.com>, <xiao.w.wang@intel.com>,\n <cloud.wangxiaoyun@huawei.com>, <yisen.zhuang@huawei.com>,\n <yongwang@vmware.com>, <xuanziyang2@huawei.com>, Jerin Jacob\n <jerinj@marvell.com>", "Subject": "[dpdk-dev] [PATCH] ethdev: support queue-based priority flow control", "Date": "Sat, 4 Dec 2021 22:54:58 +0530", "Message-ID": "<20211204172458.1904300-1-jerinj@marvell.com>", "X-Mailer": "git-send-email 2.34.1", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Content-Type": "text/plain", "X-Proofpoint-GUID": "awfiGvI4ICld-TSrh5R97pUKjdSopvOd", "X-Proofpoint-ORIG-GUID": "awfiGvI4ICld-TSrh5R97pUKjdSopvOd", "X-Proofpoint-Virus-Version": "vendor=baseguard\n engine=ICAP:2.0.205,Aquarius:18.0.790,Hydra:6.0.425,FMLib:17.11.62.513\n definitions=2021-12-04_06,2021-12-02_01,2021-12-02_01", "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": "From: Jerin Jacob <jerinj@marvell.com>\n\nBased on device support and use-case need, there are two different ways\nto enable PFC. The first case is the port level PFC configuration, in\nthis case, rte_eth_dev_priority_flow_ctrl_set() API shall be used to\nconfigure the PFC, and PFC frames will be generated using based on VLAN\nTC value.\n\nThe second case is the queue level PFC configuration, in this\ncase, Any packet field content can be used to steer the packet to the\nspecific queue using rte_flow or RSS and then use\nrte_eth_dev_priority_flow_ctrl_queue_set() to set the TC mapping on each\nqueue. Based on congestion selected on the specific queue, configured TC\nshall be used to generate PFC frames.\n\nOperation of these modes are mutually exclusive, when driver sets\nnon zero value for rte_eth_dev_info::pfc_queue_tc_max,\napplication must use queue level PFC configuration via\nrte_eth_dev_priority_flow_ctrl_queue_set() API instead of port level\nPFC configuration via rte_eth_dev_priority_flow_ctrl_set() API to\nrealize PFC configuration.\n\nThis patch enables the configuration for second case a.k.a queue\nbased PFC also updates rte_eth_dev_priority_flow_ctrl_set()\nimplmentaion to adheher to rte_eth_dev_info::pfc_queue_tc_max\nhandling.\n\nAlso updated libabigail.abignore to ignore the update\nto reserved fields in rte_eth_dev_info.\n\nSigned-off-by: Jerin Jacob <jerinj@marvell.com>\n---\n devtools/libabigail.abignore | 6 ++\n doc/guides/nics/features.rst | 5 +-\n doc/guides/rel_notes/release_22_03.rst | 4 ++\n lib/ethdev/ethdev_driver.h | 6 +-\n lib/ethdev/rte_ethdev.c | 73 ++++++++++++++++++++++++\n lib/ethdev/rte_ethdev.h | 77 +++++++++++++++++++++++++-\n lib/ethdev/version.map | 3 +\n 7 files changed, 168 insertions(+), 6 deletions(-)", "diff": "diff --git a/devtools/libabigail.abignore b/devtools/libabigail.abignore\nindex 4b676f317d..e5686115f7 100644\n--- a/devtools/libabigail.abignore\n+++ b/devtools/libabigail.abignore\n@@ -11,3 +11,9 @@\n ; Ignore generated PMD information strings\n [suppress_variable]\n name_regexp = _pmd_info$\n+\n+; Ignore fields inserted in place of reserved fields of rte_eth_dev_info\n+[suppress_type]\n+ name = rte_eth_dev_info\n+ has_data_member_inserted_between = {offset_after(switch_info), end}\n+\ndiff --git a/doc/guides/nics/features.rst b/doc/guides/nics/features.rst\nindex 27be2d2576..6bb7337c58 100644\n--- a/doc/guides/nics/features.rst\n+++ b/doc/guides/nics/features.rst\n@@ -379,9 +379,10 @@ Flow control\n Supports configuring link flow control.\n \n * **[implements] eth_dev_ops**: ``flow_ctrl_get``, ``flow_ctrl_set``,\n- ``priority_flow_ctrl_set``.\n+ ``priority_flow_ctrl_set``, ``priority_flow_ctrl_queue_set_t``.\n * **[related] API**: ``rte_eth_dev_flow_ctrl_get()``, ``rte_eth_dev_flow_ctrl_set()``,\n- ``rte_eth_dev_priority_flow_ctrl_set()``.\n+ ``rte_eth_dev_priority_flow_ctrl_set()``, ``rte_eth_dev_priority_flow_ctrl_queue_set()``.\n+* **[provides] rte_eth_dev_info**: ``pfc_queue_tc_max``.\n \n \n .. _nic_features_rate_limitation:\ndiff --git a/doc/guides/rel_notes/release_22_03.rst b/doc/guides/rel_notes/release_22_03.rst\nindex 6d99d1eaa9..f336ee2996 100644\n--- a/doc/guides/rel_notes/release_22_03.rst\n+++ b/doc/guides/rel_notes/release_22_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 an API to enable queue based priority flow ctrl(PFC).**\n+\n+ A new API, ``rte_eth_dev_priority_flow_ctrl_queue_set()``, was added.\n+\n \n Removed Items\n -------------\ndiff --git a/lib/ethdev/ethdev_driver.h b/lib/ethdev/ethdev_driver.h\nindex d95605a355..0cbd434152 100644\n--- a/lib/ethdev/ethdev_driver.h\n+++ b/lib/ethdev/ethdev_driver.h\n@@ -532,6 +532,9 @@ typedef int (*flow_ctrl_set_t)(struct rte_eth_dev *dev,\n /** @internal Setup priority flow control parameter on an Ethernet device. */\n typedef int (*priority_flow_ctrl_set_t)(struct rte_eth_dev *dev,\n \t\t\t\tstruct rte_eth_pfc_conf *pfc_conf);\n+/** @internal Queue setup for priority flow control parameter on an Ethernet device. */\n+typedef int (*priority_flow_ctrl_queue_set_t)(struct rte_eth_dev *dev,\n+\t\tuint16_t queue_id, struct rte_eth_pfc_queue_conf *pfc_queue_conf);\n \n /** @internal Update RSS redirection table on an Ethernet device. */\n typedef int (*reta_update_t)(struct rte_eth_dev *dev,\n@@ -1080,7 +1083,8 @@ struct eth_dev_ops {\n \tflow_ctrl_set_t flow_ctrl_set; /**< Setup flow control */\n \t/** Setup priority flow control */\n \tpriority_flow_ctrl_set_t priority_flow_ctrl_set;\n-\n+\t/** Priority flow control queue setup */\n+\tpriority_flow_ctrl_queue_set_t priority_flow_ctrl_queue_set;\n \t/** Set Unicast Table Array */\n \teth_uc_hash_table_set_t uc_hash_table_set;\n \t/** Set Unicast hash bitmap */\ndiff --git a/lib/ethdev/rte_ethdev.c b/lib/ethdev/rte_ethdev.c\nindex a1d475a292..86e0adac24 100644\n--- a/lib/ethdev/rte_ethdev.c\n+++ b/lib/ethdev/rte_ethdev.c\n@@ -3998,7 +3998,9 @@ int\n rte_eth_dev_priority_flow_ctrl_set(uint16_t port_id,\n \t\t\t\t struct rte_eth_pfc_conf *pfc_conf)\n {\n+\tstruct rte_eth_dev_info dev_info;\n \tstruct rte_eth_dev *dev;\n+\tint ret;\n \n \tRTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV);\n \tdev = &rte_eth_devices[port_id];\n@@ -4010,6 +4012,17 @@ rte_eth_dev_priority_flow_ctrl_set(uint16_t port_id,\n \t\treturn -EINVAL;\n \t}\n \n+\tret = rte_eth_dev_info_get(port_id, &dev_info);\n+\tif (ret != 0)\n+\t\treturn ret;\n+\n+\tif (dev_info.pfc_queue_tc_max != 0) {\n+\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\"Ethdev port %u driver does not support port level PFC config\\n\",\n+\t\t\tport_id);\n+\t\treturn -ENOTSUP;\n+\t}\n+\n \tif (pfc_conf->priority > (RTE_ETH_DCB_NUM_USER_PRIORITIES - 1)) {\n \t\tRTE_ETHDEV_LOG(ERR, \"Invalid priority, only 0-7 allowed\\n\");\n \t\treturn -EINVAL;\n@@ -4022,6 +4035,66 @@ rte_eth_dev_priority_flow_ctrl_set(uint16_t port_id,\n \treturn -ENOTSUP;\n }\n \n+int\n+rte_eth_dev_priority_flow_ctrl_queue_set(\n+\tuint16_t port_id, uint16_t queue_id,\n+\tstruct rte_eth_pfc_queue_conf *pfc_queue_conf)\n+{\n+\tstruct rte_eth_dev_info dev_info;\n+\tstruct rte_eth_dev *dev;\n+\tint ret;\n+\n+\tRTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV);\n+\tdev = &rte_eth_devices[port_id];\n+\n+\tif (pfc_queue_conf == NULL) {\n+\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\"Cannot set ethdev port %u queue %d PFC from NULL config\\n\",\n+\t\t\tport_id, queue_id);\n+\t\treturn -EINVAL;\n+\t}\n+\n+\tret = rte_eth_dev_info_get(port_id, &dev_info);\n+\tif (ret != 0)\n+\t\treturn ret;\n+\n+\tif (dev_info.pfc_queue_tc_max == 0) {\n+\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\"Ethdev port %u driver does not support PFC TC values\\n\",\n+\t\t\tport_id);\n+\t\treturn -ENOTSUP;\n+\t}\n+\n+\tif (pfc_queue_conf->mode != RTE_ETH_FC_TX_PAUSE &&\n+\t queue_id >= dev_info.nb_rx_queues) {\n+\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\"PFC Rx queue not in range(requested: %d configured: %d)\\n\",\n+\t\t\tqueue_id, dev_info.nb_rx_queues);\n+\t\treturn -EINVAL;\n+\t}\n+\n+\tif (pfc_queue_conf->mode != RTE_ETH_FC_RX_PAUSE &&\n+\t queue_id >= dev_info.nb_tx_queues) {\n+\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\"PFC Tx queue not in range(requested: %d configured: %d)\\n\",\n+\t\t\tqueue_id, dev_info.nb_tx_queues);\n+\t\treturn -EINVAL;\n+\t}\n+\n+\tif (pfc_queue_conf->tc >= dev_info.pfc_queue_tc_max) {\n+\t\tRTE_ETHDEV_LOG(ERR,\n+\t\t\t\"PFC TC not in range(requested: %d max: %d)\\n\",\n+\t\t\tpfc_queue_conf->tc, dev_info.pfc_queue_tc_max);\n+\t\treturn -EINVAL;\n+\t}\n+\n+\tif (*dev->dev_ops->priority_flow_ctrl_queue_set)\n+\t\treturn eth_err(port_id,\n+\t\t\t (*dev->dev_ops->priority_flow_ctrl_queue_set)(\n+\t\t\t\t dev, queue_id, pfc_queue_conf));\n+\treturn -ENOTSUP;\n+}\n+\n static int\n eth_check_reta_mask(struct rte_eth_rss_reta_entry64 *reta_conf,\n \t\t\tuint16_t reta_size)\ndiff --git a/lib/ethdev/rte_ethdev.h b/lib/ethdev/rte_ethdev.h\nindex fa299c8ad7..b40e54576f 100644\n--- a/lib/ethdev/rte_ethdev.h\n+++ b/lib/ethdev/rte_ethdev.h\n@@ -1395,6 +1395,19 @@ struct rte_eth_pfc_conf {\n \tuint8_t priority; /**< VLAN User Priority. */\n };\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change, or be removed, without prior notice\n+ *\n+ * A structure used to configure Ethernet priority flow control parameter for\n+ * ethdev queues.\n+ */\n+struct rte_eth_pfc_queue_conf {\n+\tuint8_t tc; /**< Traffic class as per PFC (802.1Qbb) specification */\n+\tuint16_t pause_time; /**< Pause quota in the Pause frame */\n+\tenum rte_eth_fc_mode mode; /**< Link flow control mode */\n+};\n+\n /**\n * Tunnel type for device-specific classifier configuration.\n * @see rte_eth_udp_tunnel\n@@ -1841,8 +1854,30 @@ struct rte_eth_dev_info {\n \t * embedded managed interconnect/switch.\n \t */\n \tstruct rte_eth_switch_info switch_info;\n-\n-\tuint64_t reserved_64s[2]; /**< Reserved for future fields */\n+\t/**\n+\t * Maximum supported traffic class as per PFC (802.1Qbb) specification.\n+\t *\n+\t * Based on device support and use-case need, there are two different\n+\t * ways to enable PFC. The first case is the port level PFC\n+\t * configuration, in this case, rte_eth_dev_priority_flow_ctrl_set()\n+\t * API shall be used to configure the PFC, and PFC frames will be\n+\t * generated using based on VLAN TC value.\n+\t * The second case is the queue level PFC configuration, in this case,\n+\t * Any packet field content can be used to steer the packet to the\n+\t * specific queue using rte_flow or RSS and then use\n+\t * rte_eth_dev_priority_flow_ctrl_queue_set() to set the TC mapping\n+\t * on each queue. Based on congestion selected on the specific queue,\n+\t * configured TC shall be used to generate PFC frames.\n+\t *\n+\t * When set to non zero value, application must use queue level\n+\t * PFC configuration via rte_eth_dev_priority_flow_ctrl_queue_set() API\n+\t * instead of port level PFC configuration via\n+\t * rte_eth_dev_priority_flow_ctrl_set() API to realize\n+\t * PFC configuration.\n+\t */\n+\tuint8_t pfc_queue_tc_max;\n+\tuint8_t reserved_8s[7];\n+\tuint64_t reserved_64s[1]; /**< Reserved for future fields */\n \tvoid *reserved_ptrs[2]; /**< Reserved for future fields */\n };\n \n@@ -4109,6 +4144,9 @@ int rte_eth_dev_flow_ctrl_set(uint16_t port_id,\n * Configure the Ethernet priority flow control under DCB environment\n * for Ethernet device.\n *\n+ * @see struct rte_eth_dev_info::pfc_queue_tc_max priority\n+ * flow control usage models.\n+ *\n * @param port_id\n * The port identifier of the Ethernet device.\n * @param pfc_conf\n@@ -4119,10 +4157,43 @@ int rte_eth_dev_flow_ctrl_set(uint16_t port_id,\n * - (-ENODEV) if *port_id* invalid.\n * - (-EINVAL) if bad parameter\n * - (-EIO) if flow control setup failure or device is removed.\n+ *\n */\n int rte_eth_dev_priority_flow_ctrl_set(uint16_t port_id,\n-\t\t\t\tstruct rte_eth_pfc_conf *pfc_conf);\n+\t\t\t\t struct rte_eth_pfc_conf *pfc_conf);\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Configure the Ethernet priority flow control for a given queue\n+ * for Ethernet device.\n+ *\n+ * @see struct rte_eth_dev_info::pfc_queue_tc_max priority flow control\n+ * usage models.\n+ *\n+ * @note When an ethdev port switches to PFC mode, the unconfigured\n+ * queues shall be configured by the driver with default values such as\n+ * lower priority value for TC etc.\n+ *\n+ * @param port_id\n+ * The port identifier of the Ethernet device.\n+ * @param queue_id\n+ * The Rx/Tx queue to apply the PFC configuration.\n+ * @note pfc_queue_conf::mode depicts the queue direction(Rx and/or Tx)\n+ * @param pfc_queue_conf\n+ * The pointer to the structure of the priority flow control parameters\n+ * for the queue.\n+ * @return\n+ * - (0) if successful.\n+ * - (-ENOTSUP) if hardware doesn't support priority flow control mode.\n+ * - (-ENODEV) if *port_id* invalid.\n+ * - (-EINVAL) if bad parameter\n+ * - (-EIO) if flow control setup queue failure\n+ */\n+__rte_experimental\n+int rte_eth_dev_priority_flow_ctrl_queue_set(uint16_t port_id, uint16_t queue_id,\n+\t\t\t\t\t struct rte_eth_pfc_queue_conf *pfc_queue_conf);\n /**\n * Add a MAC address to the set used for filtering incoming packets.\n *\ndiff --git a/lib/ethdev/version.map b/lib/ethdev/version.map\nindex c2fb0669a4..8f361ec15a 100644\n--- a/lib/ethdev/version.map\n+++ b/lib/ethdev/version.map\n@@ -256,6 +256,9 @@ EXPERIMENTAL {\n \trte_flow_flex_item_create;\n \trte_flow_flex_item_release;\n \trte_flow_pick_transfer_proxy;\n+\n+\t# added in 22.03\n+\trte_eth_dev_priority_flow_ctrl_queue_set;\n };\n \n INTERNAL {\n", "prefixes": [] }