device_get_next_child_node(9)

💖 NAME 💖

okay bestie, welcome to the Kernel API Manual — this is the page for device_get_next_child_node, and it's literally “Return the next child node handle for a device.” main character energy for real. ✨

✨ SYNOPSIS ✨

struct fwnode_handle * device_get_next_child_node (const struct device
       *dev , struct fwnode_handle *child );

🎀 ARGUMENTS 🎀

• dev — the device we're finding the next child node for. lowkey straightforward.
• child — a handle to one of the device's child nodes, or a NULL handle. no pressure. 🫶

🦋 DESCRIPTION 🦋

ngl, this one has a tiny gotcha. the caller is responsible for calling fwnode_handle_put on the returned fwnode pointer. also — and this is the important part — this function also puts a reference to child unconditionally. yes, unconditionally. periodt. 💅

🌈 SEE ALSO 🌈

Kernel file ./drivers/base/property.c, and the whole related bestie gang:

• device_property_present(9)
• fwnode_property_present(9)
• device_property_read_bool(9)
• fwnode_property_read_bool(9)
• device_property_read_u8_array(9)
• device_property_read_u16_array(9)
• device_property_read_u32_array(9)
• device_property_read_u64_array(9)
• device_property_read_string_array(9)
• device_property_read_string(9)
• device_property_match_string(9)
• fwnode_property_read_u8_array(9)
• fwnode_property_read_u16_array(9)
• fwnode_property_read_u32_array(9)
• fwnode_property_read_u64_array(9)
• fwnode_property_read_string_array(9)
• fwnode_property_read_string(9)
• fwnode_property_match_string(9)
• fwnode_property_match_property_string(9)
• fwnode_property_get_reference_args(9)
• fwnode_find_reference(9)
• fwnode_get_name(9)
• fwnode_get_name_prefix(9)
• fwnode_name_eq(9)
• fwnode_get_parent(9)
• fwnode_get_next_parent(9)
• fwnode_count_parents(9)
• fwnode_get_nth_parent(9)
• fwnode_get_next_child_node(9)
• fwnode_get_next_available_child_node(9)
• fwnode_get_named_child_node(9)
• device_get_named_child_node(9)
• fwnode_handle_get(9)
• fwnode_device_is_available(9)
• fwnode_get_child_node_count(9)
• fwnode_get_named_child_node_count(9)
• fwnode_get_phy_mode(9)
• device_get_phy_mode(9)
• fwnode_iomap(9)
• fwnode_irq_get(9)
• fwnode_irq_get_byname(9)
• fwnode_graph_get_next_endpoint(9)
• fwnode_graph_get_port_parent(9)
• fwnode_graph_get_remote_port_parent(9)
• fwnode_graph_get_remote_port(9)
• fwnode_graph_get_remote_endpoint(9)
• fwnode_graph_get_endpoint_by_id(9)
• fwnode_graph_get_endpoint_count(9)
• fwnode_graph_parse_endpoint(9)
• fwnode_connection_find_match(9)
• fwnode_connection_find_matches(9)

cute sign-off: source/version ./drivers/base, date October 2026, page device_get_next_child_node(9) — bye bestie! 💖💅✨