* gdbinv-s.texi (Debug Session): Document exceptionHook.
authorJim Kingdon <jkingdon@engr.sgi.com>
Wed, 9 Jun 1993 18:12:35 +0000 (18:12 +0000)
committerJim Kingdon <jkingdon@engr.sgi.com>
Wed, 9 Jun 1993 18:12:35 +0000 (18:12 +0000)
gdb/doc/ChangeLog
gdb/doc/gdbinv-s.texi

index 9643f727faa78aef4087b5c99b7932bbf3a52f76..780d479aca42602c054847a6c9df93ae47624eb6 100644 (file)
@@ -1,3 +1,7 @@
+Wed Jun  9 10:58:16 1993  Jim Kingdon  (kingdon@cygnus.com)
+
+       * gdbinv-s.texi (Debug Session): Document exceptionHook.
+
 Tue Jun  8 13:42:04 1993  Jim Kingdon  (kingdon@cygnus.com)
 
        * gdb.texinfo (Print Settings): Move all stuff relating to symbolic
index d653ce2aac22c7a442641bd62e6b8912417de157..9145d942708862b65d30b54e430f56c3f87174ac 100644 (file)
@@ -55,18 +55,21 @@ machine; for example, use @file{sparc-stub.c} to debug programs on
 @cindex remote serial stub list
 These working remote stubs are distributed with @value{GDBN}:
 
-@c FIXME! verify these...
 @table @code
 @item sparc-stub.c
 @kindex sparc-stub.c
 For @sc{sparc} architectures.
 
 @item m68k-stub.c
-@kindex m68-stub.c
+@kindex m68k-stub.c
+@kindex Motorola 680x0
+@kindex 680x0
 For Motorola 680x0 architectures.
 
 @item i386-stub.c
-@kindex i36-stub.c
+@kindex i386-stub.c
+@kindex Intel
+@kindex 386
 For Intel 386 and compatible architectures.
 @end table
 
@@ -204,6 +207,20 @@ set_debug_traps();
 breakpoint();
 @end example
 
+@item
+For the 680x0 stub only, you need to provide a variable called
+exceptionHook.  Normally you just use
+
+@example
+void (*exceptionHook)() = 0;
+@end example
+
+but if you, before calling @code{set_debug_traps}, set it to point to
+a function, that function will be called when the debugger continues
+from a trap (for example, bus error) which causes the debugger to be
+entered.  It is passed one parameter---an @code{int} which is the
+exception number.
+
 @item
 Compile and link together: your program, the @value{GDBN} debugging stub for
 your target architecture, and the supporting subroutines.