On 11/3/2026 3:08 AM, Peter Maydell wrote: > The iotests section of the testing documentation suggests directly > running the "./check" script. However if you do this then the > script complains: > > WARNING: iotests is being run from outside of the configure-time python > virtual environment > [...] > Please use the meson run script: > /home/pm215/qemu/build/x86-tgt-san-dbg/run ./check >
A bit a side question, Does it bring anything useful compared to: ./build/run meson test <this_test or suite>? If not, maybe we can remove all this, including the extra doc. We can also add test suites if that's the missing piece to run a specific group of tests. > Update the documentation to match this. > > Signed-off-by: Peter Maydell <[email protected]> > --- > docs/devel/testing/main.rst | 14 +++++++++----- > 1 file changed, 9 insertions(+), 5 deletions(-) > > diff --git a/docs/devel/testing/main.rst b/docs/devel/testing/main.rst > index b0ca37fe2ba..e26b8af0c79 100644 > --- a/docs/devel/testing/main.rst > +++ b/docs/devel/testing/main.rst > @@ -272,8 +272,12 @@ scripts. The testing success criteria is golden output > comparison, and the > test files are named with numbers. > > To run iotests, make sure QEMU is built successfully, then switch to the > -``tests/qemu-iotests`` directory under the build directory, and run > ``./check`` > -with desired arguments from there. > +``tests/qemu-iotests`` directory under the build directory, and run > +the ``check`` script via the ``run`` wrapper which sets up the environment: > + > +.. code:: > + > + ../../run ./check [args] > > By default, "raw" format and "file" protocol is used; all tests will be > executed, except the unsupported ones. You can override the format and > protocol > @@ -282,16 +286,16 @@ with arguments: > .. code:: > > # test with qcow2 format > - ./check -qcow2 > + ../../run ./check -qcow2 > # or test a different protocol > - ./check -nbd > + ../../run ./check -nbd > > It's also possible to list test numbers explicitly: > > .. code:: > > # run selected cases with qcow2 format > - ./check -qcow2 001 030 153 > + ../../run ./check -qcow2 001 030 153 > > Cache mode can be selected with the "-c" option, which may help reveal bugs > that are specific to certain cache mode.
