50. TXGBE Poll Mode Driver

The TXGBE PMD (librte_pmd_txgbe) provides poll mode driver support for Wangxun 10 Gigabit Ethernet NICs.

50.1. Features

  • Multiple queues for TX and RX

  • Receiver Side Scaling (RSS)

  • MAC/VLAN filtering

  • Packet type information

  • Checksum offload

  • VLAN/QinQ stripping and inserting

  • TSO offload

  • Promiscuous mode

  • Multicast mode

  • Port hardware statistics

  • Jumbo frames

  • Link state information

  • Link flow control

  • Interrupt mode for RX

  • Scattered and gather for TX and RX

  • DCB

  • IEEE 1588

  • FW version

  • LRO

50.2. Prerequisites

50.3. Pre-Installation Configuration

50.3.1. 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.

50.3.2. 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.

50.4. Driver compilation and testing

Refer to the document compiling and testing a PMD for a NIC for details.

50.5. Limitations or Known issues

Build with ICC is not supported yet. Power8, ARMv7 and BSD are not supported yet.