16c39e015SJacob Keller.. SPDX-License-Identifier: GPL-2.0
26c39e015SJacob Keller
36c39e015SJacob Keller=====================
46c39e015SJacob Kellermlxsw devlink support
56c39e015SJacob Keller=====================
66c39e015SJacob Keller
76c39e015SJacob KellerThis document describes the devlink features implemented by the ``mlxsw``
86c39e015SJacob Kellerdevice driver.
96c39e015SJacob Keller
106c39e015SJacob KellerParameters
116c39e015SJacob Keller==========
126c39e015SJacob Keller
136c39e015SJacob Keller.. list-table:: Generic parameters implemented
146c39e015SJacob Keller
156c39e015SJacob Keller   * - Name
166c39e015SJacob Keller     - Mode
176c39e015SJacob Keller   * - ``fw_load_policy``
186c39e015SJacob Keller     - driverinit
196c39e015SJacob Keller
206c39e015SJacob KellerThe ``mlxsw`` driver also implements the following driver-specific
216c39e015SJacob Kellerparameters.
226c39e015SJacob Keller
236c39e015SJacob Keller.. list-table:: Driver-specific parameters implemented
246c39e015SJacob Keller   :widths: 5 5 5 85
256c39e015SJacob Keller
266c39e015SJacob Keller   * - Name
276c39e015SJacob Keller     - Type
286c39e015SJacob Keller     - Mode
296c39e015SJacob Keller     - Description
306c39e015SJacob Keller   * - ``acl_region_rehash_interval``
316c39e015SJacob Keller     - u32
326c39e015SJacob Keller     - runtime
336c39e015SJacob Keller     - Sets an interval for periodic ACL region rehashes. The value is
346c39e015SJacob Keller       specified in milliseconds, with a minimum of ``3000``. The value of
356c39e015SJacob Keller       ``0`` disables periodic work entirely. The first rehash will be run
366c39e015SJacob Keller       immediately after the value is set.
376c39e015SJacob Keller
386c39e015SJacob KellerThe ``mlxsw`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
39d4255d75SJacob Keller
40d4255d75SJacob KellerInfo versions
41d4255d75SJacob Keller=============
42d4255d75SJacob Keller
431d0ee02bSIdo SchimmelThe ``mlxsw`` driver reports the following versions
44d4255d75SJacob Keller
45d4255d75SJacob Keller.. list-table:: devlink info versions implemented
46d4255d75SJacob Keller   :widths: 5 5 90
47d4255d75SJacob Keller
48d4255d75SJacob Keller   * - Name
49d4255d75SJacob Keller     - Type
50d4255d75SJacob Keller     - Description
51d4255d75SJacob Keller   * - ``hw.revision``
52d4255d75SJacob Keller     - fixed
53d4255d75SJacob Keller     - The hardware revision for this board
54d4255d75SJacob Keller   * - ``fw.psid``
55d4255d75SJacob Keller     - fixed
56d4255d75SJacob Keller     - Firmware PSID
57d4255d75SJacob Keller   * - ``fw.version``
58d4255d75SJacob Keller     - running
59d4255d75SJacob Keller     - Three digit firmware version
605b051621SAmit Cohen
615ba325feSJiri PirkoLine card auxiliary device info versions
625ba325feSJiri Pirko========================================
635ba325feSJiri Pirko
645ba325feSJiri PirkoThe ``mlxsw`` driver reports the following versions for line card auxiliary device
655ba325feSJiri Pirko
665ba325feSJiri Pirko.. list-table:: devlink info versions implemented
675ba325feSJiri Pirko   :widths: 5 5 90
685ba325feSJiri Pirko
695ba325feSJiri Pirko   * - Name
705ba325feSJiri Pirko     - Type
715ba325feSJiri Pirko     - Description
725ba325feSJiri Pirko   * - ``hw.revision``
735ba325feSJiri Pirko     - fixed
745ba325feSJiri Pirko     - The hardware revision for this line card
755ba325feSJiri Pirko   * - ``ini.version``
765ba325feSJiri Pirko     - running
775ba325feSJiri Pirko     - Version of line card INI loaded
78*3fc0c519SJiri Pirko   * - ``fw.psid``
79*3fc0c519SJiri Pirko     - fixed
80*3fc0c519SJiri Pirko     - Line card device PSID
814da0eb2aSJiri Pirko   * - ``fw.version``
824da0eb2aSJiri Pirko     - running
834da0eb2aSJiri Pirko     - Three digit firmware version of line card device
845ba325feSJiri Pirko
855b051621SAmit CohenDriver-specific Traps
865b051621SAmit Cohen=====================
875b051621SAmit Cohen
885b051621SAmit Cohen.. list-table:: List of Driver-specific Traps Registered by ``mlxsw``
895b051621SAmit Cohen   :widths: 5 5 90
905b051621SAmit Cohen
915b051621SAmit Cohen   * - Name
925b051621SAmit Cohen     - Type
935b051621SAmit Cohen     - Description
945b051621SAmit Cohen   * - ``irif_disabled``
955b051621SAmit Cohen     - ``drop``
965b051621SAmit Cohen     - Traps packets that the device decided to drop because they need to be
975b051621SAmit Cohen       routed from a disabled router interface (RIF). This can happen during
985b051621SAmit Cohen       RIF dismantle, when the RIF is first disabled before being removed
995b051621SAmit Cohen       completely
1005b051621SAmit Cohen   * - ``erif_disabled``
1015b051621SAmit Cohen     - ``drop``
1025b051621SAmit Cohen     - Traps packets that the device decided to drop because they need to be
1035b051621SAmit Cohen       routed through a disabled router interface (RIF). This can happen during
1045b051621SAmit Cohen       RIF dismantle, when the RIF is first disabled before being removed
1055b051621SAmit Cohen       completely
106