From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 20494 invoked by alias); 31 Dec 2013 03:31:44 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 20483 invoked by uid 89); 31 Dec 2013 03:31:43 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL,BAYES_00 autolearn=ham version=3.3.2 X-HELO: relay1.mentorg.com Received: from relay1.mentorg.com (HELO relay1.mentorg.com) (192.94.38.131) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 31 Dec 2013 03:31:42 +0000 Received: from svr-orw-exc-10.mgc.mentorg.com ([147.34.98.58]) by relay1.mentorg.com with esmtp id 1Vxq3P-00040q-5T from Hui_Zhu@mentor.com ; Mon, 30 Dec 2013 19:31:39 -0800 Received: from SVR-ORW-FEM-05.mgc.mentorg.com ([147.34.97.43]) by SVR-ORW-EXC-10.mgc.mentorg.com with Microsoft SMTPSVC(6.0.3790.4675); Mon, 30 Dec 2013 19:31:39 -0800 Received: from [127.0.0.1] (147.34.91.1) by svr-orw-fem-05.mgc.mentorg.com (147.34.97.43) with Microsoft SMTP Server id 14.2.247.3; Mon, 30 Dec 2013 19:31:09 -0800 Message-ID: <52C23A96.8090009@mentor.com> Date: Tue, 31 Dec 2013 03:31:00 -0000 From: Hui Zhu User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 MIME-Version: 1.0 To: gdb-patches ml CC: Pedro Alves , , Eli Zaretskii Subject: [PATCH v3 4/4] tracepoint multithread and multiprocess support (doc) Content-Type: text/plain; charset="ISO-8859-1"; format=flowed Content-Transfer-Encoding: 7bit X-IsSubscribed: yes X-SW-Source: 2013-12/txt/msg00998.txt.bz2 This patch is for the doc. It add introduce of MultiThreadTracepoint and MultiProcessTracepointTogether. And add introduce of [:P@var{thread-id}] inside QTDP. Please help me review it. Thanks, Hui 2013-12-31 Hui Zhu * gdb.texinfo (General Query Packets): Men[PATCH v3 4/4] tracepoint multithread and multiprocess support (doc)tion MultiThreadTracepoint and MultiProcessTracepointTogether feature. (QTDP): Add 'P'. --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -39655,6 +39655,16 @@ These are the currently defined stub fea @tab @samp{-} @tab No +@item @samp{MultiThreadTracepoint} +@tab No +@tab @samp{-} +@tab No + +@item @samp{MultiProcessTracepointTogether} +@tab No +@tab @samp{-} +@tab No + @end multitable These are the currently defined stub features, in more detail: @@ -39828,6 +39838,19 @@ The remote stub understands the @samp{Qb @item Qbtrace:bts The remote stub understands the @samp{Qbtrace:bts} packet. +@item MultiThreadTracepoint +@cindex string tracing, in remote protocol +The remote stub supports creation of tracepoints with multithread +infomation. +@xref{Tracepoint Packets}. + +@item MultiProcessTracepointTogether +@cindex string tracing, in remote protocol +The remote stub supports creation of tracepoints with multiprocess +infomation and the tracepoints of each inferior will be controlled +together. +@xref{Tracepoint Packets}. + @end table @item qSymbol:: @@ -40355,7 +40378,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 @@ -40363,8 +40386,11 @@ 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 -tracepoint condition, which consists of a hexadecimal length, followed +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, further @samp{QTDP} packets will follow to specify this tracepoint's