home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / hunkext.lha / HunkExtract.doc < prev    next >
Encoding:
Text File  |  1994-08-03  |  3.9 KB  |  137 lines
  1.              _______ /|   _______/\_______________    _____ 
  2.             /~ ____// | __\___  ~__~/  _____/~   ~\  /~ ¡ ~\.  
  3.            //  __)_// |/ ~\  /  :| //  __) //   .__)//  |  \\\
  4.            \\     ~\\ ~   \\/   || \\     ~\\   : \\\\      / \  
  5.             \  ____/\______/\____|  \  ____/\____ // \. |__/  /
  6.              \/ .____/\______/\_____|\/ .TeTSUo__\/ / \/ ____/
  7.               \/                      \/          \/   \/ 
  8.  
  9.                             The Hunk Extractor
  10.                             ==================
  11.  
  12. Instructions
  13. ------------
  14.  
  15.  
  16.     This program was developed originally to allow me to understand how
  17. AMIGA DOS stored it's exedcutable files. The program may not know all the
  18. AMIGA DOS hunk codes that are available but it does know the standard ones.
  19.  
  20.     The usage of the program is simplicity in it's self, all you need to
  21. do is type : 
  22.  
  23.   HunkExtract  File_Name
  24.  
  25.     Where File_Name is the name of the file you wish to extract the
  26. hunks from. Once the program is started it will quickly scan through the
  27. file and split it up in to it's relevant parts saving each part to the ram
  28. disk. There are Four types of file that will be saved to ram :
  29.  
  30.    Out.Code
  31.    Out.Data
  32.    Out.Relo
  33.    Out.Bss
  34.  
  35.     Each of these files is slightly different here is their explanation.
  36.  
  37. Out.Code
  38. --------
  39.  
  40.     This file name's format is :
  41.  
  42.    Out.Code_MemType-Hunk Number
  43.  
  44.     where MemType is either :  A - Anymem (Public Memory)
  45.                                C - Chip memory only
  46.                                F - Fast memory only
  47.  
  48.     Hunk number will not be a number it is instead a letter. A is the
  49. first hunk, B is the second hunk etc. The Hunk Number is the position of the
  50. code hunk in the main program and not the position in the code hunks.
  51.  
  52.     The contents of this file is simply the contents of the code hunk.
  53.  
  54. Out.Data
  55. --------
  56.  
  57.     This file name's format is :
  58.  
  59.    Out.Data_MemType-Hunk Number
  60.  
  61.     where MemType is either :  A - Anymem (Public Memory)
  62.                                C - Chip memory only
  63.                                F - Fast memory only
  64.  
  65.     Hunk number will not be a number it is instead a letter. A is the
  66. first hunk, B is the second hunk etc. The Hunk Number is the position of the
  67. code hunk in the main program and not the position in the code hunks.
  68.  
  69.     The contents of this file is simply the contents of the data hunk.
  70.  
  71. Out.Relo
  72. --------
  73.  
  74.     This file name's format is :
  75.  
  76.    Out.Data_MemType-Hunk Number-Hunk Number
  77.  
  78.     where MemType is either :  A - Anymem (Public Memory)
  79.                                C - Chip memory only
  80.                                F - Fast memory only
  81.  
  82.     Hunk number will not be a number it is instead a letter. A is the
  83. first hunk, B is the second hunk etc.
  84.  
  85.     The first Hunk Number is the code hunk that the relocation
  86. information belongs to and the second number is the hunk that is being
  87. referenced. For example if the following code was placed into Devpac :
  88.  
  89.             section    Program,code
  90.  
  91.         Main    move.l    SomeData,d0
  92.             rts
  93.  
  94.             section    Data,data_c
  95.  
  96.         SomeData
  97.             dc.l    1543
  98.  
  99.     Then if HunkExtract was used to split the program up, the following
  100. would be found in RAM.
  101.  
  102.     Out.Code_A-A
  103.     Out.Data_C-B
  104.     Out.Relo_A-A-B
  105.  
  106.     Out.Relo_A-A-B will now contain a single long word, this longword is
  107. the number 2. This number then tells you that at the offset of 2 from hunk A
  108. add the starting location of hunk B.
  109.  
  110.     The contents of this type of file is just a number of longwords.
  111.  
  112. Out.Bss
  113. --------
  114.  
  115.     This file name's format is :
  116.  
  117.    Out.Bss__MemType-Hunk Number
  118.  
  119.     where MemType is either :  A - Anymem (Public Memory)
  120.                                C - Chip memory only
  121.                                F - Fast memory only
  122.  
  123.     Hunk number will not be a number it is instead a letter. A is the
  124. first hunk, B is the second hunk etc.
  125.  
  126.     The contents of this type of file is a single longword this longword
  127. is the length of the bss hunk / 4.
  128.  
  129. Credits etc.
  130. ------------
  131.  
  132.     Coded by LeeCH / ELTECH.
  133.  
  134.     This program is freeware but is still ©1995 ELTECH.
  135.  
  136.     Hello's go to Jester,Mic Flair,Realitor of ELTECH and to any one else
  137.         who knows me.