| .. SPDX-License-Identifier: GPL-2.0 |
| |
| ========================= |
| netdevsim devlink support |
| ========================= |
| |
| This document describes the ``devlink`` features supported by the |
| ``netdevsim`` device driver. |
| |
| Parameters |
| ========== |
| |
| .. list-table:: Generic parameters implemented |
| |
| * - Name |
| - Mode |
| * - ``max_macs`` |
| - driverinit |
| |
| The ``netdevsim`` driver also implements the following driver-specific |
| parameters. |
| |
| .. list-table:: Driver-specific parameters implemented |
| :widths: 5 5 5 85 |
| |
| * - Name |
| - Type |
| - Mode |
| - Description |
| * - ``test1`` |
| - Boolean |
| - driverinit |
| - Test parameter used to show how a driver-specific devlink parameter |
| can be implemented. |
| |
| The ``netdevsim`` driver supports reloading via ``DEVLINK_CMD_RELOAD`` |
| |
| Regions |
| ======= |
| |
| The ``netdevsim`` driver exposes a ``dummy`` region as an example of how the |
| devlink-region interfaces work. A snapshot is taken whenever the |
| ``take_snapshot`` debugfs file is written to. |
| |
| Resources |
| ========= |
| |
| The ``netdevsim`` driver exposes resources to control the number of FIB |
| entries, FIB rule entries and nexthops that the driver will allow. |
| |
| .. code:: shell |
| |
| $ devlink resource set netdevsim/netdevsim0 path /IPv4/fib size 96 |
| $ devlink resource set netdevsim/netdevsim0 path /IPv4/fib-rules size 16 |
| $ devlink resource set netdevsim/netdevsim0 path /IPv6/fib size 64 |
| $ devlink resource set netdevsim/netdevsim0 path /IPv6/fib-rules size 16 |
| $ devlink resource set netdevsim/netdevsim0 path /nexthops size 16 |
| $ devlink dev reload netdevsim/netdevsim0 |
| |
| Rate objects |
| ============ |
| |
| The ``netdevsim`` driver supports rate objects management, which includes: |
| |
| - registerging/unregistering leaf rate objects per VF devlink port; |
| - creation/deletion node rate objects; |
| - setting tx_share and tx_max rate values for any rate object type; |
| - setting parent node for any rate object type. |
| |
| Rate nodes and their parameters are exposed in ``netdevsim`` debugfs in RO mode. |
| For example created rate node with name ``some_group``: |
| |
| .. code:: shell |
| |
| $ ls /sys/kernel/debug/netdevsim/netdevsim0/rate_groups/some_group |
| rate_parent tx_max tx_share |
| |
| Same parameters are exposed for leaf objects in corresponding ports directories. |
| For ex.: |
| |
| .. code:: shell |
| |
| $ ls /sys/kernel/debug/netdevsim/netdevsim0/ports/1 |
| dev ethtool rate_parent tx_max tx_share |
| |
| Driver-specific Traps |
| ===================== |
| |
| .. list-table:: List of Driver-specific Traps Registered by ``netdevsim`` |
| :widths: 5 5 90 |
| |
| * - Name |
| - Type |
| - Description |
| * - ``fid_miss`` |
| - ``exception`` |
| - When a packet enters the device it is classified to a filtering |
| identifier (FID) based on the ingress port and VLAN. This trap is used |
| to trap packets for which a FID could not be found |
