tail head cat sleep
QR code linking to this page

Manual Pages  — DWARF_GET_ELF

NAME

dwarf_get_elf – retrieve the Elf descriptor associated with a Dwarf_Debug instance

CONTENTS

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;

amp;... 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)

DWARF_GET_ELF (3) November 9, 2011

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

Computer science would have progressed much further and faster if all of the time and effort that has been spent maintaining and nurturing Unix had been spent on a sounder operating system.
— The Unix Haters' handbook