FreeChainXenon/binutils-gdb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Assorted small improvements, mostly from FSF editing pass (Melissa).

Browse source
This commit is contained in:
Roland Pesch 1993-10-01 01:30:04 +00:00
parent a4aeaacf69
commit 6b51acad7e
3 changed files with 74 additions and 71 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
gdb/doc/ChangeLog
View file

@ -1,3 +1,8 @@
Thu Sep 30 18:24:56 1993 Roland H. Pesch (pesch@fowanton.cygnus.com)
* gdb.texinfo, remote.texi: assorted small improvements, mostly
from Melissa at FSF's editing pass.
Thu Sep 30 11:54:38 1993 Jim Kingdon (kingdon@lioth.cygnus.com) Thu Sep 30 11:54:38 1993 Jim Kingdon (kingdon@lioth.cygnus.com)
* gdb.texinfo: Remove stuff about ar and 14 character filenames. * gdb.texinfo: Remove stuff about ar and 14 character filenames.

112
gdb/doc/gdb.texinfo
View file

@ -54,11 +54,11 @@ END-INFO-DIR-ENTRY
This file documents the GNU debugger @value{GDBN}. This file documents the GNU debugger @value{GDBN}.
@c !!set edition, date, version @c !!set edition, date, version
This is Edition 4.09, April 1993, This is Edition 4.09, August 1993,
of @cite{Debugging with @value{GDBN}: the GNU Source-Level Debugger} of @cite{Debugging with @value{GDBN}: the GNU Source-Level Debugger}
for GDB Version @value{GDBVN}. for GDB Version @value{GDBVN}.
Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993 Free Software Foundation, Inc. Copyright (C) 1988, '89, '90, '91, '92, '93 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice this manual provided the copyright notice and this permission notice
@ -89,8 +89,8 @@ into another language, under the above conditions for modified versions.
@sp 1 @sp 1
@c !!set edition, date, version @c !!set edition, date, version
@subtitle Edition 4.09, for @value{GDBN} version @value{GDBVN} @subtitle Edition 4.09, for @value{GDBN} version @value{GDBVN}
@subtitle April 1993 @subtitle August 1993
@author by Richard M. Stallman and Roland H. Pesch @author Richard M. Stallman and Roland H. Pesch
@page @page
@tex @tex
{\parskip=0pt {\parskip=0pt
@ -102,7 +102,14 @@ into another language, under the above conditions for modified versions.
@end tex @end tex
@vskip 0pt plus 1filll @vskip 0pt plus 1filll
Copyright @copyright{} 1988, 1989, 1990, 1991, 1992, 1993 Free Software Foundation, Inc. Copyright @copyright{} 1988, '89, '90, '91, '92, '93 Free Software
Foundation, Inc.
@sp 2
Published by the Free Software Foundation @*
675 Massachusetts Avenue, @*
Cambridge, MA 02139 USA @*
Printed copies are available for $20 each. @*
ISBN 1-882114-11-6 @*
Permission is granted to make and distribute verbatim copies of Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice this manual provided the copyright notice and this permission notice
@ -266,7 +273,7 @@ Kingdon (releases 3.5, 3.4, 3.3); and Randy Smith (releases 3.2, 3.1,
significantly to the structure, stability, and capabilities of the significantly to the structure, stability, and capabilities of the
entire debugger. entire debugger.
Richard Stallman, assisted at various times by Pete TerMaat, Chris Richard Stallman, assisted at various times by Peter TerMaat, Chris
Hanson, and Richard Mlynarik, handled releases through 2.8. Hanson, and Richard Mlynarik, handled releases through 2.8.
@ifclear CONLY @ifclear CONLY
@ -831,11 +838,11 @@ them, so long as enough of the option is present to be unambiguous.
than @samp{-}, though we illustrate the more usual convention.) than @samp{-}, though we illustrate the more usual convention.)
@table @code @table @code
@item -symbols=@var{file} @item -symbols @var{file}
@itemx -s @var{file} @itemx -s @var{file}
Read symbol table from file @var{file}. Read symbol table from file @var{file}.
@item -exec=@var{file} @item -exec @var{file}
@itemx -e @var{file} @itemx -e @var{file}
Use file @var{file} as the executable file to execute when Use file @var{file} as the executable file to execute when
@ifset BARETARGET @ifset BARETARGET
@ -846,12 +853,12 @@ appropriate, and for examining pure data in conjunction with a core
dump. dump.
@end ifclear @end ifclear
@item -se=@var{file} @item -se @var{file}
Read symbol table from file @var{file} and use it as the executable Read symbol table from file @var{file} and use it as the executable
file. file.
@ifclear BARETARGET @ifclear BARETARGET
@item -core=@var{file} @item -core @var{file}
@itemx -c @var{file} @itemx -c @var{file}
Use file @var{file} as a core dump to examine. Use file @var{file} as a core dump to examine.
@ -861,12 +868,12 @@ Connect to process ID @var{number}, as with the @code{attach} command
case @samp{-c} specifies that file as a core dump to read). case @samp{-c} specifies that file as a core dump to read).
@end ifclear @end ifclear
@item -command=@var{file} @item -command @var{file}
@itemx -x @var{file} @itemx -x @var{file}
Execute @value{GDBN} commands from file @var{file}. @xref{Command Execute @value{GDBN} commands from file @var{file}. @xref{Command
Files,, Command files}. Files,, Command files}.
@item -directory=@var{directory} @item -directory @var{directory}
@itemx -d @var{directory} @itemx -d @var{directory}
Add @var{directory} to the path to search for source files. Add @var{directory} to the path to search for source files.
@ -947,7 +954,7 @@ Program exited normally.
(which is ordinarily issued whenever a program running under @value{GDBN} control (which is ordinarily issued whenever a program running under @value{GDBN} control
terminates) is not issued when running in batch mode. terminates) is not issued when running in batch mode.
@item -cd=@var{directory} @item -cd @var{directory}
Run @value{GDBN} using @var{directory} as its working directory, Run @value{GDBN} using @var{directory} as its working directory,
instead of the current directory. instead of the current directory.
@ -979,7 +986,7 @@ a signal to display the source code for the frame.
Set the line speed (baud rate or bits per second) of any serial Set the line speed (baud rate or bits per second) of any serial
interface used by @value{GDBN} for remote debugging. interface used by @value{GDBN} for remote debugging.
@item -tty=@var{device} @item -tty @var{device}
Run using @var{device} for your program's standard input and output. Run using @var{device} for your program's standard input and output.
@c FIXME: kingdon thinks there is more to -tty. Investigate. @c FIXME: kingdon thinks there is more to -tty. Investigate.
@end ifset @end ifset
@ -1482,7 +1489,7 @@ wrong program.
When you issue the @code{run} command, your program begins to execute When you issue the @code{run} command, your program begins to execute
immediately. @xref{Stopping, ,Stopping and continuing}, for discussion immediately. @xref{Stopping, ,Stopping and continuing}, for discussion
of how to arrange for your program to stop. Once your program has of how to arrange for your program to stop. Once your program has
stopped, you may calls functions in your program, using the @code{print} stopped, you may call functions in your program, using the @code{print}
or @code{call} commands. @xref{Data, ,Examining Data}. or @code{call} commands. @xref{Data, ,Examining Data}.
If the modification time of your symbol file has changed since the If the modification time of your symbol file has changed since the
@ -2111,7 +2118,7 @@ expression changes, without having to predict a particular place
where this may happen. where this may happen.
Watchpoints currently execute two orders of magnitude more slowly than Watchpoints currently execute two orders of magnitude more slowly than
other breakpoints, but this can well be worth it to catch errors where other breakpoints, but this can be well worth it to catch errors where
you have no clue what part of your program is the culprit. Some you have no clue what part of your program is the culprit. Some
processors provide special hardware to support watchpoint evaluation; future processors provide special hardware to support watchpoint evaluation; future
releases of @value{GDBN} will use such hardware if it is available. releases of @value{GDBN} will use such hardware if it is available.
@ -2495,15 +2502,6 @@ cont
end end
@end example @end example
@cindex lost output
@c Do we need to mention this at all? I am sort of tempted to mention
@c it in case people are used to seeing this section of the manual. But
@c for new users it is an annoyance--it documents something which isn't
@c there. -kingdon, 6 Jul 93
Previous versions of @value{GDBN} (4.9 and earlier) would flush pending
input when executing breakpoint commands, if your program used raw mode
for the terminal. This is no longer true.
@ignore @ignore
@c I don't think this is true any longer, now that only readline @c I don't think this is true any longer, now that only readline
@c switches to or from raw mode. In any event, it is a (relatively @c switches to or from raw mode. In any event, it is a (relatively
@ -2631,27 +2629,25 @@ or when stepping, your program may stop even sooner, due to
a breakpoint. a breakpoint.
@end ifset @end ifset
@ifclear BARETARGET @ifclear BARETARGET
a breakpoint or to a signal. (If due to a signal, you may want to use a breakpoint or a signal. (If due to a signal, you may want to use
@code{handle}, or use @samp{signal 0} to resume execution. @code{handle}, or use @samp{signal 0} to resume execution.
@xref{Signals, ,Signals}.) @xref{Signals, ,Signals}.)
@end ifclear @end ifclear
@table @code @table @code
@item continue @r{[}@var{count}@r{]} @item continue @r{[}@var{ignore-count}@r{]}
@itemx c @r{[}@var{count}@r{]} @itemx c @r{[}@var{ignore-count}@r{]}
@itemx fg @r{[}@var{count}@r{]} @itemx fg @r{[}@var{ignore-count}@r{]}
@kindex continue @kindex continue
@kindex c @kindex c
@kindex fg @kindex fg
Resume program execution, at the address where your program last Resume program execution, at the address where your program last stopped;
stopped; any breakpoints set at that address are bypassed. The optional any breakpoints set at that address are bypassed. The optional argument
argument @var{count} means to set the ignore count of a breakpoint which @var{ignore-count} allows you to specify a further number of times to
you are stopped at to @var{count} @minus{} 1, just like the @code{ignore} ignore a breakpoint at this location; its effect is like that of
command (@pxref{Conditions, ,Break conditions}). This means that the @code{ignore} (@pxref{Conditions, ,Break conditions}).
program does not stop at that breakpoint until the @var{count}th time
it is hit.
The argument @var{count} is meaningful only when your program The argument @var{ignore-count} is meaningful only when your program
stopped due to a breakpoint. At other times, the argument to stopped due to a breakpoint. At other times, the argument to
@code{continue} is ignored. @code{continue} is ignored.
@ -2726,7 +2722,7 @@ Contrast this with the @code{return} command (@pxref{Returning,
@item until @item until
@kindex until @kindex until
@item u @itemx u
@kindex u @kindex 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
current stack frame, is reached. This command is used to avoid single current stack frame, is reached. This command is used to avoid single
@ -2771,7 +2767,7 @@ instruction stepping, and hence is slower than @code{until} with an
argument. argument.
@item until @var{location} @item until @var{location}
@item u @var{location} @itemx u @var{location}
Continue running your program until either the specified location is Continue running your program until either the specified location is
reached, or the current stack frame returns. @var{location} is any of reached, or the current stack frame returns. @var{location} is any of
the forms of argument acceptable to @code{break} (@pxref{Set Breaks, the forms of argument acceptable to @code{break} (@pxref{Set Breaks,
@ -2973,6 +2969,7 @@ and so on upward. These numbers do not really exist in your program;
they are assigned by @value{GDBN} to give you a way of designating stack they are assigned by @value{GDBN} to give you a way of designating stack
frames in @value{GDBN} commands. frames in @value{GDBN} commands.
@c below produces an acceptable overful hbox. --mew 13aug1993
@cindex frameless execution @cindex frameless execution
Some compilers provide a way to compile functions so that they operate Some compilers provide a way to compile functions so that they operate
without stack frames. (For example, the @code{@value{GCC}} option without stack frames. (For example, the @code{@value{GCC}} option
@ -4093,7 +4090,7 @@ These settings are useful for debugging programs in any language:
@table @code @table @code
@item set print address @item set print address
@item set print address on @itemx set print address on
@kindex set print address @kindex set print address
@value{GDBN} will print memory addresses showing the location of stack @value{GDBN} will print memory addresses showing the location of stack
traces, structure values, pointer values, breakpoints, and so forth, traces, structure values, pointer values, breakpoints, and so forth,
@ -4398,10 +4395,11 @@ pointers back to the types defined in the symbol table.
@cindex @code{$} @cindex @code{$}
@cindex @code{$$} @cindex @code{$$}
@cindex history number @cindex history number
The values printed are given @dfn{history numbers} for you to refer to them The values printed are given @dfn{history numbers} by which you can
by. These are successive integers starting with one. @code{print} shows you refer to them. These are successive integers starting with one.
the history number assigned to a value by printing @samp{$@var{num} = } @code{print} shows you the history number assigned to a value by
before the value; here @var{num} is the history number. printing @samp{$@var{num} = } before the value; here @var{num} is the
history number.
To refer to any previous value, use @samp{$} followed by the value's To refer to any previous value, use @samp{$} followed by the value's
history number. The way @code{print} labels its output is designed to history number. The way @code{print} labels its output is designed to
@ -4487,9 +4485,9 @@ set $foo = *object_ptr
would save in @code{$foo} the value contained in the object pointed to by would save in @code{$foo} the value contained in the object pointed to by
@code{object_ptr}. @code{object_ptr}.
Using a convenience variable for the first time creates it; but its value Using a convenience variable for the first time creates it, but its
is @code{void} until you assign a new value. You can alter the value with value is @code{void} until you assign a new value. You can alter the
another assignment at any time. value with another assignment at any time.
Convenience variables have no fixed types. You can assign a convenience Convenience variables have no fixed types. You can assign a convenience
variable any type of value, including structures and arrays, even if variable any type of value, including structures and arrays, even if
@ -4980,7 +4978,7 @@ is printed and evaluation of the expression is aborted.
Output messages when the @value{GDBN} range checker detects a range error, Output messages when the @value{GDBN} range checker detects a range error,
but attempt to evaluate the expression anyway. Evaluating the but attempt to evaluate the expression anyway. Evaluating the
expression may still be impossible for other reasons, such as accessing expression may still be impossible for other reasons, such as accessing
memory that the process does not own (a typical example from many UNIX memory that the process does not own (a typical example from many Unix
systems). systems).
@item show range @item show range
@ -5685,7 +5683,7 @@ represents a variable or constant of integral type.
@item m @item m
represents an identifier that belongs to a set. Generally used in the represents an identifier that belongs to a set. Generally used in the
same function with the metavariable @var{s}. The type of @var{s} should same function with the metavariable @var{s}. The type of @var{s} should
be @code{SET OF @var{mtype}} (where @var{mtype} is the type of @var{m}. be @code{SET OF @var{mtype}} (where @var{mtype} is the type of @var{m}).
@item n @item n
represents a variable or constant of integral or floating-point type. represents a variable or constant of integral or floating-point type.
@ -6003,7 +6001,7 @@ local variable, this prints the stack-frame offset at which the variable
is always stored. is always stored.
Note the contrast with @samp{print &@var{symbol}}, which does not work Note the contrast with @samp{print &@var{symbol}}, which does not work
at all for a register variables, and for a stack local variable prints at all for a register variable, and for a stack local variable prints
the exact address of the current instantiation of the variable. the exact address of the current instantiation of the variable.
@item whatis @var{exp} @item whatis @var{exp}
@ -6298,7 +6296,7 @@ already executed, in order to examine its execution in more detail.
@table @code @table @code
@item signal @var{signalnum} @item signal @var{signalnum}
@kindex signal @kindex signal
Resume execution where your program stopped, but give it immediately the Resume execution where your program stopped, but immediately give it the
signal number @var{signalnum}. signal number @var{signalnum}.
Alternatively, if @var{signalnum} is zero, continue execution without Alternatively, if @var{signalnum} is zero, continue execution without
@ -6692,12 +6690,12 @@ Print the names of the shared libraries which are currently loaded.
@itemx share @var{regex} @itemx share @var{regex}
@kindex sharedlibrary @kindex sharedlibrary
@kindex share @kindex share
This is an obsolescent command; you can use it to explicitly This is an obsolescent command; you can use it to explicitly load shared
load shared object library symbols for files matching a UNIX regular object library symbols for files matching a Unix regular expression, but
expression, but as with files loaded automatically, it will only load as with files loaded automatically, it will only load shared libraries
shared libraries required by your program for a core file or after required by your program for a core file or after typing @code{run}. If
typing @code{run}. If @var{regex} is omitted all shared libraries @var{regex} is omitted all shared libraries required by your program are
required by your program are loaded. loaded.
@end table @end table
@end ifclear @end ifclear

28
gdb/doc/remote.texi
View file

@ -68,14 +68,14 @@ For @sc{sparc} architectures.
@item m68k-stub.c @item m68k-stub.c
@kindex m68k-stub.c @kindex m68k-stub.c
@kindex Motorola 680x0 @cindex Motorola 680x0
@kindex 680x0 @cindex 680x0
For Motorola 680x0 architectures. For Motorola 680x0 architectures.
@item i386-stub.c @item i386-stub.c
@kindex i386-stub.c @kindex i386-stub.c
@kindex Intel @cindex Intel
@kindex 386 @cindex 386
For Intel 386 and compatible architectures. For Intel 386 and compatible architectures.
@end table @end table
@ -225,7 +225,7 @@ steps.
@enumerate @enumerate
@item @item
Make sure you have the supporting low-level routines Make sure you have the supporting low-level routines
(@pxref{Bootstrapping}): (@pxref{Bootstrapping,,What you must do for the stub}):
@display @display
@code{getDebugChar}, @code{putDebugChar}, @code{getDebugChar}, @code{putDebugChar},
@code{flush_i_cache}, @code{memset}, @code{exceptionHandler}. @code{flush_i_cache}, @code{memset}, @code{exceptionHandler}.
@ -885,8 +885,8 @@ sequences will get you back to the @value{GDBN} command prompt:
@value{GDBN} enables developers to spawn and debug tasks running on networked @value{GDBN} enables developers to spawn and debug tasks running on networked
VxWorks targets from a Unix host. Already-running tasks spawned from VxWorks targets from a Unix host. Already-running tasks spawned from
the VxWorks shell can also be debugged. @value{GDBN} uses code that runs on the VxWorks shell can also be debugged. @value{GDBN} uses code that runs on
both the UNIX host and on the VxWorks target. The program both the Unix host and on the VxWorks target. The program
@code{gdb} is installed and executed on the UNIX host. (It may be @code{gdb} is installed and executed on the Unix host. (It may be
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.)
@ -909,7 +909,7 @@ VxWorks, see the manufacturer's manual.
Once you have included the RDB interface in your VxWorks system image Once you have included the RDB interface in your VxWorks system image
and set your Unix execution search path to find @value{GDBN}, you are ready and set your Unix execution search path to find @value{GDBN}, you are ready
to run @value{GDBN}. From your UNIX host, run @code{gdb} (or to run @value{GDBN}. From your Unix host, run @code{gdb} (or
@code{vxgdb}, depending on your installation). @code{vxgdb}, depending on your installation).
@value{GDBN} comes up showing the prompt: @value{GDBN} comes up showing the prompt:
@ -961,7 +961,7 @@ command again.
@cindex download to VxWorks @cindex download to VxWorks
If you have connected to the VxWorks target and you want to debug an If you have connected to the VxWorks target and you want to debug an
object that has not yet been loaded, you can use the @value{GDBN} object that has not yet been loaded, you can use the @value{GDBN}
@code{load} command to download a file from UNIX to VxWorks @code{load} command to download a file from Unix to VxWorks
incrementally. The object file given as an argument to the @code{load} incrementally. The object file given as an argument to the @code{load}
command is actually opened twice: first by the VxWorks target in order command is actually opened twice: first by the VxWorks target in order
to download the code, then by @value{GDBN} in order to read the symbol to download the code, then by @value{GDBN} in order to read the symbol
@ -1204,11 +1204,11 @@ retransmit-timeout}. (These commands are @emph{only} available when
@cindex MIPS remote floating point @cindex MIPS remote floating point
@cindex floating point, MIPS remote @cindex floating point, MIPS remote
If your target board does not support the MIPS floating point If your target board does not support the MIPS floating point
coprocessor, use the command @samp{set mipsfpu off} (you may wish to put coprocessor, you should use the command @samp{set mipsfpu off} (you may
this in your @value{GDBINIT} file). This will tell @value{GDBN} how to wish to put this in your @value{GDBINIT} file). This tells @value{GDBN}
find the return value of functions which return floating point values, how to find the return value of functions which return floating point
and tell it to call functions on the board without saving the floating values. It also allows @value{GDBN} to avoid saving the floating point
point registers. registers when calling functions on the board.
@end ifset @end ifset
@ifset SIMS @ifset SIMS