Nguyen Anh Quynh | 8282dc6 | 2014-01-15 21:20:47 +0800 | [diff] [blame] | 1 | This file details the changelog of Capstone. |
| 2 | |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 3 | --------------------------------- |
Nguyen Anh Quynh | a0cdd0b | 2018-12-18 22:25:39 +0800 | [diff] [blame] | 4 | Version 4.0: December 18th, 2018 |
| 5 | |
| 6 | |
| 7 | [ Core ] |
| 8 | |
| 9 | - New APIs: cs_regs_access() |
| 10 | - Add new options for cs_option(): CS_OPT_MNEMONIC & CS_OPT_UNSIGNED & CS_OPT_SYNTAX_MASM. |
| 11 | - Various updates & bugfixes for all architectures. |
| 12 | - Add 4 new architectures: EVM, M68K, M680X & TMS320C64x. |
| 13 | - Add new group types: CS_GRP_PRIVILEGE & CS_GRP_BRANCH_RELATIVE. |
| 14 | - Add new error types: CS_ERR_X86_MASM. |
| 15 | |
| 16 | |
| 17 | [ X86 ] |
| 18 | |
| 19 | - Add XOP code condition type in x86_xop_cc. |
| 20 | - Add some info on encoding to cs_x86 in cs_x86_encoding. |
| 21 | - Add register flags update in cs_x86.{eflags, fpu_flags} |
| 22 | - Change cs_x86.disp type from int32_t to int64_t. |
| 23 | - Add new groups: X86_GRP_VM & X86_GRP_FPU. |
| 24 | - Lots of new instructions (AVX) |
| 25 | |
| 26 | |
| 27 | [ ARM64 ] |
| 28 | |
| 29 | - Add instruction ARM64_INS_NEGS & ARM64_INS_NGCS. |
| 30 | |
| 31 | |
| 32 | [ Mips ] |
| 33 | |
| 34 | - Add mode CS_MODE_MIPS2. |
| 35 | |
| 36 | |
| 37 | [ PPC ] |
| 38 | |
| 39 | - Change cs_ppc_op.imm type from int32_t to int64_t. |
| 40 | - Add new groups: PPC_GRP_ICBT, PPC_GRP_P8ALTIVEC, PPC_GRP_P8VECTOR & PPC_GRP_QPX. |
| 41 | - Lots of new instructions (QPX among them) |
| 42 | |
| 43 | |
| 44 | [ Sparc ] |
| 45 | |
| 46 | - Change cs_sparc_op.imm type from int32_t to int64_t. |
| 47 | |
| 48 | |
| 49 | [ Binding ] |
| 50 | |
| 51 | - New bindings: PowerShell & VB6 |
| 52 | |
| 53 | |
| 54 | --------------------------------- |
Nguyen Anh Quynh | db19431 | 2018-07-19 00:17:10 +0800 | [diff] [blame] | 55 | Version 3.0.5: July 18th, 2018 |
Nguyen Anh Quynh | 9ea5fbd | 2018-07-17 15:59:51 +0800 | [diff] [blame] | 56 | |
| 57 | |
| 58 | [ Core ] |
| 59 | |
| 60 | - Fix the include path for Android builds when building cstool. |
| 61 | - Add posibility to disable universal build for Mac OS. |
| 62 | - cstool: Separate instruction bytes by spaces. |
| 63 | - Fix code path of pkg-config in Cmake. |
| 64 | - Update XCode project for XCode 9.1. |
| 65 | - Add Cortex-M support to cstool. |
| 66 | - Cmake forces to be build using MT with MSVC. |
| 67 | - Better support for Mac OS kernel. |
| 68 | |
| 69 | |
| 70 | [ X86 ] |
| 71 | |
| 72 | - Fix some issues in handling EVEX & VEX3 instructions. |
| 73 | - Fix immediate operand for AND instruction in ATT mode. |
| 74 | - Fix ATT syntax when imm operand is 0. |
| 75 | - Better handle XACQUIRE/XRELEASE. |
| 76 | - Fix imm operand of RETF. |
| 77 | |
| 78 | |
| 79 | [ ARM ] |
| 80 | |
| 81 | - Fix an integer overlow bug. |
| 82 | |
| 83 | |
| 84 | [ ARM64 ] |
| 85 | |
| 86 | - Bug fix for incorrect operand type in certain load/store instructions. |
| 87 | |
| 88 | |
| 89 | [ Mips ] |
| 90 | |
| 91 | - Mode CS_MODE_MIPS32R6 automatically sets CS_MODE_32 |
| 92 | |
| 93 | |
| 94 | [ PPC ] |
| 95 | |
| 96 | - Fix endian check. |
| 97 | |
| 98 | |
| 99 | [ Sparc ] |
| 100 | |
| 101 | - Fix an integer overlow bug. |
| 102 | |
| 103 | |
| 104 | [ SystemZ ] |
| 105 | |
| 106 | - Fix an integer overlow bug. |
| 107 | |
| 108 | |
Nguyen Anh Quynh | eeff103 | 2018-07-18 13:48:32 +0800 | [diff] [blame] | 109 | [ Python binding ] |
| 110 | |
| 111 | - Raise error on accessing irrelevant data fields if skipdata & detail modes are enable. |
| 112 | |
| 113 | |
Nguyen Anh Quynh | 9ea5fbd | 2018-07-17 15:59:51 +0800 | [diff] [blame] | 114 | --------------------------------- |
Nguyen Anh Quynh | da2e94e | 2017-07-31 13:15:18 +0700 | [diff] [blame] | 115 | Version 3.0.5-rc3: July 31st, 2017 |
| 116 | |
| 117 | |
| 118 | [ Core ] |
| 119 | |
| 120 | - Fix compilation for MacOS kernel extension |
| 121 | - cstool to support armbe and arm64be modes |
| 122 | - Add nmake.bat for Windows build |
| 123 | - Fix an integer overflow for Windows kernel driver |
| 124 | - Support to embedded Capstone into MacOS kernel |
| 125 | - cstool: fix mips64 mode |
| 126 | - Fix a compiling error in MS Visual Studio 2015 |
| 127 | - Install pkgconfig file with CMake build |
| 128 | - Fix SOVERSION property of CMake build |
| 129 | - Properly handle switching to Endian mode at run-time for Arm, Arm64, Mips & Sparc |
| 130 | - Fix MingW build |
| 131 | - Better handle CMake installation for Linux 64bit |
| 132 | |
| 133 | |
| 134 | [ X86 ] |
| 135 | |
| 136 | - Support BND prefix of Intel MPX extension |
| 137 | - Correct operand size for CALL/JMP in 64bit mode with prefix 0x66 |
| 138 | - LOCK NOP is a valid instruction |
| 139 | - Fix ATT syntax for instruction with zero offset segment register |
| 140 | - LES/LDS are invalid in 64bit mode |
| 141 | - Fix number of operands for some MOV instructions |
| 142 | |
| 143 | |
| 144 | [ ARM ] |
| 145 | |
| 146 | - Fix POP reg to update SP register |
| 147 | - Update flags for UADD8 instruction |
| 148 | |
| 149 | |
| 150 | [ ARM64 ] |
| 151 | |
| 152 | - Better performance with new lookup table |
| 153 | - Handle system registers added in ARMv8.1/2 |
| 154 | |
| 155 | |
| 156 | [ Java binding ] |
| 157 | |
| 158 | - Better handle input with invalid code |
| 159 | |
| 160 | |
| 161 | [ Visual Basic binding ] |
| 162 | |
| 163 | - New binding |
| 164 | |
| 165 | --------------------------------- |
Nguyen Anh Quynh | e22577e | 2017-03-02 22:21:24 +0800 | [diff] [blame] | 166 | Version 3.0.5-rc2: March 2nd, 2017 |
| 167 | |
| 168 | |
| 169 | [ Core ] |
| 170 | |
| 171 | - Fix build for Visual Studio 2012 |
| 172 | - Fix X86_REL_ADDR macro |
| 173 | - Add CS_VERSION_MAJOR, CS_VERSION_MINOR, CS_VERSION_EXTRA |
| 174 | - Better support for embedding Capstone into Windows kernel drivers |
| 175 | - Support to embedded Capstone into MacOS kernel |
| 176 | - Support MacOS 10.11 and up |
| 177 | - Better support for Cygwin |
| 178 | - Support build packages for FreeBSD & DragonflyBSD |
| 179 | - Add a command-line tool "cstool" |
| 180 | - Properly handle switching to Endian mode at run-time for Arm, Arm64, Mips & Sparc |
| 181 | |
| 182 | |
| 183 | [ X86 ] |
| 184 | |
| 185 | - Some random 16-bit code can be handled wrongly. |
| 186 | - Remove abundant operand type X86_OP_FP |
| 187 | - Fix instructions MOVQ, LOOP, LOOPE, LOOPNE, CALL/JMP rel16, REPNE LODSD, MOV *AX, MOFFS, FAR JMP/CALL |
| 188 | - Add X86_REG_EFLAGS for STC and STD |
| 189 | - Fix instruction attributes for SYSEXIT, MOVW, ROL, LGS, SLDT |
| 190 | - Rename registers ST0-ST7 to be consistent with asm output |
| 191 | |
| 192 | |
| 193 | [ ARM ] |
| 194 | |
| 195 | - Properly handle IT instruction |
| 196 | - Fix LDRSB |
| 197 | - Fix writeback for LDR |
| 198 | - Fix Thumb BigEndian setup |
| 199 | |
| 200 | |
| 201 | [ ARM64 ] |
| 202 | |
| 203 | - Fix arith extender |
| 204 | - Fix writeback for LDR |
| 205 | - Rename enum arm64_mrs_reg to arm64_sysreg |
| 206 | |
| 207 | |
| 208 | [ PowerPC ] |
| 209 | |
| 210 | - Print 0 offset for memory operand |
| 211 | |
| 212 | |
| 213 | [ Sparc ] |
| 214 | |
| 215 | - Fix POPC instruction |
| 216 | |
| 217 | |
| 218 | [ Python binding ] |
| 219 | |
| 220 | - Better PyPy support |
| 221 | - Add __version__ |
| 222 | - Better support for Python 3 |
| 223 | - Fix CS_SKIPDATA_CALLBACK prototype |
| 224 | - Cast skipdata function inside binding to simplify the API |
| 225 | |
| 226 | |
| 227 | [ Java binding ] |
| 228 | |
| 229 | - Better handle input with invalid code |
| 230 | |
| 231 | |
| 232 | [ PowerShell ] |
| 233 | |
| 234 | - New binding |
| 235 | |
| 236 | --------------------------------- |
Nguyen Anh Quynh | cfd8db3 | 2015-07-15 13:01:12 +0800 | [diff] [blame] | 237 | Version 3.0.4: July 15th, 2015 |
Nguyen Anh Quynh | e49512b | 2015-07-15 11:38:05 +0800 | [diff] [blame] | 238 | |
| 239 | |
| 240 | [ Library ] |
| 241 | |
| 242 | - Improve cross-compile for Android using Android NDK. |
| 243 | - Support cross-compile for AArch64 Android (with Linux GCC). |
| 244 | - Removed osxkernel_inttypes.h that is incompatible with BSD license. |
| 245 | - Make it possible to compile with CC having a space inside (like "ccache gcc"). |
| 246 | |
| 247 | |
| 248 | [ X86 ] |
| 249 | |
| 250 | - Fix a null pointer dereference bug on handling code with special prefixes. |
| 251 | - Properly handle AL/AX/EAX operand for OUT instruction in AT&T syntax. |
| 252 | - Print immediate operand in positive form in some algorithm instructions. |
| 253 | - Properly decode some SSE instructions. |
| 254 | |
| 255 | |
| 256 | [ PowerPC ] |
| 257 | |
| 258 | - Fixed a memory corruption bug. |
| 259 | - Fixed a memory corruption bug for the engine built in DIET mode. |
| 260 | |
| 261 | |
| 262 | [ Mips ] |
| 263 | |
| 264 | - Fixed instruction ID of SUBU instruction. |
| 265 | - Fixed a memory corruption bug. |
| 266 | |
| 267 | |
| 268 | [ Arm ] |
| 269 | |
| 270 | - Fixed a memory corruption bug on IT instruction. |
| 271 | |
| 272 | |
| 273 | [ XCore ] |
| 274 | |
| 275 | - Fixed a memory corruption bug when instruction has a memory operand. |
| 276 | |
| 277 | |
| 278 | [ Python ] |
| 279 | |
| 280 | - Support Virtualenv. |
| 281 | - setup.py supports option --user if not in a virtualenv to allow for local usage. |
| 282 | - Properly handle the destruction of Cs object in the case the shared library |
| 283 | was already unloaded. |
| 284 | |
| 285 | --------------------------------- |
Nguyen Anh Quynh | 512303b | 2015-05-08 15:17:01 +0800 | [diff] [blame] | 286 | Version 3.0.3: May 08th, 2015 |
| 287 | |
| 288 | |
| 289 | [ Library ] |
| 290 | |
| 291 | - Support to embed into Mac OS X kernel extensions. |
| 292 | - Now it is possible to compile Capstone with older C compilers, such as |
| 293 | GCC 4.8 on Ubuntu 12.04. |
| 294 | - Add "test_iter" to MSVC project. |
| 295 | |
| 296 | |
| 297 | [ X86 ] |
| 298 | |
| 299 | - All shifted instructions SHL, SHR, SAL, SAR, RCL, RCR, ROL & ROR now support |
| 300 | $1 as first operand in *AT&T* syntax (so we have "rcll $1, %edx" instead of |
| 301 | "rcll %edx"). |
| 302 | - CMPXCHG16B is a valid instruction with LOCK prefix. |
| 303 | - Fixed a segfault on the input of 0xF3. |
| 304 | |
| 305 | |
| 306 | [ Arm ] |
| 307 | |
| 308 | - BLX instruction modifies PC & LR registers. |
| 309 | |
| 310 | |
| 311 | [ Sparc ] |
| 312 | |
| 313 | - Improved displacement decoding for sparc banching instructions. |
| 314 | |
| 315 | |
| 316 | [ Python binding ] |
| 317 | |
| 318 | - Fix for Cython so it can properly initialize. |
| 319 | - X86Op.avx_zero_mask now has c_bool type, but not c_uint8 type. |
| 320 | - Properly support compile with Cygwin & install binding (setup.py). |
| 321 | |
| 322 | --------------------------------- |
Nguyen Anh Quynh | 359a8b7 | 2015-03-11 12:12:33 +0800 | [diff] [blame] | 323 | Version 3.0.2: March 11th, 2015 |
| 324 | |
| 325 | |
| 326 | [ Library ] |
| 327 | |
| 328 | - On *nix, only export symbols that are part of the API (instead of all |
| 329 | the internal symbols). |
| 330 | |
| 331 | |
| 332 | [ X86 ] |
| 333 | |
| 334 | - Do not consider 0xF2 as REPNE prefix if it is a part of instruction encoding. |
| 335 | - Fix implicit registers read/written & instruction groups of some instructions. |
| 336 | - More flexible on the order of prefixes, so better handle some tricky |
| 337 | instructions. |
| 338 | - REPNE prefix can go with STOS & MOVS instructions. |
| 339 | - Fix a compilation bug for X86_REDUCE mode. |
| 340 | - Fix operand size of instructions with operand PTR [] |
| 341 | |
| 342 | |
| 343 | [ Arm ] |
| 344 | |
| 345 | - Fix a bug where arm_op_mem.disp is wrongly calculated (in DETAIL mode). |
| 346 | - Fix a bug on handling the If-Then block. |
| 347 | |
| 348 | |
| 349 | [ Mips ] |
| 350 | |
| 351 | - Sanity check for the input size for MIPS64 mode. |
| 352 | |
| 353 | |
| 354 | [ MSVC ] |
| 355 | |
| 356 | - Compile capstone.dll with static runtime MSVCR built in. |
| 357 | |
| 358 | |
| 359 | [ Python binding ] |
| 360 | |
| 361 | - Fix a compiling issue of Cython binding with gcc 4.9. |
| 362 | |
| 363 | --------------------------------- |
| 364 | Version 3.0.1: February 03rd, 2015 |
Nguyen Anh Quynh | c6b1be8 | 2015-02-03 16:28:27 +0800 | [diff] [blame] | 365 | |
| 366 | [ X86 ] |
| 367 | |
| 368 | - Properly handle LOCK, REP, REPE & REPNE prefixes. |
| 369 | - Handle undocumented immediates for SSE's (V)CMPPS/PD/SS/SD instructions. |
| 370 | - Print LJUMP/LCALL without * as prefix for Intel syntax. |
| 371 | - Handle REX prefix properly for segment/MMX related instructions (x86_64). |
| 372 | - Instruction with length > 15 is consider invalid. |
| 373 | - Handle some tricky encodings for instructions MOVSXD, FXCH, FCOM, FCOMP, |
| 374 | FSTP, FSTPNCE, NOP. |
| 375 | - Handle some tricky code for some X86_64 instructions with REX prefix. |
| 376 | - Add missing operands in detail mode for PUSH , POP , IN/OUT reg, reg |
| 377 | - MOV32ms & MOV32sm should reference word rather than dword. |
| 378 | |
| 379 | |
| 380 | [ Arm64 ] |
| 381 | |
| 382 | - BL & BLR instructions do not read SP register. |
| 383 | - Print absolute (rather than relative) address for instructions B, BL, |
| 384 | CBNZ, ADR. |
| 385 | |
| 386 | |
| 387 | [ Arm ] |
| 388 | |
| 389 | - Instructions ADC & SBC do not update flags. |
| 390 | - BL & BLX do not read SP, but PC register. |
| 391 | - Alias LDR instruction with operands [sp], 4 to POP. |
| 392 | - Print immediate operand of MVN instruction in positive hexadecimal form. |
| 393 | |
| 394 | |
| 395 | [ PowerPC ] |
| 396 | |
| 397 | - Fix some compilation bugs when DIET mode is enable. |
| 398 | - Populate SLWI/SRWI instruction details with SH operand. |
| 399 | |
| 400 | |
| 401 | [ Python binding ] |
| 402 | |
| 403 | - Fix a Cython bug when CsInsn.bytes returns a shorten array of bytes. |
| 404 | - Fixed a memory leak for Cython disasm functions when we immaturely quit |
| 405 | the enumeration of disassembled instructions. |
| 406 | - Fix a NULL memory access issue when SKIPDATA & Detail modes are enable |
| 407 | at the same time. |
| 408 | - Fix a memory leaking bug when when we stop enumeration over the disassembled |
| 409 | instructions prematurely. |
| 410 | - Export generic operand types & groups (CS_OP_xxx & CS_GRP_xxx). |
| 411 | |
| 412 | --------------------------------- |
Nguyen Anh Quynh | b53a59a | 2014-11-19 17:56:04 +0800 | [diff] [blame] | 413 | Version 3.0: November 19th, 2014 |
Nguyen Anh Quynh | fadbddc | 2014-11-18 22:53:32 +0800 | [diff] [blame] | 414 | |
| 415 | [ API ] |
| 416 | |
| 417 | - New API: cs_disasm_iter & cs_malloc. See docs/README for tutorials. |
| 418 | - Renamed cs_disasm_ex to cs_disasm (cs_disasm_ex is still supported, but |
| 419 | marked obsolete to be removed in future) |
| 420 | - Support SKIPDATA mode, so Capstone can jump over unknown data and keep going |
| 421 | from the next legitimate instruction. See docs/README for tutorials. |
| 422 | - More details provided in cs_detail struct for all architectures. |
| 423 | - API version was bumped to 3.0. |
| 424 | |
| 425 | |
| 426 | [ Bindings ] |
| 427 | |
| 428 | - Python binding supports Python3 (besides Python2). |
| 429 | - Support Ocaml binding. |
Nguyen Anh Quynh | 8946029 | 2014-11-19 14:37:08 +0800 | [diff] [blame] | 430 | - Java: add close() method to be used to deinitialize a Capstone object when |
| 431 | no longer use it. |
Nguyen Anh Quynh | fadbddc | 2014-11-18 22:53:32 +0800 | [diff] [blame] | 432 | |
| 433 | |
| 434 | [ Architectures ] |
| 435 | |
| 436 | - New architectures: Sparc, SystemZ & XCore. |
| 437 | - Important bugfixes for Arm, Arm64, Mips, PowerPC & X86. |
| 438 | - Support more instructions for Arm, Arm64, Mips, PowerPC & X86. |
| 439 | - Always expose absolute addresses rather than relative addresses (Arm, Arm64, |
| 440 | Mips, PPC, Sparc, X86). |
| 441 | - Use common instruction operand types REG, IMM, MEM & FP across all |
| 442 | architectures (to enable cross-architecture analysis). |
| 443 | - Use common instruction group types across all architectures (to enable |
| 444 | cross-architecture analysis). |
| 445 | |
| 446 | |
| 447 | [ X86 ] |
| 448 | |
| 449 | - X86 engine is mature & handles all the malware tricks (that we are aware of). |
| 450 | - Added a lot of new instructions (such as AVX512, 3DNow, etc). |
| 451 | - Add prefix symbols X86_PREFIX_REP/REPNE/LOCK/CS/DS/SS/FS/GS/ES/OPSIZE/ADDRSIZE. |
| 452 | - Print immediate in positive form & hexadecimal for AND/OR/XOR instructions. |
| 453 | - More friendly disassembly for JMP16i (in the form segment:offset) |
| 454 | |
| 455 | |
| 456 | [ Mips ] |
| 457 | |
| 458 | - Engine added supports for new hardware modes: Mips32R6 (CS_MODE_MIPS32R6) & |
| 459 | MipsGP64 (CS_MODE_MIPSGP64). |
| 460 | - Removed the ABI-only mode CS_MODE_N64. |
| 461 | - New modes CS_MODE_MIPS32 & CS_MODE_MIPS64 (to use instead of CS_MODE_32 & |
| 462 | CS_MODE_64). |
| 463 | |
| 464 | |
| 465 | [ ARM ] |
| 466 | |
| 467 | - Support new mode CS_MODE_V8 for Armv8 A32 encodings. |
| 468 | - Print immediate in positive form & hexadecimal for AND/ORR/EOR/BIC instructions |
| 469 | |
| 470 | |
| 471 | [ ARM64 ] |
| 472 | |
| 473 | - Print immediate in hexadecimal for AND/ORR/EOR/TST instructions. |
| 474 | |
| 475 | |
| 476 | [ PowerPC ] |
| 477 | |
| 478 | - Do not print a dot in front of absolute address. |
| 479 | |
| 480 | |
| 481 | [ Other features ] |
| 482 | |
| 483 | - Support for Microsoft Visual Studio (so enable Windows native compilation). |
| 484 | - Support CMake compilation. |
| 485 | - Cross-compile for Android. |
| 486 | - Build libraries/tests using XCode project |
| 487 | - Much faster, while consuming less memory for all architectures. |
| 488 | |
| 489 | --------------------------------- |
Nguyen Anh Quynh | 2f43c39 | 2014-04-01 09:19:19 +0800 | [diff] [blame] | 490 | Version 2.1.2: April 3rd, 2014 |
Nguyen Anh Quynh | 025a345 | 2014-03-30 22:39:22 +0800 | [diff] [blame] | 491 | |
| 492 | This is a stable release to fix some bugs deep in the core. There is no update |
| 493 | to any architectures or bindings, so bindings version 2.1 can be used with this |
| 494 | version 2.1.2 just fine. |
| 495 | |
| 496 | [ Core changes] |
| 497 | |
Nguyen Anh Quynh | 2f43c39 | 2014-04-01 09:19:19 +0800 | [diff] [blame] | 498 | - Support cross-compilation for all iDevices (iPhone/iPad/iPod). |
| 499 | - X86: do not print memory offset in negative form. |
Nguyen Anh Quynh | 025a345 | 2014-03-30 22:39:22 +0800 | [diff] [blame] | 500 | - Fix a bug in X86 when Capstone cannot handle short instruction. |
| 501 | - Print negative number above -9 without prefix 0x (arm64, mips, arm). |
| 502 | - Correct the SONAME setup for library versioning (Linux, *BSD, Solaris). |
| 503 | - Set library versioning for dylib of OSX. |
| 504 | |
| 505 | --------------------------------- |
Nguyen Anh Quynh | 56db639 | 2014-03-11 11:24:46 +0800 | [diff] [blame] | 506 | Version 2.1.1: March 13th, 2014 |
| 507 | |
| 508 | This is a stable release to fix some bugs deep in the core. There is no update |
| 509 | to any architectures or bindings, so bindings version 2.1 can be used with this |
| 510 | version 2.1.1 just fine. |
| 511 | |
| 512 | [ Core changes] |
| 513 | |
| 514 | - Fix a buffer overflow bug in Thumb mode (ARM). Some special input can |
| 515 | trigger this flaw. |
| 516 | - Fix a crash issue when embedding Capstone into OSX kernel. This should |
Nguyen Anh Quynh | a96d25e | 2014-03-11 11:41:09 +0800 | [diff] [blame] | 517 | also enable Capstone to be embedded into other systems with limited stack |
Nguyen Anh Quynh | 56db639 | 2014-03-11 11:24:46 +0800 | [diff] [blame] | 518 | memory size such as Linux kernel or some firmwares. |
| 519 | - Use a proper SONAME for library versioning (Linux). |
| 520 | |
| 521 | --------------------------------- |
Nguyen Anh Quynh | f51971d | 2014-03-05 00:09:49 +0800 | [diff] [blame] | 522 | Version 2.1: March 5th, 2014 |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 523 | |
| 524 | [ API changes ] |
| 525 | |
| 526 | - API version has been bumped to 2.1. |
Nguyen Anh Quynh | 6cfabcd | 2014-03-03 17:04:15 +0800 | [diff] [blame] | 527 | - Change prototype of cs_close() to be able to invalidate closed handle. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 528 | See http://capstone-engine.org/version_2.1_API.html for more information. |
| 529 | - Extend cs_support() to handle more query types, not only about supported |
| 530 | architectures. This change is backward compatible, however, so existent code |
| 531 | do not need to be modified to support this. |
| 532 | - New query type CS_SUPPORT_DIET for cs_support() to ask about diet status of |
| 533 | the engine. |
| 534 | - New error code CS_ERR_DIET to report errors about newly added diet mode. |
| 535 | - New error code CS_ERR_VERSION to report issue of incompatible versions between |
| 536 | bindings & core engine. |
| 537 | |
| 538 | |
| 539 | [ Core changes ] |
| 540 | |
| 541 | - On memory usage, Capstone uses about 40% less memory, while still faster |
| 542 | than version 2.0. |
| 543 | - All architectures are much smaller: binaries size reduce at least 30%. |
| 544 | Especially, X86-only binary reduces from 1.9MB to just 720KB. |
| 545 | - Support "diet" mode, in which engine size is further reduced (by around 40%) |
| 546 | for embedding purpose. The price to pay is that we have to sacrifice some |
| 547 | non-critical data fields. See http://capstone-engine.org/diet.html for more |
| 548 | details. |
| 549 | |
| 550 | |
| 551 | [ Architectures ] |
| 552 | |
Nguyen Anh Quynh | 6cfabcd | 2014-03-03 17:04:15 +0800 | [diff] [blame] | 553 | - Update all 5 architectures to fix bugs. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 554 | - PowerPC: |
| 555 | - New instructions: FMR & MSYNC. |
| 556 | - Mips: |
| 557 | - New instruction: DLSA |
| 558 | - X86: |
| 559 | - Properly handle AVX-512 instructions. |
| 560 | - New instructions: PSETPM, SALC, INT1, GETSEC. |
| 561 | - Fix some memory leaking issues in case of prefixed instructions such |
| 562 | as LOCK, REP, REPNE. |
| 563 | |
| 564 | |
| 565 | [ Python binding ] |
| 566 | |
| 567 | - Verify the core version at initialization time. Refuse to run if its version |
| 568 | is different from the core's version. |
| 569 | - New API disasm_lite() added to Cs class. This light API only returns tuples of |
Nguyen Anh Quynh | 6cfabcd | 2014-03-03 17:04:15 +0800 | [diff] [blame] | 570 | (address, size, mnemonic, op_str), rather than list of CsInsn objects. This |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 571 | improves performance by around 30% in some benchmarks. |
Nguyen Anh Quynh | 7fc8121 | 2014-03-04 23:56:42 +0800 | [diff] [blame] | 572 | - New API version_bind() returns binding's version, which might differ from |
Nguyen Anh Quynh | b0b7308 | 2014-03-03 17:57:15 +0800 | [diff] [blame] | 573 | the core's API version if the binding is out-of-date. |
Nguyen Anh Quynh | f51971d | 2014-03-05 00:09:49 +0800 | [diff] [blame] | 574 | - New API debug() returns information on Cython support, diet status & archs |
Nguyen Anh Quynh | 7fc8121 | 2014-03-04 23:56:42 +0800 | [diff] [blame] | 575 | compiled in. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 576 | - Fixed some memory leaking bugs for Cython binding. |
| 577 | - Fix a bug crashing Cython code when accessing @regs_read/regs_write/groups. |
Nguyen Anh Quynh | e6c378e | 2014-03-03 17:25:53 +0800 | [diff] [blame] | 578 | - Support diet mode. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 579 | |
| 580 | |
| 581 | [ Java binding ] |
| 582 | |
| 583 | - Fix some memory leaking bugs. |
Nguyen Anh Quynh | e6c378e | 2014-03-03 17:25:53 +0800 | [diff] [blame] | 584 | - New API version() returns combined version. |
| 585 | - Support diet mode. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 586 | - Better support for detail option. |
| 587 | |
| 588 | |
| 589 | [ Miscellaneous ] |
| 590 | |
Nguyen Anh Quynh | 6cfabcd | 2014-03-03 17:04:15 +0800 | [diff] [blame] | 591 | - make.sh now can uninstall the core engine. This is done with: |
| 592 | |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 593 | $ sudo ./make.sh uninstall |
| 594 | |
| 595 | ---------------------------------- |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 596 | Version 2.0: January 22nd, 2014 |
Nguyen Anh Quynh | 8282dc6 | 2014-01-15 21:20:47 +0800 | [diff] [blame] | 597 | |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 598 | Release 2.0 deprecates verison 1.0 and brings a lot of crucial changes. |
Nguyen Anh Quynh | 8282dc6 | 2014-01-15 21:20:47 +0800 | [diff] [blame] | 599 | |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 600 | [ API changes ] |
| 601 | |
| 602 | - API version has been bumped to 2.0 (see cs_version() API) |
| 603 | - New API cs_strerror(errno) returns a string describing error code given |
| 604 | in its only argument. |
| 605 | - cs_version() now returns combined version encoding both major & minor versions. |
| 606 | - New option CS_OPT_MODE allows to change engine’s mode at run-time with |
| 607 | cs_option(). |
| 608 | - New option CS_OPT_MEM allows to specify user-defined functions for dynamically |
| 609 | memory management used internally by Capstone. This is useful to embed Capstone |
| 610 | into special environments such as kernel or firware. |
| 611 | - New API cs_support() can be used to check if this lib supports a particular |
| 612 | architecture (this is necessary since we now allow to choose which architectures |
| 613 | to compile in). |
| 614 | - The detail option is OFF by default now. To get detail information, it should be |
| 615 | explicitly turned ON. The details then can be accessed using cs_insn.detail |
| 616 | pointer (to newly added structure cs_detail) |
Nguyen Anh Quynh | 8282dc6 | 2014-01-15 21:20:47 +0800 | [diff] [blame] | 617 | |
| 618 | |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 619 | [ Core changes ] |
| 620 | |
| 621 | - On memory usage, Capstone uses much less memory, but a lot faster now. |
| 622 | - User now can choose which architectures to be supported by modifying config.mk |
| 623 | before compiling/installing. |
| 624 | |
| 625 | |
| 626 | [ Architectures ] |
| 627 | |
| 628 | - Arm |
| 629 | - Support Big-Endian mode (besides Little-Endian mode). |
Nguyen Anh Quynh | 6c5eec5 | 2014-01-22 18:33:35 +0800 | [diff] [blame] | 630 | - Support friendly register, so instead of output sub "r12,r11,0x14", |
| 631 | we have "sub ip,fp,0x14". |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 632 | - Arm64: support Big-Endian mode (besides Little-Endian mode). |
| 633 | - PowerPC: newly added. |
Nguyen Anh Quynh | 6c5eec5 | 2014-01-22 18:33:35 +0800 | [diff] [blame] | 634 | - Mips: support friendly register, so instead of output "srl $2,$1,0x1f", |
| 635 | we have "srl $v0,$at,0x1f". |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 636 | - X86: bug fixes. |
| 637 | |
| 638 | |
| 639 | [ Python binding ] |
| 640 | |
| 641 | - Python binding is vastly improved in performance: around 3 ~ 4 times faster |
| 642 | than in 1.0. |
| 643 | - Cython support has been added, which can further speed up over the default |
| 644 | pure Python binding (up to 30% in some cases) |
| 645 | - Function cs_disasm_quick() & Cs.disasm() now use generator (rather than a list) |
| 646 | to return succesfully disassembled instructions. This improves the performance |
| 647 | and reduces memory usage. |
| 648 | |
| 649 | |
| 650 | [ Java binding ] |
| 651 | |
| 652 | - Better performance & bug fixes. |
| 653 | |
| 654 | |
| 655 | [ Miscellaneous ] |
| 656 | |
| 657 | - Fixed some installation issues with Gentoo Linux. |
| 658 | - Capstone now can easily compile/install on all *nix, including Linux, OSX, |
| 659 | {Net, Free, Open}BSD & Solaris. |
| 660 | |
| 661 | ---------------------------------- |
Nguyen Anh Quynh | 8282dc6 | 2014-01-15 21:20:47 +0800 | [diff] [blame] | 662 | [Version 1.0]: December 18th, 2013 |
| 663 | |
| 664 | - Initial public release. |
| 665 | |