NAME

dwarf_get_fde_instr_bytes —

retrieve instructions from FDE descritpor

LIBRARY

DWARF Access Library (libdwarf, -ldwarf)

SYNOPSIS

#include <libdwarf.h>

int
dwarf_get_fde_instr_bytes(Dwarf_Fde fde, Dwarf_Ptr *ret_inst, Dwarf_Unsigned *ret_len, Dwarf_Error *error);

DESCRIPTION

Function dwarf_get_fde_instr_bytes() retrieves instruction bytes from a given FDE descriptor.

Argument fde should reference a valid DWARF FDE descriptor.

Argument ret_inst should point to a location that will be set to a pointer to an array of bytes containing the instructions of the FDE descriptor.

Argument ret_len should point to a location that will hold the length in bytes of the instructions returned in argument ret_inst.

If argument err is not NULL, it will be used to store error information in case of an error.

Applications can use the function dwarf_expand_frame_instructions(3) to parse and expand the returned instruction bytes into an array of Dwarf_Frame_Op descriptors.

RETURN VALUES

Function dwarf_get_fde_instr_bytes() returns DW_DLV_OK when it succeeds. In case of an error, it returns DW_DLV_ERROR and sets the argument err.

ERRORS

Function dwarf_get_fde_instr_bytes() can fail with:

[DW_DLE_ARGUMENT]: One of the arguments fde, ret_inst or ret_len was NULL.