freebsd man page for dwarf_get_fde_range

DWARF_GET_FDE_RANGE(3)					   BSD Library Functions Manual 				    DWARF_GET_FDE_RANGE(3)

NAME
     dwarf_get_fde_range -- retrieve range information from an FDE descriptor

LIBRARY
     DWARF Access Library (libdwarf, -ldwarf)

SYNOPSIS
     #include <libdwarf.h>

     int
     dwarf_get_fde_range(Dwarf_Fde fde, Dwarf_Addr *low_pc, Dwarf_Unsigned *func_len, Dwarf_Ptr *fde_bytes, Dwarf_Unsigned *fde_byte_len,
	 Dwarf_Off *cie_offset, Dwarf_Signed *cie_index, Dwarf_Off *fde_offset, Dwarf_Error *err);

DESCRIPTION
     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.

SEE ALSO
     dwarf(3), dwarf_get_cie_info(3), dwarf_get_cie_index(3), dwarf_get_cie_of_fde, dwarf_get_fde_at_pc(3), dwarf_get_fde_info_for_all_regs(3),
     dwarf_get_fde_info_for_all_regs3(3), dwarf_get_fde_info_for_cfa_reg3(3), dwarf_get_fde_info_for_reg(3), dwarf_get_fde_info_for_reg3(3),
     dwarf_get_fde_instr_bytes(3), dwarf_get_fde_list(3), dwarf_get_fde_list_eh(3), dwarf_get_fde_n(3)

BSD
								   May 22, 2011 							       BSD