DWARF_END_MACRO_FILE(3)

💖 NAME 💖

Hey bestie, welcome to the DWARF_END_MACRO_FILE(3) page! 💅 This is all about dwarf_end_macro_file — the function that marks the end of the current source file inclusion. Slay, closure is important. ✨

📚 LIBRARY 📚

DWARF Access Library (libdwarf, -ldwarf) 🫶

✨ SYNOPSIS ✨

#include <libdwarf.h>

int
dwarf_end_macro_file(Dwarf_P_Debug dbg, Dwarf_Error *err);

🌸 DESCRIPTION 🌸

Function dwarf_end_macro_file() marks the end of the current source file inclusion. That's the whole vibe — it's giving "we're done with this included source file now," and honestly, iconic. 🎀

Argument dbg should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3). No random dbg impostors, okay? Main character energy only. 👑

If argument err is not NULL, it will be used to store error information in case of an error. So if things go sideways, err is ready to spill the tea. 😭

🔥 RETURN VALUES 🔥

On success, function dwarf_end_macro_file() returns DW_DLV_OK. Periodt. 💚

In case of an error, function dwarf_end_macro_file() returns DW_DLV_ERROR and sets the argument err. Not the happy ending, but at least err tells you what happened. 💀

🙈 ERRORS 🙈

Function dwarf_end_macro_file() can fail with:

• [DW_DLE_ARGUMENT] — Argument dbg was NULL. Literally no dbg? Bestie. 😭
• [DW_DLE_MEMORY] — An out of memory condition was encountered during the execution of the function. The memory said "not today." 💀

🦋 SEE ALSO 🦋

dwarf(3), dwarf_def_macro(3), dwarf_producer_init(3), dwarf_producer_init_b(3), dwarf_start_macro_file(3), dwarf_undef_macro(3), dwarf_vendor_ext(3)

okay bye bestie 🫶 — this cutie came from Debian, dated September 25, 2011, and it's the DWARF_END_MACRO_FILE(3) page. periodt 💅