STRUCT IOMMU_FAULT_PARAM(9)

🌸 NAME 🌸

struct iommu_fault_param(9) — straight from the Kernel API Manual, bestie — and it is literally the per-device IOMMU fault data struct. That’s the whole vibe: per-device IOMMU fault data, no cap. 💅

✨ SYNOPSIS ✨

Here’s the full fit, exactly as it’s giving:

       struct iommu_fault_param {
           struct mutex lock;
           refcount_t users;
           struct rcu_head rcu;
           struct device *dev;
           struct iopf_queue *queue;
           struct list_head queue_list;
           struct list_head partial;
           struct list_head faults;
        };

🫶 Members 🫶

Okay so every single member is doing main-character work, and we are not skipping any:

• lock — protects the pending faults list, periodt.
• users — user counter to manage the lifetime of the data.
• rcu — rcu head for kfree_rcu.
• dev — the device that owns this param.
• queue — IOPF queue.
• queue_list — index into queue->devices.
• partial — faults that are part of a Page Request Group for which the last request hasn’t been submitted yet.
• faults — holds the pending faults which need response.

🌈 SEE ALSO 🌈

Kernel file ./include/linux/iommu.h — and the whole linked-list bestie squad is right here:

• 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 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)

Signed, sealed, and slayed from ./include/linux, October 2026, on the struct iommu_fault_param(9) page — mwah! 💖