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