Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dwarf_seterrhand(3) [freebsd man page]

DWARF_SETERRARG(3)					   BSD Library Functions Manual 					DWARF_SETERRARG(3)

NAME
dwarf_seterrarg, dwarf_seterrhand -- configure error handling LIBRARY
DWARF Access Library (libdwarf, -ldwarf) SYNOPSIS
#include <libdwarf.h> Dwarf_Ptr dwarf_seterrarg(Dwarf_Debug dbg, Dwarf_Ptr arg); Dwarf_Handler dwarf_seterrhand(Dwarf_Debug dbg, Dwarf_Handler handler); DESCRIPTION
These functions may be used by applications to configure error handling callbacks. The error handling scheme used by the library is described in dwarf(3). Function dwarf_seterrarg() may be used to set the callback argument passed to a configured error handler at the time it is invoked. Argument arg is the callback argument being set. Argument dbg can be a debug context allocated by a prior call to dwarf_init(3), or can be NULL to indicate that the library-wide callback argument is to be set. Function dwarf_seterrhand() may be used to associate an error handler denoted by argument handler with the DWARF debug context descriptor denoted by argument dbg. Argument dbg should be a debug context allocated by a prior call to dwarf_init(3), or may be NULL to indicate that the library-wide error handler is to be set. RETURN VALUES
Function dwarf_seterrhand() returns the previous error handler associated with argument dbg. If argument dbg is NULL, function dwarf_seterrhand() returns the previous library-wide error handler. Function dwarf_seterrarg() returns the previous callback argument associated with argument dbg. If argument dbg is NULL, function dwarf_seterrarg() returns the previous library-wide callback argument. COMPATIBILITY
The behavior of these functions when argument dbg is NULL is a local extension. ERRORS
These functions do not set an error code. SEE ALSO
dwarf(3), dwarf_init(3) BSD
May 01, 2010 BSD

Check Out this Related Man Page

DWARF_INIT(3)						   BSD Library Functions Manual 					     DWARF_INIT(3)

NAME
dwarf_init, dwarf_elf_init -- allocate a DWARF debug descriptor LIBRARY
DWARF Access Library (libdwarf, -ldwarf) SYNOPSIS
#include <libdwarf.h> int dwarf_init(int fd, int mode, Dwarf_Handler errhand, Dwarf_Ptr errarg, Dwarf_Debug *ret, Dwarf_Error *err); in dwarf_elf_init(Elf *elf, int mode, Dwarf_Handler errhand, Dwarf_Ptr errarg, Dwarf_Debug *ret, Dwarf_Error *err); DESCRIPTION
These functions allocate and return a Dwarf_Debug instance for the object denoted by argument fd or elf. This instance would be used for subsequent access to debugging information in the object by other functions in the DWARF(3) library. For function dwarf_init(), argument fd denotes an open file descriptor referencing a compilation object. Function dwarf_init() implicitly allocates an Elf descriptor for argument fd. For function dwarf_elf_init(), argument elf denotes a descriptor returned by elf_begin(3) or elf_memory(3). Argument mode specifies the access mode desired. It should be at least as permissive as the mode with which the file descriptor fd or the ELF descriptor elf was created with. Legal values for argument mode are: DW_DLC_RDWR Permit reading and writing of DWARF information. DW_DLC_READ Operate in read-only mode. DW_DLC_WRITE Permit writing of DWARF information. Argument errhand denotes a function to be called in case of an error. If this argument is NULL then a default error handling scheme is used. See dwarf(3) for a description of the error handling scheme used by the DWARF(3) library. Argument errarg is passed to the error handler function denoted by argument errhand when it is invoked. Argument ret points to the memory location that will hold a Dwarf_Debug reference on a successful call these functions. Argument err references a memory location that would hold a Dwarf_Error descriptor in case of an error. Memory Management The Dwarf_Debug instance returned by these functions should be freed using dwarf_finish(). RETURN VALUES
These functions return the following values: [DW_DLV_OK] This return value indicates a successful return. [DW_DLV_ERROR] The operation failed. [DW_DLV_NO_ENTRY] The object specified by arguments fd or elf did not contain debug information. IMPLEMENTATION NOTES
The current implementation does not support access modes DW_DLC_RDWR and DW_DLC_WRITE. EXAMPLES
To initialize a Dwarf_Debug instance from a open file descriptor referencing an ELF object, and with the default error handler, use: Dwarf_Error err; Dwarf_Debug dbg; if (dwarf_init(fd, DW_DLC_READ, NULL, NULL, &dbg, &err) != DW_DLV_OK) errx(EXIT_FAILURE, "dwarf_init: %s", dwarf_errmsg(err)); SEE ALSO
dwarf(3), dwarf_errmsg(3), dwarf_finish(3), dwarf_get_elf(3), elf_begin(3), elf_memory(3) BSD
November 9, 2011 BSD
Man Page