From e3b9a4856fb91e282fe52fff8b6e83a8e0367e70 Mon Sep 17 00:00:00 2001 From: Jim Kingdon Date: Wed, 27 Oct 1993 05:31:10 +0000 Subject: [PATCH] * remote.texi (Bootstrapping): Talk about getting the serial driver to deal with ^C sent by gdb to stop the remote system. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/remote.texi | 16 ++++++++++++++-- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 2ca5aa75dc..b34ea2bbba 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +Wed Oct 27 00:25:46 1993 Jim Kingdon (kingdon@lioth.cygnus.com) + + * remote.texi (Bootstrapping): Talk about getting the serial driver + to deal with ^C sent by gdb to stop the remote system. + Mon Oct 25 03:25:41 1993 Tom Lord (lord@cygnus.com) * libgdb.texinfo (Defining Commands): made the DOC arg diff --git a/gdb/doc/remote.texi b/gdb/doc/remote.texi index 5b7ec90e1e..350c52fa98 100644 --- a/gdb/doc/remote.texi +++ b/gdb/doc/remote.texi @@ -149,8 +149,10 @@ start of your debugging session. @cindex remote stub, support routines The debugging stubs that come with @value{GDBN} are set up for a particular chip architecture, but they have no information about the rest of your -debugging target machine. To allow the stub to work, you must supply -these special low-level subroutines: +debugging target machine. + +First of all you need to tell the stub how to communicate with the +serial port. @table @code @item int getDebugChar() @@ -164,7 +166,17 @@ different name is used to allow you to distinguish the two if you wish. Write this subroutine to write a single character to the serial port. It may be identical to @code{putchar} for your target system; a different name is used to allow you to distinguish the two if you wish. +@end table +If you want @value{GDBN} to be able to stop your program while it is +running, you need to use an interrupt-driven serial driver, and arrange +for it to execute a breakpoint instruction when it receives a control C +character. That is the character which @value{GDBN} uses to tell the +remote system to stop. + +Other routines you need to supply are: + +@table @code @item void exceptionHandler (int @var{exception_number}, void *@var{exception_address}) @kindex exceptionHandler Write this function to install @var{exception_address} in the exception