DWARF_DIE_LINK(3)

DWARF_DIE_LINK(3) 💅✨

okay so this is the Library Functions Manual page for dwarf_die_link, and it's lowkey iconic because it's all about linking debugging information entries together. bestie, gather round. 🫶

---

🌸 NAME 🌸

dwarf_die_link — link a debugging information entry

📚 LIBRARY 📚

DWARF Access Library (libdwarf, -ldwarf)

🛠️ SYNOPSIS 🛠️

#include <libdwarf.h>

Dwarf_P_Die
dwarf_die_link(Dwarf_P_Die die, Dwarf_P_Die parent, Dwarf_P_Die child,
    Dwarf_P_Die left, Dwarf_P_Die right, Dwarf_Error *err);

💖 DESCRIPTION 💖

dwarf_die_link() is the function that links debugging information entries together. no cap, that's the whole vibe. 🦋

• die — this is the debugging information entry you're updating. it's the main character here. 👑
• parent — this sets the new parent link for the debugging information entry.
• child — this sets the new first child link for the debugging information entry.
• left — this sets the new left sibling link for the debugging information entry.
• right — this sets the new right sibling link for the debugging information entry.

🚨 okay bestie, this is important: only one of parent, child, left and right is allowed to be non-NULL. don't be out here passing more than one non-NULL link. fr fr.

Existing links to parent, child, left or right debugging information entries — if there are any — will be unlinked before the specified link is established. so it's not stacking links, it's clearing the old one first. 💅

If err is not NULL, it will be used to store error information in case of an error. you love to see it. 🙈

🎀 RETURN VALUES 🎀

On success, dwarf_die_link() returns the debugging information entry provided in argument die. slay. ✨

In case of an error, dwarf_die_link() returns DW_DLV_BADADDR and sets the argument err. 😭

💀 ERRORS 💀

dwarf_die_link() can fail with:

• [DW_DLE_ARGUMENT] — Argument die was NULL.
• [DW_DLE_ARGUMENT] — More than one of the arguments parent, child, left and right were non-NULL.

👀 SEE ALSO 👀

• dwarf(3)
• dwarf_add_die_to_debug(3)
• dwarf_new_die(3)

---

xoxo, Debian 💖 September 4, 2011 💖 DWARF_DIE_LINK(3)