X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fnics%2Fbnx2x.rst;h=9ad4f9f410de5a9d13b4d0da355ed475650a3734;hb=a124f9e9591bf2b22b20e2d117775b0ff0b9f684;hp=0a16f0c706c4fad5f169e7355d2450cb3ff3bd23;hpb=7440e8523688f7b3898f0c2d1b6940fdccc869ab;p=dpdk.git diff --git a/doc/guides/nics/bnx2x.rst b/doc/guides/nics/bnx2x.rst index 0a16f0c706..9ad4f9f410 100644 --- a/doc/guides/nics/bnx2x.rst +++ b/doc/guides/nics/bnx2x.rst @@ -4,7 +4,7 @@ BNX2X Poll Mode Driver ====================== -The BNX2X poll mode driver library (**librte_pmd_bnx2x**) implements support +The BNX2X poll mode driver library (**librte_net_bnx2x**) implements support for **QLogic 578xx** 10/20 Gbps family of adapters as well as their virtual functions (VF) in SR-IOV context. It is supported on several standard Linux distros like RHEL and SLES. It is compile-tested under FreeBSD OS. @@ -67,39 +67,32 @@ Supported QLogic NICs Prerequisites ------------- -- Requires firmware version **7.2.51.0**. It is included in most of the +- Requires firmware version **7.13.11.0**. It is included in most of the standard Linux distros. If it is not available visit - `linux-firmware git repository `_ + `linux-firmware git repository `_ to get the required firmware. Pre-Installation Configuration ------------------------------ -Config File Options -~~~~~~~~~~~~~~~~~~~ +Config Options +~~~~~~~~~~~~~~ -The following options can be modified in the ``.config`` file. Please note that +The following options can be enabled with Meson flags. Please note that enabling debugging options may affect system performance. -- ``CONFIG_RTE_LIBRTE_BNX2X_PMD`` (default **n**) - - Toggle compilation of bnx2x driver. To use bnx2x PMD set this config parameter - to 'y'. Also, in order for firmware binary to load user will need zlib devel - package installed. - -- ``CONFIG_RTE_LIBRTE_BNX2X_DEBUG_TX`` (default **n**) +- ``RTE_LIBRTE_BNX2X_DEBUG_TX`` (default **disabled**) Toggle display of transmit fast path run-time messages. -- ``CONFIG_RTE_LIBRTE_BNX2X_DEBUG_RX`` (default **n**) +- ``RTE_LIBRTE_BNX2X_DEBUG_RX`` (default **disabled**) Toggle display of receive fast path run-time messages. -- ``CONFIG_RTE_LIBRTE_BNX2X_DEBUG_PERIODIC`` (default **n**) +- ``RTE_LIBRTE_BNX2X_DEBUG_PERIODIC`` (default **disabled**) Toggle display of register reads and writes. - .. _bnx2x_driver-compilation: Driver compilation and testing @@ -108,6 +101,23 @@ Driver compilation and testing Refer to the document :ref:`compiling and testing a PMD for a NIC ` for details. +Jumbo: Limitation +----------------- + +Rx descriptor limit for number of segments per MTU is set to 1. +PMD doesn't support Jumbo Rx scatter gather. Some applciations can +adjust mbuf_size based on this param and max_pkt_len. + +For others, PMD detects the condition where Rx packet length cannot +be held by configured mbuf size and logs the message. + +Example output: + + .. code-block:: console + + [...] + [bnx2x_recv_pkts:397(04:00.0:dpdk-port-0)] mbuf size 2048 is not enough to hold Rx packet length more than 2046 + SR-IOV: Prerequisites and sample Application Notes --------------------------------------------------