virtqueue_ma...loc_coherent(9)

💅 virtqueue_ma...loc_coherent(9) — like, the Kernel API Manual page, bestie 🎀

okay so this one lives in the Kernel API Manual and the function name is a whole mouthful: virtqueue_map_alloc_coherent. Don't panic, it's actually chill. Let's get into it ✨

---

✨ NAME ✨

virtqueue_map_alloc_coherent — alloc coherent mapping 🫶

---

🌸 SYNOPSIS 🌸

void * virtqueue_map_alloc_coherent (struct virtio_device *vdev , union
virtio_map map , size_t size , dma_addr_t *map_handle , gfp_t gfp );

like yes she's long but she's worth it 💖

---

🦋 ARGUMENTS 🦋

• vdev — the virtio device we are talking to 💬 (literally the other half of the conversation)
• map — metadata for performing mapping 🗂️
• size — the size of the buffer 📏
• map_handle — the pointer to the mapped address 📍
• gfp — allocation flag (GFP_XXX) 🌱

---

⭐ DESCRIPTION ⭐

so basically: return virtual address or NULL on error 😭 that's the whole vibe. no cap.

lowkey important: if you get NULL back, that's the error signal — not a cute little empty result. handle it 💀

---

💜 SEE ALSO 💜

she's in the kernel file ./drivers/virtio/virtio_ring.c and honestly her whole friend group is huge, so here's the full squad, no gatekeeping 🫶:

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

---

okay that's the whole page, mwah 💋 it's from ./drivers/virtio, dated October 2026, and it's literally titled virtqueue_ma...loc_coherent(9) — yes the title is truncated with dots, no that's not a typo, that's just how she's listed 💅✨ go read the kernel source bestie, ily, bye 🎀🦋