vchan_terminate_vdesc(9)

💅 vchan_terminate_vdesc — like, the whole vibe ✨

okay bestie, so this is a page straight out of the Kernel API Manual, and it's about one tiny function that does one very specific thing 🎀 no cap, it's short, but every word matters so stay with me.

---

🌸 NAME 🌸

vchan_terminate_vdesc — kills off a pending cyclic callback, that's the whole job 💀

---

⭐ SYNOPSIS ⭐

void vchan_terminate_vdesc (struct virt_dma_desc *vd );

it literally returns void, so like… don't go looking for a return value, there isn't one 🫶

---

🦋 ARGUMENTS 🦋

• vd — the virtual descriptor that's getting terminated ✂️ it's the one being shut down, bestie, that's it

---

🔥 DESCRIPTION 🔥

okay so real talk: vc.lock must be held by the caller 👑 like, that's not a suggestion, that's the whole deal. you show up holding the lock, or you don't show up at all 💅

fr fr though — this is the entire description. no extra lore. lock held, or it's not it 🙈

---

🌈 SEE ALSO 🌈

everything here lives in the kernel file ./drivers/dma/virt-dma.h — go read the whole friend group:

• vchan_tx_prep(9)
• vchan_issue_pending(9)
• vchan_cookie_complete(9)
• vchan_vdesc_fini(9)
• vchan_cyclic_callback(9)
• vchan_next_desc(9)
• vchan_get_all_descriptors(9)
• vchan_synchronize(9)

---

and that's the page, bestie 💖 that's genuinely all of it — short, iconic, absolutely zero filler ✨

shoutout to ./drivers/dma for being the source of all this, dated October 2026 🎀 mwah, see you in the next manpage 🌸