FUNCTION::LOCAL_CLOC(3stap)

💖 FUNCTION::LOCAL_CLOC (3stap) 💖

okay bestie, welcome to the Timestamp Functions corner of the 3stap manual, aka the place where we count time and look cute doing it 🕰️✨

---

🌸 NAME 🌸

function::local_clock_us — the number of microseconds on the local cpu's clock 🦋

---

✨ SYNOPSIS ✨

local_clock_us:long()

---

🎀 ARGUMENTS 🎀

None. Not a single one. Zero. Nada. She takes no arguments, she simply is 💅

---

👑 DESCRIPTION 👑

So like, this function hands you back the number of microseconds on the local cpu's clock ⏱️ That's it, that's the whole vibe.

The tea you actually need to know: comparing timestamps on the same cpu? Always monotonic, no cap, she only goes forward, never backwards 🙅‍♀️

But between different cpus? 😭 yeah, there may be some drift — within about a jiffy, so don't be dramatic about it. It's giving "close enough, bestie."

⚠️ fr fr: monotonic-ness is a per-cpu promise only. Cross-cpu comparisons are where the little discrepancies live, and they can be as big as roughly a jiffy. iykyk 💀

---

🔥 SEE ALSO 🔥

• tapset::timestamp_monotonic(3stap) — go read the family, they're all iconic 💜

---

cute sign-off time 🫶

This whole thing came from the SystemTap Tapset Reference, and it's dated September 2026 📅 So yeah, that's the version and the date — consider yourself informed, bestie. Stay monotonic on your own cpu and slay 🌈👑💖