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

FreeBSD Manual Pages

  
 
  

home | help
DWARF_GET_ARANGE(3)	 BSD Library Functions Manual	   DWARF_GET_ARANGE(3)

NAME
     dwarf_get_arange -- retrieve the address range descriptor for an address

LIBRARY
     DWARF Access Library (libdwarf, -ldwarf)

SYNOPSIS
     #include <libdwarf.h>

     int
     dwarf_get_arange(Dwarf_Arange *ar_list, Dwarf_Unsigned ar_cnt,
	 Dwarf_Addr addr, Dwarf_Arange *ret_ar,	Dwarf_Error *err);

DESCRIPTION
     Function dwarf_get_arange() searches an array of Dwarf_Arange descriptors
     for one that covers a given address.

     Argument ar_list should point to an array of Dwarf_Arange descriptors.

     Argument ar_cnt specifies the number of Dwarf_Arange descriptors in the
     array pointed to by argument ar_list.

     Argument addr specifies the address being looked up.

     Argument ret_ar will be used to store the Dwarf_Arange descriptor that
     covers the	given address.

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

RETURN VALUES
     Function dwarf_get_arange() returns DW_DLV_OK when	it succeeds.  It re-
     turns DW_DLV_NO_ENTRY if there is no Dwarf_Arange descriptor that covers
     the provided address.  In case of an error, it returns DW_DLV_ERROR and
     sets the argument err.

ERRORS
     Function dwarf_get_arange() can fail with:

     [DW_DLE_ARGUMENT]	One of the arguments dbg, ar_list or ret_ar was	NULL.

     [DW_DLE_ARGUMENT]	Value of argument ar_cnt equals	to 0.

     [DW_DLE_NO_ENTRY]	A Dwarf_Arange descriptor that covers the given	ad-
			dress was not found.

SEE ALSO
     dwarf(3), dwarf_get_aranges(3), dwarf_get_arange_cu_header_offset(3),
     dwarf_get_arange_info(3), dwarf_get_cu_die_offset(3)

BSD				April 16, 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_arange&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help