univdreams 0.4.0

Byte-identical binary <-> source round-tripping: binary formats, multi-arch decode/encode, a .ud decompiler/compiler, and an x86 emulator with Win16/Win32/Linux hosts.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! Debug-info reader: turns `.debug_info` (DWARF) into typed function
//! signatures the decompiler can attach to its `FnDecl` AST nodes.
//!
//! v0 scope: x86-64 ELF, DWARF 4/5. Subprogram DIEs yield names,
//! addresses, and parameter / return types. Type recovery covers
//! DW_TAG_base_type (primitives) and DW_TAG_pointer_type (recursively
//! resolved); other tags produce [`crate::ast::Type::Unknown`].
//!
//! Pluggable parsers for PDB, stabs, and Mach-O `.dSYM` will land in
//! this same crate as additional modules.

#![allow(clippy::cast_possible_truncation)]

mod dwarf;

pub use dwarf::{DebugError, DebugFunction};

use std::collections::HashMap;

use crate::format::elf::Elf64File;

/// Read every supported debug-info section from `elf` and return a
/// map keyed by function start address. Empty when no debug info is
/// present.
///
/// Today this only consults `.debug_info` (DWARF). It will grow as
/// other formats come online.
pub fn read_debug_info(elf: &Elf64File) -> Result<HashMap<u64, DebugFunction>, DebugError> {
    let mut by_addr = HashMap::new();
    for f in dwarf::read_subprograms(elf)? {
        by_addr.insert(f.addr, f);
    }
    Ok(by_addr)
}