dwarf_add_AT_dataref —
create an attribute descriptor for a relocatable
address
DWARF Access Library (libdwarf, -ldwarf)
#include
<libdwarf.h>
Dwarf_P_Attribute
dwarf_add_AT_dataref(
Dwarf_P_Debug
dbg,
Dwarf_P_Die die,
Dwarf_Half attr,
Dwarf_Unsigned pc_value,
Dwarf_Unsigned sym_index,
Dwarf_Error *err);
Function
dwarf_add_AT_dataref() creates an
attribute descriptor for a relocatable address and attaches it to the
debugging information entry referenced by argument
die.
If flag
DW_DLC_SIZE_64
is set, the address
value will be 8 bytes in size and of the DWARF form
DW_FORM_data8
. Otherwise, the address value
will be 4 bytes in size and of the DWARF form
DW_FORM_data4
.
Argument
dbg should reference a DWARF producer
instance allocated using
dwarf_producer_init(3)
or
dwarf_producer_init_b(3).
Argument
die should reference a debugging
information entry allocated using
dwarf_new_die(3).
Argument
attr specifies the attribute code of
the created attribute descriptor.
Argument
pc_value specifies the value of the
relocatable address.
Argument
sym_index specifies the ELF symbol
index of the 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_add_AT_dataref() returns
the created attribute descriptor. In case of an error, function
dwarf_add_AT_dataref() returns
DW_DLV_BADADDR
and sets the argument
err.
Function
dwarf_add_AT_dataref() can fail with:
-
-
- [
DW_DLE_ARGUMENT
]
- Either of the arguments
dbg or
die was NULL.
-
-
- [
DW_DLE_MEMORY
]
- An out of memory condition was encountered during the
execution of the function.
dwarf(3),
dwarf_add_AT_ref_address(3),
dwarf_add_AT_reference(3),
dwarf_add_AT_signed_const(3),
dwarf_add_AT_unsigned_const(3),
dwarf_new_die(3),
dwarf_producer_init(3),
dwarf_producer_init_b(3)