| DWARF_GET_GLOBALS(3) | Library Functions Manual | DWARF_GET_GLOBALS(3) |
dwarf_get_globals,
dwarf_global_cu_offset,
dwarf_global_die_offset,
dwarf_global_name_offsets,
dwarf_globname —
#include <libdwarf.h>
int
dwarf_get_globals(Dwarf_Debug
dbg, Dwarf_Global **globals,
Dwarf_Signed *nglobals, Dwarf_Error
*err);
int
dwarf_global_cu_offset(Dwarf_Global
global, Dwarf_Off *cu_offset,
Dwarf_Error *err);
int
dwarf_global_die_offset(Dwarf_Global
global, Dwarf_Off *die_offset,
Dwarf_Error *err);
int
dwarf_global_name_offsets(Dwarf_Global
global, char **name, Dwarf_Off
*die_offset, Dwarf_Off *cu_die_offset,
Dwarf_Error *err);
int
dwarf_globname(Dwarf_Global
global, char **name, Dwarf_Error
*err);
Function dwarf_get_globals() retrieves
descriptors for all the global symbols associated with the DWARF debug
context specified by argument dbg. The argument
globals should point to a location that will be set to
a pointer to an array of Dwarf_Global descriptors. The
argument nglobals should point to a location that will
be set to the number of descriptors returned.
Function dwarf_global_cu_offset() returns
the section-relative offset, relative to the “.debug_info”
section, of the compilation unit that contains the debugging information
entry associated with the argument global. Argument
cu_offset should point to a location that will hold
the returned offset.
Function dwarf_global_die_offset()
retrieves the section-relative offset, relative to the
“.debug_info” section, of the debugging information entry
associated with the argument global, and stores it
into the location pointed to by the argument
die_offset.
Function dwarf_global_name_offsets()
retrieves the name and the offsets for the debugging information entry for
argument global. Argument name
should point to a location which will be set to a pointer to a
NUL-terminated string containing the name of the associated debugging
information entry. Argument die_offset should point to
a location which will be set to a section-relative offset, relative to the
“.debug_info” section, of the associated debugging information
entry. Argument cu_die_offset should point to a
location which will be set to a section-relative offset, relative to the
“.debug_info” section, of the first debugging information
entry in the compilation unit associated with argument
global.
Function dwarf_globname() sets the
location pointed to by argument name to a pointer to a
NUL-terminated string holding the name of the debugging information entry
associated with the argument global.
dwarf_get_globals() is owned by the
DWARF Access Library (libdwarf, -ldwarf). Application
code should not attempt to directly free this pointer. Portable code should
instead use the function
dwarf_globals_dealloc(3)
to indicate that the memory area may be freed.
The memory area used for the string returned in the
name argument to functions
dwarf_globname() and
dwarf_global_name_offsets() is owned by the
DWARF Access Library (libdwarf, -ldwarf). Portable
code should use the
dwarf_dealloc(3)
function to indicate that the memory area may be freed.
DW_DLV_OK. In case
of an error, they return DW_DLV_ERROR and set the
argument err.
DW_DLE_ARGUMENT]| April 2, 2011 | NetBSD 9.3 |