dwarf_add_typename(3)

dwarf_add_typename3

Add information about a user-defined type to a dwarf producer instance

Usage

#include <libdwarf.h>

Dwarf_Unsigned

dwarf_add_typename(Dwarf_P_Debug dbg, Dwarf_P_Die die, char *name, Dwarf_Error *err);

Library

library “libdwarf”

Overview

Function dwarf_add_typename() adds information about a user-defined type to a DWARF producer instance.

Argument dbg should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3).

Argument die specifies the debugging information entry associated with the user-defined type.

Argument name should point to a NUL-terminated string containing the name of the user-defined type.

If argument err is not NULL, it will be used to store error information in case of an error.

Return values

On success, function dwarf_add_typename() returns a non-zero value. In case of an error, function dwarf_add_typename() returns 0 and sets the argument err.

Errors

Function dwarf_add_typename() can fail with:

[DW_DLE_ARGUMENT]

One of the arguments dbg, die or name was NULL.

[DW_DLE_MEMORY]

An out of memory condition was encountered during the execution of the function.

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.