home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d01xx / d0197.lha / FixHunk / FixHunk.doc < prev    next >
Text File  |  1989-03-28  |  3KB  |  74 lines
  1.                    FixHunk 2.1            7/26/87
  2.  
  3. FixHunk -- This program will modify executable files to allow them to run
  4. in external memory.
  5.  
  6.   The Amiga loader (since ver 1.1) will try to load both CODE and DATA hunks
  7. into FAST ram if available.  This causes problems with programs that use
  8. data structures that must be in CHIP ram.  Commedore/Amiga provides the
  9. ATOM utility to developers which allows them to modify object code to
  10. specify where hunks will load, but ATOM works only on object modules.
  11.  
  12. What about all the existing programs available only in executable form?
  13.  
  14. FixHunk is the answer.  It works on executable files.  It forces all
  15. DATA and BSS hunks in the file to be loaded into CHIP memory.  CODE hunks
  16. will still load into FAST ram if available.  There is no way to determine
  17. which specific DATA hunk should reside in CHIP ram, so FixHunk places them
  18. all there.
  19.  
  20. Usage:  FixHunk {-vi} filename   where -v produces verbose output
  21.                                        -i enters interactive mode
  22.  
  23. FixHunk modifies the executable file IN PLACE, so don't modify an original
  24. file.  Only modify a copy.
  25.  
  26. ----------------
  27.  
  28. Changes with version 2.0
  29.  
  30.    Will now handle overlays.
  31.  
  32.    Interactive mode added with  -i switch.
  33.       The interactive mode allows you to select where each DATA or BSS hunk
  34.    will load into memory.
  35.       You may select either CHIP, FAST or PUBLIC (either).  You will be
  36.    prompted for each DATA and BSS hunk as follows:
  37.  
  38. Hunk #nnn:  (W-Type)  sssss  [C/P/Q/]?
  39.  
  40.    where:
  41.          nnn    is a hunk counter (for reference purposes only).
  42.          W      is P,C or F.  Shows Where the hunk currently loads.
  43.          Type   is DATA or BSS -- shows hunk type.
  44.          ssss   is the size of the hunk in bytes.
  45.  
  46.    You may reply:
  47.       C or c    to make the hunk load into CHIP ram.
  48.       P or p    to make the hunk public - loads into FAST if available.
  49.       F or f    to make the hunk load into FAST ram only. (not recommended)
  50.       <CR>      leave alone.  Do not modify loader code.
  51.       Q or q    to exit interactive mode for this module.
  52.  
  53.    If you use the Q option to exit the interactive mode, the remaining
  54.    DATA and BSS hunks in the module will not have their loader codes
  55.    modified.  Interactive mode will resume at the next hunk header.
  56.  
  57. ------------------------
  58. Changes with version 2.1
  59.       There was a problem reported with the overlay support.
  60.  
  61.       Programs compiled with AC BASIC can now be processed.
  62.  
  63.       Added support for new hunk types proposed by the Software
  64.    Distillery for their BLINK linker.  These types are
  65.    DRELOC32 (3F7), DRELOC16 (3F8) and DRELOC8 (3F9).
  66.  
  67.       This version no longer asks for permission to load an entire
  68.    file image into CHIP ram -- it simply places it there.
  69.  
  70.       PUBLIC was changed to EITHER meaning either CHIP or FAST ram.
  71.  
  72. D.J.James
  73.  
  74.