docs/devel/testing: expand documentation for 'make check-block'
Explain in greater detail what 'check-block' will run for each format, and also document the new format specific targets. Reviewed-by: Kevin Wolf <kwolf@redhat.com> Reviewed-by: Thomas Huth <thuth@redhat.com> Reviewed-by: Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
Daniel P. Berrangé committed
Jan 12, 2026 at 13:33 UTC
d63c082a43697542c3865f6bda64109f1d729d71
2 files changed
+24
-3
docs/devel/testing/main.rst
+22
-3
@@ -236,9 +236,28 @@ same commit that alters the generator code.
236
check-block
237
~~~~~~~~~~~
238
239
-``make check-block`` runs a subset of the block layer iotests (the tests that
240
-are in the "auto" group).
241
-See the "QEMU iotests" section below for more information.
239
+There are a variety of ways to exercise the block layer I/O tests
240
+via make targets.
241
+
242
+A default ``make check`` or ``make check-block`` command will exercise
243
+the ``qcow2`` format, using the tests tagged into the ``auto`` group
244
+only.
245
+
246
+These targets accept the ``SPEED`` variable to augment the set of tests
247
+to run. A slightly more comprehensive test plan can be run by defining
248
+``SPEED=slow``, which enables all tests for the ``qcow2`` and ``raw``
249
+formats. The most comprehensive test plan can be run by defining
250
+``SPEED=thorough``, which enables all available tests for the formats
251
+``parallels``, ``qcow2``, ``qed``, ``raw``, ``vdi``, ``vhdx``,
252
+``vmdk``, and ``vpc``.
253
+
254
+Each of formats also has its own dedicated make target, named
255
+``make check-block-$FORMAT`` which will run all available tests for
256
+the designated format and does not require the ``SPEED`` variable
257
+to be set.
258
+
259
+See the "QEMU iotests" section below for more information on the
260
+block I/O test framework that is leveraged by these ``make`` targets.
261
262
.. _qemu-iotests:
263
tests/qemu-iotests/meson.build
+2
@@ -10,6 +10,8 @@ endif
10
11
qemu_iotests_binaries = [qemu_img, qemu_io, qemu_nbd, qsd]
12
qemu_iotests_env = {'PYTHON': python.full_path()}
13
+# If altering this definition, also update docs/devel/testing/main.rst
14
+# section on 'check-block' targets to reflect the changes
15
qemu_iotests_formats = {
16
'qcow2': 'quick',
17
'raw': 'slow',