iommu_attach_device(9)

💅 iommu_attach_device(9) 💅

okay so bestie, welcome to the Kernel API Manual page for iommu_attach_device(9). This one is short and sweet, and it's literally about attaching an IOMMU domain to a device. Let's get into it 💖

---

✨ NAME ✨

iommu_attach_device — Attach an IOMMU domain to a device 🎀

---

🌸 SYNOPSIS 🌸

int iommu_attach_device (struct iommu_domain *domain , struct device
*dev );

---

🦋 ARGUMENTS 🦋

• domain — IOMMU domain to attach. That's the domain bestie 💅
• dev — Device that will be attached. This is the device getting the domain attached to it ✨

---

💖 DESCRIPTION 💖

It returns 0 on success and an error code on failure. periodt.

🚨 soft-failure alert, bestie: note that EINVAL can be treated as a soft failure, indicating that certain configuration of the domain is incompatible with the device. In this case, attaching a different domain to the device may succeed. so like, not necessarily the end of the world 😭🫶

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/iommu/iommu.c and the whole function friend group:

• iommu_device_register(9)
• iommu_insert_resv_region(9)
• iommu_group_alloc(9)
• iommu_group_get_iommudata(9)
• iommu_group_set_iommudata(9)
• iommu_group_set_name(9)
• iommu_group_add_device(9)
• iommu_group_remove_device(9)
• iommu_group_mutex_assert(9)
• iommu_group_for_each_dev(9)
• iommu_group_get(9)
• iommu_group_ref_get(9)
• iommu_group_put(9)
• iommu_group_id(9)
• device_iommu_capable(9)
• iommu_group_has_isolated_msi(9)
• iommu_set_fault_handler(9)
• iommu_paging_domain_alloc_flags(9)
• iommu_get_domain_for_dev(9)
• iommu_driver_get_domain_for_dev(9)
• iommu_attach_group(9)
• iommu_unmap(9)
• iommu_unmap_fast(9)
• report_iommu_fault(9)
• iommu_get_resv_regions(9)
• iommu_put_resv_regions(9)
• iommu_setup_default_domain(9)
• iommu_device_use_default_domain(9)
• iommu_device_unuse_default_domain(9)
• iommu_group_claim_dma_owner(9)
• iommu_device_claim_dma_owner(9)
• iommu_group_release_dma_owner(9)
• iommu_device_release_dma_owner(9)
• iommu_group_dma_owner_claimed(9)
• iommu_replace_device_pasid(9)
• iommu_attach_handle_get(9)
• iommu_attach_group_handle(9)
• iommu_detach_group_handle(9)
• iommu_replace_group_handle(9)
• pci_dev_reset_iommu_prepare(9)
• pci_dev_reset_iommu_done(9)
• iommu_dma_prepare_msi(9)

---

cute little sign-off: this page comes from ./drivers/iommu, dated October 2026, and it's iommu_attach_device(9). mwah 💋✨