Scroll to navigation

ASxxxx(1) General Commands Manual ASxxxx(1)

NAME

ASxxxx - Series of microprocessor cross assemblers for SDCC.

SYNOPSIS

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

WARNING

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.

DESCRIPTION

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

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

OPTIONS

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.

SEE ALSO

sdcc(1), aslink(1), asx8051, as-z80(1), as-gbz80(1).

AUTHOR

This manual page was written by Aurelien Jarno <aurel32@debian.org>, for the Debian GNU/Linux system (but may be used by others).