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

FreeBSD Manual Pages

  
 
  

home | help
DWARF_GET_FDE_INSTR_B... BSD Library Functions Manual DWARF_GET_FDE_INSTR_B...

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 de-
     scriptor.

     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.

SEE ALSO
     dwarf(3), dwarf_expand_frame_instructions(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_list(3),
     dwarf_get_fde_list_eh(3), dwarf_get_fde_n(3), dwarf_get_fde_range(3)

BSD				 May 23, 2011				   BSD

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_instr_bytes&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help