DWARF_GET_FDE_RANGE(3)

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

💅 DWARF_GET_FDE_RANGE(3) 💅

okay so bestie, this is the DWARF_GET_FDE_RANGE(3) page from the Library Functions Manual, and it’s all about pulling range + offset info out of an FDE descriptor. yes, DWARF territory, but we’re doing this together 💖

✨ NAME ✨

dwarf_get_fde_range — retrieve range information from an FDE descriptor

🧚 LIBRARY 🧚

DWARF Access Library (libdwarf, -ldwarf)

🎀 SYNOPSIS 🎀

#include <libdwarf.h>

int
dwarf_get_fde_range(Dwarf_Fde fde, Dwarf_Addr *low_pc,
    Dwarf_Unsigned *func_len, Dwarf_Ptr *fde_bytes,
    Dwarf_Unsigned *fde_byte_len, Dwarf_Off *cie_offset,
    Dwarf_Signed *cie_index, Dwarf_Off *fde_offset, Dwarf_Error *err);

🌸 DESCRIPTION 🌸

Function dwarf_get_fde_range() retrieves range and offset information from a given FDE descriptor. here’s the whole cast of arguments, bestie:

  • fde — should reference a valid DWARF FDE descriptor. valid, okay? no nonsense 💅
  • low_pc — should point to a location that will be set to the lowest program counter address covered by the FDE descriptor.
  • func_len — should point to a location that will hold the length in bytes of the address range covered by the FDE descriptor.
  • fde_bytes — should point to a location that will be set to a pointer to the content of the FDE descriptor itself.
  • fde_byte_len — should point to a location that will hold the length in bytes of the FDE descriptor itself.
  • cie_offset — should point to a location that will be set to the offset, relative to the DWARF “.debug_frame” section, of the CIE descriptor associated with the given FDE descriptor.
  • cie_index — should point to a location that will hold the index of the CIE descriptor associated with the FDE descriptor. the returned value is a zero-based index into the array of CIE descriptors returned by a prior call to functions dwarf_get_fde_list(3) or dwarf_get_fde_list_eh(3).
  • fde_offset — should point to a location that will be set to the offset, relative to the DWARF “.debug_frame” section, of the FDE descriptor.
  • 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_fde_range() 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, 😭 when it doesn’t.

🍓 ERRORS 🍓

Function dwarf_get_fde_range() can fail with:

  • [DW_DLE_ARGUMENT] — One of the arguments fde, low_pc, func_len, fde_bytes, fde_byte_len, cie_offset, cie_index or fde_offset was NULL.

👑 SEE ALSO 👑

this page is from Debian and dated May 22, 2011 — mwah, bestie 💖

📦 where this page comes from