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