vringh_complete_kern(9)

💅 vringh_complete_kern(9) — your fave kernel API manual, now with ✨personality✨

okay so bestie, welcome to the vringh_complete_kern(9) page from the Kernel API Manual — like, the actual kernel manual, but make it make sense. create the moment. 🎀

---

✨ NAME ✨

vringh_complete_kern — we've finished with this descriptor, so we publish it. slay, it's done, we're releasing it into the world. 🦋

---

✨ SYNOPSIS ✨

int vringh_complete_kern (struct vringh *vrh , u16 head , u32 len );

like, that's the whole vibe. it returns an int, it takes three things, and it's lowkey iconic for it. 🔥

---

✨ ARGUMENTS ✨

• vrh — the vring. that's it. that's the whole description. she's the ring. main character energy. 👑
• head — the head, exactly as it was filled in by vringh_getdesc_kern. no cap, use the value that came from there — don't go inventing your own. 🙈
• len — the length of the data we have written. like, how much we actually wrote. 📏

---

✨ DESCRIPTION ✨

so after you call this function (one time, or multiple times — she's not gatekeeping, call her however many times you need), you should check vringh_need_notify_kern. fr fr, that's the move. 🫶

like, that's genuinely the whole instruction. do the completing, then go check vringh_need_notify_kern. iykyk. 💅

---

✨ SEE ALSO ✨

the kernel file ./drivers/vhost/vringh.c — and also, literally, all of these besties:

• vringh_kiov_advance(9)
• vringh_init_user(9)
• vringh_getdesc_user(9)
• vringh_iov_pull_user(9)
• vringh_iov_push_user(9)
• vringh_complete_user(9)
• vringh_complete_multi_user(9)
• vringh_notify_enable_user(9)
• vringh_notify_disable_user(9)
• vringh_need_notify_user(9)
• vringh_init_kern(9)
• vringh_getdesc_kern(9)
• vringh_notify_enable_kern(9)
• vringh_notify_disable_kern(9)
• vringh_need_notify_kern(9)
• vringh_init_iotlb(9)
• vringh_init_iotlb_va(9)
• vringh_set_iotlb(9)
• vringh_getdesc_iotlb(9)
• vringh_iov_pull_iotlb(9)
• vringh_iov_push_iotlb(9)
• vringh_complete_iotlb(9)
• vringh_need_notify_iotlb(9)

that's the whole friend group. go read them, they each ate. 🌈

---

🌸 signing off 🌸

this lil page lives in ./drivers/vhost, dated October 2026, and it's brought to you by vringh_complete_kern(9) — the one and only. take care of her, check vringh_need_notify_kern, and drink some water. mwah. 💜🎀✨