Trait MemoryRead 

pub trait MemoryRead {
    // Required method
    fn try_read_bytes_into(&self, address: u64, buffer: &mut [u8]) -> Option<()>;

    // Provided methods
    fn try_read_bytes(&self, address: u64, len: usize) -> Option<Vec<u8>> { ... }
    fn dump_memory(&self, range: MemoryRange) -> Option<Vec<u8>> { ... }
    fn valid_address(&self, address: u64) -> bool { ... }
    fn try_read_string(
        &self,
        address: u64,
    ) -> Option<Result<String, FromUtf8Error>> { ... }
    fn try_read_string_wide(
        &self,
        address: u64,
    ) -> Option<Result<String, FromUtf16Error>> { ... }
}

Represents any type with a buffer that can be read from

Required Methods

fn try_read_bytes_into(&self, address: u64, buffer: &mut [u8]) -> Option<()>

Reads bytes from the process at the specified address into a buffer. Returns None if the address is not valid

Provided Methods

fn try_read_bytes(&self, address: u64, len: usize) -> Option<Vec<u8>>

Reads bytes from the process at the specified address and returns the bytes as a Vector. Returns none if the address is not valid

fn dump_memory(&self, range: MemoryRange) -> Option<Vec<u8>>

Dumps a memory range into a Vector. If any part of the memory range is not valid, it will return None

fn valid_address(&self, address: u64) -> bool

Returns true if the specified address is valid. By default reads one byte at that location and returns the success value

fn try_read_string(&self, address: u64) -> Option<Result<String, FromUtf8Error>>

Reads a string at the specified location with char length of 1. If the address is valid or there is no null terminator in MAX_STRING_SIZE characters, it will return None

fn try_read_string_wide( &self, address: u64, ) -> Option<Result<String, FromUtf16Error>>

Reads a wide string at the specified location with char length of 1. If the address is valid or there is no null terminator in MAX_STRING_SIZE characters, it will return None

Trait Implementations

impl MemoryReadExt for dyn MemoryRead

fn try_read<T: Pod>(&self, address: u64) -> Option<T>

Reads bytes from the process at the specified address into a value of type T. Returns None if the address is not valid

unsafe fn try_read_unchecked<T>(&self, address: u64) -> Option<T>

Reads any type T from the process without the restriction of Pod

fn read<T: Pod>(&self, address: u64) -> T

Reads bytes from the process at the specified address into a value of type T. Panics if the address is not valid

fn try_read_bytes_const<const LEN: usize>( &self, address: u64, ) -> Option<[u8; LEN]>

Reads a const number of bytes from the process returning a stack allocated array.

fn try_read_bytes_into_chunked<const CHUNK_SIZE: usize>( &self, address: u64, buf: &mut [u8], ) -> Option<()>

Reads bytes from the process in chunks with the specified size

fn try_read_bytes_into_chunked_fallible<const CHUNK_SIZE: usize>( &self, address: u64, buf: &mut [u8], ) -> Option<usize>

Reads bytes from the process in chunks with the specified size. The function will return Some(n) with the number of bytes read unless every single chunk fails

Implementations on Foreign Types

impl<'a> MemoryRead for &'a [u8]

fn try_read_bytes_into(&self, address: u64, buffer: &mut [u8]) -> Option<()>

impl<'a, T: 'a + MemoryRead + ?Sized> MemoryRead for &'a T

fn try_read_bytes_into(&self, address: u64, buffer: &mut [u8]) -> Option<()>

fn try_read_bytes(&self, address: u64, len: usize) -> Option<Vec<u8>>

fn dump_memory(&self, range: MemoryRange) -> Option<Vec<u8>>

fn valid_address(&self, address: u64) -> bool

fn try_read_string(&self, address: u64) -> Option<Result<String, FromUtf8Error>>

fn try_read_string_wide( &self, address: u64, ) -> Option<Result<String, FromUtf16Error>>

impl<'a, T: 'a + MemoryRead + ?Sized> MemoryRead for &'a mut T

fn try_read_bytes_into(&self, address: u64, buffer: &mut [u8]) -> Option<()>

fn try_read_bytes(&self, address: u64, len: usize) -> Option<Vec<u8>>

fn dump_memory(&self, range: MemoryRange) -> Option<Vec<u8>>

fn valid_address(&self, address: u64) -> bool

fn try_read_string(&self, address: u64) -> Option<Result<String, FromUtf8Error>>

fn try_read_string_wide( &self, address: u64, ) -> Option<Result<String, FromUtf16Error>>

impl<T: AsRef<[u8]>> MemoryRead for Cell<T>

fn try_read_bytes_into(&self, address: u64, buffer: &mut [u8]) -> Option<()>

impl<T: MemoryRead + ?Sized> MemoryRead for Box<T>

fn try_read_bytes_into(&self, address: u64, buffer: &mut [u8]) -> Option<()>

fn try_read_bytes(&self, address: u64, len: usize) -> Option<Vec<u8>>

fn dump_memory(&self, range: MemoryRange) -> Option<Vec<u8>>

fn valid_address(&self, address: u64) -> bool

fn try_read_string(&self, address: u64) -> Option<Result<String, FromUtf8Error>>

fn try_read_string_wide( &self, address: u64, ) -> Option<Result<String, FromUtf16Error>>

Implementors

impl<T> MemoryRead for AttachedProcess<'_, T>

where T: MemoryReadPid,