Snap for 10957012 from 9a0e4156d50a75a99ec4f1653a0e9602a5d45c18 to simpleperf-release

Change-Id: I71090dc52dc31692978d312728175a1bd1afc2df
tree: 94241b2b074511efbbcac6265eaa22ba7925e073
  1. .github/
  2. arch/
  3. bindings/
  4. contrib/
  5. cstool/
  6. docs/
  7. include/
  8. msvc/
  9. packages/
  10. suite/
  11. tests/
  12. windows/
  13. windowsce/
  14. xcode/
  15. .appveyor.yml
  16. .gitattributes
  17. .gitignore
  18. .travis.yml
  19. Android.bp
  20. capstone.pc.in
  21. ChangeLog
  22. cmake.sh
  23. CMakeLists.txt
  24. COMPILE.TXT
  25. COMPILE_CMAKE.TXT
  26. COMPILE_MSVC.TXT
  27. config.mk
  28. CREDITS.TXT
  29. cs.c
  30. cs_priv.h
  31. functions.mk
  32. HACK.TXT
  33. LEB128.h
  34. LICENSE
  35. LICENSE.TXT
  36. LICENSE_LLVM.TXT
  37. make.sh
  38. Makefile
  39. MathExtras.h
  40. MCDisassembler.h
  41. MCFixedLenDisassembler.h
  42. MCInst.c
  43. MCInst.h
  44. MCInstrDesc.c
  45. MCInstrDesc.h
  46. MCRegisterInfo.c
  47. MCRegisterInfo.h
  48. METADATA
  49. nmake.bat
  50. OWNERS
  51. pkgconfig.mk
  52. README.md
  53. RELEASE_NOTES
  54. SPONSORS.TXT
  55. SStream.c
  56. SStream.h
  57. TODO
  58. utils.c
  59. utils.h
README.md

Capstone Engine

Build Status Build status pypi package pypi downloads

Deprecation

The master branch is deprecated. All forward development should be based on the next branch.

To clone a fresh checkout with the next branch:

git clone -b next https://github.com/capstone-engine/capstone

To change to the next branch in an existing checkout:

git checkout next

We moved the original historical repo of Capstone from https://github.com/aquynh/capstone to an organization, where we can add more maintainers to the project, and push Capstone development forward.

Our new home is https://github.com/capstone-engine/capstone

Nov 8th, 2021.


Capstone is a disassembly framework with the target of becoming the ultimate disasm engine for binary analysis and reversing in the security community.

Created by Nguyen Anh Quynh, then developed and maintained by a small community, Capstone offers some unparalleled features:

  • Support multiple hardware architectures: ARM, ARM64 (ARMv8), Ethereum VM, M68K, Mips, MOS65XX, PPC, Sparc, SystemZ, TMS320C64X, M680X, XCore and X86 (including X86_64).

  • Having clean/simple/lightweight/intuitive architecture-neutral API.

  • Provide details on disassembled instruction (called “decomposer” by others).

  • Provide semantics of the disassembled instruction, such as list of implicit registers read & written.

  • Implemented in pure C language, with lightweight bindings for D, Clojure, F#, Common Lisp, Visual Basic, PHP, PowerShell, Emacs, Haskell, Perl, Python, Ruby, C#, NodeJS, Java, GO, C++, OCaml, Lua, Rust, Delphi, Free Pascal & Vala (ready either in main code, or provided externally by the community).

  • Native support for all popular platforms: Windows, macOS, iOS, Android, Linux, *BSD, Solaris, etc.

  • Thread-safe by design.

  • Special support for embedding into firmware or OS kernel.

  • High performance & suitable for malware analysis (capable of handling various X86 malware tricks).

  • Distributed under the open source BSD license.

Further information is available at http://www.capstone-engine.org

Compile

See COMPILE.TXT file for how to compile and install Capstone.

Documentation

See docs/README for how to customize & program your own tools with Capstone.

Hack

See HACK.TXT file for the structure of the source code.

License

This project is released under the BSD license. If you redistribute the binary or source code of Capstone, please attach file LICENSE.TXT with your products.