| This file details the changelog of Capstone. |
| |
| --------------------------------- |
| Version 4.0.1: January 10th, 2019 |
| |
| |
| [ Core ] |
| |
| - Fix some issues for packaging (Debian, Gentoo). |
| - Better support for building with Mingw. |
| - cstool has new option -s to turn on skipdata mode. |
| - cstool -v now report build settings of the core. |
| - Add suite/capstone_get_setup.c so users can integrate with their own code |
| to retrieve Capstone settings at build time. |
| |
| |
| [ Arm ] |
| |
| - Fix 4.0 regression: the `tbh [r0, r1, lsl #1]` instruction sets the operand.shift.value back again (see #1317) |
| - Remove ARM_REG_PC group for BX instruction. |
| |
| |
| [ X86 ] |
| |
| - Fix: endbr32 and endbr64 instructions are now properly decoded in both CS_MODE_32 and CS_MODE_64 (#1129) |
| |
| |
| [ M680X ] |
| |
| - Fix some issues reported by clang-analyzer (#1329). |
| |
| |
| [ Python ] |
| |
| - Fix skipdata setup. |
| - Add getter/setter for skipdata_mnem, skipdata_callback. |
| |
| |
| --------------------------------- |
| Version 4.0: December 18th, 2018 |
| |
| |
| [ Core ] |
| |
| - New APIs: cs_regs_access() |
| - Add new options for cs_option(): CS_OPT_MNEMONIC & CS_OPT_UNSIGNED & CS_OPT_SYNTAX_MASM. |
| - Various updates & bugfixes for all architectures. |
| - Add 4 new architectures: EVM, M68K, M680X & TMS320C64x. |
| - Add new group types: CS_GRP_PRIVILEGE & CS_GRP_BRANCH_RELATIVE. |
| - Add new error types: CS_ERR_X86_MASM. |
| |
| |
| [ X86 ] |
| |
| - Add XOP code condition type in x86_xop_cc. |
| - Add some info on encoding to cs_x86 in cs_x86_encoding. |
| - Add register flags update in cs_x86.{eflags, fpu_flags} |
| - Change cs_x86.disp type from int32_t to int64_t. |
| - Add new groups: X86_GRP_VM & X86_GRP_FPU. |
| - Lots of new instructions (AVX) |
| |
| |
| [ ARM64 ] |
| |
| - Add instruction ARM64_INS_NEGS & ARM64_INS_NGCS. |
| |
| |
| [ Mips ] |
| |
| - Add mode CS_MODE_MIPS2. |
| |
| |
| [ PPC ] |
| |
| - Change cs_ppc_op.imm type from int32_t to int64_t. |
| - Add new groups: PPC_GRP_ICBT, PPC_GRP_P8ALTIVEC, PPC_GRP_P8VECTOR & PPC_GRP_QPX. |
| - Lots of new instructions (QPX among them) |
| |
| |
| [ Sparc ] |
| |
| - Change cs_sparc_op.imm type from int32_t to int64_t. |
| |
| |
| [ Binding ] |
| |
| - New bindings: PowerShell & VB6 |
| |
| |
| --------------------------------- |
| Version 3.0.5: July 18th, 2018 |
| |
| |
| [ Core ] |
| |
| - Fix the include path for Android builds when building cstool. |
| - Add posibility to disable universal build for Mac OS. |
| - cstool: Separate instruction bytes by spaces. |
| - Fix code path of pkg-config in Cmake. |
| - Update XCode project for XCode 9.1. |
| - Add Cortex-M support to cstool. |
| - Cmake forces to be build using MT with MSVC. |
| - Better support for Mac OS kernel. |
| |
| |
| [ X86 ] |
| |
| - Fix some issues in handling EVEX & VEX3 instructions. |
| - Fix immediate operand for AND instruction in ATT mode. |
| - Fix ATT syntax when imm operand is 0. |
| - Better handle XACQUIRE/XRELEASE. |
| - Fix imm operand of RETF. |
| |
| |
| [ ARM ] |
| |
| - Fix an integer overlow bug. |
| |
| |
| [ ARM64 ] |
| |
| - Bug fix for incorrect operand type in certain load/store instructions. |
| |
| |
| [ Mips ] |
| |
| - Mode CS_MODE_MIPS32R6 automatically sets CS_MODE_32 |
| |
| |
| [ PPC ] |
| |
| - Fix endian check. |
| |
| |
| [ Sparc ] |
| |
| - Fix an integer overlow bug. |
| |
| |
| [ SystemZ ] |
| |
| - Fix an integer overlow bug. |
| |
| |
| [ Python binding ] |
| |
| - Raise error on accessing irrelevant data fields if skipdata & detail modes are enable. |
| |
| |
| --------------------------------- |
| Version 3.0.5-rc3: July 31st, 2017 |
| |
| |
| [ Core ] |
| |
| - Fix compilation for MacOS kernel extension |
| - cstool to support armbe and arm64be modes |
| - Add nmake.bat for Windows build |
| - Fix an integer overflow for Windows kernel driver |
| - Support to embedded Capstone into MacOS kernel |
| - cstool: fix mips64 mode |
| - Fix a compiling error in MS Visual Studio 2015 |
| - Install pkgconfig file with CMake build |
| - Fix SOVERSION property of CMake build |
| - Properly handle switching to Endian mode at run-time for Arm, Arm64, Mips & Sparc |
| - Fix MingW build |
| - Better handle CMake installation for Linux 64bit |
| |
| |
| [ X86 ] |
| |
| - Support BND prefix of Intel MPX extension |
| - Correct operand size for CALL/JMP in 64bit mode with prefix 0x66 |
| - LOCK NOP is a valid instruction |
| - Fix ATT syntax for instruction with zero offset segment register |
| - LES/LDS are invalid in 64bit mode |
| - Fix number of operands for some MOV instructions |
| |
| |
| [ ARM ] |
| |
| - Fix POP reg to update SP register |
| - Update flags for UADD8 instruction |
| |
| |
| [ ARM64 ] |
| |
| - Better performance with new lookup table |
| - Handle system registers added in ARMv8.1/2 |
| |
| |
| [ Java binding ] |
| |
| - Better handle input with invalid code |
| |
| |
| [ Visual Basic binding ] |
| |
| - New binding |
| |
| --------------------------------- |
| Version 3.0.5-rc2: March 2nd, 2017 |
| |
| |
| [ Core ] |
| |
| - Fix build for Visual Studio 2012 |
| - Fix X86_REL_ADDR macro |
| - Add CS_VERSION_MAJOR, CS_VERSION_MINOR, CS_VERSION_EXTRA |
| - Better support for embedding Capstone into Windows kernel drivers |
| - Support to embedded Capstone into MacOS kernel |
| - Support MacOS 10.11 and up |
| - Better support for Cygwin |
| - Support build packages for FreeBSD & DragonflyBSD |
| - Add a command-line tool "cstool" |
| - Properly handle switching to Endian mode at run-time for Arm, Arm64, Mips & Sparc |
| |
| |
| [ X86 ] |
| |
| - Some random 16-bit code can be handled wrongly. |
| - Remove abundant operand type X86_OP_FP |
| - Fix instructions MOVQ, LOOP, LOOPE, LOOPNE, CALL/JMP rel16, REPNE LODSD, MOV *AX, MOFFS, FAR JMP/CALL |
| - Add X86_REG_EFLAGS for STC and STD |
| - Fix instruction attributes for SYSEXIT, MOVW, ROL, LGS, SLDT |
| - Rename registers ST0-ST7 to be consistent with asm output |
| |
| |
| [ ARM ] |
| |
| - Properly handle IT instruction |
| - Fix LDRSB |
| - Fix writeback for LDR |
| - Fix Thumb BigEndian setup |
| |
| |
| [ ARM64 ] |
| |
| - Fix arith extender |
| - Fix writeback for LDR |
| - Rename enum arm64_mrs_reg to arm64_sysreg |
| |
| |
| [ PowerPC ] |
| |
| - Print 0 offset for memory operand |
| |
| |
| [ Sparc ] |
| |
| - Fix POPC instruction |
| |
| |
| [ Python binding ] |
| |
| - Better PyPy support |
| - Add __version__ |
| - Better support for Python 3 |
| - Fix CS_SKIPDATA_CALLBACK prototype |
| - Cast skipdata function inside binding to simplify the API |
| |
| |
| [ Java binding ] |
| |
| - Better handle input with invalid code |
| |
| |
| [ PowerShell ] |
| |
| - New binding |
| |
| --------------------------------- |
| Version 3.0.4: July 15th, 2015 |
| |
| |
| [ Library ] |
| |
| - Improve cross-compile for Android using Android NDK. |
| - Support cross-compile for AArch64 Android (with Linux GCC). |
| - Removed osxkernel_inttypes.h that is incompatible with BSD license. |
| - Make it possible to compile with CC having a space inside (like "ccache gcc"). |
| |
| |
| [ X86 ] |
| |
| - Fix a null pointer dereference bug on handling code with special prefixes. |
| - Properly handle AL/AX/EAX operand for OUT instruction in AT&T syntax. |
| - Print immediate operand in positive form in some algorithm instructions. |
| - Properly decode some SSE instructions. |
| |
| |
| [ PowerPC ] |
| |
| - Fixed a memory corruption bug. |
| - Fixed a memory corruption bug for the engine built in DIET mode. |
| |
| |
| [ Mips ] |
| |
| - Fixed instruction ID of SUBU instruction. |
| - Fixed a memory corruption bug. |
| |
| |
| [ Arm ] |
| |
| - Fixed a memory corruption bug on IT instruction. |
| |
| |
| [ XCore ] |
| |
| - Fixed a memory corruption bug when instruction has a memory operand. |
| |
| |
| [ Python ] |
| |
| - Support Virtualenv. |
| - setup.py supports option --user if not in a virtualenv to allow for local usage. |
| - Properly handle the destruction of Cs object in the case the shared library |
| was already unloaded. |
| |
| --------------------------------- |
| Version 3.0.3: May 08th, 2015 |
| |
| |
| [ Library ] |
| |
| - Support to embed into Mac OS X kernel extensions. |
| - Now it is possible to compile Capstone with older C compilers, such as |
| GCC 4.8 on Ubuntu 12.04. |
| - Add "test_iter" to MSVC project. |
| |
| |
| [ X86 ] |
| |
| - All shifted instructions SHL, SHR, SAL, SAR, RCL, RCR, ROL & ROR now support |
| $1 as first operand in *AT&T* syntax (so we have "rcll $1, %edx" instead of |
| "rcll %edx"). |
| - CMPXCHG16B is a valid instruction with LOCK prefix. |
| - Fixed a segfault on the input of 0xF3. |
| |
| |
| [ Arm ] |
| |
| - BLX instruction modifies PC & LR registers. |
| |
| |
| [ Sparc ] |
| |
| - Improved displacement decoding for sparc banching instructions. |
| |
| |
| [ Python binding ] |
| |
| - Fix for Cython so it can properly initialize. |
| - X86Op.avx_zero_mask now has c_bool type, but not c_uint8 type. |
| - Properly support compile with Cygwin & install binding (setup.py). |
| |
| --------------------------------- |
| Version 3.0.2: March 11th, 2015 |
| |
| |
| [ Library ] |
| |
| - On *nix, only export symbols that are part of the API (instead of all |
| the internal symbols). |
| |
| |
| [ X86 ] |
| |
| - Do not consider 0xF2 as REPNE prefix if it is a part of instruction encoding. |
| - Fix implicit registers read/written & instruction groups of some instructions. |
| - More flexible on the order of prefixes, so better handle some tricky |
| instructions. |
| - REPNE prefix can go with STOS & MOVS instructions. |
| - Fix a compilation bug for X86_REDUCE mode. |
| - Fix operand size of instructions with operand PTR [] |
| |
| |
| [ Arm ] |
| |
| - Fix a bug where arm_op_mem.disp is wrongly calculated (in DETAIL mode). |
| - Fix a bug on handling the If-Then block. |
| |
| |
| [ Mips ] |
| |
| - Sanity check for the input size for MIPS64 mode. |
| |
| |
| [ MSVC ] |
| |
| - Compile capstone.dll with static runtime MSVCR built in. |
| |
| |
| [ Python binding ] |
| |
| - Fix a compiling issue of Cython binding with gcc 4.9. |
| |
| --------------------------------- |
| Version 3.0.1: February 03rd, 2015 |
| |
| [ X86 ] |
| |
| - Properly handle LOCK, REP, REPE & REPNE prefixes. |
| - Handle undocumented immediates for SSE's (V)CMPPS/PD/SS/SD instructions. |
| - Print LJUMP/LCALL without * as prefix for Intel syntax. |
| - Handle REX prefix properly for segment/MMX related instructions (x86_64). |
| - Instruction with length > 15 is consider invalid. |
| - Handle some tricky encodings for instructions MOVSXD, FXCH, FCOM, FCOMP, |
| FSTP, FSTPNCE, NOP. |
| - Handle some tricky code for some X86_64 instructions with REX prefix. |
| - Add missing operands in detail mode for PUSH , POP , IN/OUT reg, reg |
| - MOV32ms & MOV32sm should reference word rather than dword. |
| |
| |
| [ Arm64 ] |
| |
| - BL & BLR instructions do not read SP register. |
| - Print absolute (rather than relative) address for instructions B, BL, |
| CBNZ, ADR. |
| |
| |
| [ Arm ] |
| |
| - Instructions ADC & SBC do not update flags. |
| - BL & BLX do not read SP, but PC register. |
| - Alias LDR instruction with operands [sp], 4 to POP. |
| - Print immediate operand of MVN instruction in positive hexadecimal form. |
| |
| |
| [ PowerPC ] |
| |
| - Fix some compilation bugs when DIET mode is enable. |
| - Populate SLWI/SRWI instruction details with SH operand. |
| |
| |
| [ Python binding ] |
| |
| - Fix a Cython bug when CsInsn.bytes returns a shorten array of bytes. |
| - Fixed a memory leak for Cython disasm functions when we immaturely quit |
| the enumeration of disassembled instructions. |
| - Fix a NULL memory access issue when SKIPDATA & Detail modes are enable |
| at the same time. |
| - Fix a memory leaking bug when when we stop enumeration over the disassembled |
| instructions prematurely. |
| - Export generic operand types & groups (CS_OP_xxx & CS_GRP_xxx). |
| |
| --------------------------------- |
| Version 3.0: November 19th, 2014 |
| |
| [ API ] |
| |
| - New API: cs_disasm_iter & cs_malloc. See docs/README for tutorials. |
| - Renamed cs_disasm_ex to cs_disasm (cs_disasm_ex is still supported, but |
| marked obsolete to be removed in future) |
| - Support SKIPDATA mode, so Capstone can jump over unknown data and keep going |
| from the next legitimate instruction. See docs/README for tutorials. |
| - More details provided in cs_detail struct for all architectures. |
| - API version was bumped to 3.0. |
| |
| |
| [ Bindings ] |
| |
| - Python binding supports Python3 (besides Python2). |
| - Support Ocaml binding. |
| - Java: add close() method to be used to deinitialize a Capstone object when |
| no longer use it. |
| |
| |
| [ Architectures ] |
| |
| - New architectures: Sparc, SystemZ & XCore. |
| - Important bugfixes for Arm, Arm64, Mips, PowerPC & X86. |
| - Support more instructions for Arm, Arm64, Mips, PowerPC & X86. |
| - Always expose absolute addresses rather than relative addresses (Arm, Arm64, |
| Mips, PPC, Sparc, X86). |
| - Use common instruction operand types REG, IMM, MEM & FP across all |
| architectures (to enable cross-architecture analysis). |
| - Use common instruction group types across all architectures (to enable |
| cross-architecture analysis). |
| |
| |
| [ X86 ] |
| |
| - X86 engine is mature & handles all the malware tricks (that we are aware of). |
| - Added a lot of new instructions (such as AVX512, 3DNow, etc). |
| - Add prefix symbols X86_PREFIX_REP/REPNE/LOCK/CS/DS/SS/FS/GS/ES/OPSIZE/ADDRSIZE. |
| - Print immediate in positive form & hexadecimal for AND/OR/XOR instructions. |
| - More friendly disassembly for JMP16i (in the form segment:offset) |
| |
| |
| [ Mips ] |
| |
| - Engine added supports for new hardware modes: Mips32R6 (CS_MODE_MIPS32R6) & |
| MipsGP64 (CS_MODE_MIPSGP64). |
| - Removed the ABI-only mode CS_MODE_N64. |
| - New modes CS_MODE_MIPS32 & CS_MODE_MIPS64 (to use instead of CS_MODE_32 & |
| CS_MODE_64). |
| |
| |
| [ ARM ] |
| |
| - Support new mode CS_MODE_V8 for Armv8 A32 encodings. |
| - Print immediate in positive form & hexadecimal for AND/ORR/EOR/BIC instructions |
| |
| |
| [ ARM64 ] |
| |
| - Print immediate in hexadecimal for AND/ORR/EOR/TST instructions. |
| |
| |
| [ PowerPC ] |
| |
| - Do not print a dot in front of absolute address. |
| |
| |
| [ Other features ] |
| |
| - Support for Microsoft Visual Studio (so enable Windows native compilation). |
| - Support CMake compilation. |
| - Cross-compile for Android. |
| - Build libraries/tests using XCode project |
| - Much faster, while consuming less memory for all architectures. |
| |
| --------------------------------- |
| Version 2.1.2: April 3rd, 2014 |
| |
| This is a stable release to fix some bugs deep in the core. There is no update |
| to any architectures or bindings, so bindings version 2.1 can be used with this |
| version 2.1.2 just fine. |
| |
| [ Core changes] |
| |
| - Support cross-compilation for all iDevices (iPhone/iPad/iPod). |
| - X86: do not print memory offset in negative form. |
| - Fix a bug in X86 when Capstone cannot handle short instruction. |
| - Print negative number above -9 without prefix 0x (arm64, mips, arm). |
| - Correct the SONAME setup for library versioning (Linux, *BSD, Solaris). |
| - Set library versioning for dylib of OSX. |
| |
| --------------------------------- |
| Version 2.1.1: March 13th, 2014 |
| |
| This is a stable release to fix some bugs deep in the core. There is no update |
| to any architectures or bindings, so bindings version 2.1 can be used with this |
| version 2.1.1 just fine. |
| |
| [ Core changes] |
| |
| - Fix a buffer overflow bug in Thumb mode (ARM). Some special input can |
| trigger this flaw. |
| - Fix a crash issue when embedding Capstone into OSX kernel. This should |
| also enable Capstone to be embedded into other systems with limited stack |
| memory size such as Linux kernel or some firmwares. |
| - Use a proper SONAME for library versioning (Linux). |
| |
| --------------------------------- |
| Version 2.1: March 5th, 2014 |
| |
| [ API changes ] |
| |
| - API version has been bumped to 2.1. |
| - Change prototype of cs_close() to be able to invalidate closed handle. |
| See http://capstone-engine.org/version_2.1_API.html for more information. |
| - Extend cs_support() to handle more query types, not only about supported |
| architectures. This change is backward compatible, however, so existent code |
| do not need to be modified to support this. |
| - New query type CS_SUPPORT_DIET for cs_support() to ask about diet status of |
| the engine. |
| - New error code CS_ERR_DIET to report errors about newly added diet mode. |
| - New error code CS_ERR_VERSION to report issue of incompatible versions between |
| bindings & core engine. |
| |
| |
| [ Core changes ] |
| |
| - On memory usage, Capstone uses about 40% less memory, while still faster |
| than version 2.0. |
| - All architectures are much smaller: binaries size reduce at least 30%. |
| Especially, X86-only binary reduces from 1.9MB to just 720KB. |
| - Support "diet" mode, in which engine size is further reduced (by around 40%) |
| for embedding purpose. The price to pay is that we have to sacrifice some |
| non-critical data fields. See http://capstone-engine.org/diet.html for more |
| details. |
| |
| |
| [ Architectures ] |
| |
| - Update all 5 architectures to fix bugs. |
| - PowerPC: |
| - New instructions: FMR & MSYNC. |
| - Mips: |
| - New instruction: DLSA |
| - X86: |
| - Properly handle AVX-512 instructions. |
| - New instructions: PSETPM, SALC, INT1, GETSEC. |
| - Fix some memory leaking issues in case of prefixed instructions such |
| as LOCK, REP, REPNE. |
| |
| |
| [ Python binding ] |
| |
| - Verify the core version at initialization time. Refuse to run if its version |
| is different from the core's version. |
| - New API disasm_lite() added to Cs class. This light API only returns tuples of |
| (address, size, mnemonic, op_str), rather than list of CsInsn objects. This |
| improves performance by around 30% in some benchmarks. |
| - New API version_bind() returns binding's version, which might differ from |
| the core's API version if the binding is out-of-date. |
| - New API debug() returns information on Cython support, diet status & archs |
| compiled in. |
| - Fixed some memory leaking bugs for Cython binding. |
| - Fix a bug crashing Cython code when accessing @regs_read/regs_write/groups. |
| - Support diet mode. |
| |
| |
| [ Java binding ] |
| |
| - Fix some memory leaking bugs. |
| - New API version() returns combined version. |
| - Support diet mode. |
| - Better support for detail option. |
| |
| |
| [ Miscellaneous ] |
| |
| - make.sh now can uninstall the core engine. This is done with: |
| |
| $ sudo ./make.sh uninstall |
| |
| ---------------------------------- |
| Version 2.0: January 22nd, 2014 |
| |
| Release 2.0 deprecates verison 1.0 and brings a lot of crucial changes. |
| |
| [ API changes ] |
| |
| - API version has been bumped to 2.0 (see cs_version() API) |
| - New API cs_strerror(errno) returns a string describing error code given |
| in its only argument. |
| - cs_version() now returns combined version encoding both major & minor versions. |
| - New option CS_OPT_MODE allows to change engine’s mode at run-time with |
| cs_option(). |
| - New option CS_OPT_MEM allows to specify user-defined functions for dynamically |
| memory management used internally by Capstone. This is useful to embed Capstone |
| into special environments such as kernel or firware. |
| - New API cs_support() can be used to check if this lib supports a particular |
| architecture (this is necessary since we now allow to choose which architectures |
| to compile in). |
| - The detail option is OFF by default now. To get detail information, it should be |
| explicitly turned ON. The details then can be accessed using cs_insn.detail |
| pointer (to newly added structure cs_detail) |
| |
| |
| [ Core changes ] |
| |
| - On memory usage, Capstone uses much less memory, but a lot faster now. |
| - User now can choose which architectures to be supported by modifying config.mk |
| before compiling/installing. |
| |
| |
| [ Architectures ] |
| |
| - Arm |
| - Support Big-Endian mode (besides Little-Endian mode). |
| - Support friendly register, so instead of output sub "r12,r11,0x14", |
| we have "sub ip,fp,0x14". |
| - Arm64: support Big-Endian mode (besides Little-Endian mode). |
| - PowerPC: newly added. |
| - Mips: support friendly register, so instead of output "srl $2,$1,0x1f", |
| we have "srl $v0,$at,0x1f". |
| - X86: bug fixes. |
| |
| |
| [ Python binding ] |
| |
| - Python binding is vastly improved in performance: around 3 ~ 4 times faster |
| than in 1.0. |
| - Cython support has been added, which can further speed up over the default |
| pure Python binding (up to 30% in some cases) |
| - Function cs_disasm_quick() & Cs.disasm() now use generator (rather than a list) |
| to return succesfully disassembled instructions. This improves the performance |
| and reduces memory usage. |
| |
| |
| [ Java binding ] |
| |
| - Better performance & bug fixes. |
| |
| |
| [ Miscellaneous ] |
| |
| - Fixed some installation issues with Gentoo Linux. |
| - Capstone now can easily compile/install on all *nix, including Linux, OSX, |
| {Net, Free, Open}BSD & Solaris. |
| |
| ---------------------------------- |
| [Version 1.0]: December 18th, 2013 |
| |
| - Initial public release. |
| |