tests/functional: add a QMP backdoor for debugging stalled tests
authorDaniel P. Berrangé <berrange@redhat.com>
Thu, 21 Nov 2024 16:57:44 +0000 (16:57 +0000)
committerAlex Bennée <alex.bennee@linaro.org>
Mon, 25 Nov 2024 10:13:41 +0000 (10:13 +0000)
commit1a8755a51eef11360af92adf71fed6a20a1260b2
tree7666f048756b55c8b0818838025122eb27248bfe
parent97d79319f0475fe248962166d9ec4ecf6477d8cc
tests/functional: add a QMP backdoor for debugging stalled tests

Support the QEMU_TEST_QMP_BACKDOOR=backdoor.sock env variable as a
way to get a QMP backdoor for debugging a stalled QEMU test. Most
typically this would be used if running the tests directly:

 $ QEMU_TEST_QMP_BACKDOOR=backdoor.sock \
   QEMU_TEST_QEMU_BINARY=./build/qemu-system-arm \
   PYTHONPATH=./python \
   ./tests/functional/test_arm_tuxrun.py

And then, when the test stalls, in a second shell run:

 $ ./scripts/qmp/qmp-shell backdoor.sock

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
Message-Id: <20241121154218.1423005-18-berrange@redhat.com>
Reviewed-by: Thomas Huth <thuth@redhat.com>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Message-Id: <20241121165806.476008-18-alex.bennee@linaro.org>
docs/devel/testing/functional.rst
tests/functional/qemu_test/testcase.py