iommu_group_ref_get(9)
π iommu_group_ref_get β like, the manual page, but make it make sense π
okay so bestie, welcome to the Kernel API Manual entry for iommu_group_ref_get β yes that's a mouthful, yes it's iconic, and yes we're gonna get through it together π«Ά
β¨ NAME β¨
iommu_group_ref_get β increments the reference count on a group. that's it. that's the whole vibe. a little "+1 bestie" for your IOMMU group π
πΈ SYNOPSIS πΈ
struct iommu_group * iommu_group_ref_get (struct iommu_group *group );
like, it takes a group and hands it right back to you. main character energy fr fr π
π¦ ARGUMENTS π¦
groupβ the group you're working with, and just so we're clear: it must not be NULL. no cap, do not pass NULL here, that's not the move π
π DESCRIPTION π
so here's the tea β β this function gets called by iommu drivers when they wanna take additional references on a group that already exists. think of it as adding your name to the group chat so it doesn't get archived while you're still in it π
and the cute part? it returns the given group for convenience. like, "here's your group back, bestie, you're welcome" β¨ so you can chain it or whatever, slay.
π₯ SEE ALSO π₯
the lore lives in the kernel file ./drivers/iommu/iommu.c, and here's the whole friend group β every single one, no skips, we don't do that here π
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_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_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)
ngl the reference thing matters β extra references are how the group stays alive while drivers are still using it. increment responsibly, bestie π
okay that's the page!! sourced from ./drivers/iommu, dated October 2026, and it's part of the Kernel API Manual β mwah, go touch some code πππ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms