mirror of
https://github.com/espressif/binutils-gdb.git
synced 2025-07-30 05:14:18 +08:00
gdb/doc:
* gdb.texinfo: Add missing cindex for some packets.
This commit is contained in:
gdb/doc
@ -1,3 +1,7 @@
|
|||||||
|
2012-06-22 Yao Qi <yao@codesourcery.com>
|
||||||
|
|
||||||
|
* gdb.texinfo: Add missing cindex for some packets.
|
||||||
|
|
||||||
2012-06-20 Keith Seitz <keiths@redhat.com>
|
2012-06-20 Keith Seitz <keiths@redhat.com>
|
||||||
|
|
||||||
* gdb.texinfo (GDB/MI Breakpoint Commands): Re-order options
|
* gdb.texinfo (GDB/MI Breakpoint Commands): Re-order options
|
||||||
|
@ -37214,6 +37214,7 @@ tracepoints (@pxref{Tracepoints}).
|
|||||||
@table @samp
|
@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}][:X@var{len},@var{bytes}]@r{[}-@r{]}
|
||||||
|
@cindex @samp{QTDP} packet
|
||||||
Create a new tracepoint, number @var{n}, at @var{addr}. If @var{ena}
|
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
|
is @samp{E}, then the tracepoint is enabled; if it is @samp{D}, then
|
||||||
the tracepoint is disabled. @var{step} is the tracepoint's step
|
the tracepoint is disabled. @var{step} is the tracepoint's step
|
||||||
@ -37348,6 +37349,7 @@ target should simply create the trace state variables as they are
|
|||||||
mentioned in expressions.
|
mentioned in expressions.
|
||||||
|
|
||||||
@item QTFrame:@var{n}
|
@item QTFrame:@var{n}
|
||||||
|
@cindex @samp{QTFrame} packet
|
||||||
Select the @var{n}'th tracepoint frame from the buffer, and use the
|
Select the @var{n}'th tracepoint frame from the buffer, and use the
|
||||||
register and memory contents recorded there to answer subsequent
|
register and memory contents recorded there to answer subsequent
|
||||||
request packets from @value{GDBN}.
|
request packets from @value{GDBN}.
|
||||||
@ -37390,6 +37392,7 @@ Like @samp{QTFrame:range:@var{start}:@var{end}}, but select the first
|
|||||||
frame @emph{outside} the given range of addresses (exclusive).
|
frame @emph{outside} the given range of addresses (exclusive).
|
||||||
|
|
||||||
@item qTMinFTPILen
|
@item qTMinFTPILen
|
||||||
|
@cindex @samp{qTMinFTPILen} packet
|
||||||
This packet requests the minimum length of instruction at which a fast
|
This packet requests the minimum length of instruction at which a fast
|
||||||
tracepoint (@pxref{Set Tracepoints}) may be placed. For instance, on
|
tracepoint (@pxref{Set Tracepoints}) may be placed. For instance, on
|
||||||
the 32-bit x86 architecture, it is possible to use a 4-byte jump, but
|
the 32-bit x86 architecture, it is possible to use a 4-byte jump, but
|
||||||
@ -37414,30 +37417,36 @@ An empty reply indicates that the request is not supported by the stub.
|
|||||||
@end table
|
@end table
|
||||||
|
|
||||||
@item QTStart
|
@item QTStart
|
||||||
|
@cindex @samp{QTStart} packet
|
||||||
Begin the tracepoint experiment. Begin collecting data from
|
Begin the tracepoint experiment. Begin collecting data from
|
||||||
tracepoint hits in the trace frame buffer. This packet supports the
|
tracepoint hits in the trace frame buffer. This packet supports the
|
||||||
@samp{qRelocInsn} reply (@pxref{Tracepoint Packets,,Relocate
|
@samp{qRelocInsn} reply (@pxref{Tracepoint Packets,,Relocate
|
||||||
instruction reply packet}).
|
instruction reply packet}).
|
||||||
|
|
||||||
@item QTStop
|
@item QTStop
|
||||||
|
@cindex @samp{QTStop} packet
|
||||||
End the tracepoint experiment. Stop collecting trace frames.
|
End the tracepoint experiment. Stop collecting trace frames.
|
||||||
|
|
||||||
@item QTEnable:@var{n}:@var{addr}
|
@item QTEnable:@var{n}:@var{addr}
|
||||||
@anchor{QTEnable}
|
@anchor{QTEnable}
|
||||||
|
@cindex @samp{QTEnable} packet
|
||||||
Enable tracepoint @var{n} at address @var{addr} in a started tracepoint
|
Enable tracepoint @var{n} at address @var{addr} in a started tracepoint
|
||||||
experiment. If the tracepoint was previously disabled, then collection
|
experiment. If the tracepoint was previously disabled, then collection
|
||||||
of data from it will resume.
|
of data from it will resume.
|
||||||
|
|
||||||
@item QTDisable:@var{n}:@var{addr}
|
@item QTDisable:@var{n}:@var{addr}
|
||||||
@anchor{QTDisable}
|
@anchor{QTDisable}
|
||||||
|
@cindex @samp{QTDisable} packet
|
||||||
Disable tracepoint @var{n} at address @var{addr} in a started tracepoint
|
Disable tracepoint @var{n} at address @var{addr} in a started tracepoint
|
||||||
experiment. No more data will be collected from the tracepoint unless
|
experiment. No more data will be collected from the tracepoint unless
|
||||||
@samp{QTEnable:@var{n}:@var{addr}} is subsequently issued.
|
@samp{QTEnable:@var{n}:@var{addr}} is subsequently issued.
|
||||||
|
|
||||||
@item QTinit
|
@item QTinit
|
||||||
|
@cindex @samp{QTinit} packet
|
||||||
Clear the table of tracepoints, and empty the trace frame buffer.
|
Clear the table of tracepoints, and empty the trace frame buffer.
|
||||||
|
|
||||||
@item QTro:@var{start1},@var{end1}:@var{start2},@var{end2}:@dots{}
|
@item QTro:@var{start1},@var{end1}:@var{start2},@var{end2}:@dots{}
|
||||||
|
@cindex @samp{QTro} packet
|
||||||
Establish the given ranges of memory as ``transparent''. The stub
|
Establish the given ranges of memory as ``transparent''. The stub
|
||||||
will answer requests for these ranges from memory's current contents,
|
will answer requests for these ranges from memory's current contents,
|
||||||
if they were not collected as part of the tracepoint hit.
|
if they were not collected as part of the tracepoint hit.
|
||||||
@ -37448,12 +37457,14 @@ still have the same contents they did when the tracepoint was hit, so
|
|||||||
there's no reason for the stub to refuse to provide their contents.
|
there's no reason for the stub to refuse to provide their contents.
|
||||||
|
|
||||||
@item QTDisconnected:@var{value}
|
@item QTDisconnected:@var{value}
|
||||||
|
@cindex @samp{QTDisconnected} packet
|
||||||
Set the choice to what to do with the tracing run when @value{GDBN}
|
Set the choice to what to do with the tracing run when @value{GDBN}
|
||||||
disconnects from the target. A @var{value} of 1 directs the target to
|
disconnects from the target. A @var{value} of 1 directs the target to
|
||||||
continue the tracing run, while 0 tells the target to stop tracing if
|
continue the tracing run, while 0 tells the target to stop tracing if
|
||||||
@value{GDBN} is no longer in the picture.
|
@value{GDBN} is no longer in the picture.
|
||||||
|
|
||||||
@item qTStatus
|
@item qTStatus
|
||||||
|
@cindex @samp{qTStatus} packet
|
||||||
Ask the stub if there is a trace experiment running right now.
|
Ask the stub if there is a trace experiment running right now.
|
||||||
|
|
||||||
The reply has the form:
|
The reply has the form:
|
||||||
@ -37573,7 +37584,9 @@ was not collected.
|
|||||||
@end table
|
@end table
|
||||||
|
|
||||||
@item qTfP
|
@item qTfP
|
||||||
|
@cindex @samp{qTfP} packet
|
||||||
@itemx qTsP
|
@itemx qTsP
|
||||||
|
@cindex @samp{qTsP} packet
|
||||||
These packets request data about tracepoints that are being used by
|
These packets request data about tracepoints that are being used by
|
||||||
the target. @value{GDBN} sends @code{qTfP} to get the first piece
|
the target. @value{GDBN} sends @code{qTfP} to get the first piece
|
||||||
of data, and multiple @code{qTsP} to get additional pieces. Replies
|
of data, and multiple @code{qTsP} to get additional pieces. Replies
|
||||||
@ -37581,7 +37594,9 @@ to these packets generally take the form of the @code{QTDP} packets
|
|||||||
that define tracepoints. (FIXME add detailed syntax)
|
that define tracepoints. (FIXME add detailed syntax)
|
||||||
|
|
||||||
@item qTfV
|
@item qTfV
|
||||||
|
@cindex @samp{qTfV} packet
|
||||||
@itemx qTsV
|
@itemx qTsV
|
||||||
|
@cindex @samp{qTsV} packet
|
||||||
These packets request data about trace state variables that are on the
|
These packets request data about trace state variables that are on the
|
||||||
target. @value{GDBN} sends @code{qTfV} to get the first vari of data,
|
target. @value{GDBN} sends @code{qTfV} to get the first vari of data,
|
||||||
and multiple @code{qTsV} to get additional variables. Replies to
|
and multiple @code{qTsV} to get additional variables. Replies to
|
||||||
@ -37592,6 +37607,8 @@ trace state variables.
|
|||||||
@itemx qTsSTM
|
@itemx qTsSTM
|
||||||
@anchor{qTfSTM}
|
@anchor{qTfSTM}
|
||||||
@anchor{qTsSTM}
|
@anchor{qTsSTM}
|
||||||
|
@cindex @samp{qTfSTM} packet
|
||||||
|
@cindex @samp{qTsSTM} packet
|
||||||
These packets request data about static tracepoint markers that exist
|
These packets request data about static tracepoint markers that exist
|
||||||
in the target program. @value{GDBN} sends @code{qTfSTM} to get the
|
in the target program. @value{GDBN} sends @code{qTfSTM} to get the
|
||||||
first piece of data, and multiple @code{qTsSTM} to get additional
|
first piece of data, and multiple @code{qTsSTM} to get additional
|
||||||
@ -37623,18 +37640,21 @@ query), until the target responds with @samp{l} (lower-case ell, for
|
|||||||
|
|
||||||
@item qTSTMat:@var{address}
|
@item qTSTMat:@var{address}
|
||||||
@anchor{qTSTMat}
|
@anchor{qTSTMat}
|
||||||
|
@cindex @samp{qTSTMat} packet
|
||||||
This packets requests data about static tracepoint markers in the
|
This packets requests data about static tracepoint markers in the
|
||||||
target program at @var{address}. Replies to this packet follow the
|
target program at @var{address}. Replies to this packet follow the
|
||||||
syntax of the @samp{qTfSTM} and @code{qTsSTM} packets that list static
|
syntax of the @samp{qTfSTM} and @code{qTsSTM} packets that list static
|
||||||
tracepoint markers.
|
tracepoint markers.
|
||||||
|
|
||||||
@item QTSave:@var{filename}
|
@item QTSave:@var{filename}
|
||||||
|
@cindex @samp{QTSave} packet
|
||||||
This packet directs the target to save trace data to the file name
|
This packet directs the target to save trace data to the file name
|
||||||
@var{filename} in the target's filesystem. @var{filename} is encoded
|
@var{filename} in the target's filesystem. @var{filename} is encoded
|
||||||
as a hex string; the interpretation of the file name (relative vs
|
as a hex string; the interpretation of the file name (relative vs
|
||||||
absolute, wild cards, etc) is up to the target.
|
absolute, wild cards, etc) is up to the target.
|
||||||
|
|
||||||
@item qTBuffer:@var{offset},@var{len}
|
@item qTBuffer:@var{offset},@var{len}
|
||||||
|
@cindex @samp{qTBuffer} packet
|
||||||
Return up to @var{len} bytes of the current contents of trace buffer,
|
Return up to @var{len} bytes of the current contents of trace buffer,
|
||||||
starting at @var{offset}. The trace buffer is treated as if it were
|
starting at @var{offset}. The trace buffer is treated as if it were
|
||||||
a contiguous collection of traceframes, as per the trace file format.
|
a contiguous collection of traceframes, as per the trace file format.
|
||||||
@ -37648,6 +37668,7 @@ This packet directs the target to use a circular trace buffer if
|
|||||||
@var{value} is 1, or a linear buffer if the value is 0.
|
@var{value} is 1, or a linear buffer if the value is 0.
|
||||||
|
|
||||||
@item QTNotes:@r{[}@var{type}:@var{text}@r{]}@r{[};@var{type}:@var{text}@r{]}@dots{}
|
@item QTNotes:@r{[}@var{type}:@var{text}@r{]}@r{[};@var{type}:@var{text}@r{]}@dots{}
|
||||||
|
@cindex @samp{QTNotes} packet
|
||||||
This packet adds optional textual notes to the trace run. Allowable
|
This packet adds optional textual notes to the trace run. Allowable
|
||||||
types include @code{user}, @code{notes}, and @code{tstop}, the
|
types include @code{user}, @code{notes}, and @code{tstop}, the
|
||||||
@var{text} fields are arbitrary strings, hex-encoded.
|
@var{text} fields are arbitrary strings, hex-encoded.
|
||||||
|
Reference in New Issue
Block a user