* agentexpr.texi: Fix typos.
* annotate.texinfo: Likewise. * gdb.texinfo: Likewise. * gdbint.texinfo: Likewise. * observer.texi: Likewise. * stabs.texinfo: Likewise.
This commit is contained in:
parent
86f0469973
commit
d3e8051bdd
@ -1,3 +1,12 @@
|
||||
2007-01-20 Ralf Wildenhues <Ralf.Wildenhues@gmx.de> (tiny change)
|
||||
|
||||
* agentexpr.texi: Fix typos.
|
||||
* annotate.texinfo: Likewise.
|
||||
* gdb.texinfo: Likewise.
|
||||
* gdbint.texinfo: Likewise.
|
||||
* observer.texi: Likewise.
|
||||
* stabs.texinfo: Likewise.
|
||||
|
||||
2007-01-20 Markus Deuling <deuling@de.ibm.com> (tiny change)
|
||||
|
||||
* gdbint.texinfo (Support Libraries): Remove mmalloc
|
||||
|
@ -17,7 +17,7 @@
|
||||
@node Agent Expressions
|
||||
@appendix The GDB Agent Expression Mechanism
|
||||
|
||||
In some applications, it is not feasable for the debugger to interrupt
|
||||
In some applications, it is not feasible for the debugger to interrupt
|
||||
the program's execution long enough for the developer to learn anything
|
||||
helpful about its behavior. If the program's correctness depends on its
|
||||
real-time behavior, delays introduced by a debugger might cause the
|
||||
@ -221,7 +221,7 @@ their sum, as an integer.
|
||||
|
||||
In this example, @code{add} is the name of the bytecode, and
|
||||
@code{(0x02)} is the one-byte value used to encode the bytecode, in
|
||||
hexidecimal. The phrase ``@var{a} @var{b} @result{} @var{a+b}'' shows
|
||||
hexadecimal. The phrase ``@var{a} @var{b} @result{} @var{a+b}'' shows
|
||||
the stack before and after the bytecode executes. Beforehand, the stack
|
||||
must contain at least two values, @var{a} and @var{b}; since the top of
|
||||
the stack is to the right, @var{b} is on the top of the stack, and
|
||||
|
@ -20,7 +20,7 @@
|
||||
@set DATE July 2003
|
||||
|
||||
@c NOTE: cagney/2003-07-28:
|
||||
@c Don't make this migration doccument an appendix of GDB's user guide.
|
||||
@c Don't make this migration document an appendix of GDB's user guide.
|
||||
@c By keeping this separate, the size of the user guide is contained. If
|
||||
@c the user guide to get much bigger it would need to switch to a larger,
|
||||
@c more expensive, form factor and would drive up the manuals publication
|
||||
@ -161,7 +161,7 @@ assume that specific @value{GDBN} commands provide specific information.
|
||||
Any change to @value{GDBN}'s @sc{cli} output modifies or removes that
|
||||
information and, consequently, likely breaks the client.
|
||||
|
||||
Since the @sc{gdb/mi} output is independant of the @sc{cli}, it does not
|
||||
Since the @sc{gdb/mi} output is independent of the @sc{cli}, it does not
|
||||
have this problem.
|
||||
|
||||
@section Scalability
|
||||
@ -200,8 +200,8 @@ The annotation mechanism was implemented by interspersing @sc{cli} print
|
||||
statements with various annotations. As a consequence, any @sc{cli}
|
||||
output change can alter the annotation output.
|
||||
|
||||
Since the @sc{gdb/mi} output is independant of the @sc{cli}, and the
|
||||
@sc{gdb/mi} is increasingly implemented independant of the @sc{cli}
|
||||
Since the @sc{gdb/mi} output is independent of the @sc{cli}, and the
|
||||
@sc{gdb/mi} is increasingly implemented independent of the @sc{cli}
|
||||
code, its long term maintenance is much easier.
|
||||
|
||||
@node Migrating to GDB/MI
|
||||
|
@ -3217,7 +3217,7 @@ zero, @value{GDBN} will never try to use hardware watchpoints, even if
|
||||
the underlying system supports them. (Note that hardware-assisted
|
||||
watchpoints that were set @emph{before} setting
|
||||
@code{can-use-hw-watchpoints} to zero will still use the hardware
|
||||
mechanism of watching expressiion values.)
|
||||
mechanism of watching expression values.)
|
||||
|
||||
@table @code
|
||||
@item set can-use-hw-watchpoints
|
||||
@ -4664,7 +4664,7 @@ This entry point is encoded by the linker when the application is built,
|
||||
and is likely before the user entry point @code{main} (or equivalent) is called.
|
||||
|
||||
@item set backtrace past-entry off
|
||||
Backtraces will stop when they encouter the internal entry point of an
|
||||
Backtraces will stop when they encounter the internal entry point of an
|
||||
application. This is the default.
|
||||
|
||||
@item show backtrace past-entry
|
||||
@ -5148,7 +5148,7 @@ To avoid unexpected substitution results, a rule is applied only if the
|
||||
For instance, a rule substituting @file{/usr/source} into
|
||||
@file{/mnt/cross} will be applied to @file{/usr/source/foo-1.0} but
|
||||
not to @file{/usr/sourceware/foo-2.0}. And because the substitution
|
||||
is applied only at the begining of the directory name, this rule will
|
||||
is applied only at the beginning of the directory name, this rule will
|
||||
not be applied to @file{/root/usr/source/baz.c} either.
|
||||
|
||||
In many cases, you can achieve the same result using the @code{directory}
|
||||
@ -5181,7 +5181,7 @@ path; this moves it forward, so @value{GDBN} searches it sooner.
|
||||
@kindex cdir
|
||||
@kindex cwd
|
||||
@vindex $cdir@r{, convenience variable}
|
||||
@vindex $cwdr@r{, convenience variable}
|
||||
@vindex $cwd@r{, convenience variable}
|
||||
@cindex compilation directory
|
||||
@cindex current directory
|
||||
@cindex working directory
|
||||
@ -6171,7 +6171,7 @@ If the number is 0, then the printing is unlimited.
|
||||
@item set print repeats
|
||||
@cindex repeated array elements
|
||||
Set the threshold for suppressing display of repeated array
|
||||
elelments. When the number of consecutive identical elements of an
|
||||
elements. When the number of consecutive identical elements of an
|
||||
array exceeds the threshold, @value{GDBN} prints the string
|
||||
@code{"<repeats @var{n} times>"}, where @var{n} is the number of
|
||||
identical repetitions, instead of displaying the identical elements
|
||||
@ -6382,8 +6382,8 @@ Show whether C@t{++} static members are printed or not.
|
||||
|
||||
@item set print pascal_static-members
|
||||
@itemx set print pascal_static-members on
|
||||
@cindex static members of Pacal objects
|
||||
@cindex Pacal objects, static members display
|
||||
@cindex static members of Pascal objects
|
||||
@cindex Pascal objects, static members display
|
||||
Print static members when displaying a Pascal object. The default is on.
|
||||
|
||||
@item set print pascal_static-members off
|
||||
@ -6830,7 +6830,7 @@ to enable, disable, or remove a memory region, you specify that number.
|
||||
Define a memory region bounded by @var{lower} and @var{upper} with
|
||||
attributes @var{attributes}@dots{}, and add it to the list of regions
|
||||
monitored by @value{GDBN}. Note that @var{upper} == 0 is a special
|
||||
case: it is treated as the the target's maximum memory address.
|
||||
case: it is treated as the target's maximum memory address.
|
||||
(0xffff on 16 bit targets, 0xffffffff on 32 bit targets, etc.)
|
||||
|
||||
@item mem auto
|
||||
@ -6895,7 +6895,7 @@ Memory is read/write. This is the default.
|
||||
@end table
|
||||
|
||||
@subsubsection Memory Access Size
|
||||
The acccess size attributes tells @value{GDBN} to use specific sized
|
||||
The access size attribute tells @value{GDBN} to use specific sized
|
||||
accesses in the memory region. Often memory mapped device registers
|
||||
require specific sized accesses. If no access size attribute is
|
||||
specified, @value{GDBN} may use accesses of any size.
|
||||
@ -11326,7 +11326,7 @@ selected stack frame returns naturally.
|
||||
@cindex calling functions
|
||||
@cindex inferior functions, calling
|
||||
@item print @var{expr}
|
||||
Evaluate the expression @var{expr} and display the resuling value.
|
||||
Evaluate the expression @var{expr} and display the resulting value.
|
||||
@var{expr} may include calls to functions in the program being
|
||||
debugged.
|
||||
|
||||
@ -11773,7 +11773,7 @@ memory footprint by preventing it from automatically loading the
|
||||
symbols from shared libraries. To that end, type @kbd{set
|
||||
auto-solib-add off} before running the inferior, then load each
|
||||
library whose debug symbols you do need with @kbd{sharedlibrary
|
||||
@var{regexp}}, where @var{regexp} is a regular expresion that matches
|
||||
@var{regexp}}, where @var{regexp} is a regular expression that matches
|
||||
the libraries whose symbols you want to be loaded.
|
||||
|
||||
@kindex show auto-solib-add
|
||||
@ -11879,9 +11879,9 @@ directories to search for shared libraries. @samp{solib-search-path}
|
||||
is used after @samp{sysroot} fails to locate the library, or if the
|
||||
path to the library is relative instead of absolute. If you want to
|
||||
use @samp{solib-search-path} instead of @samp{sysroot}, be sure to set
|
||||
@samp{sysroot} to a nonexistant directory to prevent @value{GDBN} from
|
||||
@samp{sysroot} to a nonexistent directory to prevent @value{GDBN} from
|
||||
finding your host's libraries. @samp{sysroot} is preferred; setting
|
||||
it to a nonexistant directory may interfere with automatic loading
|
||||
it to a nonexistent directory may interfere with automatic loading
|
||||
of shared library symbols.
|
||||
|
||||
@kindex show solib-search-path
|
||||
@ -12497,7 +12497,7 @@ Send an arbitrary @var{command} string to the remote monitor.
|
||||
@section Connecting to a remote target
|
||||
|
||||
On the @value{GDBN} host machine, you will need an unstripped copy of
|
||||
your program, since @value{GDBN} needs symobl and debugging information.
|
||||
your program, since @value{GDBN} needs symbol and debugging information.
|
||||
Start up @value{GDBN} as usual, using the name of the local copy of your
|
||||
program as the first argument.
|
||||
|
||||
@ -12766,7 +12766,7 @@ system-call-allowed}.
|
||||
|
||||
@table @code
|
||||
@item set remoteaddresssize @var{bits}
|
||||
@cindex adress size for remote targets
|
||||
@cindex address size for remote targets
|
||||
@cindex bits in remote address
|
||||
Set the maximum size of address in a memory packet to the specified
|
||||
number of bits. @value{GDBN} will mask off the address bits above
|
||||
@ -13653,7 +13653,7 @@ the Win32 API @code{GetThreadSelectorEntry} function.
|
||||
It takes an optional argument that is evaluated to
|
||||
a long value to give the information about this given selector.
|
||||
Without argument, this command displays information
|
||||
about the the six segment registers.
|
||||
about the six segment registers.
|
||||
|
||||
@kindex info dll
|
||||
@item info dll
|
||||
@ -13996,7 +13996,7 @@ only the current thread.
|
||||
This command shows the state of current thread suspension.
|
||||
|
||||
@item set thread run
|
||||
This comamnd sets whether the current thread is allowed to run.
|
||||
This command sets whether the current thread is allowed to run.
|
||||
|
||||
@item show thread run
|
||||
Show whether the current thread is allowed to run.
|
||||
@ -14664,7 +14664,7 @@ The following @value{GDBN} commands are specific to the M32R monitor:
|
||||
@item set download-path @var{path}
|
||||
@kindex set download-path
|
||||
@cindex find downloadable @sc{srec} files (M32R)
|
||||
Set the default path for finding donwloadable @sc{srec} files.
|
||||
Set the default path for finding downloadable @sc{srec} files.
|
||||
|
||||
@item show download-path
|
||||
@kindex show download-path
|
||||
@ -15008,7 +15008,7 @@ When triggered, it can capture low level data, like: @code{PC}, @code{LSEA},
|
||||
@table @code
|
||||
@kindex hwatch
|
||||
@item hwatch @var{conditional}
|
||||
Set hardware watchpoint on combination of Load/Store Effecive Address(es)
|
||||
Set hardware watchpoint on combination of Load/Store Effective Address(es)
|
||||
or Data. For example:
|
||||
|
||||
@code{hwatch ($LEA == my_var) && ($LDATA < 50) || ($SEA == my_var) && ($SDATA >= 50)}
|
||||
@ -15073,7 +15073,7 @@ SDS monitor, running on a PowerPC board (such as Motorola's ADS).
|
||||
@end table
|
||||
|
||||
@cindex SDS protocol
|
||||
The following commands specifi to the SDS protocol are supported
|
||||
The following commands specify to the SDS protocol are supported
|
||||
by@value{GDBN}:
|
||||
|
||||
@table @code
|
||||
@ -15695,13 +15695,13 @@ Show the current setting of MIPS debugging messages.
|
||||
@subsection HPPA
|
||||
@cindex HPPA support
|
||||
|
||||
When @value{GDBN} is debugging te HP PA architecture, it provides the
|
||||
When @value{GDBN} is debugging the HP PA architecture, it provides the
|
||||
following special commands:
|
||||
|
||||
@table @code
|
||||
@item set debug hppa
|
||||
@kindex set debug hppa
|
||||
THis command determines whether HPPA architecture specific debugging
|
||||
This command determines whether HPPA architecture specific debugging
|
||||
messages are to be displayed.
|
||||
|
||||
@item show debug hppa
|
||||
@ -16500,11 +16500,11 @@ handle SIGALRM pass
|
||||
end
|
||||
|
||||
define hook-continue
|
||||
handle SIGLARM pass
|
||||
handle SIGALRM pass
|
||||
end
|
||||
@end smallexample
|
||||
|
||||
As a further example, to hook at the begining and end of the @code{echo}
|
||||
As a further example, to hook at the beginning and end of the @code{echo}
|
||||
command, and to add extra text to the beginning and end of the message,
|
||||
you could define:
|
||||
|
||||
@ -17733,7 +17733,7 @@ end is to make your project known to @value{GDBN} developers and
|
||||
follow development on @email{gdb@@sourceware.org} and
|
||||
@email{gdb-patches@@sourceware.org}. There is also the mailing list
|
||||
@email{dmi-discuss@@lists.freestandards.org}, hosted by the Free Standards
|
||||
Group, which has the aim of creating a a more general MI protocol
|
||||
Group, which has the aim of creating a more general MI protocol
|
||||
called Debugger Machine Interface (DMI) that will become a standard
|
||||
for all debuggers, not just @value{GDBN}.
|
||||
@cindex mailing lists
|
||||
@ -17871,7 +17871,7 @@ the @sc{gdb/mi} interface. In these examples, @samp{->} means that the
|
||||
following line is passed to @sc{gdb/mi} as input, while @samp{<-} means
|
||||
the output received from @sc{gdb/mi}.
|
||||
|
||||
Note the the line breaks shown in the examples are here only for
|
||||
Note the line breaks shown in the examples are here only for
|
||||
readability, they don't appear in the real output.
|
||||
|
||||
@subheading Setting a breakpoint
|
||||
@ -18232,7 +18232,7 @@ Initialize the @var{ignore-count}.
|
||||
@item -r
|
||||
Insert a regular breakpoint in all the functions whose names match the
|
||||
given regular expression. Other flags are not applicable to regular
|
||||
expresson.
|
||||
expressions.
|
||||
@end table
|
||||
|
||||
@subsubheading Result
|
||||
@ -18380,12 +18380,12 @@ body=[]@}
|
||||
@end smallexample
|
||||
|
||||
Create a watchpoint. With the @samp{-a} option it will create an
|
||||
@dfn{access} watchpoint, i.e. a watchpoint that triggers either on a
|
||||
@dfn{access} watchpoint, i.e., a watchpoint that triggers either on a
|
||||
read from or on a write to the memory location. With the @samp{-r}
|
||||
option, the watchpoint created is a @dfn{read} watchpoint, i.e. it will
|
||||
option, the watchpoint created is a @dfn{read} watchpoint, i.e., it will
|
||||
trigger only when the memory location is accessed for reading. Without
|
||||
either of the options, the watchpoint created is a regular watchpoint,
|
||||
i.e. it will trigger when the memory location is accessed for writing.
|
||||
i.e., it will trigger when the memory location is accessed for writing.
|
||||
@xref{Set Watchpoints, , Setting watchpoints}.
|
||||
|
||||
Note that @samp{-break-list} will report a single list of watchpoints and
|
||||
@ -18604,7 +18604,7 @@ search path in the same order they were presented in the command.
|
||||
If blanks are needed as
|
||||
part of a directory name, double-quotes should be used around
|
||||
the name. In the command output, the path will show up separated
|
||||
by the system directory-separator character. The directory-seperator
|
||||
by the system directory-separator character. The directory-separator
|
||||
character must not be used
|
||||
in any directory name.
|
||||
If no directories are specified, the current search path is displayed.
|
||||
@ -18654,7 +18654,7 @@ search path in the same order they were presented in the command.
|
||||
If blanks are needed as
|
||||
part of a directory name, double-quotes should be used around
|
||||
the name. In the command output, the path will show up separated
|
||||
by the system directory-separator character. The directory-seperator
|
||||
by the system directory-separator character. The directory-separator
|
||||
character must not be used
|
||||
in any directory name.
|
||||
If no directories are specified, the current path is displayed.
|
||||
@ -19420,7 +19420,7 @@ following info:
|
||||
|
||||
@table @samp
|
||||
@item @var{level}
|
||||
The frame number, 0 being the topmost frame, i.e. the innermost function.
|
||||
The frame number, 0 being the topmost frame, i.e., the innermost function.
|
||||
@item @var{addr}
|
||||
The @code{$pc} value for that frame.
|
||||
@item @var{func}
|
||||
@ -19521,7 +19521,7 @@ values; and if it is 2 or @code{--simple-values}, print the name,
|
||||
type and value for simple data types and the name and type for arrays,
|
||||
structures and unions. In this last case, a frontend can immediately
|
||||
display the value of simple data types and create variable objects for
|
||||
other data types when the the user wishes to explore their values in
|
||||
other data types when the user wishes to explore their values in
|
||||
more detail.
|
||||
|
||||
@subsubheading @value{GDBN} Command
|
||||
@ -20019,7 +20019,7 @@ is the name of the file to disassemble
|
||||
@item @var{linenum}
|
||||
is the line number to disassemble around
|
||||
@item @var{lines}
|
||||
is the the number of disassembly lines to be produced. If it is -1,
|
||||
is the number of disassembly lines to be produced. If it is -1,
|
||||
the whole function will be disassembled, in case no @var{end-addr} is
|
||||
specified. If @var{end-addr} is specified as a non-zero value, and
|
||||
@var{lines} is lower than the number of disassembly lines between
|
||||
@ -20044,7 +20044,7 @@ The output for each instruction is composed of four fields:
|
||||
@end itemize
|
||||
|
||||
Note that whatever included in the instruction field, is not manipulated
|
||||
directely by @sc{gdb/mi}, i.e. it is not possible to adjust its format.
|
||||
directly by @sc{gdb/mi}, i.e., it is not possible to adjust its format.
|
||||
|
||||
@subsubheading @value{GDBN} Command
|
||||
|
||||
@ -21496,7 +21496,7 @@ designed to interface @value{GDBN} to graphical user interfaces or other
|
||||
similar programs which want to interact with @value{GDBN} at a
|
||||
relatively high level.
|
||||
|
||||
The annotation mechanism has largely been superseeded by @sc{gdb/mi}
|
||||
The annotation mechanism has largely been superseded by @sc{gdb/mi}
|
||||
(@pxref{GDB/MI}).
|
||||
|
||||
@ignore
|
||||
@ -21536,7 +21536,7 @@ The annotation @var{level}, which is specified using the
|
||||
@option{--annotate} command line option (@pxref{Mode Options}), controls
|
||||
how much information @value{GDBN} prints together with its prompt,
|
||||
values of expressions, source lines, and other types of output. Level 0
|
||||
is for no anntations, level 1 is for use when @value{GDBN} is run as a
|
||||
is for no annotations, level 1 is for use when @value{GDBN} is run as a
|
||||
subprocess of @sc{gnu} Emacs, level 3 is the maximum annotation suitable
|
||||
for programs that control @value{GDBN}, and level 2 annotations have
|
||||
been made obsolete (@pxref{Limitations, , Limitations of the Annotation
|
||||
@ -21865,7 +21865,7 @@ distribution.
|
||||
@c should add a web page ref...
|
||||
|
||||
In any event, we also recommend that you submit bug reports for
|
||||
@value{GDBN}. The prefered method is to submit them directly using
|
||||
@value{GDBN}. The preferred method is to submit them directly using
|
||||
@uref{http://www.gnu.org/software/gdb/bugs/, @value{GDBN}'s Bugs web
|
||||
page}. Alternatively, the @email{bug-gdb@@gnu.org, e-mail gateway} can
|
||||
be used.
|
||||
@ -22118,7 +22118,7 @@ and is located in the @file{gdb-@var{version-number}/texinfo}
|
||||
directory.
|
||||
|
||||
If you have @TeX{} and a @sc{dvi} printer program installed, you can
|
||||
typeset and print this manual. First switch to the the @file{gdb}
|
||||
typeset and print this manual. First switch to the @file{gdb}
|
||||
subdirectory of the main source directory (for example, to
|
||||
@file{gdb-@value{GDBVN}/gdb}) and type:
|
||||
|
||||
@ -22521,7 +22521,7 @@ 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}.
|
||||
Demangle a C@t{++} or Objective-C mangled @var{name}.
|
||||
|
||||
@kindex maint deprecate
|
||||
@kindex maint undeprecate
|
||||
@ -22555,7 +22555,7 @@ either quit @value{GDBN} or create a core file of the current
|
||||
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}:
|
||||
Here's an example of using @code{internal-error}:
|
||||
|
||||
@smallexample
|
||||
(@value{GDBP}) @kbd{maint internal-error testing, 1, 2}
|
||||
@ -22658,7 +22658,7 @@ and symtabs.
|
||||
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
|
||||
of minimal, partial, 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,
|
||||
@ -23265,7 +23265,7 @@ Reply:
|
||||
|
||||
@item vCont?
|
||||
@cindex @samp{vCont?} packet
|
||||
Request a list of actions supporetd by the @samp{vCont} packet.
|
||||
Request a list of actions supported by the @samp{vCont} packet.
|
||||
|
||||
Reply:
|
||||
@table @samp
|
||||
@ -24624,7 +24624,7 @@ or the full action has been completed.
|
||||
@subsection Console I/O
|
||||
@cindex console i/o as part of file-i/o
|
||||
|
||||
By default and if not explicitely closed by the target system, the file
|
||||
By default and if not explicitly closed by the target system, the file
|
||||
descriptors 0, 1 and 2 are connected to the @value{GDBN} console. Output
|
||||
on the @value{GDBN} console is handled as any other file output operation
|
||||
(@code{write(1, @dots{})} or @code{write(2, @dots{})}). Console input is handled
|
||||
|
@ -284,7 +284,7 @@ and called functions.
|
||||
need to support @sc{dwarf}'s Call Frame Information in mind. In fact,
|
||||
the term ``unwind'' is taken directly from that specification.
|
||||
Developers wishing to learn more about unwinders, are encouraged to
|
||||
read the the @sc{dwarf} specification.
|
||||
read the @sc{dwarf} specification.
|
||||
|
||||
@findex frame_register_unwind
|
||||
@findex get_frame_register
|
||||
@ -1054,7 +1054,7 @@ command immediately after it is created.
|
||||
|
||||
The first time a command is used the user will be warned and offered a
|
||||
replacement (if one exists). Note that the replacement string passed to
|
||||
@code{deprecate_cmd} should be the full name of the command, i.e. the
|
||||
@code{deprecate_cmd} should be the full name of the command, i.e., the
|
||||
entire string the user should type at the command line.
|
||||
|
||||
@section UI-Independent Output---the @code{ui_out} Functions
|
||||
@ -2929,7 +2929,7 @@ Given the type flags representing an address class qualifier, return
|
||||
its name.
|
||||
@end deftypefn
|
||||
@deftypefn {Target Macro} int ADDRESS_CLASS_NAME_to_TYPE_FLAGS (int @var{name}, int *var{type_flags_ptr})
|
||||
Given an address qualifier name, set the @code{int} refererenced by @var{type_flags_ptr} to the type flags
|
||||
Given an address qualifier name, set the @code{int} referenced by @var{type_flags_ptr} to the type flags
|
||||
for that address class qualifier.
|
||||
@end deftypefn
|
||||
|
||||
@ -3104,7 +3104,7 @@ their @var{reg} and @var{type} arguments in different orders.
|
||||
@cindex @code{struct value}, converting register contents to
|
||||
|
||||
@emph{Maintainer's note: The way GDB manipulates registers is undergoing
|
||||
significant change. Many of the macros and functions refered to in this
|
||||
significant change. Many of the macros and functions referred to in this
|
||||
section are likely to be subject to further revision. See
|
||||
@uref{http://sources.redhat.com/gdb/current/ari/, A.R. Index} and
|
||||
@uref{http://www.gnu.org/software/gdb/bugs, Bug Tracking Database} for
|
||||
@ -3555,7 +3555,7 @@ This method is deprecated. @xref{unwind_pc}.
|
||||
@findex unwind_pc
|
||||
@anchor{unwind_pc} Return the instruction address, in @var{this_frame}'s
|
||||
caller, at which execution will resume after @var{this_frame} returns.
|
||||
This is commonly refered to as the return address.
|
||||
This is commonly referred to as the return address.
|
||||
|
||||
The implementation, which must be frame agnostic (work with any frame),
|
||||
is typically no more than:
|
||||
@ -3572,7 +3572,7 @@ return d10v_make_iaddr (pc);
|
||||
@item CORE_ADDR unwind_sp (struct frame_info *@var{this_frame})
|
||||
@findex unwind_sp
|
||||
@anchor{unwind_sp} Return the frame's inner most stack address. This is
|
||||
commonly refered to as the frame's @dfn{stack pointer}.
|
||||
commonly referred to as the frame's @dfn{stack pointer}.
|
||||
|
||||
The implementation, which must be frame agnostic (work with any frame),
|
||||
is typically no more than:
|
||||
@ -3816,7 +3816,7 @@ Return the virtual type of @var{reg}.
|
||||
@item struct type *register_type (@var{gdbarch}, @var{reg})
|
||||
@findex register_type
|
||||
If defined, return the type of register @var{reg}. This function
|
||||
superseeds @code{DEPRECATED_REGISTER_VIRTUAL_TYPE}. @xref{Target Architecture
|
||||
supersedes @code{DEPRECATED_REGISTER_VIRTUAL_TYPE}. @xref{Target Architecture
|
||||
Definition, , Raw and Virtual Register Representations}.
|
||||
|
||||
@item REGISTER_CONVERT_TO_VIRTUAL(@var{reg}, @var{type}, @var{from}, @var{to})
|
||||
@ -3841,10 +3841,10 @@ Return the appropriate register set for a core file section with name
|
||||
Define this as 1 if the target does not have a hardware single-step
|
||||
mechanism. The macro @code{SOFTWARE_SINGLE_STEP} must also be defined.
|
||||
|
||||
@item SOFTWARE_SINGLE_STEP(@var{signal}, @var{insert_breapoints_p})
|
||||
@item SOFTWARE_SINGLE_STEP(@var{signal}, @var{insert_breakpoints_p})
|
||||
@findex SOFTWARE_SINGLE_STEP
|
||||
A function that inserts or removes (depending on
|
||||
@var{insert_breapoints_p}) breakpoints at each possible destinations of
|
||||
@var{insert_breakpoints_p}) breakpoints at each possible destinations of
|
||||
the next instruction. See @file{sparc-tdep.c} and @file{rs6000-tdep.c}
|
||||
for examples.
|
||||
|
||||
@ -3925,7 +3925,7 @@ definition is only used in generic code when parsing "$ps".)
|
||||
@findex DEPRECATED_POP_FRAME
|
||||
@findex frame_pop
|
||||
If defined, used by @code{frame_pop} to remove a stack frame. This
|
||||
method has been superseeded by generic code.
|
||||
method has been superseded by generic code.
|
||||
|
||||
@item push_dummy_call (@var{gdbarch}, @var{function}, @var{regcache}, @var{pc_addr}, @var{nargs}, @var{args}, @var{sp}, @var{struct_return}, @var{struct_addr})
|
||||
@findex push_dummy_call
|
||||
@ -3976,7 +3976,7 @@ This method has been replaced by @code{stabs_argument_has_addr}
|
||||
@findex SAVE_DUMMY_FRAME_TOS
|
||||
@anchor{SAVE_DUMMY_FRAME_TOS} Used in @samp{call_function_by_hand} to
|
||||
notify the target dependent code of the top-of-stack value that will be
|
||||
passed to the the inferior code. This is the value of the @code{SP}
|
||||
passed to the inferior code. This is the value of the @code{SP}
|
||||
after both the dummy frame and space for parameters/results have been
|
||||
allocated on the stack. @xref{unwind_dummy_id}.
|
||||
|
||||
@ -4020,7 +4020,7 @@ return-value extract and store.}
|
||||
parameter, and such a parameter should not be added. If an architecture
|
||||
that requires per-compiler or per-function information be identified,
|
||||
then the replacement of @var{rettype} with @code{struct value}
|
||||
@var{function} should be persued.}
|
||||
@var{function} should be pursued.}
|
||||
|
||||
@emph{Maintainer note: The @var{regcache} parameter limits this methods
|
||||
to the inner most frame. While replacing @var{regcache} with a
|
||||
@ -4501,7 +4501,7 @@ A target vector can be completely inactive (not pushed on the target
|
||||
stack), active but not running (pushed, but not connected to a fully
|
||||
manifested inferior), or completely active (pushed, with an accessible
|
||||
inferior). Most targets are only completely inactive or completely
|
||||
active, but some support persistant connections to a target even
|
||||
active, but some support persistent connections to a target even
|
||||
when the target has exited or not yet started.
|
||||
|
||||
For example, connecting to the simulator using @code{target sim} does
|
||||
@ -4933,7 +4933,7 @@ The obstack mechanism provides a convenient way to allocate and free
|
||||
chunks of memory. Each obstack is a pool of memory that is managed
|
||||
like a stack. Objects (of any nature, size and alignment) are
|
||||
allocated and freed in a @acronym{LIFO} fashion on an obstack (see
|
||||
@code{libiberty}'s documenatation for a more detailed explanation of
|
||||
@code{libiberty}'s documentation for a more detailed explanation of
|
||||
@code{obstacks}).
|
||||
|
||||
The most noticeable use of the @code{obstacks} in @value{GDBN} is in
|
||||
@ -4942,7 +4942,7 @@ representation of an object file. Lots of things get allocated on
|
||||
these @code{obstacks}: dictionary entries, blocks, blockvectors,
|
||||
symbols, minimal symbols, types, vectors of fundamental types, class
|
||||
fields of types, object files section lists, object files section
|
||||
offets lists, line tables, symbol tables, partial symbol tables,
|
||||
offset lists, line tables, symbol tables, partial symbol tables,
|
||||
string tables, symbol table private data, macros tables, debug
|
||||
information sections and entries, import and export lists (som),
|
||||
unwind information (hppa), dwarf2 location expressions data. Plus
|
||||
@ -4951,7 +4951,7 @@ names of types.
|
||||
|
||||
An essential and convenient property of all data on @code{obstacks} is
|
||||
that memory for it gets allocated (with @code{obstack_alloc}) at
|
||||
various times during a debugging sesssion, but it is released all at
|
||||
various times during a debugging session, but it is released all at
|
||||
once using the @code{obstack_free} function. The @code{obstack_free}
|
||||
function takes a pointer to where in the stack it must start the
|
||||
deletion from (much like the cleanup chains have a pointer to where to
|
||||
@ -5000,7 +5000,7 @@ Regex conditionals.
|
||||
|
||||
Often it is necessary to manipulate a dynamic array of a set of
|
||||
objects. C forces some bookkeeping on this, which can get cumbersome
|
||||
and repetative. The @file{vec.h} file contains macros for defining
|
||||
and repetitive. The @file{vec.h} file contains macros for defining
|
||||
and using a typesafe vector type. The functions defined will be
|
||||
inlined when compiling, and so the abstraction cost should be zero.
|
||||
Domain checks are added to detect programming errors.
|
||||
@ -5496,7 +5496,7 @@ code, but @sc{gcc} 2.x and @sc{c89} do not.
|
||||
|
||||
@item -Wformat-nonliteral
|
||||
Non-literal format strings, with a few exceptions, are bugs - they
|
||||
might contain unintented user-supplied format specifiers.
|
||||
might contain unintended user-supplied format specifiers.
|
||||
Since @value{GDBN} uses the @code{format printf} attribute on all
|
||||
@code{printf} like functions this checks not just @code{printf} calls
|
||||
but also calls to functions such as @code{fprintf_unfiltered}.
|
||||
@ -6032,7 +6032,7 @@ branch tag, denoting the head of the branch, does not need this.}
|
||||
To avoid version conflicts, vendors are expected to modify the file
|
||||
@file{gdb/version.in} to include a vendor unique alphabetic identifier
|
||||
(an official @value{GDBN} release never uses alphabetic characters in
|
||||
its version identifer). E.g., @samp{6.2widgit2}, or @samp{6.2 (Widgit
|
||||
its version identifier). E.g., @samp{6.2widgit2}, or @samp{6.2 (Widgit
|
||||
Inc Patch 2)}.
|
||||
|
||||
@section Experimental Branches
|
||||
@ -6407,8 +6407,8 @@ Send an announcement to the mailing lists:
|
||||
@item
|
||||
@email{gdb-announce@@sources.redhat.com, GDB Announcement mailing list}
|
||||
@item
|
||||
@email{gdb@@sources.redhat.com, GDB Discsussion mailing list} and
|
||||
@email{gdb-testers@@sources.redhat.com, GDB Discsussion mailing list}
|
||||
@email{gdb@@sources.redhat.com, GDB Discussion mailing list} and
|
||||
@email{gdb-testers@@sources.redhat.com, GDB Testers mailing list}
|
||||
@end itemize
|
||||
|
||||
@emph{Pragmatics: The branch creation is sent to the announce list to
|
||||
@ -6615,7 +6615,7 @@ $
|
||||
@emph{Don't worry about the @file{gdb.info-??} or
|
||||
@file{gdb/p-exp.tab.c}. They were generated (and yes @file{gdb.info-1}
|
||||
was also generated only something strange with CVS means that they
|
||||
didn't get supressed). Fixing it would be nice though.}
|
||||
didn't get suppressed). Fixing it would be nice though.}
|
||||
|
||||
@subsubheading Create compressed versions of the release
|
||||
|
||||
|
@ -74,7 +74,7 @@ The following interfaces are available to manage observers:
|
||||
|
||||
@deftypefun extern struct observer *observer_attach_@var{event} (observer_@var{event}_ftype *@var{f})
|
||||
Using the function @var{f}, create an observer that is notified when
|
||||
ever @var{event} occures, return the observer.
|
||||
ever @var{event} occurs, return the observer.
|
||||
@end deftypefun
|
||||
|
||||
@deftypefun extern void observer_detach_@var{event} (struct observer *@var{observer});
|
||||
|
@ -1069,7 +1069,7 @@ start of the relevant section for that compilation unit. SunPRO has
|
||||
plans to have the linker stop relocating stabs; I suspect that their the
|
||||
debugger gets the address from the corresponding ELF (not stab) symbol.
|
||||
I'm not sure how to find which symbol of that name is the right one.
|
||||
The clean way to do all this would be to have a the value of a symbol
|
||||
The clean way to do all this would be to have the value of a symbol
|
||||
descriptor @samp{S} symbol be an offset relative to the start of the
|
||||
file, just like everything else, but that introduces obvious
|
||||
compatibility problems. For more information on linker stab relocation,
|
||||
|
Loading…
Reference in New Issue
Block a user