diff --git a/README.md b/README.md new file mode 100644 index 0000000..b12aa67 --- /dev/null +++ b/README.md @@ -0,0 +1,70 @@ +ROPGenerator +============ + +ROPGenerator is a tool that makes ROP exploits easy. It enables you to automatically find gadgets or build ROP chains. +The current version supports *x86* and *x64* binaries. + +Overview +-------- +ROPGenerator uses the tool ROPgadget (https://github.com/JonathanSalwan/ROPgadget) to extract gadgets from binaries and the barf-project (https://github.com/programa-stic/barf-project) to disassembly them. After gadgets are extracted, it analyzes them in order to compute their semantic and stores them according to their usefullness. Once the analysis is done, you can request ROPGenerator to automatically find gadgets or ROP chains by supplying semantic queries. + +ROPGenerator is written in python. The tool has python2-only dependencies so it runs under python2 so far. + +**Note**: Version is now released with: faster gadget search, more chaining strategies, more advanced exploit features ! + +Why using ROPGenerator ? +---------------------------- +- **Nice Command Line Interface** : Enjoy a nice and smooth CLI with easy-to-use commands +- **Semantic gadget search** : Find your gadgets quickly by only specifying the desired semantics +- **Gadget chaining engine** : No suitable single gadget ? ROPGenerator will build ROP chains for you +- **Fully automated exploit building** : ROPGenerator can build entire exploits... all by itself ! + +Installation +============ +Install ROPGenerator +-------------------- +You can download the source and run + + $ python setup.py install + $ ROPGenerator + + +Install Dependencies +-------------------- +**ROPGenerator** depends on **ROPgadget**, **prompt_toolkit**, **enum**, **python-magic**, and **barf v0.5.0**: +- **python-magic**, **enum**, **barf v0.5.0**, and **prompt_toolkit** packages will be added automaticaly during installation +- **ROPgadget** need to be installed manually from the github repo since the currently available package on pypi is not up-to-date (version 5.6 is required). + +Simply run + + $ git clone https://github.com/JonathanSalwan/ROPgadget + $ cd ROPgadget && python setup.py install + + +Getting started +=============== +ROPGenerator is very easy to use ! +For a quick starting guide, check [**ROPGenerator's Wiki**](https://github.com/Boyan-MILANOV/ropgenerator/wiki) + +See also the screenshots below ! + +Screenshots +=============== +Launch **ROPGenerator** + +![Alt text](/screenshots/start.png?raw=true) + +Get help + +![Alt text](/screenshots/help.png?raw=true) + +Load gadgets from a binary + +![Alt text](/screenshots/load.png?raw=true) + +Easily look for gadgets ! + +![Alt text](/screenshots/search1.png?raw=true) +![Alt text](/screenshots/search2.png?raw=true) +![Alt text](/screenshots/search3.png?raw=true) +![Alt text](/screenshots/search4.png?raw=true)