STRUCT IOMMU_FAULT_PAGE_REQUEST(9)

💖 struct iommu_fault_page_request — Page Request data 💖

okay so bestie, welcome to the Kernel API Manual, we're talking struct iommu_fault_page_request today and honestly? it's giving "small struct, big responsibilities" ✨ this is the data that shows up when a device is like "hey, I need a page, can u map it for me 🥺" — it's the Page Request data, periodt.

🌸 NAME 🌸

struct iommu_fault_page_request — Page Request data 🎀

✨ SYNOPSIS ✨

struct iommu_fault_page_request {
  #define IOMMU_FAULT_PAGE_REQUEST_PASID_VALID    (1 << 0);
  #define IOMMU_FAULT_PAGE_REQUEST_LAST_PAGE      (1 << 1);
  #define IOMMU_FAULT_PAGE_RESPONSE_NEEDS_PASID   (1 << 2);
    u32 flags;
    u32 pasid;
    u32 grpid;
    u32 perm;
    u64 addr;
    u64 private_data[2];
 };

like, copy that exactly bestie, don't be out here renaming things 🙈

🫶 MEMBERS 🫶

• flags — this one's the vibe check of the whole struct ngl. it encodes whether the corresponding fields are valid and whether this is the last page in the group (you know, the IOMMU_FAULT_PAGE_REQUEST_* values 💅). and listen, this part matters: when IOMMU_FAULT_PAGE_RESPONSE_NEEDS_PASID is set, the page response must have the same PASID value as the page request — same, matching, no cap. when it's clear, the page response should not have a PASID. okurrr 🦋
• pasid — Process Address Space ID 👑
• grpid — Page Request Group Index 🎀
• perm — the requested page permissions (those IOMMU_FAULT_PERM_* values, iykyk) 🔥
• addr — page address 📍
• private_data — device-specific private information 🙈 like, the device's own little secret stash, not for us

🌈 SEE ALSO 🌈

so there's a whole friend group here, fr fr — start with the Kernel file ./include/linux/iommu.h, then:

• 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)
• iommu_iotlb_gather_add_page(9)
• struct iommu_fwspec(9)
• struct iommu_sva(9)
• iommu_map_sgtable(9)

okay that's the whole lore drop 💀 this page lives in ./include/linux and it's dated October 2026 — so like, future-core of it all ⭐ go read the kernel source bestie, ily, bye 🧚‍♀️💜