X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fnics%2Fmlx5.rst;h=45f44c97d7236926e431b06a28428a2382731ff7;hb=34fd4373ce76efd0236e59397c495762c2ec9e64;hp=bae73f42d882f792a8945c1f3b27bff228d76b9d;hpb=5c4e0deef345c4c97719845a16e9f0988b0547c3;p=dpdk.git diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index bae73f42d8..45f44c97d7 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -255,7 +255,7 @@ Limitations no MPRQ feature or vectorized code can be engaged. - When Multi-Packet Rx queue is configured (``mprq_en``), a Rx packet can be - externally attached to a user-provided mbuf with having EXT_ATTACHED_MBUF in + externally attached to a user-provided mbuf with having RTE_MBUF_F_EXTERNAL in ol_flags. As the mempool for the external buffer is managed by PMD, all the Rx mbufs must be freed before the device is closed. Otherwise, the mempool of the external buffers will be freed by PMD and the application which still @@ -263,7 +263,7 @@ Limitations - If Multi-Packet Rx queue is configured (``mprq_en``) and Rx CQE compression is enabled (``rxq_cqe_comp_en``) at the same time, RSS hash result is not fully - supported. Some Rx packets may not have PKT_RX_RSS_HASH. + supported. Some Rx packets may not have RTE_MBUF_F_RX_RSS_HASH. - IPv6 Multicast messages are not supported on VM, while promiscuous mode and allmulticast mode are both set to off. @@ -371,7 +371,7 @@ Limitations - CRC: - - ``DEV_RX_OFFLOAD_KEEP_CRC`` cannot be supported with decapsulation + - ``RTE_ETH_RX_OFFLOAD_KEEP_CRC`` cannot be supported with decapsulation for some NICs (such as ConnectX-6 Dx, ConnectX-6 Lx, and BlueField-2). The capability bit ``scatter_fcs_w_decap_disable`` shows NIC support. @@ -431,8 +431,8 @@ Limitations - yellow: NULL or END. - RED: DROP / END. - The only supported meter policy actions: - - green: QUEUE, RSS, PORT_ID, JUMP, DROP, MARK and SET_TAG. - - yellow: QUEUE, RSS, PORT_ID, JUMP, DROP, MARK and SET_TAG. + - green: QUEUE, RSS, PORT_ID, REPRESENTED_PORT, JUMP, DROP, MARK and SET_TAG. + - yellow: QUEUE, RSS, PORT_ID, REPRESENTED_PORT, JUMP, DROP, MARK and SET_TAG. - RED: must be DROP. - Policy actions of RSS for green and yellow should have the same configuration except queues. - meter profile packet mode is supported. @@ -464,6 +464,14 @@ Limitations - In order to achieve best insertion rate, application should manage the flows per lcore. - Better to disable memory reclaim by setting ``reclaim_mem_mode`` to 0 to accelerate the flow object allocation and release with cache. +- HW hashed bonding + + - TXQ affinity subjects to HW hash once enabled. + +- Bonding under socket direct mode + + - Needs OFED 5.4+. + Statistics ---------- @@ -606,9 +614,9 @@ Driver options and each stride receives one packet. MPRQ can improve throughput for small-packet traffic. - When MPRQ is enabled, max_rx_pkt_len can be larger than the size of - user-provided mbuf even if DEV_RX_OFFLOAD_SCATTER isn't enabled. PMD will - configure large stride size enough to accommodate max_rx_pkt_len as long as + When MPRQ is enabled, MTU can be larger than the size of + user-provided mbuf even if RTE_ETH_RX_OFFLOAD_SCATTER isn't enabled. PMD will + configure large stride size enough to accommodate MTU as long as device allows. Note that this can waste system memory compared to enabling Rx scatter and multi-segment packet. @@ -644,7 +652,7 @@ Driver options the mbuf by external buffer attachment - ``rte_pktmbuf_attach_extbuf()``. A mempool for external buffers will be allocated and managed by PMD. If Rx packet is externally attached, ol_flags field of the mbuf will have - EXT_ATTACHED_MBUF and this flag must be preserved. ``RTE_MBUF_HAS_EXTBUF()`` + RTE_MBUF_F_EXTERNAL and this flag must be preserved. ``RTE_MBUF_HAS_EXTBUF()`` checks the flag. The default value is 128, valid only if ``mprq_en`` is set. - ``rxqs_min_mprq`` parameter [int] @@ -1001,6 +1009,19 @@ Driver options Enabled by default. +- ``mr_mempool_reg_en`` parameter [int] + + A nonzero value enables implicit registration of DMA memory of all mempools + except those having ``RTE_MEMPOOL_F_NON_IO``. This flag is set automatically + for mempools populated with non-contiguous objects or those without IOVA. + The effect is that when a packet from a mempool is transmitted, + its memory is already registered for DMA in the PMD and no registration + will happen on the data path. The tradeoff is extra work on the creation + of each mempool and increased HW resource use if some mempools + are not used with MLX5 devices. + + Enabled by default. + - ``representor`` parameter [list] This parameter can be used to instantiate DPDK Ethernet devices from