1.. SPDX-License-Identifier: GPL-2.0
2
3=====================
4mlxsw devlink support
5=====================
6
7This document describes the devlink features implemented by the ``mlxsw``
8device driver.
9
10Parameters
11==========
12
13.. list-table:: Generic parameters implemented
14
15   * - Name
16     - Mode
17   * - ``fw_load_policy``
18     - driverinit
19
20The ``mlxsw`` driver also implements the following driver-specific
21parameters.
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
38The ``mlxsw`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
39
40Info versions
41=============
42
43The ``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
61Line card info versions
62=======================
63
64The ``mlxsw`` driver reports the following versions for line cards
65
66.. list-table:: devlink line card info versions implemented
67   :widths: 5 5 90
68
69   * - Name
70     - Type
71     - Description
72   * - ``hw.revision``
73     - fixed
74     - The hardware revision for this line card
75   * - ``ini.version``
76     - running
77     - Version of line card INI loaded
78
79Driver-specific Traps
80=====================
81
82.. list-table:: List of Driver-specific Traps Registered by ``mlxsw``
83   :widths: 5 5 90
84
85   * - Name
86     - Type
87     - Description
88   * - ``irif_disabled``
89     - ``drop``
90     - Traps packets that the device decided to drop because they need to be
91       routed from a disabled router interface (RIF). This can happen during
92       RIF dismantle, when the RIF is first disabled before being removed
93       completely
94   * - ``erif_disabled``
95     - ``drop``
96     - Traps packets that the device decided to drop because they need to be
97       routed through a disabled router interface (RIF). This can happen during
98       RIF dismantle, when the RIF is first disabled before being removed
99       completely
100