Target Audience

Welcome to the 1.0.1 release of the Yasm Modular Assembler. Its target audience includes people who want to:

Download Yasm 1.0.1

A number of download formats are available. For Windows and DOS users, we recommend downloading the prebuilt binaries. The source tarball contains all sources needed to build Yasm on UNIX-compatible systems, Windows, and DOS. If you use Visual Studio 2010, we highly recommend downloading the appropriate vsyasm zip file and following its readme.txt directions for integration of yasm into the Visual Studio IDE.

A TASM-like frontend is also available. It defaults to the “tasm” parser and provides TASM-like command line options.

Features

Changes from 1.0.0 to 1.0.1:

Features also include:

Object and debugging format support:

Assembler syntax support:

Architecture support:

Other features:

Important Differences from NASM

Known Issues

As Yasm is still under development, there are some caveats and features that do not yet work or are not yet fully functional. See the Tickets area of Yasm’s website for a list of active issues.

Compiling Yasm from source

On UNIX-compatible operating systems, Yasm builds using the standard “./configure; make; make install” commands. GNU make is not required. While Yasm development requires a larger toolchain (see the HACKING file), building Yasm should not require more than just a C compiler.

For Windows and DOS systems, we recommend simply downloading the prebuilt executables. However, for those that want to build YASM directly using DJGPP, CygWin, or Visual Studio, Makefiles and all required specialized files are provided in the Mkfiles/ directory of the distribution tarball.

Running Yasm

Version Information:

yasm --version

Command Line Option Help:

yasm --help

Assemble test.asm to Win32 object file test.obj with CodeView 8.0 (VS2005) source debug info:

yasm -f win32 -g cv8 test.asm

Assemble test2.asm to Win64 object file test.obj with CodeView 8.0 source debug info:

yasm -f win64 -g cv8 test2.asm

Assemble test3.asm to AMD64 ELF object file test3.o with DWARF2 debugging information:

yasm -f elf64 -g dwarf2 test3.asm

Alternative to above:

yasm -f elf -m amd64 -g dwarf2 test3.asm

Assemble test4.s (GAS syntax file) to 32-bit x86 ELF object file testo.o with DWARF2 debugging information:

yasm -p gas -f elf32 -g dwarf2 -o testo.o test4.s