of_find_mat...de_and_match(9)

🌸 NAME 🌸

hey bestie, welcome to the Kernel API Manual page for of_find_matching_node_and_match — yes, the header abbreviates it as of_find_mat...de_and_match(9), but we are spelling it all the way out 💅. It does one iconic thing: find a node based on an of_device_id match table. periodt.

✨ SYNOPSIS ✨

struct device_node * of_find_matching_node_and_match (struct device_node
*from , const struct of_device_id *matches , const struct of_device_id
**match );

🎀 ARGUMENTS 🎀

• from — the node to start searching from, or NULL. The node you pass will not be searched — only the next one will. Typically, you pass what the previous call returned. of_node_put will be called on it. bestie, that cleanup detail matters 🫶
• matches — array of of device match structures to search in. this is the match-table squad you're checking against ✨
• match — updated to point at the matches entry which matched. slay, now you know which one hit 💖

🦋 RETURN 🦋

A node pointer with refcount incremented — use of_node_put on it when done. do the cleanup, no cap 🧚

💅 SEE ALSO 💅

okay so the related squad is huge, and every single one is section 9; also peep the kernel file ./drivers/of/base.c:

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

mwah 💋 — source/version: ./drivers/of, date: October 2026, for of_find_mat...de_and_match(9). that's the whole page, bestie; go be the main character of your device tree 🌈👑