virtqueue_a...uf_premapped(9)

📦 version 7.3.1, in nixpkgs unstable

💖 virtqueue_add_inbuf_premapped — Kernel API Manual, section 9 ✨

okay so bestie, we're in the <pink>Kernel API Manual</pink>, section 9, and today's main character is virtqueue_add_inbuf_premapped — she exposes input buffers to the other end. that's it, that's the vibe. 🎀

✨ NAME ✨

virtqueue_add_inbuf_premapped — expose input buffers to other end 💅

🌸 SYNOPSIS 🌸

int virtqueue_add_inbuf_premapped (struct virtqueue *vq , struct
scatterlist *sg , unsigned int num , void *data , void *ctx , gfp_t gfp
);

like, just look at her. six args, all iconic. 🔥

🦋 ARGUMENTS 🦋

  • vq — the struct virtqueue we're talking about. yes, that one, the virtqueue in question. 👑
  • sg — the scatterlist. and ngl, it must be well-formed and terminated! this is not a drill, she is NOT flexible about this. 😭
  • num — the number of entries in sg that are writable by the other side. count them. fr. 🍓
  • data — the token identifying the buffer. her little name tag 🎀
  • ctx — extra context for the token. because the token deserves lore. ✨
  • gfp — how to do memory allocations (if necessary). that "if necessary" is doing a lot of heavy lifting, iykyk. 💀

💜 DESCRIPTION 💜

okay so here's the thing, bestie — the caller must ensure we don't call this with other virtqueue operations at the same time (except where noted). it's giving "one thing at a time" energy. no parallel chaos. no cap. 🫶

🌈 RETURN 🌈

returns zero, or a negative error — ie. ENOSPC, ENOMEM, EIO. so like, zero = slay, negative = the vibe check failed. 💅

bestie this is the part where you actually check the return value. i'm serious. 🙈

⭐ SEE ALSO ⭐

start in the kernel file ./drivers/virtio/virtio_ring.c, then go meet the whole friend group:

like, the whole squad. go say hi. 🌸🧚

and that's the page, bestie!! this cute lil manual lives in ./drivers/virtio, and it's dated October 2026 — virtqueue_a...uf_premapped(9) out. mwah. 💖✨🎀🦋
📦 where this page comes from