FUNCTION::PRINT_UBAC(3stap)

💖 FUNCTION::PRINT_UBAC 💖

okay bestie, you found a page from the 3stap manual — that's the SystemTap Tapset Reference, aka the group chat where all the context functions live. this one is literally the backtrace printer. let's get into it 🫶

---

✨ NAME ✨

function::print_ubacktrace_fileline — Print stack back trace for current user-space task. 🦋

---

🌸 SYNOPSIS 🌸

so there's two ways to call this queen, and they're both valid, no cap:

1) print_ubacktrace_fileline()

2) print_ubacktrace_fileline(pc:long,sp:long,fp:long)

---

🎀 ARGUMENTS 🎀

okay so these are the little guys you can hand over, but ONLY in form 2), iykyk:

• pc — override PC. that's the program counter, bestie, you're telling it "hey, look here instead" 💅
• sp — override SP. stack pointer override, slay.
• fp — override FP. frame pointer override, iconic.

---

👑 DESCRIPTION 👑

1) so with no arguments at all? that's the plain vibe. nothing extra to say about it, it just does the thing. ✨

2) this one is equivalent to print_ubacktrace, but the output for each symbol is longer — it includes file names and line numbers. so yeah, more info per line, more to love. 🍓

and also: this is equivalent to print_ubacktrace_fileline, but it performs the backtrace using the pc, sp, and fp that you passed in. so you're driving the backtrace manually, main character energy fr fr. 🔥

---

💀 NOTE 💀

listen up, this part matters. to get (full) backtraces for user space applications and shared shared libraries that aren't mentioned in the current script, you gotta run stap with -d /path/to/exe-or-so and/or add --ldd to load all the needed unwind data. otherwise your backtrace is gonna be giving… incomplete. 😭

---

🌈 SEE ALSO 🌈

• tapset::ucontext-unwind(3stap) — go read your sister page, bestie 🧚

---

and that's the whole page, periodt. 💜

SystemTap Tapset Reference, version Ver — dated September 2026 (yes, the version string is genuinely just sitting there half-formed, we don't make the rules, we just report them 💅). mwah, go forth and unwind your stacks responsibly. 🎀✨