summaryrefslogtreecommitdiff
path: root/doc/guides
diff options
context:
space:
mode:
authorThomas Monjalon <thomas@monjalon.net>2019-08-05 17:32:18 +0200
committerRaslan Darawsheh <rasland@mellanox.com>2019-08-06 17:42:12 +0200
commitae28c04547339f0a3ab0994e7386e2973ca9f520 (patch)
tree41be65931c6917dac9f94298a2b6bc16732fae23 /doc/guides
parent1f1eb0949c1889ec5cd62e0619c3336fa0619af9 (diff)
downloaddpdk-ae28c04547339f0a3ab0994e7386e2973ca9f520.zip
dpdk-ae28c04547339f0a3ab0994e7386e2973ca9f520.tar.gz
dpdk-ae28c04547339f0a3ab0994e7386e2973ca9f520.tar.xz
doc: improve firmware configuration in mlx5 guide
The command mlxconfig was not enough explained and too much verbose at the same time. The syntax is now explained in introduction before listing the options, without repeating the commands. Some options, which are explained elsewhere in the doc, are added to this list. Signed-off-by: Thomas Monjalon <thomas@monjalon.net> Acked-by: Raslan Darawsheh <rasland@mellanox.com>
Diffstat (limited to 'doc/guides')
-rw-r--r--doc/guides/nics/mlx5.rst53
1 files changed, 30 insertions, 23 deletions
diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index 5102bcd..d3acf4c 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -575,46 +575,53 @@ Run-time configuration
Firmware configuration
~~~~~~~~~~~~~~~~~~~~~~
-- L3 VXLAN and VXLAN-GPE destination UDP port
+Firmware features can be configured as key/value pairs.
- .. code-block:: console
+The command to set a value is::
- mlxconfig -d <mst device> set IP_OVER_VXLAN_EN=1
- mlxconfig -d <mst device> set IP_OVER_VXLAN_PORT=<udp dport>
+ mlxconfig -d <device> set <key>=<value>
- Verify configurations are set:
+The command to query a value is::
- .. code-block:: console
+ mlxconfig -d <device> query | grep <key>
- mlxconfig -d <mst device> query | grep IP_OVER_VXLAN
- IP_OVER_VXLAN_EN True(1)
- IP_OVER_VXLAN_PORT <udp dport>
+The device name for the command ``mlxconfig`` can be either the PCI address,
+or the mst device name found with::
-- enable ICMP/ICMP6's code/type field matching
+ mst status
- .. code-block:: console
+Below are some firmware configurations listed.
- mlxconfig -d <mst device> set FLEX_PARSER_PROFILE_ENABLE=2
+- link type::
- Verify configurations are set:
+ LINK_TYPE_P1
+ LINK_TYPE_P2
+ value: 1=Infiniband 2=Ethernet 3=VPI(auto-sense)
- .. code-block:: console
+- enable SR-IOV::
- mlxconfig -d <mst device> query | grep FLEX_PARSER_PROFILE_ENABLE
- FLEX_PARSER_PROFILE_ENABLE 2
+ SRIOV_EN=1
-- IP-in-IP tunnel enable
+- maximum number of SR-IOV virtual functions::
- .. code-block:: console
+ NUM_OF_VFS=<max>
- mlxconfig -d <mst device> set FLEX_PARSER_PROFILE_ENABLE=0
+- aggressive CQE zipping::
- Verify configurations are set:
+ CQE_COMPRESSION=1
- .. code-block:: console
+- L3 VXLAN and VXLAN-GPE destination UDP port::
+
+ IP_OVER_VXLAN_EN=1
+ IP_OVER_VXLAN_PORT=<udp dport>
+
+- enable IP-in-IP tunnel flow matching::
+
+ FLEX_PARSER_PROFILE_ENABLE=0
+
+- enable ICMP/ICMP6 code/type fields matching::
- mlxconfig -d <mst device> query | grep FLEX_PARSER_PROFILE_ENABLE
- FLEX_PARSER_PROFILE_ENABLE 0
+ FLEX_PARSER_PROFILE_ENABLE=2
Prerequisites
-------------