Struct AddressContext

pub struct AddressContext {
    pub va: Va,
    pub root: Pa,
}

A complete address context within a system for virtual to physical address translation.

In virtual machine introspection (VMI) and memory analysis, it’s often necessary to work with addresses from different processes or memory spaces. The AddressContext struct encapsulates both a virtual address and the corresponding translation root, providing all the information needed to accurately translate the virtual address to a physical address.

The AddressContext is commonly used as an input to memory access or translation functions in VMI tools, ensuring that the correct translation context is applied for each memory operation.

Example

let user_space_address = AddressContext {
    va: Va(0x7ffe0000),
    root: Pa(0x1000000),  // CR3 value for a specific process
};

let kernel_space_address = AddressContext {
    va: Va(0xfffff80000000000),
    root: Pa(0x2000000),  // CR3 value for kernel space
};

// These contexts can then be used in memory operations
// vmi.read(user_space_address, &mut buffer)?;
// vmi.translate_address(kernel_space_address)?;

Fields

va: Va

The virtual address.

root: Pa

The translation root, typically the base of the page table hierarchy (e.g., CR3 in x86).

Implementations

impl AddressContext

pub fn new(va: impl Into<Va>, root: impl Into<Pa>) -> Self

Creates a new AddressContext with the given virtual address and translation root.

Trait Implementations

impl Add<u64> for AddressContext

type Output = AddressContext

The resulting type after applying the + operator.

fn add(self, rhs: u64) -> Self::Output

Performs the + operation.

impl Add for AddressContext

type Output = AddressContext

The resulting type after applying the + operator.

fn add(self, rhs: AddressContext) -> Self::Output

Performs the + operation.

impl AddAssign<u64> for AddressContext

fn add_assign(&mut self, rhs: u64)

Performs the += operation.

impl AddAssign for AddressContext

fn add_assign(&mut self, rhs: AddressContext)

Performs the += operation.

impl BitAnd<u64> for AddressContext

type Output = AddressContext

The resulting type after applying the & operator.

fn bitand(self, rhs: u64) -> Self::Output

Performs the & operation.

impl BitAndAssign<u64> for AddressContext

fn bitand_assign(&mut self, rhs: u64)

Performs the &= operation.

impl BitOr<u64> for AddressContext

type Output = AddressContext

The resulting type after applying the | operator.

fn bitor(self, rhs: u64) -> Self::Output

Performs the | operation.

impl BitOrAssign<u64> for AddressContext

fn bitor_assign(&mut self, rhs: u64)

Performs the |= operation.

impl Clone for AddressContext

fn clone(&self) -> AddressContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AddressContext

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AddressContext

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for AddressContext

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

Formats the value using the given formatter.

impl Div<u64> for AddressContext

type Output = AddressContext

The resulting type after applying the / operator.

fn div(self, rhs: u64) -> Self::Output

Performs the / operation.

impl Div for AddressContext

type Output = AddressContext

The resulting type after applying the / operator.

fn div(self, rhs: AddressContext) -> Self::Output

Performs the / operation.

impl DivAssign<u64> for AddressContext

fn div_assign(&mut self, rhs: u64)

Performs the /= operation.

impl DivAssign for AddressContext

fn div_assign(&mut self, rhs: AddressContext)

Performs the /= operation.

impl From<(Va, Pa)> for AddressContext

fn from(value: (Va, Pa)) -> Self

Converts to this type from the input type.

impl From<AddressContext> for AccessContext

fn from(value: AddressContext) -> Self

Converts to this type from the input type.

impl Hash for AddressContext

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Mul<u64> for AddressContext

type Output = AddressContext

The resulting type after applying the * operator.

fn mul(self, rhs: u64) -> Self::Output

Performs the * operation.

impl Mul for AddressContext

type Output = AddressContext

The resulting type after applying the * operator.

fn mul(self, rhs: AddressContext) -> Self::Output

Performs the * operation.

impl MulAssign<u64> for AddressContext

fn mul_assign(&mut self, rhs: u64)

Performs the *= operation.

impl MulAssign for AddressContext

fn mul_assign(&mut self, rhs: AddressContext)

Performs the *= operation.

impl Ord for AddressContext

fn cmp(&self, other: &AddressContext) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for AddressContext

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for AddressContext

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

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Serialize for AddressContext

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub<u64> for AddressContext

type Output = AddressContext

The resulting type after applying the - operator.

fn sub(self, rhs: u64) -> Self::Output

Performs the - operation.

impl Sub for AddressContext

type Output = AddressContext

The resulting type after applying the - operator.

fn sub(self, rhs: AddressContext) -> Self::Output

Performs the - operation.

impl SubAssign<u64> for AddressContext

fn sub_assign(&mut self, rhs: u64)

Performs the -= operation.

impl SubAssign for AddressContext

fn sub_assign(&mut self, rhs: AddressContext)

Performs the -= operation.

impl Copy for AddressContext

impl Eq for AddressContext

impl StructuralPartialEq for AddressContext