<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_ubacktrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="context_stp.html" title="Chapter 2. Context Functions"><link rel="prev" href="API-sprint-syms.html" title="function::sprint_syms"><link rel="next" href="API-sprint-ustack.html" title="function::sprint_ustack"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>function::sprint_ubacktrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-syms.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-sprint-ustack.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_ubacktrace"><a name="API-sprint-ubacktrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_ubacktrace —
Return stack back trace for current user-space task as string.
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
sprint_ubacktrace:string()
</pre></div><div class="refsect1" title="Arguments"><a name="idp3205472"></a><h2>Arguments</h2><p>
None
</p></div><div class="refsect1" title="Description"><a name="idp3206048"></a><h2>Description</h2><p>
</p><p>
Returns a simple backtrace for the current task. One line per
address. Includes the symbol name (or hex address if symbol
couldn't be resolved) and module name (if found). Includes the
offset from the start of the function if found, otherwise the
offset will be added to the module (if found, between
brackets). Returns the backtrace as string (each line terminated by
a newline character). Note that the returned stack will be
truncated to MAXSTRINGLEN, to print fuller and richer stacks use
<code class="function">print_ubacktrace</code>. Equivalent to sprint_ustack(<code class="function">ubacktrace</code>),
but more efficient (no need to translate between hex strings and
final backtrace string).
</p></div><div class="refsect1" title="Note"><a name="idp3208048"></a><h2>Note</h2><p>
To get (full) backtraces for user space applications and shared
shared libraries not mentioned in the current script run stap with
-d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sprint-syms.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="context_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sprint-ustack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_syms</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::sprint_ustack</span></td></tr></table></div></body></html>
