Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dwarf_next_types_section(3) [freebsd 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

Check Out this Related Man Page

DWARF_GET_STR(3)					   BSD Library Functions Manual 					  DWARF_GET_STR(3)

NAME
dwarf_get_str -- retrieve a string from the DWARF string section LIBRARY
DWARF Access Library (libdwarf, -ldwarf) SYNOPSIS
#include <libdwarf.h> int dwarf_get_str(Dwarf_Debug dbg, Dwarf_Off offset, char **string, Dwarf_Signed *len, Dwarf_Error *err); DESCRIPTION
Function dwarf_get_str() retrieves a NUL-terminated string from the DWARF string section ``.debug_str''. Argument dbg should reference a DWARF debug context allocated using dwarf_init(3). Argument offset should be an offset, relative to the ``.debug_str'' section, specifying the start of the desired string. Argument string should point to a location which will hold a returned pointer to a NUL-terminated string. Argument len should point to a location which will hold the length of the returned string. The returned length does not include the space needed for the NUL-terminator. If argument err is not NULL, it will be used to store error information in case of an error. RETURN VALUES
Function dwarf_get_str() returns DW_DLV_OK when it succeeds. It returns DW_DLV_NO_ENTRY if there is no ``.debug_str'' section associated with the specified debugging context, or if the provided offset offset is at the very end of ``.debug_str'' section. In case of an error, it returns DW_DLV_ERROR and sets the argument err. ERRORS
Function dwarf_get_str() can fail with: [DW_DLE_ARGUMENT] One of the arguments dbg, string or len was NULL. [DW_DLE_ARGUMENT] Argument offset was out of range. [DW_DLE_NO_ENTRY] The debugging context dbg did not contain a ``.debug_str'' string section. [DW_DLE_NO_ENTRY] Argument offset was at the very end of the ``.debug_str'' section. EXAMPLE
To retrieve all the strings in the DWARF string section, use: Dwarf_Debug dbg; Dwarf_Off offset; Dwarf_Signed len; Dwarf_Error de; char *str; int ret offset = 0; while ((ret = dwarf_get_str(dbg, offset, &str, &len, &de)) == DW_DLV_OK) { /* .. Use the retrieved string. .. */ offset += len + 1; /* Account for the terminating NUL. */ } if (ret == DW_DLV_ERROR) warnx("dwarf_get_str: %s", dwarf_errmsg(de)); SEE ALSO
dwarf(3), dwarf_init(3) BSD
April 3, 2011 BSD
Man Page