Files

T

iris 00cc9309cb Squashed 'external/ircolib/' changes from ce3cd726c..de6e324bd

de6e324bd separate emu thread
10d3daf86 Roms List improvements
95d202f37 Let's make the rom list process on a separate thread so the emulator doesnt take ages to load.
fc306967f Wow the ROM Header was just completely busted. Game list view works now
bad1691ee fuck this shit
2b59e5f46 game list in progress
d26417b83 remappable inputs in progress
ac4af8106 input
e72abc240 update readme
430139dc9 Qt6 frontend
3080d4d45 Fix this small bug too
08cd13b85 Cop0 unused functions do not actually pose a threat (as per manual). They don't do anything, so shall we.
61bb4fb44 make idle loop detection a little more specific with where the load goes
b037de4c3 SAZDFsdff
12e81e73e need to figure out why n64-systemtest loops indefinitely at some address that appears to be valid (i think it's me not invalidating the cache properly)
204f0e13b idle skipping seems to work!
cb8bb634a sdkfjlasdf
58e5c89c1 Fix compilation issue on my machine (no idea)
24fb2898e attempting more serious idle skipping
214719577 Place rsp.Step inside cached interpreter. Gains about 3 more fps
bb97dcc23 mmmmm
920b77d38 wjkhasdfjhkasdf
430ccdab4 it's a start...
4f42a673a Cached interpreter plays Mario 64. Start looking into RSP as well
c9a030787 idle skipping works!
5fbda03ce new idea
366637aba Idle skipping... maybe?
609fa2fb0 Cache instructions implemented but broken lmao. Commented out for now
e140a6d12 - Stop using inheritance for CPU, instead use composition. - Introduce KAIZEN_JIT_ENABLED optional define instead of relying on __aarch64__ and the like. - More cache work
68e613057 prep cache impl
811b4d809 fix clang format
fda755f7d idk
d5024ebbf small MI refactor in preparation of (eventually) implementing the RDRAM interface properly
694b45341 Merge commit '206dcdedf195fb320913584180edb12c7731e396' as 'external/SDL'
206dcdedf Squashed 'external/SDL/' content from commit 4d17b99d0a
4d16e1cb4 need to update sdl
848b19920 Fix compilation error
db61b5299 Merge commit 'e94a94559f28e49678fbcf72199a5258137b0fe9' as 'external/imgui'
e94a94559 Squashed 'external/imgui/' content from commit 02e9b8cac
52edb3757 need to update imgui
c1a705e86 Emulate weird JALR behaviour
4b4c32f4b Fix exception for "unusable COP1" in 4 instructions i missed accidentally (again)
df5828142 Bug putting 0s in the log everywhere
f8b580048 Make isviewer a sink to file
8241e9735 Fix exception for "unusable COP1" in 4 instructions i missed accidentally
b29715f20 small changes
d9a620bc1 make use of my new small utility library
0d1aa938e Add 'external/ircolib/' from commit 'ce3cd726c8df8388d554abf8bb55d55020eb4450'
e64eb40b3 Fuck git

git-subtree-dir: external/ircolib
git-subtree-split: de6e324bde

2026-06-15 11:56:38 +02:00

4.6 KiB

Raw Blame History

Building Capstone

This guide describes how to build Capstone with CMake.

Build commands

Unix

cmake -B build -DCMAKE_BUILD_TYPE=Release # For debug build change "Release" to "Debug"
cmake --build build
cmake --install build --prefix "<install-prefix>"

To create rpm, debian and OSX packages, run the following

cmake -B build -DCMAKE_BUILD_TYPE=Release -DCAPSTONE_BUILD_SHARED_LIBS=1 -DCMAKE_INSTALL_PREFIX=/usr
cmake --build build
cd build
cpack -G DEB
cpack -G RPM
cpack -G DragNDrop

Windows

cmake.exe -B build
cmake.exe --build build --config Release # For debug build change "Release" to "Debug"
cmake.exe --install build

Tailor Capstone to your needs.

Enable and disable options in the "configure" step (first cmake command from above). Options are added with -D<OPTION>=ON/OFF or -D<OPTION>=1/0

Exclude architecture modules

You can build Capstone with only the architectures you need. By default all are enabled.

CAPSTONE_ARCHITECTURE_DEFAULT: Whether all architectures are enabled by default.
CAPSTONE_ARM_SUPPORT: Support ARM.
CAPSTONE_AARCH64_SUPPORT: Support AARCH64.
CAPSTONE_ALPHA_SUPPORT: Support Alpha.
CAPSTONE_ARC_SUPPORT: Support ARC.
CAPSTONE_HPPA_SUPPORT: Support HPPA.
CAPSTONE_LOONGARCH_SUPPORT: Support LoongArch.
CAPSTONE_M680X_SUPPORT: Support M680X.
CAPSTONE_M68K_SUPPORT: Support M68K.
CAPSTONE_MIPS_SUPPORT: Support Mips.
CAPSTONE_MOS65XX_SUPPORT: Support MOS65XX.
CAPSTONE_PPC_SUPPORT: Support PPC.
CAPSTONE_SPARC_SUPPORT: Support Sparc.
CAPSTONE_SYSTEMZ_SUPPORT: Support SystemZ.
CAPSTONE_XCORE_SUPPORT: Support XCore.
CAPSTONE_TRICORE_SUPPORT: Support TriCore.
CAPSTONE_X86_SUPPORT: Support X86.
CAPSTONE_TMS320C64X_SUPPORT: Support TMS320C64X.
CAPSTONE_M680X_SUPPORT: Support M680X.
CAPSTONE_EVM_SUPPORT: Support EVM.
CAPSTONE_WASM_SUPPORT: Support Web Assembly.
CAPSTONE_BPF_SUPPORT: Support BPF.
CAPSTONE_RISCV_SUPPORT: Support RISCV.

Module registration

If you're building a static library that you intend to link into multiple consumers, and they have differing architecture requirements, you may want -DCAPSTONE_USE_ARCH_REGISTRATION=1.

In your consumer code you can call cs_arch_register_*() to register the specific module for initialization.

In this way you only pay footprint size for the architectures you're actually using in each consumer, without having to compile Capstone multiple times.

Additional options

Capstone allows some more customization via the following options:

CAPSTONE_BUILD_SHARED_LIBS: Build shared libraries.
CAPSTONE_BUILD_STATIC_LIBS: Build static libraries (ON by default).
CAPSTONE_BUILD_STATIC_MSVC_RUNTIME: (Windows only) - Build with static MSVC runtime. Always set if CAPSTONE_BUILD_SHARED_LIBS=ON.
CAPSTONE_BUILD_CSTOOL: Enable/disable build of cstool. Default is enabled if build runs from the repository root.
CAPSTONE_USE_SYS_DYN_MEM: change this to OFF to use your own dynamic memory management.
CAPSTONE_BUILD_MACOS_THIN: MacOS only. Disables universal2 build. So you only get the binary for you processor architecture.
CAPSTONE_BUILD_DIET: change this to ON to make the binaries more compact.
CAPSTONE_X86_REDUCE: change this to ON to make X86 binary smaller.
CAPSTONE_X86_ATT_DISABLE: change this to ON to disable AT&T syntax on x86.

By default, Capstone use system dynamic memory management, and both DIET and X86_REDUCE modes are disabled. To use your own memory allocations, turn ON both DIET & X86_REDUCE, run "cmake" with: -DCAPSTONE_USE_SYS_DYN_MEM=0, -DCAPSTONE_BUILD_DIET=1, -DCAPSTONE_X86_REDUCE=1

Developer specific options

CAPSTONE_DEBUG: Change this to ON to enable extra debug assertions. Automatically enabled with Debug build.
CAPSTONE_BUILD_CSTEST: Build cstest in suite/cstest/. Note: cstest requires libyaml on your system. It attempts to build it from source otherwise.
CMAKE_EXPORT_COMPILE_COMMANDS: To export compile_commands.json for clangd and other language servers.
ENABLE_ASAN: Compiles Capstone with the address sanitizer.
ENABLE_COVERAGE: Generate coverage files.
CAPSTONE_BUILD_LEGACY_TESTS: Build some legacy integration tests.

Building cstest

cstest is build together with Capstone by adding the flag -DCAPSTONE_BUILD_CSTEST.

The build requires libyaml. It is a fairly common package and should be provided by your package manager.

Note: Currently cstest us only supported on Linux.

If you run another operation system, please install cstest_py. See bindings/python/BUILDING.md for instructions.

4.6 KiB Raw Blame History