18 stable releases

new 5.9.17 Jun 3, 2024
5.9.6 Apr 7, 2024
5.9.5 Mar 20, 2024
5.8.14 Oct 19, 2023
5.4.4 Mar 13, 2023

#67 in Operating systems

Download history 7/week @ 2024-02-14 109/week @ 2024-02-21 127/week @ 2024-02-28 40/week @ 2024-03-06 146/week @ 2024-03-13 231/week @ 2024-03-20 41/week @ 2024-03-27 162/week @ 2024-04-03 38/week @ 2024-04-10 12/week @ 2024-04-17 73/week @ 2024-04-24 19/week @ 2024-05-01 279/week @ 2024-05-08 48/week @ 2024-05-15 28/week @ 2024-05-22 157/week @ 2024-05-29

517 downloads per month

AGPL-3.0-or-later

340KB
5K SLoC

MemProcFS Rust API

The MemProcFS crate contains a wrapper API around the MemProcFS physical memory analysis framework. The native libray in the form of vmm.dll or vmm.so must be compiled or downloaded in order to make use of the memprocfs rust crate.

The aim of the MemProcFS Rust Crate and API is to make MemProcFS usage easy and smooth on Rust! Please let me know what you think or if you have any improvement suggestions!

Physical memory analysis may take place on memory dump files for forensic purposes. Analysis may also take place on live memory - either captured by using PCILeech PCIe DMA devices or by using drivers - such as WinPMEM, LiveCloudKd, VMware or similar.

Rust API Versioning follows MemProcFS major.minor versioning. Always use the matching MemProcFS Native library version for the major.minor number. Revision numbers may however be higher (but not lower) in the Native library than in the Rust API. Bug fixes often takes place in the Native library without the Rust API being updated. It's possible to use Rust API version 5.8.1 with MemProcFS 5.8.10 for example. It is not supported to use Rust API version 5.8.1 with MemProcFS 5.7.x or MemProcFS 5.9.x.

Base of the MemProcFS API is the Vmm struct. Once the native vmm has been initialized it's possible to retrieve processes in the form of the VmmProcess struct. Using the Vmm and VmmProcess it's possible to undertake a wide range of actions - such as reading/writing memory and retrieving various information.

Read and write memory by using the methods mem_read(), mem_read_ex(), mem_write() of the Vmm and VmmProcess structs.

Efficiently read and write memory using the VmmScatterMemory struct.

Get info about loaded modules, memory regions, registry, process handles, kernel pool allocations and much more!

Access the VFS (Virtual File System) via the Rust API to get access to the full range of built-in and external plugins.

The MemProcFS rust API supports creation of native MemProcFS plugins in the form of a library .dll or .so for the more advanced user.

Examples

// Initialize MemProcFS on Linux targeting a live Windows system
// by reading memory using a PCILeech PCIe FPGA hardware device.
// After initialization list all processes.
let mut args = ["-printf", "-device", "fpga"].to_vec();
let vmm = Vmm::new("/home/user/memprocfs/vmm.so", &args)?
if let Ok(process_all) = vmm.process_list() {
    for process in &*process_all {
        println!("{} : {}", process.pid, process.info()?.name);
    }
}
// Initialize MemProcFS on Windows - analyzing a memory dump file.
// Also trigger the forensic mode and scan for VMs.
// List all processes in the virtual file system directory /name/.
let mut args = ["-printf", "-forensic", "1", "-vm",
                "-device", "C:\\dumps\\memory.dmp"].to_vec();
let vmm = Vmm::new("C:\\MemProcFS\\vmm.dll", &args)?
if let Ok(vfs_all) = vmm.vfs_list("/name/") {
    println!("Number of files/directories: {}.", vfs_all.len());
    for vfs in &*vfs_all {
        println!("{vfs}");
    }
}

Example projects

Check out the example project and the example MemProcFS plugin.

Project documentation

Check out the project documentation for MemProcFS, LeechCore and pcileech-fpga:

Questions and Comments

Please feel free to contact me!

Get Started!

Check out the MemProcFS documentation and the example project!

Best wishes with your Rust memory analysis project!

Dependencies

~0.6–6MB
~27K SLoC