GNU Binutils with patches for OS216
Revisión | 6dc1cc7b97f3655afc92ad4fa4fb109da4b0c185 (tree) |
---|---|
Tiempo | 2011-04-20 22:22:59 |
Autor | Tom Tromey <tromey@redh...> |
Commiter | Tom Tromey |
* gdb.texinfo (Trace File Format): Move node later.
@@ -1,3 +1,7 @@ | ||
1 | +2011-04-20 Tom Tromey <tromey@redhat.com> | |
2 | + | |
3 | + * gdb.texinfo (Trace File Format): Move node later. | |
4 | + | |
1 | 5 | 2010-09-01 Marc Khouzam <marc.khouzam@ericsson.com> |
2 | 6 | |
3 | 7 | * gdb.texinfo (GDB/MI Miscellaneous Commands): Document new |
@@ -34855,59 +34855,6 @@ element is interpreted as human-readable auxilliary information. | ||
34855 | 34855 | |
34856 | 34856 | @include agentexpr.texi |
34857 | 34857 | |
34858 | -@node Trace File Format | |
34859 | -@appendix Trace File Format | |
34860 | -@cindex trace file format | |
34861 | - | |
34862 | -The trace file comes in three parts: a header, a textual description | |
34863 | -section, and a trace frame section with binary data. | |
34864 | - | |
34865 | -The header has the form @code{\x7fTRACE0\n}. The first byte is | |
34866 | -@code{0x7f} so as to indicate that the file contains binary data, | |
34867 | -while the @code{0} is a version number that may have different values | |
34868 | -in the future. | |
34869 | - | |
34870 | -The description section consists of multiple lines of @sc{ascii} text | |
34871 | -separated by newline characters (@code{0xa}). The lines may include a | |
34872 | -variety of optional descriptive or context-setting information, such | |
34873 | -as tracepoint definitions or register set size. @value{GDBN} will | |
34874 | -ignore any line that it does not recognize. An empty line marks the end | |
34875 | -of this section. | |
34876 | - | |
34877 | -@c FIXME add some specific types of data | |
34878 | - | |
34879 | -The trace frame section consists of a number of consecutive frames. | |
34880 | -Each frame begins with a two-byte tracepoint number, followed by a | |
34881 | -four-byte size giving the amount of data in the frame. The data in | |
34882 | -the frame consists of a number of blocks, each introduced by a | |
34883 | -character indicating its type (at least register, memory, and trace | |
34884 | -state variable). The data in this section is raw binary, not a | |
34885 | -hexadecimal or other encoding; its endianness matches the target's | |
34886 | -endianness. | |
34887 | - | |
34888 | -@c FIXME bi-arch may require endianness/arch info in description section | |
34889 | - | |
34890 | -@table @code | |
34891 | -@item R @var{bytes} | |
34892 | -Register block. The number and ordering of bytes matches that of a | |
34893 | -@code{g} packet in the remote protocol. Note that these are the | |
34894 | -actual bytes, in target order and @value{GDBN} register order, not a | |
34895 | -hexadecimal encoding. | |
34896 | - | |
34897 | -@item M @var{address} @var{length} @var{bytes}... | |
34898 | -Memory block. This is a contiguous block of memory, at the 8-byte | |
34899 | -address @var{address}, with a 2-byte length @var{length}, followed by | |
34900 | -@var{length} bytes. | |
34901 | - | |
34902 | -@item V @var{number} @var{value} | |
34903 | -Trace state variable block. This records the 8-byte signed value | |
34904 | -@var{value} of trace state variable numbered @var{number}. | |
34905 | - | |
34906 | -@end table | |
34907 | - | |
34908 | -Future enhancements of the trace file format may include additional types | |
34909 | -of blocks. | |
34910 | - | |
34911 | 34858 | @node Target Descriptions |
34912 | 34859 | @appendix Target Descriptions |
34913 | 34860 | @cindex target descriptions |
@@ -35580,6 +35527,59 @@ should contain a comma-separated list of cores that this process | ||
35580 | 35527 | is running on. Target may provide additional columns, |
35581 | 35528 | which @value{GDBN} currently ignores. |
35582 | 35529 | |
35530 | +@node Trace File Format | |
35531 | +@appendix Trace File Format | |
35532 | +@cindex trace file format | |
35533 | + | |
35534 | +The trace file comes in three parts: a header, a textual description | |
35535 | +section, and a trace frame section with binary data. | |
35536 | + | |
35537 | +The header has the form @code{\x7fTRACE0\n}. The first byte is | |
35538 | +@code{0x7f} so as to indicate that the file contains binary data, | |
35539 | +while the @code{0} is a version number that may have different values | |
35540 | +in the future. | |
35541 | + | |
35542 | +The description section consists of multiple lines of @sc{ascii} text | |
35543 | +separated by newline characters (@code{0xa}). The lines may include a | |
35544 | +variety of optional descriptive or context-setting information, such | |
35545 | +as tracepoint definitions or register set size. @value{GDBN} will | |
35546 | +ignore any line that it does not recognize. An empty line marks the end | |
35547 | +of this section. | |
35548 | + | |
35549 | +@c FIXME add some specific types of data | |
35550 | + | |
35551 | +The trace frame section consists of a number of consecutive frames. | |
35552 | +Each frame begins with a two-byte tracepoint number, followed by a | |
35553 | +four-byte size giving the amount of data in the frame. The data in | |
35554 | +the frame consists of a number of blocks, each introduced by a | |
35555 | +character indicating its type (at least register, memory, and trace | |
35556 | +state variable). The data in this section is raw binary, not a | |
35557 | +hexadecimal or other encoding; its endianness matches the target's | |
35558 | +endianness. | |
35559 | + | |
35560 | +@c FIXME bi-arch may require endianness/arch info in description section | |
35561 | + | |
35562 | +@table @code | |
35563 | +@item R @var{bytes} | |
35564 | +Register block. The number and ordering of bytes matches that of a | |
35565 | +@code{g} packet in the remote protocol. Note that these are the | |
35566 | +actual bytes, in target order and @value{GDBN} register order, not a | |
35567 | +hexadecimal encoding. | |
35568 | + | |
35569 | +@item M @var{address} @var{length} @var{bytes}... | |
35570 | +Memory block. This is a contiguous block of memory, at the 8-byte | |
35571 | +address @var{address}, with a 2-byte length @var{length}, followed by | |
35572 | +@var{length} bytes. | |
35573 | + | |
35574 | +@item V @var{number} @var{value} | |
35575 | +Trace state variable block. This records the 8-byte signed value | |
35576 | +@var{value} of trace state variable numbered @var{number}. | |
35577 | + | |
35578 | +@end table | |
35579 | + | |
35580 | +Future enhancements of the trace file format may include additional types | |
35581 | +of blocks. | |
35582 | + | |
35583 | 35583 | @include gpl.texi |
35584 | 35584 | |
35585 | 35585 | @node GNU Free Documentation License |