Documentation/networking/devlink/mlxsw.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2
   3 =====================
   4 mlxsw devlink support
   5 =====================
   6
   7 This document describes the devlink features implemented by the ``mlxsw``
   8 device driver.
   9
  10 Parameters
  11 ==========
  12
  13 .. list-table:: Generic parameters implemented
  14
  15    * - Name
  16      - Mode
  17    * - ``fw_load_policy``
  18      - driverinit
  19
  20 The ``mlxsw`` driver also implements the following driver-specific
  21 parameters.
  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
  38 The ``mlxsw`` driver supports reloading via ``DEVLINK_CMD_RELOAD``
  39
  40 Info versions
  41 =============
  42
  43 The ``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
  61 Line card auxiliary device info versions
  62 ========================================
  63
  64 The ``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
  85 Driver-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