Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
1.. SPDX-License-Identifier: GPL-2.0
2
3====================
4i40e devlink support
5====================
6
7This document describes the devlink features implemented by the ``i40e``
8device driver.
9
10Parameters
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
44Info versions
45=============
46
47The ``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.