home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 August - Disc 3 / chip_20018103_hu.iso / amiga / chiputil / hunkfunc.lha / HunkFunc / HunkFunc.readme < prev    next >
Encoding:
Text File  |  2001-06-23  |  3.6 KB  |  91 lines
  1. Short:    V1.14 display executable file structure
  2. Uploader: stoecker@epost.de (Dirk Stoecker)
  3. Author:   stoecker@epost.de (Dirk Stoecker)
  4. Type:     dev/moni
  5. Version:  1.14
  6.  
  7. This program allows you to display information about the structure of an
  8. Amiga executable file (or a link object). HunkFunc requires OS2.0 for work.
  9.  
  10. The first version of this program is made with help of HunkFunk utility
  11. made by Olaf Barthel. But as Olaf's utility misses a lot of hunks and
  12. other information, I made my own tool. This version knows a lot more
  13. possible configurations and is shorter, as it uses Amiga functions instead
  14. of ANSI-C.
  15.  
  16. Know hunk types are: HUNK_UNIT, HUNK_NAME, HUNK_CODE, HUNK_DATA, HUNK_BSS,
  17. HUNK_(ABS)RELOC32, HUNK_(REL)RELOC16, HUNK_(REL)RELOC8, HUNK_EXT, HUNK_SYMBOL,
  18. HUNK_DEBUG, HUNK_END, HUNK_HEADER, HUNK_OVERLAY, HUNK_BREAK,
  19. HUNK_DREL32, HUNK_DREL16, HUNK_DREL8, HUNK_LIB, HUNK_INDEX,
  20. HUNK_RELOC32SHORT, HUNK_RELRELOC32, HUNK_ABSRELOC16, HUNK_PPC_CODE,
  21. HUNK_RELRELOC26.
  22.  
  23. The File has following argument line:
  24. "FILE/M/A,SREL=SHOWRELOC/S,SSYM=SHOWSYMBOL/S,SEXT=SHOWEXTERN/S,
  25.  SEREF=SHOWEXTERNREF/S,SOVT=SHOWOVERLAYTABLE/S,STATS/S".
  26.  
  27. FILE       You must pass at least one file name, but may pass a lot more.
  28.            Patterns are not supported.
  29. SHOWRELOC  displays all reloc entries (there may be really much of them!)
  30. SHOWSYMBOL displays symbol names of HUNK_SYMBOL
  31. SHOWEXTERN displays definitions of HUNK_EXT
  32. SHOWEX-REF displays references of HUNK_EXT
  33. SHOWOVERL. display data of overlay table
  34. STATS      show short statistics about file
  35.  
  36. Example output:
  37. File 'C:AddDataTypes':
  38. HUNK_HEADER
  39.   Numhunks =         2 (0 to 1)
  40.   Hunk 000 =      5560 ($0015B8) Bytes
  41.   Hunk 001 =       160 ($0000A0) Bytes
  42.  
  43. HUNK_CODE         5560 ($0015B8) Bytes
  44. HUNK_RELOC32
  45.   Summary            5 entries to hunk 1
  46. HUNK_END
  47.  
  48. HUNK_DATA          160 ($0000A0) Bytes
  49. HUNK_RELOC32
  50.   Summary           14 entries to hunk 0
  51. HUNK_END
  52.  
  53. - First line shows program name.
  54. - HUNK_HEADER is the first hunk of an executable and lists all the hunks.
  55.   There may be additionally comments like CHIP, FAST, ADVISORY or MEMTYPE.
  56. - HUNK_CODE and HUNK_DATA store information.
  57. - HUNK_BSS store memory space, which is filled with 0 on startup.
  58. - HUNK_RELOC32 (and other types) hold relocation information.
  59. - HUNK_END ends an hunk entry.
  60. - In HUNK_CODE, HUNK_DATA and HUNK_BSS the memory flags may be repeated
  61.   in first or second longword. The flags is displayed normally when in
  62.   second longword (size) and preceeded by a '_' (e.g. _CHIP), when in
  63.   first longword (hunk type).
  64. - HUNK_DREL32EXE is in real a HUNK_RELOC32SHORT which uses wrong ID due
  65.   to a bug in OS V37.
  66.  
  67. A lot more information about executable or object file format can be found
  68. in:
  69.  
  70.                 The Amiga Guru Book
  71.                 ⌐1989,1993 by Ralph Babel
  72.                 Taunusstein 1993
  73.  
  74. If HunkFunc prints a line like "HUNK_??? ($xxxx) - Aborting!", please
  75. contact me and send an example file (if the file is a correct one).
  76.  
  77. Use this tool as you want, but WITHOUT ANY WARRANTY!
  78.  
  79. Contact me at:
  80.  
  81. *********************************************************************
  82. * snail-mail:                  * e-mail:                            *
  83. *   Dirk Stoecker              *   stoecker@epost.de                *
  84. *   Geschwister-Scholl-Str. 10 *   dirk@dstoecker.de                *
  85. *   01877 Bischofswerda        * world wide web:                    *
  86. *   GERMANY                    *   http://www.dstoecker.de/         *
  87. * phone:                       * pgp key:                           *
  88. *   GERMANY +49 (0)3594/706666 *   get from WWW pages or keyservers *
  89. *********************************************************************
  90.  
  91.