Struct SectionTable

pub struct SectionTable {
    pub name: String,
    pub virtual_size: u32,
    pub virtual_address: u32,
    pub size_of_raw_data: u32,
    pub pointer_to_raw_data: u32,
    pub pointer_to_relocations: u32,
    pub pointer_to_line_numbers: u32,
    pub number_of_relocations: u16,
    pub number_of_line_numbers: u16,
    pub characteristics: u32,
}

Provides access to low-level file and memory parsing utilities.

The crate::Parser type is used for decoding CIL bytecode and metadata streams.

Usage Examples

use dotscope::{Parser, assembly::decode_instruction};
let code = [0x2A]; // ret
let mut parser = Parser::new(&code);
let instr = decode_instruction(&mut parser, 0x1000)?;
assert_eq!(instr.mnemonic, "ret");

Owned section table entry.

Fields

name: String

Section name (up to 8 bytes)

virtual_size: u32

Virtual size

virtual_address: u32

Virtual address (RVA)

size_of_raw_data: u32

Size of raw data

pointer_to_raw_data: u32

Pointer to raw data

pointer_to_relocations: u32

Pointer to relocations

pointer_to_line_numbers: u32

Pointer to line numbers

number_of_relocations: u16

Number of relocations

number_of_line_numbers: u16

Number of line numbers

characteristics: u32

Section characteristics

Implementations

impl SectionTable

pub const HEADER_SIZE: usize = 40usize

Size of a section table header in bytes.

pub fn calculate_table_size(section_count: usize) -> u64

Calculates the total size required for a section table with the given number of sections.

Arguments

• section_count - Number of sections in the table

Returns

Total size in bytes for the section table

pub fn from_layout_info( name: String, virtual_address: u32, virtual_size: u32, file_offset: u64, file_size: u64, characteristics: u32, ) -> Result<Self>

Creates a SectionTable from layout information.

This converts from the layout planning structures used during write operations back to the PE section table format.

Arguments

• name - Section name
• virtual_address - RVA where section is mapped
• virtual_size - Virtual size of section in memory
• file_offset - File offset where section data is stored
• file_size - Size of section data in file
• characteristics - Section characteristics flags

Returns

A new SectionTable instance

Errors

Returns an error if the file offset or size exceed u32 range

pub fn update_virtual_location( &mut self, virtual_address: u32, virtual_size: u32, )

Updates the virtual address and size of this section.

Arguments

• virtual_address - New RVA where section is mapped
• virtual_size - New virtual size of section in memory

pub fn update_file_location( &mut self, file_offset: u64, file_size: u64, ) -> Result<()>

Updates the file location and size of this section.

Arguments

• file_offset - New file offset where section data is stored
• file_size - New size of section data in file

Errors

Returns an error if the file offset or size exceed u32 range

pub fn update_characteristics(&mut self, characteristics: u32)

Updates the section characteristics flags.

Arguments

• characteristics - New section characteristics flags

pub fn set_name(&mut self, name: String)

Sets the section name.

Arguments

• name - New section name (will be truncated to 8 bytes if longer)

pub fn write_header_to<W: Write>(&self, writer: &mut W) -> Result<()>

Writes a section header as a standalone 40-byte header.

This method encodes the section information into the PE section table format and writes it to the provided writer. This serializes the current state of the section without making any modifications.

Arguments

• writer - Writer to output the header bytes to

Errors

Returns an error if writing fails

Trait Implementations

impl Clone for SectionTable

fn clone(&self) -> SectionTable

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SectionTable

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

Formats the value using the given formatter.