@ifinfo
@format
START-INFO-DIR-ENTRY
-* Gdb-Internals: (gdbint). The GNU debugger internals.
+* Gdb-Internals: (gdbint). The GNU debugger's internals.
END-INFO-DIR-ENTRY
@end format
@end ifinfo
@ifinfo
This file documents the internals of the GNU debugger GDB.
-Copyright (C) 1990, 1991, 1992 Free Software Foundation, Inc.
+Copyright 1990, 1991, 1992 Free Software Foundation, Inc.
Contributed by Cygnus Support. Written by John Gilmore.
Permission is granted to make and distribute verbatim copies of
@end titlepage
-@node Top, README, (dir), (dir)
-
-This file documents the internals of the GNU debugger GDB. It is a
+@node Top
+@top
+This documents the internals of the GNU debugger, GDB. It is a
collection of miscellaneous information with little form at this point.
Mostly, it is a repository into which you can put information about
GDB as you discover it (or as you design changes to GDB).
* Wrapping:: Wrapping Output Lines
* Frames:: Keeping track of function calls
* Coding Style:: Strunk and White for GDB maintainers
-* Host Conditionals:: Controlling what features exist in the host
-* Target Conditionals:: Controlling what features exist in the target
-* Native Conditionals:: Native Conditionals
+* Host Conditionals:: What features exist in the host
+* Target Conditionals:: What features exist in the target
+* Native Conditionals:: Conditionals for when host and target are same
+* Obsolete Conditionals:: Conditionals that don't exist any more
@end menu
-@node README, New Architectures, Top, Top
+@node README
@chapter The @file{README} File
Check the @file{README} file, it often has useful information that does not
appear anywhere else in the directory.
-@node New Architectures, Config, README, Top
+@node New Architectures
@chapter Defining a New Host or Target Architecture
When building support for a new host and/or target, much of the work you
duplicated code.
-@node Config, Host, New Architectures, Top
+@node Config
@chapter Adding a New Configuration
Most of the work in making GDB compile on a new machine is in specifying
configuration; the next two chapters discuss those.
-@node Host, Target, Config, Top
+@node Host
@chapter Adding a New Host
Once you have specified a new configuration for your host
for more info about this.)
-@node Target, Languages, Host, Top
+@node Target
@chapter Adding a New Target
For a new target called @var{ttt}, first specify the configuration as
configuration.)
-@node Languages, Releases, Target, Top
+@node Languages
@chapter Adding a Source Language to GDB
To add other languages to GDB's expression parser, follow the following steps:
@end table
-@node Releases, Partial Symbol Tables, Languages, Top
+@node Releases
@chapter Configuring GDB for Release
From the top level directory (containing @file{gdb}, @file{bfd},
split the document into one overall file and five or so included files.
-@node Partial Symbol Tables, BFD support for GDB, Releases, Top
+@node Partial Symbol Tables
@chapter Partial Symbol Tables
GDB has three types of symbol tables.
little to be gained by trying to free them unless you want to do a lot
more work.
-@node BFD support for GDB, Symbol Reading, Partial Symbol Tables, Top
+@node BFD support for GDB
@chapter Binary File Descriptor Library Support for GDB
BFD provides support for GDB in several ways:
@c Reading,,Symbol Reading}.
-@node Symbol Reading, Cleanups, BFD support for GDB, Top
+@node Symbol Reading
@chapter Symbol Reading
GDB reads symbols from "symbol files". The usual symbol file is the
@end table
-@node Cleanups, Wrapping, Symbol Reading, Top
+@node Cleanups
@chapter Cleanups
Cleanups are a structured way to deal with things that need to be done
since they might never return to your code (they @samp{longjmp} instead).
-@node Wrapping, Frames, Cleanups, Top
+@node Wrapping
@chapter Wrapping Output Lines
Output that goes through @code{printf_filtered} or @code{fputs_filtered} or
warnings are a good example.
-@node Frames, Coding Style, Wrapping, Top
+@node Frames
@chapter Frames
A frame is a construct that GDB uses to keep track of calling and called
the new frame.
@end table
-@node Coding Style, Host Conditionals, Frames, Top
+@node Coding Style
@chapter Coding Style
GDB is generally written using the GNU coding standards, as described in
have been followed, but it's GDB policy, and we periodically check it
using the tools available (plus manual labor), and clean up any remnants.
-@node Host Conditionals, Target Conditionals, Coding Style, Top
+@node Host Conditionals
@chapter Host Conditionals
When GDB is configured and compiled, various macros are defined or left
coffread.c
@end table
-@node Target Conditionals, Native Conditionals, Host Conditionals, Top
+@node Target Conditionals
@chapter Target Conditionals
When GDB is configured and compiled, various macros are defined or left
coffread.c
@end table
-@node Native Conditionals, , Target Conditionals, Top
+@node Native Conditionals
@chapter Native Conditionals
+When GDB is configured and compiled, various macros are defined or left
+undefined, to control compilation when the host and target systems
+are the same. These macros should be defined (or left undefined)
+in @file{nm-@var{system}.h}.
@table @code
@item ATTACH_DETACH
If defined, then gdb will include support for the @code{attach} and
@code{detach} commands.
-commands.
@item FETCH_INFERIOR_REGISTERS
Define this if the native-dependent code will provide its
own routines
u.u_ar0 @emph{is} the location of the registers.
@end table
+@node Obsolete Conditionals
+@chapter Obsolete Conditionals
+
+Fragments of old code in GDB sometimes reference or set the following
+configuration macros. They should not be used by new code, and
+old uses should be removed as those parts of the debugger are
+otherwise touched.
+
+@table @code
+@item STACK_END_ADDR
+This macro used to define where the end of the stack appeared, for use
+in interpreting core file formats that don't record this address in the
+core file itself. This information is now configured in BFD, and GDB
+gets the info portably from there. The values in GDB's configuration
+files should be moved into BFD configuration files (if needed there),
+and deleted from all of GDB's config files.
+
+Any @file{@var{foo}-xdep.c} file that references STACK_END_ADDR
+is so old that it has never been converted to use BFD. Now that's old!
+@end table
@contents
@bye
projects / binutils-gdb.git / commitdiff