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