DWARF_GET_CU_DIE_OFFSET(3)

💖 NAME 💖

This is DWARF_GET_CU_DIE_OFFSET(3), bestie — straight outta the Library Functions Manual — and the actual main characters are dwarf_get_arange_cu_header_offset and dwarf_get_cu_die_offset, aka your retrieve-compilation-unit-offsets besties. 💅

📚 LIBRARY 📚

DWARF Access Library (libdwarf, -ldwarf) — your DWARF-access home base, periodt. 🫶

✨ SYNOPSIS ✨

#include <libdwarf.h>

int
dwarf_get_arange_cu_header_offset(Dwarf_Arange ar, Dwarf_Off *ret,
    Dwarf_Error *err);

int
dwarf_get_cu_die_offset(Dwarf_Arange ar, Dwarf_Off *ret,
    Dwarf_Error *err);

🦋 DESCRIPTION 🦋

Okay so these functions are literally here to retrieve the offsets — relative to the .debug_info DWARF section — of the debugging information entries describing the compilation unit associated with a Dwarf_Arange descriptor. Iconic. ✨

Function dwarf_get_arange_cu_header_offset() retrieves the offset of the compilation unit header associated with argument ar, and stores it in the location pointed to by argument ret. Slay. 💅

Function dwarf_get_cu_die_offset() retrieves the offset of the debugging information entry for the compilation unit associated with argument ar, and stores it in the location pointed to by argument ret. Also slay. 🌸

If argument err is not NULL, these functions will use it to store error information, in case of an error. Noted, bestie. 🫶

🌈 RETURN VALUES 🌈

On success, these functions return DW_DLV_OK. In case of an error, they return DW_DLV_ERROR and set the argument err. That's the whole vibe check. ✅

🎀 ERRORS 🎀

These functions may fail with:

• [DW_DLE_ARGUMENT] — Argument ar was not a valid Dwarf_Arange descriptor.
• [DW_DLE_ARGUMENT] — Argument ret was NULL.

Not me showing up with a bad descriptor or a NULL ret — that's a hard no, bestie. 💀

🔥 SEE ALSO 🔥

• dwarf(3)
• dwarf_get_arange(3)
• dwarf_get_arange_info(3)
• dwarf_get_aranges(3)

Source/version: Debian; date: April 10, 2011; page: DWARF_GET_CU_DIE_OFFSET(3). Byeee! 💋✨