YASM Release Notes

Milestone 2 (0.2.0)

Release Date: 3/26/03

Target Audience

Welcome to the second milestone release of The YASM Modular Assembler. As this is only a milestone, it's really not for general use yet, so there are certain to be many bugs and missing features. This release is intended to provide a stable snapshot of YASM development as of 3/26/03. Its target audience includes people who:

• want to keep track of YASM's progress in terms of stability and feature set;
• want to test YASM with their own code to help test it;
• want to get started on YASM development from a new release;
• are just interested in the YASM project.

What's New

As it's been over a year since Milestone 1 (we will be releasing more often in the future!), quite a lot has changed. Although still limited, YASM is usable for most Win32 or DJGPP targeted projects. Some of the new features include:

• Revamped (faster and better) NASM-compatible parser.
• Full support for COFF (DJGPP) and Win32 object format output.
• "Real" NASM preprocessor (imported from NASM tree).
• Support for AMD x86-64 instruction set, registers, and addressing modes (mostly untested). This is enabled using the "[BITS 64]" directive; see the x86-64 tests for the x86 architecture for more details.
• Numerous bug fixes and code cleanups.
• Most code relicensed under 2-clause BSD license, although major portions are still LGPL-licensed (NASM preprocessor, long integer support).

As YASM is still under development, there are some caveats and features that do not yet work or are not yet fully functional:

• There is no support at present for the use of -I to specify include directories (even when using the embedded NASM preprocessor). See below for a workaround using the external NASM preprocessor.
• The optimizer is very basic 2-pass style (even so it should be slightly better than NASM's 2-pass optimizer).
• SEG, WRT, and ':' (segment:offset notation) don't work (generally used in 16-bit code).

Important Differences from NASM

YASM defaults to reading from standard input and writing to standard output if no files are specified. When an input file is specified, YASM behaves like NASM.

Running YASM

Version Information:

yasm --version

Commandline Help:

yasm --help

Assemble test.asm (using "real" NASM preprocessor) to Win32 object file test.obj:

yasm -f win32 test.asm

Assemble test2.asm (which needs to be preprocessed with -I) to COFF object file test2.o:

nasm -e -Iinclude test2.asm | yasm -r raw -f coff -o test2.o