Expand description
Ghostscope DWARF Analysis Library
High-performance DWARF analysis library with on-demand loading architecture inspired by GDB’s cooked index system.
Modules§
- constants
- Constant definitions.
Structs§
- Address
Expr - Address expression that can be evaluated by a later lowering layer.
- Address
Query Result - Rich query result for a single address within a module.
- Address
Space Info - Analyzer
Stats - Statistics for debugging and monitoring
- CInteger
Comparison Plan - CInteger
Comparison Type - Caller
Frame Recovery - Caller-frame recovery rules materialized as planned expression ops.
- Compact
Unwind Row - Compact
Unwind Stats - Compact
Unwind Table - A compact, row-oriented unwind table derived from DWARF CFI.
- CuId
- Stable identifier for a compilation unit within a loaded module.
- DieRef
- Stable reference to a DIE within a loaded module.
- DwAte
- The encodings of the constants used in the
DW_AT_encodingattribute. - Dwarf
Analyzer - DWARF analyzer - unified entry point for all DWARF analysis
- Entry
Value Case - One caller-side case for recovering a callee’s DW_OP_entry_value.
- Enum
Variant - Enum variant information
- Executable
File Info - Executable file information (for “info file” command)
- Explicit
Debug File - A user-provided debug file bound to one loaded module.
- Function
Id - Stable identifier for a function DIE.
- Function
Info - Function information
- Function
Parameter - Function
Query Result - Rich query result for a function lookup across modules.
- Global
Variable Info - Lightweight global variable metadata resolved from DWARF/ELF
- Indexable
Element Layout - Inline
Context Id - Stable identifier for an inline context inside a concrete function.
- Inline
Frame - Loaded
Module Runtime Info - Runtime mapping metadata for a loaded module.
- Main
Executable Info - Main executable information
- Member
Layout - Module
Address - Module address pair - combines module path with address offset
- Module
Id - Stable identifier for a loaded module within one
DwarfAnalyzer. - Module
Loading Stats - Statistics for a loaded module
- Module
Stats - Module statistics compatible with ghostscope-binary
- PcContext
- PcLine
Info - PcRange
- Piece
Location - Planned
Address - Runtime
Capabilities - Capabilities available to a future BPF lowering pass.
- Runtime
Computed Expr - Runtime expression selected by DWARF semantic planning.
- ScopeId
- Stable identifier for a lexical scope DIE.
- Section
Info - Section information for executable files
- Shared
Library Info - Shared library information (compatible with ghostscope-ui)
- Simple
File Info - Simple file information compatible with ghostscope-binary
- Source
Line Address Search - Source
Line Query Search - Source
Location - Source location information (address-based, not pc-based)
- Struct
Member - Struct/union member information
- TypeId
- Stable identifier for a type DIE.
- Type
Lookup Ambiguity - Unwind
Diagnostic - Variable
Access Path - Variable
Id - Stable identifier for a variable declaration DIE.
- Variable
Lowering Plan - Variable
Materialization Plan - Variable
Plan - Variable
Query Diagnostic - Diagnostic produced while answering a PC-sensitive variable query.
- Variable
Read Plan - Owned, PC-sensitive variable read plan before runtime-specific lowering.
- Visible
Variable - Owned semantic view returned by PC-context variable queries.
- Visible
Variables Result - Visible variables plus non-fatal diagnostics from best-effort discovery.
Enums§
- Address
Origin - Ambiguity
Reason - Reason a query could not pick one unambiguous semantic interpretation.
- Availability
- Whether a semantic result is usable at the requested PC.
- CfaResult
- CFA (Canonical Frame Address) computation for stack variables
- CfaRule
Plan - Debug
Info Source - Where DWARF debug information for a loaded module came from.
- Dwarf
Error - Error types for the library
- Helper
Mode - User-memory helper strategy selected by a lowering plan.
- Lvalue
Address Plan - Memory
Access Size - Memory access size for bpf_probe_read_user
- Module
Default Policy - Module
Loading Event - Events emitted during module loading process
- Plan
Expr Op - Stack-machine expression op selected by DWARF lowering.
- Planned
Address Kind - Planned
Value - Provenance
- Where a semantic answer came from.
- Register
Recovery Plan - Runtime
Computed Kind - Runtime
Requirement - Runtime feature required before a semantic plan can be lowered safely.
- Section
Type - Program section classification for global/static variables
- Target
Arch - Type
Info - Type information with full fidelity from DWARF debugging data
- Type
Kind - Variable type kind - used by compiler and streaming parser for runtime classification
- Type
Layout Error - Type
Qualifier - Type qualifiers
- Unsupported
Reason - DWARF or semantic shapes the current engine cannot represent yet.
- Unwind
Diagnostic Kind - Variable
Access Segment - Variable
Location - PC-sensitive variable location before BPF lowering.
- Variable
Lowering Kind - Variable
Materialization - Verifier
Risk - Coarse verifier risk surfaced before backend codegen.
Functions§
- c_
integer_ comparison_ type - indexable_
element_ layout - is_
c_ aggregate_ type - is_
c_ pointer_ or_ array_ type - is_
c_ signed_ integer_ type - member_
layout - strip_
type_ aliases - usual_
c_ arithmetic_ comparison_ plan