From patchwork Wed Feb 10 20:19:48 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Marcin_Ko=C5=9Bcielnicki?= X-Patchwork-Id: 10806 Received: (qmail 63483 invoked by alias); 10 Feb 2016 20:19:53 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Delivered-To: mailing list gdb-patches@sourceware.org Received: (qmail 62568 invoked by uid 89); 10 Feb 2016 20:19:53 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.5 required=5.0 tests=AWL, BAYES_00, RP_MATCHES_RCVD, SPF_PASS autolearn=ham version=3.3.2 spammy=promised, begins, marks, specifies X-HELO: xyzzy.0x04.net Received: from xyzzy.0x04.net (HELO xyzzy.0x04.net) (109.74.193.254) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 10 Feb 2016 20:19:52 +0000 Received: from hogfather.0x04.net (89-65-66-135.dynamic.chello.pl [89.65.66.135]) by xyzzy.0x04.net (Postfix) with ESMTPS id E4D993FEBC; Wed, 10 Feb 2016 21:20:39 +0100 (CET) Received: by hogfather.0x04.net (Postfix, from userid 1000) id F29B8580092; Wed, 10 Feb 2016 21:19:49 +0100 (CET) From: =?UTF-8?q?Marcin=20Ko=C5=9Bcielnicki?= To: palves@redhat.com Cc: gdb-patches@sourceware.org, =?UTF-8?q?Marcin=20Ko=C5=9Bcielnicki?= Subject: [PATCH 3/3] gdb/doc: Add documentation for tfile description section lines. Date: Wed, 10 Feb 2016 21:19:48 +0100 Message-Id: <1455135588-21970-1-git-send-email-koriakin@0x04.net> In-Reply-To: <56BB482A.1060307@redhat.com> References: <56BB482A.1060307@redhat.com> MIME-Version: 1.0 X-IsSubscribed: yes gdb/doc/ChangeLog: * gdb.texinfo (Trace File Format): Add documentation for description section lines. --- Here's the promised documentation for tdesc lines and then some. gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 33 ++++++++++++++++++++++++++++++++- 2 files changed, 37 insertions(+), 1 deletion(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 75b24ef..12ace48 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,5 +1,10 @@ 2016-02-10 Marcin Kościelnicki + * gdb.texinfo (Trace File Format): Add documentation for description + section lines. + +2016-02-10 Marcin Kościelnicki + * gdb.texinfo (Trace File Format): Remove misleading information about register block ordering. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 9db234e..0028eda 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -41031,7 +41031,38 @@ as tracepoint definitions or register set size. @value{GDBN} will ignore any line that it does not recognize. An empty line marks the end of this section. -@c FIXME add some specific types of data +@table @code +@item R @var{size} +Specifies the size of a register block in bytes. This is equal to the +size of a @code{g} packet payload in the remote protocol. @var{size} +is an ascii decimal number. There should be only one such line in +a single trace file. + +@item status @var{status} +Trace status. @var{status} has the same format as a @code{qTStatus} +remote packet reply. There should be only one such line in a single trace +file. + +@item tp @var{payload} +Tracepoint definition. The @var{payload} has the same format as +@code{qTfP}/@code{qTsP} remote packet reply payload. A single tracepoint +may take multiple lines of definition, corresponding to the multiple +reply packets. + +@item tsv @var{payload} +Trace state variable definition. The @var{payload} has the same format as +@code{qTfV}/@code{qTsV} remote packet reply payload. A single variable +may take multiple lines of definition, corresponding to the multiple +reply packets. + +@item tdesc @var{payload} +Target description in XML format. The @var{payload} is a single line of +the XML file. All such lines should be concatenated together to get +the original XML file. This file is in the same format as @code{qXfer} +@code{features} payload, and corresponds to the main @code{target.xml} +file. Includes are not allowed. + +@end table The trace frame section consists of a number of consecutive frames. Each frame begins with a two-byte tracepoint number, followed by a