@@ -405,6 +405,19 @@ argument should be passed as part of the command::
These machines are the ones present in your BSP layer, in the ``conf/machine/``
directory.
+To run only some of the tests, for example to split a long check over
+several runs, pass their names to the ``--run-tests`` argument, as
+``<module>[.<class>[.<name>]]``::
+
+ $ source oe-init-build-env
+ $ yocto-check-layer --run-tests bsp --machines <machine1> <machine2> ... -- your_layer_directory
+
+.. note::
+
+ A "PASS" from such a run only covers the tests and machines it ran. A
+ layer is Yocto Project Compatible only if a single run with all the
+ tests, and with all the machines of a BSP layer, passes.
+
Entering the command causes the script to determine the type of layer
and then to execute a set of specific tests against the layer.
yocto-check-layer can now run a subset of its tests with --run-tests, for example to split a long check of a BSP layer over several runs. Document the option, and that a PASS from such a run doesn't make a layer Yocto Project Compatible: that needs a single run with all the tests and, for a BSP layer, all its machines. AI-Generated: Claude Code, Opus 5.5 Signed-off-by: Otavio Salvador <otavio@ossystems.tech> --- documentation/dev-manual/layers.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+)