xgene_dma_cl...g_descriptor(9)

🎀 xgene_dma_clean_running_descriptor — the Kernel API Manual, bestie edition 🎀

okay so this is the page for xgene_dma_clean_running_descriptor(9) and honestly? it's giving cleanup crew main character energy. it lives in the Kernel API Manual and it is so much chiller than it sounds, trust 💅

---

✨ NAME ✨

xgene_dma_clean_running_descriptor — move the completed descriptor from ld_running to ld_completed

no cap, that's the whole job. it's a glow-up relocation service for descriptors 🌸

---

🦋 SYNOPSIS 🦋

void xgene_dma_clean_running_descriptor (struct xgene_dma_chan *chan ,
       struct xgene_dma_desc_sw *desc );

it returns void, so like… nothing comes back. it just does the thing and leaves. iconic behavior honestly 👑

---

💖 ARGUMENTS 💖

• chan — the X-Gene DMA channel. this is the vibe check context, the place where all the descriptor shuffling actually happens 🫶
• desc — the descriptor which is completed. yes bestie, this one's done, it's finished, it ate and it's ready to move on ✨

---

🔥 DESCRIPTION 🔥

so here's the tea. this function figures out where a finished descriptor should go. two possible outcomes, and it picks based on one condition:

• if it's acked by the async_tx api — free the descriptor directly. like, immediately. no queue, no waiting, just poof, gone 💀
• else — move it to the queue ld_completed. it goes and waits with the other completed descriptors like it's in the group chat but on read-only mode 🙈

that's literally it. simple, elegant, does exactly one thing. we love a focused function 💜

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/dma/xgene-dma.c — the source file where all of this lives, go read it iykyk 📖
• struct xgene_dma_chan(9)
• struct xgene_dma(9)
• xgene_dma_clean_completed_descriptor(9)
• xgene_dma_run_tx_complete_actions(9)
• xgene_chan_xfer_ld_pending(9)
• xgene_dma_cleanup_descriptors(9)
• xgene_dma_free_desc_list(9)

all of these are the extended universe fr fr — same family, same drama, same drivers/dma neighborhood 🏡

---

little reminder bestie: if it is acked by async_tx, the descriptor gets freed directly. do not pass go, do not collect ld_completed. 😭

---

and that's the page!! source path: ./drivers/dma, dated October 2026, straight out of the Kernel API Manual. mwah, go forth and clean those running descriptors 💅🎀🦋⭐