| .. SPDX-License-Identifier: GPL-2.0 | |
| ==================== | |
| mlx5 devlink support | |
| ==================== | |
| This document describes the devlink features implemented by the ``mlx5`` | |
| device driver. | |
| Parameters | |
| ========== | |
| .. list-table:: Generic parameters implemented | |
| * - Name | |
| - Mode | |
| - Validation | |
| * - ``enable_roce`` | |
| - driverinit | |
| - Type: Boolean | |
| * - ``io_eq_size`` | |
| - driverinit | |
| - The range is between 64 and 4096. | |
| * - ``event_eq_size`` | |
| - driverinit | |
| - The range is between 64 and 4096. | |
| * - ``max_macs`` | |
| - driverinit | |
| - The range is between 1 and 2^31. Only power of 2 values are supported. | |
| The ``mlx5`` driver also implements the following driver-specific | |
| parameters. | |
| .. list-table:: Driver-specific parameters implemented | |
| :widths: 5 5 5 85 | |
| * - Name | |
| - Type | |
| - Mode | |
| - Description | |
| * - ``flow_steering_mode`` | |
| - string | |
| - runtime | |
| - Controls the flow steering mode of the driver | |
| * ``dmfs`` Device managed flow steering. In DMFS mode, the HW | |
| steering entities are created and managed through firmware. | |
| * ``smfs`` Software managed flow steering. In SMFS mode, the HW | |
| steering entities are created and manage through the driver without | |
| firmware intervention. | |
| * - ``fdb_large_groups`` | |
| - u32 | |
| - driverinit | |
| - Control the number of large groups (size > 1) in the FDB table. | |
| * The default value is 15, and the range is between 1 and 1024. | |
| * - ``esw_multiport`` | |
| - Boolean | |
| - runtime | |
| - Control MultiPort E-Switch shared fdb mode. | |
| An experimental mode where a single E-Switch is used and all the vports | |
| and physical ports on the NIC are connected to it. | |
| An example is to send traffic from a VF that is created on PF0 to an | |
| uplink that is natively associated with the uplink of PF1 | |
| Note: Future devices, ConnectX-8 and onward, will eventually have this | |
| as the default to allow forwarding between all NIC ports in a single | |
| E-switch environment and the dual E-switch mode will likely get | |
| deprecated. | |
| Default: disabled | |
| * - ``hairpin_num_queues`` | |
| - u32 | |
| - driverinit | |
| - We refer to a TC NIC rule that involves forwarding as "hairpin". | |
| Hairpin queues are mlx5 hardware specific implementation for hardware | |
| forwarding of such packets. | |
| Control the number of hairpin queues. | |
| * - ``hairpin_queue_size`` | |
| - u32 | |
| - driverinit | |
| - Control the size (in packets) of the hairpin queues. | |
| The ``mlx5`` driver supports reloading via ``DEVLINK_CMD_RELOAD`` | |
| Info versions | |
| ============= | |
| The ``mlx5`` driver reports the following versions | |
| .. list-table:: devlink info versions implemented | |
| :widths: 5 5 90 | |
| * - Name | |
| - Type | |
| - Description | |
| * - ``fw.psid`` | |
| - fixed | |
| - Used to represent the board id of the device. | |
| * - ``fw.version`` | |
| - stored, running | |
| - Three digit major.minor.subminor firmware version number. |