0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 =====================
0004 mlxsw devlink support
0005 =====================
0006
0007 This document describes the devlink features implemented by the ``mlxsw``
0008 device driver.
0009
0010 Parameters
0011 ==========
0012
0013 .. list-table:: Generic parameters implemented
0014
0015 * - Name
0016 - Mode
0017 * - ``fw_load_policy``
0018 - driverinit
0019
0020 The ``mlxsw`` driver also implements the following driver-specific
0021 parameters.
0022
0023 .. list-table:: Driver-specific parameters implemented
0024 :widths: 5 5 5 85
0025
0026 * - Name
0027 - Type
0028 - Mode
0029 - Description
0030 * - ``acl_region_rehash_interval``
0031 - u32
0032 - runtime
0033 - Sets an interval for periodic ACL region rehashes. The value is
0034 specified in milliseconds, with a minimum of ``3000``. The value of
0035 ``0`` disables periodic work entirely. The first rehash will be run
0036 immediately after the value is set.
0037
0038 The ``mlxsw`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
0039
0040 Info versions
0041 =============
0042
0043 The ``mlxsw`` driver reports the following versions
0044
0045 .. list-table:: devlink info versions implemented
0046 :widths: 5 5 90
0047
0048 * - Name
0049 - Type
0050 - Description
0051 * - ``hw.revision``
0052 - fixed
0053 - The hardware revision for this board
0054 * - ``fw.psid``
0055 - fixed
0056 - Firmware PSID
0057 * - ``fw.version``
0058 - running
0059 - Three digit firmware version
0060
0061 Line card auxiliary device info versions
0062 ========================================
0063
0064 The ``mlxsw`` driver reports the following versions for line card auxiliary device
0065
0066 .. list-table:: devlink info versions implemented
0067 :widths: 5 5 90
0068
0069 * - Name
0070 - Type
0071 - Description
0072 * - ``hw.revision``
0073 - fixed
0074 - The hardware revision for this line card
0075 * - ``ini.version``
0076 - running
0077 - Version of line card INI loaded
0078 * - ``fw.psid``
0079 - fixed
0080 - Line card device PSID
0081 * - ``fw.version``
0082 - running
0083 - Three digit firmware version of line card device
0084
0085 Driver-specific Traps
0086 =====================
0087
0088 .. list-table:: List of Driver-specific Traps Registered by ``mlxsw``
0089 :widths: 5 5 90
0090
0091 * - Name
0092 - Type
0093 - Description
0094 * - ``irif_disabled``
0095 - ``drop``
0096 - Traps packets that the device decided to drop because they need to be
0097 routed from a disabled router interface (RIF). This can happen during
0098 RIF dismantle, when the RIF is first disabled before being removed
0099 completely
0100 * - ``erif_disabled``
0101 - ``drop``
0102 - Traps packets that the device decided to drop because they need to be
0103 routed through a disabled router interface (RIF). This can happen during
0104 RIF dismantle, when the RIF is first disabled before being removed
0105 completely
