Merge tag '5.14-rc-smb3-fixes-part1' of git://git.samba.org/sfrench/cifs-2.6
[linux-2.6-microblaze.git] / Documentation / networking / devlink / mlxsw.rst
1 .. SPDX-License-Identifier: GPL-2.0
2
3 =====================
4 mlxsw devlink support
5 =====================
6
7 This document describes the devlink features implemented by the ``mlxsw``
8 device driver.
9
10 Parameters
11 ==========
12
13 .. list-table:: Generic parameters implemented
14
15    * - Name
16      - Mode
17    * - ``fw_load_policy``
18      - driverinit
19
20 The ``mlxsw`` driver also implements the following driver-specific
21 parameters.
22
23 .. list-table:: Driver-specific parameters implemented
24    :widths: 5 5 5 85
25
26    * - Name
27      - Type
28      - Mode
29      - Description
30    * - ``acl_region_rehash_interval``
31      - u32
32      - runtime
33      - Sets an interval for periodic ACL region rehashes. The value is
34        specified in milliseconds, with a minimum of ``3000``. The value of
35        ``0`` disables periodic work entirely. The first rehash will be run
36        immediately after the value is set.
37
38 The ``mlxsw`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
39
40 Info versions
41 =============
42
43 The ``mlxsw`` driver reports the following versions
44
45 .. list-table:: devlink info versions implemented
46    :widths: 5 5 90
47
48    * - Name
49      - Type
50      - Description
51    * - ``hw.revision``
52      - fixed
53      - The hardware revision for this board
54    * - ``fw.psid``
55      - fixed
56      - Firmware PSID
57    * - ``fw.version``
58      - running
59      - Three digit firmware version
60
61 Driver-specific Traps
62 =====================
63
64 .. list-table:: List of Driver-specific Traps Registered by ``mlxsw``
65    :widths: 5 5 90
66
67    * - Name
68      - Type
69      - Description
70    * - ``irif_disabled``
71      - ``drop``
72      - Traps packets that the device decided to drop because they need to be
73        routed from a disabled router interface (RIF). This can happen during
74        RIF dismantle, when the RIF is first disabled before being removed
75        completely
76    * - ``erif_disabled``
77      - ``drop``
78      - Traps packets that the device decided to drop because they need to be
79        routed through a disabled router interface (RIF). This can happen during
80        RIF dismantle, when the RIF is first disabled before being removed
81        completely