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

//! Core types and utilities for ghostscope-dwarf

use crate::binary::DwarfReader;

pub mod demangle;
pub mod diagnostic;
pub mod errors;
pub mod evaluation;
pub mod ids;
pub mod mapping;
pub mod plan;
pub mod symbol_names;
pub mod types;

pub use demangle::is_likely_mangled;
pub use diagnostic::{
    AmbiguityReason, Availability, DebugInfoSource, HelperMode, Provenance, RuntimeCapabilities,
    RuntimeRequirement, TargetArch, UnsupportedReason, VerifierRisk,
};
pub use errors::{DwarfError, Result};
pub(crate) use evaluation::{
    plan_expr_steps_to_expression, DirectValueResult, LocationResult, PieceResult,
    RawExpressionResult,
};
pub use evaluation::{
    CallerFrameRecovery, CfaResult, EntryValueCase, MemoryAccessSize, PlanExprOp,
};
pub use ids::{CuId, DieRef, FunctionId, InlineContextId, ModuleId, ScopeId, TypeId, VariableId};
pub(crate) use plan::ParsedLocation;
pub use plan::{AddressExpr, PieceLocation, VariableLocation};
pub(crate) use symbol_names::{
    demangled_name, extract_name_fragments, normalize_demangled_signature,
    symbol_name_matches_query,
};
pub use types::{
    FunctionDieKind, FunctionInfo, GlobalVariableInfo, IndexEntry, IndexFlags, LineEntry,
    ModuleAddress, SectionType, SourceLocation,
};

pub(crate) fn attr_u64(value: gimli::AttributeValue<DwarfReader>) -> Option<u64> {
    match value {
        gimli::AttributeValue::Udata(v) => Some(v),
        gimli::AttributeValue::Sdata(v) if v >= 0 => Some(v as u64),
        gimli::AttributeValue::Data1(v) => Some(v as u64),
        gimli::AttributeValue::Data2(v) => Some(v as u64),
        gimli::AttributeValue::Data4(v) => Some(v as u64),
        gimli::AttributeValue::Data8(v) => Some(v),
        _ => None,
    }
}