of_map_msi_id(9)

✨ NAME ✨

of_map_msi_id — Translate an ID using "msi-map" bindings. This is the of_map_msi_id(9) page from the Kernel API Manual, section 9, and yes bestie, we’re getting into it 💖

---

🌸 SYNOPSIS 🌸

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

---

💅 ARGUMENTS 💅

• np — root complex device node. That’s the starting point, the main character of this lookup 🔥
• id — Requester ID of the device (e.g. PCI RID/BDF or a platform stream/device ID) used as the lookup key in the msi-map table.
• filter_np — pointer to an optional filter node, or NULL to allow bypass. If non-NULL, the map property must exist (-ENODEV if absent). If *filter_np is also non-NULL, only entries targeting that node match.
• 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.

---

🦋 DESCRIPTION 🦋

Convenience wrapper around of_map_id using "msi-map", "#msi-cells", and "msi-map-mask". Lowkey just a cute little wrapper doing the translate thing, but the details matter, periodt 💜

---

🔥 RETURN 🔥

0 on success or a standard error code on failure. Short, sweet, iconic.

---

👑 SEE ALSO 👑

The og source file is ./drivers/of/base.c, and the whole SEE ALSO squad is right here — no skips, no cuts, full lineup 🌈

• 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_iommu_id(9)

---

Catch you in ./drivers/of — dated October 2026, page of_map_msi_id(9). Mwah 💋🎀