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

FreeBSD Manual Pages

  
 
  

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

NAME
     dwarf_add_AT_targ_address,	dwarf_add_AT_targ_address_b -- create and at-
     tach address class	attributes

LIBRARY
     DWARF Access Library (libdwarf, -ldwarf)

SYNOPSIS
     #include <libdwarf.h>

     Dwarf_P_Attribute
     dwarf_add_AT_targ_address(Dwarf_P_Debug dbg, Dwarf_P_Die die,
	 Dwarf_Half attr, Dwarf_Unsigned pc_value, Dwarf_Signed	sym_index,
	 Dwarf_Error *err);

     Dwarf_P_Attribute
     dwarf_add_AT_targ_address_b(Dwarf_P_Debug dbg, Dwarf_P_Die	die,
	 Dwarf_Half attr, Dwarf_Unsigned pc_value, Dwarf_Unsigned sym_index,
	 Dwarf_Error *err);

DESCRIPTION
     Function dwarf_add_AT_targ_address_b() creates an attribute descriptor
     belonging to the `address'	class and attaches it to the debugging infor-
     mation entry referenced by	argument die.

     The created attribute descriptor will have	DWARF form DW_FORM_addr.  If
     flag DW_DLC_SIZE_64 is set	on the producer	instance, the attribute	value
     will be 8 bytes in	size.  Otherwise the attribute value will be 4 bytes
     in	size.

     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 us-
     ing dwarf_new_die(3).

     Argument attr should specify the attribute	code of	the created attribute
     descriptor.

     Argument pc_value should hold a relocatable address value which will be-
     come the value of the created attribute descriptor.

     Argument sym_index	should specify the ELF symbol index of the symbol to
     be	used for relocating the	address	value.

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

     Function dwarf_add_AT_targ_address() is deprecated.  It is	similar	to
     function dwarf_add_AT_targ_address_b() except that	it cannot handle all
     possible symbol index values.

RETURN VALUES
     On	success, these functions return	the created attribute descriptor.  In
     case of an	error, these functions return DW_DLV_BADADDR and sets the ar-
     gument err.

ERRORS
     These functions 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 exe-
			cution.

SEE ALSO
     dwarf(3), dwarf_add_AT_const_value_unsignedint(3),
     dwarf_add_AT_dataref(3), dwarf_add_AT_ref_address(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)

BSD			       September 4, 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_add_AT_targ_address&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help