[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v9 09/16] docs/devel/testing: add -gdb option to the debugging se
From: |
Emanuele Giuseppe Esposito |
Subject: |
[PATCH v9 09/16] docs/devel/testing: add -gdb option to the debugging section of QEMU iotests |
Date: |
Mon, 9 Aug 2021 11:01:07 +0200 |
Signed-off-by: Emanuele Giuseppe Esposito <eesposit@redhat.com>
Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
Reviewed-by: Max Reitz <mreitz@redhat.com>
---
docs/devel/testing.rst | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst
index 8359f2ae37..01e1919873 100644
--- a/docs/devel/testing.rst
+++ b/docs/devel/testing.rst
@@ -229,6 +229,17 @@ Debugging a test case
The following options to the ``check`` script can be useful when debugging
a failing test:
+* ``-gdb`` wraps every QEMU invocation in a ``gdbserver``, which waits for a
+ connection from a gdb client. The options given to ``gdbserver`` (e.g. the
+ address on which to listen for connections) are taken from the
``$GDB_OPTIONS``
+ environment variable. By default (if ``$GDB_OPTIONS`` is empty), it listens
on
+ ``localhost:12345``.
+ It is possible to connect to it for example with
+ ``gdb -iex "target remote $addr"``, where ``$addr`` is the address
+ ``gdbserver`` listens on.
+ If the ``-gdb`` option is not used, ``$GDB_OPTIONS`` is ignored,
+ regardless of whether it is set or not.
+
* ``-d`` (debug) just increases the logging verbosity, showing
for example the QMP commands and answers.
--
2.31.1
- [PATCH v9 00/16] qemu_iotests: improve debugging options, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 01/16] python: qemu: add timer parameter for qmp.accept socket, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 02/16] python: Reduce strictness of pylint's duplicate-code check, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 05/16] qemu-iotests: add option to attach gdbserver, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 04/16] docs/devel/testing: add debug section to the QEMU iotests chapter, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 03/16] python: qemu: pass the wrapper field from QEMUQtestmachine to QEMUMachine, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 06/16] qemu-iotests: delay QMP socket timers, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 07/16] qemu_iotests: insert gdbserver command line as wrapper for qemu binary, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 08/16] qemu-iotests: add gdbserver option to script tests too, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 09/16] docs/devel/testing: add -gdb option to the debugging section of QEMU iotests,
Emanuele Giuseppe Esposito <=
- [PATCH v9 11/16] qemu-iotests: extend QMP socket timeout when using valgrind, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 10/16] qemu-iotests: extend the check script to prepare supporting valgrind for python tests, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 12/16] qemu-iotests: allow valgrind to read/delete the generated log file, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 13/16] qemu-iotests: insert valgrind command line as wrapper for qemu binary, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 14/16] docs/devel/testing: add -valgrind option to the debug section of QEMU iotests, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 15/16] qemu-iotests: add option to show qemu binary logs on stdout, Emanuele Giuseppe Esposito, 2021/08/09
- [PATCH v9 16/16] docs/devel/testing: add -p option to the debug section of QEMU iotests, Emanuele Giuseppe Esposito, 2021/08/09
- Re: [PATCH v9 00/16] qemu_iotests: improve debugging options, Hanna Reitz, 2021/08/10