iommu_pages...oherent_list(9)

💅 NAME 💅

ok so this page — it's called iommu_pages...oherent_list(9), from the Kernel API Manual, bestie, don't worry about the truncated name, the kernel just does that — is all about iommu_pages_start_incoherent_list, which makes a list of pages incoherent. that's it. that's the whole vibe. 🦋

---

✨ SYNOPSIS ✨

int iommu_pages_start_incoherent_list (struct iommu_pages_list *list ,
struct device *dma_dev );

like yes it takes two things and returns an int, we been knew 💅

---

🎀 ARGUMENTS 🎀

• list — the list of pages you're setting up. this is the main character of the whole operation, honestly 👑
• dma_dev — the iommu device. the supporting actor. still important tho 🫶

---

🔥 DESCRIPTION 🔥

so what it actually does: it performs iommu_pages_start_incoherent across all of list. every single page in there. no skips, no shortcuts, the whole roster gets the treatment ✨

⚠️ okay this part is important, don't scroll past it: if this fails, the caller must call iommu_pages_stop_incoherent_list. like, that's not optional, that's not a suggestion, that's a "you break it you clean it up" situation 😭 please don't leave things half-incoherent, it's giving chaos and not the cute kind 💀

---

🌈 SEE ALSO 🌈

kernel file ./drivers/iommu/iommu-pages.c — go read it, iykyk 📖

and the whole friend group of related pages, all iconic in their own right:

• iommu_alloc_pages_node_sz(9)
• iommu_free_pages(9)
• iommu_put_pages_list(9)
• iommu_pages_start_incoherent(9)
• iommu_pages_stop_incoherent_list(9)
• iommu_pages_free_incoherent(9)

---

⭐ okay that's the page!! sourced from ./drivers/iommu, dated October 2026, and honestly? we ate. go forth and make your pages incoherent (responsibly, and clean up after yourself with iommu_pages_stop_incoherent_list if it goes sideways) 🧚💜