Struct process_memory::LocalMember

pub struct LocalMember<T> { /* fields omitted */ }

Tools for working with local memory

This module provides functions for modifying the memory of a program from within the address space of that program. This may be helpful for debug functions, or for an injected DLL.

Examples:

// We have a variable with some value
let x = 4u32;

// We make a `LocalMember` that has an offset referring to its location in memory
let member = LocalMember::new_offset(vec![&x as *const _ as usize]);
// The memory refered to is now the same
assert_eq!(&x as *const _ as usize, member.get_offset().unwrap());
// The value of the member is the same as the variable
assert_eq!(x, member.read().unwrap());
// We can write to and modify the value of the variable using the member
member.write(&6u32).unwrap();
assert_eq!(x, 6u32);

Methods

impl<T: Sized + Copy> LocalMember<T>

#[must_use] pub fn new() -> Self

Creates a new LocalMember with no offsets. Any calls to Memory::read will attempt to read from a null pointer reference.

To set offsets, use Memory::set_offsetoffset), or create the LocalMember using new_offset.

#[must_use] pub fn new_offset(offsets: Vec<usize>) -> Self

Create a new LocalMember with a given set of offsets.

Trait Implementations

impl<T: Clone> Clone for LocalMember<T>

fn clone(&self) -> LocalMember<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for LocalMember<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for LocalMember<T>

fn default() -> LocalMember<T>

Returns the "default value" for a type.

impl<T: Sized + Copy> Memory<T> for LocalMember<T>

fn set_offset(&mut self, new_offsets: Vec<usize>)

Set the offsets to the location in memory. This is used for things such as multi-level pointers, such as a Vec<Vec<T>> or a Vec<String>.

fn get_offset(&self) -> Result<usize>

Gets the actual total offset from the offsets given by [Memory::set_offset].

fn read(&self) -> Result<T>

This will only return a error if one of the offsets gives a null pointer.

fn write(&self, value: &T) -> Result<()>

This will only return a error if one of the offsets gives a null pointer.