vchan_tx_desc_free(9)

💫 vchan_tx_desc_free — the Kernel API Manual glow-up 💫

okay so bestie, you're in the Kernel API Manual and today's main character is vchan_tx_desc_free(9) — the little function that lets your reusable DMA descriptor go 🦋✨

---

🌸 NAME 🌸

vchan_tx_desc_free — free a reusable descriptor, literally just set it free 🫶

---

✨ SYNOPSIS ✨

int vchan_tx_desc_free (struct dma_async_tx_descriptor *tx );

---

🎀 ARGUMENTS 🎀

• tx — the transfer 👑 (that's the descriptor you're about to release, bestie)

---

💅 DESCRIPTION 💅

okay so here's the tea: this function frees a descriptor that was, like, previously allocated as a reusable one. It's giving cleanup era. 💖

The only other way to do this is to clear the DMA_CTRL_REUSE flag and submit one last time the transfer — that's it, those are the two paths, no cap.

It returns 0 upon success ⭐

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/dma/virt-dma.c — go read it, iykyk 📖🦋

---

and that's the whole page, bestie — short and iconic, fr fr. 💜

source/version: ./drivers/dma · dated October 2026 · page vchan_tx_desc_free(9) — mwah, ily, go free those descriptors responsibly 🧚‍♀️🎀💅