home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / CBMDevKit2.dms / CBMDevKit2.adf / DevTools / DevTools.lha / Devtools / DOCS / absload.doc next >
Encoding:
Text File  |  1993-05-13  |  3.0 KB  |  77 lines
  1. ABSLOAD
  2.  
  3. Format:      ABSLOAD [-D] [-M] [-X] [-S] [-B <Ksize>] [-O <sfile>] [-T<addr>]
  4.          [<lfile>]
  5.  
  6. Template:    ABSLOAD "-D/S,-M/S,-X/S,-S/S,-B/K,-O/K,-T/K"
  7.  
  8. Purpose:     To convert Amiga loader format to Motorola srecords.
  9.  
  10. Specification:
  11.  
  12. ABSLOAD converts Amiga Binary object files from the linker ALINK and creates
  13. a Motorola srecord file suitable for downloading to an Amiga machine.  The
  14. starting address of the code is assumed to be the first code hunk found in
  15. the input file.
  16.  
  17. The options available are:
  18.  
  19. [-D]        Writes debugging information to standard error.  This option
  20.         is primarily useful if the linker is creating a file that
  21.         ABSLOAD cannot understand.  Much of this information is
  22.         similar to that from PRINTA. The first line printed is the
  23.         version of ABSLOAD.  (Default is not to write debugging
  24.         information.)
  25.  
  26. [-M]        Writes map of hunk addresses to standard output. The map is
  27.         a list of lines with three fields:  decimal hunk number,
  28.         hexadecimal hunk base byte address, and hexadecimal byte
  29.         length of hunk. (Default is not to produce a map.)
  30.  
  31. [-X]        Excludes the hunk map from memory image.  This option is
  32.         used to save memory (e.g. ROMs), but it requires that you
  33.         use the -M option in order to do any debugging.
  34.  
  35.                 Note:  When using the resulting srecord file, the starting
  36.                 address of the code is not the same as the starting address
  37.                 in memory unless the -X option is used.  When you download
  38.                 the file with the Amiga debugger's LOAD command, the starting
  39.                 address will be printed.  Make sure you use the starting
  40.         address for your GO command.
  41.  
  42. [-S]        Suppresses same length.  Writes the srecords with the last
  43.         srecord having the exact length specified.  (Default is to
  44.         zero pad the last srecord to have the same length as the
  45.         others.)
  46.  
  47. [-B <Ksize>]    Specifies the decimal number of kilobytes ABSLOAD is to use
  48.                 to build its memory image of the file. Default for the Amiga
  49.                 is 16 Kbytes.
  50.  
  51. [-O <sfile>]    Writes srecords to <sfile>.  (Default is file 'a.srec.')
  52.  
  53. [-T <addr>]    Specifies byte address in hexadecimal for ABSLOAD to begin
  54.         allocating memory for the absolute binary form.  The address
  55.         must be long word aligned.  (Default is hex 20000.)
  56.  
  57. [<lfile>]    Specifies the file, created by ALINK, that is to be
  58.         converted.  If no file is specified, the standard input is
  59.         used.
  60.  
  61. A brief synopsis of the options, along with an error message, is printed if
  62. the correct syntax is not followed.
  63.  
  64. For debugging purposes:  If you did not use the -M option and the -X option,
  65. and you need to know the address of a hunk, it can be found at your memory
  66. starting address plus four times the hunk number.  Hunk numbers start from
  67. zero.
  68.  
  69. With the map produced from ALINK and the map produced from ABSLOAD, you
  70. should be able to determine the location of all externals.  Note that
  71. PRINTA's and ALINK's maps number hunks starting at 1.  ABSLOAD numbers hunks
  72. starting at 0.
  73.  
  74. See Also:    ALINK, PRINTA
  75.  
  76. Bugs:        Does not handle overlays.
  77.