home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / dirs / enforcer_454.lzh / Enforcer / enforcer.doc < prev    next >
Text File  |  1991-02-14  |  2KB  |  69 lines
  1.  
  2. Enclosed is a majik tool for detecting invisible bugs in programs; _The
  3. Enforcer_ uses the MMU to build a shroud of protection over anything that
  4. is not legal memory.  Any "empty holes" in the address space are marked as
  5. illegal by _Enforcer_.    Reads of the system ROMs are allowed, but not
  6. writes.  With the exception of longword reads of location 4, the lowest 1K
  7. of memory is completely off-limits.
  8.  
  9. Enforcer runs on any Amiga or OS revision, as long a the MMU is not already
  10. in use.  This version of Enforcer also works on the A3000 under
  11. SuperKickstart (V1.3 or 2.0).  Under V1.3, enforcer requires SetPatch
  12. version 1.38 or later.
  13.  
  14. When an illegal access is detected, the power LED will flash and a detailed
  15. message will be sent out the serial port (at the default speed).  Illegal
  16. writes are aborted, illegal reads return NULL data.  For example:
  17.  
  18.  
  19.  
  20. Program Counter (approximate)= 783C460         Fault address        =DEADBEEF
  21. User stack pointer         = 7860ABC           DOS Proccess address = 7839F98
  22. Data: 00000001 01E0F0FB 00000FA0 0783AE18 00000001 01E0987F 01E0A93D 0783C3EC
  23. Addr: 0783AE18 0785FB28 07810114 0783C3EC 07860AC0 00F8F56A 00F8F55E 078021D0
  24. Status register =$8           Special status word =$729 (WRITE-WORD)
  25. Data output buffer  =$FFFFADEF (o)
  26. Process/CLI = Background CLI ,"lawbreaker"
  27. Hunk-O-Matic says: PC address is in hunk #0, near offset $70
  28.  
  29.  
  30.  
  31. CLI command "lawbreaker" has written the word value $ADEF to location
  32. $DEADBEEF.  The write was aborted.  With the information given, it is
  33. usually quite easy to figure out what went wrong.
  34.  
  35.  
  36.  
  37.  
  38. Remote keystrokes:
  39.         ^S    - pause.  You may have to press it more than once.
  40.         ^Q    - resume
  41.         ^X    - When in ^S, press ^X to suspend _Enforcer_ reporting.
  42.           Use ^Q to resume.
  43.  
  44.  
  45. Command line options:
  46.         on
  47.         fprotect    ;Same as on, but write protects $F00000-$F7FFFF
  48.         off
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55. Notes:
  56.  
  57.     If you don't have an external terminal, just use a modem & a terminal
  58.     program.  Most modems will echo back characters at any baud rate. Else,
  59.     just set the baud rate to match the modem.
  60.  
  61.     Illegal hits from CLI commands named "metascope" or "wack" are ignored.
  62.  
  63.     Rebooting an A3000 running Enforcer causes the SuperKickstart to be
  64.     reloaded from scratch next time you boot.  Some call this a feature.
  65.     This will, however, kill RAD:.  When enforcer is off, SuperKickstart is
  66.     not reloaded.
  67.  
  68.     The Alert() system call writes to locations in the $180-$1C0 area.
  69.