of_map_iommu_id(9)

✨ NAME ✨

okay bestie, welcome to this lil’ page from the Kernel API Manual for of_map_iommu_id(9) 💖

of_map_iommu_id — translate an ID using "iommu-map" bindings. periodt.

---

🦋 SYNOPSIS 🦋

int of_map_iommu_id (const struct device_node *np , u32 id , struct
       of_phandle_args *arg );

---

🎀 ARGUMENTS 🎀

• np — root complex device node. that’s the starting point, bestie 🌸
• id — Requester ID of the device (e.g. PCI RID/BDF or a platform stream/device ID) used as the lookup key in the iommu-map table. it’s giving “find me in the map” energy 🔥
• arg — pointer to a struct of_phandle_args for the result. On success, arg->args_count will be set to the number of output specifier cells and arg->args[0..args_count-1] will contain the translated output specifier values. If a map entry was matched, arg->np holds a reference to the target node that the caller must release with of_node_put. 👑

bestie, if arg->np gets set, that reference is yours to release with of_node_put. no leaking, fr fr 💅

---

🌈 DESCRIPTION 🌈

Convenience wrapper around of_map_id using "iommu-map", "#iommu-cells", and "iommu-map-mask". lowkey iconic, highkey useful 🦋

---

⭐ RETURN ⭐

0 on success or a standard error code on failure. simple as that, no cap ✨

---

💜 SEE ALSO 💜

• Kernel file ./drivers/of/base.c
• of_find_all_nodes(9)
• __of_device_is_compatible(9)
• of_machine_compatible_match(9)
• of_machine_read_compatible(9)
• of_machine_read_model(9)
• of_machine_get_match(9)
• of_machine_get_match_data(9)
• __of_device_is_available(9)
• __of_device_is_reserved(9)
• of_device_is_available(9)
• __of_device_is_fail(9)
• of_device_is_big_endian(9)
• of_get_parent(9)
• of_get_next_parent(9)
• of_get_next_child(9)
• of_get_next_child_with_prefix(9)
• of_get_next_available_child(9)
• of_get_next_reserved_child(9)
• of_get_next_cpu_node(9)
• of_get_compatible_child(9)
• of_get_child_by_name(9)
• of_get_available_child_by_name(9)
• of_find_node_opts_by_path(9)
• of_find_node_by_name(9)
• of_find_node_by_type(9)
• of_find_compatible_node(9)
• of_find_node_with_property(9)
• of_match_node(9)
• of_find_matching_node_and_match(9)
• of_alias_from_compatible(9)
• of_find_node_by_phandle(9)
• of_parse_phandle_with_args_map(9)
• of_count_phandle_with_args(9)
• __of_add_property(9)
• of_add_property(9)
• of_remove_property(9)
• of_alias_scan(9)
• of_alias_get_id(9)
• of_alias_get_highest_id(9)
• of_console_check(9)
• of_find_next_cache_node(9)
• of_find_last_cache_level(9)
• of_map_id(9)
• of_map_msi_id(9)

---

okay that’s the whole page, bestie — source/version ./drivers/of, date October 2026. slay and bye 💅✨