This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
[PATCH 4/4] Fix PR breakpoints/16494: add dprintf-style "agent-call"(doc)
- From: Hui Zhu <hui_zhu at mentor dot com>
- To: gdb-patches ml <gdb-patches at sourceware dot org>
- Date: Wed, 5 Mar 2014 00:30:18 +0800
- Subject: [PATCH 4/4] Fix PR breakpoints/16494: add dprintf-style "agent-call"(doc)
- Authentication-results: sourceware.org; auth=none
This patch is for doc.
Thanks,
Hui
2014-03-04 Hui Zhu <hui@codesourcery.com>
PR breakpoint/16494
* gdb.texinfo (Dynamic Printf): Add "agent-call".
(qSupported): Add "DprintfAgentCall".
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -4803,9 +4803,17 @@ Have the remote debugging agent (such as
the output itself. This style is only available for agents that
support running commands on the target.
+@item agent-call
+@kindex dprintf-style agent-call
+Have the remote debugging agent (such as @code{gdbserver}) handle
+the output itself by calling a function in your program (normally
+@code{printf}). This style is only available for agents that
+support running commands and dprintf agent call on the target.
+
@item set dprintf-function @var{function}
-Set the function to call if the dprintf style is @code{call}. By
-default its value is @code{printf}. You may set it to any expression.
+Set the function to call if the dprintf style is @code{call} or
+@code{agent-call}. By default its value is @code{printf}. You may
+set it to any expression.
that @value{GDBN} can evaluate to a function, as per the @code{call}
command.
@@ -4842,7 +4850,7 @@ the variable settings.
@kindex set disconnected-dprintf
Choose whether @code{dprintf} commands should continue to run if
@value{GDBN} has disconnected from the target. This only applies
-if the @code{dprintf-style} is @code{agent}.
+if the @code{dprintf-style} is @code{agent} or @code{agent-call}.
@item show disconnected-dprintf off
@kindex show disconnected-dprintf
@@ -35344,6 +35352,11 @@ These are the currently defined stub fea
@tab @samp{-}
@tab No
+@item @samp{DprintfAgentCall}
+@tab No
+@tab @samp{-}
+@tab No
+
@end multitable
These are the currently defined stub features, in more detail:
@@ -35511,6 +35524,10 @@ See @ref{Bytecode Descriptions} for deta
The remote stub supports running a breakpoint's command list itself,
rather than reporting the hit to @value{GDBN}.
+@item DprintfAgentCall
+@cindex dprintf agent call, in remote protocol
+The remote stub supports dprintf agent call.
+
@item Qbtrace:off
The remote stub understands the @samp{Qbtrace:off} packet.