diff options
author | Pedro Alves <palves@redhat.com> | 2016-03-15 11:08:52 +0000 |
---|---|---|
committer | Pedro Alves <palves@redhat.com> | 2016-03-15 11:08:52 +0000 |
commit | 45fa2529db961adff41c52c3a560808cb135beb2 (patch) | |
tree | f58661c3ef55990dc639682d27f4c77c62eed8e6 /gdb/doc/gdb.texinfo | |
parent | 4bde3cdd707dfdf8b704c0776795b3733592e4b0 (diff) | |
download | gdb-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.texinfo | 7 |
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. |