Add better support for cross builds. (#2803)

* Add several cross compilation toolchain files.

* Make cstest compile sucessfully on targets without libyaml.

* Add cross compilation tests to CI.

* Add test for issue #2339

* Document cross compilation improvements.
18 files changed
tree: ee1148a6a6d905ca72707165a7dc8a64d45cda28
  1. .github/
  2. .reuse/
  3. arch/
  4. bindings/
  5. contrib/
  6. cross_configs/
  7. cstool/
  8. docs/
  9. ext_patches/
  10. include/
  11. LICENSES/
  12. packages/
  13. suite/
  14. tests/
  15. windows/
  16. windowsce/
  17. xcode/
  18. .appveyor.yml
  19. .clang-format
  20. .dockerignore
  21. .editorconfig
  22. .gitattributes
  23. .gitignore
  24. .gitmodules
  25. BUILDING.md
  26. capstone-config.cmake.in
  27. capstone.pc.in
  28. ChangeLog
  29. cmake.sh
  30. cmake_uninstall.cmake.in
  31. CMakeLists.txt
  32. CMakePresets.json
  33. COMPILE_MAKE.TXT
  34. config.mk
  35. CONTRIBUTING.md
  36. CPackConfig.cmake
  37. CPackConfig.txt
  38. CREDITS.TXT
  39. cs.c
  40. cs_priv.h
  41. cs_simple_types.h
  42. functions.mk
  43. LEB128.h
  44. make.sh
  45. Makefile
  46. Mapping.c
  47. Mapping.h
  48. MathExtras.h
  49. MCAsmInfo.h
  50. MCDisassembler.h
  51. MCFixedLenDisassembler.h
  52. MCInst.c
  53. MCInst.h
  54. MCInstPrinter.c
  55. MCInstPrinter.h
  56. MCInstrDesc.c
  57. MCInstrDesc.h
  58. MCRegisterInfo.c
  59. MCRegisterInfo.h
  60. pkgconfig.mk
  61. README.md
  62. SPONSORS.TXT
  63. SStream.c
  64. SStream.h
  65. utils.c
  66. utils.h
README.md

Capstone Engine

Build status pypi package pypi downloads oss-fuzz Status

[!TIP] Welcome to join our community group!  

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, AArch64, Alpha, ARC, BPF, Ethereum VM, LoongArch, HP PA-RISC (HPPA), M68K, M680X, Mips, MOS65XX, PPC, RISC-V(rv32G/rv64G), SH, Sparc, SystemZ, TMS320C64X, TriCore, Webassembly, XCore and X86 (16, 32, 64), Xtensa.

  • 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 Swift, 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, Mac OSX, 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 https://www.capstone-engine.org

Compile

See BUILDING.md file for how to compile and install Capstone.

Documentation

Contributing

See CONTRIBUTING.md for an intro.

Fuzz

See suite/fuzz/README.md for more information.

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.