dwarf_add_pubname —
add information about a global object to a DWARF
producer instance
DWARF Access Library (libdwarf, -ldwarf)
#include
<libdwarf.h>
Dwarf_Unsigned
dwarf_add_pubname(
Dwarf_P_Debug
dbg,
Dwarf_P_Die die,
char *name,
Dwarf_Error *err);
Function
dwarf_add_pubname() adds information about
a global object to a DWARF producer instance.
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 global object.
Argument
name should point to a NUL-terminated
string containing the name of the global object.
If argument
err is not NULL, it will be used to
store error information in case of an error.
On success, function
dwarf_add_pubname() returns a
non-zero value. In case of an error, function
dwarf_add_pubname() returns 0 and sets the
argument
err.
Function
dwarf_add_pubname() 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.
dwarf(3),
dwarf_add_funcname(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)