dma_cookie_complete(9)

🦋 dma_cookie_complete(9) 🦋

okay so welcome to the Kernel API Manual, bestie — today’s main character is dma_cookie_complete, and she’s here to complete a descriptor. No cap. 💅

✨ NAME ✨

dma_cookie_complete — complete a descriptor, periodt. 💖

🌸 SYNOPSIS 🌸

void dma_cookie_complete (struct dma_async_tx_descriptor *tx );

🎀 ARGUMENTS 🎀

• tx — the descriptor to complete. that’s the whole vibe.

💖 DESCRIPTION 💖

So what does she actually do? She marks this descriptor complete by updating the channel’s completed cookie marker. Then she zeroes the descriptor’s cookie so accidental repeated completions don’t happen — literally protecting everyone from a messy repeated-completion moment. 🫶

🔥 NOTE 🔥

⚠️ bestie, the caller is expected to hold a lock to prevent concurrency. Do not skip this, fr fr. 🔒

🌈 SEE ALSO 🌈

Kernel file: ./drivers/dma/dmaengine.h

• dma_cookie_init(9)
• dma_cookie_assign(9)
• dma_cookie_status(9)
• dmaengine_desc_get_callback(9)
• dmaengine_desc_callback_invoke(9)
• dmaengine_desc_get_callback_invoke(9)
• dmaengine_desc_callback_valid(9)

This page is serving source/version ./drivers/dma and dated October 2026 — mwah, bye bestie 💋✨