overlay_fixup_one_phandle(9)

💖 overlay_fixup_one_phandle(9) — Kernel API Manual 💖

okay bestie, you opened the overlay_fixup_one_phandle(9) page and honestly? it's giving “tiny but important kernel helper” energy. no cap, this one is all about fixing up one phandle so it points where it's supposed to. let's get into it 🫶

✨ NAME ✨

overlay_fixup_one_phandle — Set an overlay phandle to the base one 💅

🌸 SYNOPSIS 🌸

int overlay_fixup_one_phandle (void *fdto , int symbols_off , const char
       *path , uint32_t path_len , const char *name , uint32_t name_len , int
       poffset , uint32_t phandle );

🎀 ARGUMENTS 🎀

• fdto — Device tree overlay blob 🦋
• symbols_off — Node offset of the symbols node in the base device tree ✨
• path — Path to a node holding a phandle in the overlay 🌈
• path_len — number of path characters to consider 🔢
• name — Name of the property holding the phandle reference in the overlay 🏷️
• name_len — number of name characters to consider 🔢
• poffset — Offset within the overlay property where the phandle is stored 📍
• phandle — Phandle referencing the node 👑

🦋 DESCRIPTION 🦋

overlay_fixup_one_phandle resolves an overlay phandle pointing to a node in the base device tree. literally its whole job, and it ate 💅

This is part of the device tree overlay application process, when you want all the phandles in the overlay to point to the actual base dt nodes. think of it as the matchmaker that makes the overlay's phandle look at the real base node — but fr fr, that's the process it belongs to 🧚

⭐ RETURN ⭐

• 0 on success 🎉
• Negative error code on failure 😭

💜 SEE ALSO 💜

• Kernel file ./scripts/dtc/libfdt/fdt_overlay.c 📁
• overlay_get_target_phandle(9)
• overlay_phandle_add_offset(9)
• overlay_adjust_node_phandles(9)
• overlay_adjust_local_phandles(9)
• overlay_update_local_node_references(9)
• overlay_update_local_references(9)
• overlay_fixup_phandle(9)
• overlay_fixup_phandles(9)
• overlay_adjust_local_conflicting_phandle(9)
• overlay_update_node_conflicting_references(9)
• overlay_update_local_conflicting_references(9)
• overlay_prevent_phandle_overwrite_node(9)
• overlay_prevent_phandle_overwrite(9)
• overlay_apply_node(9)
• overlay_merge(9)
• overlay_symbol_update(9)

xoxo, your local manpage 🎀 — this one came from ./scripts/dtc/libfdt, dated October 2026, and it's all about overlay_fixup_one_phandle(9) 💖