virtqueue_map_page_attrs(9)

📦 version 7.3.1, in nixpkgs unstable

💫 NAME 💫

virtqueue_map_page_attrs — ok so this is the one that maps a page to the device, bestie 🎀

Quick vibe check: this page lives in the Kernel API Manual section 9, and it's about handing a page over to your device so it can do DMA things with it ✨

🦋 SYNOPSIS 🦋

dma_addr_t virtqueue_map_page_attrs (const struct virtqueue *_vq ,
struct page *page , unsigned long offset , size_t size , enum
dma_data_direction dir , unsigned long attrs );

Like, that's the whole signature, no cap 💅

🌸 ARGUMENTS 🌸

  • _vq — the virtqueue we are talking to 🫶 like, which queue are we doing this for
  • page — the page that will be mapped by the device, the actual star of the show 👑
  • offset — the offset in the page for a buffer, so we know where in that page the good stuff starts
  • size — the buffer size, literally how much we're mapping 📏
  • dir — mapping direction, iykyk 🌈
  • attrs — mapping attributes, the little extras ✨

🔥 DESCRIPTION 🔥

So it returns the mapped address — that's the whole delivery 🚚

⚠️ But fr fr, caller should check that by virtqueue_map_mapping_error — don't just trust the address, do the vibe check first or you're gonna have a bad time 😭

💜 SEE ALSO 💜

So there's a kernel file involved: ./drivers/virtio/virtio_ring.c 📁 — that's where the magic lives, go read it, it's giving main character energy.

And now, the whole squad of friends, no one left behind 🫶:

okay that's the whole page bestie, you ate that 🍓

Signed off from the ./drivers/virtio corner of the kernel 🌈, dated October 2026, manual section 9 — periodt 💅✨

📦 where this page comes from