z88dk-z80asm(1) [debian man page]

z80asm(1)							z88 Development Kit							 z80asm(1)

NAME

       z88dk-z80asm - Z80 assembler compiler.

SYSNOPIS

       z88dk-z80asm [options] [ @<modulefile> | {<filename>} ]

DESCRIPTION

       This  manual page documents briefly the z88dk tools. This manual page was written for the Debian GNU/Linux distribution (but may be used by
       others), because the original program does not have a manual page.

       z88dk-z80asm is a Z80 assembler cross compiler.

       Please refer to the z88dk documentation in /usr/share/doc/z88dk-doc/ for the complete description of the system.  If  /usr/share/doc/z88dk-
       doc not exists, please install the package z88dk-doc.

OPTIONS

       -h     display help

       -n     defines option to be turned OFF (except -r -R -i -x -D -t -o)

       -v     verbose

       -l     listing file

       -s     symbol table,

       -m     map listing file

       -r<ORG>
	      Explicit relocation <ORG> defined in hex (ignore ORG in first module)

       -plus  Interpret 'Invoke' as RST 28h

       -R     Generate relocatable code (Automatical relocation before execution)

       -D<symbol>
	      define symbol as logically TRUE (used for conditional assembly)

       -b     assemble files & link to ORG address. -c split code in 16K banks

       -d     date  stamp  control,  assemble only if source file > object file -a: -b & -d (assemble only updated source files, then link & relo-
	      cate)

       -o<bin filename>
	      expl. output filename, -g XDEF reloc. addr. from all modules

       -i<library>
	      include <library> LIB modules with .obj modules during linking

       -x<library>
	      create library from specified modules ( e.g. with @<modules> )

       -t<n>  tabulator width for .map, .def, .sym files. Column width is 4 times -t

       Default options: -nv -nd -nb -nl -s -m -ng -nc -nR -t8

SEE ALSO

       z88dk(1), z88dk-zcc(1), z88dk-z80asm(1), z88dk-appmake(1), z88dk-copt(1).

AUTHOR

       z88dk was written by Dominic Morris <dom@z88dk.org>, and others.  z80asm was written by Gunther Strube <gbs@image.dk>.	This  manual  page
       was written by Krystian Wlosek <tygrys@waw.pdi.net> using exists documentation, for the Debian GNU/Linux system.

								 01 December 2009							 z80asm(1)

ASLINK(1)						      General Commands Manual							 ASLINK(1)

NAME

       ASLINK - companion linker for the ASxxxx assemblers.

SYNOPSIS

       aslink [options] filenames
       link-gbz80 [options] filenames
       link-z80 [options] filenames

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 ASLINK is general relocating companion linker for the ASxxx assemblers.

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

OPTIONS

       The linker may run in the command line mode or command file modes.  The allowed startup linker commands are:

       -c/-f  command line / command file modes

       -p/-n  enable/disable echo file.lnk input to stdout

       If command line mode is selected, all linker commands come from stdin, if the command file mode is selected the commands are input from the
       specified file (extension must be .lnk).

       After invoking the linker the valid options are:

       -i/-s  Intel Hex (file.ihx) or Motorola S19 (file.s19) image output file.

       -z     Specifies that symbol names are case sensitive.

       -m     Generate a map file (file.map). This file contains a list of the symbols (by area) with absolute addresses, sizes of  linked  areas,
	      and other linking information.

       -w     Specifies that a wide listing format be used for the map file.

       -xdq   Specifies the number radix for the map file (Hexidecimal, Decimal, or Octal).

       -u     Generate an updated listing file (file.rst) derived from the relocated addresses and data from the linker.

       fileN  Files to be linked. Files may be on the same line as the above options or on a separate line(s) one file	per line or multiple files
	      separated by spaces or tabs.

       -b area = expression (one definition per line)
	      This specifies an area base address where the expression may contain constants and/or defined symbols from the linked files.

       -g symbol = expression (one definition per line)
	      This specifies the value for the symbol where the expression may contain constants and/or defined symbols from the linked files.

       -k library directory path (one  definition  per line)
	      This specifies one possible path to an object library.  More than one path is allowed.

       -l library file specification (one  definition  per  line)
	      This specifies a possible library file.  More than one file is allowed.

       -e     or null line, terminates input to the linker.

SEE ALSO

       sdcc(1), asxxxx(1), link-z80(1), link-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).

																	 ASLINK(1)