virtqueue_kick_prepare(9)

💖 virtqueue_kick_prepare(9) 💖

okay so welcome to the virtqueue_kick_prepare(9) page, straight out of the Kernel API Manual bestie, and honestly? this one's a little two-parter and it's giving season finale energy 🎀

---

✨ NAME ✨

virtqueue_kick_prepare — the first half of a split virtqueue_kick call. yes, it's a duet, not a solo. 🎤

---

🌸 SYNOPSIS 🌸

bool virtqueue_kick_prepare (struct virtqueue *_vq );

---

🦋 ARGUMENTS 🦋

• _vq — the struct virtqueue. that's it, that's the whole vibe check. the virtqueue in question, the main character 👑

---

💅 DESCRIPTION 💅

okay bestie listen. instead of just calling virtqueue_kick, you can do this little combo instead:

if (virtqueue_kick_prepare(vq))
        virtqueue_notify(vq);

and why would you ever split it like that, you ask? because this is sometimes useful, lowkey. the way that it works is that the virtqueue_kick_prepare call needs to be serialized (so like, one at a time, no cutting the line 🙈) but the actual virtqueue_notify call does not need any of that. so you prep under lock and notify however you like, and the whole thing ate. periodt. 💅

---

🎀 SEE ALSO 🎀

the whole friend group, no cap. kernel file ./drivers/virtio/virtio_ring.c plus:

• virtqueue_add_sgs(9)
• virtqueue_add_outbuf(9)
• virtqueue_add_outbuf_premapped(9)
• virtqueue_add_inbuf(9)
• virtqueue_add_inbuf_cache_clean(9)
• virtqueue_add_inbuf_ctx(9)
• virtqueue_add_inbuf_premapped(9)
• virtqueue_dma_dev(9)
• virtqueue_notify(9)
• virtqueue_kick(9)
• virtqueue_get_buf_ctx(9)
• virtqueue_disable_cb(9)
• virtqueue_enable_cb_prepare(9)
• virtqueue_poll(9)
• virtqueue_enable_cb(9)
• virtqueue_enable_cb_delayed(9)
• virtqueue_detach_unused_buf(9)
• vring_interrupt(9)
• virtqueue_resize(9)
• virtqueue_reset(9)
• virtqueue_get_vring_size(9)
• virtqueue_map_alloc_coherent(9)
• virtqueue_map_free_coherent(9)
• virtqueue_map_page_attrs(9)
• virtqueue_unmap_page_attrs(9)
• virtqueue_map_single_attrs(9)
• virtqueue_unmap_single_attrs(9)
• virtqueue_map_mapping_error(9)
• virtqueue_map_need_sync(9)
• virtqueue_map_sync_single_range_for_cpu(9)
• virtqueue_map_sync_single_range_for_device(9)

---

ngl that's a lot of links but every single one of them is invited to the party 🫶

---

okay that's the page!! sourced from ./drivers/virtio, dated October 2026, and it goes by virtqueue_kick_prepare(9) — mwah, bye bestie, go serialize responsibly 😭💜