702 lines
		
	
	
		
			19 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			702 lines
		
	
	
		
			19 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
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.
 | 
						||
 |