dwarf_get_section_max_offsets(3) [freebsd man page]
DWARF_GET_SECTION_MAX_OFFSETS LOCAL DWARF_GET_SECTION_MAX_OFFSETS NAME
dwarf_get_section_max_offsets, dwarf_get_section_max_offsets_b -- return the size of DWARF sections LIBRARY
DWARF Access Library (libdwarf, -ldwarf) SYNOPSIS
#include <libdwarf.h> int dwarf_get_section_max_offsets(Dwarf_Debug dbg, Dwarf_Unsigned *debug_info, Dwarf_Unsigned *debug_abbrev, Dwarf_Unsigned *debug_line, Dwarf_Unsigned *debug_loc, Dwarf_Unsigned *debug_aranges, Dwarf_Unsigned *debug_macinfo, Dwarf_Unsigned *debug_pubnames, Dwarf_Unsigned *debug_str, Dwarf_Unsigned *debug_frame, Dwarf_Unsigned *debug_ranges, Dwarf_Unsigned *debug_pubtypes); int dwarf_get_section_max_offsets_b(Dwarf_Debug dbg, Dwarf_Unsigned *debug_info, Dwarf_Unsigned *debug_abbrev, Dwarf_Unsigned *debug_line, Dwarf_Unsigned *debug_loc, Dwarf_Unsigned *debug_aranges, Dwarf_Unsigned *debug_macinfo, Dwarf_Unsigned *debug_pubnames, Dwarf_Unsigned *debug_str, Dwarf_Unsigned *debug_frame, Dwarf_Unsigned *debug_ranges, Dwarf_Unsigned *debug_pubtypes, Dwarf_Unsigned *debug_types); DESCRIPTION
Function dwarf_get_section_max_offsets_b() retrieves the sizes of the DWARF sections in a DWARF debug context. Argument dbg should reference a DWARF debug context allocated using dwarf_init(3). The function stores the size of each DWARF section to the location pointed to by the argument corresponding to the section name. If a DWARF section does not exist, the location pointed to by the argument corresponding to that section will be set to zero. A value of NULL may be used for any of the arguments debug_info, debug_abbrev, debug_line, debug_loc, debug_aranges, debug_macinfo, debug_pubnames, debug_str, debug_frame, debug_ranges, debug_pubtypes and debug_types if the caller is not interested in the respective sec- tion size. Function dwarf_get_section_max_offsets() is identical to function dwarf_get_section_max_offsets_b() except that it does not provide argument debug_types, and thus cannot return the size of the ``.debug_types'' section. RETURN VALUES
On success, these functions return DW_DLV_OK. If argument dbg is NULL, they return DW_DLV_ERROR. SEE ALSO
dwarf(3), dwarf_init(3) BSD
December 21, 2014 BSD
Check Out this Related Man Page
DWARF_NEXT_TYPES_SECTION(3) BSD Library Functions Manual DWARF_NEXT_TYPES_SECTION(3) NAME
dwarf_next_types_section -- step through .debug_types sections in a debug context LIBRARY
DWARF Access Library (libdwarf, -ldwarf) SYNOPSIS
#include <libdwarf.h> int dwarf_next_types_section(Dwarf_Debug dbg, Dwarf_Error *err); DESCRIPTION
Function dwarf_next_types_section() steps through the ``.debug_types'' sections found in a debug context. Argument dbg should reference a DWARF debug context allocated using dwarf_init(3). Argument err should point to a location that will hold an error descriptor in case of an error. When a DWARF debug context is allocated using dwarf_init(3), an internal pointer associated with the context will point to the first ``.debug_types'' section present in the debug object. When the application calls function dwarf_next_types_section(), this internal pointer will move to the next ``.debug_types'' section present. On stepping past the last ``.debug_types'' section left in the debug context, func- tion dwarf_next_types_section() returns DW_DLV_NO_ENTRY. The next call to the function will restart from the first ``.debug_types'' section in the debug context. Application code should call function dwarf_next_cu_header_c(3) to iterate though the type units associated with the current ``.debug_types'' section. RETURN VALUES
On success, function dwarf_next_types_section() returns DW_DLV_OK. In case of an error, it returns DW_DLV_ERROR and sets argument err. When there are no more ``.debug_types'' sections left to traverse, it returns DW_DLV_NO_ENTRY. COMPATIBILITY
This function is an extension to the DWARF(3) API. ERRORS
The dwarf_next_types_section() function may fail with the following errors: [DW_DLE_ARGUMENT] Argument dbg was NULL. EXAMPLES
To iterate though every type unit in all the ``.debug_types'' sections found in a debug context: Dwarf_Debug dbg; Dwarf_Sig8 sig8; Dwarf_Unsigned typeoff; Dwarf_Error de; ... allocate dbg using dwarf_init() etc ... do { while ((ret = dwarf_next_cu_header_c(dbg, 0, NULL, NULL, NULL, NULL, NULL, NULL, &sig8, &typeoff, NULL, &de)) == DW_DLV_OK) { /* Access DIEs etc ... */ } } while (dwarf_next_types_section(dbg, &de) == DW_DLV_OK); SEE ALSO
dwarf(3), dwarf_init(3), dwarf_next_cu_header_c(3) BSD
December 20, 2014 BSD