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 auxiliary device info versions
62========================================
63
64The ``mlxsw`` driver reports the following versions for line card auxiliary device
65
66.. list-table:: devlink 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   * - ``fw.psid``
79     - fixed
80     - Line card device PSID
81   * - ``fw.version``
82     - running
83     - Three digit firmware version of line card device
84
85Driver-specific Traps
86=====================
87
88.. list-table:: List of Driver-specific Traps Registered by ``mlxsw``
89   :widths: 5 5 90
90
91   * - Name
92     - Type
93     - Description
94   * - ``irif_disabled``
95     - ``drop``
96     - Traps packets that the device decided to drop because they need to be
97       routed from a disabled router interface (RIF). This can happen during
98       RIF dismantle, when the RIF is first disabled before being removed
99       completely
100   * - ``erif_disabled``
101     - ``drop``
102     - Traps packets that the device decided to drop because they need to be
103       routed through a disabled router interface (RIF). This can happen during
104       RIF dismantle, when the RIF is first disabled before being removed
105       completely
106