From: Alex Bennée Date: Wed, 23 Dec 2020 21:36:16 +0000 (-0500) Subject: Clarify language for the '?' packet X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=f37059ea22267e5b426df1732a2ae7ab45b1d848;p=binutils-gdb.git 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 gdb/doc/ChangeLog: * gdb.texinfo (Packets): Clarify language for ? packet. Change-Id: Iae25d3110fe28b8d2467704962a6889e55224ca5 --- diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index d56cec23ff9..1d88c926346 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,7 @@ +2020-12-23 Alex Bennée + + * gdb.texinfo (Packets): Clarify language for ? packet. + 2020-12-21 Joel Brobecker * gdb.texinfo (Requirements): Add GMP to list of requirements. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 617a3641382..93e722881a3 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -39502,9 +39502,10 @@ The remote target both supports and has enabled extended mode. @item ? @cindex @samp{?} packet @anchor{? packet} -Indicate the reason the target halted. The reply is the same as for -step and continue. This packet has a special interpretation when the -target is in non-stop mode; see @ref{Remote Non-Stop}. +This is sent when connection is first established to query the reason +the target halted. The reply is the same as for step and continue. +This packet has a special interpretation when the target is in +non-stop mode; see @ref{Remote Non-Stop}. Reply: @xref{Stop Reply Packets}, for the reply specifications.