virtqueue_add_inbuf_ctx(9)

📦 version 7.3.1, in nixpkgs unstable

💖 virtqueue_add_inbuf_ctx 💖

okay bestie so this is a page from the Kernel API Manual and it's literally about showing your input buffers to the other end of the virtqueue. it's giving "here, take my stuff, please don't fumble it" energy 🎀

✨ NAME ✨

virtqueue_add_inbuf_ctx — expose input buffers to other end 🫶

🌸 SYNOPSIS 🌸

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

like, yes, it's a long signature, but she's worth it 💅

🦋 ARGUMENTS 🦋

  • vq — the struct virtqueue we're talking about. your main character struct, the one we're actually doing the thing to 👑
  • sg — the scatterlist. and hear me out: it must be well-formed and terminated. no half-built scatterlists, no loose ends, she needs to be complete fr fr 😭
  • num — the number of entries in sg that are writable by the other side. count them, bestie, don't guess 🔢
  • data — the token that identifies the buffer. it's like a little name tag so you know who's who later 🏷️
  • ctx — extra context for that token. more lore, more detail, we love a token with backstory 💜
  • gfp — how to do memory allocations (if necessary). that's the "if necessary" doing a lot of heavy lifting ngl 🌈

⭐ DESCRIPTION ⭐

so the caller — that's you, bestie — must ensure we don't call this at the same time as other virtqueue operations, except where noted. like, no multitasking with the virtqueue, okay? she needs your full attention 🙈

it returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO). so like, zero = slay, negative = something went sideways and you gotta read the error 💀

🎀 SEE ALSO 🎀

these are the sibling functions, the whole friend group, and honestly they all ate 🔥 the kernel file is ./drivers/virtio/virtio_ring.c:

periodt. that's the whole list, no cap 💅✨

and that's the page bestie!! this one's from ./drivers/virtio, dated October 2026, and it's all about virtqueue_add_inbuf_ctx(9) — go expose those input buffers, you've got this 💖🦋🌸

📦 where this page comes from