Manual Pages  — DWARF_GET_ARANGES

dwarf_get_aranges – retrieve program address space mappings

LIBRARY SYNOPSIS DESCRIPTION Memory Management RETURN VALUES EXAMPLES ERRORS SEE ALSO

DWARF Access Library (libdwarf, -ldwarf)

#include <libdwarf.h>

int
dwarf_get_aranges(Dwarf_Debug dbg, Dwarf_Arange **ar_list, Dwarf_Signed *ar_cnt, Dwarf_Error *err);

Function dwarf_get_aranges() returns DW_DLV_OK when it succeeds. It returns DW_DLV_NO_ENTRY if there is no ".debug_aranges" section associated with the specified debugging context. In case of an error, it returns DW_DLV_ERROR and sets the argument err.

To loop through all the address lookup table entries, use:

Dwarf_Debug dbg;
Dwarf_Addr start;
Dwarf_Arange *aranges;
Dwarf_Off die_off;
Dwarf_Signed i, cnt;
Dwarf_Unsigned length;
Dwarf_Error de;

if (dwarf_get_aranges(dbg, &aranges, &cnt, &de) != DW_DLV_OK)
        errx(EXIT_FAILURE, "dwarf_get_aranges: %s",
            dwarf_errmsg(de));

for (i = 0; i < cnt; i++) {
        if (dwarf_get_arange_info(aranges[i], &start, &length,
            &die_off, &de) != DW_DLV_OK) {
                warnx("dwarf_get_arange_info: %s",
                    dwarf_errmsg(de));
                continue;
        }
        /* Do something with the returned information. */
}

Function dwarf_get_aranges() can fail with:

[DW_DLE_ARGUMENT]	One of the arguments dbg, ar_list or ar_cnt was NULL.
[DW_DLE_NO_ENTRY]	The debugging context dbg did not contain a ".debug_aranges" string section.