DWARF_ADD_AT_LOCATION_EXPR(3)

🌸 NAME — dwarf_add_AT_location_expr 🌸

Hii bestie, welcome to the DWARF Access Library manual, section 3 — the libdwarf / -ldwarf one. This page is literally about dwarf_add_AT_location_expr — it creates an attribute descriptor for a location expression. Slay. 💅

---

📚 LIBRARY 📚

DWARF Access Library (libdwarf, -ldwarf).

---

✨ SYNOPSIS ✨

#include <libdwarf.h>

Dwarf_P_Attribute
dwarf_add_AT_location_expr(Dwarf_P_Debug dbg, Dwarf_P_Die die,
    Dwarf_Half attr, Dwarf_P_Expr loc_expr, Dwarf_Error *err);

---

💖 DESCRIPTION 💖

Okay so dwarf_add_AT_location_expr() creates an attribute descriptor for a location expression and attaches it to the debugging information entry referenced by argument die. Iconic behavior, no cap.

Here's the vibe check on the arguments:

• dbg — should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3).
• die — should reference a debugging information entry allocated using dwarf_new_die(3).
• attr — specifies the attribute code of the created attribute descriptor.
• loc_expr — should reference a location expression descriptor allocated using dwarf_new_expr(3).

The attribute created by dwarf_add_AT_location_expr() will have one of the DWARF forms DW_FORM_block, DW_FORM_block1, DW_FORM_block2 or DW_FORM_block4, depending on the size of the byte stream generated by the location expression descriptor referenced by argument loc_expr. It's giving "form chosen by byte-stream size realness" 💫

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

---

🦋 RETURN VALUES 🦋

On success, dwarf_add_AT_location_expr() returns the created attribute descriptor. Bestie ate and left no crumbs. 💅

In case of an error, dwarf_add_AT_location_expr() returns DW_DLV_BADADDR and sets the argument err. 😭

---

🎀 ERRORS 🎀

dwarf_add_AT_location_expr() can fail with:

• [DW_DLE_ARGUMENT] — one of the arguments dbg, die or loc_expr was NULL.
• [DW_DLE_MEMORY] — an out of memory condition was encountered during the execution of the function.

---

🌈 SEE ALSO 🌈

dwarf(3), dwarf_new_die(3), dwarf_new_expr(3), dwarf_producer_init(3), dwarf_producer_init_b(3)

---

K bye bestie 💖 — this little manual-page moment came from Debian, dated September 5, 2011, and its whole handle is DWARF_ADD_AT_LOCATION_EXPR(3). 🎀