dotscope 0.6.0

A high-performance, cross-platform framework for analyzing and reverse engineering .NET PE executables
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

//! # `ParamPtr` Table Module
//!
//! This module provides comprehensive access to the `ParamPtr` metadata table (ID 0x04),
//! which serves as an indirection mechanism for parameter table entries in optimized
//! metadata layouts. The `ParamPtr` table enables parameter table compression and
//! reordering while maintaining logical parameter access patterns.
//!
//! ## Table Purpose
//!
//! The `ParamPtr` table provides:
//! - **Indirection**: Maps logical parameter indexes to physical parameter locations
//! - **Optimization**: Enables parameter table compression in optimized metadata
//! - **Flexibility**: Allows parameter reordering without breaking logical references
//! - **Efficiency**: Supports efficient parameter lookup in compressed assemblies
//!
//! ## Module Structure
//!
//! The module follows the standard dual-variant pattern for metadata tables:
//!
//! ### Raw Variant (`ParamPtrRaw`)
//! - Direct memory representation of table entries
//! - Minimal processing overhead during initial parsing
//! - Contains unresolved references requiring further processing
//! - Used for memory-efficient storage and initial metadata loading
//!
//! ### Owned Variant (`ParamPtr`)
//! - Fully processed and validated table entries
//! - Contains resolved references and complete parameter information
//! - Provides high-level access methods and validation
//! - Used for application logic and metadata analysis
//!
//! ## References
//!
//! - ECMA-335, Partition II, ยง22.26 - `ParamPtr` table specification
//! - [`crate::metadata::tables::Param`] - Target parameter table entries
//! - [`crate::metadata::loader`] - Metadata loading and resolution system
use crate::metadata::token::Token;
use crossbeam_skiplist::SkipMap;
use std::sync::Arc;

mod builder;
mod loader;
mod owned;
mod raw;
mod reader;
mod writer;

pub use builder::*;
pub(crate) use loader::*;
pub use owned::*;
pub use raw::*;

/// A concurrent map that holds Token to `ParamPtr` mappings.
///
/// This skip list-based map provides efficient concurrent access to loaded
/// `ParamPtr` entries indexed by their metadata tokens. Used by the loader
/// for storing and retrieving parameter pointer entries.
pub type ParamPtrMap = SkipMap<Token, ParamPtrRc>;

/// A thread-safe vector containing `ParamPtr` entries.
///
/// This concurrent vector provides sequential access to `ParamPtr` entries
/// while supporting safe concurrent iteration and access from multiple threads.
pub type ParamPtrList = Arc<boxcar::Vec<ParamPtrRc>>;

/// A reference-counted pointer to a `ParamPtr` entry.
///
/// This atomic reference-counted pointer enables safe sharing of `ParamPtr`
/// instances across threads while providing automatic memory management.
pub type ParamPtrRc = Arc<ParamPtr>;