FUNCTION::UCALLERS(3stap)

πŸ’– FUNCTION::UCALLERS πŸ’–

okay bestie, welcome to the 3stap manual β€” yes that's the manual section, it's giving SystemTap tapset reference energy and we're gonna read it together, no cap 🫢


✨ NAME ✨

function::ucallers β€” returns the first n elements of a user stack backtrace 🌸


πŸŽ€ SYNOPSIS πŸŽ€

ucallers:string(n:long)

πŸ¦‹ ARGUMENTS πŸ¦‹

  • n β€” the number of levels to descend in the stack, and bestie, not counting the top level. if n is -1, it prints the entire stack. periodt πŸ’…

⭐ DESCRIPTION ⭐

so this function returns a string of the first n hex addresses from the backtrace of the user stack. that's the whole vibe. ✨

lowkey important: the output may be truncated as per the maximum string length, aka MAXSTRINGLEN. so if your backtrace looks like it got cut off mid-sentence... yeah, that's why 😭

πŸ’œ NOTE πŸ’œ

to get (full) backtraces for user space applications and shared shared libraries that are not mentioned in the current script, run stap with -d /path/to/exe-or-so and/or add --ldd to load all the needed unwind data. do not skip this step, i'm literally begging πŸ™ˆ


🌈 SEE ALSO 🌈

tapset::ucontext(3stap)


that's it, that's the page, you ate it, i'm obsessed πŸ‘‘

SystemTap Tapset Reference β€” September 2026 edition, mwah πŸ’‹ πŸŽ€ πŸ¦‹ πŸ’–

πŸ“¦ where this page comes from