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.0 |