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_init(3),
dwarf_finish(3),
elf(3)