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

FreeBSD Manual Pages

  
 
  

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

NAME
     dwarf_formexprloc -- return information about a location expression

LIBRARY
     DWARF Access Library (libdwarf, -ldwarf)

SYNOPSIS
     #include <libdwarf.h>

     int
     dwarf_formexprloc(Dwarf_Attribute attr, Dwarf_Unsigned *retlen,
	 Dwarf_Ptr *retexpr, Dwarf_Error *err);

DESCRIPTION
     Function dwarf_formexprloc() allows an application	to retrieve the	length
     and the bytes of a	DWARF location expression.

     Argument attr should reference a DWARF attribute of the form
     DW_FORM_exprloc.  Argument	retlen should point to a location that will be
     set to the	length of the location expression.  Argument retexpr should
     point to a	location that will be set to a pointer to the content of the
     location expression itself.

     If	argument err is	not NULL, it will be used to return an error descrip-
     tor in case of an error.

   Memory Management
     The application should not	attempt	to free	the memory area	referenced by
     the pointer returned in argument retexpr.

RETURN VALUES
     Function dwarf_formexprloc() returns DW_DLV_OK on success.	 In case of an
     error, it returns DW_DLV_ERROR and	sets argument err.

ERRORS
     Function dwarf_formexprloc() may fail with	the following errors:

     [DW_DLE_ARGUMENT]	     One of arguments attr, retlen or retexpr was
			     NULL.

     [DW_DLE_ATTR_FORM_BAD]  The attribute referenced by argument attr was not
			     of	form DW_FORM_exprloc.

SEE ALSO
     dwarf(3), dwarf_attr(3), dwarf_formblock(3), dwarf_formflag(3),
     dwarf_formref(3), dwarf_formsdata(3), dwarf_formsig8(3),
     dwarf_formstring(3), dwarf_formudata(3), dwarf_hasattr(3)

BSD				 July 25, 2010				   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_formexprloc&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help