DwarfCfi

Documentation

API Reference

DwarfCfi

Description

Parsed .eh_frame index. CIEs are de-duplicated; FDEs each point at their CIE by offset. eh_frame_base is the runtime address that pc-relative encodings in .eh_frame are relative to (= the section’s load address); we record the file-relative form, so DwarfCfi-consuming callers should pass already-file-relative PCs.

Usage example (Cross-references)

Usage examples (Cross-references)

In SymbolResolver.h:93:

        bool       sidecar_dwarf_ok;
        // Lazily-parsed .eh_frame for the CFI-based unwinder.
        DwarfCfi cfi;
        bool     cfi_built;
        bool     cfi_ok;

In SymbolResolver.h:182:

        SymbolResolver  *self,
        void            *runtime_addr,
        const DwarfCfi **out_cfi,
        const DwarfFde **out_fde,
        u64             *out_module_base

In Dwarf.h:184:

        DwarfFdes  fdes;
        u64        eh_frame_addr;
    } DwarfCfi;
    
    ///

In Dwarf.h:213:

    /// TAGS: Parser, DWARF, CFI, Lookup
    ///
    const DwarfFde *DwarfCfiFindFde(const DwarfCfi *self, u64 vaddr);
    
    ///

In Dwarf.h:224:

    /// TAGS: Parser, DWARF, CFI, Lookup
    ///
    const DwarfCie *DwarfCfiFindCie(const DwarfCfi *self, u64 cie_offset);
    
    ///

In Dwarf.h:235:

    /// TAGS: Parser, DWARF, CFI, Deinit, Lifecycle
    ///
    void DwarfCfiDeinit(DwarfCfi *self);
    
    // ---------------------------------------------------------------------------

In Dwarf.h:306:

    /// TAGS: Parser, DWARF, CFI, Unwind
    ///
    bool DwarfCfiBuildRow(const DwarfCfi *cfi, const DwarfFde *fde, u64 target_pc, DwarfUnwindRow *out);
    
    // ===========================================================================

In SymbolResolver.c:259:

        SymbolResolver  *self,
        void            *runtime_addr,
        const DwarfCfi **out_cfi,
        const DwarfFde **out_fde,
        u64             *out_module_base

In Backtrace.c:620:

            ++emitted;
    
            const DwarfCfi *cfi         = NULL;
            const DwarfFde *fde         = NULL;
            u64             module_base = 0;

In DwarfUnwind.c:293:

        const u8       *body_start,
        u64             cie_offset,
        const DwarfCfi *cfi,
        const u8       *section_data,
        u64             section_addr,

In DwarfUnwind.c:356:

    // augmentation). Returns false only on allocation failure.
    static bool
        cfi_parse_section(DwarfCfi *out, const u8 *section_data, u64 section_addr, u64 section_size, bool is_debug_frame) {
        const u32 cie_id      = is_debug_frame ? 0xffffffffu : 0u;
        BufIter   section_cur = BufIterFromMemory(section_data, section_size);

In DwarfUnwind.c:425:

    }
    
    bool dwarf_cfi_build_from_elf(DwarfCfi *out, const Elf *elf, Allocator *alloc) {
        if (!out || !elf || !alloc) {
            LOG_FATAL("DwarfCfiBuildFromElf: NULL argument");

In DwarfUnwind.c:457:

    }
    
    const DwarfCie *DwarfCfiFindCie(const DwarfCfi *self, u64 cie_offset) {
        if (!self)
            return NULL;

In DwarfUnwind.c:468:

    }
    
    const DwarfFde *DwarfCfiFindFde(const DwarfCfi *self, u64 vaddr) {
        if (!self)
            return NULL;

In DwarfUnwind.c:481:

    }
    
    void DwarfCfiDeinit(DwarfCfi *self) {
        if (!self)
            return;

In DwarfUnwind.c:855:

    }
    
    bool DwarfCfiBuildRow(const DwarfCfi *cfi, const DwarfFde *fde, u64 target_pc, DwarfUnwindRow *out) {
        if (!cfi || !fde || !out)
            return false;

In DwarfUnwind.c:145:

        }
    
        DwarfCfi cfi;
        bool     ok = DwarfCfiBuildFromElf(&cfi, &elf, base);
        if (ok) {

In DwarfUnwind.c:344:

            return false;
        }
        DwarfCfi cfi;
        bool     ok = DwarfCfiBuildFromElf(&cfi, &elf, base);
        if (ok) {

In DwarfUnwind.c:465:

            return false;
        }
        DwarfCfi cfi;
        bool     ok = DwarfCfiBuildFromElf(&cfi, &elf, base);
        if (ok) {

In DwarfUnwind.c:540:

            return false;
        }
        DwarfCfi cfi;
        bool     ok = DwarfCfiBuildFromElf(&cfi, &elf, base);
        if (ok) {

In DwarfUnwind.c:1250:

        Elf  elf;
        if (ElfOpenFromMemoryCopy(&elf, elfbuf, (size)elf_len, base)) {
            DwarfCfi cfi;
            if (DwarfCfiBuildFromElf(&cfi, &elf, base)) {
                const DwarfFde *fde = DwarfCfiFindFde(&cfi, 0x5000);

In DwarfUnwind.c:1310:

        Elf  elf;
        if (ElfOpenFromMemoryCopy(&elf, elfbuf, (size)elf_len, base)) {
            DwarfCfi cfi;
            if (DwarfCfiBuildFromElf(&cfi, &elf, base)) {
                ok = DwarfCfiFindFde(&cfi, 0x10ff) != NULL  // last in-range address

In DwarfUnwind.c:1338:

        Elf  elf;
        if (ElfOpenFromMemoryCopy(&elf, elfbuf, (size)elf_len, base)) {
            DwarfCfi cfi;
            if (DwarfCfiBuildFromElf(&cfi, &elf, base)) {
                const DwarfFde *fde = DwarfCfiFindFde(&cfi, 0x1000);

In DwarfUnwind.c:1379:

        Elf  elf;
        if (ElfOpenFromMemoryCopy(&elf, elfbuf, (size)elf_len, base)) {
            DwarfCfi cfi;
            if (DwarfCfiBuildFromElf(&cfi, &elf, base)) {
                const DwarfCie *cie = DwarfCfiFindCie(&cfi, 0);

In DwarfUnwind.c:1411:

        Elf  elf;
        if (ElfOpenFromMemoryCopy(&elf, elfbuf, (size)elf_len, base)) {
            DwarfCfi cfi;
            if (DwarfCfiBuildFromElf(&cfi, &elf, base)) {
                const DwarfFde *fde = DwarfCfiFindFde(&cfi, 0x1000);

In Dwarf.c:114:

        }
    
        DwarfCfi cfi;
        bool     built = DwarfCfiBuildFromElf(&cfi, &elf, base);
        // Contract (strict): the parse must succeed AND an FDE must cover this

Last updated on June 29, 2026

DnsResponseDeinit DwarfCfiBuildFromElf