home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 635.lha / Trap_v2.4 / Trap.doc < prev    next >
Text File  |  1992-03-17  |  5KB  |  131 lines
  1.  
  2.  
  3.  
  4.                         Trap V2.4 - the TrapHandler
  5.               Written 1992 by Tobias Abt and Alexander Kneer
  6.                          © 1992 by the same party
  7.                         This program is FreeWare !
  8.  
  9.  
  10. DISCLAIMER:
  11. -----------
  12.         We, the programmers, are in no way responsible of what Trap may do to
  13.         your system, so don't blame us for loosing your unsaved but precious
  14.         works due to inconveniences, although it runs safe on many systems.
  15.         Trap has been tested on these configurations:
  16.                 standard A500,
  17.                 A1000 with 5MB RAM,
  18.                 standard A2000,
  19.                 A2000 with 68030 accelerator board, 5MB RAM,
  20.                 A2000 with 68040 accelerator board, 12MB RAM,
  21.                 A3000 with 4-18MB RAM.
  22.         No specific errors occured using these systems, so we think it is quite
  23.         safe to use.
  24.  
  25.  
  26. OVERVIEW:
  27. ---------
  28.  
  29.         What is Trap?
  30.           - it is short,
  31.           - it is a utility,
  32.           - it can be runned from CLI or WorkBench,
  33.           - it is designed to catch system exceptions and display a requester
  34.             on the frontmost screen, allowing you to either suspend or remove 
  35.             the crashed process or reboot the system,
  36.           - it displays the CPU registers, allowing you to take a deeper look
  37.             on what went wrong, thus being a big help developing software ;-),
  38.           - it can be removed at any time,
  39.           - it doesn't override a private traphandler attached to a
  40.             task/process.
  41.  
  42.           - enforcer reported no hits using Trap.
  43.  
  44.  
  45. REQUIREMENTS:
  46. -------------
  47.  
  48.         Amiga with at least a few KBytes RAM left,
  49.         Kick 2.04 (V37)   (you don't have it? buy and install!)
  50.  
  51.  
  52.  
  53. INSTALLATION:
  54. -------------
  55.  
  56.         Place Trap anywhere, call it in the S:User-Startup or
  57.         put it in SYS:WBStartup.
  58.  
  59.  
  60. TECHNICAL:
  61. ----------
  62.  
  63.         Trap patches the Exec AddTask routine to install itself as the default
  64.         traphandler. It also patches the existing tasks and processes if the
  65.         default exec traphandler is installed to ensure that these also benefit
  66.         from Trap. 
  67.         If started again it checks first if it can be removed safely i.e. if no
  68.         one else has patched in front of Trap. If this is not the case, it will
  69.         only be deactivated waiting for reactivation.
  70.      
  71.         Trap is visible to other programs due to its public message port named
  72.         Traphandler. But don't try to send messages to that port - they won't be
  73.         processed and are lost until reboot.
  74.  
  75.         If a system exception occures, trap displays the CPU registers in a
  76.         EasyRequest with three possible actions to be taken:
  77.         Suspend, Remove or Reboot.
  78.         
  79.         If Suspend or Reboot is choosen, the same as with the standard system
  80.         requester happens: the task or process is suspended or the system will
  81.         be rebooted.
  82.         But if you happen to select Remove, Trap will close all windows with the
  83.         mp_SigTask of the wd_UserPort or wd_WindowPort set to the crashed task
  84.         or process and then it will attempt to close the screen.
  85.         After that, the stdout and stdin of the task will be closed, the current
  86.         directory is unlocked and the task structure with attached memory is
  87.         removed and freed, trying to return as much memory as possible to the 
  88.         system.
  89.         
  90.  
  91. KNOWN BUGS:
  92. -----------
  93.         
  94.         None yet ;^)
  95.         
  96. DISTRIBUTION:
  97. -------------
  98.  
  99.         Trap may be included with commercial programs as long as no money
  100.         is made by including it in the distribution (this also applies to
  101.         inclusion in AmigaDOS Enhancer kits, on Workbench/Extras disks or
  102.         A3x00 hard disk drives).
  103.         You must not make any money by distributing Trap. A small copy fee
  104.         for data media (3$ US maximum) or the inclusion of Trap in
  105.         Public-Domain collections such as Fred Fish's Amiga Library of Freely
  106.         Distributable Software is permitted though.
  107.  
  108.         
  109. BUG REPORTS and SUGGESTIONS:
  110. ----------------------------
  111.         
  112.         Send your bug reports (what went wrong and why and where and on which
  113.         hardware configuration) to:
  114.  
  115.  
  116.         Tobias Abt                  Alexander Kneer
  117.                             or
  118.         Bessererstr. 9              Schubertstr. 35
  119.         W7900 Ulm                   W7910 Neu-Ulm
  120.         Germany                     Germany
  121.  
  122.         No EMail addresses yet, sorry.
  123.  
  124.  
  125.  
  126. BY THE WAY:
  127. -----------
  128.  
  129.         Positive feedback is also accepted by us. You know the tale about rich
  130.         students?
  131.