<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.69.1"><link rel="start" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ch02.html" title="Chapter 2. Context Functions"><link rel="prev" href="re52.html" title="function::sprint_stack"><link rel="next" href="re54.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="re52.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="re54.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><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 task as string. </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="programlisting"> sprint_ubacktrace:string() </pre></div><div class="refsect1" lang="en"><a name="idp5234896"></a><h2>Arguments</h2><p> None </p></div><div class="refsect1" lang="en"><a name="idp5236112"></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" lang="en"><a name="idp5239632"></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="re52.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re54.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_stack</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>