From patchwork Thu Nov 23 13:59:12 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "lihuisong (C)" X-Patchwork-Id: 134563 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 0BA3A433AB; Thu, 23 Nov 2023 14:59:26 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7236542F81; Thu, 23 Nov 2023 14:59:17 +0100 (CET) Received: from szxga02-in.huawei.com (szxga02-in.huawei.com [45.249.212.188]) by mails.dpdk.org (Postfix) with ESMTP id 6B50442F17 for ; Thu, 23 Nov 2023 14:59:15 +0100 (CET) Received: from kwepemm000004.china.huawei.com (unknown [172.30.72.57]) by szxga02-in.huawei.com (SkyGuard) with ESMTP id 4Sbfph6FDZzWhlw; Thu, 23 Nov 2023 21:58:36 +0800 (CST) Received: from localhost.localdomain (10.69.192.56) by kwepemm000004.china.huawei.com (7.193.23.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Thu, 23 Nov 2023 21:59:11 +0800 From: Huisong Li To: , , , Chengwen Feng , Jie Hai , Dongdong Liu CC: , Subject: [PATCH 1/5] doc/features: add RSS hash algorithm feature Date: Thu, 23 Nov 2023 21:59:12 +0800 Message-ID: <20231123135916.33315-2-lihuisong@huawei.com> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20231123135916.33315-1-lihuisong@huawei.com> References: <20231123135916.33315-1-lihuisong@huawei.com> MIME-Version: 1.0 X-Originating-IP: [10.69.192.56] X-ClientProxiedBy: dggems704-chm.china.huawei.com (10.3.19.181) To kwepemm000004.china.huawei.com (7.193.23.18) 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 Add hash algorithm feature introduced by 23.11 and fix some RSS features description. Fixes: 34ff088cc241 ("ethdev: set and query RSS hash algorithm") Signed-off-by: Huisong Li --- doc/guides/nics/features.rst | 25 +++++++++++++++++++++---- 1 file changed, 21 insertions(+), 4 deletions(-) diff --git a/doc/guides/nics/features.rst b/doc/guides/nics/features.rst index 1a1dc16c1e..dfa6f087c8 100644 --- a/doc/guides/nics/features.rst +++ b/doc/guides/nics/features.rst @@ -277,10 +277,12 @@ RSS hash Supports RSS hashing on RX. * **[uses] user config**: ``dev_conf.rxmode.mq_mode`` = ``RTE_ETH_MQ_RX_RSS_FLAG``. -* **[uses] user config**: ``dev_conf.rx_adv_conf.rss_conf``. +* **[uses] user config**: ``rss_conf.rss_hf``. * **[uses] rte_eth_rxconf,rte_eth_rxmode**: ``offloads:RTE_ETH_RX_OFFLOAD_RSS_HASH``. * **[provides] rte_eth_dev_info**: ``flow_type_rss_offloads``. * **[provides] mbuf**: ``mbuf.ol_flags:RTE_MBUF_F_RX_RSS_HASH``, ``mbuf.rss``. +* **[related] API**: ``rte_eth_dev_configure``, ``rte_eth_dev_rss_hash_update`` + ``rte_eth_dev_rss_hash_conf_get()``. .. _nic_features_inner_rss: @@ -288,7 +290,7 @@ Supports RSS hashing on RX. Inner RSS --------- -Supports RX RSS hashing on Inner headers. +Supports RX RSS hashing on Inner headers by rte_flow API. * **[uses] rte_flow_action_rss**: ``level``. * **[uses] rte_eth_rxconf,rte_eth_rxmode**: ``offloads:RTE_ETH_RX_OFFLOAD_RSS_HASH``. @@ -303,9 +305,24 @@ RSS key update Supports configuration of Receive Side Scaling (RSS) hash computation. Updating Receive Side Scaling (RSS) hash key. -* **[implements] eth_dev_ops**: ``rss_hash_update``, ``rss_hash_conf_get``. +* **[implements] eth_dev_ops**: ``dev_configure``, ``rss_hash_update``, ``rss_hash_conf_get``. +* **[uses] user config**: ``rss_conf.rss_key``, ``rss_conf.rss_key_len`` * **[provides] rte_eth_dev_info**: ``hash_key_size``. -* **[related] API**: ``rte_eth_dev_rss_hash_update()``, +* **[related] API**: ``rte_eth_dev_configure``, ``rte_eth_dev_rss_hash_update()``, + ``rte_eth_dev_rss_hash_conf_get()``. + +.. _nic_features_rss_hash_algo_update: + +RSS hash algorithm update +-------------- + +Supports configuration of Receive Side Scaling (RSS) hash algorithm. Updating +RSS hash algorithm. + +* **[implements] eth_dev_ops**: ``dev_configure``, ``rss_hash_update``, ``rss_hash_conf_get``. +* **[uses] user config**: ``rss_conf.algorithm`` +* **[provides] rte_eth_dev_info**: ``rss_algo_capa``. +* **[related] API**: ``rte_eth_dev_configure``, ``rte_eth_dev_rss_hash_update()``, ``rte_eth_dev_rss_hash_conf_get()``. From patchwork Thu Nov 23 13:59:13 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "lihuisong (C)" X-Patchwork-Id: 134562 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 36A1A433AB; Thu, 23 Nov 2023 14:59:16 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id D989742F76; Thu, 23 Nov 2023 14:59:15 +0100 (CET) Received: from szxga01-in.huawei.com (szxga01-in.huawei.com [45.249.212.187]) by mails.dpdk.org (Postfix) with ESMTP id E996C42F17 for ; Thu, 23 Nov 2023 14:59:14 +0100 (CET) Received: from kwepemm000004.china.huawei.com (unknown [172.30.72.54]) by szxga01-in.huawei.com (SkyGuard) with ESMTP id 4Sbfpv265NzvQwg; Thu, 23 Nov 2023 21:58:47 +0800 (CST) Received: from localhost.localdomain (10.69.192.56) by kwepemm000004.china.huawei.com (7.193.23.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Thu, 23 Nov 2023 21:59:12 +0800 From: Huisong Li To: , , , Changchun Ouyang CC: , Subject: [PATCH 2/5] doc/features: add link up/down feature Date: Thu, 23 Nov 2023 21:59:13 +0800 Message-ID: <20231123135916.33315-3-lihuisong@huawei.com> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20231123135916.33315-1-lihuisong@huawei.com> References: <20231123135916.33315-1-lihuisong@huawei.com> MIME-Version: 1.0 X-Originating-IP: [10.69.192.56] X-ClientProxiedBy: dggems704-chm.china.huawei.com (10.3.19.181) To kwepemm000004.china.huawei.com (7.193.23.18) 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 Add link up/down feature for features.rst. Fixes: 915e67837586 ("ethdev: API for link up and down") Cc: stable@dpdk.org Signed-off-by: Huisong Li --- doc/guides/nics/features.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/guides/nics/features.rst b/doc/guides/nics/features.rst index dfa6f087c8..1c0cf2cea7 100644 --- a/doc/guides/nics/features.rst +++ b/doc/guides/nics/features.rst @@ -41,10 +41,13 @@ Link status Supports getting the link speed, duplex mode and link state (up/down). -* **[implements] eth_dev_ops**: ``link_update``. +* **[implements] eth_dev_ops**: ``link_update``, ``dev_set_link_up``, ``dev_set_link_down``. * **[implements] rte_eth_dev_data**: ``dev_link``. * **[related] API**: ``rte_eth_link_get()``, ``rte_eth_link_get_nowait()``. +Set link up/down an Ethernet device. + +* **[related] API**: ``rte_eth_dev_set_link_up()``, ``rte_eth_dev_set_link_down()``. .. _nic_features_link_status_event: From patchwork Thu Nov 23 13:59:14 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "lihuisong (C)" X-Patchwork-Id: 134565 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 5AFE0433AB; Thu, 23 Nov 2023 14:59:40 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A959542F93; Thu, 23 Nov 2023 14:59:19 +0100 (CET) Received: from szxga03-in.huawei.com (szxga03-in.huawei.com [45.249.212.189]) by mails.dpdk.org (Postfix) with ESMTP id 87F3042F2B for ; Thu, 23 Nov 2023 14:59:15 +0100 (CET) Received: from kwepemm000004.china.huawei.com (unknown [172.30.72.56]) by szxga03-in.huawei.com (SkyGuard) with ESMTP id 4Sbfjw2nWhzMn06; Thu, 23 Nov 2023 21:54:28 +0800 (CST) Received: from localhost.localdomain (10.69.192.56) by kwepemm000004.china.huawei.com (7.193.23.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Thu, 23 Nov 2023 21:59:12 +0800 From: Huisong Li To: , , CC: , Subject: [PATCH 3/5] doc/features: add config interface for speed capabilities Date: Thu, 23 Nov 2023 21:59:14 +0800 Message-ID: <20231123135916.33315-4-lihuisong@huawei.com> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20231123135916.33315-1-lihuisong@huawei.com> References: <20231123135916.33315-1-lihuisong@huawei.com> MIME-Version: 1.0 X-Originating-IP: [10.69.192.56] X-ClientProxiedBy: dggems704-chm.china.huawei.com (10.3.19.181) To kwepemm000004.china.huawei.com (7.193.23.18) 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 Cc: stable@dpdk.org Signed-off-by: Huisong Li --- doc/guides/nics/features.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/guides/nics/features.rst b/doc/guides/nics/features.rst index 1c0cf2cea7..a5026a0aa8 100644 --- a/doc/guides/nics/features.rst +++ b/doc/guides/nics/features.rst @@ -31,6 +31,7 @@ Speed capabilities Supports getting the speed capabilities that the current device is capable of. * **[provides] rte_eth_dev_info**: ``speed_capa:RTE_ETH_LINK_SPEED_*``. +* **[uses] user config**: ``dev_conf.link_speeds``. * **[related] API**: ``rte_eth_dev_info_get()``. From patchwork Thu Nov 23 13:59:15 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "lihuisong (C)" X-Patchwork-Id: 134564 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 3E4C5433AB; Thu, 23 Nov 2023 14:59:33 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7E5E942F87; Thu, 23 Nov 2023 14:59:18 +0100 (CET) Received: from szxga03-in.huawei.com (szxga03-in.huawei.com [45.249.212.189]) by mails.dpdk.org (Postfix) with ESMTP id 8F48342F6F for ; Thu, 23 Nov 2023 14:59:15 +0100 (CET) Received: from kwepemm000004.china.huawei.com (unknown [172.30.72.54]) by szxga03-in.huawei.com (SkyGuard) with ESMTP id 4Sbfjw72mxzMnCP; Thu, 23 Nov 2023 21:54:28 +0800 (CST) Received: from localhost.localdomain (10.69.192.56) by kwepemm000004.china.huawei.com (7.193.23.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Thu, 23 Nov 2023 21:59:13 +0800 From: Huisong Li To: , , , Cristian Dumitrescu , Balasubramanian Manoharan , Jerin Jacob , Hemant Agrawal CC: , Subject: [PATCH 4/5] doc/features: add Traffic Manager features Date: Thu, 23 Nov 2023 21:59:15 +0800 Message-ID: <20231123135916.33315-5-lihuisong@huawei.com> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20231123135916.33315-1-lihuisong@huawei.com> References: <20231123135916.33315-1-lihuisong@huawei.com> MIME-Version: 1.0 X-Originating-IP: [10.69.192.56] X-ClientProxiedBy: dggems704-chm.china.huawei.com (10.3.19.181) To kwepemm000004.china.huawei.com (7.193.23.18) 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 Add Traffic Manager features. Fixes: 5d109deffa87 ("ethdev: add traffic management API") Cc: stable@dpdk.org Signed-off-by: Huisong Li --- doc/guides/nics/features.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/guides/nics/features.rst b/doc/guides/nics/features.rst index a5026a0aa8..69fbf737b8 100644 --- a/doc/guides/nics/features.rst +++ b/doc/guides/nics/features.rst @@ -761,6 +761,19 @@ Supports congestion management. ``rte_eth_cman_config_set()``, ``rte_eth_cman_config_get()``. +.. _nic_features_traffic_manager: + +Traffic manager +--------------------- + +Supports Traffic manager. + +* **[implements] rte_tm_ops**: ``capabilities_get``, ``shaper_profile_add``, + ``hierarchy_commit`` and so on. +* **[related] API**: ``rte_tm_capabilities_get()``, ``rte_tm_shaper_profile_add()``, + ``rte_tm_hierarchy_commit()`` and so on. + + .. _nic_features_fw_version: FW version From patchwork Thu Nov 23 13:59:16 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "lihuisong (C)" X-Patchwork-Id: 134566 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 2454F433AB; Thu, 23 Nov 2023 14:59:53 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id E33C442FA5; Thu, 23 Nov 2023 14:59:21 +0100 (CET) Received: from szxga08-in.huawei.com (szxga08-in.huawei.com [45.249.212.255]) by mails.dpdk.org (Postfix) with ESMTP id 0C30642F77 for ; Thu, 23 Nov 2023 14:59:16 +0100 (CET) Received: from kwepemm000004.china.huawei.com (unknown [172.30.72.53]) by szxga08-in.huawei.com (SkyGuard) with ESMTP id 4SbflN0SPBz1P8gB; Thu, 23 Nov 2023 21:55:44 +0800 (CST) Received: from localhost.localdomain (10.69.192.56) by kwepemm000004.china.huawei.com (7.193.23.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Thu, 23 Nov 2023 21:59:13 +0800 From: Huisong Li To: , , , Ajit Khaparde , Ferruh Yigit , =?utf-8?q?Morten_Br=C3=B8rup?= , Ray Kinsella , "Min Hu (Connor)" CC: , Subject: [PATCH 5/5] doc/features: add dump device private information feature Date: Thu, 23 Nov 2023 21:59:16 +0800 Message-ID: <20231123135916.33315-6-lihuisong@huawei.com> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20231123135916.33315-1-lihuisong@huawei.com> References: <20231123135916.33315-1-lihuisong@huawei.com> MIME-Version: 1.0 X-Originating-IP: [10.69.192.56] X-ClientProxiedBy: dggems704-chm.china.huawei.com (10.3.19.181) To kwepemm000004.china.huawei.com (7.193.23.18) 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 Add dump device private information feature. Fixes: edcf22c6d389 ("ethdev: introduce dump API") Cc: stable@dpdk.org Signed-off-by: Huisong Li --- doc/guides/nics/features.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/guides/nics/features.rst b/doc/guides/nics/features.rst index 69fbf737b8..bae1a1faab 100644 --- a/doc/guides/nics/features.rst +++ b/doc/guides/nics/features.rst @@ -820,6 +820,18 @@ registers and register size). * **[related] API**: ``rte_eth_dev_get_reg_info()``. +.. _nic_features_device_private_info_dump: + +Device private information dump +-------------- + +Supports retrieving device private information to a file. Provided data and +the order depends on PMD. + +* **[mplements] eth_dev_ops**: ``eth_dev_priv_dump``. +* **[related] API**: ``rte_eth_dev_priv_dump()``. + + .. _nic_features_led: LED