From: Pedro Alves Date: Tue, 15 Mar 2016 11:08:52 +0000 (+0000) Subject: Document possible unreliability of '$_ret' X-Git-Url: http://drtracing.org/?a=commitdiff_plain;h=45fa2529db961adff41c52c3a560808cb135beb2;p=deliverable%2Fbinutils-gdb.git Document possible unreliability of '$_ret' gdb/doc/ChangeLog: 2016-03-15 Pedro Alves Andreas Arnez Marcin Kościelnicki * gdb.texinfo (Tracepoint Actions): Document possible unreliability of '$_ret'. --- diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 3d49085ed7..0606d9db28 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,10 @@ +2016-03-15 Pedro Alves + Andreas Arnez + Marcin Kościelnicki + + * gdb.texinfo (Tracepoint Actions): Document possible + unreliability of '$_ret'. + 2016-03-11 Andrew Burgess * gdb.texinfo (Symbols): Document new 'maint info line-table' diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index bf7df3557a..5f88335c73 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.