dwarf_seterrarg(3)

dwarf_seterrarg3

Configure error handling

Usage

#include <libdwarf.h>

Dwarf_Ptr

dwarf_seterrarg(Dwarf_Debug dbg, Dwarf_Ptr arg);

Dwarf_Handler

dwarf_seterrhand(Dwarf_Debug dbg, Dwarf_Handler handler);

Library

library “libdwarf”

Overview

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.

Releases

25 releases since FreeBSD 11.0-RELEASE; the text changed 1 time.

  1. 11.0–12.0
  2. 12.1–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.