home *** CD-ROM | disk | FTP | other *** search
/ Windoware / WINDOWARE_1_6.iso / winutil / wrip143 / winrip.doc next >
Text File  |  1991-06-27  |  4KB  |  103 lines
  1. Windows RIP Handler.
  2. ====================
  3.  
  4. The RIP handler is a utility that intercepts FatalExit messages generated by
  5. the debugging version of Windows and displays them on a debugging screen.
  6. This is the same thing as OX.SYS will do for you. The difference is that
  7. this utility will also allow you to answer the "Abort, Break or Ignore?"
  8. question in protected mode. This cannot ox.sys currently do.
  9. This will probably save you some time avoiding a reboot and also the
  10. possibility to ignore more or less harmless errors.
  11.  
  12. The utility does not limit itself to FatalExits, it will intercept every
  13. OutputDebugString issued by any application.
  14.  
  15. This utility will only work in protected mode, so you definitely still
  16. need ox.sys for real mode stuff.
  17.  
  18. In addition to displaying the FatalExits the utility will also try to replace
  19. the exit code with a readable text string. So instead of seeing
  20.     "FatalExit code =  0x0007"  you will see
  21.     "FatalExit code =  Window handle not valid." which is somewhat nicer.
  22.  
  23. The utility will work in three different hardware configurations:
  24.  
  25.     1) Graphics card+Mono
  26.     2) 8514/a+VGA          (Currently limited to 25 lines)
  27.     3) Graphics card only
  28.  
  29. In the third alternative the FatalExits are redirected to the same display
  30. as where Windows run. The second alternative is probably not limited to the
  31. 8514/a but will work with any card that can coexist with a VGA. I haven't
  32. tested anything else though.
  33.  
  34. The selection of the setup is done by editing the winrip.ini file.
  35.  
  36. The easiest way of installing this is to specify "load=winrip" in WIN.INI. It
  37. will display a logo string upon installation. Note that it will not check
  38. if you have the appropriate hardware, so you have every chance of making it
  39. fail.
  40.  
  41. All the usual disclaimers about functionality but it has been used
  42. successfully for some time now. (Tested mostly on Compaqs and a few PS/2s).
  43.  
  44. Windows RIP Handler, version 1.4
  45. ================================
  46.  
  47. This version will also catch UAEs (General Protection Faults or Trap D) and
  48. display the same kind of stack dump as a normal RIP does. It will also give
  49. you the same three choices "Abort, Break or Ignore?". The main purpose with
  50. this feature is to display a stack trace in order to simplify tracing down
  51. the bug, instead of simply receiving the UAE message box. In addition this
  52. feature actually allows you to ignore a GP fault although not really
  53. recommended since all sorts of weird things may happen.
  54.  
  55. This is currently only supported in 386 Enhanced Mode. Standard mode was a
  56. a lot trickier than I thought (In theory it should be the same as 386
  57. Enhanced mode, but...)
  58.  
  59. It is implemented in the way that WinRIP skips the offending instruction and
  60. simply tries the next one. This may result in numerous GP faults. One draw
  61. back with letting WinRIP handle the UAEs is that there is currently no easy
  62. way to terminate the app, either you ignore the UAE or abort your Windows
  63. session. I'll try to fix that in a subsequent release.
  64.  
  65.  
  66. Windows RIP Handler, version 1.41
  67. =================================
  68.  
  69. Bug fixed that would cause FatalExit = 0x506 to show up as a GP fault. In
  70. fact I was generating the GP fault inside the RIP handler.
  71. Bug fixed that prevented a Windows real mode session to be terminated.
  72. WinRIP is loaded even in real mode but is inactive. Optionally I could
  73. refuse to load in real mode, but that will produce an 'Application Execution
  74. Error' from progman.
  75.  
  76. You may now also instruct WinRIP to interpret 'Break' as 'kill this
  77. application' thus allowing you to get rid of the current app without having
  78. to terminate Windows (either on a RIP or a UAE). This is configurable through
  79. the winrip.ini file. Removes restriction in 1.4.
  80.  
  81.  
  82. Windows RIP Handler, version 1.42
  83. =================================
  84.  
  85. Fixed bug that would in low memory situations cause WinRIP to lose control
  86. over FatalExits. This did only happen if you also ran cvw along the way.
  87.  
  88.  
  89. Windows RIP Handler, version 1.43
  90. =================================
  91.  
  92. Fixed GP trap handling in standard mode. Also added the RIP code to the
  93. displayed string so you will see both the string and the actual code when
  94. a RIP occurs.
  95.  
  96. Enjoy!
  97.  
  98.  
  99. Anders Thun, Prosoftia AB.
  100.  
  101. bix: athun
  102. CIS: 72331,2560
  103.