diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index 1fb6cfadb9..2404a73dd3 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -5217,6 +5217,78 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" + TEST_QEMUBOOT_TIMEOUT + + + The time in seconds allowed for a QEMU image to boot before + tests begin to run against the image using the following + command: + + bitbake <qemu_image> -c testimage + + + + + The default timeout period to allow the boot process to + reach the login prompt is 500 seconds. + You can edit this default value in the + local.conf file. + + + + For more information on testing QEMU images, see the + "Running and Writing Tests for a QEMU Image" + section in the Yocto Project Development Manual. + + + + + TEST_SUITES + + + An ordered list of tests (modules) to run against + a QEMU image using the following command: + + bitbake <qemu_image> -c testimage + + + + + The Yocto Project provides a core set of tests that can + be used against QEMU images. + Tests include ping, + ssh, df among + others. + You can add your own tests to the list of tests by + appending TEST_SUITES as follows: + + TEST_SUITES_append = " mytest" + + + + + The order in which tests are run is important. + Tests that depend on another test must appear later in the + list than the test on which they depend. + For example, if you append the list of tests with two + tests (test_A and + test_B) where + test_B is dependent on + test_A, then you must order the tests + as follows: + + TEST_SUITES = " test_A test_B" + + + + + For more information on testing QEMU images, see the + "Running and Writing Tests for a QEMU Image" + section in the Yocto Project Development Manual. + + + + THISDIR