DWARF_GET_ARANGE(3) | Library Functions Manual | DWARF_GET_ARANGE(3) |
dwarf_get_arange
—
#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);
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.
dwarf_get_arange
() returns
DW_DLV_OK
when it succeeds. It returns
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.
dwarf_get_arange
() can fail with:
DW_DLE_ARGUMENT
]DW_DLE_ARGUMENT
]DW_DLE_NO_ENTRY
]April 16, 2011 | NetBSD 9.2 |