blob: db373e271be1711f02fbd370805eb35c98e12640 [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.
Nguyen Anh Quynh6adc5c12014-01-07 11:34:05 +080024├── suite <- Development test tools - for Capstone developers only
Nguyen Anh Quynh7f36d262013-12-05 10:25:51 +080025├── tests <- Test code (in C language)
pancake5ea50372014-11-01 22:14:13 +010026└── xcode <- Xcode support (for MacOSX compile)
Nguyen Anh Quynh1ae38db2013-11-27 14:33:13 +080027
28
Nguyen Anh Quynhea980bd2014-11-02 00:34:14 +080029Follow instructions in COMPILE.TXT for how to compile and run test code.
Nguyen Anh Quynh18ebd802013-11-27 21:29:12 +080030
Nguyen Anh Quynh7f36d262013-12-05 10:25:51 +080031Note: if you find some strange bugs, it is recommended to firstly clean
32the code and try to recompile/reinstall again. This can be done with:
Nguyen Anh Quynh1ae38db2013-11-27 14:33:13 +080033
Nguyen Anh Quynh06aef6b2014-05-07 16:00:33 +080034 $ ./make.sh
35 $ sudo ./make.sh install
Nguyen Anh Quynh1ae38db2013-11-27 14:33:13 +080036
Nguyen Anh Quynhea980bd2014-11-02 00:34:14 +080037At the same time, for Java/Ocaml/Python bindings, be sure to always use
38the bindings coming with the core to avoid potential incompatility issue
39with older versions.
40See bindings/<language>/README for detail instructions on how to compile &
41install the bindings.