DWARF_GET_CIE_INFO(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1, nixpkgs unstable

🌸 NAME 🌸

okay so bestie, this is DWARF_GET_CIE_INFO(3) from the Library Functions Manual, and it's highkey serving pure CIE-descriptor info retrieval. The function is dwarf_get_cie_info — retrieve information associated with a CIE descriptor. ✨

🫶 LIBRARY 🫶

DWARF Access Library (libdwarf, -ldwarf) 💖

🔥 SYNOPSIS 🔥

#include <libdwarf.h>

int
dwarf_get_cie_info(Dwarf_Cie cie, Dwarf_Unsigned *cie_byte_len,
    Dwarf_Small *version, char **augmentation, Dwarf_Unsigned *caf,
    Dwarf_Unsigned *daf, Dwarf_Half *ra, Dwarf_Ptr *init_inst,
    Dwarf_Unsigned *inst_len, Dwarf_Error *err);

💅 DESCRIPTION 💅

Function dwarf_get_cie_info() retrieves the information associated with a given CIE descriptor. It's giving "tell me everything about this CIE", and we love that for us. 🦋

Here's the group chat breakdown of every argument:

  • cie — should reference a valid DWARF CIE descriptor, such as would be returned by function dwarf_get_cie_of_fde(3). 👑
  • cie_byte_len — should point to a location that will hold the length in bytes of the CIE descriptor itself. 🎀
  • version — should point to a location that will hold the version number of the CIE descriptor. ⭐
  • augmentation — should point to a location that will be set to a pointer to a NUL-terminated string containing augmentation data encoded as UTF-8. 🌈
  • caf — should point to a location that will hold the code alignment factor recorded in the CIE descriptor. 🔥
  • daf — should point to a location that will hold the data alignment factor recorded in the CIE descriptor. 🍓
  • ra — should point to a location that will hold the return address recorded in the CIE descriptor. 💜
  • init_inst — should point to a location that will be set to a pointer to an array of bytes containing the initial instructions associated with the CIE descriptor. 🧚
  • inst_len — should point to a location that will hold the length in bytes of the initial instructions returned in argument init_inst. ✨
  • err — if argument err is not NULL, it will be used to store error information in case of an error. 💀

😭 RETURN VALUES 😭

Function dwarf_get_cie_info() returns DW_DLV_OK when it succeeds. In case of an error, it returns DW_DLV_ERROR and sets the argument err. slay when it works, error tea when it doesn't. 💖

🙈 ERRORS 🙈

Function dwarf_get_cie_info() can fail with:

  • [DW_DLE_ARGUMENT] — One of the arguments cie, cie_byte_len, version, augmentation, caf, daf, ra, init_inst or inst_len was NULL.
bestie, if any one of those required pointers is NULL, it's a no from the function. 🫶

👑 SEE ALSO 👑

xoxo, bestie 💋 — source/version: Debian; date: May 29, 2011. periodt. 🎀

📦 where this page comes from