viortc_read_alarm(9)

💅 viortc_read_alarm — the Kernel API Manual page you've been waiting for

okay so bestie, welcome to viortc_read_alarm(9), straight out of the Kernel API Manual ✨ this one's a lil function that's basically the wrapper for VIRTIO_RTC_REQ_READ_ALARM, and honestly? she's giving "small but important." like yes she's just a wrapper but she's the wrapper 🎀

---

🌸 NAME

viortc_read_alarm — the VIRTIO_RTC_REQ_READ_ALARM wrapper. that's it. that's the whole vibe. 💖

---

✨ SYNOPSIS

int viortc_read_alarm (struct viortc_dev *viortc , u16 vio_clk_id , u64
*alarm_time , bool *enabled );

literally just one call, four args, and she returns an int. no cap. 🦋

---

🎀 ARGUMENTS

• viortc — the device data. like, the whole entire device's lil data bundle, hand it over please 🫶
• vio_clk_id — the virtio_rtc clock id (it's a u16, icon behavior)
• alarm_time — the alarm time, in ns ⏰ (yes, nanoseconds, we're precise here)
• enabled — whether the alarm is enabled — a bool *, so you're getting that answer written back at you 👑

---

🧚 CONTEXT

Process context. periodt. don't be out here calling her from anywhere weird 😭

---

⭐ RETURN

Zero on success, negative error code otherwise. that's the whole deal — 0 means slay, anything negative means something went sideways 💀

---

🔥 SEE ALSO

this list is long and honestly it ate. go read these next:

Kernel file ./drivers/virtio/virtio_rtc_driver.c, struct viortc_vq(9), struct viortc_dev(9), struct viortc_msg(9), viortc_class_from_dev(9), viortc_alarms_supported(9), viortc_feed_vq(9), viortc_msg_init(9), viortc_msg_release(9), viortc_do_cb(9), viortc_requestq_hdlr(9), viortc_cb_requestq(9), viortc_alarmq_hdlr(9), viortc_cb_alarmq(9), viortc_get_resp_errno(9), viortc_msg_xfer(9), VIORTC_DECLARE_MSG_HDL_ONSTACK(9), VIORTC_MSG(9), VIORTC_MSG_INIT(9), VIORTC_MSG_WRITE(9), VIORTC_MSG_READ(9), viortc_read(9), viortc_read_cross(9), viortc_cfg(9), viortc_clock_cap(9), viortc_cross_cap(9), viortc_set_alarm(9), viortc_set_alarm_enabled(9), viortc_init_rtc_class_clock(9), viortc_init_ptp_clock(9), viortc_init_clock(9), viortc_clocks_deinit(9), viortc_clocks_init(9), viortc_populate_vq(9), viortc_alloc_vq_bufs(9), viortc_init_vqs(9), viortc_probe(9), viortc_remove(9)

like I said. she ate. 🌈

---

and that's the page, bestie 💜 this icon lives in ./drivers/virtio, dated October 2026, and she was served to you fresh from the viortc_read_alarm(9) section of the manual. go forth and read those alarms 🍓👑