0001 .. SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
0002
0003 =================
0004 Devlink Selftests
0005 =================
0006
0007 The ``devlink-selftests`` API allows executing selftests on the device.
0008
0009 Tests Mask
0010 ==========
0011 The ``devlink-selftests`` command should be run with a mask indicating
0012 the tests to be executed.
0013
0014 Tests Description
0015 =================
0016 The following is a list of tests that drivers may execute.
0017
0018 .. list-table:: List of tests
0019 :widths: 5 90
0020
0021 * - Name
0022 - Description
0023 * - ``DEVLINK_SELFTEST_FLASH``
0024 - Devices may have the firmware on non-volatile memory on the board, e.g.
0025 flash. This particular test helps to run a flash selftest on the device.
0026 Implementation of the test is left to the driver/firmware.
0027
0028 example usage
0029 -------------
0030
0031 .. code:: shell
0032
0033 # Query selftests supported on the devlink device
0034 $ devlink dev selftests show DEV
0035 # Query selftests supported on all devlink devices
0036 $ devlink dev selftests show
0037 # Executes selftests on the device
0038 $ devlink dev selftests run DEV id flash
