DWARF_ADD_AT_COMP_DIR(3)

💖 DWARF_ADD_AT_COMP_DIR(3) 💖

okay bestie, this is the DWARF_ADD_AT_COMP_DIR(3) page from the Library Functions Manual, and it’s honestly giving “tiny function, very important job” energy 💅✨

🌸 NAME 🌸

dwarf_add_AT_comp_dir — create and attach a DW_AT_comp_dir attribute 🎀

🌈 LIBRARY 🌈

It’s the DWARF Access Library (libdwarf, -ldwarf) — yes, that’s the library situation, no cap 🫶

⭐ SYNOPSIS ⭐

#include <libdwarf.h>

Dwarf_P_Attribute
dwarf_add_AT_comp_dir(Dwarf_P_Die die, char *dir, Dwarf_Error *err);

🦋 DESCRIPTION 🦋

Function dwarf_add_AT_comp_dir() creates a DW_AT_comp_dir attribute descriptor and attaches it to the debugging information entry referenced by argument die. The created attribute will have DWARF form DW_FORM_strp. ✨

Argument die should reference a debugging information entry allocated using dwarf_new_die(3). 👑

Argument dir should point to a NUL-terminated string which will become the value of the created attribute. 🍓

If argument err is not NULL, it will be used to store error information in case of an error. 💜

💀 RETURN VALUES 💀

On success, function dwarf_add_AT_comp_dir() returns the created attribute descriptor. 😭💖 In case of an error, function dwarf_add_AT_comp_dir() returns DW_DLV_BADADDR and sets the argument err. 🫶

🔥 ERRORS 🔥

Function dwarf_add_AT_comp_dir() can fail with:

• [DW_DLE_ARGUMENT] — either of the arguments die or dir was NULL.
• [DW_DLE_MEMORY] — an out of memory condition was encountered during the execution of the function.

🧚 SEE ALSO 🧚

Go peek at these besties, iykyk:

• dwarf(3)
• dwarf_add_AT_const_value_string(3)
• dwarf_add_AT_name(3)
• dwarf_add_AT_producer(3)
• dwarf_add_AT_string(3)
• dwarf_new_die(3)

---

later, bestie — this cutie is from the Debian edition, dated September 4, 2011 💖🎀🫶