From fa3f8d5ac61f98d5efde8dc92ba4c9f3dc12938b Mon Sep 17 00:00:00 2001 From: David Taylor Date: Thu, 12 Feb 2015 22:38:28 +0200 Subject: [PATCH] Fix documentation of the QTDV packet gdb/doc/ChangeLog 2015-02-12 David Taylor * gdb.texinfo (Tracepoint Packets): Document the builtin and name fields of the QTDV packet. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 9 +++++++-- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index b8e1f7f392e..62726ffafce 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2015-02-12 David Taylor + + * gdb.texinfo (Tracepoint Packets): Document the builtin and name + fields of the QTDV packet. + 2015-02-09 Markus Metzger * gdb.texinfo (Branch Trace Configuration Format): Add size. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index d1f22de979e..c4f03b25cdb 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -36812,7 +36812,7 @@ the ones in effect during the trace run; even a small discrepancy could cause @samp{tdump} not to work, or a particular trace frame not be found. -@item QTDV:@var{n}:@var{value} +@item QTDV:@var{n}:@var{value}:@var{builtin}:@var{name} @cindex define trace state variable, remote request @cindex @samp{QTDV} packet Create a new trace state variable, number @var{n}, with an initial @@ -36820,7 +36820,12 @@ value of @var{value}, which is a 64-bit signed integer. Both @var{n} and @var{value} are encoded as hexadecimal values. @value{GDBN} has the option of not using this packet for initial values of zero; the target should simply create the trace state variables as they are -mentioned in expressions. +mentioned in expressions. The value @var{builtin} should be 1 (one) +if the trace state variable is builtin and 0 (zero) if it is not builtin. +@value{GDBN} only sets @var{builtin} to 1 if a previous @samp{qTfV} or +@samp{qTsV} packet had it set. The contents of @var{name} is the +hex-encoded name (without the leading @samp{$}) of the trace state +variable. @item QTFrame:@var{n} @cindex @samp{QTFrame} packet -- 2.30.2