virtqueue_reset(9)

💅 virtqueue_reset(9) — it's giving Kernel API Manual, bestie 🦋

okay so picture this: you're deep in the kernel, you've got a struct virtqueue that's holding onto a bunch of buffers nobody's using anymore, and you just want to, like, let them go. that's this function. welcome to the reset arc, it's very main character energy ✨

---

🌸 NAME 🌸

virtqueue_reset — detach and recycle all unused buffers 💖

---

✨ SYNOPSIS ✨

int virtqueue_reset (struct virtqueue *_vq , void (*recycle)(struct
virtqueue *vq, void *buf) , void (*recycle_done)(struct virtqueue *vq)
);

like, look at that signature. three whole params. she's committed 🎀

---

🫶 ARGUMENTS 🫶

• _vq — the struct virtqueue we're talking about. yes, the underscore is part of the name, don't come for her 💅
• recycle — callback to recycle unused buffers. this is where you get to be the recycling icon you were always meant to be ♻️
• recycle_done — callback that gets invoked when the recycling of all the unused buffers is done. the "we're so back" moment, fr fr 🌈

---

💀 DESCRIPTION 💀

okay so the caller must ensure we don't call this with other virtqueue operations at the same time — except where noted. that's a big deal, not me being dramatic. do not overlap this with other vq ops unless the docs literally told you it's fine 🙈

returns zero or a negative error, and here's the full receipt:

• 0 — success. slay 💅 periodt
• -EBUSY — failed to sync with device, and vq may not work properly 😭 like it might be cooked, ngl
• -ENOENT — transport or device not supported 🫠
• -EPERM — operation not permitted 🔥

warning bestie: that -EBUSY one is the scary one — if you hit it, the vq may not work properly. not a vibe. 💀

---

👑 SEE ALSO 👑

kernel file ./drivers/virtio/virtio_ring.c — that's where the magic lives, iykyk 🧚

and the whole friend group, because she does not go anywhere alone:

• 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_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_cpu(9)
• virtqueue_map_sync_single_range_for_device(9)

thirty-one entries and every single one of them still invited, no gatekeeping here 🎀

---

and that's the whole page, bestie 🫶 this drop is from ./drivers/virtio, dated October 2026, and it lives in the Kernel API Manual — go forth, detach those unused buffers, and recycle responsibly ✨💖