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 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.

Methods

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 Copy for PdbInternalSectionOffset

impl Clone for PdbInternalSectionOffset

fn clone(&self) -> PdbInternalSectionOffset

Returns a copy of the value.

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

Performs copy-assignment from source.

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.

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

default 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 Eq for PdbInternalSectionOffset

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].

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

Feeds a slice of this type into the given [Hasher].

impl Add<u32> for PdbInternalSectionOffset

type Output = Self

The resulting type after applying the + operator.

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.

impl Debug for PdbInternalSectionOffset

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

Formats the value using the given formatter.

impl<'a> TryFromCtx<'a, Endian, [u8]> for PdbInternalSectionOffset where
    PdbInternalSectionOffset: 'a, 

type Error = Error

type Size = usize

fn try_from_ctx(
    src: &'a [u8],
    ctx: Endian
) -> Result<(Self, Self::Size), Self::Error>