eqqlyz / boomerang

Boomerang Decompiler - Fighting the code-rot :)

Welcome to boomerang decompiler

This repository is now connected to continous integration server: http://jenkins.nemerle.eu Generated documentation is available at http://jenkins.nemerle.eu/job/boomerang/doxygen/

This is an experimental branch of boomerang project, the inital goals are:

1. Try to fix all warnings from GCC and Clang's -Wall
2. Verify stability of decompilation results: compare 2 run results, they should be exactly the same.
3. Simplify code base using features available in c++11

Considering part 3, the target compilers are GCC >=4.6 family (MinGW on windows), Clang and MSVC>=2015.

For full ( and slightly stale :) ) build instructions please see

http://boomerang.sourceforge.net/making.php

Compiling the next branch

Note that on a debian system you can usually get away with:

sudo apt-get install git cmake qt5-default
cd YOUR_FAVOURITE_DEVELOPMENT_DIRECTORY
git clone git://github.com/nemerle/boomerang.git
cd boomerang
mkdir build && cd build
cmake ..
make

To compile on windows, it should be enough to have:

• CMake 3.1.0 or newer
• Qt5 for MinGW
• QtCreator (installed with Qt5)

Testing

After building boomerang You can run the test suite, to do that you will need ruby interpeter and a bash compatible shell.

  ./full_regression.sh

After running full_regression, the tool will report tests on which boomerang crashed. You can also check if Your changes to boomerang, produced any changes in the quality of decompiled code by running YOUR_FAVOURITE_DIFF_GUI ./tests/outputs ./tests/baseline

Additionally, if You enable the test suite option in ( CMake option ), boomerang unit-test can be run by

make test

Thanks.