FUNCTION::SPRINT_USY(3stap)
β¨ FUNCTION::SPRINT_USY β¨
okay bestie, welcome to the Context Functions corner of the SystemTap Tapset Reference π this one's all about turning a lil string of addresses into an actual readable stack, and honestly? it's giving detective work π΅οΈβοΈ
πΈ NAME πΈ
function::sprint_usyms β Return stack for user addresses from string
π SYNOPSIS π
sprint_usyms(callers:string)
π¦ ARGUMENTS π¦
callersβ a string packed with a list of hexadecimal (user) addresses. yeah, just a string full of hex. iconic behavior honestly β¨
π DESCRIPTION π
so what this does is it goes and does a symbolic lookup of all the addresses sitting in that string you handed it. and like, those addresses are assumed to be the result of previous calls to ustack, ucallers, and similar functions β so don't just throw random hex at it and expect magic, bestie π
it returns a simple backtrace from the given hex string. one line per address, no cap. and what's in each line?
- the symbol name β or the hex address itself if the symbol couldn't be resolved, ngl
- the module name, if it found one β as obtained from
usymdata - the offset from the start of the function, if found. and if it wasn't found, the offset gets added to the module instead (between brackets), if that module was found π
it hands you back the backtrace as a string, with every line terminated by a newline character. periodt π
β οΈ heads up though: the returned stack gets truncated toMAXSTRINGLEN. so if you want fuller and richer stacks, useprint_usymsinstead β that's the move π«Ά
π SEE ALSO π
tapset::ucontext-symbols(3stap)
and that's the whole vibe, bestie!! π this lil masterpiece lives in the SystemTap Tapset Reference, version Ver, dated September 2026 β go forth and slay your backtraces πβ¨π
π¦ 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