home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / useful / dist / cbm / v40 / devtools / docs / atom.doc < prev    next >
Text File  |  1993-05-13  |  3KB  |  90 lines
  1. ATOM
  2.  
  3. Format:         ATOM <infile> <outfile> [-I]
  4.                 or
  5.          ATOM <infile> <outfile> [-C[C|D|B]] [-F[C|D|B]]
  6.              [-P[C|D|B]]
  7.  
  8. Template:    ATOM "INFILE,OUTFILE,-I/K"
  9.              or
  10.          ATOM "INFILE,OUTFILE,-C/K,-F/K,-P/K"
  11.  
  12. Purpose:     To specify the portions of a program that should be loaded into
  13.              CHIP memory and/or FAST memory.
  14.  
  15. Specification:
  16.  
  17. ATOM is used to specify to the loader the portions of a program to be loaded
  18. into CHIP memory, FAST memory, and PUBLIC memory.  Some system structures
  19. (like Images) must be stored in CHIP memory to work.  Others can take
  20. advantage of the increased speed of FAST memory, while others can work in
  21. either.  Normally, the loader tries to use FAST memory first, if no other
  22. type (or PUBLIC) is specified.
  23.  
  24. You can compile or assemble a program, then pass the individual object
  25. modules through ATOM before they are linked to form a load file.  ATOM will
  26. flag the desired hunks (CODE, DATA and BSS) and place them in the specified
  27. type of memory (CHIP, FAST, or PUBLIC).
  28.  
  29. When using ATOM, <infile> represents an object file that has just been
  30. compiled, assembled or ATOMed.  <outfile> represents the destination for the
  31. converted file.  The options are as follows:
  32.  
  33. [-I]        operate interactively
  34. [-C]        change memory to CHIP
  35. [-F]        change memory to FAST
  36. [-P]        change memory to PUBLIC
  37. [C]        change CODE hunks
  38. [D]        change DATA hunks
  39. [B]        change BSS hunks
  40.  
  41.  
  42. ATOM ERROR MESSAGES
  43.  
  44. Error Bad Args:
  45.  
  46.     1. an option does not start with a "-".
  47.     2. wrong number of parameters.
  48.     3. "-" not followed by I, C, F or P.
  49.     4. -x supplied in addition to -I.
  50.  
  51. Error Bad Infile = file not found.
  52.  
  53. Error Bad Outfile = file cannot be created.
  54.  
  55. Error Bad Type ## = ATOM has detected a hunk type that it does not
  56. recognize; the object file may be corrupt.
  57.  
  58. Error Empty Input         = input file does not contain any data.
  59.  
  60. Error Read Externals         = external reference or definition if of an
  61.                   undefined type; object file may be corrupt.
  62.  
  63. Error Premature End of File = an end of file condition (out of data) was
  64.                   detected while ATOM was still expecting input.
  65.                   Object file may be corrupt.
  66.  
  67. Error This Utility can only be used on files that have NOT been passed
  68. through ALINK             = the input file you specified has already been
  69.                   processed by the linker; external symbols have
  70.                   been removed and hunks coagulated.  You need
  71.                   to run ATOM on the object files produced by
  72.                   the C compiler or Macro Assembler BEFORE they
  73.                   are linked.
  74.  
  75. Examples:
  76.  
  77. 1> ATOM infile.obj outfile.obj -pc -cdb
  78.  
  79. All code hunks go into Public RAM; data and BSS hunks go into chip RAM.
  80.  
  81. 1> ATOM infile.obj outfile.obj -c
  82.  
  83. All hunks in the object file are loaded into chip memory.
  84.  
  85. 1> ATOM myfile.o myfile.set.o -cd
  86.  
  87. Sets all data hunks to load into chip memory.
  88.  
  89. FOUND WITH: development tools
  90.