summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas Monjalon <thomas@monjalon.net>2019-08-05 17:32:19 +0200
committerRaslan Darawsheh <rasland@mellanox.com>2019-08-06 17:42:12 +0200
commit23bdbfec2bf30026dcaa32d6698987781f4b684e (patch)
treec7172d994b7af3c9c9a07a0e55917f4c5c588e86
parentae28c04547339f0a3ab0994e7386e2973ca9f520 (diff)
downloaddpdk-23bdbfec2bf30026dcaa32d6698987781f4b684e.zip
dpdk-23bdbfec2bf30026dcaa32d6698987781f4b684e.tar.gz
dpdk-23bdbfec2bf30026dcaa32d6698987781f4b684e.tar.xz
doc: fix wording and formatting of mlx5 guide
These are simple fixes of punctuation, anchor placement or wording. The table format is fixed to avoid having a long line in the first column. Fixes: 909be50a34d0 ("doc: update Mellanox guides and release notes") Cc: stable@dpdk.org Signed-off-by: Thomas Monjalon <thomas@monjalon.net> Acked-by: Raslan Darawsheh <rasland@mellanox.com>
-rw-r--r--doc/guides/nics/mlx5.rst57
1 files changed, 27 insertions, 30 deletions
diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index d3acf4c..021bd11 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -32,9 +32,9 @@ kernel support), librte_pmd_mlx5 relies heavily on system calls for control
operations such as querying/updating the MTU and flow control parameters.
For security reasons and robustness, this driver only deals with virtual
-memory addresses. The way resources allocations are handled by the kernel
-combined with hardware specifications that allow it to handle virtual memory
-addresses directly ensure that DPDK applications cannot access random
+memory addresses. The way resources allocations are handled by the kernel,
+combined with hardware specifications that allow to handle virtual memory
+addresses directly, ensure that DPDK applications cannot access random
physical memory (or memory that does not belong to the current process).
This capability allows the PMD to coexist with kernel network interfaces
@@ -80,7 +80,7 @@ Features
- Tunnel types: VXLAN, L3 VXLAN, VXLAN-GPE, GRE, MPLSoGRE, MPLSoUDP, IP-in-IP.
- Tunnel HW offloads: packet type, inner/outer RSS, IP and UDP checksum verification.
- NIC HW offloads: encapsulation (vxlan, gre, mplsoudp, mplsogre), NAT, routing, TTL
- increment/decrement, count, drop, mark. For details please see :ref:`Supported hardware offloads using rte_flow API`.
+ increment/decrement, count, drop, mark. For details please see :ref:`mlx5_offloads_support`.
- Flow insertion rate of more then million flows per second, when using Direct Rules.
- Support for multiple rte_flow groups.
- Hardware LRO.
@@ -173,7 +173,7 @@ Limitations
Statistics
----------
-MLX5 supports various of methods to report statistics:
+MLX5 supports various methods to report statistics:
Port statistics can be queried using ``rte_eth_stats_get()``. The received and sent statistics are through SW only and counts the number of packets received or sent successfully by the PMD. The imissed counter is the amount of packets that could not be delivered to SW because a queue was full. Packets not received due to congestion in the bus or on the NIC can be queried via the rx_discards_phy xstats counter.
@@ -972,62 +972,59 @@ Performance tuning
- Configure per-lcore cache when creating Mempools for packet buffer.
- Refrain from dynamically allocating/freeing memory in run-time.
+.. _mlx5_offloads_support:
+
Supported hardware offloads using rte_flow API
----------------------------------------------
-.. _Supported hardware offloads using rte_flow API:
-
.. table:: Supported hardware offloads using rte_flow API
+-----------------------+-----------------+-----------------+
- | Offload | E-Switch | NIC |
- | | | |
+ | Offload | with E-Switch | with vNIC |
+=======================+=================+=================+
| Count | | DPDK 19.05 | | DPDK 19.02 |
| | | OFED 4.6 | | OFED 4.6 |
- | | | RDMA-CORE V24 | | RDMA-CORE V23 |
+ | | | rdma-core 24 | | rdma-core 23 |
| | | ConnectX-5 | | ConnectX-5 |
+-----------------------+-----------------+-----------------+
| Drop / Queue / RSS | | DPDK 19.05 | | DPDK 18.11 |
| | | OFED 4.6 | | OFED 4.5 |
- | | | RDMA-CORE V24 | | RDMA-CORE V23 |
+ | | | rdma-core 24 | | rdma-core 23 |
| | | ConnectX-5 | | ConnectX-4 |
+-----------------------+-----------------+-----------------+
| Encapsulation | | DPDK 19.05 | | DPDK 19.02 |
- | (VXLAN / NVGRE / RAW) | | OFED 4.6.2 | | OFED 4.6 |
- | | | RDMA-CORE V24 | | RDMA-CORE V23 |
+ | (VXLAN / NVGRE / RAW) | | OFED 4.6-2 | | OFED 4.6 |
+ | | | rdma-core 24 | | rdma-core 23 |
| | | ConnectX-5 | | ConnectX-5 |
+-----------------------+-----------------+-----------------+
- | Header rewrite | | DPDK 19.05 | | DPDK 19.02 |
- | (set_ipv4_src / | | OFED 4.6.2 | | OFED 4.6.2 |
- | set_ipv4_dst / | | RDMA-CORE V24 | | RDMA-CORE V23 |
- | set_ipv6_src / | | ConnectX-5 | | ConnectX-5 |
- | set_ipv6_dst / | | |
- | set_tp_src / | | |
- | set_tp_dst / | | |
- | dec_ttl / | | |
- | set_ttl / | | |
- | set_mac_src / | | |
- | set_mac_dst) | | |
+ | | Header rewrite | | DPDK 19.05 | | DPDK 19.02 |
+ | | (set_ipv4_src / | | OFED 4.6-2 | | OFED 4.6-2 |
+ | | set_ipv4_dst / | | rdma-core 24 | | rdma-core 23 |
+ | | set_ipv6_src / | | ConnectX-5 | | ConnectX-5 |
+ | | set_ipv6_dst / | | |
+ | | set_tp_src / | | |
+ | | set_tp_dst / | | |
+ | | dec_ttl / | | |
+ | | set_ttl / | | |
+ | | set_mac_src / | | |
+ | | set_mac_dst) | | |
+-----------------------+-----------------+-----------------+
| Jump | | DPDK 19.05 | | DPDK 19.02 |
- | | | OFED 4.6.2 | | OFED 4.6.2 |
- | | | RDMA-CORE V24 | | N/A |
+ | | | OFED 4.6-2 | | OFED 4.6-2 |
+ | | | rdma-core 24 | | N/A |
| | | ConnectX-5 | | ConnectX-5 |
+-----------------------+-----------------+-----------------+
| Mark / Flag | | DPDK 19.05 | | DPDK 18.11 |
| | | OFED 4.6 | | OFED 4.5 |
- | | | RDMA-CORE V24 | | RDMA-CORE V23 |
+ | | | rdma-core 24 | | rdma-core 23 |
| | | ConnectX-5 | | ConnectX-4 |
+-----------------------+-----------------+-----------------+
| Port ID | | DPDK 19.05 | | N/A |
| | | OFED 4.6 | | N/A |
- | | | RDMA-CORE V24 | | N/A |
+ | | | rdma-core 24 | | N/A |
| | | ConnectX-5 | | N/A |
+-----------------------+-----------------+-----------------+
-* Minimum version for each component and nic.
-
Notes for testpmd
-----------------