espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-10-19 05:42:42 +08:00
Code Issues Packages Projects Releases Wiki Activity

(Targets): Document "set/show architecture". Remove

Browse Source 
redundant index entry for "target" command.
	(Backtrace): Add index entries.
	(Symbols, Fortran): Document the "set case-sensitive" command.
	(DJGPP Native): Document "set com1base", "set com1irq", etc.
	(Print Settings): Add index entry for "set demangle-style".
	(Target Commands): Document "set download-write-size".
	(Debugging Output): Document "set exec-done-display".
This commit is contained in:
Eli Zaretskii
2005-04-02 22:24:18 +00:00
parent 02dfa7debf
commit a8f24a3552
2 changed files with 130 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
gdb/doc/ChangeLog
View File

@ -1,3 +1,14 @@
2005-04-03 Eli Zaretskii <eliz@gnu.org>
* gdb.texinfo (Targets): Document "set/show architecture". Remove
redundant index entry for "target" command.
(Backtrace): Add index entries.
(Symbols, Fortran): Document the "set case-sensitive" command.
(DJGPP Native): Document "set com1base", "set com1irq", etc.
(Print Settings): Add index entry for "set demangle-style".
(Target Commands): Document "set download-write-size".
(Debugging Output): Document "set exec-done-display".
2005-04-02 Eli Zaretskii <eliz@gnu.org>
* gdb.texinfo (Files): Fix the name and documentation of

119
gdb/doc/gdb.texinfo
View File

@ -4124,6 +4124,9 @@ The display for frame zero does not begin with a program counter
value, indicating that your program has stopped at the beginning of the
code for line @code{993} of @code{builtin.c}.
@cindex backtrace beyond @code{main} function
@cindex program entry point
@cindex startup code, and backtrace
Most programs have a standard user entry point---a place where system
libraries and startup code transition into user code. For C this is
@code{main}. When @value{GDBN} finds the entry function in a backtrace
@ -5649,6 +5652,7 @@ or demangled form.
@cindex C@t{++} symbol decoding style
@cindex symbol decoding style, C@t{++}
@kindex set demangle-style
@item set demangle-style @var{style}
Choose among several encoding schemes used by different compilers to
represent C@t{++} names. The choices for @var{style} are currently:
@ -8800,6 +8804,11 @@ all @code{COMMON} blocks visible at current program location are
printed.
@end table
Fortran symbols are usually case-insensitive, so @value{GDBN} by
default uses case-insensitive matches for Fortran symbols. You can
change that with the @samp{set case-insensitive} command, see
@ref{Symbols}, for the details.
@node Modula-2
@subsection Modula-2
@ -9625,6 +9634,27 @@ p 'foo.c'::x
looks up the value of @code{x} in the scope of the file @file{foo.c}.
@table @code
@cindex case-insensitive symbol names
@cindex case sensitivity in symbol names
@kindex set case-sensitive
@item set case-sensitive on
@itemx set case-sensitive off
@itemx set case-sensitive auto
Normally, when @value{GDBN} looks up symbols, it matches their names
with case sensitivity determined by the current source language.
Occasionally, you may wish to control that. The command @code{set
case-sensitive} lets you do that by specifying @code{on} for
case-sensitive matches or @code{off} for case-insensitive ones. If
you specify @code{auto}, case sensitivity is reset to the default
suitable for the source language. The default is case-sensitive
matches for all languages except for Fortran, for which the default is
case-insensitive matches.
@kindex show case-insensitive
@item show case-insensitive
This command shows the current setting of case sensitivity for symbols
lookups.
@kindex info address
@cindex address of a symbol
@item info address @var{symbol}
@ -11012,8 +11042,6 @@ it.
@chapter Specifying a Debugging Target
@cindex debugging target
@kindex target
A @dfn{target} is the execution environment occupied by your program.
Often, @value{GDBN} runs in the same host environment as your program;
@ -11025,6 +11053,24 @@ realtime system over a TCP/IP connection---you can use the @code{target}
command to specify one of the target types configured for @value{GDBN}
(@pxref{Target Commands, ,Commands for managing targets}).
@cindex target architecture
It is possible to build @value{GDBN} for several different @dfn{target
architectures}. When @value{GDBN} is built like that, you can choose
one of the available architectures with the @kbd{set architecture}
command.
@table @code
@kindex set architecture
@kindex show architecture
@item set architecture @var{arch}
This command sets the current target architecture to @var{arch}. The
value of @var{arch} can be @code{"auto"}, in addition to one of the
supported architectures.
@item show architecture
Show the current target architecture.
@end table
@menu
* Active Targets:: Active targets
* Target Commands:: Commands for managing targets
@ -11177,7 +11223,23 @@ Different targets are available on different configurations of @value{GDBN};
your configuration may have more or fewer targets.
Many remote targets require you to download the executable's code
once you've successfully established a connection.
once you've successfully established a connection. You may wish to
control the size of the data chunks used by @value{GDBN} to download
program parts to the remote target.
@table @code
@kindex set download-write-size
@item set download-write-size @var{size}
Set the write size used when downloading a program. Only used when
downloading a program onto a remote target. Specify zero or a
negative value to disable blocked writes. The actual size of each
transfer is also limited by the size of the target packet and the
memory cache.
@kindex show download-write-size
@item show download-write-size
Show the current value of the write size.
@end table
@table @code
@ -12189,6 +12251,45 @@ mapped 1:1, i.e.@: the physical and linear addresses are identical.
This command is supported only with some DPMI servers.
@end table
In addition to native debugging, the DJGPP port supports remote
debugging via a serial data link. The following commands are specific
to remote serial debugging in the DJGPP port of @value{GDBN}.
@table @code
@kindex set com1base
@kindex set com1irq
@kindex set com2base
@kindex set com2irq
@kindex set com3base
@kindex set com3irq
@kindex set com4base
@kindex set com4irq
@item set com1base @var{addr}
This command sets the base I/O port address of the @file{COM1} serial
port.
@item set com1irq @var{irq}
This command sets the @dfn{Interrupt Request} (@code{IRQ}) line to use
for the @file{COM1} serial port.
There are similar commands @samp{set com2base}, @samp{set com3irq},
etc.@: for setting the port address and the @code{IRQ} lines for the
other 3 COM ports.
@kindex show com1base
@kindex show com1irq
@kindex show com2base
@kindex show com2irq
@kindex show com3base
@kindex show com3irq
@kindex show com4base
@kindex show com4irq
The related commands @samp{show com1base}, @samp{show com1irq} etc.@:
display the current settings of the base address and the @code{IRQ}
lines used by the COM ports.
@end table
@node Cygwin Native
@subsection Features for Debugging MS Windows PE executables
@cindex MS Windows debugging
@ -13849,7 +13950,6 @@ Set the current OS ABI to @var{abi}.
@end table
@cindex float promotion
@kindex set coerce-float-to-double
Generally, the way that an argument of type @code{float} is passed to a
function depends on whether the function is prototyped. For a prototyped
@ -13863,6 +13963,7 @@ a function is prototyped. If @value{GDBN} calls a function that is not marked
as prototyped, it consults @kbd{set coerce-float-to-double}.
@table @code
@kindex set coerce-float-to-double
@item set coerce-float-to-double
@itemx set coerce-float-to-double on
Arguments of type @code{float} will be promoted to @code{double} when passed
@ -13980,8 +14081,18 @@ Displays state of confirmation requests.
@cindex optional debugging messages
@table @code
@kindex set exec-done-display
@item set exec-done-display
Turns on or off the notification of asynchronous commands'
completion. When on, @value{GDBN} will print a message when an
asynchronous command finishes its execution. The default is off.
@kindex show exec-done-display
@item show exec-done-display
Displays the current setting of asynchronous command completion
notification.
@kindex set debug
@cindex gdbarch debugging info
@cindex architecture debugging info
@item set debug arch
Turns on or off display of gdbarch debugging info. The default is off
@kindex show debug