Struct LocalMember

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

This struct 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, unsafe { 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);

Safety

These functions are technically not safe. Do not attempt to read or write to any local memory that you do not know is correct. If you’re trying to explore your entire address space or are testing to see if a pointer is allocated to you, use DataMember with your own PID.

Unfortunately it’s not possible to implement some traits safely (e.g. Memory on DataMember but implement it on other structures unsafely in Rust.

The implemented functions try to stop you from shooting yourself in the foot by checking none of the pointers end up at the null pointer, but this does not guarantee that you won’t be able to mess something up really badly in your program.

Implementations

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

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.

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 duplicate 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>

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

This will only return a error if one of the offsets gives a null pointer. or give a non-aligned read

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

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

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.