FUNCTION::SPRINT_SYM(3stap)
π FUNCTION::SPRINT_SYMS π
okay so bestie, we're in the Context Functions corner of the 3stap manual, and today's main character is function::sprint_syms β the girl who turns a lil string of kernel addresses into an actual stack trace. she's giving translator energy fr fr π§β¨
πΈ NAME πΈ
function::sprint_syms β literally returns the stack for kernel addresses, but like, from a string. no cap. π
β¨ SYNOPSIS β¨
sprint_syms(callers:string)
π ARGUMENTS π
callersβ a string holding a list of hexadecimal (kernel) addresses. that's it, that's the input π«Ά
π DESCRIPTION π
so what she does is: she takes the addresses sitting in that string and does a symbolic lookup on them. and the vibe check here is that those addresses are assumed to be the result of a prior call to stack, callers, and similar functions. iykyk. π
she hands you back a simple backtrace from that hex string β one line per address, periodt. each line is giving:
- the symbol name β or the plain hex address if the symbol just couldn't be resolved, tragic π
- the module name, if one was found, as obtained from
symdata - the offset from the start of the function, if that's found. and if it's not found? then the offset gets added to the module instead (if the module was found), sitting right there between brackets. cute.
and the whole backtrace comes back as a string, with every single line terminated by a newline character. iconic. β
β οΈ heads up bestie, important one: the returned stack gets truncated toMAXSTRINGLEN. so if you're craving fuller and richer stacks, don't use this one β go useprint_symsinstead. not me warning you twice π
π¦ SEE ALSO π¦
SystemTap Tapset Reference Ver, September 2026 β mwah, that's a wrap, go slay some backtraces bestie πππ«Ά
π¦ 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