FUNCTION::PRINT_USTA(3stap)
β¨ FUNCTION::PRINT_USTA β¨
okay bestie, we're diving into the Context Functions chapter of the SystemTap Tapset Reference (yes it's 3stap, the manual section, keep up π
) and today's main character is print_ustack. she's lowkey iconic, highkey niche. let's go π¦
πΈ NAME πΈ
function::print_ustack β bestie, she prints out the stack for the current task, but from a string. that's the whole vibe. π
π SYNOPSIS π
print_ustack(stk:string)
that's it. one arg. no drama. periodt. β¨
π ARGUMENTS π
stkβ astringholding a list of hexadecimal addresses, and those addresses belong to the current task. like, the task you're literally inside right now. that's the one. π«Ά
π DESCRIPTION π
so here's the tea β: print_ustack does a symbolic lookup on the addresses sitting in that string you just handed her. and where did that string come from, you ask? it's assumed to be the result of a prior call to ubacktrace for the current task. so like, ubacktrace first, then this one. in that order. no cap. π
then she prints one line per address, and each of those lines gives you:
- the address itself π
- the name of the function that contains that address π
- and an estimate of its position within that function π―
and after all that? she returns nothing. absolutely nothing. she's giving, she's slaying, and then she justβ¦ leaves. no return value. not even a little one. π
β οΈ NOTE β οΈ
okay so real talk bestie β it is recommended to use print_usyms instead of this function. not me telling you to switch but like. i'm telling you to switch. π
π SEE ALSO π
tapset::ucontext-symbols(3stap)β go read this one too, iykyk π
that's the whole page bestie, you ate it up fr fr πβ¨ this was SystemTap Tapset Reference, version vibes from September 2026 β now go forth and print those stacks, queen ππ
π¦ where this page comes from
- centos-stream 10: systemtap-client 5.6-3.el10 Β· GPL-2.0-or-later AND GPL-2.0-only AND BSD-3-Clause AND LGPL-2.1-only AND GFDL-1.2-or-later AND BSD-2-Clause
- centos-stream 9: systemtap-client 5.6-3.el9 Β· GPL-2.0-or-later AND GPL-2.0-only AND BSD-3-Clause AND LGPL-2.1-only AND GFDL-1.2-or-later AND BSD-2-Clause
- fedora 43: systemtap-client 5.6-1.fc43 Β· GPL-2.0-or-later AND GPL-2.0-only AND BSD-3-Clause AND LGPL-2.1-only AND GFDL-1.2-or-later AND BSD-2-Clause
- fedora 44: systemtap-client 5.6-1.fc44 Β· GPL-2.0-or-later AND GPL-2.0-only AND BSD-3-Clause AND LGPL-2.1-only AND GFDL-1.2-or-later AND BSD-2-Clause
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms