Introduce the "Debugging a test case" section, in preparation
to the additional flags that will be added in the next patches.

Signed-off-by: Emanuele Giuseppe Esposito <eesposit@redhat.com>
---
 docs/devel/testing.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst
index 1434a50cc4..b7e2370e7e 100644
--- a/docs/devel/testing.rst
+++ b/docs/devel/testing.rst
@@ -224,6 +224,14 @@ another application on the host may have locked the file, possibly leading to a
 test failure.  If using such devices are explicitly desired, consider adding
 ``locking=off`` option to disable image locking.
 
+Debugging a test case
+-----------------------
+QEMU iotests offers some options to debug a failing test, that can be
+given as options to the ``check`` script:
+
+* ``-d`` (debug) just increases the logging verbosity, showing
+  for example the QMP commands and answers.
+
 Test case groups
 ----------------
 
-- 
2.30.2

On 14.04.21 19:03, Emanuele Giuseppe Esposito wrote:
> Introduce the "Debugging a test case" section, in preparation
> to the additional flags that will be added in the next patches.
> 
> Signed-off-by: Emanuele Giuseppe Esposito <eesposit@redhat.com>
> ---
>   docs/devel/testing.rst | 8 ++++++++
>   1 file changed, 8 insertions(+)
> 
> diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst
> index 1434a50cc4..b7e2370e7e 100644
> --- a/docs/devel/testing.rst
> +++ b/docs/devel/testing.rst
> @@ -224,6 +224,14 @@ another application on the host may have locked the file, possibly leading to a
>   test failure.  If using such devices are explicitly desired, consider adding
>   ``locking=off`` option to disable image locking.
>   
> +Debugging a test case
> +-----------------------
> +QEMU iotests offers some options to debug a failing test, that can be

-,

Max

> +given as options to the ``check`` script:
> +
> +* ``-d`` (debug) just increases the logging verbosity, showing
> +  for example the QMP commands and answers.
> +
>   Test case groups
>   ----------------
>   
> 

On 30/04/21 13:23, Max Reitz wrote:
>>
>> +-----------------------
>> +QEMU iotests offers some options to debug a failing test, that can be
>> +given as options to the ``check`` script: 
> 
> -,

Even better: "The following options to the ``check`` script can be 
useful when debugging a failing test:".

Paolo