diff options
author | Marcin Kościelnicki <koriakin@0x04.net> | 2016-02-10 21:09:24 +0100 |
---|---|---|
committer | Marcin Kościelnicki <koriakin@0x04.net> | 2016-02-11 15:17:39 +0100 |
commit | c813a0b9d46bbc18bbb4105334656fdd9cb66d37 (patch) | |
tree | d7dfd27c555bcd82dc474cd6bf68c57579829b81 | |
parent | 9f5fed7852cae412443957862d759660cfcb3fd5 (diff) | |
download | binutils-gdb-users/mwk/tfile-xml.tar.gz |
gdb/doc: Add documentation for tfile description section lines.users/mwk/tfile-xml
gdb/doc/ChangeLog:
* gdb.texinfo (Trace File Format): Add documentation for description
section lines.
-rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
-rw-r--r-- | gdb/doc/gdb.texinfo | 33 |
2 files changed, 37 insertions, 1 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 75b24efcf0f..12ace48cdcf 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,5 +1,10 @@ 2016-02-10 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 about register block ordering. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 9db234e774a..0028eda8ef3 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 |