dwarf_diename(3)

dwarf_diename3

Retrieve the name associated with a debugging information entry

Usage

#include <libdwarf.h>

int

dwarf_diename(Dwarf_Die die, char **ret_name, Dwarf_Error *err);

Library

library “libdwarf”

Overview

Function dwarf_diename() retrieves a pointer to the NUL-terminated string associated with the DW_AT_name attribute of the debugging information entry descriptor referenced by argument die. If the pointer was successfully retrieved, it is stored in the location pointed to by argument ret_name.

Return values

Function dwarf_diename() returns DW_DLV_OK on success.

If the debugging information entry descriptor denoted by argument die does not contain a DW_AT_name attribute, the function returns DW_DLV_NO_ENTRY and sets argument err. For other errors, it returns DW_DLV_ERROR and sets argument err.

Errors

Function dwarf_diename() can fail with the following errors:

[DW_DLE_ARGUMENT]

Either of arguments die or ret_name was NULL.

[DW_DLE_NO_ENTRY]

Argument die had no DW_AT_name attribute.

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.