From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 13224A04DC; Mon, 19 Oct 2020 11:16:22 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 3422FE302; Mon, 19 Oct 2020 10:54:32 +0200 (CEST) Received: from qq.com (smtpbg429.qq.com [183.3.255.33]) by dpdk.org (Postfix) with ESMTP id CCC77CFC1 for ; Mon, 19 Oct 2020 10:53:44 +0200 (CEST) X-QQ-mid: bizesmtp6t1603097621txb0goc2o Received: from localhost.localdomain.com (unknown [183.129.236.74]) by esmtp6.qq.com (ESMTP) with id ; Mon, 19 Oct 2020 16:53:41 +0800 (CST) X-QQ-SSF: 01400000002000C0C000B00A0000000 X-QQ-FEAT: 1G/RtVmKuRVLGMkerX2/fjWc5np2kQ4hrg1uAwFN7DKkM7xXw9weg8rO3sxae zgjdcWW4vu3yod48qve7d/+RjETc68N2Ux9OaG+eKK8bR27rGisTrvOVtu96qOifQqNGHBM QdsiHogYtC2QhBZhOzQl2Ilje1EEeHeDEBA2+hCd6B0me2nhnf4C5zfZbpUdvXQlW30QVyj kamqJZ0650cnSJ3gBi8i9NvPIhd13jcNSx6hC3O+IZQK2okJaV3wICzQA1k8MFhWHKPlpaR XIvZmyJeXBRlrhWKt/I5HGiwP6dycoPbZQxhZmpzXg4qxFjQbT/h8EZl3idYDlhn710pyl4 T5kFI0SvPLqSs4fRCa5rDrMBFxq/L8w9OW7deOD X-QQ-GoodBg: 2 From: Jiawen Wu To: dev@dpdk.org Cc: Jiawen Wu Date: Mon, 19 Oct 2020 16:54:15 +0800 Message-Id: <20201019085415.82207-59-jiawenwu@trustnetic.com> X-Mailer: git-send-email 2.18.4 In-Reply-To: <20201019085415.82207-1-jiawenwu@trustnetic.com> References: <20201019085415.82207-1-jiawenwu@trustnetic.com> X-QQ-SENDSIZE: 520 Feedback-ID: bizesmtp:trustnetic.com:qybgweb:qybgweb10 Subject: [dpdk-dev] [PATCH v4 58/58] net/txgbe: introduce log type in the driver documentation X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Introduce available logging types, add txgbe PMD in release note. Signed-off-by: Jiawen Wu --- doc/guides/nics/txgbe.rst | 44 +++++++++++++++++++++++++- doc/guides/rel_notes/release_20_11.rst | 6 ++++ drivers/net/txgbe/txgbe_rxtx.c | 6 ---- drivers/net/txgbe/txgbe_rxtx.h | 4 --- 4 files changed, 49 insertions(+), 11 deletions(-) diff --git a/doc/guides/nics/txgbe.rst b/doc/guides/nics/txgbe.rst index 76da3d859..cd293698b 100644 --- a/doc/guides/nics/txgbe.rst +++ b/doc/guides/nics/txgbe.rst @@ -38,6 +38,47 @@ Prerequisites - Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. +Pre-Installation Configuration +------------------------------ + +Build Options +~~~~~~~~~~~~~ + +The following build-time options may be enabled on build time using. + +``-Dc_args=`` meson argument (e.g. ``-Dc_args=-DRTE_LIBRTE_TXGBE_DEBUG_RX``). + +Please note that enabling debugging options may affect system performance. + +- ``RTE_LIBRTE_TXGBE_DEBUG_RX`` (undefined by default) + + Toggle display of receive fast path run-time messages. + +- ``RTE_LIBRTE_TXGBE_DEBUG_TX`` (undefined by default) + + Toggle display of transmit fast path run-time messages. + +- ``RTE_LIBRTE_TXGBE_DEBUG_TX_FREE`` (undefined by default) + + Toggle display of transmit descriptor clean messages. + +Dynamic Logging Parameters +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +One may leverage EAL option "--log-level" to change default levels +for the log types supported by the driver. The option is used with +an argument typically consisting of two parts separated by a colon. + +TXGBE PMD provides the following log types available for control: + +- ``pmd.net.txgbe.driver`` (default level is **notice**) + + Affects driver-wide messages unrelated to any particular devices. + +- ``pmd.net.txgbe.init`` (default level is **notice**) + + Extra logging of the messages during PMD initialization. + Driver compilation and testing ------------------------------ @@ -46,5 +87,6 @@ for details. Limitations or Known issues --------------------------- + Build with ICC is not supported yet. -X86-32, Power8, ARMv7 and BSD are not supported yet. +Power8, ARMv7 and BSD are not supported yet. diff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst index 25ea3c20b..d28ccb611 100644 --- a/doc/guides/rel_notes/release_20_11.rst +++ b/doc/guides/rel_notes/release_20_11.rst @@ -160,6 +160,12 @@ New Features * Added SR-IOV PF support * Added Alveo SN1000 SmartNICs (EF100 architecture) support +* **Added Wangxun txgbe PMD.** + + Added a new PMD driver for Wangxun 10 Gigabit Ethernet NICs. + + See the :doc:`../nics/txgbe` for more details. + * **Updated Virtio driver.** * Added support for Vhost-vDPA backend to Virtio-user PMD. diff --git a/drivers/net/txgbe/txgbe_rxtx.c b/drivers/net/txgbe/txgbe_rxtx.c index c78a8b6b0..a0f504336 100644 --- a/drivers/net/txgbe/txgbe_rxtx.c +++ b/drivers/net/txgbe/txgbe_rxtx.c @@ -62,16 +62,10 @@ static const u64 TXGBE_TX_OFFLOAD_MASK = (PKT_TX_IP_CKSUM | #define TXGBE_TX_OFFLOAD_NOTSUP_MASK \ (PKT_TX_OFFLOAD_MASK ^ TXGBE_TX_OFFLOAD_MASK) -#define RTE_PMD_USE_PREFETCH - -#ifdef RTE_PMD_USE_PREFETCH /* * Prefetch a cache line into all cache levels. */ #define rte_txgbe_prefetch(p) rte_prefetch0(p) -#else -#define rte_txgbe_prefetch(p) do {} while (0) -#endif static int txgbe_is_vf(struct rte_eth_dev *dev) diff --git a/drivers/net/txgbe/txgbe_rxtx.h b/drivers/net/txgbe/txgbe_rxtx.h index 120c2547f..6e0e86ce5 100644 --- a/drivers/net/txgbe/txgbe_rxtx.h +++ b/drivers/net/txgbe/txgbe_rxtx.h @@ -239,11 +239,7 @@ struct txgbe_tx_desc { #define RX_RING_SZ ((TXGBE_RING_DESC_MAX + RTE_PMD_TXGBE_RX_MAX_BURST) * \ sizeof(struct txgbe_rx_desc)) -#ifdef RTE_PMD_PACKET_PREFETCH #define rte_packet_prefetch(p) rte_prefetch1(p) -#else -#define rte_packet_prefetch(p) do {} while (0) -#endif #define RTE_TXGBE_REGISTER_POLL_WAIT_10_MS 10 #define RTE_TXGBE_WAIT_100_US 100 -- 2.18.4