diff options
author | Thomas Huth <thuth@redhat.com> | 2025-01-28 16:28:35 +0100 |
---|---|---|
committer | Thomas Huth <thuth@redhat.com> | 2025-01-30 10:50:56 +0100 |
commit | 4ae633b012210452b68dc20238fe4edd41d2635b (patch) | |
tree | af5de85610c9eafb93a8082b7e4bed00facd2038 /docs/devel | |
parent | fc9fea48be250ad3e51ddaea9508a320896c094b (diff) | |
download | qemu-4ae633b012210452b68dc20238fe4edd41d2635b.zip qemu-4ae633b012210452b68dc20238fe4edd41d2635b.tar.gz qemu-4ae633b012210452b68dc20238fe4edd41d2635b.tar.bz2 |
tests/functional: Add a decorator for skipping long running tests
Some tests have a very long runtime and might run into timeout issues
e.g. when QEMU has been compiled with --enable-debug. Add a decorator
for marking them more easily. Rename the corresponding environment
variable to be more in sync with the other QEMU_TEST_ALLOW_* switches
that we already have, and add a paragraph about it in the documentation.
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Message-ID: <20250128152839.184599-2-thuth@redhat.com>
Signed-off-by: Thomas Huth <thuth@redhat.com>
Diffstat (limited to 'docs/devel')
-rw-r--r-- | docs/devel/testing/functional.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/devel/testing/functional.rst b/docs/devel/testing/functional.rst index ae238ed..ecc7389 100644 --- a/docs/devel/testing/functional.rst +++ b/docs/devel/testing/functional.rst @@ -351,5 +351,13 @@ the code snippet below: Tests should not live in this state forever and should either be fixed or eventually removed. +QEMU_TEST_ALLOW_SLOW +^^^^^^^^^^^^^^^^^^^^ +Tests that have a very long runtime and might run into timeout issues +e.g. if the QEMU binary has been compiled with debugging options enabled. +To avoid these timeout issues by default and to save some precious CPU +cycles during normal testing, such tests are disabled by default unless +the QEMU_TEST_ALLOW_SLOW environment variable has been set. + .. _unittest: https://docs.python.org/3/library/unittest.html |