gdb/doc: Add documentation for tfile description section lines.

gdb/doc/ChangeLog:

	* gdb.texinfo (Trace File Format): Add documentation for description
	section lines.
This commit is contained in:
Marcin Kościelnicki 2016-02-10 21:09:24 +01:00
parent 46a8327747
commit 0748bf3e58
2 changed files with 37 additions and 1 deletions

View File

@ -1,3 +1,8 @@
2016-02-18 Marcin Kościelnicki <koriakin@0x04.net>
* gdb.texinfo (Trace File Format): Add documentation for description
section lines.
2016-02-10 Marcin Kościelnicki <koriakin@0x04.net>
* gdb.texinfo (Trace File Format): Remove misleading information

View File

@ -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