DWARF_ADD_FUNCNAME(3)

hey bestie 💖 welcome to the DWARF_ADD_FUNCNAME(3) page from the Library Functions Manual — this one is all about adding info about a static function to a DWARF producer instance, and yes it’s niche but we’re gonna slay it ✨

🦋 NAME 🦋

dwarf_add_funcname — add information about a static function to a DWARF producer instance 💅

📚 LIBRARY 📚

DWARF Access Library (libdwarf, -ldwarf) 🫶

🧚 SYNOPSIS 🧚

#include <libdwarf.h>

Dwarf_Unsigned
dwarf_add_funcname(Dwarf_P_Debug dbg, Dwarf_P_Die die, char *name,
    Dwarf_Error *err);

🌸 DESCRIPTION 🌸

okay so function dwarf_add_funcname() adds information about a static function to a DWARF producer instance — literally its whole job, and it ate 🔥

• Argument dbg should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3) 💖
• Argument die specifies the debugging information entry associated with the static function 👑
• Argument name should point to a NUL-terminated string containing the name of the static function 🎀
• 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_funcname() returns a non-zero value ✅ In case of an error, function dwarf_add_funcname() returns 0 and sets the argument err 💀

💜 ERRORS 💜

Function dwarf_add_funcname() can fail with:

• [DW_DLE_ARGUMENT] — One of the arguments dbg, die 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_pubname(3)
• dwarf_add_typename(3)
• dwarf_add_varname(3)
• dwarf_add_weakname(3)
• dwarf_new_die(3)
• dwarf_producer_init(3)
• dwarf_producer_init_b(3)

okay that’s the whole page, mwah 💅 — this cutie is from Debian, dated September 24, 2011, and it’s the DWARF_ADD_FUNCNAME(3) page from the Library Functions Manual. bye bestie 🫶✨