<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_ustack</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-ubacktrace.html" title="function::sprint_ubacktrace"><link rel="next" href="API-sprint-usyms.html" title="function::sprint_usyms"></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_ustack</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-ubacktrace.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-usyms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_ustack"><a name="API-sprint-ustack"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_ustack —
Return stack for the current task from string.
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
sprint_ustack:string(stk:string)
</pre></div><div class="refsect1" title="Arguments"><a name="idp3212008"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>stk</code></em></span></dt><dd><p>
String with list of hexadecimal addresses for the current task.
</p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp3213616"></a><h2>Description</h2><p>
Perform a symbolic lookup of the addresses in the given string,
which is assumed to be the result of a prior call to
<code class="function">ubacktrace</code> for the current task.
</p><p>
Returns a simple backtrace from the given hex string. 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
print_ustack.
</p></div><div class="refsect1" title="NOTE"><a name="idp3215864"></a><h2>NOTE</h2><p>
it is recommended to use <code class="function">sprint_usyms</code> instead of this function.
</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-ubacktrace.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-usyms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_ubacktrace</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_usyms</span></td></tr></table></div></body></html>
