mirror of
https://github.com/espressif/binutils-gdb.git
synced 2025-10-12 02:17:45 +08:00
gdb.texinfo: gdb manual up to date for 95q3
remote.texi:
This commit is contained in:
1612
gdb/doc/gdb.texinfo
1612
gdb/doc/gdb.texinfo
File diff suppressed because it is too large
Load Diff
@ -13,7 +13,7 @@
|
|||||||
To debug a program running on another machine (the debugging
|
To debug a program running on another machine (the debugging
|
||||||
@dfn{target} machine), you must first arrange for all the usual
|
@dfn{target} machine), you must first arrange for all the usual
|
||||||
prerequisites for the program to run by itself. For example, for a C
|
prerequisites for the program to run by itself. For example, for a C
|
||||||
program, you need
|
program, you need:
|
||||||
|
|
||||||
@enumerate
|
@enumerate
|
||||||
@item
|
@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
|
For the 386, @var{exception_address} should be installed as an interrupt
|
||||||
gate so that interrupts are masked while the handler runs. The gate
|
gate so that interrupts are masked while the handler runs. The gate
|
||||||
should be at privilege level 0 (the most privileged level). The
|
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}.
|
help from @code{exceptionHandler}.
|
||||||
|
|
||||||
@item void flush_i_cache()
|
@item void flush_i_cache()
|
||||||
@ -263,7 +263,7 @@ breakpoint();
|
|||||||
|
|
||||||
@item
|
@item
|
||||||
For the 680x0 stub only, you need to provide a variable called
|
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
|
@example
|
||||||
void (*exceptionHook)() = 0;
|
void (*exceptionHook)() = 0;
|
||||||
@ -281,7 +281,7 @@ your target architecture, and the supporting subroutines.
|
|||||||
|
|
||||||
@item
|
@item
|
||||||
Make sure you have a serial connection between your target machine and
|
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
|
@item
|
||||||
@c The "remote" target now provides a `load' command, so we should
|
@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
|
Command packets are distinguished by their first character, which
|
||||||
identifies the kind of command.
|
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
|
@table @code
|
||||||
@item g
|
@item g
|
||||||
@ -422,6 +423,16 @@ Kill the target program.
|
|||||||
Report the most recent signal. To allow you to take advantage of the
|
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
|
@value{GDBN} signal handling commands, one of the functions of the debugging
|
||||||
stub is to report CPU traps as the corresponding POSIX signal values.
|
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
|
@end table
|
||||||
|
|
||||||
@kindex set remotedebug
|
@kindex set remotedebug
|
||||||
@ -563,7 +574,8 @@ To use the server, you must tell it how to communicate with
|
|||||||
program. The syntax is:
|
program. The syntax is:
|
||||||
|
|
||||||
@smallexample
|
@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
|
@end smallexample
|
||||||
|
|
||||||
@var{board} and @var{port} specify the serial line; @var{baud} specifies
|
@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
|
protocol for debugging the a29k processor family. To use this
|
||||||
configuration with AMD targets running the MiniMON monitor, you need the
|
configuration with AMD targets running the MiniMON monitor, you need the
|
||||||
program @code{MONTIP}, available from AMD at no charge. You can also
|
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.
|
@code{ISSTIP}, also available from AMD.
|
||||||
|
|
||||||
@table @code
|
@table @code
|
||||||
@ -924,7 +936,7 @@ unexpected events on the PC side of the connection.
|
|||||||
@subsection @value{GDBN} with a Tandem ST2000
|
@subsection @value{GDBN} with a Tandem ST2000
|
||||||
|
|
||||||
To connect your ST2000 to the host system, see the manufacturer's
|
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
|
@example
|
||||||
target st2000 @var{dev} @var{speed}
|
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
|
installed with the name @code{vxgdb}, to distinguish it from a
|
||||||
@value{GDBN} for debugging programs on the host itself.)
|
@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
|
The following information on connecting to VxWorks was current when
|
||||||
this manual was produced; newer releases of VxWorks may use revised
|
this manual was produced; newer releases of VxWorks may use revised
|
||||||
procedures.
|
procedures.
|
||||||
@ -1068,7 +1090,7 @@ program, type this on VxWorks:
|
|||||||
@example
|
@example
|
||||||
-> cd "@var{vxpath}/vw/demo/rdb"
|
-> cd "@var{vxpath}/vw/demo/rdb"
|
||||||
@end example
|
@end example
|
||||||
|
v
|
||||||
Then, in @value{GDBN}, type:
|
Then, in @value{GDBN}, type:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
@ -1347,6 +1369,18 @@ concentrator) instead of a serial port, using the syntax
|
|||||||
@value{GDBN} also supports these special commands for MIPS targets:
|
@value{GDBN} also supports these special commands for MIPS targets:
|
||||||
|
|
||||||
@table @code
|
@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
|
@item set mipsfpu double
|
||||||
@itemx set mipsfpu single
|
@itemx set mipsfpu single
|
||||||
@itemx set mipsfpu none
|
@itemx set mipsfpu none
|
||||||
|
Reference in New Issue
Block a user