mlxsw.rst

  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.psid``
 79     - fixed
 80     - Line card device PSID
 81   * - ``fw.version``
 82     - running
 83     - Three digit firmware version of line card device
 84
 85Driver-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