Skip to contentSkip to conversation

Documentation: mlx5.rst: Add note for eswitch MD

PATCH Applied William Tu 2 participants 2 messages Jan 25, 2024 – Jan 27, 2024

Subsystems (4)
lore
Share & tools
lore

William Tu

author
#0 lore raw

PATCH 1/1 Documentation: mlx5.rst: Add note for eswitch MD

Add a note when using esw_port_metadata. The parameter has runtime mode but setting it does not take effect immediately. Setting it must happen in legacy mode, and the port metadata takes effects when the switchdev mode is enabled.

Disable eswitch port metadata::

  $ devlink dev param set pci/0000:06:00.0 name esw_port_metadata value \
    false cmode runtime
Change eswitch mode to switchdev mode where after choosing the metadata value::
  $ devlink dev eswitch set pci/0000:06:00.0 mode switchdev

Note that other mlx5 devlink runtime parameters, esw_multiport and flow_steering_mode, do not have this limitation.

---
 Documentation/networking/devlink/mlx5.rst | 4 ++++
 1 file changed, 4 insertions(+)
Documentation/networking/devlink/mlx5.rst +4 -0
index 3f70417cf792..16700c1bc963 100644
@@ -105,6 +105,10 @@ parameters.
 
        When metadata is disabled, the above use cases will fail to initialize if
        users try to enable them.
+
+       Note: Setting this parameter does not take effect immediately. Setting
+       must happen in legacy mode and eswitch port metadata takes effect after
+       enabling switchdev mode.
    * - ``hairpin_num_queues``
      - u32
      - driverinit
Signature · 1 line
2.34.1
#1 lore raw
This patch was applied to netdev/net-next.git (main) by David S. Miller <[email protected]>:

Hello:

This patch was applied to netdev/net-next.git (main) by David S. Miller <[email protected]>:

Quoted 5 lines · On Wed, 24 Jan 2024 20:00:41 -0800 you wrote:

Add a note when using esw_port_metadata. The parameter has runtime mode but setting it does not take effect immediately. Setting it must happen in legacy mode, and the port metadata takes effects when the switchdev mode is enabled.

Quoted 7 lines

Disable eswitch port metadata::

  $ devlink dev param set pci/0000:06:00.0 name esw_port_metadata value \
    false cmode runtime
Change eswitch mode to switchdev mode where after choosing the metadata value::
  $ devlink dev eswitch set pci/0000:06:00.0 mode switchdev

[...]

Here is the summary with links:
- [net-next] Documentation: mlx5.rst: Add note for eswitch MD

    https://git.kernel.org/netdev/net-next/c/6f83b62283ed

You are awesome, thank you!

Signature · 2 lines
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html