[dpdk-dev,v4,11/11] doc: update mlx5 guide on tunnel offloading

Message ID 20180417151436.161374-12-xuemingl@mellanox.com (mailing list archive)
State Superseded, archived
Delegated to: Shahaf Shuler
Headers

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation fail apply patch file failure

Commit Message

Xueming Li April 17, 2018, 3:14 p.m. UTC
  Remove tunnel limitations, add new hardware tunnel offload features.

Signed-off-by: Xueming Li <xuemingl@mellanox.com>
---
 doc/guides/nics/features/default.ini |  1 +
 doc/guides/nics/features/mlx5.ini    |  3 +++
 doc/guides/nics/mlx5.rst             | 22 ++++++++++++++++++++--
 3 files changed, 24 insertions(+), 2 deletions(-)
  

Comments

Nélio Laranjeiro April 18, 2018, 7 a.m. UTC | #1
On Tue, Apr 17, 2018 at 11:14:36PM +0800, Xueming Li wrote:
> Remove tunnel limitations, add new hardware tunnel offload features.
> 
> Signed-off-by: Xueming Li <xuemingl@mellanox.com>
> ---
>  doc/guides/nics/features/default.ini |  1 +
>  doc/guides/nics/features/mlx5.ini    |  3 +++
>  doc/guides/nics/mlx5.rst             | 22 ++++++++++++++++++++--
>  3 files changed, 24 insertions(+), 2 deletions(-)
> 
> diff --git a/doc/guides/nics/features/default.ini b/doc/guides/nics/features/default.ini
> index dae2ad776..49be81450 100644
> --- a/doc/guides/nics/features/default.ini
> +++ b/doc/guides/nics/features/default.ini
> @@ -29,6 +29,7 @@ Multicast MAC filter =
>  RSS hash             =
>  RSS key update       =
>  RSS reta update      =
> +Inner RSS            =
>  VMDq                 =
>  SR-IOV               =
>  DCB                  =
> diff --git a/doc/guides/nics/features/mlx5.ini b/doc/guides/nics/features/mlx5.ini
> index f8ce08770..e75b14bdc 100644
> --- a/doc/guides/nics/features/mlx5.ini
> +++ b/doc/guides/nics/features/mlx5.ini
> @@ -21,6 +21,7 @@ Multicast MAC filter = Y
>  RSS hash             = Y
>  RSS key update       = Y
>  RSS reta update      = Y
> +Inner RSS            = Y
>  SR-IOV               = Y
>  VLAN filter          = Y
>  Flow director        = Y
> @@ -30,6 +31,8 @@ VLAN offload         = Y
>  L3 checksum offload  = Y
>  L4 checksum offload  = Y
>  Timestamp offload    = Y
> +Inner L3 checksum    = Y
> +Inner L4 checksum    = Y
>  Packet type parsing  = Y
>  Rx descriptor status = Y
>  Tx descriptor status = Y
> diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
> index c28c83278..51590b0a3 100644
> --- a/doc/guides/nics/mlx5.rst
> +++ b/doc/guides/nics/mlx5.rst
> @@ -74,12 +74,12 @@ Features
>  - RX interrupts.
>  - Statistics query including Basic, Extended and per queue.
>  - Rx HW timestamp.
> +- Tunnel types: VXLAN, L3 VXLAN, VXLAN-GPE, GRE, MPLS-in-GRE, MPLS-in-UDP.
> +- Tunnel HW offloads: packet type, inner/outer RSS, IP and UDP checksum verification.
>  
>  Limitations
>  -----------
>  
> -- Inner RSS for VXLAN frames is not supported yet.
> -- Hardware checksum RX offloads for VXLAN inner header are not supported yet.
>  - For secondary process:
>  
>    - Forked secondary process not supported.
> @@ -327,6 +327,24 @@ Run-time configuration
>  
>    Enabled by default, valid only on VF devices ignored otherwise.
>  
> +Firmware configuration
> +~~~~~~~~~~~~~~~~~~~~~~
> +
> +- L3 VXLAN and VXLAN-GPE destination UDP port
> +
> +   .. code-block:: console
> +
> +     mlxconfig -d <mst device> set IP_OVER_VXLAN_EN=1
> +     mlxconfig -d <mst device> set IP_OVER_VXLAN_PORT=<udp dport>
> +
> +  Verify configurations are set:
> +
> +   .. code-block:: console
> +
> +     mlxconfig -d <mst device> query | grep IP_OVER_VXLAN
> +     IP_OVER_VXLAN_EN                    True(1)
> +     IP_OVER_VXLAN_PORT                  4790
> +
>  Prerequisites
>  -------------
>  
> -- 
> 2.13.3

The documentation modification related to the L3 VXLAN should be in the
same patch as the code in mlx5.

Thanks,
  

Patch

diff --git a/doc/guides/nics/features/default.ini b/doc/guides/nics/features/default.ini
index dae2ad776..49be81450 100644
--- a/doc/guides/nics/features/default.ini
+++ b/doc/guides/nics/features/default.ini
@@ -29,6 +29,7 @@  Multicast MAC filter =
 RSS hash             =
 RSS key update       =
 RSS reta update      =
+Inner RSS            =
 VMDq                 =
 SR-IOV               =
 DCB                  =
diff --git a/doc/guides/nics/features/mlx5.ini b/doc/guides/nics/features/mlx5.ini
index f8ce08770..e75b14bdc 100644
--- a/doc/guides/nics/features/mlx5.ini
+++ b/doc/guides/nics/features/mlx5.ini
@@ -21,6 +21,7 @@  Multicast MAC filter = Y
 RSS hash             = Y
 RSS key update       = Y
 RSS reta update      = Y
+Inner RSS            = Y
 SR-IOV               = Y
 VLAN filter          = Y
 Flow director        = Y
@@ -30,6 +31,8 @@  VLAN offload         = Y
 L3 checksum offload  = Y
 L4 checksum offload  = Y
 Timestamp offload    = Y
+Inner L3 checksum    = Y
+Inner L4 checksum    = Y
 Packet type parsing  = Y
 Rx descriptor status = Y
 Tx descriptor status = Y
diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index c28c83278..51590b0a3 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -74,12 +74,12 @@  Features
 - RX interrupts.
 - Statistics query including Basic, Extended and per queue.
 - Rx HW timestamp.
+- Tunnel types: VXLAN, L3 VXLAN, VXLAN-GPE, GRE, MPLS-in-GRE, MPLS-in-UDP.
+- Tunnel HW offloads: packet type, inner/outer RSS, IP and UDP checksum verification.
 
 Limitations
 -----------
 
-- Inner RSS for VXLAN frames is not supported yet.
-- Hardware checksum RX offloads for VXLAN inner header are not supported yet.
 - For secondary process:
 
   - Forked secondary process not supported.
@@ -327,6 +327,24 @@  Run-time configuration
 
   Enabled by default, valid only on VF devices ignored otherwise.
 
+Firmware configuration
+~~~~~~~~~~~~~~~~~~~~~~
+
+- L3 VXLAN and VXLAN-GPE destination UDP port
+
+   .. code-block:: console
+
+     mlxconfig -d <mst device> set IP_OVER_VXLAN_EN=1
+     mlxconfig -d <mst device> set IP_OVER_VXLAN_PORT=<udp dport>
+
+  Verify configurations are set:
+
+   .. code-block:: console
+
+     mlxconfig -d <mst device> query | grep IP_OVER_VXLAN
+     IP_OVER_VXLAN_EN                    True(1)
+     IP_OVER_VXLAN_PORT                  4790
+
 Prerequisites
 -------------