viortc_read_cross(9)

📦 version 7.3.1, in nixpkgs unstable

💅 viortc_read_cross — like, the manual page for it (Kernel API Manual, bestie)

okay so welcome to viortc_read_cross(9), a page from the Kernel API Manual ✨ and honestly? it's a little guy. a tiny wrapper. but it's an important tiny wrapper, so let's get into it 🫶

🌸 NAME 🌸

viortc_read_cross — the VIRTIO_RTC_REQ_READ_CROSS wrapper. that's it, that's the whole vibe. it wraps the request. it's giving middleman but make it iconic 💅

✨ SYNOPSIS ✨

int viortc_read_cross (struct viortc_dev *viortc , u16 vio_clk_id , u8
hw_counter , u64 *reading , u64 *cycles );

like yes she takes five arguments and returns an int, no cap. the line breaks are a little chaotic but we respect her 🎀

🦋 ARGUMENTS 🦋

so here's who's who in the group chat:

  • viortc — the device data. this is the main character, the device itself 💖
  • vio_clk_id — the virtio_rtc clock id (type u16). which clock are we talking about, bestie? this tells you 🔥
  • hw_counter — the virtio_rtc HW counter type (type u8). specifying the hardware counter flavor 🌈
  • reading — the clock reading, measured in [ns]. it's a u64 *, so yes, pointer, so yes, she writes into it 💫
  • cycles — the HW counter cycles during the clock reading. also a u64 *. also gets written into. both of them, lowkey, get filled in 🍓

🧚 CONTEXT 🧚

Process context. that's the whole section. process context, periodt. so like, don't be calling this from some weird atomic place, iykyk 😭

⭐ RETURN ⭐

Zero on success 💚 — and a negative error code otherwise 💀. classic. no surprises, no drama, we love a predictable return value 👑

🔥 SEE ALSO 🔥

okay this list is LONG and honestly it ate. buckle up bestie, we're going through the whole friend group:

the kernel file ./drivers/virtio/virtio_rtc_driver.c plus:

see? told you. the whole squad 🫶

ngl if you're here it's probably because something with VIRTIO_RTC_REQ_READ_CROSS is doing bits and you need to know what the wrapper promises. it promises zero or negative. that's the contract. slay ✨

and that's the page!! brought to you by the source ./drivers/virtio, dated October 2026, and known to all her friends as viortc_read_cross(9) 💜 mwah, go read some virtio code bestie 🎀

📦 where this page comes from