TAPSET::UCONTEXT-SYMBOLS(3stap)

TAPSET::UCONTEXT-SYMBOLS ✨

okay bestie, welcome to the ucontext-symbols tapset — this is the tapset::ucontext-symbols page from the SystemTap Tapset Reference, and it's literally your little backstage pass to everything user-space-symbol related 💅

---

🌸 NAME 🌸

tapset::ucontext-symbols — the systemtap ucontext-symbols tapset, aka the girlies who tell you what all those mysterious addresses in your app actually mean 🦋

---

✨ DESCRIPTION ✨

so. the user context symbol functions are the ones that give you extra deets about addresses coming out of an application. like, you've got an address, cool, but who is she? 👑

these functions can hook you up with info about:

• the user space map (the library) that the event occurred in, or
• the function symbol of an address.

that's the whole vibe. now let's meet the cast 🎀

---

💖 the functions 💖

• ustack — returns the return address at a given depth of the user stack backtrace. basically "who called whom, at depth N" 🫶

see function::ustack(3stap) for details.

• usymname — returns the symbol of an address in the current task. name that symbol, periodt ✨

see function::usymname(3stap) for details.

• usymdata — returns the symbol and module offset of an address. two-for-one, iconic 🌈

see function::usymdata(3stap) for details.

• print_ustack — prints out the stack for the current task from a string. it does the printing so you don't have to 😌

see function::print_ustack(3stap) for details.

• print_usyms — prints out the user stack from a string. yes queen, show us everything 🔥

see function::print_usyms(3stap) for details.

• sprint_ustack — returns the stack for the current task from a string. the s is for "string, bestie, we're returning it not printing it" 💅

see function::sprint_ustack(3stap) for details.

• sprint_usyms — returns the stack for user addresses from a string. same energy, user addresses edition 🌸

see function::sprint_usyms(3stap) for details.

• usymfileline — returns the file name and line number of an address. the full receipt, name and line 🧾

see function::usymfileline(3stap) for details.

• usymfile — returns the file name of a given address. just the file, no extras, lowkey mysterious 🙈

see function::usymfile(3stap) for details.

• usymline — returns the line number of an address. the little number that tells you exactly where you are 📍

see function::usymline(3stap) for details.

---

👑 SEE ALSO 👑

go read these next, fr fr — they're the whole friend group:

• function::ustack(3stap)
• function::usymname(3stap)
• function::usymdata(3stap)
• function::print_ustack(3stap)
• function::print_usyms(3stap)
• function::sprint_ustack(3stap)
• function::sprint_usyms(3stap)
• function::usymfileline(3stap)
• function::usymfile(3stap)
• function::usymline(3stap)
• stap(1)
• stapprobes(3stap)

---

and that's the page bestie!! 💖 this was brought to you by the SystemTap Tapset Reference, dated September 2026 — mwah, go slay some backtraces 🎀✨🦋