[PATCH v2 4/4] tracepoint multithread and multiprocess support (doc)

Hui Zhu hui_zhu@mentor.com
Thu Dec 19 03:33:00 GMT 2013


This version doesn't have big change, just update follow GDB trunk
and update Changelog.

This patch is for the doc.
Please help me review it.

Thanks,
Hui

2013-12-19  Hui Zhu  <teawater@gmail.com>

	* gdb.texinfo (General Query Packets): Mention
	MultiProcessTracepoint feature.
	(QTDP): Add 'P'.

--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -39616,6 +39616,11 @@ These are the currently defined stub fea
  @tab @samp{-}
  @tab No
  
+@item @samp{MultiProcessTracepoint}
+@tab No
+@tab @samp{-}
+@tab No
+
  @end multitable
  
  These are the currently defined stub features, in more detail:
@@ -39789,6 +39794,12 @@ The remote stub understands the @samp{Qb
  @item Qbtrace:bts
  The remote stub understands the @samp{Qbtrace:bts} packet.
  
+@item MultiProcessTracepoint
+@cindex string tracing, in remote protocol
+The remote stub supports creation of tracepoints with multiprocess
+and multithread infomation.
+@xref{Tracepoint Packets}.
+
  @end table
  
  @item qSymbol::
@@ -40316,7 +40327,7 @@ tracepoints (@pxref{Tracepoints}).
  
  @table @samp
  
-@item QTDP:@var{n}:@var{addr}:@var{ena}:@var{step}:@var{pass}[:F@var{flen}][:X@var{len},@var{bytes}]@r{[}-@r{]}
+@item QTDP:@var{n}:@var{addr}:@var{ena}:@var{step}:@var{pass}[:F@var{flen}][:P@var{thread-id}][:X@var{len},@var{bytes}]@r{[}-@r{]}
  @cindex @samp{QTDP} packet
  Create a new tracepoint, number @var{n}, at @var{addr}.  If @var{ena}
  is @samp{E}, then the tracepoint is enabled; if it is @samp{D}, then
@@ -40324,7 +40335,10 @@ the tracepoint is disabled.  @var{step}
  count, and @var{pass} is its pass count.  If an @samp{F} is present,
  then the tracepoint is to be a fast tracepoint, and the @var{flen} is
  the number of bytes that the target should copy elsewhere to make room
-for the tracepoint.  If an @samp{X} is present, it introduces a
+for the tracepoint.  If a @samp{P} is present, the thread designator
+@var{thread-id} that has the format and interpretation described in
+@ref{thread-id syntax} includes the multiprocess and multithread infomation
+of this tracepoint.  If an @samp{X} is present, it introduces a
  tracepoint condition, which consists of a hexadecimal length, followed
  by a comma and hex-encoded bytes, in a manner similar to action
  encodings as described below.  If the trailing @samp{-} is present,



More information about the Gdb-patches mailing list