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