devel/testing/functional.rst

1 .. _checkfunctional-ref:
19 that there is no TAP-incompatible output written to stdio, e.g. either by
27    ``self.vm`` attribute (a QEMUMachine instance)
40 -------------
46   make check-functional
53   make check-functional-x86_64
63   $ export QEMU_TEST_QEMU_BINARY=$PWD/qemu-system-x86_64
70 without this variable set.
73 -------
91 -----------------------------
107           res = self.vm.cmd('human-monitor-command',
116 can also be run stand-alone, without a test runner. OTOH when run via a test
136 and also an optional ``name`` attribute so you can identify a specific
154               'human-monitor-command',
158               'human-monitor-command',
162               'human-monitor-command',
171 -----------
174 device-crash-test and other Python scripts.  It's a wrapper around the
177  * the ability to set command line arguments to be given to the QEMU
184  * convenience methods to set commonly used command line arguments in
191 primarily depend on the value of the ``qemu_bin`` instance attribute.
192 If it is not explicitly set by the test code, its default value will
202 to a UNIX socket name. The ``qmp-shell`` command can then be
205 Attribute reference
206 -------------------
219 Tests are also free to use this attribute value, for their own needs.
239 qemu-system-* binaries.
250 The cpu model that will be set to all QEMUMachine instances created
256 The machine type that will be set to all QEMUMachine instances created
258 class to set this attribute, you can automatically check whether the
263 --------------
277 run only ``make check-functional``, the "thorough" tests will be
281   make -j$(nproc) check SPEED=thorough
288 the tests are run. This pre-caching is done with the qemu_test.Asset
304 The pre-caching will be done automatically when running
305 ``make check-functional`` (but not when running e.g.
306 ``make check-functional-<target>``). In case you just want to download
309     make precache-functional
316 --------------
324   https://docs.python.org/3/library/unittest.html#skipping-tests-and-expected-failures
363   # See https://gitlab.com/qemu-project/qemu/-/issues/nnnn
377 the QEMU_TEST_ALLOW_SLOW environment variable has been set.