home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 2 / agavol2.iso / software / utilities / wb_tools / vmm / contrib / bustrap.lha / bustrap.doc < prev   
Text File  |  1994-11-24  |  5KB  |  138 lines

  1.  
  2.  
  3.  
  4.                           BusTrap  Release Version 1.0
  5.  
  6.                         Copyright 1994 Stefan Huelswitt
  7.                               All rights reserved
  8.  
  9.  
  10.  
  11. 0. Disclaimer
  12. =============
  13.  
  14. I hereby reject any liability or responsibility for these or any other
  15. consequences from the use of BusTrap whatsoever.  This includes, but is not
  16. limited to, damage to your equipment, to your data, personal injuries, financial
  17. loss or any other kinds of side effects.
  18.  
  19. Although BusTrap has been tested thoroughly on my machine, I cannot rule out the
  20. possibility that BusTrap
  21.  
  22.     o is somehow incompatible to your equipment
  23.     o has bugs that show up on your equipment
  24.     o does not do what it is supposed to do on your equipment
  25.  
  26. It is your responsiblity to take any precautions necessary to protect yourself
  27. against these or any other effects.  I explicitly reject any liability or
  28. responsibility from the consequences of you using BusTrap.
  29.  
  30.  
  31.  
  32. 1. Copyright
  33. ============
  34.  
  35. This software is provided as is.  Bug reports and suggestions for improvement
  36. are welcome, and every effort will be made to evaluate such reports.
  37.  
  38. BusTrap is freely distributable provided no fee other than a moderate fee for
  39. disk copying charges is made for its acquirement.  It may be distributed across
  40. any electronic network, provided no fee is charged specifically for it's
  41. download.  A broad-based download fee is acceptable provided it is charged
  42. universally for all such file downloads.  All associated files included with the
  43. distribution archive of BusTrap are to remain intact and unaltered.  BBS listing
  44. notices and the like may be included in the archive provided no alterations are
  45. made to the actual distribution files themselves.
  46.  
  47. This program, and all accompanying files are not public domain.  They are
  48. copyrighted material and may not be used for commercial purposes without
  49. permission from the author.  The author must be contacted before any
  50. distribution with a commercial product.
  51.  
  52. BusTrap is not shareware, as no donation or usage fee is required.  However, any
  53. donations are always appreciated, and can only encourage further development of
  54. the program.
  55.  
  56. Explicit permission is given to Martin Apel to include this tool into the
  57. distribution of VMM.
  58.  
  59.  
  60.  
  61. 2. Introduction
  62. ===============
  63.  
  64. Starting with version 2.0 of the great program VMM, you can start to use virtual
  65. memory on every 030 equiped Amiga, too.  Due to the fact that VMM uses 4kbytes
  66. pages and Enforcer uses 256bytes pages, it is impossible to run VMM and Enforcer
  67. together (you may run Enforcer before starting VMM, but it's effects are
  68. canceled on startup of VMM).  As VMM passes all page faults located outside the
  69. virtual memory space to the underlying bus error handler, all badly written
  70. software (mostly commercial) that does random memory accesses, constantly causes
  71. bus errors that lead to 80000002 gurus.
  72.  
  73. To correct this annoying fact, I wrote a small program that installs a custom
  74. bus error handler.  All page faults that are passed from VMM are trapped.  Write
  75. faults are simply canceled and read faults are returned with a value of zero.
  76. Page faults that are caused by software trying to run code outside the virtual
  77. memory area are passed to the system guru.
  78.  
  79.  
  80.  
  81. 3. Usage
  82. ========
  83.  
  84. To work correctly BusTrap _must_ always be started before VMM.
  85.  
  86. Just type 'BusTrap' from the CLI.  The program will install the handler (<100
  87. bytes) and exit immediately.  In the current version there is no protection
  88. against running BusTrap multiple times.  There is no way to remove the handler,
  89. except from rebooting.
  90.  
  91. It makes no sense to run BusTrap together with Enforcer, but if you like to do
  92. so, BusTrap must be the first program to be started.
  93.  
  94.  
  95.  
  96. 4. Credits
  97. ==========
  98.  
  99. I have some people to thank for their assistance in the development of BusTrap.
  100.  
  101.     Martin Apel
  102.         For making the greatest virtual memory manager on the Amiga and for
  103.         supplying me with so much information about the stack frames.
  104.  
  105.     Commodore
  106.         For creating this wonderful computer ;-)
  107.  
  108.  
  109.  
  110. 5. The Author
  111. =============
  112.  
  113. Send bug reports, suggestions, comments and donations to:
  114.  
  115.    Stefan Huelswitt
  116.    Birtener Strasse 5a
  117.    46487 Wesel
  118.    Germany
  119.  
  120. I'm also reacheable by e-mail under the following accounts.  If you have
  121. access to e-mail, this should be the preferred way to contact me.
  122.  
  123.    huels@ftl.uni-duisburg.de      - university account, preferred for international
  124.                                     mail, but sometimes read only once a week.
  125.  
  126.    nathan@mountain.gun.de         - home account, polled daily, but a bit slow and
  127.                                     unreliable for international mail.
  128.  
  129. These accounts may change or become unavailable at any time in the future without
  130. further notice.  I always reply to every mail I get, so if you don't get a reply
  131. within a week (or two), chances are good that your mail got lost somewhere on
  132. the net.
  133.  
  134.  
  135.  
  136. 6. End
  137. ======
  138.