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 | 512303b | 2015-05-08 15:17:01 +0800 | [diff] [blame] | 4 | Version 3.0.3: May 08th, 2015 |
| 5 | |
| 6 | |
| 7 | [ Library ] |
| 8 | |
| 9 | - Support to embed into Mac OS X kernel extensions. |
| 10 | - Now it is possible to compile Capstone with older C compilers, such as |
| 11 | GCC 4.8 on Ubuntu 12.04. |
| 12 | - Add "test_iter" to MSVC project. |
| 13 | |
| 14 | |
| 15 | [ X86 ] |
| 16 | |
| 17 | - All shifted instructions SHL, SHR, SAL, SAR, RCL, RCR, ROL & ROR now support |
| 18 | $1 as first operand in *AT&T* syntax (so we have "rcll $1, %edx" instead of |
| 19 | "rcll %edx"). |
| 20 | - CMPXCHG16B is a valid instruction with LOCK prefix. |
| 21 | - Fixed a segfault on the input of 0xF3. |
| 22 | |
| 23 | |
| 24 | [ Arm ] |
| 25 | |
| 26 | - BLX instruction modifies PC & LR registers. |
| 27 | |
| 28 | |
| 29 | [ Sparc ] |
| 30 | |
| 31 | - Improved displacement decoding for sparc banching instructions. |
| 32 | |
| 33 | |
| 34 | [ Python binding ] |
| 35 | |
| 36 | - Fix for Cython so it can properly initialize. |
| 37 | - X86Op.avx_zero_mask now has c_bool type, but not c_uint8 type. |
| 38 | - Properly support compile with Cygwin & install binding (setup.py). |
| 39 | |
| 40 | --------------------------------- |
Nguyen Anh Quynh | 359a8b7 | 2015-03-11 12:12:33 +0800 | [diff] [blame] | 41 | Version 3.0.2: March 11th, 2015 |
| 42 | |
| 43 | |
| 44 | [ Library ] |
| 45 | |
| 46 | - On *nix, only export symbols that are part of the API (instead of all |
| 47 | the internal symbols). |
| 48 | |
| 49 | |
| 50 | [ X86 ] |
| 51 | |
| 52 | - Do not consider 0xF2 as REPNE prefix if it is a part of instruction encoding. |
| 53 | - Fix implicit registers read/written & instruction groups of some instructions. |
| 54 | - More flexible on the order of prefixes, so better handle some tricky |
| 55 | instructions. |
| 56 | - REPNE prefix can go with STOS & MOVS instructions. |
| 57 | - Fix a compilation bug for X86_REDUCE mode. |
| 58 | - Fix operand size of instructions with operand PTR [] |
| 59 | |
| 60 | |
| 61 | [ Arm ] |
| 62 | |
| 63 | - Fix a bug where arm_op_mem.disp is wrongly calculated (in DETAIL mode). |
| 64 | - Fix a bug on handling the If-Then block. |
| 65 | |
| 66 | |
| 67 | [ Mips ] |
| 68 | |
| 69 | - Sanity check for the input size for MIPS64 mode. |
| 70 | |
| 71 | |
| 72 | [ MSVC ] |
| 73 | |
| 74 | - Compile capstone.dll with static runtime MSVCR built in. |
| 75 | |
| 76 | |
| 77 | [ Python binding ] |
| 78 | |
| 79 | - Fix a compiling issue of Cython binding with gcc 4.9. |
| 80 | |
| 81 | --------------------------------- |
| 82 | Version 3.0.1: February 03rd, 2015 |
Nguyen Anh Quynh | c6b1be8 | 2015-02-03 16:28:27 +0800 | [diff] [blame] | 83 | |
| 84 | [ X86 ] |
| 85 | |
| 86 | - Properly handle LOCK, REP, REPE & REPNE prefixes. |
| 87 | - Handle undocumented immediates for SSE's (V)CMPPS/PD/SS/SD instructions. |
| 88 | - Print LJUMP/LCALL without * as prefix for Intel syntax. |
| 89 | - Handle REX prefix properly for segment/MMX related instructions (x86_64). |
| 90 | - Instruction with length > 15 is consider invalid. |
| 91 | - Handle some tricky encodings for instructions MOVSXD, FXCH, FCOM, FCOMP, |
| 92 | FSTP, FSTPNCE, NOP. |
| 93 | - Handle some tricky code for some X86_64 instructions with REX prefix. |
| 94 | - Add missing operands in detail mode for PUSH , POP , IN/OUT reg, reg |
| 95 | - MOV32ms & MOV32sm should reference word rather than dword. |
| 96 | |
| 97 | |
| 98 | [ Arm64 ] |
| 99 | |
| 100 | - BL & BLR instructions do not read SP register. |
| 101 | - Print absolute (rather than relative) address for instructions B, BL, |
| 102 | CBNZ, ADR. |
| 103 | |
| 104 | |
| 105 | [ Arm ] |
| 106 | |
| 107 | - Instructions ADC & SBC do not update flags. |
| 108 | - BL & BLX do not read SP, but PC register. |
| 109 | - Alias LDR instruction with operands [sp], 4 to POP. |
| 110 | - Print immediate operand of MVN instruction in positive hexadecimal form. |
| 111 | |
| 112 | |
| 113 | [ PowerPC ] |
| 114 | |
| 115 | - Fix some compilation bugs when DIET mode is enable. |
| 116 | - Populate SLWI/SRWI instruction details with SH operand. |
| 117 | |
| 118 | |
| 119 | [ Python binding ] |
| 120 | |
| 121 | - Fix a Cython bug when CsInsn.bytes returns a shorten array of bytes. |
| 122 | - Fixed a memory leak for Cython disasm functions when we immaturely quit |
| 123 | the enumeration of disassembled instructions. |
| 124 | - Fix a NULL memory access issue when SKIPDATA & Detail modes are enable |
| 125 | at the same time. |
| 126 | - Fix a memory leaking bug when when we stop enumeration over the disassembled |
| 127 | instructions prematurely. |
| 128 | - Export generic operand types & groups (CS_OP_xxx & CS_GRP_xxx). |
| 129 | |
| 130 | --------------------------------- |
Nguyen Anh Quynh | b53a59a | 2014-11-19 17:56:04 +0800 | [diff] [blame] | 131 | Version 3.0: November 19th, 2014 |
Nguyen Anh Quynh | fadbddc | 2014-11-18 22:53:32 +0800 | [diff] [blame] | 132 | |
| 133 | [ API ] |
| 134 | |
| 135 | - New API: cs_disasm_iter & cs_malloc. See docs/README for tutorials. |
| 136 | - Renamed cs_disasm_ex to cs_disasm (cs_disasm_ex is still supported, but |
| 137 | marked obsolete to be removed in future) |
| 138 | - Support SKIPDATA mode, so Capstone can jump over unknown data and keep going |
| 139 | from the next legitimate instruction. See docs/README for tutorials. |
| 140 | - More details provided in cs_detail struct for all architectures. |
| 141 | - API version was bumped to 3.0. |
| 142 | |
| 143 | |
| 144 | [ Bindings ] |
| 145 | |
| 146 | - Python binding supports Python3 (besides Python2). |
| 147 | - Support Ocaml binding. |
Nguyen Anh Quynh | 8946029 | 2014-11-19 14:37:08 +0800 | [diff] [blame] | 148 | - Java: add close() method to be used to deinitialize a Capstone object when |
| 149 | no longer use it. |
Nguyen Anh Quynh | fadbddc | 2014-11-18 22:53:32 +0800 | [diff] [blame] | 150 | |
| 151 | |
| 152 | [ Architectures ] |
| 153 | |
| 154 | - New architectures: Sparc, SystemZ & XCore. |
| 155 | - Important bugfixes for Arm, Arm64, Mips, PowerPC & X86. |
| 156 | - Support more instructions for Arm, Arm64, Mips, PowerPC & X86. |
| 157 | - Always expose absolute addresses rather than relative addresses (Arm, Arm64, |
| 158 | Mips, PPC, Sparc, X86). |
| 159 | - Use common instruction operand types REG, IMM, MEM & FP across all |
| 160 | architectures (to enable cross-architecture analysis). |
| 161 | - Use common instruction group types across all architectures (to enable |
| 162 | cross-architecture analysis). |
| 163 | |
| 164 | |
| 165 | [ X86 ] |
| 166 | |
| 167 | - X86 engine is mature & handles all the malware tricks (that we are aware of). |
| 168 | - Added a lot of new instructions (such as AVX512, 3DNow, etc). |
| 169 | - Add prefix symbols X86_PREFIX_REP/REPNE/LOCK/CS/DS/SS/FS/GS/ES/OPSIZE/ADDRSIZE. |
| 170 | - Print immediate in positive form & hexadecimal for AND/OR/XOR instructions. |
| 171 | - More friendly disassembly for JMP16i (in the form segment:offset) |
| 172 | |
| 173 | |
| 174 | [ Mips ] |
| 175 | |
| 176 | - Engine added supports for new hardware modes: Mips32R6 (CS_MODE_MIPS32R6) & |
| 177 | MipsGP64 (CS_MODE_MIPSGP64). |
| 178 | - Removed the ABI-only mode CS_MODE_N64. |
| 179 | - New modes CS_MODE_MIPS32 & CS_MODE_MIPS64 (to use instead of CS_MODE_32 & |
| 180 | CS_MODE_64). |
| 181 | |
| 182 | |
| 183 | [ ARM ] |
| 184 | |
| 185 | - Support new mode CS_MODE_V8 for Armv8 A32 encodings. |
| 186 | - Print immediate in positive form & hexadecimal for AND/ORR/EOR/BIC instructions |
| 187 | |
| 188 | |
| 189 | [ ARM64 ] |
| 190 | |
| 191 | - Print immediate in hexadecimal for AND/ORR/EOR/TST instructions. |
| 192 | |
| 193 | |
| 194 | [ PowerPC ] |
| 195 | |
| 196 | - Do not print a dot in front of absolute address. |
| 197 | |
| 198 | |
| 199 | [ Other features ] |
| 200 | |
| 201 | - Support for Microsoft Visual Studio (so enable Windows native compilation). |
| 202 | - Support CMake compilation. |
| 203 | - Cross-compile for Android. |
| 204 | - Build libraries/tests using XCode project |
| 205 | - Much faster, while consuming less memory for all architectures. |
| 206 | |
| 207 | --------------------------------- |
Nguyen Anh Quynh | 2f43c39 | 2014-04-01 09:19:19 +0800 | [diff] [blame] | 208 | Version 2.1.2: April 3rd, 2014 |
Nguyen Anh Quynh | 025a345 | 2014-03-30 22:39:22 +0800 | [diff] [blame] | 209 | |
| 210 | This is a stable release to fix some bugs deep in the core. There is no update |
| 211 | to any architectures or bindings, so bindings version 2.1 can be used with this |
| 212 | version 2.1.2 just fine. |
| 213 | |
| 214 | [ Core changes] |
| 215 | |
Nguyen Anh Quynh | 2f43c39 | 2014-04-01 09:19:19 +0800 | [diff] [blame] | 216 | - Support cross-compilation for all iDevices (iPhone/iPad/iPod). |
| 217 | - X86: do not print memory offset in negative form. |
Nguyen Anh Quynh | 025a345 | 2014-03-30 22:39:22 +0800 | [diff] [blame] | 218 | - Fix a bug in X86 when Capstone cannot handle short instruction. |
| 219 | - Print negative number above -9 without prefix 0x (arm64, mips, arm). |
| 220 | - Correct the SONAME setup for library versioning (Linux, *BSD, Solaris). |
| 221 | - Set library versioning for dylib of OSX. |
| 222 | |
| 223 | --------------------------------- |
Nguyen Anh Quynh | 56db639 | 2014-03-11 11:24:46 +0800 | [diff] [blame] | 224 | Version 2.1.1: March 13th, 2014 |
| 225 | |
| 226 | This is a stable release to fix some bugs deep in the core. There is no update |
| 227 | to any architectures or bindings, so bindings version 2.1 can be used with this |
| 228 | version 2.1.1 just fine. |
| 229 | |
| 230 | [ Core changes] |
| 231 | |
| 232 | - Fix a buffer overflow bug in Thumb mode (ARM). Some special input can |
| 233 | trigger this flaw. |
| 234 | - 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] | 235 | 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] | 236 | memory size such as Linux kernel or some firmwares. |
| 237 | - Use a proper SONAME for library versioning (Linux). |
| 238 | |
| 239 | --------------------------------- |
Nguyen Anh Quynh | f51971d | 2014-03-05 00:09:49 +0800 | [diff] [blame] | 240 | Version 2.1: March 5th, 2014 |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 241 | |
| 242 | [ API changes ] |
| 243 | |
| 244 | - API version has been bumped to 2.1. |
Nguyen Anh Quynh | 6cfabcd | 2014-03-03 17:04:15 +0800 | [diff] [blame] | 245 | - 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] | 246 | See http://capstone-engine.org/version_2.1_API.html for more information. |
| 247 | - Extend cs_support() to handle more query types, not only about supported |
| 248 | architectures. This change is backward compatible, however, so existent code |
| 249 | do not need to be modified to support this. |
| 250 | - New query type CS_SUPPORT_DIET for cs_support() to ask about diet status of |
| 251 | the engine. |
| 252 | - New error code CS_ERR_DIET to report errors about newly added diet mode. |
| 253 | - New error code CS_ERR_VERSION to report issue of incompatible versions between |
| 254 | bindings & core engine. |
| 255 | |
| 256 | |
| 257 | [ Core changes ] |
| 258 | |
| 259 | - On memory usage, Capstone uses about 40% less memory, while still faster |
| 260 | than version 2.0. |
| 261 | - All architectures are much smaller: binaries size reduce at least 30%. |
| 262 | Especially, X86-only binary reduces from 1.9MB to just 720KB. |
| 263 | - Support "diet" mode, in which engine size is further reduced (by around 40%) |
| 264 | for embedding purpose. The price to pay is that we have to sacrifice some |
| 265 | non-critical data fields. See http://capstone-engine.org/diet.html for more |
| 266 | details. |
| 267 | |
| 268 | |
| 269 | [ Architectures ] |
| 270 | |
Nguyen Anh Quynh | 6cfabcd | 2014-03-03 17:04:15 +0800 | [diff] [blame] | 271 | - Update all 5 architectures to fix bugs. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 272 | - PowerPC: |
| 273 | - New instructions: FMR & MSYNC. |
| 274 | - Mips: |
| 275 | - New instruction: DLSA |
| 276 | - X86: |
| 277 | - Properly handle AVX-512 instructions. |
| 278 | - New instructions: PSETPM, SALC, INT1, GETSEC. |
| 279 | - Fix some memory leaking issues in case of prefixed instructions such |
| 280 | as LOCK, REP, REPNE. |
| 281 | |
| 282 | |
| 283 | [ Python binding ] |
| 284 | |
| 285 | - Verify the core version at initialization time. Refuse to run if its version |
| 286 | is different from the core's version. |
| 287 | - 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] | 288 | (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] | 289 | improves performance by around 30% in some benchmarks. |
Nguyen Anh Quynh | 7fc8121 | 2014-03-04 23:56:42 +0800 | [diff] [blame] | 290 | - 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] | 291 | 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] | 292 | - New API debug() returns information on Cython support, diet status & archs |
Nguyen Anh Quynh | 7fc8121 | 2014-03-04 23:56:42 +0800 | [diff] [blame] | 293 | compiled in. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 294 | - Fixed some memory leaking bugs for Cython binding. |
| 295 | - 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] | 296 | - Support diet mode. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 297 | |
| 298 | |
| 299 | [ Java binding ] |
| 300 | |
| 301 | - Fix some memory leaking bugs. |
Nguyen Anh Quynh | e6c378e | 2014-03-03 17:25:53 +0800 | [diff] [blame] | 302 | - New API version() returns combined version. |
| 303 | - Support diet mode. |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 304 | - Better support for detail option. |
| 305 | |
| 306 | |
| 307 | [ Miscellaneous ] |
| 308 | |
Nguyen Anh Quynh | 6cfabcd | 2014-03-03 17:04:15 +0800 | [diff] [blame] | 309 | - make.sh now can uninstall the core engine. This is done with: |
| 310 | |
Nguyen Anh Quynh | 6e6ada2 | 2014-03-03 16:50:04 +0800 | [diff] [blame] | 311 | $ sudo ./make.sh uninstall |
| 312 | |
| 313 | ---------------------------------- |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 314 | Version 2.0: January 22nd, 2014 |
Nguyen Anh Quynh | 8282dc6 | 2014-01-15 21:20:47 +0800 | [diff] [blame] | 315 | |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 316 | 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] | 317 | |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 318 | [ API changes ] |
| 319 | |
| 320 | - API version has been bumped to 2.0 (see cs_version() API) |
| 321 | - New API cs_strerror(errno) returns a string describing error code given |
| 322 | in its only argument. |
| 323 | - cs_version() now returns combined version encoding both major & minor versions. |
| 324 | - New option CS_OPT_MODE allows to change engine’s mode at run-time with |
| 325 | cs_option(). |
| 326 | - New option CS_OPT_MEM allows to specify user-defined functions for dynamically |
| 327 | memory management used internally by Capstone. This is useful to embed Capstone |
| 328 | into special environments such as kernel or firware. |
| 329 | - New API cs_support() can be used to check if this lib supports a particular |
| 330 | architecture (this is necessary since we now allow to choose which architectures |
| 331 | to compile in). |
| 332 | - The detail option is OFF by default now. To get detail information, it should be |
| 333 | explicitly turned ON. The details then can be accessed using cs_insn.detail |
| 334 | pointer (to newly added structure cs_detail) |
Nguyen Anh Quynh | 8282dc6 | 2014-01-15 21:20:47 +0800 | [diff] [blame] | 335 | |
| 336 | |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 337 | [ Core changes ] |
| 338 | |
| 339 | - On memory usage, Capstone uses much less memory, but a lot faster now. |
| 340 | - User now can choose which architectures to be supported by modifying config.mk |
| 341 | before compiling/installing. |
| 342 | |
| 343 | |
| 344 | [ Architectures ] |
| 345 | |
| 346 | - Arm |
| 347 | - Support Big-Endian mode (besides Little-Endian mode). |
Nguyen Anh Quynh | 6c5eec5 | 2014-01-22 18:33:35 +0800 | [diff] [blame] | 348 | - Support friendly register, so instead of output sub "r12,r11,0x14", |
| 349 | we have "sub ip,fp,0x14". |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 350 | - Arm64: support Big-Endian mode (besides Little-Endian mode). |
| 351 | - PowerPC: newly added. |
Nguyen Anh Quynh | 6c5eec5 | 2014-01-22 18:33:35 +0800 | [diff] [blame] | 352 | - Mips: support friendly register, so instead of output "srl $2,$1,0x1f", |
| 353 | we have "srl $v0,$at,0x1f". |
Nguyen Anh Quynh | 1ee2326 | 2014-01-22 18:27:39 +0800 | [diff] [blame] | 354 | - X86: bug fixes. |
| 355 | |
| 356 | |
| 357 | [ Python binding ] |
| 358 | |
| 359 | - Python binding is vastly improved in performance: around 3 ~ 4 times faster |
| 360 | than in 1.0. |
| 361 | - Cython support has been added, which can further speed up over the default |
| 362 | pure Python binding (up to 30% in some cases) |
| 363 | - Function cs_disasm_quick() & Cs.disasm() now use generator (rather than a list) |
| 364 | to return succesfully disassembled instructions. This improves the performance |
| 365 | and reduces memory usage. |
| 366 | |
| 367 | |
| 368 | [ Java binding ] |
| 369 | |
| 370 | - Better performance & bug fixes. |
| 371 | |
| 372 | |
| 373 | [ Miscellaneous ] |
| 374 | |
| 375 | - Fixed some installation issues with Gentoo Linux. |
| 376 | - Capstone now can easily compile/install on all *nix, including Linux, OSX, |
| 377 | {Net, Free, Open}BSD & Solaris. |
| 378 | |
| 379 | ---------------------------------- |
Nguyen Anh Quynh | 8282dc6 | 2014-01-15 21:20:47 +0800 | [diff] [blame] | 380 | [Version 1.0]: December 18th, 2013 |
| 381 | |
| 382 | - Initial public release. |
| 383 | |