aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc/gdb.texinfo
diff options
context:
space:
mode:
authorPedro Alves <palves@redhat.com>2016-03-15 11:08:52 +0000
committerPedro Alves <palves@redhat.com>2016-03-15 11:08:52 +0000
commit45fa2529db961adff41c52c3a560808cb135beb2 (patch)
treef58661c3ef55990dc639682d27f4c77c62eed8e6 /gdb/doc/gdb.texinfo
parent4bde3cdd707dfdf8b704c0776795b3733592e4b0 (diff)
downloadgdb-45fa2529db961adff41c52c3a560808cb135beb2.zip
gdb-45fa2529db961adff41c52c3a560808cb135beb2.tar.gz
gdb-45fa2529db961adff41c52c3a560808cb135beb2.tar.bz2
Document possible unreliability of '$_ret'
gdb/doc/ChangeLog: 2016-03-15 Pedro Alves <palves@redhat.com> Andreas Arnez <arnez@linux.vnet.ibm.com> Marcin Koƛcielnicki <koriakin@0x04.net> * gdb.texinfo (Tracepoint Actions): Document possible unreliability of '$_ret'.
Diffstat (limited to 'gdb/doc/gdb.texinfo')
-rw-r--r--gdb/doc/gdb.texinfo7
1 files changed, 7 insertions, 0 deletions
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index bf7df35..5f88335 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -12878,6 +12878,13 @@ Collect all local variables.
Collect the return address. This is helpful if you want to see more
of a backtrace.
+@emph{Note:} The return address location can not always be reliability
+determined up front, and the wrong address / registers may end up
+collected instead. On some architectures the reliability is higher
+for tracepoints at function entry, while on others it's the opposite.
+When this happens, backtracing will stop because the return address is
+found unavailable (unless another collect rule happened to match it).
+
@item $_probe_argc
Collects the number of arguments from the static probe at which the
tracepoint is located.