diff options
author | Victoria Mixon <victoria@cygnus> | 1995-06-22 21:28:02 +0000 |
---|---|---|
committer | Victoria Mixon <victoria@cygnus> | 1995-06-22 21:28:02 +0000 |
commit | af215b1a6ab2b6d6a21422f655f3825d7cafc260 (patch) | |
tree | 13a889fc5b5ad86fde5ce5a0bd25b8ed032f42a8 /gdb/doc/remote.texi | |
parent | 89fd75ae2b6c679eb012b17011c14234f077fcce (diff) | |
download | gdb-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.texi | 52 |
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 |