OpenE2K
/
binutils-gdb
12
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

(Files): Fix the name and documentation of 

add-shared-symbol-files.  Document its alias assf.  Update the
	list of OSs where GDB supports shared libraries.  Fix markup.
	(Continuing and Stepping): Add reference to @var{location} in the
	text.
	(Dump/Restore Files): Fix reference to @{filename}.
	(Help): Fix wording.
	(Attach): Ditto.
	(Set Watchpoints): Ditto.
	(Backtrace): Remove redundant index entries.  Improve index
	entries.
	(Delete Breaks): Fix wording.
	(Memory): Document the compare-sections command.
	(Memory Region Attributes): Improve wording.
	(Disabling): Improve wording.
	(Fortran): New subsection.  Document the "info common" command.
	(Help): Document aliases "info copying" and "info warranty".
	(Caching Remote Data): New section.  Document the "set/show
	remotecache" and "info dcache" commands.
	(Show): Fix wording of the documentation of the "set
	extension-language" command.
	(Signals): Add index entry for "info handle".
	(Memory Region Attributes): Fix punctuation.
	(Symbols): Change the arg name to "location" and refer to it in
	the text.  Fix wording of "info types" doc.
	(Threads): Fix usage of @enumerate @item's.
	(Listing Tracepoints): Add index entry for "info tp".
	(Set Watchpoints): Add xref to "info break" description.
	(Macros): Add an index entry for "macro exp1".  Document the
	"macro list" command.
	(Maintenance Commands): Document "flushregs", "maint agent",
	"maint check-symtabs", "maint cplus", "maint demangle", "maint
	deprecate", "maint undeprecate", "maint dump-me", "maint packet",
	"maint print architecture", "maint print objfiles", "maint print
	statistics", "maint print type", "maint show-debug-regs", "maint
	space", "maint time", and "maint translate-address".
	(Connecting): Document the "monitor" command.
	(Annotations Overview): Describe the "set annotate" command.
This commit is contained in:
Eli Zaretskii 2005-04-02 17:48:36 +00:00
parent b31a49d78d
commit 09d4efe17b
2 changed files with 369 additions and 89 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
gdb/doc/ChangeLog
View File

@ -1,3 +1,44 @@
2005-04-02 Eli Zaretskii <eliz@gnu.org>
* gdb.texinfo (Files): Fix the name and documentation of
add-shared-symbol-files. Document its alias assf. Update the
list of OSs where GDB supports shared libraries. Fix markup.
(Continuing and Stepping): Add reference to @var{location} in the
text.
(Dump/Restore Files): Fix reference to @{filename}.
(Help): Fix wording.
(Attach): Ditto.
(Set Watchpoints): Ditto.
(Backtrace): Remove redundant index entries. Improve index
entries.
(Delete Breaks): Fix wording.
(Memory): Document the compare-sections command.
(Memory Region Attributes): Improve wording.
(Disabling): Improve wording.
(Fortran): New subsection. Document the "info common" command.
(Help): Document aliases "info copying" and "info warranty".
(Caching Remote Data): New section. Document the "set/show
remotecache" and "info dcache" commands.
(Show): Fix wording of the documentation of the "set
extension-language" command.
(Signals): Add index entry for "info handle".
(Memory Region Attributes): Fix punctuation.
(Symbols): Change the arg name to "location" and refer to it in
the text. Fix wording of "info types" doc.
(Threads): Fix usage of @enumerate @item's.
(Listing Tracepoints): Add index entry for "info tp".
(Set Watchpoints): Add xref to "info break" description.
(Macros): Add an index entry for "macro exp1". Document the
"macro list" command.
(Maintenance Commands): Document "flushregs", "maint agent",
"maint check-symtabs", "maint cplus", "maint demangle", "maint
deprecate", "maint undeprecate", "maint dump-me", "maint packet",
"maint print architecture", "maint print objfiles", "maint print
statistics", "maint print type", "maint show-debug-regs", "maint
space", "maint time", and "maint translate-address".
(Connecting): Document the "monitor" command.
(Annotations Overview): Describe the "set annotate" command.
2005-04-01 Eli Zaretskii <eliz@gnu.org> 2005-04-01 Eli Zaretskii <eliz@gnu.org>
* gdb.texinfo (Set Watchpoints): Document can-use-hw-watchpoints. * gdb.texinfo (Set Watchpoints): Document can-use-hw-watchpoints.

417
gdb/doc/gdb.texinfo
View File

@ -1481,7 +1481,7 @@ short paragraph on how to use that command.
@kindex apropos @kindex apropos
@item apropos @var{args} @item apropos @var{args}
The @code{apropos @var{args}} command searches through all of the @value{GDBN} The @code{apropos} command searches through all of the @value{GDBN}
commands, and their documentation, for the regular expression specified in commands, and their documentation, for the regular expression specified in
@var{args}. It prints out all matches found. For example: @var{args}. It prints out all matches found. For example:
@ -1587,11 +1587,15 @@ The version number is the same as the one announced when you start
@value{GDBN}. @value{GDBN}.
@kindex show copying @kindex show copying
@kindex info copying
@item show copying @item show copying
@itemx info copying
Display information about permission for copying @value{GDBN}. Display information about permission for copying @value{GDBN}.
@kindex show warranty @kindex show warranty
@kindex info warranty
@item show warranty @item show warranty
@itemx info warranty
Display the @sc{gnu} ``NO WARRANTY'' statement, or a warranty, Display the @sc{gnu} ``NO WARRANTY'' statement, or a warranty,
if your version of @value{GDBN} comes with one. if your version of @value{GDBN} comes with one.
@ -2002,7 +2006,7 @@ for @value{GDBN} still comes from your terminal.
This command attaches to a running process---one that was started This command attaches to a running process---one that was started
outside @value{GDBN}. (@code{info files} shows your active outside @value{GDBN}. (@code{info files} shows your active
targets.) The command takes as argument a process ID. The usual way to targets.) The command takes as argument a process ID. The usual way to
find out the process-id of a Unix process is with the @code{ps} utility, find out the @var{process-id} of a Unix process is with the @code{ps} utility,
or with the @samp{jobs -l} shell command. or with the @samp{jobs -l} shell command.
@code{attach} does not repeat if you press @key{RET} a second time after @code{attach} does not repeat if you press @key{RET} a second time after
@ -2165,11 +2169,14 @@ Display a summary of all threads currently in your
program. @value{GDBN} displays for each thread (in this order): program. @value{GDBN} displays for each thread (in this order):
@enumerate @enumerate
@item the thread number assigned by @value{GDBN} @item
the thread number assigned by @value{GDBN}
@item the target system's thread identifier (@var{systag}) @item
the target system's thread identifier (@var{systag})
@item the current stack frame summary for that thread @item
the current stack frame summary for that thread
@end enumerate @end enumerate
@noindent @noindent
@ -2409,12 +2416,12 @@ Breaks, ,Setting breakpoints}), to specify the place where your program
should stop by line number, function name or exact address in the should stop by line number, function name or exact address in the
program. program.
In HP-UX, SunOS 4.x, SVR4, and Alpha OSF/1 configurations, you can set On some systems, you can set breakpoints in shared libraries before
breakpoints in shared libraries before the executable is run. There is the executable is run. There is a minor limitation on HP-UX systems:
a minor limitation on HP-UX systems: you must wait until the executable you must wait until the executable is run in order to set breakpoints
is run in order to set breakpoints in shared library routines that are in shared library routines that are not called directly by the program
not called directly by the program (for example, routines that are (for example, routines that are arguments in a @code{pthread_create}
arguments in a @code{pthread_create} call). call).
@cindex watchpoints @cindex watchpoints
@cindex memory tracing @cindex memory tracing
@ -2566,7 +2573,7 @@ breakpoint requires hardware support and some target hardware may not
have this support. The main purpose of this is EPROM/ROM code have this support. The main purpose of this is EPROM/ROM code
debugging, so you can set a breakpoint at an instruction without debugging, so you can set a breakpoint at an instruction without
changing the instruction. This can be used with the new trap-generation changing the instruction. This can be used with the new trap-generation
provided by SPARClite DSU and some x86-based targets. These targets provided by SPARClite DSU and most x86-based targets. These targets
will generate traps when a program accesses some data or instruction will generate traps when a program accesses some data or instruction
address that is assigned to the debug registers. However the hardware address that is assigned to the debug registers. However the hardware
breakpoint registers can take a limited number of breakpoints. For breakpoint registers can take a limited number of breakpoints. For
@ -2766,17 +2773,18 @@ is written into by the program and its value changes.
@kindex rwatch @kindex rwatch
@item rwatch @var{expr} @item rwatch @var{expr}
Set a watchpoint that will break when watch @var{expr} is read by the program. Set a watchpoint that will break when the value of @var{expr} is read
by the program.
@kindex awatch @kindex awatch
@item awatch @var{expr} @item awatch @var{expr}
Set a watchpoint that will break when @var{expr} is either read or written into Set a watchpoint that will break when @var{expr} is either read from
by the program. or written into by the program.
@kindex info watchpoints @kindex info watchpoints
@item info watchpoints @item info watchpoints
This command prints a list of watchpoints, breakpoints, and catchpoints; This command prints a list of watchpoints, breakpoints, and catchpoints;
it is the same as @code{info break}. it is the same as @code{info break} (@pxref{Set Breaks}).
@end table @end table
@value{GDBN} sets a @dfn{hardware watchpoint} if possible. Hardware @value{GDBN} sets a @dfn{hardware watchpoint} if possible. Hardware
@ -3024,11 +3032,12 @@ breakpoint where your program just stopped.
@item clear @var{function} @item clear @var{function}
@itemx clear @var{filename}:@var{function} @itemx clear @var{filename}:@var{function}
Delete any breakpoints set at entry to the function @var{function}. Delete any breakpoints set at entry to the named @var{function}.
@item clear @var{linenum} @item clear @var{linenum}
@itemx clear @var{filename}:@var{linenum} @itemx clear @var{filename}:@var{linenum}
Delete any breakpoints set at or within the code of the specified line. Delete any breakpoints set at or within the code of the specified
@var{linenum} of the specified @var{filename}.
@cindex delete breakpoints @cindex delete breakpoints
@kindex delete @kindex delete
@ -3098,6 +3107,7 @@ of these breakpoints immediately after stopping your program.
@item enable @r{[}breakpoints@r{]} delete @var{range}@dots{} @item enable @r{[}breakpoints@r{]} delete @var{range}@dots{}
Enable the specified breakpoints to work once, then die. @value{GDBN} Enable the specified breakpoints to work once, then die. @value{GDBN}
deletes any of these breakpoints as soon as your program stops there. deletes any of these breakpoints as soon as your program stops there.
Breakpoints set by the @code{tbreak} command start out in this state.
@end table @end table
@c FIXME: I think the following ``Except for [...] @code{tbreak}'' is @c FIXME: I think the following ``Except for [...] @code{tbreak}'' is
@ -3602,6 +3612,7 @@ Contrast this with the @code{return} command (@pxref{Returning,
@kindex until @kindex until
@kindex u @r{(@code{until})} @kindex u @r{(@code{until})}
@cindex run until specified location
@item until @item until
@itemx u @itemx u
Continue running until a source line past the current line, in the Continue running until a source line past the current line, in the
@ -3673,8 +3684,8 @@ invocations have returned.
@kindex advance @var{location} @kindex advance @var{location}
@itemx advance @var{location} @itemx advance @var{location}
Continue running the program up to the given location. An argument is Continue running the program up to the given @var{location}. An argument is
required, anything of the same form as arguments for the @code{break} required, which should be of the same form as arguments for the @code{break}
command. Execution will also stop upon exit from the current stack command. Execution will also stop upon exit from the current stack
frame. This command is similar to @code{until}, but @code{advance} will frame. This command is similar to @code{until}, but @code{advance} will
not skip over recursive function calls, and the target location doesn't not skip over recursive function calls, and the target location doesn't
@ -3741,6 +3752,7 @@ You can change these settings with the @code{handle} command.
@table @code @table @code
@kindex info signals @kindex info signals
@kindex info handle
@item info signals @item info signals
@itemx info handle @itemx info handle
Print a table of all the kinds of signals and how @value{GDBN} has been told to Print a table of all the kinds of signals and how @value{GDBN} has been told to
@ -4054,9 +4066,8 @@ to another without printing the frame. This is the silent version of
@node Backtrace @node Backtrace
@section Backtraces @section Backtraces
@cindex backtraces @cindex traceback
@cindex tracebacks @cindex call stack traces
@cindex stack traces
A backtrace is a summary of how your program got where it is. It shows one A backtrace is a summary of how your program got where it is. It shows one
line per frame, for many frames, starting with the currently executing line per frame, for many frames, starting with the currently executing
frame (frame zero), followed by its caller (frame one), and on up the frame (frame zero), followed by its caller (frame one), and on up the
@ -4531,7 +4542,6 @@ gdb @dots{}
@node Search @node Search
@section Searching source files @section Searching source files
@cindex searching source files @cindex searching source files
@kindex reverse-search
There are two commands for searching through the current source file for a There are two commands for searching through the current source file for a
regular expression. regular expression.
@ -4547,6 +4557,7 @@ starting with the one following the last line listed, for a match for
synonym @samp{search @var{regexp}} or abbreviate the command name as synonym @samp{search @var{regexp}} or abbreviate the command name as
@code{fo}. @code{fo}.
@kindex reverse-search
@item reverse-search @var{regexp} @item reverse-search @var{regexp}
The command @samp{reverse-search @var{regexp}} checks each line, starting The command @samp{reverse-search @var{regexp}} checks each line, starting
with the one before the last line listed and going backward, for a match with the one before the last line listed and going backward, for a match
@ -4812,6 +4823,7 @@ Table}.
* Core File Generation:: Cause a program dump its core * Core File Generation:: Cause a program dump its core
* Character Sets:: Debugging programs that use a different * Character Sets:: Debugging programs that use a different
character set than GDB does character set than GDB does
* Caching Remote Data:: Data caching for remote targets
@end menu @end menu
@node Expressions @node Expressions
@ -5245,6 +5257,25 @@ If the @code{x} command has a repeat count, the address and contents saved
are from the last memory unit printed; this is not the same as the last are from the last memory unit printed; this is not the same as the last
address printed if several units were printed on the last line of output. address printed if several units were printed on the last line of output.
@cindex remote memory comparison
@cindex verify remote memory image
When you are debugging a program running on a remote target machine
(@pxref{Remote}), you may wish to verify the program's image in the
remote machine's memory against the executable file you downloaded to
the target. The @code{compare-sections} command is provided for such
situations.
@table @code
@kindex compare-sections
@item compare-sections @r{[}@var{section-name}@r{]}
Compare the data of a loadable section @var{section-name} in the
executable file of the program being debugged with the same section in
the remote machine's memory, and report any mismatches. With no
arguments, compares all loadable sections. This command's
availability depends on the target's support for the @code{"qCRC"}
remote request.
@end table
@node Auto Display @node Auto Display
@section Automatic display @section Automatic display
@cindex automatic display @cindex automatic display
@ -6027,29 +6058,31 @@ to enable, disable, or remove a memory region, you specify that number.
@table @code @table @code
@kindex mem @kindex mem
@item mem @var{lower} @var{upper} @var{attributes}@dots{} @item mem @var{lower} @var{upper} @var{attributes}@dots{}
Define memory region bounded by @var{lower} and @var{upper} with Define a memory region bounded by @var{lower} and @var{upper} with
attributes @var{attributes}@dots{}. Note that @var{upper} == 0 is a attributes @var{attributes}@dots{}, and add it to the list of regions
special case: it is treated as the the target's maximum memory address. monitored by @value{GDBN}. Note that @var{upper} == 0 is a special
case: it is treated as the the target's maximum memory address.
(0xffff on 16 bit targets, 0xffffffff on 32 bit targets, etc.) (0xffff on 16 bit targets, 0xffffffff on 32 bit targets, etc.)
@kindex delete mem @kindex delete mem
@item delete mem @var{nums}@dots{} @item delete mem @var{nums}@dots{}
Remove memory regions @var{nums}@dots{}. Remove memory regions @var{nums}@dots{} from the list of regions
monitored by @value{GDBN}.
@kindex disable mem @kindex disable mem
@item disable mem @var{nums}@dots{} @item disable mem @var{nums}@dots{}
Disable memory regions @var{nums}@dots{}. Disable monitoring of memory regions @var{nums}@dots{}.
A disabled memory region is not forgotten. A disabled memory region is not forgotten.
It may be enabled again later. It may be enabled again later.
@kindex enable mem @kindex enable mem
@item enable mem @var{nums}@dots{} @item enable mem @var{nums}@dots{}
Enable memory regions @var{nums}@dots{}. Enable monitoring of memory regions @var{nums}@dots{}.
@kindex info mem @kindex info mem
@item info mem @item info mem
Print a table of all defined memory regions, with the following columns Print a table of all defined memory regions, with the following columns
for each region. for each region:
@table @emph @table @emph
@item Memory Region Number @item Memory Region Number
@ -6183,7 +6216,7 @@ form.
@item append @r{[}binary@r{]} memory @var{filename} @var{start_addr} @var{end_addr} @item append @r{[}binary@r{]} memory @var{filename} @var{start_addr} @var{end_addr}
@itemx append @r{[}binary@r{]} value @var{filename} @var{expr} @itemx append @r{[}binary@r{]} value @var{filename} @var{expr}
Append the contents of memory from @var{start_addr} to @var{end_addr}, Append the contents of memory from @var{start_addr} to @var{end_addr},
or the value of @var{expr}, to @var{filename}, in raw binary form. or the value of @var{expr}, to the file @var{filename}, in raw binary form.
(@value{GDBN} can only append data to files in raw binary form.) (@value{GDBN} can only append data to files in raw binary form.)
@kindex restore @kindex restore
@ -6480,6 +6513,38 @@ $10 = 78 '+'
The @sc{ibm1047} character set uses the number 78 to encode the @samp{+} The @sc{ibm1047} character set uses the number 78 to encode the @samp{+}
character. character.
@node Caching Remote Data
@section Caching Data of Remote Targets
@cindex caching data of remote targets
@value{GDBN} can cache data exchanged between the debugger and a
remote target (@pxref{Remote}). Such caching generally improves
performance, because it reduces the overhead of the remote protocol by
bundling memory reads and writes into large chunks. Unfortunately,
@value{GDBN} does not currently know anything about volatile
registers, and thus data caching will produce incorrect results when
volatile registers are in use.
@table @code
@kindex set remotecache
@item set remotecache on
@itemx set remotecache off
Set caching state for remote targets. When @code{ON}, use data
caching. By default, this option is @code{OFF}.
@kindex show remotecache
@item show remotecache
Show the current state of data caching for remote targets.
@kindex info dcache
@item info dcache
Print the information about the data cache performance. The
information displayed includes: the dcache width and depth; and for
each cache line, how many times it was referenced, and its data and
state (dirty, bad, ok, etc.). This command is useful for debugging
the data cache operation.
@end table
@node Macros @node Macros
@chapter C Preprocessor Macros @chapter C Preprocessor Macros
@ -6524,6 +6589,7 @@ Show the results of expanding all preprocessor macro invocations in
not parse the result, @var{expression} need not be a valid expression; not parse the result, @var{expression} need not be a valid expression;
it can be any string of tokens. it can be any string of tokens.
@kindex macro exp1
@item macro expand-once @var{expression} @item macro expand-once @var{expression}
@itemx macro exp1 @var{expression} @itemx macro exp1 @var{expression}
@cindex expand macro once @cindex expand macro once
@ -6570,6 +6636,10 @@ definitions provided with the @command{macro define} command, described
above; it cannot remove definitions present in the program being above; it cannot remove definitions present in the program being
debugged. debugged.
@kindex macro list
@item macro list
@i{(This command is not yet implemented.)} List all the macros
defined using the @code{macro define} command.
@end table @end table
@cindex macros, example of debugging with @cindex macros, example of debugging with
@ -6987,6 +7057,7 @@ You may abbreviate @code{while-stepping} as @code{ws} or
@table @code @table @code
@kindex info tracepoints @kindex info tracepoints
@kindex info tp
@cindex information about tracepoints @cindex information about tracepoints
@item info tracepoints @r{[}@var{num}@r{]} @item info tracepoints @r{[}@var{num}@r{]}
Display information about the tracepoint @var{num}. If you don't specify Display information about the tracepoint @var{num}. If you don't specify
@ -7906,9 +7977,9 @@ with a language explicitly:
@kindex set extension-language @kindex set extension-language
@kindex info extensions @kindex info extensions
@table @code @table @code
@item set extension-language @var{.ext} @var{language} @item set extension-language @var{ext} @var{language}
Set source files with extension @var{.ext} to be assumed to be in Tell @value{GDBN} that source files with extension @var{ext} are to be
the source language @var{language}. assumed as written in the source language @var{language}.
@item info extensions @item info extensions
List all the filename extensions and the associated languages. List all the filename extensions and the associated languages.
@ -8097,6 +8168,7 @@ language reference or tutorial.
@menu @menu
* C:: C and C@t{++} * C:: C and C@t{++}
* Objective-C:: Objective-C * Objective-C:: Objective-C
* Fortran:: Fortran
* Modula-2:: Modula-2 * Modula-2:: Modula-2
* Ada:: Ada * Ada:: Ada
@end menu @end menu
@ -8714,7 +8786,21 @@ the description of an object. However, this command may only work
with certain Objective-C libraries that have a particular hook with certain Objective-C libraries that have a particular hook
function, @code{_NSPrintForDebugger}, defined. function, @code{_NSPrintForDebugger}, defined.
@node Modula-2, Ada, Objective-C, Support @node Fortran
@subsection Fortran
@cindex Fortran-specific support in @value{GDBN}
@table @code
@cindex @code{COMMON} blocks, Fortran
@kindex info common
@item info common @r{[}@var{common-name}@r{]}
This command prints the values contained in the Fortran @code{COMMON}
block whose name is @var{common-name}. With no argument, the names of
all @code{COMMON} blocks visible at current program location are
printed.
@end table
@node Modula-2
@subsection Modula-2 @subsection Modula-2
@cindex Modula-2, @value{GDBN} support @cindex Modula-2, @value{GDBN} support
@ -9618,12 +9704,13 @@ the type of @code{$}, the last value in the value history.
@kindex info types @kindex info types
@item info types @var{regexp} @item info types @var{regexp}
@itemx info types @itemx info types
Print a brief description of all types whose names match @var{regexp} Print a brief description of all types whose names match the regular
(or all types in your program, if you supply no argument). Each expression @var{regexp} (or all types in your program, if you supply
complete typename is matched as though it were a complete line; thus, no argument). Each complete typename is matched as though it were a
@samp{i type value} gives information on all types in your program whose complete line; thus, @samp{i type value} gives information on all
names include the string @code{value}, but @samp{i type ^value$} gives types in your program whose names include the string @code{value}, but
information only on types whose complete name is @code{value}. @samp{i type ^value$} gives information only on types whose complete
name is @code{value}.
This command differs from @code{ptype} in two ways: first, like This command differs from @code{ptype} in two ways: first, like
@code{whatis}, it does not print a detailed description; second, it @code{whatis}, it does not print a detailed description; second, it
@ -9631,11 +9718,11 @@ lists all source files where a type is defined.
@kindex info scope @kindex info scope
@cindex local variables @cindex local variables
@item info scope @var{addr} @item info scope @var{location}
List all the variables local to a particular scope. This command List all the variables local to a particular scope. This command
accepts a location---a function name, a source line, or an address accepts a @var{location} argument---a function name, a source line, or
preceded by a @samp{*}, and prints all the variables local to the an address preceded by a @samp{*}, and prints all the variables local
scope defined by that location. For example: to the scope defined by that location. For example:
@smallexample @smallexample
(@value{GDBP}) @b{info scope command_line_handler} (@value{GDBP}) @b{info scope command_line_handler}
@ -10325,7 +10412,7 @@ symbol table. It cannot be shared across multiple host platforms.
@c files. @c files.
@kindex core-file @kindex core-file
@item core-file @r{[} @var{filename} @r{]} @item core-file @r{[}@var{filename}@r{]}
@itemx core @itemx core
Specify the whereabouts of a core dump file to be used as the ``contents Specify the whereabouts of a core dump file to be used as the ``contents
of memory''. Traditionally, core files contain only some parts of the of memory''. Traditionally, core files contain only some parts of the
@ -10402,21 +10489,28 @@ You can use the @samp{-mapped} and @samp{-readnow} options just as with
the @code{symbol-file} command, to change how @value{GDBN} manages the symbol the @code{symbol-file} command, to change how @value{GDBN} manages the symbol
table information for @var{filename}. table information for @var{filename}.
@kindex add-shared-symbol-file @kindex add-shared-symbol-files
@item add-shared-symbol-file @kindex assf
The @code{add-shared-symbol-file} command can be used only under Harris' CXUX @item add-shared-symbol-files @var{library-file}
operating system for the Motorola 88k. @value{GDBN} automatically looks for @itemx assf @var{library-file}
shared libraries, however if @value{GDBN} does not find yours, you can run The @code{add-shared-symbol-files} command can currently be used only
@code{add-shared-symbol-file}. It takes no arguments. in the Cygwin build of @value{GDBN} on MS-Windows OS, where it is an
alias for the @code{dll-symbols} command (@pxref{Cygwin Native}).
@value{GDBN} automatically looks for shared libraries, however if
@value{GDBN} does not find yours, you can invoke
@code{add-shared-symbol-files}. It takes one argument: the shared
library's file name. @code{assf} is a shorthand alias for
@code{add-shared-symbol-files}.
@kindex section @kindex section
@item section @item section @var{section} @var{addr}
The @code{section} command changes the base address of section SECTION of The @code{section} command changes the base address of the named
the exec file to ADDR. This can be used if the exec file does not contain @var{section} of the exec file to @var{addr}. This can be used if the
section addresses, (such as in the a.out format), or when the addresses exec file does not contain section addresses, (such as in the
specified in the file itself are wrong. Each section must be changed @code{a.out} format), or when the addresses specified in the file
separately. The @code{info files} command, described below, lists all itself are wrong. Each section must be changed separately. The
the sections and their addresses. @code{info files} command, described below, lists all the sections and
their addresses.
@kindex info files @kindex info files
@kindex info target @kindex info target
@ -10498,8 +10592,8 @@ as arguments. @value{GDBN} always converts the file name to an absolute file
name and remembers it that way. name and remembers it that way.
@cindex shared libraries @cindex shared libraries
@value{GDBN} supports HP-UX, SunOS, SVr4, Irix 5, and IBM RS/6000 shared @value{GDBN} supports GNU/Linux, MS-Windows, HP-UX, SunOS, SVr4, Irix
libraries. 5, and IBM RS/6000 shared libraries.
@value{GDBN} automatically loads symbol definitions from shared libraries @value{GDBN} automatically loads symbol definitions from shared libraries
when you use the @code{run} command, or when you examine a core file. when you use the @code{run} command, or when you examine a core file.
@ -11317,6 +11411,12 @@ the target is generally not resumed. It will wait for @value{GDBN}
(this instance or another one) to connect and continue debugging. After (this instance or another one) to connect and continue debugging. After
the @code{disconnect} command, @value{GDBN} is again free to connect to the @code{disconnect} command, @value{GDBN} is again free to connect to
another target. another target.
@cindex send command to remote monitor
@kindex monitor
@item monitor @var{cmd}
This command allows you to send commands directly to the remote
monitor.
@end table @end table
@node Server @node Server
@ -14019,6 +14119,7 @@ commands is marked by a line containing @code{end}.
@kindex if @kindex if
@kindex else @kindex else
@item if @item if
@itemx else
Takes a single argument, which is an expression to evaluate. Takes a single argument, which is an expression to evaluate.
It is followed by a series of commands that are executed It is followed by a series of commands that are executed
only if the expression is true (nonzero). only if the expression is true (nonzero).
@ -18993,8 +19094,16 @@ is for no anntations, level 1 is for use when @value{GDBN} is run as a
subprocess of @sc{gnu} Emacs, level 3 is the maximum annotation suitable subprocess of @sc{gnu} Emacs, level 3 is the maximum annotation suitable
for programs that control @value{GDBN}, and level 2 annotations have for programs that control @value{GDBN}, and level 2 annotations have
been made obsolete (@pxref{Limitations, , Limitations of the Annotation been made obsolete (@pxref{Limitations, , Limitations of the Annotation
Interface, annotate, GDB's Obsolete Annotations}). This chapter Interface, annotate, GDB's Obsolete Annotations}).
describes level 3 annotations.
@table @code
@kindex set annotate
@item set annotate @var{level}
The @value{GDB} command @code{set annotate} sets the level of
annotations to the specified @var{level}.
@end table
This chapter describes level 3 annotations.
A simple example of starting up @value{GDBN} with annotations is: A simple example of starting up @value{GDBN} with annotations is:
@ -19884,10 +19993,17 @@ needed for special purposes only.
@cindex internal commands @cindex internal commands
In addition to commands intended for @value{GDBN} users, @value{GDBN} In addition to commands intended for @value{GDBN} users, @value{GDBN}
includes a number of commands intended for @value{GDBN} developers. includes a number of commands intended for @value{GDBN} developers,
These commands are provided here for reference. that are not documented elsewhere in this manual. These commands are
provided here for reference.
@table @code @table @code
@kindex maint agent
@item maint agent @var{expression}
Translate the given @var{expression} into remote agent bytecodes.
This command is useful for debugging the Agent Expression mechanism
(@pxref{Agent Expressions}).
@kindex maint info breakpoints @kindex maint info breakpoints
@item @anchor{maint info breakpoints}maint info breakpoints @item @anchor{maint info breakpoints}maint info breakpoints
Using the same format as @samp{info breakpoints}, display both the Using the same format as @samp{info breakpoints}, display both the
@ -19921,10 +20037,41 @@ Shared library events.
@end table @end table
@kindex maint check-symtabs
@item maint check-symtabs
Check the consistency of psymtabs and symtabs.
@kindex maint cplus first_component
@item maint cplus first_component @var{name}
Print the first C@t{++} class/namespace component of @var{name}.
@kindex maint cplus namespace
@item maint cplus namespace
Print the list of possible C@t{++} namespaces.
@kindex maint demangle
@item maint demangle @var{name}
Demangle a C@t{++} or Objective-C manled @var{name}.
@kindex maint deprecate
@kindex maint undeprecate
@cindex deprecated commands
@item maint deprecate @var{command} @r{[}@var{replacement}@r{]}
@itemx maint undeprecate @var{command}
Deprecate or undeprecate the named @var{command}. Deprecated commands
cause @value{GDBN} to issue a warning when you use them. The optional
argument @var{replacement} says which newer command should be used in
favor of the deprecated one; if it is given, @value{GDBN} will mention
the replacement as part of the warning.
@kindex maint dump-me
@item maint dump-me
Cause a fatal signal in the debugger and force it to dump its core.
@kindex maint internal-error @kindex maint internal-error
@kindex maint internal-warning @kindex maint internal-warning
@item maint internal-error @item maint internal-error @r{[}@var{message-text}@r{]}
@itemx maint internal-warning @itemx maint internal-warning @r{[}@var{message-text}@r{]}
Cause @value{GDBN} to call the internal function @code{internal_error} Cause @value{GDBN} to call the internal function @code{internal_error}
or @code{internal_warning} and hence behave as though an internal error or @code{internal_warning} and hence behave as though an internal error
or internal warning has been detected. In addition to reporting the or internal warning has been detected. In addition to reporting the
@ -19932,6 +20079,11 @@ internal problem, these functions give the user the opportunity to
either quit @value{GDBN} or create a core file of the current either quit @value{GDBN} or create a core file of the current
@value{GDBN} session. @value{GDBN} session.
These commands take an optional parameter @var{message-text} that is
used as the text of the error or warning message.
Here's an example of using @code{indernal-error}:
@smallexample @smallexample
(@value{GDBP}) @kbd{maint internal-error testing, 1, 2} (@value{GDBP}) @kbd{maint internal-error testing, 1, 2}
@dots{}/maint.c:121: internal-error: testing, 1, 2 @dots{}/maint.c:121: internal-error: testing, 1, 2
@ -19942,8 +20094,18 @@ Create a core file? (y or n) @kbd{n}
(@value{GDBP}) (@value{GDBP})
@end smallexample @end smallexample
Takes an optional parameter that is used as the text of the error or @kindex maint packet
warning message. @item maint packet @var{text}
If @value{GDBN} is talking to an inferior via the serial protocol,
then this command sends the string @var{text} to the inferior, and
displays the response packet. @value{GDBN} supplies the initial
@samp{$} character, the terminating @samp{#} character, and the
checksum.
@kindex maint print architecture
@item maint print architecture @r{[}@var{file}@r{]}
Print the entire architecture configuration. The optional argument
@var{file} names the file where the output goes.
@kindex maint print dummy-frames @kindex maint print dummy-frames
@item maint print dummy-frames @item maint print dummy-frames
@ -19971,10 +20133,10 @@ Takes an optional file parameter.
@kindex maint print raw-registers @kindex maint print raw-registers
@kindex maint print cooked-registers @kindex maint print cooked-registers
@kindex maint print register-groups @kindex maint print register-groups
@item maint print registers @item maint print registers @r{[}@var{file}@r{]}
@itemx maint print raw-registers @itemx maint print raw-registers @r{[}@var{file}@r{]}
@itemx maint print cooked-registers @itemx maint print cooked-registers @r{[}@var{file}@r{]}
@itemx maint print register-groups @itemx maint print register-groups @r{[}@var{file}@r{]}
Print @value{GDBN}'s internal register data structures. Print @value{GDBN}'s internal register data structures.
The command @code{maint print raw-registers} includes the contents of The command @code{maint print raw-registers} includes the contents of
@ -19984,13 +20146,16 @@ includes the (cooked) value of all registers; and the command
register is a member of. @xref{Registers,, Registers, gdbint, register is a member of. @xref{Registers,, Registers, gdbint,
@value{GDBN} Internals}. @value{GDBN} Internals}.
Takes an optional file parameter. These commands take an optional parameter, a file name to which to
write the information.
@kindex maint print reggroups @kindex maint print reggroups
@item maint print reggroups @item maint print reggroups @r{[}@var{file}@r{]}
Print @value{GDBN}'s internal register group data structures. Print @value{GDBN}'s internal register group data structures. The
optional argument @var{file} tells to what file to write the
information.
Takes an optional file parameter. The register groups info looks like this:
@smallexample @smallexample
(@value{GDBP}) @kbd{maint print reggroups} (@value{GDBP}) @kbd{maint print reggroups}
@ -20004,6 +20169,57 @@ Takes an optional file parameter.
restore internal restore internal
@end smallexample @end smallexample
@kindex flushregs
@item flushregs
This command forces @value{GDBN} to flush its internal register cache.
@kindex maint print objfiles
@cindex info for known object files
@item maint print objfiles
Print a dump of all known object files. For each object file, this
command prints its name, address in memory, and all of its psymtabs
and symtabs.
@kindex maint print statistics
@cindex bcache statistics
@item maint print statistics
This command prints, for each object file in the program, various data
about that object file followed by the byte cache (@dfn{bcache})
statistics for the object file. The objfile data includes the number
of minimal, partical, full, and stabs symbols, the number of types
defined by the objfile, the number of as yet unexpanded psym tables,
the number of line tables and string tables, and the amount of memory
used by the various tables. The bcache statistics include the counts,
sizes, and counts of duplicates of all and unique objects, max,
average, and median entry size, total memory used and its overhead and
savings, and various measures of the hash table size and chain
lengths.
@kindex maint print type
@cindex type chain of a data type
@item maint print type @var{expr}
Print the type chain for a type specified by @var{expr}. The argument
can be either a type name or a symbol. If it is a symbol, the type of
that symbol is described. The type chain produced by this command is
a recursive definition of the data type as stored in @value{GDBN}'s
data structures, including its flags and contained types.
@kindex maint set dwarf2 max-cache-age
@kindex maint show dwarf2 max-cache-age
@item maint set dwarf2 max-cache-age
@itemx maint show dwarf2 max-cache-age
Control the DWARF 2 compilation unit cache.
@cindex DWARF 2 compilation units cache
In object files with inter-compilation-unit references, such as those
produced by the GCC option @samp{-feliminate-dwarf2-dups}, the DWARF 2
reader needs to frequently refer to previously read compilation units.
This setting controls how long a compilation unit will remain in the
cache if it is not referenced. A higher limit means that cached
compilation units will be stored in memory longer, and more total
memory will be used. Setting it to zero disables caching, which will
slow down @value{GDBN} startup, but reduce memory consumption.
@kindex maint set profile @kindex maint set profile
@kindex maint show profile @kindex maint show profile
@cindex profiling GDB @cindex profiling GDB
@ -20022,18 +20238,41 @@ data in a @file{gmon.out} file, be sure to move it to a safe location.
Configuring with @samp{--enable-profiling} arranges for @value{GDBN} to be Configuring with @samp{--enable-profiling} arranges for @value{GDBN} to be
compiled with the @samp{-pg} compiler option. compiled with the @samp{-pg} compiler option.
@kindex maint set dwarf2 max-cache-age @kindex maint show-debug-regs
@kindex maint show dwarf2 max-cache-age @cindex x86 hardware debug registers
@item maint set dwarf2 max-cache-age @item maint show-debug-regs
@itemx maint show dwarf2 max-cache-age Control whether to show variables that mirror the x86 hardware debug
Control the DWARF 2 compilation unit cache. registers. Use @code{ON} to enable, @code{OFF} to disable. If
enabled, the debug registers values are shown when GDB inserts or
removes a hardware breakpoint or watchpoint, and when the inferior
triggers a hardware-assisted breakpoint or watchpoint.
In object files with inter-compilation-unit references, such as those @kindex maint space
produced by the GCC option @samp{-feliminate-dwarf2-dups}, the DWARF 2 @cindex memory used by commands
reader needs to frequently refer to previously read compilation units. @item maint space
This setting controls how long a compilation unit will remain in the cache Control whether to display memory usage for each command. If set to a
if it is not referenced. Setting it to zero disables caching, which will nonzero value, @value{GDBN} will display how much memory each command
slow down @value{GDBN} startup but reduce memory consumption. took, following the command's own output. This can also be requested
by invoking @value{GDBN} with the @option{--statistics} command-line
switch (@pxref{Mode Options}).
@kindex maint time
@cindex time of command execution
@item maint time
Control whether to display the execution time for each command. If
set to a nonzero value, @value{GDBN} will display how much time it
took to execute each command, following the command's own output.
This can also be requested by invoking @value{GDBN} with the
@option{--statistics} command-line switch (@pxref{Mode Options}).
@kindex maint translate-address
@item maint translate-address @r{[}@var{section}@r{]} @var{addr}
Find the symbol stored at the location specified by the address
@var{addr} and an optional section name @var{section}. If found,
@value{GDBN} prints the name of the closest symbol and an offset from
the symbol's location to the specified address. This is similar to
the @code{info address} command (@pxref{Symbols}), except that this
command also allows to find symbols in other sections.
@end table @end table