aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc/remote.texi
diff options
context:
space:
mode:
authorVictoria Mixon <victoria@cygnus>1995-06-22 21:28:02 +0000
committerVictoria Mixon <victoria@cygnus>1995-06-22 21:28:02 +0000
commitaf215b1a6ab2b6d6a21422f655f3825d7cafc260 (patch)
tree13a889fc5b5ad86fde5ce5a0bd25b8ed032f42a8 /gdb/doc/remote.texi
parent89fd75ae2b6c679eb012b17011c14234f077fcce (diff)
downloadgdb-af215b1a6ab2b6d6a21422f655f3825d7cafc260.zip
gdb-af215b1a6ab2b6d6a21422f655f3825d7cafc260.tar.gz
gdb-af215b1a6ab2b6d6a21422f655f3825d7cafc260.tar.bz2
gdb.texinfo: gdb manual up to date for 95q3
remote.texi:
Diffstat (limited to 'gdb/doc/remote.texi')
-rw-r--r--gdb/doc/remote.texi52
1 files changed, 43 insertions, 9 deletions
diff --git a/gdb/doc/remote.texi b/gdb/doc/remote.texi
index bb03c5b..4011c34 100644
--- a/gdb/doc/remote.texi
+++ b/gdb/doc/remote.texi
@@ -13,7 +13,7 @@
To debug a program running on another machine (the debugging
@dfn{target} machine), you must first arrange for all the usual
prerequisites for the program to run by itself. For example, for a C
-program, you need
+program, you need:
@enumerate
@item
@@ -206,7 +206,7 @@ should be a simple jump, not a jump to subroutine.
For the 386, @var{exception_address} should be installed as an interrupt
gate so that interrupts are masked while the handler runs. The gate
should be at privilege level 0 (the most privileged level). The
-@sc{sparc} and 68k stubs are able to mask interrupts themself without
+@sc{sparc} and 68k stubs are able to mask interrup themselves without
help from @code{exceptionHandler}.
@item void flush_i_cache()
@@ -263,7 +263,7 @@ breakpoint();
@item
For the 680x0 stub only, you need to provide a variable called
-@code{exceptionHook}. Normally you just use
+@code{exceptionHook}. Normally you just use:
@example
void (*exceptionHook)() = 0;
@@ -281,7 +281,7 @@ your target architecture, and the supporting subroutines.
@item
Make sure you have a serial connection between your target machine and
-the @value{GDBN} host, and identify the serial port used for this on the host.
+the @value{GDBN} host, and identify the serial port on the host.
@item
@c The "remote" target now provides a `load' command, so we should
@@ -389,7 +389,8 @@ sends data when your program stops.
Command packets are distinguished by their first character, which
identifies the kind of command.
-These are the commands currently supported:
+These are some of the commands currently supported (for a complete list of
+commands, look in @file{gdb/remote.c.}):
@table @code
@item g
@@ -422,6 +423,16 @@ Kill the target program.
Report the most recent signal. To allow you to take advantage of the
@value{GDBN} signal handling commands, one of the functions of the debugging
stub is to report CPU traps as the corresponding POSIX signal values.
+
+@item T
+Allows the remote stub to send only the registers that @value{GDBN} needs
+to make a quick decision about single-stepping or conditional breakpoints.
+This eliminates the need to fetch the entire register set for each instruction
+being stepped through.
+
+The @value{GDBN} remote serial protocol now implements a write-through
+cache for registers. @value{GDBN} only re-reads the registers if the
+target has run.
@end table
@kindex set remotedebug
@@ -563,7 +574,8 @@ To use the server, you must tell it how to communicate with
program. The syntax is:
@smallexample
-load gdbserve [ BOARD=@var{board} ] [ PORT=@var{port} ] [ BAUD=@var{baud} ] @var{program} [ @var{args} @dots{} ]
+load gdbserve [ BOARD=@var{board} ] [ PORT=@var{port} ]
+ [ BAUD=@var{baud} ] @var{program} [ @var{args} @dots{} ]
@end smallexample
@var{board} and @var{port} specify the serial line; @var{baud} specifies
@@ -714,7 +726,7 @@ a break is detected.
protocol for debugging the a29k processor family. To use this
configuration with AMD targets running the MiniMON monitor, you need the
program @code{MONTIP}, available from AMD at no charge. You can also
-use @value{GDBN} with the UDI conformant a29k simulator program
+use @value{GDBN} with the UDI-conformant a29k simulator program
@code{ISSTIP}, also available from AMD.
@table @code
@@ -924,7 +936,7 @@ unexpected events on the PC side of the connection.
@subsection @value{GDBN} with a Tandem ST2000
To connect your ST2000 to the host system, see the manufacturer's
-manual. Once the ST2000 is physically attached, you can run
+manual. Once the ST2000 is physically attached, you can run:
@example
target st2000 @var{dev} @var{speed}
@@ -980,6 +992,16 @@ both the Unix host and on the VxWorks target. The program
installed with the name @code{vxgdb}, to distinguish it from a
@value{GDBN} for debugging programs on the host itself.)
+@table @code
+@item VxWorks-timeout @var{args}
+@kindex vxworks-timeout
+All VxWorks-based targets now support the option @code{vxworks-timeout}.
+This option is set by the user, and @var{args} represents the number of
+seconds @value{GDBN} waits for responses to rpc's. You might use this if
+your VxWorks target is a slow software simulator or is on the far side
+of a thin network line.
+@end table
+
The following information on connecting to VxWorks was current when
this manual was produced; newer releases of VxWorks may use revised
procedures.
@@ -1068,7 +1090,7 @@ program, type this on VxWorks:
@example
-> cd "@var{vxpath}/vw/demo/rdb"
@end example
-
+v
Then, in @value{GDBN}, type:
@example
@@ -1347,6 +1369,18 @@ concentrator) instead of a serial port, using the syntax
@value{GDBN} also supports these special commands for MIPS targets:
@table @code
+@item set processor @var{args}
+@itemx show processor
+@kindex set processor @var{args}
+@kindex show processor
+Use the @code{set processor} command to set the type of MIPS
+processor when you want to access processor-type-specific registers.
+For example, @code{set processor @var{r3041}} tells @value{GDBN}
+to use the CPO registers appropriate for the 3041 chip.
+Use the @code{show processor} command to see what MIPS processor @value{GDBN}
+is using. Use the @code{info reg} command to see what registers
+@value{GDBN} is using.
+
@item set mipsfpu double
@itemx set mipsfpu single
@itemx set mipsfpu none