aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorStan Shebs <shebs@codesourcery.com>2010-04-22 04:09:25 +0000
committerStan Shebs <shebs@codesourcery.com>2010-04-22 04:09:25 +0000
commit5a9351aeae277684e6086f527e4a69d037dbc002 (patch)
tree3a8391e069a67fd765ed4e57693686dd02c8b8af /gdb/doc
parent0398aac57504c2b4ee3f8d32486bd4216ded271e (diff)
downloadgdb-5a9351aeae277684e6086f527e4a69d037dbc002.zip
gdb-5a9351aeae277684e6086f527e4a69d037dbc002.tar.gz
gdb-5a9351aeae277684e6086f527e4a69d037dbc002.tar.bz2
2010-04-21 Stan Shebs <stan@codesourcery.com>
* gdb.texinfo (Tracepoint Actions): Mention synonymy of actions and commands. (Listing Tracepoints): Update to reflect current behavior.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog6
-rw-r--r--gdb/doc/gdb.texinfo24
2 files changed, 17 insertions, 13 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 84814a0..69961ff 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+2010-04-21 Stan Shebs <stan@codesourcery.com>
+
+ * gdb.texinfo (Tracepoint Actions): Mention synonymy of actions
+ and commands.
+ (Listing Tracepoints): Update to reflect current behavior.
+
2010-04-22 Pierre Muller <muller@ics.u-strasbg.fr>
* gdb.texinfo (Examining memory): Update for change in string
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 97a5531..f9c3949 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -9647,6 +9647,10 @@ terminate the actions list with a line containing just @code{end}. So
far, the only defined actions are @code{collect}, @code{teval}, and
@code{while-stepping}.
+@code{actions} is actually equivalent to @code{commands} (@pxref{Break
+Commands, ,Breakpoint Command Lists}), except that only the defined
+actions are allowed; any other @value{GDBN} command is rejected.
+
@cindex remove actions from a tracepoint
To remove all actions from a tracepoint, type @samp{actions @var{num}}
and follow it immediately with @samp{end}.
@@ -9675,7 +9679,7 @@ Enter actions for tracepoint 1, one per line:
> collect bar,baz
> collect $regs
> while-stepping 12
- > collect $fp, $sp
+ > collect $pc, arr[i]
> end
end
@end smallexample
@@ -9700,7 +9704,7 @@ collect all local variables.
You can give several consecutive @code{collect} commands, each one
with a single argument, or one @code{collect} command with several
-arguments separated by commas: the effect is the same.
+arguments separated by commas; the effect is the same.
The command @code{info scope} (@pxref{Symbols, info scope}) is
particularly useful for figuring out what data to collect.
@@ -9771,24 +9775,18 @@ tracing:
@itemize @bullet
@item
its passcount as given by the @code{passcount @var{n}} command
-@item
-its step count as given by the @code{while-stepping @var{n}} command
-@item
-its action list as given by the @code{actions} command. The actions
-are prefixed with an @samp{A} so as to distinguish them from commands.
@end itemize
@smallexample
(@value{GDBP}) @b{info trace}
Num Type Disp Enb Address What
1 tracepoint keep y 0x0804ab57 in foo() at main.cxx:7
+ while-stepping 20
+ collect globfoo, $regs
+ end
+ collect globfoo2
+ end
pass count 1200
- step count 20
- A while-stepping 20
- A collect globfoo, $regs
- A end
- A collect globfoo2
- A end
(@value{GDBP})
@end smallexample