virtqueue_m...ange_for_cpu(9)

🦋 virtqueue_m...ange_for_cpu(9) — bestie edition 🦋

okay so this is a page from the Kernel API Manual (yes, that manual, the one that lives in the kernel tree) and it's about virtqueue_map_sync_single_range_for_cpu. It's giving "niche virtio lore" and honestly? we're obsessed. Let's get into it 💅

---

✨ NAME ✨

virtqueue_map_sync_single_range_for_cpu — map sync for cpu 🫶

like, that's literally the whole thing. map. sync. for the cpu. iconic.

---

🌸 SYNOPSIS 🌸

void virtqueue_map_sync_single_range_for_cpu (const struct virtqueue
*_vq , dma_addr_t addr , unsigned long offset , size_t size , enum
dma_data_direction dir );

it returns void, so no sneaky return values to check, bestie — it just does the thing. ✨

---

🎀 ARGUMENTS 🎀

• _vq — the struct virtqueue we're talking about. yes, it literally has an underscore in front. no, we don't know why either. 🙈
• addr — DMA address
• offset — DMA address offset
• size — buf size for sync
• dir — DMA direction

five args, all business. slay. 🔥

---

💖 DESCRIPTION 💖

so here's the vibe check 👑 — before you call this function, you gotta use virtqueue_map_need_sync to confirm that the DMA address really needs to be synchronized. like, check first, sync second. that's the whole rule. do not skip the check, fr fr. 😭

lowkey important: this function assumes you already did the virtqueue_map_need_sync confirm step. it's not out here guessing for you, bestie.

---

🌈 SEE ALSO 🌈

the whole friend group shows up here, and we are not leaving anyone out 🫶:

• Kernel file ./drivers/virtio/virtio_ring.c
• 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_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_device(9)

that's the whole squad, no cap. and yes, virtqueue_map_need_sync(9) is in there too — the one from the DESCRIPTION. told you it was important 💀

---

and that's the page, bestie! 🧚 this lil masterpiece lives in ./drivers/virtio and it's dated October 2026 — so it's from the future, which is very main character energy of it. mwah 💋 💜