doc/changes.src

   1 \#
   2 \# NASM revision history in nasmdoc format
   3 \#
   4
   5 \H{cl-2.xx} NASM 2 Series
   6
   7 The NASM 2 series supports x86-64, and is the production version of NASM
   8 since 2007.
   9
  10 \S{cl-2.11.08} Version 2.11.08
  11
  12 \b Fix section length computation in \c{bin} backend which leaded in incorrect
  13    relocation records.
  14
  15 \b Add a warning for numeric preprocessor definitions passed via command
  16    line which might have unexpected results otherwise.
  17
  18 \b Add ability to specify a module name record in \c{rdoff} linker with
  19    \c{-mn} option.
  20
  21 \b Increase label length capacity up to 256 bytes in \c{rdoff} backend for
  22    FreePascal sake, which tends to generate very long labels for procedures.
  23
  24 \b Fix segmentation failure when rip addressing is used in \c{macho64} backend.
  25
  26 \b Fix access on out of memory when handling strings with a single
  27    grave. We have sixed similar problem in previous release but not
  28    all cases were covered.
  29
  30 \b Fix NULL dereference in disassembled on \c{BND} instruction.
  31
  32 \S{cl-2.11.07} Version 2.11.07
  33
  34 \b Fix 256 bit \c{VMOVNTPS} instruction.
  35
  36 \b Fix \c{-MD} option handling, which was rather broken in previous
  37 release changing command line api.
  38
  39 \b Fix access to unitialized space when handling strings with
  40 a single grave.
  41
  42 \b Fix nil dereference in handling memory reference parsing.
  43
  44 \S{cl-2.11.06} Version 2.11.06
  45
  46 \b Update AVX512 instructions based on the Extension Reference (319433-021 Sept
  47 2014).
  48
  49 \b Fix the behavior of \c{-MF} and \c{-MD} options (Bugzilla 3392280)
  50
  51 \b Updated Win32 Makefile to fix issue with build
  52
  53 \S{cl-2.11.05} Version 2.11.05
  54
  55 \b Add \c{--v} as an alias for \c{-v} (see \k{opt-v}), for
  56 command-line compatibility with Yasm.
  57
  58 \b Fix a bug introduced in 2.11.03 whereby certain instructions would
  59 contain multiple REX prefixes, and thus be corrupt.
  60
  61 \S{cl-2.11.04} Version 2.11.04
  62
  63 \b Removed an invalid error checking code. Sometimes a memref only with
  64 a displacement can also set an evex flag. For example:
  65
  66 \c       vmovdqu32 [0xabcd]{k1}, zmm0
  67
  68 \b Fixed a bug in disassembler that EVEX.L'L vector length was not matched
  69 when EVEX.b was set because it was simply considered as EVEC.RC.
  70 Separated EVEX.L'L case from EVEX.RC which is ignored in matching.
  71
  72 \S{cl-2.11.03} Version 2.11.03
  73
  74 \b Fix a bug there REX prefixes were missing on instructions inside a
  75 \c{TIMES} statement.
  76
  77 \S{cl-2.11.02} Version 2.11.02
  78
  79 \b Add the \c{XSAVEC}, \c{XSAVES} and \c{XRSTORS} family instructions.
  80
  81 \b Add the \c{CLFLUSHOPT} instruction.
  82
  83 \S{cl-2.11.01} Version 2.11.01
  84
  85 \b Allow instructions which implicitly uses \c{XMM0} (\c{VBLENDVPD},
  86 \c{VBLENDVPS}, \c{PBLENDVB} and \c{SHA256RNDS2}) to be specified
  87 without an explicit \c{xmm0} on the assembly line.  In other words,
  88 the following two lines produce the same output:
  89
  90 \c      vblendvpd xmm2,xmm1,xmm0      ; Last operand is fixed xmm0
  91 \c      vblendvpd xmm2,xmm1           ; Implicit xmm0 omitted
  92
  93 \b In the ELF backends, don't crash the assembler if \c{section align}
  94 is specified without a value.
  95
  96 \S{cl-2.11} Version 2.11
  97
  98 \b Add support for the Intel AVX-512 instruction set:
  99
 100 \b 16 new, 512-bit SIMD registers. Total 32 \c{(ZMM0 ~ ZMM31)}
 101
 102 \b 8 new opmask registers \c{(K0 ~ K7)}. One of 7 registers \c{(K1 ~ K7)} can
 103 be used as an opmask for conditional execution.
 104
 105 \b A new EVEX encoding prefix. EVEX is based on VEX and provides more
 106 capabilities: opmasks, broadcasting, embedded rounding and compressed
 107 displacements.
 108
 109 \c  - opmask
 110 \c      VDIVPD zmm0{k1}{z}, zmm1, zmm3  ; conditional vector operation
 111 \c                                      ; using opmask k1.
 112 \c                                      ; {z} is for zero-masking
 113 \c  - broadcasting
 114 \c      VDIVPS zmm4, zmm5, [rbx]{1to16} ; load single-precision float and
 115 \c                                      ; replicate it 16 times. 32 * 16 = 512
 116 \c  - embedded rounding
 117 \c      VCVTSI2SD xmm6, xmm7, {rz-sae}, rax ; round toward zero. note that it
 118 \c                                       ; is used as if a separate operand.
 119 \c                                       ; it comes after the last SIMD operand
 120
 121 \b Add support for \c{ZWORD} (512 bits), \c{DZ} and \c{RESZ}.
 122
 123 \b Add support for the MPX and SHA instruction sets.
 124
 125 \b Better handling of section redefinition.
 126
 127 \b Generate manpages when running \c{'make dist'}.
 128
 129 \b Handle all token chains in mmacro params range.
 130
 131 \b Support split [base,index] effective address:
 132
 133 \c      mov eax,[eax+8,ecx*4]   ; eax=base, ecx=index, 4=scale, 8=disp
 134
 135 This is expected to be most useful for the MPX instructions.
 136
 137 \b Support \c{BND} prefix for branch instructions (for MPX).
 138
 139 \b The \c{DEFAULT} directive can now take \c{BND} and \c{NOBND}
 140 options to indicate whether all relevant branches should be getting
 141 \c{BND} prefixes.  This is expected to be the normal for use in MPX
 142 code.
 143
 144 \b Add \c{{evex}}, \c{{vex3}} and \c{{vex2}} instruction prefixes to
 145 have NASM encode the corresponding instruction, if possible, with an EVEX,
 146 3-byte VEX, or 2-byte VEX prefix, respectively.
 147
 148 \b Support for section names longer than 8 bytes in Win32/Win64 COFF.
 149
 150 \b The \c{NOSPLIT} directive by itself no longer forces a single
 151 register to become an index register, unless it has an explicit
 152 multiplier.
 153
 154 \c      mov eax,[nosplit eax]       ; eax as base register
 155 \c      mov eax,[nosplit eax*1]     ; eax as index register
 156
 157 \S{cl-2.10.09} Version 2.10.09
 158
 159 \b Pregenerate man pages.
 160
 161 \S{cl-2.10.08} Version 2.10.08
 162
 163 \b Fix \c{VMOVNTDQA}, \c{MOVNTDQA} and \c{MOVLPD} instructions.
 164
 165 \b Fix collision for \c{VGATHERQPS}, \c{VPGATHERQD} instructions.
 166
 167 \b Fix \c{VPMOVSXBQ}, \c{VGATHERQPD}, \c{VSPLLW} instructions.
 168
 169 \b Add a bunch of AMD TBM instructions.
 170
 171 \b Fix potential stack overwrite in numbers conversion.
 172
 173 \b Allow byte size in \c{PREFETCHTx} instructions.
 174
 175 \b Make manual pages up to date.
 176
 177 \b Make \c{F3} and \c{F2} SSE prefixes to override \c{66}.
 178
 179 \b Support of AMD SVM instructions in 32 bit mode.
 180
 181 \b Fix near offsets code generation for \c{JMP}, \c{CALL} instrictions
 182 in long mode.
 183
 184 \b Fix preprocessor parse regression when id is expanding to a whitespace.
 185
 186 \S{cl-2.10.07} Version 2.10.07
 187
 188 \b Fix line continuation parsing being broken in previous version.
 189
 190 \S{cl-2.10.06} Version 2.10.06
 191
 192 \b Always quote the dependency source names when using the automatic
 193 dependency generation options.
 194
 195 \b If no dependency target name is specified via the \c{-MT} or
 196 \c{-MQ} options, quote the default output name.
 197
 198 \b Fix assembly of shift operations in \c{CPU 8086} mode.
 199
 200 \b Fix incorrect generation of explicit immediate byte for shift by 1
 201 under certain circumstances.
 202
 203 \b Fix assembly of the \c{VPCMPGTQ} instruction.
 204
 205 \b Fix RIP-relative relocations in the \c{macho64} backend.
 206
 207 \S{cl-2.10.05} Version 2.10.05
 208
 209 \b Add the \c{CLAC} and \c{STAC} instructions.
 210
 211 \S{cl-2.10.04} Version 2.10.04
 212
 213 \b Add back the inadvertently deleted 256-bit version of the \c{VORPD}
 214 instruction.
 215
 216 \b Correct disassembly of instructions starting with byte \c{82} hex.
 217
 218 \b Fix corner cases in token pasting, for example:
 219
 220 \c    %define N 1e%++%+ 5
 221 \c            dd N, 1e+5
 222
 223 \S{cl-2.10.03} Version 2.10.03
 224
 225 \b Correct the assembly of the instruction:
 226
 227 \c XRELEASE MOV [absolute],AL
 228
 229 Previous versions would incorrectly generate \c{F3 A2} for this
 230 instruction and issue a warning; correct behavior is to emit \c{F3 88
 231 05}.
 232
 233 \S{cl-2.10.02} Version 2.10.02
 234
 235 \b Add the \c{ifunc} macro package with integer functions, currently
 236 only integer logarithms.  See \k{pkg_ifunc}.
 237
 238 \b Add the \c{RDSEED}, \c{ADCX} and \c{ADOX} instructions.
 239
 240 \S{cl-2.10.01} Version 2.10.01
 241
 242 \b Add missing VPMOVMSKB instruction with reg32, ymmreg operands.
 243
 244 \S{cl-2.10} Version 2.10
 245
 246 \b When optimization is enabled, \c{mov r64,imm} now optimizes to the
 247   shortest form possible between:
 248
 249 \c      mov r32,imm32                   ;  5 bytes
 250 \c      mov r64,imm32                   ;  7 bytes
 251 \c      mov r64,imm64                   ; 10 bytes
 252
 253 To force a specific form, use the \c{STRICT} keyword, see \k{strict}.
 254
 255 \b Add support for the Intel AVX2 instruction set.
 256
 257 \b Add support for Bit Manipulation Instructions 1 and 2.
 258
 259 \b Add support for Intel Transactional Synchronization Extensions (TSX).
 260
 261 \b Add support for x32 ELF (32-bit ELF with the CPU in 64-bit mode.)
 262    See \k{elffmt}.
 263
 264 \b Add support for bigendian UTF-16 and UTF-32.  See \k{unicode}.
 265
 266 \S{cl-2.09.10} Version 2.09.10
 267
 268 \b Fix up NSIS script to protect uninstaller against registry keys
 269    absence or corruption. It brings in a few additional questions
 270    to a user during deinstallation procedure but still it is better
 271    than unpredictable file removal.
 272
 273 \S{cl-2.09.09} Version 2.09.09
 274
 275 \b Fix initialization of section attributes of \c{bin} output format.
 276
 277 \b Fix \c{mach64} output format bug that crashes NASM due to NULL symbols.
 278
 279
 280 \S{cl-2.09.08} Version 2.09.08
 281
 282 \b Fix \c{__OUTPUT_FORMAT__} assignment when output driver alias
 283    is used. For example when \c{-f elf} is used \c{__OUTPUT_FORMAT__}
 284    must be set to \c{elf}, if \c{-f elf32} is used \c{__OUTPUT_FORMAT__}
 285    must be assigned accordingly, i.e. to \c{elf32}. The rule applies to
 286    all output driver aliases. See \k{ofmtm}.
 287
 288
 289 \S{cl-2.09.07} Version 2.09.07
 290
 291 \b Fix attempts to close same file several times
 292    when \c{-a} option is used.
 293
 294 \b Fixes for VEXTRACTF128, VMASKMOVPS encoding.
 295
 296
 297 \S{cl-2.09.06} Version 2.09.06
 298
 299 \b Fix missed section attribute initialization in \c{bin} output target.
 300
 301
 302 \S{cl-2.09.05} Version 2.09.05
 303
 304 \b Fix arguments encoding for VPEXTRW instruction.
 305
 306 \b Remove invalid form of VPEXTRW instruction.
 307
 308 \b Add \c{VLDDQU} as alias for \c{VLDQQU} to
 309    match specification.
 310
 311
 312 \S{cl-2.09.04} Version 2.09.04
 313
 314 \b Fix incorrect labels offset for VEX intructions.
 315
 316 \b Eliminate bogus warning on implicit operand size override.
 317
 318 \b \c{%if} term could not handle 64 bit numbers.
 319
 320 \b The COFF backend was limiting relocations number to 16 bits even if
 321    in real there were a way more relocations.
 322
 323
 324 \S{cl-2.09.03} Version 2.09.03
 325
 326 \b Print \c{%macro} name inside \c{%rep} blocks on error.
 327
 328 \b Fix preprocessor expansion behaviour. It happened sometime
 329    too early and sometime simply wrong. Move behaviour back to
 330    the origins (down to NASM 2.05.01).
 331
 332 \b Fix unitialized data dereference on OMF output format.
 333
 334 \b Issue warning on unterminated \c{%{} construct.
 335
 336 \b Fix for documentation typo.
 337
 338
 339 \S{cl-2.09.02} Version 2.09.02
 340
 341 \b Fix reversed tokens when \c{%deftok} produces more than one output token.
 342
 343 \b Fix segmentation fault on disassembling some VEX instructions.
 344
 345 \b Missing \c{%endif} did not always cause error.
 346
 347 \b Fix typo in documentation.
 348
 349 \b Compound context local preprocessor single line macro identifiers
 350   were not expanded early enough and as result lead to unresolved
 351   symbols.
 352
 353
 354 \S{cl-2.09.01} Version 2.09.01
 355
 356 \b Fix NULL dereference on missed %deftok second parameter.
 357
 358 \b Fix NULL dereference on invalid %substr parameters.
 359
 360
 361 \S{cl-2.09} Version 2.09
 362
 363 \b Fixed assignment the magnitude of \c{%rep} counter. It is limited
 364   to 62 bits now.
 365
 366 \b Fixed NULL dereference if argument of \c{%strlen} resolves
 367   to whitespace. For example if nonexistent macro parameter is used.
 368
 369 \b \c{%ifenv}, \c{%elifenv}, \c{%ifnenv}, and \c{%elifnenv} directives
 370   introduced.  See \k{ifenv}.
 371
 372 \b Fixed NULL dereference if environment variable is missed.
 373
 374 \b Updates of new AVX v7 Intel instructions.
 375
 376 \b \c{PUSH imm32} is now officially documented.
 377
 378 \b Fix for encoding the LFS, LGS and LSS in 64-bit mode.
 379
 380 \b Fixes for compatibility with OpenWatcom compiler and DOS 8.3 file
 381   format limitation.
 382
 383 \b Macros parameters range expansion introduced. See \k{mlmacrange}.
 384
 385 \b Backward compatibility on expanging of local sigle macros restored.
 386
 387 \b 8 bit relocations for \c{elf} and \c{bin} output formats are introduced.
 388
 389 \b Short intersegment jumps are permitted now.
 390
 391 \b An alignment more than 64 bytes are allowed for \c{win32},
 392   \c{win64} output formats.
 393
 394 \b \c{SECTALIGN} directive introduced. See \k{sectalign}.
 395
 396 \b \c{nojmp} option introduced in \c{smartalign} package. See
 397   \k{pkg_smartalign}.
 398
 399 \b Short aliases \c{win}, \c{elf} and \c{macho} for output formats are
 400   introduced.  Each stands for \c{win32}, \c{elf32} and \c{macho32}
 401   accordingly.
 402
 403 \b Faster handling of missing directives implemented.
 404
 405 \b Various small improvements in documentation.
 406
 407 \b No hang anymore if unable to open malloc.log file.
 408
 409 \b The environments without vsnprintf function are able to build nasm again.
 410
 411 \b AMD LWP instructions updated.
 412
 413 \b Tighten EA checks. We warn a user if there overflow in EA addressing.
 414
 415 \b Make \c{-Ox} the default optimization level.  For the legacy
 416   behavior, specify \c{-O0} explicitly.  See \k{opt-O}.
 417
 418 \b Environment variables read with \c{%!} or tested with \c{%ifenv}
 419   can now contain non-identifier characters if surrounded by quotes.
 420   See \k{getenv}.
 421
 422 \b Add a new standard macro package \c{%use fp} for floating-point
 423   convenience macros.  See \k{pkg_fp}.
 424
 425
 426 \S{cl-2.08.02} Version 2.08.02
 427
 428 \b Fix crash under certain circumstances when using the \c{%+} operator.
 429
 430
 431 \S{cl-2.08.01} Version 2.08.01
 432
 433 \b Fix the \c{%use} statement, which was broken in 2.08.
 434
 435
 436 \S{cl-2.08} Version 2.08
 437
 438 \b A number of enhancements/fixes in macros area.
 439
 440 \b Support for converting strings to tokens.  See \k{deftok}.
 441
 442 \b Fuzzy operand size logic introduced.
 443
 444 \b Fix COFF stack overrun on too long export identifiers.
 445
 446 \b Fix Macho-O alignment bug.
 447
 448 \b Fix crashes with -fwin32 on file with many exports.
 449
 450 \b Fix stack overrun for too long [DEBUG id].
 451
 452 \b Fix incorrect sbyte usage in IMUL (hit only if optimization
 453   flag passed).
 454
 455 \b Append ending token for \c{.stabs} records in the ELF output format.
 456
 457 \b New NSIS script which uses ModernUI and MultiUser approach.
 458
 459 \b Visual Studio 2008 NASM integration (rules file).
 460
 461 \b Warn a user if a constant is too long (and as result will be stripped).
 462
 463 \b The obsoleted pre-XOP AMD SSE5 instruction set which was never actualized
 464   was removed.
 465
 466 \b Fix stack overrun on too long error file name passed from the command line.
 467
 468 \b Bind symbols to the .text section by default (ie in case if SECTION
 469   directive was omitted) in the ELF output format.
 470
 471 \b Fix sync points array index wrapping.
 472
 473 \b A few fixes for FMA4 and XOP instruction templates.
 474
 475 \b Add AMD Lightweight Profiling (LWP) instructions.
 476
 477 \b Fix the offset for \c{%arg} in 64-bit mode.
 478
 479 \b An undefined local macro (\c{%$}) no longer matches a global macro
 480   with the same name.
 481
 482 \b Fix NULL dereference on too long local labels.
 483
 484
 485 \S{cl-2.07} Version 2.07
 486
 487 \b NASM is now under the 2-clause BSD license.  See \k{legal}.
 488
 489 \b Fix the section type for the \c{.strtab} section in the \c{elf64}
 490   output format.
 491
 492 \b Fix the handling of \c{COMMON} directives in the \c{obj} output format.
 493
 494 \b New \c{ith} and \c{srec} output formats; these are variants of the
 495   \c{bin} output format which output Intel hex and Motorola S-records,
 496   respectively.  See \k{ithfmt} and \k{srecfmt}.
 497
 498 \b \c{rdf2ihx} replaced with an enhanced \c{rdf2bin}, which can output
 499   binary, COM, Intel hex or Motorola S-records.
 500
 501 \b The Windows installer now puts the NASM directory first in the
 502   \c{PATH} of the "NASM Shell".
 503
 504 \b Revert the early expansion behavior of \c{%+} to pre-2.06 behavior:
 505   \c{%+} is only expanded late.
 506
 507 \b Yet another Mach-O alignment fix.
 508
 509 \b Don't delete the list file on errors.  Also, include error and
 510   warning information in the list file.
 511
 512 \b Support for 64-bit Mach-O output, see \k{machofmt}.
 513
 514 \b Fix assert failure on certain operations that involve strings with
 515   high-bit bytes.
 516
 517
 518 \S{cl-2.06} Version 2.06
 519
 520 \b This release is dedicated to the memory of Charles A. Crayne, long
 521   time NASM developer as well as moderator of \c{comp.lang.asm.x86} and
 522   author of the book \e{Serious Assembler}.  We miss you, Chuck.
 523
 524 \b Support for indirect macro expansion (\c{%[...]}).  See \k{indmacro}.
 525
 526 \b \c{%pop} can now take an argument, see \k{pushpop}.
 527
 528 \b The argument to \c{%use} is no longer macro-expanded.  Use
 529   \c{%[...]} if macro expansion is desired.
 530
 531 \b Support for thread-local storage in ELF32 and ELF64.  See \k{elftls}.
 532
 533 \b Fix crash on \c{%ifmacro} without an argument.
 534
 535 \b Correct the arguments to the \c{POPCNT} instruction.
 536
 537 \b Fix section alignment in the Mach-O format.
 538
 539 \b Update AVX support to version 5 of the Intel specification.
 540
 541 \b Fix the handling of accesses to context-local macros from higher
 542   levels in the context stack.
 543
 544 \b Treat \c{WAIT} as a prefix rather than as an instruction, thereby
 545   allowing constructs like \c{O16 FSAVE} to work correctly.
 546
 547 \b Support for structures with a non-zero base offset. See \k{struc}.
 548
 549 \b Correctly handle preprocessor token concatenation (see \k{concat})
 550    involving floating-point numbers.
 551
 552 \b The \c{PINSR} series of instructions have been corrected and
 553    rationalized.
 554
 555 \b Removed AMD SSE5, replaced with the new XOP/FMA4/CVT16 (rev 3.03)
 556    spec.
 557
 558 \b The ELF backends no longer automatically generate a \c{.comment} section.
 559
 560 \b Add additional "well-known" ELF sections with default attributes.  See
 561    \k{elfsect}.
 562
 563
 564 \S{cl-2.05.01} Version 2.05.01
 565
 566 \b Fix the \c{-w}/\c{-W} option parsing, which was broken in NASM 2.05.
 567
 568
 569 \S{cl-2.05} Version 2.05
 570
 571 \b Fix redundant REX.W prefix on \c{JMP reg64}.
 572
 573 \b Make the behaviour of \c{-O0} match NASM 0.98 legacy behavior.
 574   See \k{opt-O}.
 575
 576 \b \c{-w-user} can be used to suppress the output of \c{%warning} directives.
 577   See \k{opt-w}.
 578
 579 \b Fix bug where \c{ALIGN} would issue a full alignment datum instead of
 580   zero bytes.
 581
 582 \b Fix offsets in list files.
 583
 584 \b Fix \c{%include} inside multi-line macros or loops.
 585
 586 \b Fix error where NASM would generate a spurious warning on valid
 587   optimizations of immediate values.
 588
 589 \b Fix arguments to a number of the \c{CVT} SSE instructions.
 590
 591 \b Fix RIP-relative offsets when the instruction carries an immediate.
 592
 593 \b Massive overhaul of the ELF64 backend for spec compliance.
 594
 595 \b Fix the Geode \c{PFRCPV} and \c{PFRSQRTV} instruction.
 596
 597 \b Fix the SSE 4.2 \c{CRC32} instruction.
 598
 599
 600 \S{cl-2.04} Version 2.04
 601
 602 \b Sanitize macro handing in the \c{%error} directive.
 603
 604 \b New \c{%warning} directive to issue user-controlled warnings.
 605
 606 \b \c{%error} directives are now deferred to the final assembly phase.
 607
 608 \b New \c{%fatal} directive to immediately terminate assembly.
 609
 610 \b New \c{%strcat} directive to join quoted strings together.
 611
 612 \b New \c{%use} macro directive to support standard macro directives.  See
 613   \k{use}.
 614
 615 \b Excess default parameters to \c{%macro} now issues a warning by default.
 616   See \k{mlmacro}.
 617
 618 \b Fix \c{%ifn} and \c{%elifn}.
 619
 620 \b Fix nested \c{%else} clauses.
 621
 622 \b Correct the handling of nested \c{%rep}s.
 623
 624 \b New \c{%unmacro} directive to undeclare a multi-line macro.
 625   See \k{unmacro}.
 626
 627 \b Builtin macro \c{__PASS__} which expands to the current assembly pass.
 628   See \k{pass_macro}.
 629
 630 \b \c{__utf16__} and \c{__utf32__} operators to generate UTF-16 and UTF-32
 631   strings.  See \k{unicode}.
 632
 633 \b Fix bug in case-insensitive matching when compiled on platforms that
 634   don't use the \c{configure} script.  Of the official release binaries,
 635   that only affected the OS/2 binary.
 636
 637 \b Support for x87 packed BCD constants.  See \k{bcdconst}.
 638
 639 \b Correct the \c{LTR} and \c{SLDT} instructions in 64-bit mode.
 640
 641 \b Fix unnecessary REX.W prefix on indirect jumps in 64-bit mode.
 642
 643 \b Add AVX versions of the AES instructions (\c{VAES}...).
 644
 645 \b Fix the 256-bit FMA instructions.
 646
 647 \b Add 256-bit AVX stores per the latest AVX spec.
 648
 649 \b VIA XCRYPT instructions can now be written either with or without
 650   \c{REP}, apparently different versions of the VIA spec wrote them
 651   differently.
 652
 653 \b Add missing 64-bit \c{MOVNTI} instruction.
 654
 655 \b Fix the operand size of \c{VMREAD} and \c{VMWRITE}.
 656
 657 \b Numerous bug fixes, especially to the AES, AVX and VTX instructions.
 658
 659 \b The optimizer now always runs until it converges.  It also runs even
 660   when disabled, but doesn't optimize.  This allows most forward references
 661   to be resolved properly.
 662
 663 \b \c{%push} no longer needs a context identifier; omitting the context
 664   identifier results in an anonymous context.
 665
 666
 667 \S{cl-2.03.01} Version 2.03.01
 668
 669 \b Fix buffer overflow in the listing module.
 670
 671 \b Fix the handling of hexadecimal escape codes in `...` strings.
 672
 673 \b The Postscript/PDF documentation has been reformatted.
 674
 675 \b The \c{-F} option now implies \c{-g}.
 676
 677
 678 \S{cl-2.03} Version 2.03
 679
 680 \b Add support for Intel AVX, CLMUL and FMA instructions,
 681 including YMM registers.
 682
 683 \b \c{dy}, \c{resy} and \c{yword} for 32-byte operands.
 684
 685 \b Fix some SSE5 instructions.
 686
 687 \b Intel \c{INVEPT}, \c{INVVPID} and \c{MOVBE} instructions.
 688
 689 \b Fix checking for critical expressions when the optimizer is enabled.
 690
 691 \b Support the DWARF debugging format for ELF targets.
 692
 693 \b Fix optimizations of signed bytes.
 694
 695 \b Fix operation on bigendian machines.
 696
 697 \b Fix buffer overflow in the preprocessor.
 698
 699 \b \c{SAFESEH} support for Win32, \c{IMAGEREL} for Win64 (SEH).
 700
 701 \b \c{%?} and \c{%??} to refer to the name of a macro itself.  In particular,
 702 \c{%idefine keyword $%?} can be used to make a keyword "disappear".
 703
 704 \b New options for dependency generation: \c{-MD}, \c{-MF},
 705 \c{-MP}, \c{-MT}, \c{-MQ}.
 706
 707 \b New preprocessor directives \c{%pathsearch} and \c{%depend}; INCBIN
 708 reimplemented as a macro.
 709
 710 \b \c{%include} now resolves macros in a sane manner.
 711
 712 \b \c{%substr} can now be used to get other than one-character substrings.
 713
 714 \b New type of character/string constants, using backquotes (\c{`...`}),
 715 which support C-style escape sequences.
 716
 717 \b \c{%defstr} and \c{%idefstr} to stringize macro definitions before
 718 creation.
 719
 720 \b Fix forward references used in \c{EQU} statements.
 721
 722
 723 \S{cl-2.02} Version 2.02
 724
 725 \b Additional fixes for MMX operands with explicit \c{qword}, as well as
 726   (hopefully) SSE operands with \c{oword}.
 727
 728 \b Fix handling of truncated strings with \c{DO}.
 729
 730 \b Fix segfaults due to memory overwrites when floating-point constants
 731   were used.
 732
 733 \b Fix segfaults due to missing include files.
 734
 735 \b Fix OpenWatcom Makefiles for DOS and OS/2.
 736
 737 \b Add autogenerated instruction list back into the documentation.
 738
 739 \b ELF: Fix segfault when generating stabs, and no symbols have been
 740   defined.
 741
 742 \b ELF: Experimental support for DWARF debugging information.
 743
 744 \b New compile date and time standard macros.
 745
 746 \b \c{%ifnum} now returns true for negative numbers.
 747
 748 \b New \c{%iftoken} test for a single token.
 749
 750 \b New \c{%ifempty} test for empty expansion.
 751
 752 \b Add support for the \c{XSAVE} instruction group.
 753
 754 \b Makefile for Netware/gcc.
 755
 756 \b Fix issue with some warnings getting emitted way too many times.
 757
 758 \b Autogenerated instruction list added to the documentation.
 759
 760
 761 \S{cl-2.01} Version 2.01
 762
 763 \b Fix the handling of MMX registers with explicit \c{qword} tags on
 764   memory (broken in 2.00 due to 64-bit changes.)
 765
 766 \b Fix the PREFETCH instructions.
 767
 768 \b Fix the documentation.
 769
 770 \b Fix debugging info when using \c{-f elf}
 771 (backwards compatibility alias for \c{-f elf32}).
 772
 773 \b Man pages for rdoff tools (from the Debian project.)
 774
 775 \b ELF: handle large numbers of sections.
 776
 777 \b Fix corrupt output when the optimizer runs out of passes.
 778
 779
 780 \S{cl-2.00} Version 2.00
 781
 782 \b Added c99 data-type compliance.
 783
 784 \b Added general x86-64 support.
 785
 786 \b Added win64 (x86-64 COFF) output format.
 787
 788 \b Added \c{__BITS__} standard macro.
 789
 790 \b Renamed the \c{elf} output format to \c{elf32} for clarity.
 791
 792 \b Added \c{elf64} and \c{macho} (MacOS X) output formats.
 793
 794 \b Added Numeric constants in \c{dq} directive.
 795
 796 \b Added \c{oword}, \c{do} and \c{reso} pseudo operands.
 797
 798 \b Allow underscores in numbers.
 799
 800 \b Added 8-, 16- and 128-bit floating-point formats.
 801
 802 \b Added binary, octal and hexadecimal floating-point.
 803
 804 \b Correct the generation of floating-point constants.
 805
 806 \b Added floating-point option control.
 807
 808 \b Added Infinity and NaN floating point support.
 809
 810 \b Added ELF Symbol Visibility support.
 811
 812 \b Added setting OSABI value in ELF header directive.
 813
 814 \b Added Generate Makefile Dependencies option.
 815
 816 \b Added Unlimited Optimization Passes option.
 817
 818 \b Added \c{%IFN} and \c{%ELIFN} support.
 819
 820 \b Added Logical Negation Operator.
 821
 822 \b Enhanced Stack Relative Preprocessor Directives.
 823
 824 \b Enhanced ELF Debug Formats.
 825
 826 \b Enhanced Send Errors to a File option.
 827
 828 \b Added SSSE3, SSE4.1, SSE4.2, SSE5 support.
 829
 830 \b Added a large number of additional instructions.
 831
 832 \b Significant performance improvements.
 833
 834 \b \c{-w+warning} and \c{-w-warning} can now be written as -Wwarning and
 835  -Wno-warning, respectively.  See \k{opt-w}.
 836
 837 \b Add \c{-w+error} to treat warnings as errors.  See \k{opt-w}.
 838
 839 \b Add \c{-w+all} and \c{-w-all} to enable or disable all suppressible
 840  warnings.  See \k{opt-w}.
 841
 842
 843 \H{cl-0.98.xx} NASM 0.98 Series
 844
 845 The 0.98 series was the production versions of NASM from 1999 to 2007.
 846
 847
 848 \S{cl-0.98.39} Version 0.98.39
 849
 850 \b fix buffer overflow
 851
 852 \b fix outas86's \c{.bss} handling
 853
 854 \b "make spotless" no longer deletes config.h.in.
 855
 856 \b \c{%(el)if(n)idn} insensitivity to string quotes difference (#809300).
 857
 858 \b (nasm.c)\c{__OUTPUT_FORMAT__} changed to string value instead of symbol.
 859
 860 \S{cl-0.98.38} Version 0.98.38
 861
 862
 863 \b Add Makefile for 16-bit DOS binaries under OpenWatcom, and modify
 864   \c{mkdep.pl} to be able to generate completely pathless dependencies, as
 865   required by OpenWatcom wmake (it supports path searches, but not
 866   explicit paths.)
 867
 868 \b Fix the \c{STR} instruction.
 869
 870 \b Fix the ELF output format, which was broken under certain
 871   circumstances due to the addition of stabs support.
 872
 873 \b Quick-fix Borland format debug-info for \c{-f obj}
 874
 875 \b Fix for \c{%rep} with no arguments (#560568)
 876
 877 \b Fix concatenation of preprocessor function call (#794686)
 878
 879 \b Fix long label causes coredump (#677841)
 880
 881 \b Use autoheader as well as autoconf to keep configure from generating
 882   ridiculously long command lines.
 883
 884 \b Make sure that all of the formats which support debugging output
 885   actually will suppress debugging output when \c{-g} not specified.
 886
 887 \S{cl-0.98.37} Version 0.98.37
 888
 889
 890 \b Paths given in \c{-I} switch searched for \c{incbin}-ed as
 891   well as \c{%include}-ed files.
 892
 893 \b Added stabs debugging for the ELF output format, patch from
 894   Martin Wawro.
 895
 896 \b Fix \c{output/outbin.c} to allow origin > 80000000h.
 897
 898 \b Make \c{-U} switch work.
 899
 900 \b Fix the use of relative offsets with explicit prefixes, e.g.
 901 \c{a32 loop foo}.
 902
 903 \b Remove \c{backslash()}.
 904
 905 \b Fix the \c{SMSW} and \c{SLDT} instructions.
 906
 907 \b \c{-O2} and \c{-O3} are no longer aliases for \c{-O10} and \c{-O15}.
 908 If you mean the latter, please say so! :)
 909
 910 \S{cl-0.98.36} Version 0.98.36
 911
 912
 913 \b Update rdoff - librarian/archiver - common rec - docs!
 914
 915 \b Fix signed/unsigned problems.
 916
 917 \b Fix \c{JMP FAR label} and \c{CALL FAR label}.
 918
 919 \b Add new multisection support - map files - fix align bug
 920
 921 \b Fix sysexit, movhps/movlps reg,reg bugs in insns.dat
 922
 923 \b \c{Q} or \c{O} suffixes indicate octal
 924
 925 \b Support Prescott new instructions (PNI).
 926
 927 \b Cyrix \c{XSTORE} instruction.
 928
 929
 930 \S{cl-0.98.35} Version 0.98.35
 931
 932 \b Fix build failure on 16-bit DOS (Makefile.bc3 workaround for compiler bug.)
 933
 934 \b Fix dependencies and compiler warnings.
 935
 936 \b Add "const" in a number of places.
 937
 938 \b Add -X option to specify error reporting format (use -Xvc to
 939   integrate with Microsoft Visual Studio.)
 940
 941 \b Minor changes for code legibility.
 942
 943 \b Drop use of tmpnam() in rdoff (security fix.)
 944
 945
 946 \S{cl-0.98.34} Version 0.98.34
 947
 948 \b Correct additional address-size vs. operand-size confusions.
 949
 950 \b Generate dependencies for all Makefiles automatically.
 951
 952 \b Add support for unimplemented (but theoretically available)
 953   registers such as tr0 and cr5.  Segment registers 6 and 7 are called
 954   segr6 and segr7 for the operations which they can be represented.
 955
 956 \b Correct some disassembler bugs related to redundant address-size prefixes.
 957   Some work still remains in this area.
 958
 959 \b Correctly generate an error for things like "SEG eax".
 960
 961 \b Add the JMPE instruction, enabled by "CPU IA64".
 962
 963 \b Correct compilation on newer gcc/glibc platforms.
 964
 965 \b Issue an error on things like "jmp far eax".
 966
 967
 968 \S{cl-0.98.33} Version 0.98.33
 969
 970 \b New __NASM_PATCHLEVEL__ and __NASM_VERSION_ID__ standard macros to
 971   round out the version-query macros.  version.pl now understands
 972   X.YYplWW or X.YY.ZZplWW as a version number, equivalent to
 973   X.YY.ZZ.WW (or X.YY.0.WW, as appropriate).
 974
 975 \b New keyword "strict" to disable the optimization of specific
 976   operands.
 977
 978 \b Fix the handing of size overrides with JMP instructions
 979   (instructions such as "jmp dword foo".)
 980
 981 \b Fix the handling of "ABSOLUTE label", where "label" points into a
 982   relocatable segment.
 983
 984 \b Fix OBJ output format with lots of externs.
 985
 986 \b More documentation updates.
 987
 988 \b Add -Ov option to get verbose information about optimizations.
 989
 990 \b Undo a braindead change which broke \c{%elif} directives.
 991
 992 \b Makefile updates.
 993
 994
 995 \S{cl-0.98.32} Version 0.98.32
 996
 997 \b Fix NASM crashing when \c{%macro} directives were left unterminated.
 998
 999 \b Lots of documentation updates.
1000
1001 \b Complete rewrite of the PostScript/PDF documentation generator.
1002
1003 \b The MS Visual C++ Makefile was updated and corrected.
1004
1005 \b Recognize .rodata as a standard section name in ELF.
1006
1007 \b Fix some obsolete Perl4-isms in Perl scripts.
1008
1009 \b Fix configure.in to work with autoconf 2.5x.
1010
1011 \b Fix a couple of "make cleaner" misses.
1012
1013 \b Make the normal "./configure && make" work with Cygwin.
1014
1015
1016 \S{cl-0.98.31} Version 0.98.31
1017
1018 \b Correctly build in a separate object directory again.
1019
1020 \b Derive all references to the version number from the version file.
1021
1022 \b New standard macros __NASM_SUBMINOR__ and __NASM_VER__ macros.
1023
1024 \b Lots of Makefile updates and bug fixes.
1025
1026 \b New \c{%ifmacro} directive to test for multiline macros.
1027
1028 \b Documentation updates.
1029
1030 \b Fixes for 16-bit OBJ format output.
1031
1032 \b Changed the NASM environment variable to NASMENV.
1033
1034
1035 \S{cl-0.98.30} Version 0.98.30
1036
1037 \b Changed doc files a lot: completely removed old READMExx and
1038   Wishlist files, incorporating all information in CHANGES and TODO.
1039
1040 \b I waited a long time to rename zoutieee.c to (original) outieee.c
1041
1042 \b moved all output modules to output/ subdirectory.
1043
1044 \b Added 'make strip' target to strip debug info from nasm & ndisasm.
1045
1046 \b Added INSTALL file with installation instructions.
1047
1048 \b Added -v option description to nasm man.
1049
1050 \b Added dist makefile target to produce source distributions.
1051
1052 \b 16-bit support for ELF output format (GNU extension, but useful.)
1053
1054
1055 \S{cl-0.98.28} Version 0.98.28
1056
1057 \b Fastcooked this for Debian's Woody release:
1058 Frank applied the INCBIN bug patch to 0.98.25alt and called
1059 it 0.98.28 to not confuse poor little apt-get.
1060
1061
1062 \S{cl-0.98.26} Version 0.98.26
1063
1064 \b Reorganised files even better from 0.98.25alt
1065
1066
1067 \S{cl-0.98.25alt} Version 0.98.25alt
1068
1069 \b Prettified the source tree. Moved files to more reasonable places.
1070
1071 \b Added findleak.pl script to misc/ directory.
1072
1073 \b Attempted to fix doc.
1074
1075
1076 \S{cl-0.98.25} Version 0.98.25
1077
1078 \b Line continuation character \c{\\}.
1079
1080 \b Docs inadvertantly reverted - "dos packaging".
1081
1082
1083 \S{cl-0.98.24p1} Version 0.98.24p1
1084
1085 \b FIXME: Someone, document this please.
1086
1087
1088 \S{cl-0.98.24} Version 0.98.24
1089
1090 \b Documentation - Ndisasm doc added to Nasm.doc.
1091
1092
1093 \S{cl-0.98.23} Version 0.98.23
1094
1095 \b Attempted to remove rdoff version1
1096
1097 \b Lino Mastrodomenico's patches to preproc.c (%$$ bug?).
1098
1099
1100 \S{cl-0.98.22} Version 0.98.22
1101
1102 \b Update rdoff2 - attempt to remove v1.
1103
1104
1105 \S{cl-0.98.21} Version 0.98.21
1106
1107 \b Optimization fixes.
1108
1109
1110 \S{cl-0.98.20} Version 0.98.20
1111
1112 \b Optimization fixes.
1113
1114
1115 \S{cl-0.98.19} Version 0.98.19
1116
1117 \b H. J. Lu's patch back out.
1118
1119
1120 \S{cl-0.98.18} Version 0.98.18
1121
1122 \b Added ".rdata" to "-f win32".
1123
1124
1125 \S{cl-0.98.17} Version 0.98.17
1126
1127 \b H. J. Lu's "bogus elf" patch. (Red Hat problem?)
1128
1129
1130 \S{cl-0.98.16} Version 0.98.16
1131
1132 \b Fix whitespace before "[section ..." bug.
1133
1134
1135 \S{cl-0.98.15} Version 0.98.15
1136
1137 \b Rdoff changes (?).
1138
1139 \b Fix fixes to memory leaks.
1140
1141
1142 \S{cl-0.98.14} Version 0.98.14
1143
1144 \b Fix memory leaks.
1145
1146
1147 \S{cl-0.98.13} Version 0.98.13
1148
1149 \b There was no 0.98.13
1150
1151
1152 \S{cl-0.98.12} Version 0.98.12
1153
1154 \b Update optimization (new function of "-O1")
1155
1156 \b Changes to test/bintest.asm (?).
1157
1158
1159 \S{cl-0.98.11} Version 0.98.11
1160
1161 \b Optimization changes.
1162
1163 \b Ndisasm fixed.
1164
1165
1166 \S{cl-0.98.10} Version 0.98.10
1167
1168 \b There was no 0.98.10
1169
1170
1171 \S{cl-0.98.09} Version 0.98.09
1172
1173 \b Add multiple sections support to "-f bin".
1174
1175 \b Changed GLOBAL_TEMP_BASE in outelf.c from 6 to 15.
1176
1177 \b Add "-v" as an alias to the "-r" switch.
1178
1179 \b Remove "#ifdef" from Tasm compatibility options.
1180
1181 \b Remove redundant size-overrides on "mov ds, ex", etc.
1182
1183 \b Fixes to SSE2, other insns.dat (?).
1184
1185 \b Enable uppercase "I" and "P" switches.
1186
1187 \b Case insinsitive "seg" and "wrt".
1188
1189 \b Update install.sh (?).
1190
1191 \b Allocate tokens in blocks.
1192
1193 \b Improve "invalid effective address" messages.
1194
1195
1196 \S{cl-0.98.08} Version 0.98.08
1197
1198 \b Add "\c{%strlen}" and "\c{%substr}" macro operators
1199
1200 \b Fixed broken c16.mac.
1201
1202 \b Unterminated string error reported.
1203
1204 \b Fixed bugs as per 0.98bf
1205
1206
1207 \S{cl-0.98.09b with John Coffman patches released 28-Oct-2001} Version 0.98.09b with John Coffman patches released 28-Oct-2001
1208
1209 Changes from 0.98.07 release to 98.09b as of 28-Oct-2001
1210
1211 \b More closely compatible with 0.98 when -O0 is implied
1212 or specified.  Not strictly identical, since backward
1213 branches in range of short offsets are recognized, and signed
1214 byte values with no explicit size specification will be
1215 assembled as a single byte.
1216
1217 \b More forgiving with the PUSH instruction.  0.98 requires
1218 a size to be specified always.  0.98.09b will imply the size
1219 from the current BITS setting (16 or 32).
1220
1221 \b Changed definition of the optimization flag:
1222
1223         -O0     strict two-pass assembly, JMP and Jcc are
1224                 handled more like 0.98, except that back-
1225                 ward JMPs are short, if possible.
1226
1227         -O1     strict two-pass assembly, but forward
1228                 branches are assembled with code guaranteed
1229                 to reach; may produce larger code than
1230                 -O0, but will produce successful assembly
1231                 more often if branch offset sizes are not
1232                 specified.
1233
1234         -O2     multi-pass optimization, minimize branch
1235                 offsets; also will minimize signed immed-
1236                 iate bytes, overriding size specification.
1237
1238         -O3     like -O2, but more passes taken, if needed
1239
1240
1241 \S{cl-0.98.07 released 01/28/01} Version 0.98.07 released 01/28/01
1242
1243 \b       Added Stepane Denis' SSE2 instructions to a *working*
1244         version of the code - some earlier versions were based on
1245         broken code - sorry 'bout that. version "0.98.07"
1246
1247
1248 01/28/01
1249
1250
1251 \b       Cosmetic modifications to nasm.c, nasm.h,
1252         AUTHORS, MODIFIED
1253
1254
1255 \S{cl-0.98.06f released 01/18/01} Version 0.98.06f released 01/18/01
1256
1257
1258 \b       - Add "metalbrain"s jecxz bug fix in insns.dat
1259         - alter nasmdoc.src to match - version "0.98.06f"
1260
1261
1262 \S{cl-0.98.06e released 01/09/01} Version 0.98.06e released 01/09/01
1263
1264
1265 \b       Removed the "outforms.h" file - it appears to be
1266         someone's old backup of "outform.h". version "0.98.06e"
1267
1268 01/09/01
1269
1270 \b fbk - finally added the fix for the "multiple %includes bug",
1271         known since 7/27/99 - reported originally (?) and sent to
1272         us by Austin Lunnen - he reports that John Fine had a fix
1273         within the day. Here it is...
1274
1275 \b Nelson Rush resigns from the group. Big thanks to Nelson for
1276   his leadership and enthusiasm in getting these changes
1277   incorporated into Nasm!
1278
1279 \b fbk - [list +], [list -] directives - ineptly implemented, should
1280         be re-written or removed, perhaps.
1281
1282 \b Brian Raiter / fbk - "elfso bug" fix - applied to aoutb format
1283                        as well - testing might be desirable...
1284
1285 08/07/00
1286
1287 \b James Seter - -postfix, -prefix command line switches.
1288
1289 \b Yuri Zaporozhets - rdoff utility changes.
1290
1291
1292 \S{cl-0.98p1} Version 0.98p1
1293
1294 \b GAS-like palign (Panos Minos)
1295
1296 \b FIXME: Someone, fill this in with details
1297
1298
1299 \S{cl-0.98bf (bug-fixed)} Version 0.98bf (bug-fixed)
1300
1301 \b Fixed - elf and aoutb bug - shared libraries
1302         - multiple "%include" bug in "-f obj"
1303         - jcxz, jecxz bug
1304         - unrecognized option bug in ndisasm
1305
1306 \S{cl-0.98.03 with John Coffman's changes released 27-Jul-2000} Version 0.98.03 with John Coffman's changes released 27-Jul-2000
1307
1308 \b Added signed byte optimizations for the 0x81/0x83 class
1309 of instructions: ADC, ADD, AND, CMP, OR, SBB, SUB, XOR:
1310 when used as 'ADD reg16,imm' or 'ADD reg32,imm.'  Also
1311 optimization of signed byte form of 'PUSH imm' and 'IMUL
1312 reg,imm'/'IMUL reg,reg,imm.'  No size specification is needed.
1313
1314 \b Added multi-pass JMP and Jcc offset optimization.  Offsets
1315 on forward references will preferentially use the short form,
1316 without the need to code a specific size (short or near) for
1317 the branch.  Added instructions for 'Jcc label' to use the
1318 form 'Jnotcc $+3/JMP label', in cases where a short offset
1319 is out of bounds.  If compiling for a 386 or higher CPU, then
1320 the 386 form of Jcc will be used instead.
1321
1322 This feature is controlled by a new command-line switch: "O",
1323 (upper case letter O).  "-O0" reverts the assembler to no
1324 extra optimization passes, "-O1" allows up to 5 extra passes,
1325 and "-O2"(default), allows up to 10 extra optimization passes.
1326
1327 \b Added a new directive:  'cpu XXX', where XXX is any of:
1328 8086, 186, 286, 386, 486, 586, pentium, 686, PPro, P2, P3 or
1329 Katmai.  All are case insensitive.  All instructions will
1330 be selected only if they apply to the selected cpu or lower.
1331 Corrected a couple of bugs in cpu-dependence in 'insns.dat'.
1332
1333 \b Added to 'standard.mac', the "use16" and "use32" forms of
1334 the "bits 16/32" directive. This is nothing new, just conforms
1335 to a lot of other assemblers. (minor)
1336
1337 \b Changed label allocation from 320/32 (10000 labels @ 200K+)
1338 to 32/37 (1000 labels); makes running under DOS much easier.
1339 Since additional label space is allocated dynamically, this
1340 should have no effect on large programs with lots of labels.
1341 The 37 is a prime, believed to be better for hashing. (minor)
1342
1343
1344 \S{cl-0.98.03} Version 0.98.03
1345
1346 "Integrated patchfile 0.98-0.98.01.  I call this version 0.98.03 for
1347 historical reasons: 0.98.02 was trashed." --John Coffman
1348 <johninsd@san.rr.com>, 27-Jul-2000
1349
1350 \b Kendall Bennett's SciTech MGL changes
1351
1352 \b Note that you must define "TASM_COMPAT" at compile-time
1353 to get the Tasm Ideal Mode compatibility.
1354
1355 \b All changes can be compiled in and out using the TASM_COMPAT macros,
1356 and when compiled without TASM_COMPAT defined we get the exact same
1357 binary as the unmodified 0.98 sources.
1358
1359 \b standard.mac, macros.c: Added macros to ignore TASM directives before
1360 first include
1361
1362 \b nasm.h: Added extern declaration for tasm_compatible_mode
1363
1364 \b nasm.c: Added global variable tasm_compatible_mode
1365
1366 \b Added command line switch for TASM compatible mode (-t)
1367
1368 \b Changed version command line to reflect when compiled with TASM additions
1369
1370 \b Added response file processing to allow all arguments on a single
1371 line (response file is @resp rather than -@resp for NASM format).
1372
1373 \b labels.c: Changes islocal() macro to support TASM style @@local labels.
1374
1375 \b Added islocalchar() macro to support TASM style @@local labels.
1376
1377 \b parser.c: Added support for TASM style memory references (ie: mov
1378 [DWORD eax],10 rather than the NASM style mov DWORD [eax],10).
1379
1380 \b preproc.c: Added new directives, \c{%arg}, \c{%local}, \c{%stacksize} to directives
1381 table
1382
1383 \b Added support for TASM style directives without a leading % symbol.
1384
1385 \b Integrated a block of changes from Andrew Zabolotny <bit@eltech.ru>:
1386
1387 \b A new keyword \c{%xdefine} and its case-insensitive counterpart \c{%ixdefine}.
1388 They work almost the same way as \c{%define} and \c{%idefine} but expand
1389 the definition immediately, not on the invocation. Something like a cross
1390 between \c{%define} and \c{%assign}. The "x" suffix stands for "eXpand", so
1391 "xdefine" can be deciphered as "expand-and-define". Thus you can do
1392 things like this:
1393
1394 \c      %assign ofs     0
1395 \c
1396 \c      %macro  arg     1
1397 \c              %xdefine %1 dword [esp+ofs]
1398 \c              %assign ofs ofs+4
1399 \c      %endmacro
1400
1401 \b Changed the place where the expansion of %$name macros are expanded.
1402 Now they are converted into ..@ctxnum.name form when detokenizing, so
1403 there are no quirks as before when using %$name arguments to macros,
1404 in macros etc. For example:
1405
1406 \c      %macro  abc     1
1407 \c              %define %1 hello
1408 \c      %endm
1409 \c
1410 \c      abc     %$here
1411 \c      %$here
1412
1413     Now last line will be expanded into "hello" as expected. This also allows
1414     for lots of goodies, a good example are extended "proc" macros included
1415     in this archive.
1416
1417 \b Added a check for "cstk" in smacro_defined() before calling get_ctx() -
1418     this allows for things like:
1419
1420 \c      %ifdef %$abc
1421 \c      %endif
1422
1423     to work without warnings even in no context.
1424
1425 \b Added a check for "cstk" in %if*ctx and %elif*ctx directives -
1426     this allows to use \c{%ifctx} without excessive warnings. If there is
1427     no active context, \c{%ifctx} goes through "false" branch.
1428
1429 \b Removed "user error: " prefix with \c{%error} directive: it just clobbers the
1430     output and has absolutely no functionality. Besides, this allows to write
1431     macros that does not differ from built-in functions in any way.
1432
1433 \b Added expansion of string that is output by \c{%error} directive. Now you
1434     can do things like:
1435
1436 \c      %define hello(x) Hello, x!
1437 \c
1438 \c      %define %$name andy
1439 \c      %error "hello(%$name)"
1440
1441     Same happened with \c{%include} directive.
1442
1443 \b Now all directives that expect an identifier will try to expand and
1444     concatenate everything without whitespaces in between before usage.
1445     For example, with "unfixed" nasm the commands
1446
1447 \c      %define %$abc hello
1448 \c      %define __%$abc goodbye
1449 \c      __%$abc
1450
1451     would produce "incorrect" output: last line will expand to
1452
1453 \c      hello goodbyehello
1454
1455     Not quite what you expected, eh? :-) The answer is that preprocessor
1456     treats the \c{%define} construct as if it would be
1457
1458 \c      %define __ %$abc goodbye
1459
1460     (note the white space between __ and %$abc). After my "fix" it
1461     will "correctly" expand into
1462
1463 \c      goodbye
1464
1465     as expected. Note that I use quotes around words "correct", "incorrect"
1466     etc because this is rather a feature not a bug; however current behaviour
1467     is more logical (and allows more advanced macro usage :-).
1468
1469     Same change was applied to:
1470         \c{%push},\c{%macro},\c{%imacro},\c{%define},\c{%idefine},\c{%xdefine},\c{%ixdefine},
1471         \c{%assign},\c{%iassign},\c{%undef}
1472
1473 \b A new directive [WARNING {+|-}warning-id] have been added. It works only
1474     if the assembly phase is enabled (i.e. it doesn't work with nasm -e).
1475
1476 \b A new warning type: macro-selfref. By default this warning is disabled;
1477     when enabled NASM warns when a macro self-references itself; for example
1478     the following source:
1479
1480 \c        [WARNING macro-selfref]
1481 \c
1482 \c        %macro          push    1-*
1483 \c                %rep    %0
1484 \c                        push    %1
1485 \c                        %rotate 1
1486 \c                %endrep
1487 \c        %endmacro
1488 \c
1489 \c                        push    eax,ebx,ecx
1490
1491     will produce a warning, but if we remove the first line we won't see it
1492     anymore (which is The Right Thing To Do {tm} IMHO since C preprocessor
1493     eats such constructs without warnings at all).
1494
1495 \b Added a "error" routine to preprocessor which always will set ERR_PASS1
1496     bit in severity_code. This removes annoying repeated errors on first
1497     and second passes from preprocessor.
1498
1499 \b Added the %+ operator in single-line macros for concatenating two
1500     identifiers. Usage example:
1501
1502 \c        %define _myfunc _otherfunc
1503 \c        %define cextern(x) _ %+ x
1504 \c        cextern (myfunc)
1505
1506     After first expansion, third line will become "_myfunc". After this
1507     expansion is performed again so it becomes "_otherunc".
1508
1509 \b Now if preprocessor is in a non-emitting state, no warning or error
1510     will be emitted. Example:
1511
1512 \c        %if 1
1513 \c                mov     eax,ebx
1514 \c        %else
1515 \c                put anything you want between these two brackets,
1516 \c                even macro-parameter references %1 or local
1517 \c                labels %$zz or macro-local labels %%zz - no
1518 \c                warning will be emitted.
1519 \c        %endif
1520
1521 \b Context-local variables on expansion as a last resort are looked up
1522     in outer contexts. For example, the following piece:
1523
1524 \c        %push   outer
1525 \c        %define %$a [esp]
1526 \c
1527 \c                %push   inner
1528 \c                %$a
1529 \c                %pop
1530 \c        %pop
1531
1532     will expand correctly the fourth line to [esp]; if we'll define another
1533     %$a inside the "inner" context, it will take precedence over outer
1534     definition. However, this modification has been applied only to
1535     expand_smacro and not to smacro_define: as a consequence expansion
1536     looks in outer contexts, but \c{%ifdef} won't look in outer contexts.
1537
1538     This behaviour is needed because we don't want nested contexts to
1539     act on already defined local macros. Example:
1540
1541 \c        %define %$arg1  [esp+4]
1542 \c        test    eax,eax
1543 \c        if      nz
1544 \c                mov     eax,%$arg1
1545 \c        endif
1546
1547     In this example the "if" mmacro enters into the "if" context, so %$arg1
1548     is not valid anymore inside "if". Of course it could be worked around
1549     by using explicitely %$$arg1 but this is ugly IMHO.
1550
1551 \b Fixed memory leak in \c{%undef}. The origline wasn't freed before
1552     exiting on success.
1553
1554 \b Fixed trap in preprocessor when line expanded to empty set of tokens.
1555     This happens, for example, in the following case:
1556
1557 \c        #define SOMETHING
1558 \c        SOMETHING
1559
1560
1561 \S{cl-0.98} Version 0.98
1562
1563 All changes since NASM 0.98p3 have been produced by H. Peter Anvin <hpa@zytor.com>.
1564
1565 \b The documentation comment delimiter is \# not #.
1566
1567 \b Allow EQU definitions to refer to external labels; reported by
1568   Pedro Gimeno.
1569
1570 \b Re-enable support for RDOFF v1; reported by Pedro Gimeno.
1571
1572 \b Updated License file per OK from Simon and Julian.
1573
1574
1575 \S{cl-0.98p9} Version 0.98p9
1576
1577 \b Update documentation (although the instruction set reference will
1578   have to wait; I don't want to hold up the 0.98 release for it.)
1579
1580 \b Verified that the NASM implementation of the PEXTRW and PMOVMSKB
1581   instructions is correct.  The encoding differs from what the Intel
1582   manuals document, but the Pentium III behaviour matches NASM, not
1583   the Intel manuals.
1584
1585 \b Fix handling of implicit sizes in PSHUFW and PINSRW, reported by
1586   Stefan Hoffmeister.
1587
1588 \b Resurrect the -s option, which was removed when changing the
1589   diagnostic output to stdout.
1590
1591
1592 \S{cl-0.98p8} Version 0.98p8
1593
1594 \b Fix for "DB" when NASM is running on a bigendian machine.
1595
1596 \b Invoke insns.pl once for each output script, making Makefile.in
1597   legal for "make -j".
1598
1599 \b Improve the Unix configure-based makefiles to make package
1600   creation easier.
1601
1602 \b Included an RPM .spec file for building RPM (RedHat Package Manager)
1603   packages on Linux or Unix systems.
1604
1605 \b Fix Makefile dependency problems.
1606
1607 \b Change src/rdsrc.pl to include sectioning information in info
1608   output; required for install-info to work.
1609
1610 \b Updated the RDOFF distribution to version 2 from Jules; minor
1611   massaging to make it compile in my environment.
1612
1613 \b Split doc files that can be built by anyone with a Perl interpreter off
1614   into a separate archive.
1615
1616 \b "Dress rehearsal" release!
1617
1618
1619 \S{cl-0.98p7} Version 0.98p7
1620
1621 \b Fixed opcodes with a third byte-sized immediate argument to not
1622   complain if given "byte" on the immediate.
1623
1624 \b Allow \c{%undef} to remove single-line macros with arguments.  This
1625   matches the behaviour of #undef in the C preprocessor.
1626
1627 \b Allow -d, -u, -i and -p to be specified as -D, -U, -I and -P for
1628   compatibility with most C compilers and preprocessors.  This allows
1629   Makefile options to be shared between cc and nasm, for example.
1630
1631 \b Minor cleanups.
1632
1633 \b Went through the list of Katmai instructions and hopefully fixed the
1634   (rather few) mistakes in it.
1635
1636 \b (Hopefully) fixed a number of disassembler bugs related to ambiguous
1637   instructions (disambiguated by -p) and SSE instructions with REP.
1638
1639 \b Fix for bug reported by Mark Junger: "call dword 0x12345678" should
1640   work and may add an OSP (affected CALL, JMP, Jcc).
1641
1642 \b Fix for environments when "stderr" isn't a compile-time constant.
1643
1644
1645 \S{cl-0.98p6} Version 0.98p6
1646
1647
1648 \b Took officially over coordination of the 0.98 release; so drop
1649   the p3.x notation. Skipped p4 and p5 to avoid confusion with John
1650   Fine's J4 and J5 releases.
1651
1652 \b Update the documentation; however, it still doesn't include
1653   documentation for the various new instructions.  I somehow wonder if
1654   it makes sense to have an instruction set reference in the assembler
1655   manual when Intel et al have PDF versions of their manuals online.
1656
1657 \b Recognize "idt" or "centaur" for the -p option to ndisasm.
1658
1659 \b Changed error messages back to stderr where they belong, but add an
1660   -E option to redirect them elsewhere (the DOS shell cannot redirect
1661   stderr.)
1662
1663 \b -M option to generate Makefile dependencies (based on code from Alex
1664   Verstak.)
1665
1666 \b \c{%undef} preprocessor directive, and -u option, that undefines a
1667   single-line macro.
1668
1669 \b OS/2 Makefile (Mkfiles/Makefile.os2) for Borland under OS/2; from
1670   Chuck Crayne.
1671
1672 \b Various minor bugfixes (reported by):
1673   - Dangling \c{%s} in preproc.c (Martin Junker)
1674
1675 \b THERE ARE KNOWN BUGS IN SSE AND THE OTHER KATMAI INSTRUCTIONS.  I am
1676   on a trip and didn't bring the Katmai instruction reference, so I
1677   can't work on them right now.
1678
1679 \b Updated the License file per agreement with Simon and Jules to
1680   include a GPL distribution clause.
1681
1682
1683 \S{cl-0.98p3.7} Version 0.98p3.7
1684
1685 \b (Hopefully) fixed the canned Makefiles to include the outrdf2 and
1686   zoutieee modules.
1687
1688 \b Renamed changes.asm to changed.asm.
1689
1690
1691 \S{cl-0.98p3.6} Version 0.98p3.6
1692
1693 \b Fixed a bunch of instructions that were added in 0.98p3.5 which had
1694   memory operands, and the address-size prefix was missing from the
1695   instruction pattern.
1696
1697
1698 \S{cl-0.98p3.5} Version 0.98p3.5
1699
1700 \b Merged in changes from John S. Fine's 0.98-J5 release.  John's based
1701   0.98-J5 on my 0.98p3.3 release; this merges the changes.
1702
1703 \b Expanded the instructions flag field to a long so we can fit more
1704   flags; mark SSE (KNI) and AMD or Katmai-specific instructions as
1705   such.
1706
1707 \b Fix the "PRIV" flag on a bunch of instructions, and create new
1708   "PROT" flag for protected-mode-only instructions (orthogonal to if
1709   the instruction is privileged!) and new "SMM" flag for SMM-only
1710   instructions.
1711
1712 \b Added AMD-only SYSCALL and SYSRET instructions.
1713
1714 \b Make SSE actually work, and add new Katmai MMX instructions.
1715
1716 \b Added a -p (preferred vendor) option to ndisasm so that it can
1717   distinguish e.g. Cyrix opcodes also used in SSE.  For example:
1718
1719 \c      ndisasm -p cyrix aliased.bin
1720 \c      00000000  670F514310        paddsiw mm0,[ebx+0x10]
1721 \c      00000005  670F514320        paddsiw mm0,[ebx+0x20]
1722 \c      ndisasm -p intel aliased.bin
1723 \c      00000000  670F514310        sqrtps xmm0,[ebx+0x10]
1724 \c      00000005  670F514320        sqrtps xmm0,[ebx+0x20]
1725
1726 \b Added a bunch of Cyrix-specific instructions.
1727
1728
1729 \S{cl-0.98p3.4} Version 0.98p3.4
1730
1731 \b Made at least an attempt to modify all the additional Makefiles (in
1732   the Mkfiles directory).  I can't test it, but this was the best I
1733   could do.
1734
1735 \b DOS DJGPP+"Opus Make" Makefile from John S. Fine.
1736
1737 \b changes.asm changes from John S. Fine.
1738
1739
1740 \S{cl-0.98p3.3} Version 0.98p3.3
1741
1742 \b Patch from Conan Brink to allow nesting of \c{%rep} directives.
1743
1744 \b If we're going to allow INT01 as an alias for INT1/ICEBP (one of
1745   Jules 0.98p3 changes), then we should allow INT03 as an alias for INT3
1746   as well.
1747
1748 \b Updated changes.asm to include the latest changes.
1749
1750 \b Tried to clean up the <CR>s that had snuck in from a DOS/Windows
1751   environment into my Unix environment, and try to make sure than
1752   DOS/Windows users get them back.
1753
1754 \b We would silently generate broken tools if insns.dat wasn't sorted
1755   properly.  Change insns.pl so that the order doesn't matter.
1756
1757 \b Fix bug in insns.pl (introduced by me) which would cause conditional
1758   instructions to have an extra "cc" in disassembly, e.g. "jnz"
1759   disassembled as "jccnz".
1760
1761
1762 \S{cl-0.98p3.2} Version 0.98p3.2
1763
1764 \b Merged in John S. Fine's changes from his 0.98-J4 prerelease; see
1765   http://www.csoft.net/cz/johnfine/
1766
1767 \b Changed previous "spotless" Makefile target (appropriate for distribution)
1768   to "distclean", and added "cleaner" target which is same as "clean"
1769   except deletes files generated by Perl scripts; "spotless" is union.
1770
1771 \b Removed BASIC programs from distribution.  Get a Perl interpreter
1772   instead (see below.)
1773
1774 \b Calling this "pre-release 3.2" rather than "p3-hpa2" because of
1775   John's contributions.
1776
1777 \b Actually link in the IEEE output format (zoutieee.c); fix a bunch of
1778   compiler warnings in that file.  Note I don't know what IEEE output
1779   is supposed to look like, so these changes were made "blind".
1780
1781
1782 \S{cl-0.98p3-hpa} Version 0.98p3-hpa
1783
1784 \b Merged nasm098p3.zip with nasm-0.97.tar.gz to create a fully
1785   buildable version for Unix systems (Makefile.in updates, etc.)
1786
1787 \b Changed insns.pl to create the instruction tables in nasm.h and
1788   names.c, so that a new instruction can be added by adding it *only*
1789   to insns.dat.
1790
1791 \b Added the following new instructions: SYSENTER, SYSEXIT, FXSAVE,
1792   FXRSTOR, UD1, UD2 (the latter two are two opcodes that Intel
1793   guarantee will never be used; one of them is documented as UD2 in
1794   Intel documentation, the other one just as "Undefined Opcode" --
1795   calling it UD1 seemed to make sense.)
1796
1797 \b MAX_SYMBOL was defined to be 9, but LOADALL286 and LOADALL386 are 10
1798   characters long.  Now MAX_SYMBOL is derived from insns.dat.
1799
1800 \b A note on the BASIC programs included: forget them.  insns.bas is
1801   already out of date.  Get yourself a Perl interpreter for your
1802   platform of choice at
1803   \W{http://www.cpan.org/ports/index.html}{http://www.cpan.org/ports/index.html}.
1804
1805
1806 \S{cl-0.98p3} Version 0.98 pre-release 3
1807
1808 \b added response file support, improved command line handling, new layout
1809 help screen
1810
1811 \b fixed limit checking bug, 'OUT byte nn, reg' bug, and a couple of rdoff
1812 related bugs, updated Wishlist; 0.98 Prerelease 3.
1813
1814
1815 \S{cl-0.98p2} Version 0.98 pre-release 2
1816
1817 \b fixed bug in outcoff.c to do with truncating section names longer
1818 than 8 characters, referencing beyond end of string; 0.98 pre-release 2
1819
1820
1821 \S{cl-0.98p1} Version 0.98 pre-release 1
1822
1823 \b Fixed a bug whereby STRUC didn't work at all in RDF.
1824
1825 \b Fixed a problem with group specification in PUBDEFs in OBJ.
1826
1827 \b Improved ease of adding new output formats. Contribution due to
1828 Fox Cutter.
1829
1830 \b Fixed a bug in relocations in the `bin' format: was showing up when
1831 a relocatable reference crossed an 8192-byte boundary in any output
1832 section.
1833
1834 \b Fixed a bug in local labels: local-label lookups were inconsistent
1835 between passes one and two if an EQU occurred between the definition
1836 of a global label and the subsequent use of a local label local to
1837 that global.
1838
1839 \b Fixed a seg-fault in the preprocessor (again) which happened when
1840 you use a blank line as the first line of a multi-line macro
1841 definition and then defined a label on the same line as a call to
1842 that macro.
1843
1844 \b Fixed a stale-pointer bug in the handling of the NASM environment
1845 variable. Thanks to Thomas McWilliams.
1846
1847 \b ELF had a hard limit on the number of sections which caused
1848 segfaults when transgressed. Fixed.
1849
1850 \b Added ability for ndisasm to read from stdin by using `-' as the
1851 filename.
1852
1853 \b ndisasm wasn't outputting the TO keyword. Fixed.
1854
1855 \b Fixed error cascade on bogus expression in \c{%if} - an error in
1856 evaluation was causing the entire \c{%if} to be discarded, thus creating
1857 trouble later when the \c{%else} or \c{%endif} was encountered.
1858
1859 \b Forward reference tracking was instruction-granular not operand-
1860 granular, which was causing 286-specific code to be generated
1861 needlessly on code of the form `shr word [forwardref],1'. Thanks to
1862 Jim Hague for sending a patch.
1863
1864 \b All messages now appear on stdout, as sending them to stderr serves
1865 no useful purpose other than to make redirection difficult.
1866
1867 \b Fixed the problem with EQUs pointing to an external symbol - this
1868 now generates an error message.
1869
1870 \b Allowed multiple size prefixes to an operand, of which only the first
1871 is taken into account.
1872
1873 \b Incorporated John Fine's changes, including fixes of a large number
1874 of preprocessor bugs, some small problems in OBJ, and a reworking of
1875 label handling to define labels before their line is assembled, rather
1876 than after.
1877
1878 \b Reformatted a lot of the source code to be more readable. Included
1879 'coding.txt' as a guideline for how to format code for contributors.
1880
1881 \b Stopped nested \c{%reps} causing a panic - they now cause a slightly more
1882 friendly error message instead.
1883
1884 \b Fixed floating point constant problems (patch by Pedro Gimeno)
1885
1886 \b Fixed the return value of insn_size() not being checked for -1, indicating
1887 an error.
1888
1889 \b Incorporated 3Dnow! instructions.
1890
1891 \b Fixed the 'mov eax, eax + ebx' bug.
1892
1893 \b Fixed the GLOBAL EQU bug in ELF. Released developers release 3.
1894
1895 \b Incorporated John Fine's command line parsing changes
1896
1897 \b Incorporated David Lindauer's OMF debug support
1898
1899 \b Made changes for LCC 4.0 support (\c{__NASM_CDecl__}, removed register size
1900 specification warning when sizes agree).
1901
1902
1903 \H{cl-0.9x} NASM 0.9 Series
1904
1905 Revisions before 0.98.
1906
1907
1908 \S{cl-0.97} Version 0.97 released December 1997
1909
1910 \b This was entirely a bug-fix release to 0.96, which seems to have got
1911 cursed. Silly me.
1912
1913 \b Fixed stupid mistake in OBJ which caused `MOV EAX,<constant>' to
1914 fail. Caused by an error in the `MOV EAX,<segment>' support.
1915
1916 \b ndisasm hung at EOF when compiled with lcc on Linux because lcc on
1917 Linux somehow breaks feof(). ndisasm now does not rely on feof().
1918
1919 \b A heading in the documentation was missing due to a markup error in
1920 the indexing. Fixed.
1921
1922 \b Fixed failure to update all pointers on realloc() within extended-
1923 operand code in parser.c. Was causing wrong behaviour and seg faults
1924 on lines such as `dd 0.0,0.0,0.0,0.0,...'
1925
1926 \b Fixed a subtle preprocessor bug whereby invoking one multi-line
1927 macro on the first line of the expansion of another, when the second
1928 had been invoked with a label defined before it, didn't expand the
1929 inner macro.
1930
1931 \b Added internal.doc back in to the distribution archives - it was
1932 missing in 0.96 *blush*
1933
1934 \b Fixed bug causing 0.96 to be unable to assemble its own test files,
1935 specifically objtest.asm. *blush again*
1936
1937 \b Fixed seg-faults and bogus error messages caused by mismatching
1938 \c{%rep} and \c{%endrep} within multi-line macro definitions.
1939
1940 \b Fixed a problem with buffer overrun in OBJ, which was causing
1941 corruption at ends of long PUBDEF records.
1942
1943 \b Separated DOS archives into main-program and documentation to reduce
1944 download size.
1945
1946
1947 \S{cl-0.96} Version 0.96 released November 1997
1948
1949 \b Fixed a bug whereby, if `nasm sourcefile' would cause a filename
1950 collision warning and put output into `nasm.out', then `nasm
1951 sourcefile -o outputfile' still gave the warning even though the
1952 `-o' was honoured.
1953 Fixed name pollution under Digital UNIX: one of its header files
1954 defined R_SP, which broke the enum in nasm.h.
1955
1956 \b Fixed minor instruction table problems: FUCOM and FUCOMP didn't have
1957 two-operand forms; NDISASM didn't recognise the longer register
1958 forms of PUSH and POP (eg FF F3 for PUSH BX); TEST mem,imm32 was
1959 flagged as undocumented; the 32-bit forms of CMOV had 16-bit operand
1960 size prefixes; `AAD imm' and `AAM imm' are no longer flagged as
1961 undocumented because the Intel Architecture reference documents
1962 them.
1963
1964 \b Fixed a problem with the local-label mechanism, whereby strange
1965 types of symbol (EQUs, auto-defined OBJ segment base symbols)
1966 interfered with the `previous global label' value and screwed up
1967 local labels.
1968
1969 \b Fixed a bug whereby the stub preprocessor didn't communicate with
1970 the listing file generator, so that the -a and -l options in
1971 conjunction would produce a useless listing file.
1972
1973 \b Merged `os2' object file format back into `obj', after discovering
1974 that `obj' _also_ shouldn't have a link pass separator in a module
1975 containing a non-trivial MODEND. Flat segments are now declared
1976 using the FLAT attribute. `os2' is no longer a valid object format
1977 name: use `obj'.
1978
1979 \b Removed the fixed-size temporary storage in the evaluator. Very very
1980 long expressions (like `mov ax,1+1+1+1+...' for two hundred 1s or
1981 so) should now no longer crash NASM.
1982
1983 \b Fixed a bug involving segfaults on disassembly of MMX instructions,
1984 by changing the meaning of one of the operand-type flags in nasm.h.
1985 This may cause other apparently unrelated MMX problems; it needs to
1986 be tested thoroughly.
1987
1988 \b Fixed some buffer overrun problems with large OBJ output files.
1989 Thanks to DJ Delorie for the bug report and fix.
1990
1991 \b Made preprocess-only mode actually listen to the \c{%line} markers as it
1992 prints them, so that it can report errors more sanely.
1993
1994 \b Re-designed the evaluator to keep more sensible track of expressions
1995 involving forward references: can now cope with previously-nightmare
1996 situations such as:
1997
1998 \c   mov ax,foo | bar
1999 \c   foo equ 1
2000 \c   bar equ 2
2001
2002 \b Added the ALIGN and ALIGNB standard macros.
2003
2004 \b Added PIC support in ELF: use of WRT to obtain the four extra
2005 relocation types needed.
2006
2007 \b Added the ability for output file formats to define their own
2008 extensions to the GLOBAL, COMMON and EXTERN directives.
2009
2010 \b Implemented common-variable alignment, and global-symbol type and
2011 size declarations, in ELF.
2012
2013 \b Implemented NEAR and FAR keywords for common variables, plus
2014 far-common element size specification, in OBJ.
2015
2016 \b Added a feature whereby EXTERNs and COMMONs in OBJ can be given a
2017 default WRT specification (either a segment or a group).
2018
2019 \b Transformed the Unix NASM archive into an auto-configuring package.
2020
2021 \b Added a sanity-check for people applying SEG to things which are
2022 already segment bases: this previously went unnoticed by the SEG
2023 processing and caused OBJ-driver panics later.
2024
2025 \b Added the ability, in OBJ format, to deal with `MOV EAX,<segment>'
2026 type references: OBJ doesn't directly support dword-size segment
2027 base fixups, but as long as the low two bytes of the constant term
2028 are zero, a word-size fixup can be generated instead and it will
2029 work.
2030
2031 \b Added the ability to specify sections' alignment requirements in
2032 Win32 object files and pure binary files.
2033
2034 \b Added preprocess-time expression evaluation: the \c{%assign} (and
2035 \c{%iassign}) directive and the bare \c{%if} (and \c{%elif}) conditional. Added
2036 relational operators to the evaluator, for use only in \c{%if}
2037 constructs: the standard relationals = < > <= >= <> (and C-like
2038 synonyms == and !=) plus low-precedence logical operators &&, ^^ and
2039 ||.
2040
2041 \b Added a preprocessor repeat construct: \c{%rep} / \c{%exitrep} / \c{%endrep}.
2042
2043 \b Added the __FILE__ and __LINE__ standard macros.
2044
2045 \b Added a sanity check for number constants being greater than
2046 0xFFFFFFFF. The warning can be disabled.
2047
2048 \b Added the %0 token whereby a variadic multi-line macro can tell how
2049 many parameters it's been given in a specific invocation.
2050
2051 \b Added \c{%rotate}, allowing multi-line macro parameters to be cycled.
2052
2053 \b Added the `*' option for the maximum parameter count on multi-line
2054 macros, allowing them to take arbitrarily many parameters.
2055
2056 \b Added the ability for the user-level forms of EXTERN, GLOBAL and
2057 COMMON to take more than one argument.
2058
2059 \b Added the IMPORT and EXPORT directives in OBJ format, to deal with
2060 Windows DLLs.
2061
2062 \b Added some more preprocessor \c{%if} constructs: \c{%ifidn} / \c{%ifidni} (exact
2063 textual identity), and \c{%ifid} / \c{%ifnum} / \c{%ifstr} (token type testing).
2064
2065 \b Added the ability to distinguish SHL AX,1 (the 8086 version) from
2066 SHL AX,BYTE 1 (the 286-and-upwards version whose constant happens to
2067 be 1).
2068
2069 \b Added NetBSD/FreeBSD/OpenBSD's variant of a.out format, complete
2070 with PIC shared library features.
2071
2072 \b Changed NASM's idiosyncratic handling of FCLEX, FDISI, FENI, FINIT,
2073 FSAVE, FSTCW, FSTENV, and FSTSW to bring it into line with the
2074 otherwise accepted standard. The previous behaviour, though it was a
2075 deliberate feature, was a deliberate feature based on a
2076 misunderstanding. Apologies for the inconvenience.
2077
2078 \b Improved the flexibility of ABSOLUTE: you can now give it an
2079 expression rather than being restricted to a constant, and it can
2080 take relocatable arguments as well.
2081
2082 \b Added the ability for a variable to be declared as EXTERN multiple
2083 times, and the subsequent definitions are just ignored.
2084
2085 \b We now allow instruction prefixes (CS, DS, LOCK, REPZ etc) to be
2086 alone on a line (without a following instruction).
2087
2088 \b Improved sanity checks on whether the arguments to EXTERN, GLOBAL
2089 and COMMON are valid identifiers.
2090
2091 \b Added misc/exebin.mac to allow direct generation of .EXE files by
2092 hacking up an EXE header using DB and DW; also added test/binexe.asm
2093 to demonstrate the use of this. Thanks to Yann Guidon for
2094 contributing the EXE header code.
2095
2096 \b ndisasm forgot to check whether the input file had been successfully
2097 opened. Now it does. Doh!
2098
2099 \b Added the Cyrix extensions to the MMX instruction set.
2100
2101 \b Added a hinting mechanism to allow [EAX+EBX] and [EBX+EAX] to be
2102 assembled differently. This is important since [ESI+EBP] and
2103 [EBP+ESI] have different default base segment registers.
2104
2105 \b Added support for the PharLap OMF extension for 4096-byte segment
2106 alignment.
2107
2108
2109 \S{cl-0.95 released July 1997} Version 0.95 released July 1997
2110
2111 \b Fixed yet another ELF bug. This one manifested if the user relied on
2112 the default segment, and attempted to define global symbols without
2113 first explicitly declaring the target segment.
2114
2115 \b Added makefiles (for NASM and the RDF tools) to build Win32 console
2116 apps under Symantec C++. Donated by Mark Junker.
2117
2118 \b Added `macros.bas' and `insns.bas', QBasic versions of the Perl
2119 scripts that convert `standard.mac' to `macros.c' and convert
2120 `insns.dat' to `insnsa.c' and `insnsd.c'. Also thanks to Mark
2121 Junker.
2122
2123 \b Changed the diassembled forms of the conditional instructions so
2124 that JB is now emitted as JC, and other similar changes. Suggested
2125 list by Ulrich Doewich.
2126
2127 \b Added `@' to the list of valid characters to begin an identifier
2128 with.
2129
2130 \b Documentary changes, notably the addition of the `Common Problems'
2131 section in nasm.doc.
2132
2133 \b Fixed a bug relating to 32-bit PC-relative fixups in OBJ.
2134
2135 \b Fixed a bug in perm_copy() in labels.c which was causing exceptions
2136 in cleanup_labels() on some systems.
2137
2138 \b Positivity sanity check in TIMES argument changed from a warning to
2139 an error following a further complaint.
2140
2141 \b Changed the acceptable limits on byte and word operands to allow
2142 things like `~10111001b' to work.
2143
2144 \b Fixed a major problem in the preprocessor which caused seg-faults if
2145 macro definitions contained blank lines or comment-only lines.
2146
2147 \b Fixed inadequate error checking on the commas separating the
2148 arguments to `db', `dw' etc.
2149
2150 \b Fixed a crippling bug in the handling of macros with operand counts
2151 defined with a `+' modifier.
2152
2153 \b Fixed a bug whereby object file formats which stored the input file
2154 name in the output file (such as OBJ and COFF) weren't doing so
2155 correctly when the output file name was specified on the command
2156 line.
2157
2158 \b Removed [INC] and [INCLUDE] support for good, since they were
2159 obsolete anyway.
2160
2161 \b Fixed a bug in OBJ which caused all fixups to be output in 16-bit
2162 (old-format) FIXUPP records, rather than putting the 32-bit ones in
2163 FIXUPP32 (new-format) records.
2164
2165 \b Added, tentatively, OS/2 object file support (as a minor variant on
2166 OBJ).
2167
2168 \b Updates to Fox Cutter's Borland C makefile, Makefile.bc2.
2169
2170 \b Removed a spurious second fclose() on the output file.
2171
2172 \b Added the `-s' command line option to redirect all messages which
2173 would go to stderr (errors, help text) to stdout instead.
2174
2175 \b Added the `-w' command line option to selectively suppress some
2176 classes of assembly warning messages.
2177
2178 \b Added the `-p' pre-include and `-d' pre-define command-line options.
2179
2180 \b Added an include file search path: the `-i' command line option.
2181
2182 \b Fixed a silly little preprocessor bug whereby starting a line with a
2183 `%!' environment-variable reference caused an `unknown directive'
2184 error.
2185
2186 \b Added the long-awaited listing file support: the `-l' command line
2187 option.
2188
2189 \b Fixed a problem with OBJ format whereby, in the absence of any
2190 explicit segment definition, non-global symbols declared in the
2191 implicit default segment generated spurious EXTDEF records in the
2192 output.
2193
2194 \b Added the NASM environment variable.
2195
2196 \b From this version forward, Win32 console-mode binaries will be
2197 included in the DOS distribution in addition to the 16-bit binaries.
2198 Added Makefile.vc for this purpose.
2199
2200 \b Added `return 0;' to test/objlink.c to prevent compiler warnings.
2201
2202 \b Added the __NASM_MAJOR__ and __NASM_MINOR__ standard defines.
2203
2204 \b Added an alternative memory-reference syntax in which prefixing an
2205 operand with `&' is equivalent to enclosing it in square brackets,
2206 at the request of Fox Cutter.
2207
2208 \b Errors in pass two now cause the program to return a non-zero error
2209 code, which they didn't before.
2210
2211 \b Fixed the single-line macro cycle detection, which didn't work at
2212 all on macros with no parameters (caused an infinite loop). Also
2213 changed the behaviour of single-line macro cycle detection to work
2214 like cpp, so that macros like `extrn' as given in the documentation
2215 can be implemented.
2216
2217 \b Fixed the implementation of WRT, which was too restrictive in that
2218 you couldn't do `mov ax,[di+abc wrt dgroup]' because (di+abc) wasn't
2219 a relocatable reference.
2220
2221
2222 \S{cl-0.94 released April 1997} Version 0.94 released April 1997
2223
2224
2225 \b Major item: added the macro processor.
2226
2227 \b Added undocumented instructions SMI, IBTS, XBTS and LOADALL286. Also
2228 reorganised CMPXCHG instruction into early-486 and Pentium forms.
2229 Thanks to Thobias Jones for the information.
2230
2231 \b Fixed two more stupid bugs in ELF, which were causing `ld' to
2232 continue to seg-fault in a lot of non-trivial cases.
2233
2234 \b Fixed a seg-fault in the label manager.
2235
2236 \b Stopped FBLD and FBSTP from _requiring_ the TWORD keyword, which is
2237 the only option for BCD loads/stores in any case.
2238
2239 \b Ensured FLDCW, FSTCW and FSTSW can cope with the WORD keyword, if
2240 anyone bothers to provide it. Previously they complained unless no
2241 keyword at all was present.
2242
2243 \b Some forms of FDIV/FDIVR and FSUB/FSUBR were still inverted: a
2244 vestige of a bug that I thought had been fixed in 0.92. This was
2245 fixed, hopefully for good this time...
2246
2247 \b Another minor phase error (insofar as a phase error can _ever_ be
2248 minor) fixed, this one occurring in code of the form
2249
2250 \c   rol ax,forward_reference
2251 \c   forward_reference equ 1
2252
2253 \b The number supplied to TIMES is now sanity-checked for positivity,
2254 and also may be greater than 64K (which previously didn't work on
2255 16-bit systems).
2256
2257 \b Added Watcom C makefiles, and misc/pmw.bat, donated by Dominik Behr.
2258
2259 \b Added the INCBIN pseudo-opcode.
2260
2261 \b Due to the advent of the preprocessor, the [INCLUDE] and [INC]
2262 directives have become obsolete. They are still supported in this
2263 version, with a warning, but won't be in the next.
2264
2265 \b Fixed a bug in OBJ format, which caused incorrect object records to
2266 be output when absolute labels were made global.
2267
2268 \b Updates to RDOFF subdirectory, and changes to outrdf.c.
2269
2270
2271 \S{cl-0.93 released January 1997} Version 0.93 released January 1997
2272
2273 This release went out in a great hurry after semi-crippling bugs
2274 were found in 0.92.
2275
2276 \b Really \e{did} fix the stack overflows this time. *blush*
2277
2278 \b Had problems with EA instruction sizes changing between passes, when
2279 an offset contained a forward reference and so 4 bytes were
2280 allocated for the offset in pass one; by pass two the symbol had
2281 been defined and happened to be a small absolute value, so only 1
2282 byte got allocated, causing instruction size mismatch between passes
2283 and hence incorrect address calculations. Fixed.
2284
2285 \b Stupid bug in the revised ELF section generation fixed (associated
2286 string-table section for .symtab was hard-coded as 7, even when this
2287 didn't fit with the real section table). Was causing `ld' to
2288 seg-fault under Linux.
2289
2290 \b Included a new Borland C makefile, Makefile.bc2, donated by Fox
2291 Cutter <lmb@comtch.iea.com>.
2292
2293
2294 \S{cl-0.92 released January 1997} Version 0.92 released January 1997
2295
2296 \b The FDIVP/FDIVRP and FSUBP/FSUBRP pairs had been inverted: this was
2297 fixed. This also affected the LCC driver.
2298
2299 \b Fixed a bug regarding 32-bit effective addresses of the form
2300 \c{[other_register+ESP]}.
2301
2302 \b Documentary changes, notably documentation of the fact that Borland
2303 Win32 compilers use `obj' rather than `win32' object format.
2304
2305 \b Fixed the COMENT record in OBJ files, which was formatted
2306 incorrectly.
2307
2308 \b Fixed a bug causing segfaults in large RDF files.
2309
2310 \b OBJ format now strips initial periods from segment and group
2311 definitions, in order to avoid complications with the local label
2312 syntax.
2313
2314 \b Fixed a bug in disassembling far calls and jumps in NDISASM.
2315
2316 \b Added support for user-defined sections in COFF and ELF files.
2317
2318 \b Compiled the DOS binaries with a sensible amount of stack, to
2319 prevent stack overflows on any arithmetic expression containing
2320 parentheses.
2321
2322 \b Fixed a bug in handling of files that do not terminate in a newline.
2323
2324
2325 \S{cl-0.91 released November 1996} Version 0.91 released November 1996
2326
2327 \b Loads of bug fixes.
2328
2329 \b Support for RDF added.
2330
2331 \b Support for DBG debugging format added.
2332
2333 \b Support for 32-bit extensions to Microsoft OBJ format added.
2334
2335 \b Revised for Borland C: some variable names changed, makefile added.
2336
2337 \b LCC support revised to actually work.
2338
2339 \b JMP/CALL NEAR/FAR notation added.
2340
2341 \b `a16', `o16', `a32' and `o32' prefixes added.
2342
2343 \b Range checking on short jumps implemented.
2344
2345 \b MMX instruction support added.
2346
2347 \b Negative floating point constant support added.
2348
2349 \b Memory handling improved to bypass 64K barrier under DOS.
2350
2351 \b \c{$} prefix to force treatment of reserved words as identifiers added.
2352
2353 \b Default-size mechanism for object formats added.
2354
2355 \b Compile-time configurability added.
2356
2357 \b \c{#}, \c{@}, \c{~} and c\{?} are now valid characters in labels.
2358
2359 \b \c{-e} and \c{-k} options in NDISASM added.
2360
2361
2362 \S{cl-0.90 released October 1996} Version 0.90 released October 1996
2363
2364 First release version. First support for object file output. Other
2365 changes from previous version (0.3x) too numerous to document.