Clarify language for the '?' packet

Both QEMU and kgdb make the assumption that the '?' packet is only
sent during the initial setup of a gdbstub connection. Both use that
knowledge to reset breakpoints and ensure the gdbstub is in a
clean-state on a resumed connection. This can cause confusion for
others implementing clients that speak to gdbstub devices. To avoid
that make the language clearer that this is a start-up query packet
that you only expect to see once.

Signed-off-by: Alex Bennée <alex.bennee@linaro.org>

gdb/doc/ChangeLog:

	* gdb.texinfo (Packets): Clarify language for ? packet.

Change-Id: Iae25d3110fe28b8d2467704962a6889e55224ca5
This commit is contained in:
Alex Bennée
2020-12-23 16:36:16 -05:00
committed by Simon Marchi
parent 279d901e5a
commit f37059ea22
2 changed files with 8 additions and 3 deletions

View File

@ -1,3 +1,7 @@
2020-12-23 Alex Bennée <alex.bennee@linaro.org>
* gdb.texinfo (Packets): Clarify language for ? packet.
2020-12-21 Joel Brobecker <brobecker@adacore.com> 2020-12-21 Joel Brobecker <brobecker@adacore.com>
* gdb.texinfo (Requirements): Add GMP to list of requirements. * gdb.texinfo (Requirements): Add GMP to list of requirements.

View File

@ -39502,9 +39502,10 @@ The remote target both supports and has enabled extended mode.
@item ? @item ?
@cindex @samp{?} packet @cindex @samp{?} packet
@anchor{? packet} @anchor{? packet}
Indicate the reason the target halted. The reply is the same as for This is sent when connection is first established to query the reason
step and continue. This packet has a special interpretation when the the target halted. The reply is the same as for step and continue.
target is in non-stop mode; see @ref{Remote Non-Stop}. This packet has a special interpretation when the target is in
non-stop mode; see @ref{Remote Non-Stop}.
Reply: Reply:
@xref{Stop Reply Packets}, for the reply specifications. @xref{Stop Reply Packets}, for the reply specifications.