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