| 1 |
.. SPDX-License-Identifier: GPL-2.0 |
| 2 |
|
| 3 |
==================== |
| 4 |
i40e devlink support |
| 5 |
==================== |
| 6 |
|
| 7 |
This document describes the devlink features implemented by the ``i40e`` |
| 8 |
device driver. |
| 9 |
|
| 10 |
Parameters |
| 11 |
========== |
| 12 |
|
| 13 |
.. list-table:: Generic parameters implemented |
| 14 |
:widths: 5 5 90 |
| 15 |
|
| 16 |
* - Name |
| 17 |
- Mode |
| 18 |
- Notes |
| 19 |
* - ``max_mac_per_vf`` |
| 20 |
- runtime |
| 21 |
- Controls the maximum number of MAC addresses a VF can use |
| 22 |
on i40e devices. |
| 23 |
|
| 24 |
By default (``0``), the driver enforces its internally calculated per-VF |
| 25 |
MAC filter limit, which is based on the number of allocated VFS. |
| 26 |
|
| 27 |
If set to a non-zero value, this parameter acts as a strict cap: |
| 28 |
the driver will use the user-provided value instead of its internal |
| 29 |
calculation. |
| 30 |
|
| 31 |
**Important notes:** |
| 32 |
|
| 33 |
- This value **must be set before enabling SR-IOV**. |
| 34 |
Attempting to change it while SR-IOV is enabled will return an error. |
| 35 |
- MAC filters are a **shared hardware resource** across all VFs. |
| 36 |
Setting a high value may cause other VFs to be starved of filters. |
| 37 |
- This value is a **Administrative policy**. The hardware may return |
| 38 |
errors when its absolute limit is reached, regardless of the value |
| 39 |
set here. |
| 40 |
|
| 41 |
The default value is ``0`` (internal calculation is used). |
| 42 |
|
| 43 |
|
| 44 |
Info versions |
| 45 |
============= |
| 46 |
|
| 47 |
The ``i40e`` driver reports the following versions |
| 48 |
|
| 49 |
.. list-table:: devlink info versions implemented |
| 50 |
:widths: 5 5 5 90 |
| 51 |
|
| 52 |
* - Name |
| 53 |
- Type |
| 54 |
- Example |
| 55 |
- Description |
| 56 |
* - ``board.id`` |
| 57 |
- fixed |
| 58 |
- K15190-000 |
| 59 |
- The Product Board Assembly (PBA) identifier of the board. |
| 60 |
* - ``fw.mgmt`` |
| 61 |
- running |
| 62 |
- 9.130 |
| 63 |
- 2-digit version number of the management firmware that controls the |
| 64 |
PHY, link, etc. |
| 65 |
* - ``fw.mgmt.api`` |
| 66 |
- running |
| 67 |
- 1.15 |
| 68 |
- 2-digit version number of the API exported over the AdminQ by the |
| 69 |
management firmware. Used by the driver to identify what commands |
| 70 |
are supported. |
| 71 |
* - ``fw.mgmt.build`` |
| 72 |
- running |
| 73 |
- 73618 |
| 74 |
- Build number of the source for the management firmware. |
| 75 |
* - ``fw.undi`` |
| 76 |
- running |
| 77 |
- 1.3429.0 |
| 78 |
- Version of the Option ROM containing the UEFI driver. The version is |
| 79 |
reported in ``major.minor.patch`` format. The major version is |
| 80 |
incremented whenever a major breaking change occurs, or when the |
| 81 |
minor version would overflow. The minor version is incremented for |
| 82 |
non-breaking changes and reset to 1 when the major version is |
| 83 |
incremented. The patch version is normally 0 but is incremented when |
| 84 |
a fix is delivered as a patch against an older base Option ROM. |
| 85 |
* - ``fw.psid.api`` |
| 86 |
- running |
| 87 |
- 9.30 |
| 88 |
- Version defining the format of the flash contents. |
| 89 |
* - ``fw.bundle_id`` |
| 90 |
- running |
| 91 |
- 0x8000e5f3 |
| 92 |
- Unique identifier of the firmware image file that was loaded onto |
| 93 |
the device. Also referred to as the EETRACK identifier of the NVM. |