virtqueue_add_inbuf(9)

📦 version 7.3.1, in nixpkgs unstable

✨ virtqueue_add_inbuf ✨

okay so this is a Kernel API Manual moment and we're about to expose input buffers to the other end, bestie 💅

🌸 SYNOPSIS 🌸

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

🎀 ARGUMENTS 🎀

  • vq — the struct virtqueue we're talking about. literally the main character here 👑
  • sg — scatterlist. and bestie, it must be well-formed and terminated! no cap, this is not a drill 😭
  • num — the number of entries in sg writable by other side. count 'em fr fr
  • data — the token identifying the buffer. it's giving name tag at a party 🫶
  • gfp — how to do memory allocations (if necessary). y'know, the whole allocation vibe check 💜

🦋 DESCRIPTION 🦋

okay so here's the tea: caller must ensure we don't call this with other virtqueue operations at the same time (except where noted). like, one thing at a time, periodt. don't be messy 🌈

it returns zero or a negative error (ie. ENOSPC, ENOMEM, EIO). so like, zero is slay, negative is 💀

ngl this is one of those functions you just gotta respect the concurrency rules on. no exceptions bestie ✨

🧚 SEE ALSO 🧚

kernel file ./drivers/virtio/virtio_ring.c and all these iconic siblings:

and that's the whole vibe, bestie 🍓 this page came from ./drivers/virtio and it's dated October 2026 — go forth and expose those buffers responsibly, mwah 💋✨

📦 where this page comes from