2020-01-09 15:46:22 -07:00
|
|
|
.. 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
|
2020-11-04 06:30:37 -07:00
|
|
|
entries, FIB rule entries and nexthops that the driver will allow.
|
2020-01-09 15:46:22 -07:00
|
|
|
|
|
|
|
.. 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
|
2020-11-04 06:30:37 -07:00
|
|
|
$ devlink resource set netdevsim/netdevsim0 path /nexthops size 16
|
2020-01-09 15:46:22 -07:00
|
|
|
$ devlink dev reload netdevsim/netdevsim0
|
|
|
|
|
2021-06-02 05:17:31 -07:00
|
|
|
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.
|
|
|
|
|
2022-08-29 16:54:14 -07:00
|
|
|
Rate nodes and their parameters are exposed in ``netdevsim`` debugfs in RO mode.
|
2021-06-02 05:17:31 -07:00
|
|
|
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
|
|
|
|
|
2020-01-09 15:46:22 -07:00
|
|
|
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
|
2023-01-29 16:10:48 -07:00
|
|
|
identifier (FID) based on the ingress port and VLAN. This trap is used
|
2020-01-09 15:46:22 -07:00
|
|
|
to trap packets for which a FID could not be found
|