Struct pdb::PdbInternalSectionOffset
source · [−]Expand description
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
sourceimpl PdbInternalSectionOffset
impl PdbInternalSectionOffset
sourcepub fn is_valid(self) -> bool
pub fn is_valid(self) -> bool
Returns whether this section offset points to a valid section or into the void.
sourcepub fn checked_add(self, offset: u32) -> Option<Self>
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
.
sourcepub fn saturating_add(self, offset: u32) -> Self
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
.
sourcepub fn wrapping_add(self, offset: u32) -> Self
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
.
sourceimpl PdbInternalSectionOffset
impl PdbInternalSectionOffset
sourcepub fn to_rva(self, translator: &AddressMap<'_>) -> Option<Rva>
pub fn to_rva(self, translator: &AddressMap<'_>) -> Option<Rva>
Resolves an actual Relative Virtual Address in the executable’s address space.
sourcepub fn to_internal_rva(
self,
translator: &AddressMap<'_>
) -> Option<PdbInternalRva>
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.
sourcepub fn to_section_offset(
self,
translator: &AddressMap<'_>
) -> Option<SectionOffset>
pub fn to_section_offset(
self,
translator: &AddressMap<'_>
) -> Option<SectionOffset>
Resolves the section offset in the PE headers.
Trait Implementations
sourceimpl Add<u32> for PdbInternalSectionOffset
impl Add<u32> for PdbInternalSectionOffset
sourcefn add(self, offset: u32) -> Self
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
type Output = PdbInternalSectionOffset
The resulting type after applying the +
operator.
sourceimpl AddAssign<u32> for PdbInternalSectionOffset
impl AddAssign<u32> for PdbInternalSectionOffset
sourcefn add_assign(&mut self, offset: u32)
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
.
sourceimpl Clone for PdbInternalSectionOffset
impl Clone for PdbInternalSectionOffset
sourcefn clone(&self) -> PdbInternalSectionOffset
fn clone(&self) -> PdbInternalSectionOffset
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl Debug for PdbInternalSectionOffset
impl Debug for PdbInternalSectionOffset
sourceimpl Default for PdbInternalSectionOffset
impl Default for PdbInternalSectionOffset
sourcefn default() -> PdbInternalSectionOffset
fn default() -> PdbInternalSectionOffset
Returns the “default value” for a type. Read more
sourceimpl Hash for PdbInternalSectionOffset
impl Hash for PdbInternalSectionOffset
sourceimpl PartialEq<PdbInternalSectionOffset> for PdbInternalSectionOffset
impl PartialEq<PdbInternalSectionOffset> for PdbInternalSectionOffset
sourcefn eq(&self, other: &PdbInternalSectionOffset) -> bool
fn eq(&self, other: &PdbInternalSectionOffset) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
sourcefn ne(&self, other: &PdbInternalSectionOffset) -> bool
fn ne(&self, other: &PdbInternalSectionOffset) -> bool
This method tests for !=
.
sourceimpl PartialOrd<PdbInternalSectionOffset> for PdbInternalSectionOffset
impl PartialOrd<PdbInternalSectionOffset> for PdbInternalSectionOffset
sourcefn partial_cmp(&self, other: &Self) -> Option<Ordering>
fn partial_cmp(&self, other: &Self) -> Option<Ordering>
Compares offsets if they reside in the same section.
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
sourceimpl<'t> TryFromCtx<'t, Endian, [u8]> for PdbInternalSectionOffset
impl<'t> TryFromCtx<'t, Endian, [u8]> for PdbInternalSectionOffset
impl Copy for PdbInternalSectionOffset
impl Eq for PdbInternalSectionOffset
impl StructuralEq for PdbInternalSectionOffset
impl StructuralPartialEq for PdbInternalSectionOffset
Auto Trait Implementations
impl RefUnwindSafe for PdbInternalSectionOffset
impl Send for PdbInternalSectionOffset
impl Sync for PdbInternalSectionOffset
impl Unpin for PdbInternalSectionOffset
impl UnwindSafe for PdbInternalSectionOffset
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more