dma_iova_destroy(9)

dma_iova_destroy(9) 💅 — Kernel API Manual edition

okay so bestie, welcome to the Finish a DMA mapping transaction era. This is the Kernel API Manual page for dma_iova_destroy(9), and it's lowkey the cleanup main character. 🧹✨

💖 NAME 💖

dma_iova_destroy — Finish a DMA mapping transaction. That's it, that's the name, and it's giving "wrap it up, we're done here" energy. 🎀

✨ SYNOPSIS ✨

the signature, no cap:

void dma_iova_destroy (struct device *dev , struct dma_iova_state *state
, size_t mapped_len , enum dma_data_direction dir , unsigned long attrs
);

🫶 ARGUMENTS 🫶

• dev — DMA device. like, the device doing the DMA thing. 💻
• state — IOVA state. this is the state bestie, keep up. 🌸
• mapped_len — number of bytes to unmap. literal bytes, bestie. 🔢
• dir — DMA direction. the direction vibe. 🧭
• attrs — attributes of mapping properties. the property-attrs situation. 🎀

🌈 DESCRIPTION 🌈

Okay so here's the actual tea: this function unlinks the IOVA range up to mapped_len and frees the entire IOVA space. 💅🔥

The range of IOVA from dma_addr to mapped_len must all be linked, and it must be the only linked IOVA in state. Not "mostly linked", not "kinda linked with a side quest" — all linked, and the only linked IOVA in state. Periodt. 👑✨

🦋 SEE ALSO 🦋

Kernel file: ./drivers/iommu/dma-iommu.c — go read the source, iykyk. 📖

• iommu_get_dma_cookie(9)
• iommu_get_msi_cookie(9)
• iommu_put_dma_cookie(9)
• iommu_put_msi_cookie(9)
• iommu_dma_get_resv_regions(9)
• iommu_dma_init_options(9)
• iommu_dma_init_domain(9)
• dma_info_to_prot(9)
• dma_iova_try_alloc(9)
• dma_iova_free(9)
• dma_iova_link(9)
• dma_iova_sync(9)
• dma_iova_unlink(9)

xoxo bestie 💖 — source ./drivers/iommu, version dma_iova_destroy(9), dated October 2026. now go slay that cleanup, mwah. 🎀