Man Linux: Main Page and Category List

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).