dwarf_get_fde_range3

Usage

Library

library “libdwarf”

Overview

Function dwarf_get_fde_range() retrieves range and offset information from a given FDE descriptor.

Argument fde should reference a valid DWARF FDE descriptor.

Argument low_pc should point to a location that will be set to the lowest program counter address covered by the FDE descriptor.

Argument func_len should point to a location that will hold the length in bytes of the address range covered by the FDE descriptor.

Argument fde_bytes should point to a location that will be set to a pointer to the content of the FDE descriptor itself.

Argument fde_byte_len should point to a location that will hold the length in bytes of the FDE descriptor itself.

Argument cie_offset should point to a location that will be set to the offset, relative to the DWARF “.debug_frame” section, of the CIE descriptor associated with the given FDE descriptor.

Argument cie_index should point to a location that will hold the index of the CIE descriptor associated with the FDE descriptor. The returned value is a zero-based index into the array of CIE descriptors returned by a prior call to functions dwarf_get_fde_list(3) or dwarf_get_fde_list_eh(3).

Argument fde_offset should point to a location that will be set to the offset, relative to the DWARF “.debug_frame” section, of the FDE descriptor.

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

Return values

Function dwarf_get_fde_range() 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_range() can fail with:

[DW_DLE_ARGUMENT]

One of the arguments fde, low_pc, func_len, fde_bytes, fde_byte_len, cie_offset, cie_index or fde_offset was NULL.