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