FUNCTION::UCALLERS

Section: Context Functions (3stap)
Updated: March 2013
Index Return to Main Contents

NAME

function::ucallers - Return first n elements of user stack backtrace

SYNOPSIS

    ucallers:string(n:long)

ARGUMENTS

: number of levels to descend in the stack (not counting the top level). If n is -1, print the entire stack.

DESCRIPTION

This function returns a string of the first n hex addresses from the backtrace of the user stack. Output may be truncated as per maximum string length (MAXSTRINGLEN).

NOTE

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.

This document was created by man2html, using the manual pages.
Time: 09:58:17 GMT, March 20, 2013