Skip to content

headers

🤖 AI-Generated Content

This documentation was generated with AI assistance and is still being audited. Some, or potentially a lot, of this information may be inaccurate. Learn more.

flavor.psp.format_2025.pe_utils.headers

PE header utilities.

Provides utilities for working with PE file headers and offset calculations.

Functions

rva_to_file_offset 

rva_to_file_offset(data: bytes, rva: int) -> int | None

Map a Relative Virtual Address (RVA) to a file offset.

Walks the section table to find which section contains the RVA and calculates the corresponding file offset.

Parameters:

Name Type Description Default
data bytes

PE executable data

 required
rva int

Relative Virtual Address to map

 required

Returns:

Type Description
int | None

File offset if mapping succeeded, None otherwise
Source code in flavor/psp/format_2025/pe_utils/headers.py 
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
def rva_to_file_offset(data: bytes, rva: int) -> int | None:
    """
    Map a Relative Virtual Address (RVA) to a file offset.

    Walks the section table to find which section contains the RVA and
    calculates the corresponding file offset.

    Args:
        data: PE executable data
        rva: Relative Virtual Address to map

    Returns:
        File offset if mapping succeeded, None otherwise
    """
    # Get PE header location
    pe_offset: int = struct.unpack("<I", data[0x3C:0x40])[0]
    coff_offset = pe_offset + 4

    # Read number of sections
    num_sections: int = struct.unpack("<H", data[coff_offset + 2 : coff_offset + 4])[0]

    # Read optional header size
    opt_hdr_size: int = struct.unpack("<H", data[coff_offset + 16 : coff_offset + 18])[0]

    # Section table offset
    section_table_offset = coff_offset + 20 + opt_hdr_size

    # Walk section table to find which section contains this RVA
    for i in range(num_sections):
        section_offset = section_table_offset + (i * 40)

        # Read section header fields
        # VirtualAddress is at offset 12 in section header
        # VirtualSize is at offset 8 in section header
        # PointerToRawData is at offset 20 in section header

        virtual_addr: int = struct.unpack("<I", data[section_offset + 12 : section_offset + 16])[0]
        virtual_size: int = struct.unpack("<I", data[section_offset + 8 : section_offset + 12])[0]
        pointer_to_raw_data: int = struct.unpack("<I", data[section_offset + 20 : section_offset + 24])[0]

        # Check if RVA falls within this section
        if rva >= virtual_addr and rva < virtual_addr + virtual_size:
            offset_within_section = rva - virtual_addr
            file_offset: int = pointer_to_raw_data + offset_within_section
            logger.trace(
                "Mapped RVA to file offset",
                rva=f"0x{rva:x}",
                section=i,
                section_va=f"0x{virtual_addr:x}",
                file_offset=f"0x{file_offset:x}",
            )
            return file_offset

    logger.trace("RVA not found in any section", rva=f"0x{rva:x}")
    return None