Struct DllReader 

pub struct DllReader<'config, R> { /* private fields */ }

Implementations

impl<'config, R> DllReader<'config, R>

pub fn new(reader: R, options: &'config DllReadConfig) -> Self

Constructs a .NET reader (DLL) using a generic PE reader.

Note: This is a lazy constructor and will not immediately execute the parsing workflow.

impl<'config, R> DllReader<'config, R>

where R: Read + Seek,

pub fn get_assembly_info(&mut self) -> Result<DotNetAssemblyInfo, GaiaError>

Lazily reads basic assembly information.

Only reads basic identification information of the assembly without parsing the full type system. Suitable for scenarios where you need to quickly get assembly name, version, etc.

Returns

• Ok(DotNetAssemblyInfo) - Basic assembly information.
• Err(GaiaError) - Error during the reading process.

pub fn to_clr_program(&mut self) -> Result<ClrProgram, GaiaError>

Parses as a full CLR program.

Parses the entire .NET assembly, including all types, methods, fields, and other information. This is a heavyweight operation that consumes significant memory and time.

Returns

• Ok(ClrProgram) - Full representation of the CLR program.
• Err(GaiaError) - Error during the parsing process.

pub fn validate_assembly(&mut self) -> Result<Vec<String>, GaiaError>

Validates the integrity of the assembly.

Checks if the parsed .NET assembly contains all required components:

• CLR Header: Contains runtime information.
• Metadata Header: Describes the type system.
• Metadata Streams: Contains the actual metadata.

Returns

• Ok(Vec<String>) - List of warning messages; an empty list indicates validation success.
• Err(GaiaError) - Error during the validation process.

pub fn get_assembly_summary(&mut self) -> String

Gets a summary of the assembly information.

Returns the basic information of the assembly in a friendly format, suitable for display or logging. If the assembly information is unavailable, it returns a corresponding error message.

Returns

• String - Formatted assembly information containing name, version, culture, public key token, and runtime version.

Trait Implementations

impl<'config, R: Debug> Debug for DllReader<'config, R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'config, R: Read + Seek> PeReader<R> for DllReader<'config, R>

fn get_viewer(&mut self) -> &mut R

Get a mutable reference to the binary reader

fn add_diagnostics(&mut self, error: impl Into<GaiaError>)

Get a mutable reference to diagnostics information

fn get_section_headers(&mut self) -> Result<&[SectionHeader], GaiaError>

Get cached section headers

fn get_pe_header(&mut self) -> Result<&PeHeader, GaiaError>

Read PE header information (generic implementation)

fn get_program(&mut self) -> Result<&PeProgram, GaiaError>

Force read full PeProgram and cache the result

fn get_position(&mut self) -> Result<u64, GaiaError>

where R: Seek,

fn set_position(&mut self, offset: u64) -> Result<u64, GaiaError>

where R: Seek,

fn rva_to_file_offset( &self, rva: u32, sections: &[PeSection], ) -> Result<u32, GaiaError>

Convert RVA to file offset (generic implementation)

fn parse_import_table( &mut self, header: &PeHeader, sections: &[PeSection], ) -> Result<ImportTable, GaiaError>

Parse import table (generic implementation)

fn parse_export_table( &mut self, header: &PeHeader, sections: &[PeSection], ) -> Result<ExportTable, GaiaError>

Parse export table (generic implementation)

fn create_pe_info(&mut self) -> Result<PeInfo, GaiaError>

Create PE info view (generic implementation)