Message ID | 20210604091723.13419-10-eesposit@redhat.com |
---|---|
State | New |
Headers | show |
Series | qemu_iotests: improve debugging options | expand |
04.06.2021 12:17, Emanuele Giuseppe Esposito wrote: > Signed-off-by: Emanuele Giuseppe Esposito <eesposit@redhat.com> > Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com> > --- > docs/devel/testing.rst | 11 +++++++++++ > 1 file changed, 11 insertions(+) > > diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst > index 9d6a8f8636..11a0359218 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, Then, --gdb here too > + regardless on whether it is set or not. > + > * ``-d`` (debug) just increases the logging verbosity, showing > for example the QMP commands and answers. > >
diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst index 9d6a8f8636..11a0359218 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.