gdb.texinfo: gdb manual up to date for 95q3

remote.texi:
This commit is contained in:
Victoria Mixon 1995-06-22 21:28:02 +00:00
parent 89fd75ae2b
commit af215b1a6a
2 changed files with 966 additions and 698 deletions

File diff suppressed because it is too large Load Diff

View File

@ -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