of_parse_phandle(9)

✨ NAME ✨

of_parse_phandle — bestie, this is the one that resolves a phandle property into an actual device_node pointer 💅 (yes, we're in the of_parse_phandle(9) girlies, welcome to the Kernel API Manual, grab a seat 🎀)

🦋 SYNOPSIS 🦋

struct device_node * of_parse_phandle (const struct device_node *np ,
const char *phandle_name , int index );

🌸 ARGUMENTS 🌸

• np — a pointer to the device node that's holding the phandle property. like, the node you're snooping in 🫶
• phandle_name — the name of the property that's holding a phandle value. that's the label you're looking for, okurrr 💖
• index — so when a property holds a whole table of phandles, this is the index into that table. pick your slot, bestie ✨

👑 RETURN 👑

You get back a device_node pointer, and its refcount has been incremented. not me forgetting to release it 😭 — make sure you call of_node_put on it when you're done, periodt. no cap, that part is literally mandatory 💀

🌈 SEE ALSO 🌈

Kernel file ./include/linux/of.h — and like, the whole friend group:

• of_node_init(9)
• of_machine_is_compatible(9)
• of_parse_phandle_with_args(9)
• of_parse_phandle_with_fixed_args(9)
• of_parse_phandle_with_optional_args(9)
• of_phandle_args_equal(9)
• of_property_count_u8_elems(9)
• of_property_count_u16_elems(9)
• of_property_count_u32_elems(9)
• of_property_count_u64_elems(9)
• of_property_read_string_array(9)
• of_property_count_strings(9)
• of_property_read_string_index(9)
• of_property_present(9)
• of_property_read_u8_array(9)
• of_property_read_u16_array(9)
• of_property_read_u32_array(9)
• of_property_read_u64_array(9)
• struct of_changeset_entry(9)
• struct of_changeset(9)
• of_device_is_system_power_controller(9)
• of_have_populated_dt(9)

⭐ ok that's the whole page, you ate that ngl 💅 go forth and parse those phandles, main character 🧚

mwah 💜 this lil page lives in ./include/linux and it's stamped October 2026 — so go check it out in the Kernel API Manual, ily, bye bestie 🍓✨