blob: 19099bbceb03955c344266cab262e8bf9fef692f [file] [log] [blame]
Nguyen Anh Quynh1ae38db2013-11-27 14:33:13 +08001Capstone source is organized as followings.
2
Nguyen Anh Quynh7f36d262013-12-05 10:25:51 +08003
Nguyen Anh Quynh8282dc62014-01-15 21:20:47 +08004. <- core engine + README + COMPILE.TXT etc
Nguyen Anh Quynhbdbde1f2013-11-27 17:00:06 +08005├── arch <- code handling disasm engine for each arch
Nguyen Anh Quynh7f36d262013-12-05 10:25:51 +08006│   ├── AArch64 <- ARM64 (aka ARMv8) engine
7│   ├── ARM <- ARM engine
Nguyen Anh Quynh74a114e2015-10-05 16:14:19 +08008│   ├── M68K <- M68K engine
Nguyen Anh Quynh7f36d262013-12-05 10:25:51 +08009│   ├── Mips <- Mips engine
Nguyen Anh Quynhab26cd92014-01-07 11:46:21 +080010│   ├── PowerPC <- PowerPC engine
Nguyen Anh Quynh636f5062014-03-23 22:24:28 +080011│   ├── Sparc <- Sparc engine
12│   ├── SystemZ <- SystemZ engine
Nguyen Anh Quynhc80d8402014-05-26 23:02:48 +080013│   ├── X86 <- X86 engine
14│   └── XCore <- XCore engine
Nguyen Anh Quynh18ebd802013-11-27 21:29:12 +080015├── bindings <- all bindings are under this dir
Nguyen Anh Quynhbdbde1f2013-11-27 17:00:06 +080016│   ├── java <- Java bindings + test code
17│   ├── ocaml <- Ocaml bindings + test code
pancake5ea50372014-11-01 22:14:13 +010018│   └── python <- Python bindings + test code
Nguyen Anh Quynhea980bd2014-11-02 00:34:14 +080019├── contrib <- Code contributed by community to help Capstone integration
20├── docs <- Documentation
Nguyen Anh Quynh7f36d262013-12-05 10:25:51 +080021├── include <- API headers in C language (*.h)
Nguyen Anh Quynhea980bd2014-11-02 00:34:14 +080022├── msvc <- Microsoft Visual Studio support (for Windows compile)
23├── packages <- Packages for Linux/OSX/BSD.
tandasat45e5eab2016-05-11 21:48:32 -070024├── windows <- Windows support (for Windows kernel driver compile)
Nguyen Anh Quynh6adc5c12014-01-07 11:34:05 +080025├── suite <- Development test tools - for Capstone developers only
Nguyen Anh Quynh7f36d262013-12-05 10:25:51 +080026├── tests <- Test code (in C language)
pancake5ea50372014-11-01 22:14:13 +010027└── xcode <- Xcode support (for MacOSX compile)
Nguyen Anh Quynh1ae38db2013-11-27 14:33:13 +080028
29
Nguyen Anh Quynhea980bd2014-11-02 00:34:14 +080030Follow instructions in COMPILE.TXT for how to compile and run test code.
Nguyen Anh Quynh18ebd802013-11-27 21:29:12 +080031
Nguyen Anh Quynh7f36d262013-12-05 10:25:51 +080032Note: if you find some strange bugs, it is recommended to firstly clean
33the code and try to recompile/reinstall again. This can be done with:
Nguyen Anh Quynh1ae38db2013-11-27 14:33:13 +080034
Nguyen Anh Quynh06aef6b2014-05-07 16:00:33 +080035 $ ./make.sh
36 $ sudo ./make.sh install
Nguyen Anh Quynh1ae38db2013-11-27 14:33:13 +080037
Nguyen Anh Quynhea980bd2014-11-02 00:34:14 +080038At the same time, for Java/Ocaml/Python bindings, be sure to always use
39the bindings coming with the core to avoid potential incompatility issue
40with older versions.
41See bindings/<language>/README for detail instructions on how to compile &
42install the bindings.