COMPILE

How To Compile & Run Capstone for Linux, Mac OSX, *nix and Windows
                        *-*-*-*-*-*


Capstone requires no prerequisite packages, so it is easy to compile & install.


(1) On Linux, Mac OSX or *nix:

- To compile for current platform, run either:
		$ ./compile.sh
	or:
		$ make

	Then run "./tests/test*" to see the tests disassembling sample code.

- On 64-bit OS, run command below to cross-compile Capstone for 32-bit binary:

	$ ./compile.sh nix32

	Then similarly, run "./tests/test*" to see the tests disassembling sample code.



(2) To install Capstone, run:

	$ sudo make install
	
Users are then required to enter root password to copy Capstone into machine
system directories.

NOTE: The core framework that will be installed by "make install" consist of
only following files:

	/usr/include/capstone/capstone.h
	/usr/include/capstone/x86.h
	/usr/include/capstone/arm.h
	/usr/include/capstone/arm64.h
	/usr/include/capstone/mips.h
	/usr/lib/libcapstone.so (for Linux/*nix), or /usr/lib/libcapstone.dylib (OSX)



(3) To cross-compile for Windows, Linux & gcc-mingw-w64-i686 (and also gcc-mingw-w64-x86-64
for 64-bit binaries) are required.

	- To cross-compile Windows 32-bit binary, simply run
		$ ./compile.sh cross-win32

	- To cross-compile Windows 64-bit binary, simply run
		$ ./compile.sh cross-win64

Resulted files "capstone.dll" and "tests/test*.exe" can then be used on Windows machine.



(4) To compile under Cygwin gcc-mingw-w64-i686 or x86_64-w64-mingw32 run:

        - To compile Windows 32-bit binary under Cygwin, simply run
                $ ./compile.sh cygwin-mingw32

        - To compile Windows 64-bit binary under Cygwin, simply run
                $ ./compile.sh cygwin-mingw64


(5) By default, gcc is used as compiler. To use "clang" compiler instead, run command below:

	$ ./compile.sh clang


(6) So far, Python, Ruby, Ocaml, Java, C# and Go are supported by bindings. Look for
the bindings under directory bindings/, and refer to README file of corresponding languages.

For each binding, the common method to compile its code is to run the command below
from the directory of the binding (such as in ./bindings/python/ for Python and so on)

	$ make

For some bindings (such as Python), the code can be installed into system with:

	$ sudo make install