From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id EDD7242C0E; Fri, 2 Jun 2023 09:52:26 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 298E842D0B; Fri, 2 Jun 2023 09:52:18 +0200 (CEST) Received: from szxga08-in.huawei.com (szxga08-in.huawei.com [45.249.212.255]) by mails.dpdk.org (Postfix) with ESMTP id A0FED406B8 for ; Fri, 2 Jun 2023 09:52:14 +0200 (CEST) Received: from dggpeml500011.china.huawei.com (unknown [172.30.72.55]) by szxga08-in.huawei.com (SkyGuard) with ESMTP id 4QXZpq2X5yz18M55; Fri, 2 Jun 2023 15:47:31 +0800 (CST) Received: from localhost.huawei.com (10.50.163.32) by dggpeml500011.china.huawei.com (7.185.36.84) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Fri, 2 Jun 2023 15:52:12 +0800 From: Dengdui Huang To: CC: , , , , , , , , , Subject: [PATCH v4 1/2] ethdev: add API to check if queue is valid Date: Fri, 2 Jun 2023 15:52:10 +0800 Message-ID: <20230602075211.3628165-2-huangdengdui@huawei.com> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20230602075211.3628165-1-huangdengdui@huawei.com> References: <20230516110021.1801443-1-huangdengdui@huawei.com> <20230602075211.3628165-1-huangdengdui@huawei.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.50.163.32] X-ClientProxiedBy: dggems706-chm.china.huawei.com (10.3.19.183) To dggpeml500011.china.huawei.com (7.185.36.84) X-CFilter-Loop: Reflected X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org The API rte_eth_dev_is_valid_rxq/txq which is used to check if Rx/Tx queue is valid. If the queue has been setup, it is considered valid. Signed-off-by: Dengdui Huang --- doc/guides/rel_notes/release_23_07.rst | 6 ++++ lib/ethdev/rte_ethdev.c | 22 +++++++++++++++ lib/ethdev/rte_ethdev.h | 38 ++++++++++++++++++++++++++ lib/ethdev/version.map | 2 ++ 4 files changed, 68 insertions(+) diff --git a/doc/guides/rel_notes/release_23_07.rst b/doc/guides/rel_notes/release_23_07.rst index 0d3cada5d0..1332fa3a5a 100644 --- a/doc/guides/rel_notes/release_23_07.rst +++ b/doc/guides/rel_notes/release_23_07.rst @@ -83,6 +83,12 @@ New Features for new capability registers, large passthrough BAR and some performance enhancements for UPT. +* **Added ethdev Rx/Tx queue ID check API.** + + Added ethdev Rx/Tx queue ID check API which provides functions + for check if Rx/Tx queue is valid. If the queue has been setup, + it is considered valid. + Removed Items ------------- diff --git a/lib/ethdev/rte_ethdev.c b/lib/ethdev/rte_ethdev.c index d46e74504e..a134928c8a 100644 --- a/lib/ethdev/rte_ethdev.c +++ b/lib/ethdev/rte_ethdev.c @@ -771,6 +771,28 @@ eth_dev_validate_tx_queue(const struct rte_eth_dev *dev, uint16_t tx_queue_id) return 0; } +int +rte_eth_dev_is_valid_rxq(uint16_t port_id, uint16_t queue_id) +{ + struct rte_eth_dev *dev; + + RTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV); + dev = &rte_eth_devices[port_id]; + + return eth_dev_validate_rx_queue(dev, queue_id); +} + +int +rte_eth_dev_is_valid_txq(uint16_t port_id, uint16_t queue_id) +{ + struct rte_eth_dev *dev; + + RTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV); + dev = &rte_eth_devices[port_id]; + + return eth_dev_validate_tx_queue(dev, queue_id); +} + int rte_eth_dev_rx_queue_start(uint16_t port_id, uint16_t rx_queue_id) { diff --git a/lib/ethdev/rte_ethdev.h b/lib/ethdev/rte_ethdev.h index 9932413c33..4ef803c244 100644 --- a/lib/ethdev/rte_ethdev.h +++ b/lib/ethdev/rte_ethdev.h @@ -2666,6 +2666,44 @@ int rte_eth_dev_socket_id(uint16_t port_id); */ int rte_eth_dev_is_valid_port(uint16_t port_id); +/** + * @warning + * @b EXPERIMENTAL: this API may change, or be removed, without prior notice + * + * Check if Rx queue is valid. If the queue has been setup, + * it is considered valid. + * + * @param port_id + * The port identifier of the Ethernet device. + * @param queue_id + * The index of the receive queue. + * @return + * - -ENODEV: if *port_id* is valid. + * - -EINVAL: if queue is out of range or not been setup. + * - 0 if Rx queue is valid. + */ +__rte_experimental +int rte_eth_dev_is_valid_rxq(uint16_t port_id, uint16_t queue_id); + +/** + * @warning + * @b EXPERIMENTAL: this API may change, or be removed, without prior notice + * + * Check if Tx queue is valid. If the queue has been setup, + * it is considered valid. + * + * @param port_id + * The port identifier of the Ethernet device. + * @param queue_id + * The index of the transmit queue. + * @return + * - -ENODEV: if *port_id* is valid. + * - -EINVAL: if queue is out of range or not been setup. + * - 0 if Tx queue is valid. + */ +__rte_experimental +int rte_eth_dev_is_valid_txq(uint16_t port_id, uint16_t queue_id); + /** * Start specified Rx queue of a port. It is used when rx_deferred_start * flag of the specified queue is true. diff --git a/lib/ethdev/version.map b/lib/ethdev/version.map index 9d418091ef..3aa6bce156 100644 --- a/lib/ethdev/version.map +++ b/lib/ethdev/version.map @@ -309,6 +309,8 @@ EXPERIMENTAL { rte_flow_async_action_list_handle_destroy; rte_flow_async_action_list_handle_query_update; rte_flow_async_actions_update; + rte_eth_dev_is_valid_rxq; + rte_eth_dev_is_valid_txq; }; INTERNAL { -- 2.33.0