dismount

Dismonut is a cross-compile, cross-platform C++ library that implements generic assembler and disassembler. The library includes an easy abstraction layer for OS-dependent code.

Requirements

Windows

Need Visual Studio Express 2010 or higher, or Visual Studio 2010 or higher.

Ubuntu (Debian)

sudo apt-get install automake autoconf libtool build-essential git-core

CentOS/Fedora/Redhat

• Building tools sudo yum install autoconf automake gcc-c++ sudo dnf install autoconf automake gcc-c++

Some distributions of CentOS have a problem with libstd++ (need to check). For some reason the symbol __cxa_get_exception_ptr is not defined.

ArchLinux

• Building tools sudo pacman -S base-devel automake autoconf git sudo pacman -S gcc-multilib libtool-multilib binutils-multilib

Cygwin

Install cygwin with the following packages:

• gcc
• g++
• automake
• autoconf
• libtool

Setting Up Environment

Git

git clone https://github.com/eladraz/xStl
git clone https://github.com/eladraz/dismount

Set up the following environment variables:

export XSTL_PATH=`pwd`/xStl
export DISMOUNT_PATH=`pwd`/dismount

In order to test flow-Mapper you should also include

export PELIB_PATH=`pwd`/pe

Windows

In order to pass variable arguments to Visual Studio, you need to declare the following system arguments:

• XSTL_PATH (for example: C:\WORK\github\xStl)
• DISMOUNT_PATH (for example: C:\WORK\github\dismount)
• PELIB_PATH (optional)

To add system variables you should:

• Right-click My Computer, and then click Properties.
• Click the Advanced tab.
• Click Environment variables.
• Click New to add a new variable name (e.g. DISMOUNT_PATH) and its location (e.g. C:\WORK\github\dismount).

How to Build

CMake

CMake is cross-compile system for many platform and many system. You can read about it more here

Here is a quick example on how to run xStl with ninja build:

mkdir build
cd build
cmake -G Ninja ..
ninja -j

Windows

In order to build the dismount library, open dismount.sln solution project with Visual Studio. In Visual Studio's configuration manager, choose the desired build configuration (Win32/x64/Debug/Release) and build dismount.

Linux

Compilation Shortcut (build.sh script)

Build all projects (the default configuration of the compilation script is the debug/unicode version):

cd dismount
./build.sh
cd ../

In order to compile dismount you can simply run build.sh:

#/bin/sh
PWD=`pwd`
./autogen.sh && ./configure [--prefix=${PWD}/out] [--enable-debug] [--enable-unicode] [--enable-tests] && make -j4 && make install

Compile

1. Run ./autogen.sh in order to generate Makefile configure script.
2. Run ./configure to generate Makefile (see Configure Argument section, below).
3. Run make and make install.

Configure Argument

• --enable-debug Compile with debugging flags
• --enable-unicode Compile with UNICODE support
• --enable-tests Compile dismount unit-tests

Cross-Compile

In order to cross-compile (ARM, for example):

./autogen.sh
./configure --build= --host=arm-none-linux-gnueabi

Please note that it is important to have a PATH to the cross-compiler bin folder (e.g. arm-none-linux-gnueabi-g++).

License

Please see LICENSE file