DWARF_LNE_END_SEQUENCE(3)

💖 NAME 💖

okay bestie, welcome to the DWARF_LNE_END_SEQUENCE(3) page from the Library Functions Manual — and the name is literally the whole assignment: set the end of instruction sequence. periodt. ✨

---

🦋 LIBRARY 🦋

This one lives in the DWARF Access Library — that’s libdwarf, -ldwarf, no cap. 🫶

---

🌸 SYNOPSIS 🌸

#include <libdwarf.h>

Dwarf_Unsigned
dwarf_lne_end_sequence(Dwarf_P_Debug dbg, Dwarf_Addr addr,
    Dwarf_Error *err);

---

✨ DESCRIPTION ✨

okay so dwarf_lne_end_sequence() sets the address that marks the end of a sequence of target machine instructions. it’s giving “closing time” energy for an instruction sequence. 💅

Argument dbg should reference a DWARF producer instance allocated using dwarf_producer_init(3) or dwarf_producer_init_b(3). like, that’s the required vibe. 🎀

Argument addr specifies an address value that is the first byte after the end of an instruction sequence. very precise, very demure. 🦋

If argument err is not NULL, it will be used to store error information in case of an error. bestie, that’s your little error bucket. 🍓

---

🔥 RETURN VALUES 🔥

On success, dwarf_lne_end_sequence() returns DW_DLV_OK. slay. ✅

In case of an error, dwarf_lne_end_sequence() returns DW_DLV_NOCOUNT and sets the argument err. so if it’s not giving success, check err. 😭

---

💀 ERRORS 💀

Function dwarf_lne_end_sequence() can fail with:

• [DW_DLE_ARGUMENT] — Argument dbg was NULL.
• [DW_DLE_ARGUMENT] — The value in argument addr overlapped an existing line information entry.
• [DW_DLE_MEMORY] — An out of memory condition was encountered during the execution of the function.

---

👑 SEE ALSO 👑

go read these too, bestie, iykyk:

• dwarf(3)
• dwarf_add_directory_decl(3)
• dwarf_add_file_decl(3)
• dwarf_add_line_entry(3)
• dwarf_lne_set_address(3)
• dwarf_producer_init(3)
• dwarf_producer_init_b(3)

---

💖 Debian, September 15, 2011, DWARF_LNE_END_SEQUENCE(3) — source/version + date, signed off with a bow. 🎀