1FUNCTION::SPRINT_UBA(3stap)    Context Functions   FUNCTION::SPRINT_UBA(3stap)
2
3
4

NAME

6       function::sprint_ubacktrace - Return stack back trace for current task
7       as string. EXPERIMENTAL!
8

SYNOPSIS

10           sprint_ubacktrace:string()
11

ARGUMENTS

13       None
14

DESCRIPTION

16       Returns a simple backtrace for the current task. One line per address.
17       Includes the symbol name (or hex address if symbol couldn't be
18       resolved) and module name (if found). Includes the offset from the
19       start of the function if found, otherwise the offset will be added to
20       the module (if found, between brackets). Returns the backtrace as
21       string (each line terminated by a newline character). Note that the
22       returned stack will be truncated to MAXSTRINGLEN, to print fuller and
23       richer stacks use print_ubacktrace. Equivalent to
24       sprint_ustack(ubacktrace), but more efficient (no need to translate
25       between hex strings and final backtrace string).
26

NOTE

28       To get (full) backtraces for user space applications and shared shared
29       libraries not mentioned in the current script run stap with -d
30       /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
31
32
33
34SystemTap Tapset Reference        August 2011      FUNCTION::SPRINT_UBA(3stap)
Impressum