ghostscope-dwarf 0.1.5

DWARF parser and symbolizer used by GhostScope to resolve variables and types at runtime.
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//! PC-centered semantic context types.

use crate::core::{CuId, DieRef, FunctionId, InlineContextId, ModuleId, ScopeId};
use std::path::PathBuf;

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct PcContext {
    pub module: ModuleId,
    /// Runtime PC in the target process address space.
    pub pc: u64,
    /// Module-normalized PC used for DWARF and object-file queries.
    pub normalized_pc: u64,
    pub cu: Option<CuId>,
    pub function: Option<FunctionId>,
    /// Best-effort display name until stable function DIE ids are wired in.
    pub function_name: Option<String>,
    pub lexical_scopes: Vec<ScopeId>,
    pub inline_chain: Vec<InlineFrame>,
    /// Best-effort inline classification until inline DIE chains are exposed.
    pub is_inline: Option<bool>,
    pub line: Option<PcLineInfo>,
    pub address_space: AddressSpaceInfo,
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct FunctionParameter {
    pub name: String,
    pub type_name: String,
    pub is_artificial: bool,
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct InlineFrame {
    pub context: Option<InlineContextId>,
    pub call_site: Option<PcLineInfo>,
    pub abstract_origin: Option<DieRef>,
    pub concrete_die: DieRef,
    pub function_name: Option<String>,
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct PcLineInfo {
    pub file_path: String,
    pub line_number: u32,
    pub column: Option<u32>,
    pub address: u64,
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct AddressSpaceInfo {
    pub module_path: Option<PathBuf>,
    pub runtime_base: Option<u64>,
    pub link_base: Option<u64>,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct PcRange {
    pub start: u64,
    pub end: u64,
}

impl PcRange {
    pub fn contains(&self, pc: u64) -> bool {
        if self.start == self.end {
            pc == self.start
        } else {
            pc >= self.start && pc < self.end
        }
    }
}