home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 122 / af122sub.adf / MemorySnooper.lzx / MemorySnooper / MemorySnooper.doc < prev    next >
Encoding:
Text File  |  1999-01-25  |  7.0 KB  |  255 lines
  1.                               MemorySnooper
  2.                               -------------
  3.  
  4. Author:
  5.                      Przemyslaw `SENSEI` Gruchala
  6.  
  7.                          os.Sportowe 19/4
  8.                            Krakow 31-966
  9.                               POLAND
  10.  
  11. Distribution
  12. ------------
  13.  
  14. MemorySnooper is SHAREWARE program.If you often use and/or you want to
  15. remove an awful requester which demand registration you should send on
  16. my address:
  17.  
  18. - for registration (first time) $15 (fifteen US dolars).
  19.  
  20. - for upgrade (for registered users) most probably $10-12
  21.   (I`ll know how much after writing next version).
  22.  
  23. - floppy disk or $2.
  24.  
  25. - return envelope or normal plus mail charge.
  26.  
  27. You should write on envelope in visible place:
  28.  
  29. - first name and surname
  30.  
  31. - address with your country obviously.
  32.  
  33. - name of program that you want to register and it version,
  34.   (if you don`t write version I`ll send you latest version).
  35.  
  36. MemorySnooper
  37. MemorySnooper.info
  38. MemorySnooperPL.doc
  39. MemorySnooperPL.doc.info
  40. MemorySnooper.doc
  41. MemorySnooper.doc.info
  42. MemorySnooper.cd
  43. MemorySnooper.ct_polski
  44. Catalogs/Polski/MemorySnooper.catalog
  45.  
  46. Any change in these files are forbid.
  47.  
  48. Distribution of registered version without my writed permission is inadmis-
  49. sible,immoral,illegal and forbidden.
  50.  
  51. Requirements
  52. ------------
  53.  
  54. MemorySnooper require:
  55. - KickStart v2.0+.
  56. - commodities.library v36.
  57. - gadtools.library v36.
  58. - lot of free memory.
  59.  
  60. Recommended:
  61. - reqtools.library
  62. - diskfont.library
  63. - locale.library
  64.  
  65. MemorySnooper correct work with:
  66. MultiCX v2.62,
  67. ToolsDaemon`em v37.45,
  68. CycleToMenu v37.6,
  69. MagicMenu v1.27,
  70. TRTPatch v1.2
  71.  
  72. To what you can use it
  73. ----------------------
  74.  
  75. Fundamentaly,MemorySnooper is a program for programmers and using it for
  76. other purposes than debugging is rather without sense (but ofcourse you can).
  77.  
  78. This program graphicaly traces using memory by programs and operating system.
  79. This is adequate to SnoopDos but with relation to memory.
  80.  
  81. MemorySnooper for purpose of tracing memory installs patch on Exec functions:
  82. AllocMem() and FreeMem().Therefor programs that ingerate on this functions
  83. may make problems during working with MemorySnooper.
  84.  
  85. I noticed that MemorySnooper don`t like powerpacker.library v36.10 (other
  86. versions I hadn`t tested,but I suspect that they won`t work well too).
  87.  
  88. Most probably every program which are using powerpacker.library (eg.FileMaster,
  89. DirectoryOpus) will be locking possibility of quiting MemorySnooper.Therefor
  90. for avoiding that you should first load powerpacker.library to memory and
  91. then start work with MemorySnooper.
  92.  
  93. Program PowerPacker v4.0 with MemorySnooper in the background during quit
  94. will be crashing computer.
  95.  
  96. MemorySnooper have been writen on CygnusED v4.2,
  97. and compile in AmigaE v3.2a/v3.1i on computer:
  98.  
  99. Amiga 500,1 MB CHIP,4 MB FAST,000 7 MHz,HDD 850 MB,
  100. KickStart v2.04 (37.175),Workbench v2.1 (38.35)
  101.  
  102. and tested on:
  103.  
  104. Amiga 600,1 MB CHIP,4 MB FAST,020 28 MHz,
  105. KickStart v2.05 (37.299),Workbench v2.0 (37.71)
  106.  
  107. Amiga 1200,2 MB CHIP,4 MB FAST,020 14 MHz,HDD 850 MB,
  108. KickStart v3.0
  109.  
  110. MemorySnooper v0.3 work fine in AmigaShow`98 on computers:
  111.  
  112. Amiga 1200,2 MB CHIP,64 MB FAST,040 40 MHz,
  113. KickStart v3.1 (40.x),Workbench v3.1
  114.  
  115. Amiga 1200,2 MB CHIP,64 MB FAST,060 50 MHz,
  116. KickStart v3.1 (40.x),Workbench v3.1
  117.  
  118. Preferences
  119. -----------
  120.  
  121. In MemorySnooper v0.2 beta you can set preferences only in ToolTypes of
  122. icon MemorySnooper.
  123.  
  124. ToolTypes`y:
  125. In place digit parameter you write number in format Val() of AmigaE.
  126. In place string parameter you write string without commas.
  127.  
  128. Format: NAME - TYPE - DEFAULT
  129.  
  130. CX_POPUP - YES/NO - YES
  131. CX_PRI - from -128 to 127 - 0
  132. CX_POPKEY - string - shift alt m
  133. Set Commodity parameters v0.3
  134.  
  135. TASK_NAMELENGTH - digit - 32
  136. Length of name of program who will be allocated with message from patch and
  137. create a chunk with information about allocated memory.
  138. You can decrease consumption memory of MemorySnooper if you use this ToolType.
  139.  
  140. BEEP_MODE - YES/NO - YES
  141. This ToolType tell: during error or important information appears a sound.
  142.  
  143. ABOUT_MODE - YES/NO - YES
  144. This ToolType tell: during starting work appears an information about author
  145. and program.
  146.  
  147. QUIT_MODE - ASK/IMMEDIATE - ASK
  148. Method of quiting of MemorySnooper: Asks you about quiting or quits immediately.
  149.  
  150. APP_MODE - NONE/ICON/WINDOW/INVISIBLE - ICON
  151. Method of hiding of MemorySnooper: none/icon/window or invisible.
  152.  
  153. APP_PUBSCREENMODE - DEFAULT/PUBSCREEN - PUBSCREEN
  154. Mode of hiding in window hide method: default or public screen of main window.
  155.  
  156. APP_ICON - string - ENV:MemorySnooper/def_App
  157. Path to icon in icon hide method.
  158.  
  159. LOG_MODE - OVERWRITE/APPEND - OVERWRITE
  160. Mode of loging: overwrite/append (overwrite should be used if output of
  161. loging is PRT:).
  162.  
  163. LOG_INFOMODE - YES/NO - YES
  164. This ToolType tell: append a appendix information during loging.
  165.  
  166. LOG_FILENAME - string - PRT:
  167. Path to file or device to which you want loging.
  168.  
  169. FONT_TYPE - DEFAULT/SCREEN/CUSTOM - SCREEN
  170. Type of font on the gadgets: default(Topaz/8)/screen/custom.
  171. If you set type to custom you should also set:
  172.  
  173. FONT_NAME - string - Topaz.font
  174. Name of font (with suffix .font)
  175.  
  176. FONT_YSIZE - digit - 8
  177. Size of font (size not existing on the disk will be create).
  178.  
  179. FONT_STYLE - digit - 0
  180. Mask of style (you must look to docs and/or to includes).
  181.  
  182. ToolTypes LISTFONT_* have the same meaning as FONT_* but referes to list
  183. of information about memory.
  184. Attention: font must have the same horisontal size (eg.Topaz/8)
  185.  
  186. PUBSCREEN_NAME - string - Workbench
  187. Name of public screen on which appears main window of program.
  188.  
  189. WINDOW_X/Y/WIDTH/HEIGHT - digit - 0/0/scaled to size of font
  190. Set position and size of main window.
  191.  
  192. ToolTypes PREFSWINDOW_* have the same meaning as WINDOW_* but referes to
  193. window of preferences.
  194.  
  195. Bugs
  196. ----
  197.  
  198. Conflict with powerpacker.library and PowerPacker v4.0.
  199.  
  200. Libraries and operation system sometimes allocates and don`t frees memory
  201. therefor may happen we will see ALLOC/LOST in field of type of memory.
  202.  
  203. Freing the memory that is used to patch or other data added to system (eg.
  204. ports,semaphores,windows,screens etc.) may be cause of crashing the computer.
  205. Therefor you shouldn`t uses MemorySnooper to other purposes than debugging
  206. programs.
  207.  
  208. If you find a bug or program who don`t work correctly with MemorySnooper
  209. or you have a good idea give me a sign.
  210.  
  211. History
  212. -------
  213.  
  214. Version 0.2 beta
  215. ----------------
  216.  
  217. First release of MemorySnooper on the world.
  218.  
  219. Gadget PAUSE nonactive (for now).
  220.  
  221. Gadget PREFS nonactive (preferences you must set "by hand" in ToolTypes).
  222.  
  223. Gadget FREE nonactive (for now).
  224.  
  225. Date: 29.III.1998-5.V.1998.
  226.  
  227. Version 0.3/0.31 beta
  228. ---------------------
  229.  
  230. Second release of MemorySnooper.
  231.  
  232. Added:
  233. - commodities support.
  234. - menu (gadtools.library v36 required).
  235. - gadgets PAUSE/FREE and menu SELECT/UNSELECT disabled.
  236. - removed minor bugs (in rendering functions,in locale and others).
  237.  
  238. Date: 19.VI.1998/24.VI.1998
  239.  
  240. Future
  241. ------
  242.  
  243. Future of this program is in your hands.If I see a sense of expanding
  244. MemorySnooper (support by registrations and new ideas) you should expect:
  245.  
  246. - preferences set in program.
  247.  
  248. - ARexx port.
  249.  
  250. - save "session" of work MemorySnooper.
  251.  
  252. - set format in list and loging.
  253.  
  254. - include/exclude trace of chosen programs or tasks.
  255.