Type Definition process_memory::ProcessHandle

pub type ProcessHandle = (mach_port_name_t, Architecture);

On OS X a ProcessHandle is a mach port.

Trait Implementations

impl CopyAddress for ProcessHandle

Use vm_read_overwrite to read memory from another process on OS X.

We use vm_read_overwrite instead of vm_read because it can handle non-aligned reads and won’t read an entire page.

fn get_pointer_width(&self) -> Architecture

Get the the pointer width of the underlying process. This is required for get_offset to work.

fn copy_address(&self, addr: usize, buf: &mut [u8]) -> Result<()>

Copy an address into user-defined buffer.

fn get_offset(&self, offsets: &[usize]) -> Result<usize>

Get the actual memory location from a set of offsets.

impl ProcessHandleExt for ProcessHandle

fn check_handle(&self) -> bool

Returns true if the ProcessHandle is not null, and false otherwise.

fn null_type() -> ProcessHandle

Return the null equivalent of a ProcessHandle.

fn set_arch(self, arch: Architecture) -> Self

Set this handle to use some architecture

impl PutAddress for ProcessHandle

Here we use mach_vm_write to write a buffer to some arbitrary address on a process.

fn put_address(&self, addr: usize, buf: &[u8]) -> Result<()>

Put the data from a user-defined buffer at an address.

impl TryIntoProcessHandle for ProcessHandle

fn try_into_process_handle(&self) -> Result<ProcessHandle>

Attempt to turn a type into a ProcessHandle. Whilst Linux provides the same type for Pids and ProcessHandles, Windows and macOS do not. As such, you need to ensure that try_into_process_handle is called on all Pids to ensure cross-platform capabilities.