FreeBSD manual

download PDF document: dwarf_seterrarg.3.pdf

DWARF_SETERRARG(3) FreeBSD 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) FreeBSD 14.0-RELEASE-p6 May 1, 2010 FreeBSD 14.0-RELEASE-p6