DWARF_ADD_AT_NAME(3)

✨ NAME ✨

okay so welcome to the DWARF_ADD_AT_NAME(3) page, bestie — this is one of those Library Functions Manual situations (libdwarf girlies rise 🫶), and the function in question is dwarf_add_AT_name — it creates and attaches a DW_AT_name attribute 💅

🎀 LIBRARY 🎀

DWARF Access Library — and you link it with -ldwarf, no cap ✨

🦋 SYNOPSIS 🦋

#include <libdwarf.h>

Dwarf_P_Attribute
dwarf_add_AT_name(Dwarf_P_Die die, char *name, Dwarf_Error *err);

🌸 DESCRIPTION 🌸

So here's the tea ☕: dwarf_add_AT_name() does two things in one iconic move — it creates a DW_AT_name attribute descriptor, and then attaches it to the debugging information entry that die points at. And the created attribute is gonna have DWARF form DW_FORM_strp. that's just how it is, periodt 💖

Quick vibe check on the args:

• die — this one should reference a debugging information entry that was allocated using dwarf_new_die(3). like, don't just make one up out of nowhere, bestie 😭
• name — should point to a NUL-terminated string, and that string becomes the value of the created attribute. that's literally the whole job 🎀
• err — if it's not NULL, it gets used to store error information in case of an error. if it is NULL, well, she's not keeping receipts 🙈

👑 RETURN VALUES 👑

On success — slay 💅 — dwarf_add_AT_name() returns the created attribute descriptor.

In case of an error, she returns DW_DLV_BADADDR and sets the argument err. so at least you'll know 💀

🔥 ERRORS 🔥

Function dwarf_add_AT_name() can fail with:

• [DW_DLE_ARGUMENT] — one of the arguments die or name was NULL. yeah, that'll do it 😭
• [DW_DLE_MEMORY] — an out of memory condition was encountered during the execution of this function. lowkey the worst vibe 🌧️

💜 SEE ALSO 💜

dwarf(3), dwarf_add_AT_comp_dir(3), dwarf_add_AT_const_value_string(3), dwarf_add_AT_producer(3), dwarf_add_AT_string(3), dwarf_new_die(3) — go read the whole friend group, iykyk ✨

and that's the page, bestie 🫶 this one's from Debian, dated September 4, 2011, and it's DWARF_ADD_AT_NAME(3) — mwah, go write some debug info 💖🎀🌸