STRUCT VDSO_TIMESTAMP(9)

🌸 struct vdso_timestamp(9) — from the Kernel API Manual, bestie 🌸

okay so picture this: it's a struct in the kernel, and it's literally just... a timestamp per clock_id. that's the whole vibe. basetime per clock_id. iconic, honestly. 💅

---

✨ NAME ✨

struct vdso_timestamp — basetime per clock_id 🕐

---

🎀 SYNOPSIS 🎀

struct vdso_timestamp {
    u64 sec;
    u64 nsec;
 };

look at her. two fields. no notes. 🫶

---

🦋 Members 🦋

• sec — seconds, bestie. the big juicy whole-seconds part ⏱️
• nsec — nanoseconds. yes the tiny little guys. nano. tiny. ✨

---

💖 Description 💖

so here's the tea ☕ — there's one vdso_timestamp object hanging out in vvar for each vDSO-accelerated clock_id. one per clock_id. not optional. that's the arrangement. 👑

for high-resolution clocks, this thing encodes the time corresponding to vdso_time_data.cycle_last. highkey important connection, iykyk. 🔥

for coarse clocks, it encodes the actual time. simple. clean. no math girlbossery. 🌈

and just to be noticed (literally, "to be noticed" — that's the manpage talking, not me): for highres clocks, nsec is left-shifted by vdso_time_data[x].shift. read that twice, bestie. it's giving "do not forget the shift" energy. 🚨

---

⭐ SEE ALSO ⭐

Kernel file ./include/vdso/datapage.h — go read it, it's right there 🧚

• struct vdso_clock(9)
• struct vdso_time_data(9)
• struct vdso_rng_data(9)

the whole friend group, fr fr. 💜

---

this gem lives in ./include/vdso and it was dated October 2026 — shoutout to the kernel docs girlies, and to struct vdso_timestamp(9) herself, an absolute icon. periodt. 💅🎀🦋