viortc_msg_xfer(9)

💖 viortc_msg_xfer(9) 💖

okay bestie, welcome to the Kernel API Manual page for a function that sends a message request and then waits until the message response comes back. it's giving “send and await” main character energy, and we are going to keep every single detail intact — no cap, no skipped options, no invented lore. periodt. 💅

🌸 NAME 🌸

viortc_msg_xfer — send message request, wait until message response

✨ SYNOPSIS ✨

int viortc_msg_xfer (struct viortc_vq *vq , struct viortc_msg *msg ,
unsigned long timeout_jiffies );

🎀 ARGUMENTS 🎀

• vq — virtqueue. yes bestie, the virtqueue itself.
• msg — message with driver request. the driver request lives in here.
• timeout_jiffies — message response timeout, with 0 meaning no timeout. so if you want zero timeout vibes, you literally pass 0.

💅 CONTEXT 💅

Process context. it takes and releases vq.lock. it may sleep 😴 — that part is literally in the manual, so don't act surprised.

🔥 RETURN 🔥

Zero on success, negative error code otherwise. so: 0 = slay, negative = error code, fr fr.

🦋 SEE ALSO 🦋

the whole friend group is here, and every reference is staying:

• 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_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_read_alarm(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)

xoxo bestie, this page is signed off from the ./drivers/virtio source/version and dated October 2026 💖🫶