dwarf_lne_set_address —
set the base address for line number
information
DWARF Access Library (libdwarf, -ldwarf)
#include
<libdwarf.h>
Dwarf_Unsigned
dwarf_lne_set_address(
Dwarf_P_Debug
dbg,
Dwarf_Addr off,
Dwarf_Unsigned symndx,
Dwarf_Error *err);
Function
dwarf_lne_set_address() sets the base
address used by subsequent invocations of the
dwarf_add_line_entry(3)
function.
Argument
dbg should reference a DWARF producer
instance allocated using
dwarf_producer_init(3)
or
dwarf_producer_init_b(3).
Argument
off specifies a relocatable program
address.
Argument
symndx specifies the index of the ELF
symbol to be used for relocation.
If argument
err is not NULL, it will be used to
store error information in case of an error.
On success, function
dwarf_lne_set_address()
returns
DW_DLV_OK
. In case of an error,
function
dwarf_lne_set_address() returns
DW_DLV_NOCOUNT
and sets the argument
err.
Function
dwarf_lne_set_address() can fail with:
-
-
- [
DW_DLE_ARGUMENT
]
- Argument dbg was
NULL.
-
-
- [
DW_DLE_ARGUMENT
]
- The argument symndx had an
illegal value.
-
-
- [
DW_DLE_MEMORY
]
- An out of memory condition was encountered during the
execution of the function.
dwarf(3),
dwarf_add_directory_decl(3),
dwarf_add_file_decl(3),
dwarf_add_line_entry(3),
dwarf_lne_end_sequence(3),
dwarf_producer_init(3),
dwarf_producer_init_b(3)