Patcherex2

Patcherex2 is a rewritten adaptation of the original Patcherex project, aimed at building upon its core ideas and extending its capabilities.

Installation

Patcherex2 is available on PyPI and can be installed using pip. Alternatively, you can use the provided Docker image.

pip

pip install patcherex2

Install from latest commit

pip install git+https://github.com/purseclab/Patcherex2.git

Docker

docker run --rm -it -v ${PWD}:/workdir -w /workdir ghcr.io/purseclab/patcherex2

Build from latest commit

docker build -t patcherex2 --platform linux/amd64 https://github.com/purseclab/Patcherex2.git
docker run --rm -it -v ${PWD}:/workdir -w /workdir patcherex2

Usage

You can find usage examples here.

Documentation

General documentation and API reference for Patcherex2 can be found at purseclab.github.io/Patcherex2.

Supported Targets

	Linux x86	Linux amd64	Linux arm	Linux aarch64	Linux PowerPC (32bit)	Linux PowerPC (64bit)	Linux PowerPCle (64bit)	Linux MIPS (32bit)	Linux MIPS (64bit)	Linux MIPSEL ​(32bit)	Linux MIPSEL (64bit)	SPARCv8 (LEON3)	PowerPC (VLE) (IHEX)
InsertDataPatch	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	⬜	⬜
RemoveDataPatch	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	⬜	⬜
ModifyDataPatch	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	⬜	⬜
InsertInstructionPatch (ASM)	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	⬜	⬜
InsertInstructionPatch (C)	🟥	🟩	🟥	🟩	🟥	🟥	🟥	🟥	🟥	🟥	🟥	🟥	🟥
RemoveInstructionPatch	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	⬜	⬜
ModifyInstructionPatch	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	⬜	⬜
InsertFunctionPatch	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	🟩	⬜	⬜
ModifyFunctionPatch	🟨	🟩	🟩	🟩	🟨	🟨	🟨	🟨	🟨	🟨	🟨	⬜	⬜

🟩 Fully Functional, 🟨 Limited Functionality, 🟥 Not Working, ⬜ Not Tested, 🟪 Work in Progress

Acknowledgements

This project was developed as part of the DARPA AMP program, under contract N6600120C4031.