FreeBSD manual
download PDF document: dwarf_get_elf.3.pdf
DWARF_GET_ELF(3) FreeBSD 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)
FreeBSD 14.0-RELEASE-p11 November 9, 2011 FreeBSD 14.0-RELEASE-p11