From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 24927 invoked by alias); 19 Dec 2013 03:33:20 -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 24917 invoked by uid 89); 19 Dec 2013 03:33:20 -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; Thu, 19 Dec 2013 03:33:19 +0000 Received: from svr-orw-fem-01.mgc.mentorg.com ([147.34.98.93]) by relay1.mentorg.com with esmtp id 1VtUMO-0002oX-CJ from Hui_Zhu@mentor.com for gdb-patches@sourceware.org; Wed, 18 Dec 2013 19:33:16 -0800 Received: from SVR-ORW-FEM-02.mgc.mentorg.com ([147.34.96.206]) by svr-orw-fem-01.mgc.mentorg.com over TLS secured channel with Microsoft SMTPSVC(6.0.3790.4675); Wed, 18 Dec 2013 19:33:16 -0800 Received: from [127.0.0.1] (147.34.91.1) by svr-orw-fem-02.mgc.mentorg.com (147.34.96.168) with Microsoft SMTP Server id 14.2.247.3; Wed, 18 Dec 2013 19:33:12 -0800 Message-ID: <52B268F2.2060206@mentor.com> Date: Thu, 19 Dec 2013 03:33: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 Subject: [PATCH v2 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/msg00733.txt.bz2 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 * 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,