home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 5 / memwatch / memwatch.doc < prev    next >
Encoding:
Text File  |  1994-01-27  |  3.8 KB  |  81 lines
  1. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  2. /* |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved */
  3. /* |. o.| || This program may not be distributed without the permission of   */
  4. /* | .  | || the authors.                                                    */
  5. /* | o  | ||    Dave Baker    Ed Burnette        Stan Chow         BBS:      */
  6. /* |  . |//     Jay Denebeim  Gordon Keener      Jack Rouse   (919)-471-6436 */
  7. /* ======       John Toebes   Mary Ellen Toebes  Doug Walker                 */
  8. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  9.  
  10. MemWatch by John Toebes © 1986 The Software Distillery.  All Rights Reserved
  11.  235 Trillingham Ln, Cary, NC 27511
  12.  
  13. Contributions to continue development of this and other fine products for the
  14. Amiga should be sent to the Software Distillery at the above address.
  15.  
  16. Other Products produced by the Software Distillery are:
  17.    BLINK     - the Turbo-charged Alink replacement
  18.    POPCLI II - Screen saver and Pop up CLI hotkey
  19.    HACK      - The Amiga port of the famous UNIX game
  20.    MAKE      - A software development tool one shouldn't be without
  21.    KERMIT    - The World renown file transfer protocol brought to the Amiga
  22.    ICONEXEC, SETALTERNATE, SETWINDOW - Icon manipulation tools
  23.    WBRUN     - A tool to run active workbench icons from CLI
  24.    TSIZE     - A short utility for determining directory sizes.
  25. All of these are available on our BBS.
  26.  
  27. Permission is hereby granted to distribute this program provided both this
  28. documentation accompanies the executable and that no charge is made for its
  29. distribution.  Contributions to the Distillery are encouraged.  If you wish
  30. to include this program in a comercial product, contact us first.
  31.  
  32. MemWatch is a program intended to sit in the background and watch for
  33. random trashing of low memory by an application under development.
  34. If it detects a write to low memory, it repairs it to what used to be there,
  35. then puts up a requester indicating what damage had been done.
  36.  
  37. There is no guarentee that this program will catch all trashes (particularly
  38. those to location 4) or that it will always be able to repair the trash in
  39. time.  All is dependent upon how often it gets run and how much damage has
  40. been done.
  41.  
  42. The syntax to invoke MemWatch is:
  43.    RUN MemWatch [<n>]
  44.  
  45. Where <n> is the optional number of microseconds between memory checking.
  46. It defaults to 5000 with a lower limit of 20.  Note that in reality, any
  47. value less than 20000 is not likely to have a great difference because the
  48. task switching occurs about every 20miliseconds.
  49.  
  50. When a memory trash occurs, it will put up a small alert of the form:
  51. ||======================================================================||
  52. ||     Someone stomped on low memory $aaaaaaaa with $dddddddd cccc!     ||
  53. ||              Press either mouse button to continue.                  ||
  54. ||======================================================================||
  55. where $aaaaaaaa is the address that got trashed, $dddddddd is the value
  56. that someone tried to sneak into there and cccc are the ASCII characters
  57. coresponding to that data.
  58.  
  59. MemWatch can be terminated by breaking the task that is running under.
  60. For example if it is task #3, then the command:
  61.   Break 3 ALL
  62. should cause it to quit.
  63.  
  64. MemWatch is not intended for the casual user.  It is useful as a debugging
  65. assist in developing an application program to catch wild pointers 
  66. (especially referencing through a NULL pointer).
  67.  
  68.  
  69. Supressing the Copyright message:
  70.    RUN MemWatch >NIL:
  71.  
  72. Known Bugs:
  73.   None so far...
  74.  
  75. How it works:
  76.   MemWatch saves a copy of the first 100 bytes of memory in it's own space.
  77. Then every after the specified number of micro seconds, it compares what
  78. is there with what it has in its copy.  If they differ, it patches up
  79. low memory with what it has and then puts up an alert indicating the
  80. offending values.
  81.