Struct pdb::PdbInternalSectionOffset

pub struct PdbInternalSectionOffset {
    pub offset: u32,
    pub section: u16,
}

An offset relative to a PE section in the original unoptimized binary.

For optimized Microsoft binaries, this offset points to a virtual address space before the rearrangement of sections has been performed. This kind of offset is usually stored in PDB debug information. It can be converted to an RVA in the transformed address space of the optimized binary using to_rva. Likewise, there is a conversion to SectionOffset in the actual address space.

For binaries and their PDBs that have not been optimized, both address spaces are equal and the offsets are interchangeable. The conversion operations are cheap no-ops in this case.

Fields

offset: u32

The memory offset relative from the start of the section’s memory.

section: u16

The index of the section in the PDB’s section headers list, incremented by 1. A value of 0 indicates an invalid or missing reference.

Implementations

impl PdbInternalSectionOffset

pub fn new(section: u16, offset: u32) -> Self

Creates a new section offset.

pub fn is_valid(self) -> bool

Returns whether this section offset points to a valid section or into the void.

pub fn checked_add(self, offset: u32) -> Option<Self>

Checked addition of an offset. Returns None if overflow occurred.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

pub fn saturating_add(self, offset: u32) -> Self

Saturating addition of an offset, clipped at the numeric bounds.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

pub fn wrapping_add(self, offset: u32) -> Self

Wrapping (modular) addition of an offset.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

impl PdbInternalSectionOffset

pub fn to_rva(self, translator: &AddressMap<'_>) -> Option<Rva>

Resolves an actual Relative Virtual Address in the executable’s address space.

pub fn to_internal_rva(
    self,
    translator: &AddressMap<'_>
) -> Option<PdbInternalRva>

Resolves a PDB-internal Relative Virtual Address.

This address is not necessarily compatible with the executable’s address space and should therefore not be used for debugging purposes.

pub fn to_section_offset(
    self,
    translator: &AddressMap<'_>
) -> Option<SectionOffset>

Resolves the section offset in the PE headers.

Trait Implementations

impl Add<u32> for PdbInternalSectionOffset

fn add(self, offset: u32) -> Self

Adds the given offset to this section offset.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

type Output = PdbInternalSectionOffset

The resulting type after applying the + operator.

impl AddAssign<u32> for PdbInternalSectionOffset

fn add_assign(&mut self, offset: u32)

Adds the given offset to this section offset.

This does not check whether the offset is still valid within the given section. If the offset is out of bounds, the conversion to Rva will return None.

impl Clone for PdbInternalSectionOffset

fn clone(&self) -> PdbInternalSectionOffset

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PdbInternalSectionOffset

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

Formats the value using the given formatter.

impl Default for PdbInternalSectionOffset

fn default() -> PdbInternalSectionOffset

Returns the “default value” for a type.

impl Hash for PdbInternalSectionOffset

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<PdbInternalSectionOffset> for PdbInternalSectionOffset

fn eq(&self, other: &PdbInternalSectionOffset) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &PdbInternalSectionOffset) -> bool

This method tests for !=.

impl PartialOrd<PdbInternalSectionOffset> for PdbInternalSectionOffset

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

Compares offsets if they reside in the same section.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'t> TryFromCtx<'t, Endian, [u8]> for PdbInternalSectionOffset

type Error = Error

fn try_from_ctx(this: &'t [u8], le: Endian) -> Result<(Self, usize)>

impl Copy for PdbInternalSectionOffset

impl Eq for PdbInternalSectionOffset

impl StructuralEq for PdbInternalSectionOffset

impl StructuralPartialEq for PdbInternalSectionOffset