diff mbox series

[v3,03/15] docs/devel/testing: add debug section to the QEMU iotests chapter

Message ID 20210414170352.29927-4-eesposit@redhat.com (mailing list archive)
State New, archived
Headers show
Series qemu_iotests: improve debugging options | expand

Commit Message

Emanuele Giuseppe Esposito April 14, 2021, 5:03 p.m. UTC
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(+)

Comments

Max Reitz April 30, 2021, 11:23 a.m. UTC | #1
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
>   ----------------
>   
>
Paolo Bonzini April 30, 2021, 2:07 p.m. UTC | #2
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
diff mbox series

Patch

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
 ----------------