of_find_node_by_phandle(9)

💖 NAME 💖

Okay so bestie, this is the of_find_node_by_phandle(9) page from the Kernel API Manual, section 9. The vibe? Literally: of_find_node_by_phandle — Find a node given a phandle. No cap, that's the whole assignment. 🎀

✨ SYNOPSIS ✨

struct device_node * of_find_node_by_phandle (phandle handle );

🌸 ARGUMENTS 🌸

• handle — the phandle of the node to find. That's it, that's the arg, iykyk 💅

🦋 RETURN 🦋

A node pointer with refcount incremented, use of_node_put on it when done. Bestie, this part is important: when you're done with it, use of_node_put on it. Don't leave that refcount hanging, fr fr. 🫶

Not me reminding you again: refcount incremented means you've gotta call of_node_put when you're finished with the node.

💜 SEE ALSO 💜

Not me dropping the entire SEE ALSO roster, because every single reference is iconic and none are getting left behind 💅✨:

• 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_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)

Cute sign-off time: source/version shoutout to ./drivers/of, dated October 2026, and yes, this is the of_find_node_by_phandle(9) page. Periodt. 🫶✨🌈