xgene_dma_c..._descriptors(9)

💅 xgene_dma_cleanup_descriptors ✨

okay bestie, welcome to the Kernel API Manual entry for xgene_dma_c..._descriptors — yes the title is truncated with those little dots, that's just how it's printed, we don't fix it, we respect it 🫶

---

🌸 NAME 🌸

xgene_dma_cleanup_descriptors — cleanup link descriptors which are completed and move them to ld_completed to free until flag 'ack' is set

like, it literally tidies up the finished descriptor girlies and parks them in ld_completed so they can chill there until that 'ack' flag shows up 💅

---

✨ SYNOPSIS ✨

void xgene_dma_cleanup_descriptors (struct xgene_dma_chan *chan );

no return value, she just does the thing 🔥

---

🎀 ARGUMENTS 🎀

• chan — X-Gene DMA channel

that's it, that's the whole argument list, one channel, main character energy 👑

---

🦋 DESCRIPTION 🦋

okay so here's the vibe: this function is used on descriptors which have been executed by the DMA controller 🌈

what she does, in order, no skipping:

1. run any callbacks
2. submit any dependencies
3. then free these descriptors if flag 'ack' is set

so if 'ack' isn't set? the freeing step just doesn't happen — the descriptors stay put, no cap 😭

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/dma/xgene-dma.c
• struct xgene_dma_chan(9)
• struct xgene_dma(9)
• xgene_dma_clean_completed_descriptor(9)
• xgene_dma_run_tx_complete_actions(9)
• xgene_dma_clean_running_descriptor(9)
• xgene_chan_xfer_ld_pending(9)
• xgene_dma_free_desc_list(9)

like go read all of these, they're all in the same friend group fr fr 🧚

---

aaaand that's the page bestie 💖 shoutout to ./drivers/dma for being the source, October 2026 for the date, and xgene_dma_c..._descriptors(9) for the footer — she's iconic, she's truncated, she ate 🌟💜