overlay_apply_node(9)

💖 overlay_apply_node(9) — the kernel API manual, bestie edition 💖

okay so we're diving into overlay_apply_node(9) today and honestly? this one's kind of the moment. it's the final merge step of the whole device tree overlay saga, and yes, the manual name is literally right there in the title, we're already iconic ✨

---

🌸 NAME 🌸

overlay_apply_node — Merges a node into the base device tree 🫶

---

✨ SYNOPSIS ✨

int overlay_apply_node (void *fdt , int target , void *fdto , int node
);

like, that's the whole vibe. four args, one int back. no cap.

---

🎀 ARGUMENTS 🎀

• fdt — Base Device Tree blob. this is the main character, the tree everything gets merged into 💅
• target — Node offset in the base device tree to apply the fragment to. basically "where we're dropping the goods" 📍
• fdto — Device tree overlay blob. the incoming chaos, the glow-up package 🦋
• node — Node offset in the overlay holding the changes to merge. the specific lil section of the overlay that's about to make its debut 🌟

---

🔥 DESCRIPTION 🔥

so overlay_apply_node merges a node into the target base device tree node it's pointed at. that's it, that's the job 💖

lowkey the lore here is that this is part of the final step in the device tree overlay application process — like, the last scene of the movie. by the time you get here, all the phandles have already been adjusted and resolved, and literally all that's left is to merge the overlay into the base device tree. everything's been prepped, the references are all sorted, and now we just… smoosh them together. periodt 🫶✨

ngl it's giving "finishing touch" energy and i'm obsessed.

---

👑 RETURN 👑

• 0 on success 🎉
• Negative error code on failure 😭 (bestie it failed, check your stuff)

---

💜 SEE ALSO 💜

• Kernel file ./scripts/dtc/libfdt/fdt_overlay.c — that's where the magic lives, go read it iykyk 📖
• 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_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_merge(9)
• overlay_symbol_update(9)

like, the whole friend group fr fr 💀🌈

---

⚠️ quick vibe check: this is the merge step, so it assumes everything upstream (phandle adjusting, resolving, all of it) already happened. don't skip ahead, bestie, the order matters 🙈

---

and that's the page!! this lil gem lives in ./scripts/dtc/libfdt, version dated October 2026, filed under the Kernel API Manual as overlay_apply_node(9) — go forth and merge responsibly, mwah 💋🎀🧚‍♀️