Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DWARF_GET_FDE_RANGE(3) FreeBSD 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 descrip-
     tor 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 descrip-
     tor.

     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_index(3), dwarf_get_cie_info(3),
     dwarf_get_cie_of_fde(3), 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)

FreeBSD	13.0			 May 22, 2011			  FreeBSD 13.0

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dwarf_get_fde_range&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help