DWARF_ADD_DIRECTORY_DECL(3)

💖 DWARF_ADD_DIRECTORY_DECL(3) 💖

okay so this is the DWARF_ADD_DIRECTORY_DECL(3) page from the Library Functions Manual, and we are getting into it 💅

---

🌸 NAME 🌸

dwarf_add_directory_decl — add a directory name to a producer instance ✨

🦋 LIBRARY 🦋

DWARF Access Library (libdwarf, -ldwarf) 💖

✨ SYNOPSIS ✨

#include <libdwarf.h>

Dwarf_Unsigned
dwarf_add_directory_decl(Dwarf_P_Debug dbg, char *name,
    Dwarf_Error *err);

🎀 DESCRIPTION 🎀

Function dwarf_add_directory_decl() adds a source directory name to a producer instance and returns the index value generated for the directory name. slay, that’s the whole vibe 💫

Argument dbg should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3).

Argument name should point a NUL-terminated string containing the name of the directory.

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_directory_decl() returns the index value generated for the directory. In case of an error, function dwarf_add_directory_decl() returns DW_DLV_NOCOUNT and sets the argument err.

💀 ERRORS 💀

Function dwarf_add_directory_decl() can fail with:

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

🌈 SEE ALSO 🌈

• dwarf(3)
• dwarf_add_file_decl(3)
• dwarf_add_line_entry(3)
• dwarf_lne_end_sequence(3)
• dwarf_lne_set_address(3)
• dwarf_producer_init(3)
• dwarf_producer_init_b(3)

---

💖 cute little sign-off: this page’s footer points to source/version Debian, dated September 17, 2011. stay iconic, bestie 🫶✨