Sophie

Sophie

distrib > Fedora > 17 > i386 > by-pkgid > e2ec330d3ecf5110b4aa890342e53d96 > files > 391

systemtap-client-2.1-2.fc17.i686.rpm

<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_backtrace</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&#160;2.&#160;Context Functions"><link rel="prev" href="API-sid.html" title="function::sid"><link rel="next" href="API-sprint-stack.html" title="function::sprint_stack"></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_backtrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sid.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;2.&#160;Context Functions</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-sprint-stack.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_backtrace"><a name="API-sprint-backtrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_backtrace &#8212; 
     Return stack back trace as string
 </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
    sprint_backtrace:string()
</pre></div><div class="refsect1" title="Arguments"><a name="idp3184904"></a><h2>Arguments</h2><p>
  None
 </p></div><div class="refsect1" title="Description"><a name="idp3185480"></a><h2>Description</h2><p>
   </p><p>

   Returns a simple (kernel) backtrace. 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_backtrace</code>. Equivalent to sprint_stack(<code class="function">backtrace</code>),
   but more efficient (no need to translate between hex strings and
   final backtrace string).
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sid.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="context_stp.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-sprint-stack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sid</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span>function::sprint_stack</span></td></tr></table></div></body></html>