Debian Codegraph @

doc/SystemTap_Tapset_Reference/man3/function::ustack.3stap

raw
1 '\" t
2 .\" Title: function::ustack
3 .\" Author:
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: October 2025
6 .\" Manual: Context Functions
7 .\" Source: SystemTap Tapset Reference
8 .\" Language: English
9 .\"
10 .TH "FUNCTION::USTACK" "3stap" "October 2025" "SystemTap Tapset Reference" "Context Functions"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 function::ustack \- Return address at given depth of user stack backtrace
32 .SH "SYNOPSIS"
33 .sp
34 .nf
35 ustack:long(n:long)
36 .fi
37 .SH "ARGUMENTS"
38 .PP
39 \fIn\fR
40 .RS 4
41 number of levels to descend in the stack\&.
42 .RE
43 .SH "DESCRIPTION"
44 .PP
45 Performs a simple (user space) backtrace, and returns the element at the specified position\&. The results of the backtrace itself are cached, so that the backtrace computation is performed at most once no matter how many times
46 \fBustack\fR
47 is called, or in what order\&.
48 .SH SEE ALSO\n
49 .IR tapset::ucontext-symbols (3stap)