DWARF_NEW_FDE(3)

💖 NAME 💖

dwarf_new_fde — allocate a DWARF frame descriptor. Okay bestie, this is DWARF_NEW_FDE(3) from the Library Functions Manual, and it's all about spinning up a shiny new frame descriptor. 💅

📚 LIBRARY 📚

DWARF Access Library (libdwarf, -ldwarf) — that's the library vibe, no cap. 🫶

✨ SYNOPSIS ✨

#include <libdwarf.h>

Dwarf_P_Fde
dwarf_new_fde(Dwarf_P_Debug dbg, Dwarf_Error *err);

🌸 DESCRIPTION 🌸

Function dwarf_new_fde() allocates a new DWARF frame descriptor. It's giving "fresh descriptor just dropped" energy. ✨

Argument dbg should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3). That's the required setup, fr fr.

If argument err is not NULL, it will be used to store error information in case of an error. So if you pass an error pointer, it's ready to catch the bad vibes. 💖

🫶 RETURN VALUES 🫶

On success, function dwarf_new_fde() returns the newly created frame descriptor. Slay. 👑

In case of an error, function dwarf_new_fde() returns DW_DLV_BADADDR and sets the argument err. So yeah, DW_DLV_BADADDR is the "nope" return, and err gets the tea. 😭

💀 ERRORS 💀

Function dwarf_new_fde() can fail with:

• [DW_DLE_ARGUMENT] — Argument dbg was NULL. Literally the producer pointer didn't show up to the function. 🙈
• [DW_DLE_MEMORY] — An out of memory condition was encountered during the execution of the function. Not the vibe, bestie. 💀

🌈 SEE ALSO 🌈

Okay bestie, go peek at these:

• dwarf(3)
• dwarf_add_fde_inst(3)
• dwarf_add_frame_cie(3)
• dwarf_add_frame_fde(3)
• dwarf_add_frame_fde_b(3)
• dwarf_fde_cfa_offset(3)

All the related manual pages are right there. 💜

---

Okay that's the whole page, periodt. Mwah 💋 — this one's from Debian, dated September 24, 2011, and the page is DWARF_NEW_FDE(3). 🎀