overlay_get_target_phandle(9)

💖 NAME 💖

overlay_get_target_phandle — retrieves the target phandle of a fragment. Welcome to the overlay_get_target_phandle(9) page from the Kernel API Manual, bestie — yes, we're literally in kernel device-tree-overlay land and it's giving main character energy. 🎀

---

🌸 SYNOPSIS 🌸

The whole call is literally this:

uint32_t overlay_get_target_phandle (const void *fdto , int fragment );

---

🦋 ARGUMENTS 🦋

Two arguments, both iconic in their own way:

• fdto — pointer to the device tree overlay blob 🫶
• fragment — node offset of the fragment in the overlay ✨

---

🎀 DESCRIPTION 🎀

Okay so overlay_get_target_phandle retrieves the target phandle of an overlay fragment when that fragment uses a phandle (the target property) instead of a path (the target-path property). That's the whole vibe — no cap, it's specifically about the target property versus the target-path property. 💅

---

💅 RETURN 💅

It's giving three possible returns, bestie:

• the phandle pointed by the target property 👑
• 0, if the phandle was not found
• -1, if the phandle was malformed 😭

---

🌈 SEE ALSO 🌈

Kernel file first, because the source is right there:

• Kernel file ./scripts/dtc/libfdt/fdt_overlay.c

And now the whole bestie lineup, fr fr:

• 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_one_phandle(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)

---

That's the whole page, bestie 🫶 This overlay_get_target_phandle(9) page came from source/version ./scripts/dtc/libfdt and is dated October 2026 — periodt. 💋