2020-10-19 08:53:18 +00:00
|
|
|
.. SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
|
Copyright(c) 2015-2020.
|
|
|
|
|
|
|
|
|
|
TXGBE Poll Mode Driver
|
|
|
|
|
======================
|
|
|
|
|
|
|
|
|
|
The TXGBE PMD (librte_pmd_txgbe) provides poll mode driver support
|
|
|
|
|
for Wangxun 10 Gigabit Ethernet NICs.
|
|
|
|
|
|
2020-10-19 08:53:30 +00:00
|
|
|
Features
|
|
|
|
|
--------
|
|
|
|
|
|
2020-10-19 08:53:31 +00:00
|
|
|
- Multiple queues for TX and RX
|
2020-10-19 08:53:59 +00:00
|
|
|
- Receiver Side Scaling (RSS)
|
2020-10-19 08:53:53 +00:00
|
|
|
- MAC/VLAN filtering
|
2020-10-19 08:53:40 +00:00
|
|
|
- Packet type information
|
2020-10-19 08:53:42 +00:00
|
|
|
- Checksum offload
|
2020-10-19 08:53:53 +00:00
|
|
|
- VLAN/QinQ stripping and inserting
|
2020-10-19 08:53:42 +00:00
|
|
|
- TSO offload
|
2020-10-19 08:54:04 +00:00
|
|
|
- Promiscuous mode
|
|
|
|
|
- Multicast mode
|
2020-10-19 08:53:50 +00:00
|
|
|
- Port hardware statistics
|
2020-10-19 08:53:37 +00:00
|
|
|
- Jumbo frames
|
2020-10-19 08:53:30 +00:00
|
|
|
- Link state information
|
2020-10-19 08:54:01 +00:00
|
|
|
- Link flow control
|
2020-10-19 08:53:48 +00:00
|
|
|
- Interrupt mode for RX
|
2020-10-19 08:53:44 +00:00
|
|
|
- Scattered and gather for TX and RX
|
2020-10-19 08:54:00 +00:00
|
|
|
- DCB
|
2020-10-19 08:53:44 +00:00
|
|
|
- LRO
|
2020-10-19 08:53:30 +00:00
|
|
|
|
2020-10-19 08:53:18 +00:00
|
|
|
Prerequisites
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
- Learning about Wangxun 10 Gigabit Ethernet NICs using
|
|
|
|
|
`<https://www.net-swift.com/a/383.html>`_.
|
|
|
|
|
|
|
|
|
|
- Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
|
|
|
|
|
|
2020-10-19 08:53:19 +00:00
|
|
|
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.
|
|
|
|
|
|
2020-10-19 08:53:18 +00:00
|
|
|
Driver compilation and testing
|
|
|
|
|
------------------------------
|
|
|
|
|
|
|
|
|
|
Refer to the document :ref:`compiling and testing a PMD for a NIC <pmd_build_and_test>`
|
|
|
|
|
for details.
|
|
|
|
|
|
|
|
|
|
Limitations or Known issues
|
|
|
|
|
---------------------------
|
|
|
|
|
|
|
|
|
|
Build with ICC is not supported yet.
|
|
|
|
|
Power8, ARMv7 and BSD are not supported yet.
|
