From: Jim Kingdon <jkingdon@engr.sgi.com>
Date: Wed, 27 Oct 1993 05:31:10 +0000 (+0000)
Subject: 	* remote.texi (Bootstrapping): Talk about getting the serial driver
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=e3b9a4856fb91e282fe52fff8b6e83a8e0367e70;p=binutils-gdb.git

	* remote.texi (Bootstrapping): Talk about getting the serial driver
	to deal with ^C sent by gdb to stop the remote system.
---

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 2ca5aa75dc5..b34ea2bbbab 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 5b7ec90e1e8..350c52fa986 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