DWARF_GET_CIE_INDEX(3)

💅 DWARF_GET_CIE_INDEX 💅

okay so this whole page lives in the Library Functions Manual and it's all about dwarf_get_cie_index from the DWARF Access Library — yes bestie, libdwarf, and you link it with -ldwarf. let's get into it ✨

---

🎀 NAME 🎀

dwarf_get_cie_index — the function that retrieves the index of a CIE descriptor. that's the whole vibe, that's the job 🫶

📚 LIBRARY 📚

DWARF Access Library — libdwarf, -ldwarf. she's iconic, she's linked in with -ldwarf, periodt.

✨ SYNOPSIS ✨

#include <libdwarf.h>

int
dwarf_get_cie_index(Dwarf_Cie cie, Dwarf_Signed *cie_index,
    Dwarf_Error *err);

💖 DESCRIPTION 💖

okay so here's what dwarf_get_cie_index() does: it retrieves the zero-based index of a given CIE descriptor, inside the array of CIE descriptors that the functions dwarf_get_fde_list(3) and dwarf_get_fde_list_eh(3) hand back to you. zero-based, so the first one is 0, not 1 — don't come for me, that's just how it is 💀

the argument cie should reference a valid DWARF CIE descriptor. like, an actual valid one. that's the vibe check it has to pass.

and the argument cie_index should point to a location that will hold the returned index. that's where the answer lands, bestie 🎯

🔥 RETURN VALUES 🔥

when it succeeds, dwarf_get_cie_index() returns DW_DLV_OK. slay.

but 😭 if something goes wrong, it returns DW_DLV_ERROR and sets the argument err. so yeah, check your err, always check your err.

💀 ERRORS 💀

function dwarf_get_cie_index() can fail with:

• [DW_DLE_ARGUMENT] — either of the arguments cie or cie_index was NULL. literally either one. don't pass NULL, it's giving chaos 🙈

🌈 SEE ALSO 🌈

dwarf(3), dwarf_get_cie_info(3), dwarf_get_cie_of_fde(3), dwarf_get_fde_list(3), dwarf_get_fde_list_eh(3) — go read those next, iykyk 👑

---

and that's the page, bestie 💅 this lil masterpiece is from Debian, dated May 22, 2011 — yes, she's an elder icon and she still ate. mwah 🎀✨