mirror of
https://github.com/capstone-engine/capstone
synced 2026-08-11 16:26:07 -04:00
8a6fca85e4
* Branch targets are a separate addressing mode Branch targets are relative displacements that identify code locations. These are neither .w nor .l nor immediates. This change removes the immediate #s before branch target addresses in disassembly, and represents the actual branch instructions more accurately in the cs_m68k_op datastructure. M68K Python bindings have also been updated. * m68k_inst.pc handles better; print target for PC relative offsets Previous changes to branch operations relied on m68k_inst.pc pointing to (start of instruction + 2). This was not the case - it pointed to the end of the current instruction. This change makes it so that m68k_inst.pc points to (start of instruction), which is simple to work with. It also changes printing of PC relative offsets to print the absolute target address, which is consistent with how most 68000 assemblers & disassemblers behave. |
||
|---|---|---|
| .. | ||
| capstone | ||
| prebuilt | ||
| pyx | ||
| .gitignore | ||
| BUILDING.txt | ||
| LICENSE.TXT | ||
| Makefile | ||
| MANIFEST.in | ||
| README.txt | ||
| setup.py | ||
| setup_cython.py | ||
| test_all.py | ||
| test_arm.py | ||
| test_arm64.py | ||
| test_basic.py | ||
| test_customized_mnem.py | ||
| test_detail.py | ||
| test_lite.py | ||
| test_m68k.py | ||
| test_m680x.py | ||
| test_mips.py | ||
| test_ppc.py | ||
| test_skipdata.py | ||
| test_sparc.py | ||
| test_systemz.py | ||
| test_tms320c64x.py | ||
| test_x86.py | ||
| test_xcore.py | ||
| xprint.py | ||
To install Capstone, you should run `pip install capstone`. If you would like to build Capstone with just the source distribution, without pip, just run `python setup.py install` in the folder with setup.py in it. In order to use this source distribution, you will need an environment that can compile C code. On Linux, this is usually easy, but on Windows, this involves installing Visual Studio and using the "Developer Command Prompt" to perform the installation. See BUILDING.txt for more information. If you don't want to build your own copy of Capstone, you can use a precompiled binary distribution from PyPI. Saying `pip install capstone` should automatically obtain an appropriate copy for your system. If it does not, please open an issue at https://github.com/aquynh/capstone and tag @rhelmot - they will fix this, probably! -------------------------------------------------------------------------------- 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), Mips, PPC, Sparc, SystemZ, 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 wrappers for C++, C#, Go, Java, NodeJS, Ocaml, Python, Ruby & Vala ready (available 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 http://www.capstone-engine.org [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.