overlay_adj...cal_phandles(9)

💅 overlay_adjust_local_phandles — a Kernel API Manual moment

okay so bestie, welcome to the overlay_adjust_local_phandles(9) page, like, the actual kernel API manual entry, and no cap it's a good one 🎀

---

✨ NAME ✨

overlay_adjust_local_phandles — Adjust the phandles of a whole overlay 🦋

🌸 SYNOPSIS 🌸

int overlay_adjust_local_phandles (void *fdto , uint32_t delta );

🧚 ARGUMENTS 🧚

• fdto — the Device tree overlay blob, literally the whole overlay in blob form 💖
• delta — the Offset to shift the phandles of, like the amount you're nudging them by ✨

👑 DESCRIPTION 👑

so overlay_adjust_local_phandles adds a constant to all the phandles of an overlay. every single one. the whole squad gets the same little bump 💅

it's mainly use as part of the overlay application process, when we want to update all the overlay phandles to not conflict with the overlays of the base device tree. like, nobody wants their phandles beefing with the base tree's phandles, that's not the vibe, so we shift 'em all by the same constant and everyone lives in harmony 🌈

🔥 RETURN 🔥

• 0 on success — slay, we ate 👑
• Negative error code on failure — 😭 not the negative error code

💜 SEE ALSO 💜

the kernel file lives at ./scripts/dtc/libfdt/fdt_overlay.c and honestly the whole friend group is here:

• overlay_get_target_phandle(9)
• overlay_phandle_add_offset(9)
• overlay_adjust_node_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)

---

okay bestie that's the whole page, go adjust some phandles responsibly 💖✨

and the cute little sign-off: this icon lives in ./scripts/dtc/libfdt, dated October 2026, and yes the page title got abbreviated to overlay_adj...cal_phandles(9) because manpage headers said "we're not doing the full name today" 💀🫶