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