ASxxxx(1) Series of microprocessor cross assemblers for SDCC.


asx8051 [options] file1 [file2 file3 ... file6]
as-gbz80 [options] file1 [file2 file3 ... file6]
as-z80 [options] file1 [file2 file3 ... file6]


The information in this man page is an extract from the full documentation of SDCC, and is limited to the meaning of the options.

For complete and current documentation, refer to the ASxxxx Cross Assembler Documentation, available in /usr/share/doc/sdcc-doc/aslink.


The ASxxxx assemblers are a series of microprocessor assemblers. Each assembler has a device specific section.

MCS51 family is supported by asx8051.
Z80 family is supported by as-z80.
GBZ80 (GameBoy Z80-like CPU) is supported by as-gbz80.


The ASxxxx assemblers are command line oriented. The PC assemblers are started with the appropriate option(s) and file(s) to assemble following the assembler name.
decimal listing.
octal listing.
hex listing (default)

The listing radix affects the .lst, .rel, and .sym files.

add line number and debug information to file.
undefined symbols made global.
all user symbols made global.
create list output file1.lst.
create object output file1.rel.
create symbol output file1.sym.
disable listing pagination.
wide listing format for symbol table.
enable case sensitivity for symbols.
flag relocatable references by ` in the listing file.
flag relocatable reference by mode in the listing file.

The file name for the .lst, .rel, and .sym files is the first file name specified in the command line. All output files are ascii text files which may be edited, copied, etc. The output files are the concatenation of all the input files, if files are to be assembled independently invoke the assembler for each file.

The .rel file contains a radix directive so that the linker will use the proper conversion for this file. Linked files may have different radices.

If the list (l) option is specified without the symbol table (s) option, the symbol table is placed at the end of the listing file.


This manual page was written by Aurelien Jarno <[email protected]>, for the Debian GNU/Linux system (but may be used by others).