Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
65 lines (38 sloc) 1.99 KB

This documentation explains how to build Keystone on Windows. For *nix OS, see COMPILE-NIX.md

  1. Dependency

    CMake is required as dependency. Download & install cmake from http://www.cmake.org

    Microsoft Visual Studio 2013 or older is required for compiling. Download & install it from https://www.visualstudio.com

    Python is another dependency. Download & install it from https://www.python.org

  2. Open the Visual Studio Command Prompt, and from the root directory of Keystone source, do:

      $ mkdir build
      $ cd build
    

    To build DLL file, run:

      $ ..\nmake-dll.bat
    

    By default, this builds all architectures, which is: AArch64, ARM, Hexagon, Mips, PowerPC, Sparc, SystemZ & X86. To compile just some selected ones, pass a semicolon-separated list of targets to LLVM_TARGETS_TO_BUILD, like follows if we only want AArch64 & X86.

      $ cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=ON -DLLVM_TARGETS_TO_BUILD="AArch64;X86" -G "NMake Makefiles" ..
      $ nmake
    

    To build LIB file, run:

      $ ..\nmake-lib.bat
    

    Like above, this builds all architectures. To compile just some selected ones, pass a semicolon-separated list of targets to LLVM_TARGETS_TO_BUILD, like follows if we only want AArch64 & X86.

      $ cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF -DLLVM_TARGETS_TO_BUILD="AArch64, X86" -G "NMake Makefiles" ..
      $ nmake
    

    Find the generated libraries in build\llvm\lib\keystone.{dll,lib}

    In the case you build LIB file, a tool named "kstool.exe" is also compiled & available under directory "build\kstool". (Find source of "kstool" in directory "kstool/kstool")

  3. Test Keystone with "kstool" like below.

    $ kstool.exe x32 "add eax, ebx"
    

    Run "kstool.exe" without any option to find out how to use this handy tool.

  4. Learn more on how to code your own tools with our samples.

    For C sample code, see code in directory samples/

    For Python sample code, see code in directory bindings/python/