From: Jim Kingdon <jkingdon@engr.sgi.com>
Date: Wed, 9 Jun 1993 18:12:35 +0000 (+0000)
Subject: 	* gdbinv-s.texi (Debug Session): Document exceptionHook.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=49f09e186521eec71af6406faa31e6ca225cee76;p=binutils-gdb.git

	* gdbinv-s.texi (Debug Session): Document exceptionHook.
---

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 9643f727faa..780d479aca4 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -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
diff --git a/gdb/doc/gdbinv-s.texi b/gdb/doc/gdbinv-s.texi
index d653ce2aac2..9145d942708 100644
--- a/gdb/doc/gdbinv-s.texi
+++ b/gdb/doc/gdbinv-s.texi
@@ -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.