1.. SPDX-License-Identifier: GPL-2.0
2
3==============
4Devlink Params
5==============
6
7``devlink`` provides capability for a driver to expose device parameters for low
8level device functionality. Since devlink can operate at the device-wide
9level, it can be used to provide configuration that may affect multiple
10ports on a single device.
11
12This document describes a number of generic parameters that are supported
13across multiple drivers. Each driver is also free to add their own
14parameters. Each driver must document the specific parameters they support,
15whether generic or not.
16
17Configuration modes
18===================
19
20Parameters may be set in different configuration modes.
21
22.. list-table:: Possible configuration modes
23   :widths: 5 90
24
25   * - Name
26     - Description
27   * - ``runtime``
28     - set while the driver is running, and takes effect immediately. No
29       reset is required.
30   * - ``driverinit``
31     - applied while the driver initializes. Requires the user to restart
32       the driver using the ``devlink`` reload command.
33   * - ``permanent``
34     - written to the device's non-volatile memory. A hard reset is required
35       for it to take effect.
36
37Reloading
38---------
39
40In order for ``driverinit`` parameters to take effect, the driver must
41support reloading via the ``devlink-reload`` command. This command will
42request a reload of the device driver.
43
44.. _devlink_params_generic:
45
46Generic configuration parameters
47================================
48The following is a list of generic configuration parameters that drivers may
49add. Use of generic parameters is preferred over each driver creating their
50own name.
51
52.. list-table:: List of generic parameters
53   :widths: 5 5 90
54
55   * - Name
56     - Type
57     - Description
58   * - ``enable_sriov``
59     - Boolean
60     - Enable Single Root I/O Virtualization (SRIOV) in the device.
61   * - ``ignore_ari``
62     - Boolean
63     - Ignore Alternative Routing-ID Interpretation (ARI) capability. If
64       enabled, the adapter will ignore ARI capability even when the
65       platform has support enabled. The device will create the same number
66       of partitions as when the platform does not support ARI.
67   * - ``msix_vec_per_pf_max``
68     - u32
69     - Provides the maximum number of MSI-X interrupts that a device can
70       create. Value is the same across all physical functions (PFs) in the
71       device.
72   * - ``msix_vec_per_pf_min``
73     - u32
74     - Provides the minimum number of MSI-X interrupts required for the
75       device to initialize. Value is the same across all physical functions
76       (PFs) in the device.
77   * - ``fw_load_policy``
78     - u8
79     - Control the device's firmware loading policy.
80        - ``DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_DRIVER`` (0)
81          Load firmware version preferred by the driver.
82        - ``DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_FLASH`` (1)
83          Load firmware currently stored in flash.
84        - ``DEVLINK_PARAM_FW_LOAD_POLICY_VALUE_DISK`` (2)
85          Load firmware currently available on host's disk.
86   * - ``reset_dev_on_drv_probe``
87     - u8
88     - Controls the device's reset policy on driver probe.
89        - ``DEVLINK_PARAM_RESET_DEV_ON_DRV_PROBE_VALUE_UNKNOWN`` (0)
90          Unknown or invalid value.
91        - ``DEVLINK_PARAM_RESET_DEV_ON_DRV_PROBE_VALUE_ALWAYS`` (1)
92          Always reset device on driver probe.
93        - ``DEVLINK_PARAM_RESET_DEV_ON_DRV_PROBE_VALUE_NEVER`` (2)
94          Never reset device on driver probe.
95        - ``DEVLINK_PARAM_RESET_DEV_ON_DRV_PROBE_VALUE_DISK`` (3)
96          Reset the device only if firmware can be found in the filesystem.
97   * - ``enable_roce``
98     - Boolean
99     - Enable handling of RoCE traffic in the device.
100   * - ``enable_eth``
101     - Boolean
102     - When enabled, the device driver will instantiate Ethernet specific
103       auxiliary device of the devlink device.
104   * - ``enable_rdma``
105     - Boolean
106     - When enabled, the device driver will instantiate RDMA specific
107       auxiliary device of the devlink device.
108   * - ``enable_vnet``
109     - Boolean
110     - When enabled, the device driver will instantiate VDPA networking
111       specific auxiliary device of the devlink device.
112   * - ``enable_iwarp``
113     - Boolean
114     - Enable handling of iWARP traffic in the device.
115   * - ``internal_err_reset``
116     - Boolean
117     - When enabled, the device driver will reset the device on internal
118       errors.
119   * - ``max_macs``
120     - u32
121     - Typically macvlan, vlan net devices mac are also programmed in their
122       parent netdevice's Function rx filter. This parameter limit the
123       maximum number of unicast mac address filters to receive traffic from
124       per ethernet port of this device.
125   * - ``region_snapshot_enable``
126     - Boolean
127     - Enable capture of ``devlink-region`` snapshots.
128   * - ``enable_remote_dev_reset``
129     - Boolean
130     - Enable device reset by remote host. When cleared, the device driver
131       will NACK any attempt of other host to reset the device. This parameter
132       is useful for setups where a device is shared by different hosts, such
133       as multi-host setup.
134   * - ``io_eq_size``
135     - u32
136     - Control the size of I/O completion EQs.
137   * - ``event_eq_size``
138     - u32
139     - Control the size of asynchronous control events EQ.
140