iommu_iotlb_gather_add_page(9)

💅 iommu_iotlb_gather_add_page(9) 💅

okay so bestie, welcome to the kernel API manual, this one's from the <pink>Kernel API Manual</pink> girlies and it's literally all about gathering up page-based TLB invalidation. stay with me, it's giving lowkey iconic ✨

---

🌸 NAME 🌸

iommu_iotlb_gather_add_page — gather for page-based TLB invalidation 🎀

---

🦋 SYNOPSIS 🦋

void iommu_iotlb_gather_add_page (struct iommu_domain *domain , struct
       iommu_iotlb_gather *gather , unsigned long iova , size_t size );

like, that's the whole signature bestie, no cap 💖

---

💜 ARGUMENTS 💜

• domain — the IOMMU domain that's getting invalidated, that's the main character here 👑
• gather — the TLB gather data, yes it's literally called gather, we love a self-descriptive name 🫶
• iova — start of the page to invalidate 📍
• size — size of the page to invalidate 📏

---

✨ DESCRIPTION ✨

so this is a helper for IOMMU drivers to build invalidation commands based on individual pages 🧚 — or, and this is the important bit, with page size/table level hints which cannot be gathered if they differ. like, if the hints differ, they can't be merged together, periodt 💀 so the function sorts that out for you 💅

---

🌈 SEE ALSO 🌈

Kernel file ./include/linux/iommu.h — and honestly the whole friend group showed up for this one:

• struct iommu_fault_page_request(9)
• struct iommu_fault(9)
• enum iommu_page_response_code(9)
• struct iommu_page_response(9)
• struct iopf_queue(9)
• struct iommu_resv_region(9)
• struct iommu_iotlb_gather(9)
• struct iommu_dirty_bitmap(9)
• struct iommu_dirty_ops(9)
• struct iommu_user_data(9)
• struct iommu_user_data_array(9)
• __iommu_copy_struct_from_user(9)
• iommu_copy_struct_from_user(9)
• __iommu_copy_struct_from_user_array(9)
• iommu_copy_struct_from_user_array(9)
• iommu_copy_struct_from_full_user_array(9)
• __iommu_copy_struct_to_user(9)
• iommu_copy_struct_to_user(9)
• struct iommu_ops(9)
• struct iommu_domain_ops(9)
• struct iommu_device(9)
• struct iommu_fault_param(9)
• struct dev_iommu(9)
• iommu_iotlb_gather_is_disjoint(9)
• iommu_iotlb_gather_add_range(9)
• struct iommu_fwspec(9)
• struct iommu_sva(9)
• iommu_map_sgtable(9)

---

and that's the whole page bestie, ate and left no crumbs 💅✨

shoutout to the ./include/linux girlies for hosting this one, dated October 2026, straight from the Kernel API Manual — mwah, see u in the next manpage 🫶💖🎀