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 SIZE: usize = 40

Size of a section table entry in bytes (40 bytes per section).

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) -> Result<()>

Sets the section name.

PE section names are limited to 8 bytes per the PE specification. This method validates the name length before setting it.

Arguments

• name - New section name (must be 8 bytes or less)

Errors

Returns an error if the name exceeds 8 bytes.

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

Writes this section header to the writer.

Each section header is 40 bytes and describes a section’s location in both the file and virtual memory, along with its characteristics (readable, writable, executable, etc.).

Arguments

• writer - The writer to output the section header 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.