| 1 |
.. SPDX-License-Identifier: GPL-2.0 |
| 2 |
|
| 3 |
==================== |
| 4 |
mlx4 devlink support |
| 5 |
==================== |
| 6 |
|
| 7 |
This document describes the devlink features implemented by the ``mlx4`` |
| 8 |
device driver. |
| 9 |
|
| 10 |
Parameters |
| 11 |
========== |
| 12 |
|
| 13 |
.. list-table:: Generic parameters implemented |
| 14 |
|
| 15 |
* - Name |
| 16 |
- Mode |
| 17 |
* - ``internal_err_reset`` |
| 18 |
- driverinit, runtime |
| 19 |
* - ``max_macs`` |
| 20 |
- driverinit |
| 21 |
* - ``region_snapshot_enable`` |
| 22 |
- driverinit, runtime |
| 23 |
|
| 24 |
The ``mlx4`` driver also implements the following driver-specific |
| 25 |
parameters. |
| 26 |
|
| 27 |
.. list-table:: Driver-specific parameters implemented |
| 28 |
:widths: 5 5 5 85 |
| 29 |
|
| 30 |
* - Name |
| 31 |
- Type |
| 32 |
- Mode |
| 33 |
- Description |
| 34 |
* - ``enable_64b_cqe_eqe`` |
| 35 |
- Boolean |
| 36 |
- driverinit |
| 37 |
- Enable 64 byte CQEs/EQEs, if the FW supports it. |
| 38 |
* - ``enable_4k_uar`` |
| 39 |
- Boolean |
| 40 |
- driverinit |
| 41 |
- Enable using the 4k UAR. |
| 42 |
|
| 43 |
The ``mlx4`` driver supports reloading via ``DEVLINK_CMD_RELOAD`` |
| 44 |
|
| 45 |
Regions |
| 46 |
======= |
| 47 |
|
| 48 |
The ``mlx4`` driver supports dumping the firmware PCI crspace and health |
| 49 |
buffer during a critical firmware issue. |
| 50 |
|
| 51 |
In case a firmware command times out, firmware getting stuck, or a non zero |
| 52 |
value on the catastrophic buffer, a snapshot will be taken by the driver. |
| 53 |
|
| 54 |
The ``cr-space`` region will contain the firmware PCI crspace contents. The |
| 55 |
``fw-health`` region will contain the device firmware's health buffer. |
| 56 |
Snapshots for both of these regions are taken on the same event triggers. |