Skip to content

Commit

Permalink
Add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Boyan-MILANOV authored Oct 5, 2018
1 parent 8ebe17f commit 630eeeb
Showing 1 changed file with 70 additions and 0 deletions.
70 changes: 70 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -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)

0 comments on commit 630eeeb

Please sign in to comment.