iommu_attach_handle_get(9)

✨ iommu_attach_handle_get(9) ✨

Okay bestie, welcome to the iommu_attach_handle_get(9) page — this is from the Kernel API Manual, and we're about to make this whole attach-handle thing make sense. Fr fr. 💖

💅 NAME 💅

iommu_attach_handle_get — Return the attach handle

🌸 SYNOPSIS 🌸

struct iommu_attach_handle * iommu_attach_handle_get (struct iommu_group
*group , ioasid_t pasid , unsigned int type );

🎀 ARGUMENTS 🎀

• group — the iommu group that domain was attached to
• pasid — the pasid within the group
• type — matched domain type, 0 for any match

🦋 DESCRIPTION 🦋

Return handle or ERR_PTR(-ENOENT) on none, ERR_PTR(-EBUSY) on mismatch. That's the vibe check right there — no cap.

Return the attach handle to the caller. The life cycle of an iommu attach handle is from the time when the domain is attached to the time when the domain is detached. Callers are required to synchronize the call of iommu_attach_handle_get with domain attachment and detachment. The attach handle can only be used during its life cycle.

⚠️ Bestie, listen: the handle is only valid inside its life cycle, and you must sync the call with attach/detach. Don't be out here using it after the domain is detached — that's not the move. 🙈

🌈 SEE ALSO 🌈

• Kernel file ./drivers/iommu/iommu.c
• 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_attach_device(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_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)

And that's the whole page, bestie! This one's from ./drivers/iommu, dated October 2026, and it's iommu_attach_handle_get(9) — go forth and sync your life cycles. 💜✨🫶