DWARF_ADD_AT_DATAREF(3)

👑 DWARF_ADD_AT_DATAREF(3) 👑

okay so welcome to the DWARF_ADD_AT_DATAREF(3) page — yes bestie, it’s a section 3 page from the Library Functions Manual, and we’re about to make a relocatable-address attribute descriptor together. no cap, it’s giving very specific DWARF producer energy. 💅

---

🌸 NAME 🌸

dwarf_add_AT_dataref — create an attribute descriptor for a relocatable address

✨ LIBRARY ✨

DWARF Access Library (libdwarf, -ldwarf)

🦋 SYNOPSIS 🦋

#include <libdwarf.h>

Dwarf_P_Attribute
dwarf_add_AT_dataref(Dwarf_P_Debug dbg, Dwarf_P_Die die,
    Dwarf_Half attr, Dwarf_Unsigned pc_value, Dwarf_Unsigned sym_index,
    Dwarf_Error *err);

💖 DESCRIPTION 💖

Function dwarf_add_AT_dataref() creates an attribute descriptor for a relocatable address and attaches it to the debugging information entry referenced by argument die. literally its whole main character moment. ✨

If flag DW_DLC_SIZE_64 is set, the address value will be 8 bytes in size and of the DWARF form DW_FORM_data8. Otherwise, the address value will be 4 bytes in size and of the DWARF form DW_FORM_data4. so cute, so size-dependent. 🎀

• dbg — this argument should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3). 🫶
• die — this argument should reference a debugging information entry allocated using dwarf_new_die(3). 🧚
• attr — specifies the attribute code of the created attribute descriptor. iconic little code moment. 👑
• pc_value — specifies the value of the relocatable address. 📍
• sym_index — specifies the ELF symbol index of the symbol to be used for relocation. 🔥
• err — if this argument is not NULL, it will be used to store error information in case of an error. 🙈

🎀 RETURN VALUES 🎀

On success, function dwarf_add_AT_dataref() returns the created attribute descriptor. In case of an error, function dwarf_add_AT_dataref() returns DW_DLV_BADADDR and sets the argument err. periodt. 💀

🌈 ERRORS 🌈

Function dwarf_add_AT_dataref() can fail with:

• [DW_DLE_ARGUMENT] — Either of the arguments dbg or die was NULL.
• [DW_DLE_MEMORY] — An out of memory condition was encountered during the execution of the function.

💜 SEE ALSO 💜

• dwarf(3)
• dwarf_add_AT_ref_address(3)
• dwarf_add_AT_reference(3)
• dwarf_add_AT_signed_const(3)
• dwarf_add_AT_unsigned_const(3)
• dwarf_new_die(3)
• dwarf_producer_init(3)
• dwarf_producer_init_b(3)

---

mwah 💋 this page comes from Debian, dated September 4, 2011, and it’s the DWARF_ADD_AT_DATAREF(3) manual page — bye bestie! 🫶