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
71
72
73
74
75
76
77
78
79

//! `AssemblyOS` table module
//!
//! Provides complete support for the ECMA-335 `AssemblyOS` metadata table (0x22), which contains
//! operating system platform information for assemblies. This module includes raw table access,
//! collection types, and platform identification utilities.
//!
//! # Components
//!
//! - [`crate::metadata::tables::assemblyos::AssemblyOsRaw`]: Raw table structure (no heap resolution needed)
//! - [`crate::metadata::tables::assemblyos::AssemblyOs`]: Type alias to Raw since all data is self-contained
//! - [`crate::metadata::tables::assemblyos::loader::AssemblyOsLoader`]: Internal loader for processing `AssemblyOS` table data
//! - Type aliases for efficient collections and reference management
//!
//! # `AssemblyOS` Table Structure
//!
//! The `AssemblyOS` table contains platform targeting information:
//! - **`OSPlatformId`**: Operating system platform identifier (4 bytes)
//! - **`OSMajorVersion`**: Major version number of the target OS (4 bytes)
//! - **`OSMinorVersion`**: Minor version number of the target OS (4 bytes)
//!
//! # Historical Context
//!
//! This table was designed for early .NET Framework scenarios where assemblies might need
//! to specify explicit OS compatibility. Modern .NET applications typically rely on runtime
//! platform abstraction and conditional compilation instead of metadata-level OS targeting.
//!
//! # Reference
//! - [ECMA-335 II.22.3](https://ecma-international.org/wp-content/uploads/ECMA-335_6th_edition_june_2012.pdf) - `AssemblyOS` table specification

use crossbeam_skiplist::SkipMap;
use std::sync::Arc;

use crate::metadata::token::Token;

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

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

/// A map that holds the mapping of [`crate::metadata::token::Token`] to parsed [`crate::metadata::tables::assemblyos::AssemblyOs`]
///
/// Thread-safe concurrent map using skip list data structure for efficient lookups
/// and insertions. Used to cache resolved `AssemblyOS` entries by their metadata tokens.
pub type AssemblyOsMap = SkipMap<Token, AssemblyOsRc>;

/// A vector that holds a list of [`crate::metadata::tables::assemblyos::AssemblyOs`] references
///
/// Thread-safe append-only vector for storing `AssemblyOS` collections. Uses atomic operations
/// for lock-free concurrent access and is optimized for scenarios with frequent reads.
pub type AssemblyOsList = Arc<boxcar::Vec<AssemblyOsRc>>;

/// A reference-counted pointer to an [`crate::metadata::tables::assemblyos::AssemblyOs`]
///
/// Provides shared ownership and automatic memory management for `AssemblyOS` instances.
/// Multiple references can safely point to the same `AssemblyOS` data across threads.
pub type AssemblyOsRc = Arc<AssemblyOs>;

/// Operating system targeting information for assemblies
///
/// Type alias to [`crate::metadata::tables::assemblyos::AssemblyOsRaw`] since the `AssemblyOS` table contains only primitive values
/// that don't require heap resolution. All data in the raw structure is immediately usable.
///
/// The `AssemblyOS` table specifies which operating systems this assembly is designed to run on,
/// though this information is rarely used in modern .NET applications which rely on runtime
/// platform abstraction instead.
///
/// # Data Model
///
/// Unlike other metadata tables that reference string or blob heaps, `AssemblyOS` contains
/// only integer values, making the "raw" and "owned" representations identical.
///
/// # Reference
/// - [ECMA-335 II.22.3](https://ecma-international.org/wp-content/uploads/ECMA-335_6th_edition_june_2012.pdf) - `AssemblyOS` table specification (Table ID = 0x22)
pub type AssemblyOs = AssemblyOsRaw;