Sophie

Sophie

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

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_syms</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-sprint-stack.html" title="function::sprint_stack"><link rel="next" href="API-sprint-ubacktrace.html" title="function::sprint_ubacktrace"></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_syms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-stack.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-ubacktrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_syms"><a name="API-sprint-syms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_syms &#8212; 
     Return stack for kernel addresses from string
 </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
    sprint_syms(callers:string)
</pre></div><div class="refsect1" title="Arguments"><a name="idp3198016"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>callers</code></em></span></dt><dd><p>
     String with list of hexadecimal (kernel) addresses
    </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp3199616"></a><h2>Description</h2><p>
   Perform a symbolic lookup of the addresses in the given string,
   which are assumed to be the result of a prior calls to <code class="function">stack</code>,
   <code class="function">callers</code>, and similar functions.
   </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), as obtained from
   <code class="function">symdata</code>. 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_syms</code>.
</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-stack.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-ubacktrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_stack</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_ubacktrace</span></td></tr></table></div></body></html>