home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / READMEs / Peanuts-U / OpenStep / developer / resources / CrashTrap.1.6.README next >
Encoding:
Text File  |  1998-03-08  |  2.7 KB  |  56 lines
  1. OEObject 1.6
  2. An OPENSTEP Crash Trap
  3.  
  4. Art Isbell
  5. arti@lava.net
  6. 30 Nov 1997
  7.  
  8. Description
  9.  
  10.     OEObject is a free NSObject class poser that is designed to trap several types of
  11. application errors that would normally lead to an abnormal termination.  These errors include
  12. various fatal signals, messages sent to freed objects, and messages that aren't recognized by
  13. the receiver.  OEObject can be used to log a stack backtrace to help identify a programming
  14. error even when a process isn't run under gdb.  It can also be used to prevent the process
  15. from crashing thus allowing the user to try to continue or to gracefully exit the process,
  16. possibly saving changes, instead of the process just disappearing or the dreaded Dr. Watson
  17. (Windows) rearing its ugly head. 
  18.  
  19.     OEObject was originally a NEXTSTEP class called ObjectError which morphed into
  20. HKCrashTrap, at least one commercial crash catcher, and possibly other versions, but it has
  21. now been ported to OPENSTEP as OEObject.  During the porting process, the stack backtrace
  22. message was reformatted to provide a little better info about method arguments.  Support for
  23. Windows exceptions and end-of-line characters was also added. 
  24.  
  25. Usage
  26.  
  27.     Add OEObject to an app or tool project or to the project of a framework that is loaded
  28. by apps and tools.  Send OEObject a setup message early in the process' execution.  If you
  29. want the process to try to continue execution after a normally fatal error has occurred, send
  30. OEObject a setContinueAfterError: message with YES as its argument.  If you want to provide
  31. users with an indication that a crash condition has occurred, then catch the exception raised
  32. by OEObject and implement the user alert in the exception handler. 
  33.  
  34.     Several defaults variables are provided to adjust the number of function arguments
  35. printed (default is 4), the maximum number of frames printed in the backtrace (default is 50),
  36. and the maximum argument description length printed in the backtrace (default is 255 bytes). 
  37.  
  38.     The names of the exception and the defaults variables are returned by OEObject methods
  39. to avoid problems passing global constants in the Windows environment. 
  40.  
  41.     When OEObject isn't configured to continue execution after a fatal error, a crash
  42. backtrace is printed by NSLog().  Under Windows NT, backtraces are printed in the Application
  43. event log which is viewable using Event Viewer. 
  44.  
  45.     An example project, CrashTrap, is included.  This was ported to OPENSTEP from the
  46. HKCrashTrap distribution. 
  47.  
  48.  
  49. Known Problems
  50.  
  51.     Using OEObject with gdb can be problematic because OEObject can intercept signals that gdb
  52. uses to break on errors.  Using a defaults variable to turn off OEObject during a debugging
  53. session is a convenient solution. 
  54.  
  55.     No support for PowerPC is included.
  56.