Specify
the actions to be taken at a tracepoint.
Tracepoint actions may include
collecting of specified data,
single-stepping, or
enabling/disabling other tracepoints,
depending on target's capabilities.
(gdb) h collect
Specify
one or more data items to be collected at a tracepoint.
Accepts a comma-separated list of
(one or more) expressions. GDB will
collect all data (variables,
registers) referenced by that expression.
Also accepts the following special
arguments:
$regs
-- all registers.
$args
-- all function arguments.<
$locals -- all
variables local to the block/function scope.
Note: this command can only be used
in a tracepoint "actions" list.
(gdb) h delete tracepoints
Delete
specified tracepoints.
Arguments are tracepoint numbers,
separated by spaces.
No argument means delete all
tracepoints.
(gdb) h disable tracepoints
Disable
specified tracepoints.
Arguments are tracepoint numbers,
separated by spaces.
No argument means disable all
tracepoints.
(gdb) h enable tracepoints
Enable
specified tracepoints.
Arguments are tracepoint numbers,
separated by spaces.
No argument means enable all
tracepoints.
(gdb) h end
Ends
a list of commands or actions.
Several GDB commands allow you to
enter a list of commands or actions.
Entering "end" on a line by itself is
the normal way to terminate
such a list.
Note: the "end" command cannot be
used at the gdb prompt.
(gdb) h passcount
Set
the passcount for a tracepoint.
The trace will end when the
tracepoint has been passed 'count' times.
Usage: passcount COUNT TPNUM, where
TPNUM may also be "all";
if TPNUM is omitted, passcount refers
to the last tracepoint defined.
(gdb) h save-tracepoints
Save
current tracepoint definitions as a script.
Use the 'source' command in another
debug session to restore them.
(gdb) h tdump
Print
everything collected at the current tracepoint.
(gdb) h tfind
Select
a trace frame;
No argument means forward by one
frame; '-' meand backward by one frame.
List
of tfind subcommands:
tfind end -- Synonym for 'none'
tfind line -- Select a trace frame by
source line
tfind none -- De-select any trace
frame and resume 'live' debugging
tfind outside -- Select a trace frame
whose PC is outside the given range
tfind pc -- Select a trace frame by PC
tfind range -- Select a trace frame
whose PC is in the given range
tfind start -- Select the first trace
frame in the trace buffer
tfind tracepoint -- Select a trace
frame by tracepoint number