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

FreeBSD Manual Pages

  
 
  

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

NAME
     dwarf_get_elf -- retrieve the Elf descriptor associated with a
     Dwarf_Debug instance

LIBRARY
     DWARF Access Library (libdwarf, -ldwarf)

SYNOPSIS
     #include <libdwarf.h>

     int
     dwarf_get_elf(Dwarf_Debug dbg, Elf	**elf, Dwarf_Error *err);

DESCRIPTION
     Function dwarf_get_elf() returns the Elf descriptor associated with a
     Dwarf_Debug instance.

     Argument dbg should be a handle to	a valid	Dwarf_Debug instance returned
     by	a prior	call to	dwarf_init(3) or dwarf_elf_init(3).

     Argument elf points a location into which a handle	to an Elf descriptor
     will be written.

     Argument err is used to record error information in case of failure.

RETURN VALUES
     On	success, function dwarf_get_elf() returns DW_DLV_OK.  In case of an
     error, it returns DW_DLV_ERROR and	sets argument err.

EXAMPLES
     To	retrieve the Elf instance associated with a Dwarf_Debug	instance use:

	   Dwarf_Debug dbg;
	   Dwarf_Error de;
	   Elf *elf;

	   ... allocate	dbg using dwarf_init() etc ...

	   if (dwarf_get_elf(dbg, &elf,	&de) !=	DW_DLV_OK)
		   errx(EXIT_FAILURE, "dwarf_get_elf: %s", dwarf_errmsg(de));

SEE ALSO
     dwarf(3), dwarf_errmsg(3),	dwarf_finish(3), dwarf_init(3),	elf(3)

BSD			       November	9, 2011				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dwarf_get_elf&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help