Manual Pages  — DWARF_GET_FDE_LIST

dwarf_get_fde_list – retrieve frame information

LIBRARY SYNOPSIS DESCRIPTION Memory Management RETURN VALUES EXAMPLES ERRORS SEE ALSO

DWARF Access Library (libdwarf, -ldwarf)

#include <libdwarf.h>

int
dwarf_get_fde_list(Dwarf_Debug dbg, Dwarf_Cie **cie_list, Dwarf_Signed *cie_count, Dwarf_Fde **fde_list, Dwarf_Signed *fde_count, Dwarf_Error *err);

int
dwarf_get_fde_list_eh(Dwarf_Debug dbg, Dwarf_Cie **cie_list, Dwarf_Signed *cie_count, Dwarf_Fde **fde_list, Dwarf_Signed *fde_count, Dwarf_Error *err);

On success, these functions returns DW_DLV_OK. They return DW_DLV_NO_ENTRY if there is no frame information associated with the given DWARF debug context. In case of an error, they return DW_DLV_ERROR and set the argument err.

To obtain frame information from the ".debug_frame" section, use:

Dwarf_Debug dbg;
Dwarf_Cie *cie_list, cie;
Dwarf_Fde *fde_list, fde;
Dwarf_Off fde_offset, cie_offset;
Dwarf_Unsigned func_len, fde_length, fde_instlen;
Dwarf_Signed cie_count, fde_count, cie_index;
Dwarf_Addr low_pc;
Dwarf_Ptr fde_addr, fde_inst, cie_inst;
Dwarf_Error de;
int i;

if (dwarf_get_fde_list(dbg, &cie_list, &cie_count,
    &fde_list, &fde_count, &de) != DW_DLV_OK) {
        errx(EXIT_FAILURE, "dwarf_get_fde_list failed: %s",
            dwarf_errmsg(de));
}

for (i = 0; i < fde_count; i++) {
        if (dwarf_get_fde_n(fde_list, i, &fde, &de) != DW_DLV_OK) {
                warnx("dwarf_get_fde_n failed: %s",
                    dwarf_errmsg(de));
                continue;
        }
        if (dwarf_get_cie_of_fde(fde, &cie, &de) != DW_DLV_OK) {
                warnx("dwarf_get_fde_n failed: %s",
                    dwarf_errmsg(de));
                continue;
        }
        if (dwarf_get_fde_range(fde, &low_pc, &func_len, &fde_addr,
            &fde_length, &cie_offset, &cie_index, &fde_offset,
            &de) != DW_DLV_OK) {
                warnx("dwarf_get_fde_range failed: %s",
                    dwarf_errmsg(de));
                continue;
        }
        if (dwarf_get_fde_instr_bytes(fde, &fde_inst, &fde_instlen,
            &de) != DW_DLV_OK) {
                warnx("dwarf_get_fde_instr_bytes failed: %s",
                    dwarf_errmsg(de));
                continue;
        }

        /* ... Use the retrieved frame information ... */
}

/* Indicate that the returned arrays may be freed. */
dwarf_fde_cie_list_dealloc(dbg, cie_list, cie_count, fde_list,
    fde_count);

These functions may fail with the following errors:

[DW_DLE_ARGUMENT]	One of the arguments dbg, cie_list, cie_count, fde_list or fde_count was NULL.
[DW_DLE_NO_ENTRY]	There is no frame information associated with the giving DWARF debug context.