Struct CachedPhysicalMemory 

pub struct CachedPhysicalMemory<'a, T, Q> { /* private fields */ }

The cache object that can use as a drop-in replacement for any Connector.

Since this cache implements PhysicalMemory it can be used as a replacement in all structs and functions that require a PhysicalMemory object.

Implementations

impl<'a, T, Q> CachedPhysicalMemory<'a, T, Q>

where T: PhysicalMemory, Q: CacheValidator,

pub fn new(mem: T, cache: PageCache<'a, Q>) -> CachedPhysicalMemory<'a, T, Q>

Constructs a new cache based on the given PageCache.

This function is used when manually constructing a cache inside of the memflow crate itself.

For general usage it is advised to just use the builder to construct the cache.

pub fn into_inner(self) -> T

Consumes self and returns the containing memory object.

This function can be useful in case the ownership over the memory object has been given to the cache when it was being constructed. It will destroy the self and return back the ownership of the underlying memory object.

Examples

use memflow::architecture::x86::x64;
use memflow::mem::{PhysicalMemory, CachedPhysicalMemory, MemoryView};

fn build<T: PhysicalMemory>(mem: T) -> T {
    let mut cache = CachedPhysicalMemory::builder(mem)
        .arch(x64::ARCH)
        .build()
        .unwrap();

    // use the cache...
    let value: u64 = cache.phys_view().read(0.into()).unwrap();
    assert_eq!(value, MAGIC_VALUE);

    // retrieve ownership of mem and return it back
    cache.into_inner()
}

impl<'a, T> CachedPhysicalMemory<'a, T, TimedCacheValidator>

where T: PhysicalMemory,

pub fn builder(mem: T) -> CachedPhysicalMemoryBuilder<T, TimedCacheValidator>

Returns a new builder for this cache with default settings.

Trait Implementations

impl<'a, T, Q> Clone for CachedPhysicalMemory<'a, T, Q>

where T: Clone, Q: CacheValidator + Clone,

fn clone(&self) -> CachedPhysicalMemory<'a, T, Q>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'cglue_a, CGlueInst, CGlueCtx, T, Q> ConnectorInstanceVtableFiller<'cglue_a, CGlueInst, CGlueCtx> for CachedPhysicalMemory<'cglue_a, T, Q>

where CGlueInst: Deref<Target = CachedPhysicalMemory<'cglue_a, T, Q>>, CGlueCtx: ContextBounds, T: PhysicalMemory, Q: CacheValidator,

fn fill_table( table: ConnectorInstanceVtables<'cglue_a, CGlueInst, CGlueCtx>, ) -> ConnectorInstanceVtables<'cglue_a, CGlueInst, CGlueCtx>

impl<'a, T, Q> PhysicalMemory for CachedPhysicalMemory<'a, T, Q>

where T: PhysicalMemory, Q: CacheValidator,

fn phys_read_raw_iter( &mut self, data: MemOps<'_, '_, '_, CTup3<PhysicalAddress, Address, CSliceMut<'_, u8>>, CTup2<Address, CSliceMut<'_, u8>>>, ) -> Result<(), Error>

fn phys_write_raw_iter( &mut self, _: MemOps<'_, '_, '_, CTup3<PhysicalAddress, Address, CSliceRef<'_, u8>>, CTup2<Address, CSliceRef<'_, u8>>>, ) -> Result<(), Error>

fn metadata(&self) -> PhysicalMemoryMetadata

Retrieve metadata about the physical memory

fn set_mem_map(&mut self, mem_map: &[PhysicalMemoryMapping])

Sets the memory mapping for the physical memory

fn phys_read_into<T>( &mut self, addr: PhysicalAddress, out: &mut T, ) -> Result<(), Error>

where T: Pod + ?Sized, Self: Sized,

fn phys_write<T>( &mut self, addr: PhysicalAddress, data: &T, ) -> Result<(), Error>

where T: Pod + ?Sized, Self: Sized,

fn into_phys_view(self) -> PhysicalMemoryView<Self>

where Self: Sized,

fn phys_view(&mut self) -> PhysicalMemoryView<Fwd<&mut Self>>

where Self: Sized,

fn into_mem_view(self) -> PhysicalMemoryView<Self>

where Self: Sized,

fn mem_view(&mut self) -> PhysicalMemoryView<Fwd<&mut Self>>

where Self: Sized,