home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Misc / rs60-3.dms / rs60-3.adf / devtools.lha.DIR / DevTools / alink.doc next >
Encoding:
Text File  |  1996-03-29  |  2.3 KB  |  72 lines
  1. ALINK
  2.  
  3. Format:      ALINK [FROM <objectfiles>] [WITH <files>] [TO <file>]
  4.          [MAP <file>] [LIBRARY <files>] [VER <file>] [XREF <file>]
  5.          [width <n>]
  6.  
  7. Template:    ALINK "FROM=ROOT,WITH/K,TO/K,LIBRARY=LIB/K,MAP/K,VER/K,XREF/K,
  8.          WIDTH/K"
  9.  
  10. Purpose:     To link Amiga binary object files into loadable files.
  11.  
  12. Specification:
  13.  
  14. ALINK is a linkage editor to convert Amiga binary object files to Amiga load
  15. files.
  16.  
  17. In the above format, <file> stands for a single file name, while <files>
  18. means zero or more file names that must be separated by a comma, plus, or
  19. space.  If file names are separated by spaces, the parameter must be
  20. enclosed in quotes.
  21.  
  22. [FROM <objectfiles>]    Specifies the object files to be used as the primary
  23.             binary input.  The contents of these files are
  24.             always copied to the load file to form part of the
  25.             overlay root.
  26.  
  27. [WITH <files>]        Specifies files containing the linker parameters
  28.             (e.g. normal command lines).  Usually only one file
  29.             will be used, but, for completeness, a list of files
  30.             can be given. Parameters on the command line will
  31.             override those in WITH files.  Lines can be
  32.             continued by putting an asterisk (*) at the end of
  33.             them.  WITH files are frequently used when the
  34.             command line gets too long.
  35.  
  36. [TO <file>]        Specifies the destination for the load file.  If
  37.             this parameter is not given, the second pass is
  38.             omitted.
  39.  
  40. [MAP <file>]        Writes a map of addresses within hunks to the <file>
  41.             specified.
  42.  
  43. [XREF <file>]        Specifies the destination of the cross reference
  44.             output.
  45.  
  46. [VER <file>]         Specifies the destination of messages from ALINK.
  47.             If a file is not specified, all messages are sent to
  48.             the standard output.
  49.  
  50. [LIBRARY <files>]    Specifies the files to be scanned as the library.
  51.             Only referenced code segments in these files will be
  52.             included.
  53.  
  54. [WIDTH <n>]         Specifies the output width (<n> characters) to be
  55.             used when producing the link map and cross reference
  56.             table.
  57.  
  58. Example:
  59.  
  60. 1> ALINK a.obj,b.obj,c.obj LIBRARY amiga.lib MAP demo.map TO demo.ld
  61.  
  62. Converts and links binary files a, b and c to load file demo.
  63.  
  64. See Also:    ABSLOAD, PRINTA
  65.  
  66. Bugs:         The MAP output only gives the first eight characters of a
  67.          symbol's name.
  68.  
  69. For more information on ALINK, see The AmigaDOS Manual, published by Bantam
  70. Books.
  71.  
  72.