diff options
author | Pedro Alves <pedro@palves.net> | 2024-04-18 20:22:36 +0100 |
---|---|---|
committer | Pedro Alves <pedro@palves.net> | 2024-04-26 21:21:59 +0100 |
commit | 2e703c09ecb2d025dd86511a1333ca6ac10deab4 (patch) | |
tree | 43c5141dc48ff3db18983517ab9c4e57f2bc1c83 /gdb/.gitattributes | |
parent | aef11345e4be223ed1094b67179746dc3c8b9821 (diff) | |
download | gdb-2e703c09ecb2d025dd86511a1333ca6ac10deab4.zip gdb-2e703c09ecb2d025dd86511a1333ca6ac10deab4.tar.gz gdb-2e703c09ecb2d025dd86511a1333ca6ac10deab4.tar.bz2 |
Centralize documentation of error and empty RSP responses
Currently, for each packet, we document the "E NN" response (error),
and the empty response (unsupported). This patch centralizes that in
a new "Standard Replies" section.
In the "Packets", "General Query Packets", "Tracepoint Packets"
sections, Remove explicit mention of empty and error replies, except
when they provide detail not covered in Standard Replies.
Note this hunk:
-@item E @var{NN}
-@var{NN} is errno
and this one:
-@item E00
-The request was malformed, or @var{annex} was invalid.
-
-@item E @var{nn}
-The offset was invalid, or there was an error encountered reading the data.
-The @var{nn} part is a hex-encoded @code{errno} value.
were really documenting things that don't really work that way.
The first is the documentation of the "m" packet. GDB does _not_
interpret the NN as an errno. It can't, in fact, because the
remote/target errno numbers have nothing to do with GDB/host errno
numbers in a cross debugging scenario.
The second hunk above is from the documentation of qXfer. Again, GDB
does not give any interpretation to the NN error code at all. Nor
does GDBserver. And again, an errno number can't be interpreted in a
cross debugging scenario.
Change-Id: I973695c80809cdb5a5e8d5be8b78ba4d1ecdb513
Co-Authored-By: Jim Blandy <jimb@codesourcery.com>
Co-Authored-By: Mike Wrighton <mike_wrighton@mentor.com>
Co-Authored-By: Nathan Sidwell <nathan@codesourcery.com>
Co-Authored-By: Hafiz Abid Qadeer <abidh@codesourcery.com>
Approved-By: Eli Zaretskii <eliz@gnu.org>
Diffstat (limited to 'gdb/.gitattributes')
0 files changed, 0 insertions, 0 deletions