Fix documentation of the QTDV packet
authorDavid Taylor <dtaylor@emc.com>
Thu, 12 Feb 2015 20:38:28 +0000 (22:38 +0200)
committerEli Zaretskii <eliz@gnu.org>
Thu, 12 Feb 2015 20:38:28 +0000 (22:38 +0200)
gdb/doc/ChangeLog
2015-02-12  David Taylor  <dtaylor@emc.com>

* gdb.texinfo (Tracepoint Packets): Document the builtin and name
fields of the QTDV packet.

gdb/doc/ChangeLog
gdb/doc/gdb.texinfo

index b8e1f7f392ef3b17261cc6e8f7258830880c7570..62726ffafcea737f4f7ff75fbe60dee70f053b59 100644 (file)
@@ -1,3 +1,8 @@
+2015-02-12  David Taylor  <dtaylor@emc.com>
+
+       * gdb.texinfo (Tracepoint Packets): Document the builtin and name
+       fields of the QTDV packet.
+
 2015-02-09  Markus Metzger  <markus.t.metzger@intel.com>
 
        * gdb.texinfo (Branch Trace Configuration Format): Add size.
index d1f22de979e4c7b1bfabfd1a692e03b041ab73c2..c4f03b25cdb4bb372447f380fd61d9288d40376b 100644 (file)
@@ -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