1 .. SPDX-License-Identifier: BSD-3-Clause
2 Copyright(c) 2015-2020.
7 The TXGBE PMD (librte_pmd_txgbe) provides poll mode driver support
8 for Wangxun 10 Gigabit Ethernet NICs.
13 - Multiple queues for TX and RX
14 - Receiver Side Scaling (RSS)
16 - Packet type information
18 - VLAN/QinQ stripping and inserting
22 - Port hardware statistics
24 - Link state information
26 - Interrupt mode for RX
27 - Scattered and gather for TX and RX
34 - Learning about Wangxun 10 Gigabit Ethernet NICs using
35 `<https://www.net-swift.com/a/383.html>`_.
37 - Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
39 Pre-Installation Configuration
40 ------------------------------
45 The following build-time options may be enabled on build time using.
47 ``-Dc_args=`` meson argument (e.g. ``-Dc_args=-DRTE_LIBRTE_TXGBE_DEBUG_RX``).
49 Please note that enabling debugging options may affect system performance.
51 - ``RTE_LIBRTE_TXGBE_DEBUG_RX`` (undefined by default)
53 Toggle display of receive fast path run-time messages.
55 - ``RTE_LIBRTE_TXGBE_DEBUG_TX`` (undefined by default)
57 Toggle display of transmit fast path run-time messages.
59 - ``RTE_LIBRTE_TXGBE_DEBUG_TX_FREE`` (undefined by default)
61 Toggle display of transmit descriptor clean messages.
63 Dynamic Logging Parameters
64 ~~~~~~~~~~~~~~~~~~~~~~~~~~
66 One may leverage EAL option "--log-level" to change default levels
67 for the log types supported by the driver. The option is used with
68 an argument typically consisting of two parts separated by a colon.
70 TXGBE PMD provides the following log types available for control:
72 - ``pmd.net.txgbe.driver`` (default level is **notice**)
74 Affects driver-wide messages unrelated to any particular devices.
76 - ``pmd.net.txgbe.init`` (default level is **notice**)
78 Extra logging of the messages during PMD initialization.
80 Driver compilation and testing
81 ------------------------------
83 Refer to the document :ref:`compiling and testing a PMD for a NIC <pmd_build_and_test>`
86 Limitations or Known issues
87 ---------------------------
89 Build with ICC is not supported yet.
90 Power8, ARMv7 and BSD are not supported yet.