home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 5 / CD_Magazyn_EXEC_nr_5.iso / Recent / dev / moni / HunkFunc.readme < prev   
Text File  |  2001-06-11  |  4KB  |  106 lines
  1. Short:    V1.13 display executable file structure
  2. Author:   stoecker@epost.de (Dirk Stoecker)
  3. Uploader: stoecker@epost.de (Dirk Stoecker)
  4. Version:  1.13
  5. Type:     dev/moni
  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.  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. SHOWOVERL. display data of overlay table
  33. STATS      show short statistics about file
  34.  
  35. Example output:
  36. File 'C:AddDataTypes':
  37. HUNK_HEADER
  38.   Numhunks =         2 (0 to 1)
  39.   Hunk 000 =      5560 ($0015B8) Bytes
  40.   Hunk 001 =       160 ($0000A0) Bytes
  41.  
  42. HUNK_CODE         5560 ($0015B8) Bytes
  43. HUNK_RELOC32
  44.   Summary            5 entries to hunk 1
  45. HUNK_END
  46.  
  47. HUNK_DATA          160 ($0000A0) Bytes
  48. HUNK_RELOC32
  49.   Summary           14 entries to hunk 0
  50. HUNK_END
  51.  
  52. - First line shows program name.
  53. - HUNK_HEADER is the first hunk of an executable and lists all the hunks.
  54.   There may be additionally comments like CHIP, FAST, ADVISORY or MEMTYPE.
  55. - HUNK_CODE and HUNK_DATA store information.
  56. - HUNK_BSS store memory space, which is filled with 0 on startup.
  57. - HUNK_RELOC32 (and other types) hold relocation information.
  58. - HUNK_END ends an hunk entry.
  59. - In HUNK_CODE, HUNK_DATA and HUNK_BSS the memory flags may be repeated
  60.   in first or second longword. The flags is displayed normally when in
  61.   second longword (size) and preceeded by a '_' (e.g. _CHIP), when in
  62.   first longword (hunk type).
  63. - HUNK_DREL32EXE is in real a HUNK_RELOC32SHORT which uses wrong ID due
  64.   to a bug in OS V37.
  65.  
  66. A lot more information about executable or object file format can be found
  67. in:
  68.  
  69.                 The Amiga Guru Book
  70.                 ©1989,1993 by Ralph Babel
  71.                 Taunusstein 1993
  72.  
  73. If HunkFunc prints a line like "HUNK_??? ($xxxx) - Aborting!", please
  74. contact me and send an example file (if the file is a correct one).
  75.  
  76. Use this tool as you want, but WITHOUT ANY WARRANTY!
  77.  
  78. Contact me at:
  79.  
  80. *********************************************************************
  81. * snail-mail:                  * e-mail:                            *
  82. *   Dirk Stoecker              *   stoecker@epost.de                *
  83. *   Geschwister-Scholl-Str. 10 *   dirk@dstoecker.de                *
  84. *   01877 Bischofswerda        * world wide web:                    *
  85. *   GERMANY                    *   http://www.dstoecker.de/         *
  86. * phone:                       * pgp key:                           *
  87. *   GERMANY +49 (0)3594/706666 *   get from WWW pages or keyservers *
  88. *********************************************************************
  89.  
  90. Following is my PGP signature for the corresponding LhA-File.
  91. Use ' pgpv HunkFunc.readme -o HunkFunc.lha ' to check it.
  92. Key fingerprint: B9 F2 3A 1A 29 02 75 16  6A C6 5B 7D 5E F6 16 CF.
  93. All my releases after April 2001 have a PGP signature with this key.
  94. Be alarmed if signature is missing or wrong.
  95.  
  96. -----BEGIN PGP SIGNATURE-----
  97. Version: PGPfreeware 5.0i for non-commercial use
  98. MessageID: y3Z15ohoj1G1XSoKcWKw7hqHsSCsHVzo
  99.  
  100. iQCVAwUAOxvdWLOTsAT/iOY9AQFOHQQAu0uPmh4Rw4DwgEDZ3Q1aP3LdYyiQp0kh
  101. Wv6jMlCILalBy8T4TMTjnSUT6k7qiIlewGWwLzxzOw7hydz9XLyTjXHpFQuTQucR
  102. 8GQkWk7aAoXgvOnzuWYYRYXbmjLfViVq116pc8lNyveX0kOmZPnPlfnD21To0GXc
  103. edfF09jxCvQ=
  104. =1vDo
  105. -----END PGP SIGNATURE-----
  106.