DWARF_ADD_AT_STRING(3)

💖 DWARF_ADD_AT_STRING(3) 💖

okay so bestie, welcome to the DWARF_ADD_AT_STRING(3) page from the Library Functions Manual — it’s giving “tiny function, very important string attribute energy” and we’re gonna get through it together, fr fr. 🫶

---

✨ NAME ✨

dwarf_add_AT_string — create and attach a string class attribute. slay. 🎀

🌸 LIBRARY 🌸

DWARF Access Library (libdwarf, -ldwarf) — yes, that’s the one, no cap. 💅

🦋 SYNOPSIS 🦋

#include <libdwarf.h>

Dwarf_P_Attribute
dwarf_add_AT_string(Dwarf_P_Debug dbg, Dwarf_P_Die die, Dwarf_Half attr,
    char *str, Dwarf_Error *err);

💜 DESCRIPTION 💜

Okay so here’s the vibe: dwarf_add_AT_string() creates an attribute descriptor that belongs to the ‘string’ class, and attaches it to the debugging information entry referenced by the die argument. ✨ The created attribute descriptor will have DWARF form DW_FORM_strp — periodt. 💅

Here’s the bestie breakdown of the arguments:

• dbg should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3). 🫶
• die should reference a debugging information entry allocated using dwarf_new_die(3). 🌟
• attr should specify the attribute code for the created attribute descriptor. 🎀
• str should hold a pointer to a NUL-terminated string which will become the value of the created attribute descriptor. 🍓
• If err is not NULL, it will be used to store error information in case of an error. 👑

🔥 RETURN VALUES 🔥

On success, dwarf_add_AT_string() returns the created attribute descriptor. Iconic. 👑

In case of an error, dwarf_add_AT_string() returns DW_DLV_BADADDR and sets the argument err. Not the glow-up we wanted, but that’s the rule. 💀

💀 ERRORS 💀

dwarf_add_AT_string() can fail with:

• [DW_DLE_ARGUMENT] — one of the arguments dbg, die or str 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_const_value_string(3)
• dwarf_add_AT_name(3)
• dwarf_new_die(3)
• dwarf_producer_init(3)
• dwarf_producer_init_b(3)

---

and that’s the whole page, bestie — signing off from Debian, September 4, 2011, with all the string-attribute sparkle we could possibly fit. 💖✨🎀🦋