[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v4 08/15] docs/devel/testing: add -gdb option to the debugging se
From: |
Emanuele Giuseppe Esposito |
Subject: |
[PATCH v4 08/15] docs/devel/testing: add -gdb option to the debugging section of QEMU iotests |
Date: |
Thu, 20 May 2021 09:52:29 +0200 |
Signed-off-by: Emanuele Giuseppe Esposito <eesposit@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 8144e316a4..a746cab745 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 on whether it is set or not.
+
* ``-d`` (debug) just increases the logging verbosity, showing
for example the QMP commands and answers.
--
2.30.2
- Re: [PATCH v4 04/15] qemu-iotests: add option to attach gdbserver, (continued)
Re: [PATCH v4 04/15] qemu-iotests: add option to attach gdbserver, Vladimir Sementsov-Ogievskiy, 2021/05/26
Re: [PATCH v4 04/15] qemu-iotests: add option to attach gdbserver, Vladimir Sementsov-Ogievskiy, 2021/05/28
[PATCH v4 05/15] qemu-iotests: delay QMP socket timers, Emanuele Giuseppe Esposito, 2021/05/20
[PATCH v4 08/15] docs/devel/testing: add -gdb option to the debugging section of QEMU iotests,
Emanuele Giuseppe Esposito <=
[PATCH v4 03/15] docs/devel/testing: add debug section to the QEMU iotests chapter, Emanuele Giuseppe Esposito, 2021/05/20
[PATCH v4 06/15] qemu_iotests: insert gdbserver command line as wrapper for qemu binary, Emanuele Giuseppe Esposito, 2021/05/20
[PATCH v4 10/15] qemu-iotests: extent QMP socket timeout when using valgrind, Emanuele Giuseppe Esposito, 2021/05/20
[PATCH v4 13/15] docs/devel/testing: add -valgrind option to the debug section of QEMU iotests, Emanuele Giuseppe Esposito, 2021/05/20