FUNCTIO...TCH_FIL(3stap)

✨ NAME ✨

function::switch_file — bestie, this is the one that flips you over to the next output file 🎀

(it lives in the 3stap tapset manual section, iykyk)

---

✨ SYNOPSIS ✨

switch_file()

✨ ARGUMENTS ✨

Nothing. Nada. Zero. It takes no arguments, she works alone 💅

✨ DESCRIPTION ✨

Okay so here's the tea ☕ — this function sends a signal to the stapio process, and it's basically telling it: "bestie, rotate to the next output file." That kicks in when your output is being sent to file(s), so it's giving file-rotation hype squad energy 🔥

🚨 IMPORTANT LORE ALERT 🚨 the way this file-switching mechanism works was changed by upstream commit 5b39471380a238469c8fc18136f12600e5e9aec7. And after that commit? The rotation only works if there is some actual systemtap output. Like, no output, no rotation. That's the vibe check and she does not negotiate 😭

So fr fr: if you were expecting a little file shuffle with nothing coming out of systemtap, that is not happening. Actual output is required. Periodt. 💀

---

✨ SEE ALSO ✨

• tapset::switchfile(3stap) 🌸

---

and that's the whole page, no cap 🫶 this lil tapset reference is brought to you by the SystemTap Tapset Reference, dated September 2026 — mwah, iconic, go read your other manpages now 💖🦋⭐