FreeChainXenon/binutils-gdb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document DAP 'launch' parameter

Browse source 
The Debugger Adapter Protocol defines a "launch" request but leaves
the parameters up to the implementation:

    Since launching is debugger/runtime specific, the arguments for
    this request are not part of this specification.

This patch adds some documentation for the parameter GDB currently
defines.  Note that I plan to add more parameters here, and perhaps
there will be other extensions in time as well.

Reviewed-By: Eli Zaretskii <eliz@gnu.org>
This commit is contained in:
Tom Tromey 2023-04-14 12:16:58 -06:00
parent 970c6b7e15
commit a01e847fc8
1 changed files with 19 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
gdb/doc/gdb.texinfo
View file

@ -159,6 +159,7 @@ software in general. We will miss him.
* Emacs:: Using @value{GDBN} under @sc{gnu} Emacs * Emacs:: Using @value{GDBN} under @sc{gnu} Emacs
* GDB/MI:: @value{GDBN}'s Machine Interface. * GDB/MI:: @value{GDBN}'s Machine Interface.
* Annotations:: @value{GDBN}'s annotation interface. * Annotations:: @value{GDBN}'s annotation interface.
* Debugger Adapter Protocol:: The Debugger Adapter Protocol.
* JIT Interface:: Using the JIT debugging interface. * JIT Interface:: Using the JIT debugging interface.
* In-Process Agent:: In-Process Agent * In-Process Agent:: In-Process Agent
@ -29624,6 +29625,8 @@ the Debugger Adapter Protocol. This protocol can be used by a
debugger GUI or an IDE to communicate with @value{GDBN}. This debugger GUI or an IDE to communicate with @value{GDBN}. This
protocol is documented at protocol is documented at
@url{https://microsoft.github.io/debug-adapter-protocol/}. @url{https://microsoft.github.io/debug-adapter-protocol/}.
@xref{Debugger Adapter Protocol}, for information about @value{GDBN}
extensions to the protocol.
@item mi @item mi
@cindex mi interpreter @cindex mi interpreter
@ -38981,6 +38984,22 @@ source which is being displayed. The @var{addr} is in the form @samp{0x}
followed by one or more lowercase hex digits (note that this does not followed by one or more lowercase hex digits (note that this does not
depend on the language). depend on the language).
@node Debugger Adapter Protocol
@chapter Debugger Adapter Protocol
Generally, @value{GDBN} implements the Debugger Adapter Protocol as
written. However, in some cases, extensions are either needed or even
expected.
@value{GDBN} defines a parameter that can be passed to the
@code{launch} request:
@table @code
@item program
If provided, this is a string that specifies the program to use. This
corresponds to the @code{file} command. @xref{Files}.
@end table
@node JIT Interface @node JIT Interface
@chapter JIT Compilation Interface @chapter JIT Compilation Interface
@cindex just-in-time compilation @cindex just-in-time compilation