numasched(8)

📦 version 0.36.1, in alpine 3.24, nixpkgs unstable, opensuse-leap 16.0

💖 numasched 💖

okay bestie, so this is a page from the System Manager's Manual — section 8, the big-girl system administration section, and the star of the show is a lil tool called numasched. pull up a chair, grab a boba, we're doing NUMA today. 🧚

✨ NAME ✨

numasched — tracing task switch NUMA. it uses bcc/eBPF. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

numasched

just... numasched. no args, no drama. she's simple like that. 💅

👑 DESCRIPTION 👑

numasched tracked task switch of NUMA. that's the mission. that's the whole mission.

also — and this is the cute part — this program is also a basic example of bcc and tracepoint. so if you're tryna learn how bcc does its thing, she's literally right here, showing you the ropes. iconic behavior fr fr. ✨

⚠️ okay important thing, don't skip this: since this uses BPF, only the root user can use this tool. root only. no cap. if you're not root, it's not gonna work, that's just the rules. 💀

🎀 REQUIREMENTS 🎀

  • CONFIG_BPF
  • bcc

that's it. that's the list. two things. 🍓

💅 OPTIONS 💅

  • -p, --pid _PID_ — trace this PID only. one process, all eyes on her. 👀
  • -t, --tid _TID_ — trace this TID only. very specific. very targeted. we love a focused queen. 🎯
  • -c, --comm _COMM_ — trace this COMM only. filter by command name, chef's kiss. 😘

🌈 EXAMPLES 🌈

Tracing task switch NUMA:

# numasched

Trace PID 181 only:

# numasched -p 181

see how easy? she ate and left no crumbs. 🔥

⭐ FIELDS ⭐

here's the tea on what each column actually means when the output starts scrolling, because bestie you're gonna wanna know:

  • TIME — a timestamp on the output, in "HH:MM:SS" format. when did it happen, basically.
  • PID — the process ID.
  • TID — the thread ID.
  • SRC_NID — source NUMA ID. where she came from. 🏠
  • DST_NID — target NUMA ID. where she's going. ✈️
  • COMM — the process COMM.

🦋 SOURCE 🦋

this is from bcc.

https://github.com/iovisor/bcc

also, lowkey important: also look in the bcc distribution for a companion _examples.txt file containing example usage, output, and commentary for this tool. it's giving bonus content, and we love bonus content. 🫶

🌸 OS 🌸

Linux 💜 (obviously, bestie, it's BPF)

😭 STABILITY 😭

Unstable - in development.

so like... she's still growing. still evolving. main character origin story era. treat her gently, expect changes. 🙈

💖 AUTHOR 💖

Rong Tao <rongtao@cestc.cn>

thank you for your service, legend. 👑

✨ SEE ALSO ✨

go check her out too, she's also a baddie. 🎀

and that's the whole page, bestie!! this was USER COMMANDS, dated 2022-12-14, and yeah — numasched(8). now go trace some NUMA task switches, you absolute icon. periodt. 💅✨🌈

📦 where this page comes from