aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdbint.texinfo354
2 files changed, 137 insertions, 222 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 36eb7c8..afa86ad 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+Thu Jul 14 18:43:17 1994 Stan Shebs (shebs@andros.cygnus.com)
+
+ * gdbint.texinfo: Removed mentions of many incorrectly placed and
+ obsolete conditionals, described some others.
+
Tue Jul 12 12:23:15 1994 Peter Schauer (pes@regent.e-technik.tu-muenchen.de)
* gdb.texinfo (help targets): Changed to `help target', which
diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index edd1d0b..929ee93 100644
--- a/gdb/doc/gdbint.texinfo
+++ b/gdb/doc/gdbint.texinfo
@@ -347,7 +347,7 @@ Then edit @file{bfd/configure.host}. Add a line to recognize your
@code{my_host} to @var{xxx} when you recognize it. This will cause your
file @file{h-@var{xxx}.h} to be linked to @file{sysdep.h} at configuration
time. When creating the line that recognizes your configuration,
-only match the fields that you really need to match; e.g. don't match
+only match the fields that you really need to match; e.g. don't
match the architecture or manufacturer if the OS is sufficient
to distinguish the configuration that your @file{h-@var{xxx}.h} file supports.
Don't match the manufacturer name unless you really need to.
@@ -452,7 +452,7 @@ Now, you are now ready to try configuring GDB to compile using your system
as its host. From the top level (above @file{bfd}, @file{gdb}, etc), do:
@example
-./configure @var{xxx} +target=vxworks960
+./configure @var{xxx} --target=vxworks960
@end example
This will configure your system to cross-compile for VxWorks on
@@ -1490,47 +1490,36 @@ available somehow (e.g. anonymous FTP), and announce it on
When GDB is configured and compiled, various macros are defined or left
undefined, to control compilation based on the attributes of the host
-system. These macros and their meanings are:
+system. These macros and their meanings (or if the meaning is not
+documented here, then one of the source files where they are used is
+indicated) are:
@emph{NOTE: For now, both host and target conditionals are here.
Eliminate target conditionals from this list as they are identified.}
@table @code
-@item ALIGN_SIZE
-alloca.c
+
@item BLOCK_ADDRESS_FUNCTION_RELATIVE
dbxread.c
+
@item GDBINIT_FILENAME
-main.c
+The default name of GDB's initialization file (normally @file{.gdbinit}).
+
@item KERNELDEBUG
tm-hppa.h
+
@item MEM_FNS_DECLARED
Your host config file defines this if it includes
declarations of @code{memcpy} and @code{memset}. Define this
to avoid conflicts between the native include
files and the declarations in @file{defs.h}.
+
@item NO_SYS_FILE
dbxread.c
@item PYRAMID_CONTROL_FRAME_DEBUGGING
pyr-xdep.c
@item SIGWINCH_HANDLER_BODY
utils.c
-@item 1
-buildsym.c
-@item 1
-dbxread.c
-@item 1
-dbxread.c
-@item 1
-buildsym.c
-@item 1
-dwarfread.c
-@item 1
-valops.c
-@item 1
-valops.c
-@item 1
-pyr-xdep.c
@item ADDITIONAL_OPTIONS
main.c
@item ADDITIONAL_OPTION_CASES
@@ -1551,8 +1540,6 @@ altos-xdep.c
xm-altos.h
@item ASCII_COFF
remote-adapt.c
-@item BADMAG
-coffread.c
@item BCS
tm-delta88.h
@item BEFORE_MAIN_LOOP_HOOK
@@ -1561,8 +1548,6 @@ main.c
coffread.c
@item BELIEVE_PCC_PROMOTION_TYPE
stabsread.c
-@item BIG_ENDIAN
-defs.h
@item BITS_BIG_ENDIAN
defs.h
@item BKPT_AT_MAIN
@@ -1571,18 +1556,14 @@ solib.c
dbxread.c
@item BPT_VECTOR
tm-m68k.h
-@item BREAKPOINT
-tm-m68k.h
-@item BREAKPOINT_DEBUG
-breakpoint.c
+
@item BROKEN_LARGE_ALLOCA
Avoid large @code{alloca}'s. For example, on sun's, Large alloca's fail
because the attempt to increase the stack limit in main() fails because
shared libraries are allocated just below the initial stack limit. The
SunOS kernel will not allow the stack to grow into the area occupied by
the shared libraries.
-@item BSTRING
-regex.c
+
@item CALL_DUMMY
valops.c
@item CALL_DUMMY_LOCATION
@@ -1609,8 +1590,6 @@ symm-tdep.c
stack.c
@item CPLUS_MARKER
cplus-dem.c
-@item CREATE_INFERIOR_HOOK
-infrun.c
@item C_ALLOCA
regex.c
@item C_GLBLREG
@@ -1627,8 +1606,10 @@ partial-stab.h
hppabsd-xdep.c
@item DECR_PC_AFTER_BREAK
breakpoint.c
+
@item DEFAULT_PROMPT
-main.c
+The default value of the prompt string (normally @code{"(gdb) "}).
+
@item DELTA88
m88k-xdep.c
@item DEV_TTY
@@ -1643,10 +1624,6 @@ remote.c
infrun.c
@item DO_REGISTERS_INFO
infcmd.c
-@item END_OF_TEXT_DEFAULT
-dbxread.c
-@item EXTERN
-buildsym.h
@item EXTRACT_RETURN_VALUE
tm-m68k.h
@item EXTRACT_STRUCT_VALUE_ADDRESS
@@ -1657,36 +1634,10 @@ frame.h
symtab.h
@item FILES_INFO_HOOK
target.c
-@item FIXME
-coffread.c
@item FLOAT_INFO
infcmd.c
@item FOPEN_RB
defs.h
-@item FP0_REGNUM
-a68v-xdep.c
-@item FPC_REGNUM
-mach386-xdep.c
-@item FP_REGNUM
-parse.c
-@item FRAMELESS_FUNCTION_INVOCATION
-blockframe.c
-@item FRAME_ARGS_ADDRESS_CORRECT
-stack.c
-@item FRAME_CHAIN_COMBINE
-blockframe.c
-@item FRAME_CHAIN_VALID
-frame.h
-@item FRAME_CHAIN_VALID_ALTERNATE
-frame.h
-@item FRAME_FIND_SAVED_REGS
-stack.c
-@item FRAME_GET_BASEREG_VALUE
-frame.h
-@item FRAME_NUM_ARGS
-tm-m68k.h
-@item FRAME_SPECIFICATION_DYADIC
-stack.c
@item FUNCTION_EPILOGUE_SIZE
coffread.c
@item F_OK
@@ -1703,17 +1654,13 @@ dwarfread.c
findvar.c
@item GPLUS_PRODUCER
dwarfread.c
-@item GR64_REGNUM
-remote-adapt.c
-@item GR64_REGNUM
-remote-mm.c
@item HANDLE_RBRAC
partial-stab.h
-@item HAVE_68881
-m68k-tdep.c
+
@item HAVE_MMAP
In some cases, use the system call @code{mmap} for reading symbol
tables. For some machines this allows for sharing and quick updates.
+
@item HAVE_REGISTER_WINDOWS
findvar.c
@item HAVE_SIGSETMASK
@@ -1725,7 +1672,7 @@ arm-tdep.c
@item HOSTING_ONLY
xm-rtbsd.h
@item HOST_BYTE_ORDER
-ieee-float.c
+findvar.c
@item HPUX_ASM
xm-hp300hpux.h
@item HPUX_VERSION_5
@@ -1734,8 +1681,6 @@ hp300ux-xdep.c
infrun.c
@item I80960
remote-vx.c
-@item IEEE_DEBUG
-ieee-float.c
@item IEEE_FLOAT
valprint.c
@item IGNORE_SYMBOL
@@ -1766,24 +1711,26 @@ values.c
dbxread.c
@item KERNEL_DEBUGGING
tm-ultra3.h
+
@item KERNEL_U_ADDR
Define this to the address of the @code{u} structure (the ``user struct'',
also known as the ``u-page'') in kernel virtual memory. GDB needs to know
this so that it can subtract this address from absolute addresses in
the upage, that are obtained via ptrace or from core files. On systems
that don't need this value, set it to zero.
+
@item KERNEL_U_ADDR_BSD
Define this to cause GDB to determine the address of @code{u} at runtime,
by using Berkeley-style @code{nlist} on the kernel's image in the root
directory.
+
@item KERNEL_U_ADDR_HPUX
Define this to cause GDB to determine the address of @code{u} at runtime,
by using HP-style @code{nlist} on the kernel's image in the root
directory.
+
@item LCC_PRODUCER
dwarfread.c
-@item LITTLE_ENDIAN
-defs.h
@item LOG_FILE
remote-adapt.c
@item LONGERNAMES
@@ -1800,28 +1747,33 @@ defs.h
source.c
@item L_LNNO32
coffread.c
+
@item L_SET
This macro is used as the argument to lseek (or, most commonly, bfd_seek).
-FIXME, it should be replaced by SEEK_SET instead, which is the POSIX equivalent.
+FIXME, should be replaced by SEEK_SET instead, which is the POSIX equivalent.
+
@item MACHKERNELDEBUG
hppabsd-tdep.c
-@item MAIN
-cplus-dem.c
@item MAINTENANCE
dwarfread.c
+
@item MAINTENANCE_CMDS
-breakpoint.c
-@item MAINTENANCE_CMDS
-maint.c
+If the value of this is 1, then a number of optional maintenance commands
+are compiled in.
+
@item MALLOC_INCOMPATIBLE
Define this if the system's prototype for @code{malloc} differs from the
@sc{ANSI} definition.
+
@item MIPSEL
mips-tdep.c
+
@item MMAP_BASE_ADDRESS
When using HAVE_MMAP, the first mapping should go at this address.
+
@item MMAP_INCREMENT
when using HAVE_MMAP, this is the increment between mappings.
+
@item MONO
ser-go32.c
@item MOTOROLA
@@ -1834,10 +1786,10 @@ infrun.c
exec.c
@item NFAILURES
regex.c
-@item NNPC_REGNUM
-infrun.c
+
@item NORETURN
-defs.h
+(in defs.h - is this really useful to define/undefine?)
+
@item NOTDEF
regex.c
@item NOTDEF
@@ -1850,6 +1802,7 @@ infrun.c
remote-mm.c
@item NO_JOB_CONTROL
signals.h
+
@item NO_MMALLOC
GDB will use the @code{mmalloc} library for memory allocation for symbol
reading, unless this symbol is defined. Define it on systems
@@ -1861,15 +1814,15 @@ to override the setting of @code{MMALLOC_LIB} to empty, in the Makefile.
Therefore, this define is usually set on the command line by overriding
@code{MMALLOC_DISABLE} in @file{config/*/*.mh}, rather than by defining
it in @file{xm-*.h}.
+
@item NO_MMALLOC_CHECK
Define this if you are using @code{mmalloc}, but don't want the overhead
of checking the heap with @code{mmcheck}.
+
@item NO_SIGINTERRUPT
remote-adapt.c
@item NO_SINGLE_STEP
infptrace.c
-@item NPC_REGNUM
-infcmd.c
@item NS32K_SVC_IMMED_OPERANDS
ns32k-opcode.h
@item NUMERIC_REG_NAMES
@@ -1894,8 +1847,6 @@ dbxread.c
inferior.h
@item PC_LOAD_SEGMENT
stack.c
-@item PC_REGNUM
-parse.c
@item PRINT_RANDOM_SIGNAL
infcmd.c
@item PRINT_REGISTER_HOOK
@@ -1908,8 +1859,6 @@ buildsym.c
infrun.c
@item PSIGNAL_IN_SIGNAL_H
defs.h
-@item PS_REGNUM
-parse.c
@item PUSH_ARGUMENTS
valops.c
@item PYRAMID_CONTROL_FRAME_DEBUGGING
@@ -1932,14 +1881,13 @@ regex.h
dwarfread.c
@item R_OK
xm-altos.h
-@item SDB_REG_TO_REGNUM
-coffread.c
@item SEEK_END
state.c
@item SEEK_SET
state.c
@item SEM
coffread.c
+
@item SET_STACK_LIMIT_HUGE
When defined, stack limits will be raised to their maximum. Use this
if your host supports @code{setrlimit} and you have trouble with
@@ -1947,6 +1895,7 @@ if your host supports @code{setrlimit} and you have trouble with
Also used in @file{fork-child.c} to return stack limits before child
processes are forked.
+
@item SHELL_COMMAND_CONCAT
infrun.c
@item SHELL_FILE
@@ -1957,30 +1906,16 @@ breakpoint.c
regex.c
@item SIGTRAP_STOP_AFTER_LOAD
infrun.c
-@item SKIP_PROLOGUE
-tm-m68k.h
-@item SKIP_PROLOGUE_FRAMELESS_P
-blockframe.c
@item SKIP_TRAMPOLINE_CODE
infrun.c
@item SOLIB_ADD
core.c
-@item SOLIB_CREATE_INFERIOR_HOOK
-infrun.c
-@item SP_REGNUM
-parse.c
-@item STAB_REG_TO_REGNUM
-stabsread.h
@item STACK_ALIGN
valops.c
-@item STACK_DIRECTION
-alloca.c
@item START_INFERIOR_TRAPS_EXPECTED
infrun.c
@item STOP_SIGNAL
main.c
-@item STORE_RETURN_VALUE
-tm-m68k.h
@item SUN4_COMPILER_FEATURE
infrun.c
@item SUN_FIXED_LBRAC_BUG
@@ -1997,8 +1932,6 @@ symfile.c
regex.c
@item Sword
regex.c
-@item TDESC
-infrun.c
@item TIOCGETC
inflow.c
@item TIOCGLTC
@@ -2027,10 +1960,12 @@ xm-news.h
inflow.c
@item USE_STRUCT_CONVENTION
values.c
+
@item USG
Means that System V (prior to SVR4) include files are in use.
(FIXME: This symbol is abused in @file{infrun.c}, @file{regex.c},
@file{remote-nindy.c}, and @file{utils.c} for other things, at the moment.)
+
@item USIZE
xm-m88k.h
@item U_FPSTATE
@@ -2039,16 +1974,10 @@ i386-xdep.c
dbxread.c
@item WRS_ORIG
remote-vx.c
-@item _LANG_c
-language.c
-@item _LANG_m2
-language.c
@item __GNUC__
news-xdep.c
@item __GO32__
inflow.c
-@item __HAVE_68881__
-m68k-stub.c
@item __HPUX_ASM__
xm-hp300hpux.h
@item __INT_VARARGS_H
@@ -2061,8 +1990,6 @@ defs.h
defs.h
@item GOULD_PN
gould-pinsn.c
-@item emacs
-alloca.c
@item hp800
xm-hppabsd.h
@item hpux
@@ -2081,8 +2008,6 @@ ns32k-opcode.h
mips-tdep.c
@item sparc
regex.c
-@item static
-alloca.c
@item sun
m68k-tdep.c
@item sun386
@@ -2093,10 +2018,6 @@ regex.c
xm-mips.h
@item volatile
defs.h
-@item x_name
-coffread.c
-@item x_zeroes
-coffread.c
@end table
@node Target Conditionals
@@ -2110,16 +2031,15 @@ system. These macros and their meanings are:
Eliminate host conditionals from this list as they are identified.}
@table @code
+
@item PUSH_DUMMY_FRAME
Used in @samp{call_function_by_hand} to create an artificial stack frame.
+
@item POP_FRAME
Used in @samp{call_function_by_hand} to remove an artificial stack frame.
-@item ALIGN_SIZE
-alloca.c
+
@item BLOCK_ADDRESS_FUNCTION_RELATIVE
dbxread.c
-@item GDBINIT_FILENAME
-main.c
@item KERNELDEBUG
tm-hppa.h
@item NO_SYS_FILE
@@ -2146,18 +2066,12 @@ altos-xdep.c
xm-altos.h
@item ASCII_COFF
remote-adapt.c
-@item BADMAG
-coffread.c
@item BCS
tm-delta88.h
-@item BEFORE_MAIN_LOOP_HOOK
-main.c
@item BELIEVE_PCC_PROMOTION
coffread.c
@item BELIEVE_PCC_PROMOTION_TYPE
stabsread.c
-@item BIG_ENDIAN
-defs.h
@item BITS_BIG_ENDIAN
defs.h
@item BKPT_AT_MAIN
@@ -2168,10 +2082,6 @@ dbxread.c
tm-m68k.h
@item BREAKPOINT
tm-m68k.h
-@item BREAKPOINT_DEBUG
-breakpoint.c
-@item BSTRING
-regex.c
@item CALL_DUMMY
valops.c
@item CALL_DUMMY_LOCATION
@@ -2198,10 +2108,6 @@ symm-tdep.c
stack.c
@item CPLUS_MARKER
cplus-dem.c
-@item CREATE_INFERIOR_HOOK
-infrun.c
-@item C_ALLOCA
-regex.c
@item C_GLBLREG
coffread.c
@item DBXREAD_ONLY
@@ -2216,8 +2122,6 @@ partial-stab.h
hppabsd-xdep.c
@item DECR_PC_AFTER_BREAK
breakpoint.c
-@item DEFAULT_PROMPT
-main.c
@item DELTA88
m88k-xdep.c
@item DEV_TTY
@@ -2232,10 +2136,11 @@ remote.c
infrun.c
@item DO_REGISTERS_INFO
infcmd.c
+
@item END_OF_TEXT_DEFAULT
-dbxread.c
-@item EXTERN
-buildsym.h
+This is an expression that should designate the end of the text section
+(? FIXME ?)
+
@item EXTRACT_RETURN_VALUE
tm-m68k.h
@item EXTRACT_STRUCT_VALUE_ADDRESS
@@ -2246,8 +2151,6 @@ frame.h
symtab.h
@item FILES_INFO_HOOK
target.c
-@item FIXME
-coffread.c
@item FLOAT_INFO
infcmd.c
@item FOPEN_RB
@@ -2258,14 +2161,14 @@ a68v-xdep.c
mach386-xdep.c
@item FP_REGNUM
parse.c
-@item FPU
-Unused? 6-oct-92 rich@@cygnus.com. FIXME.
@item FRAMELESS_FUNCTION_INVOCATION
blockframe.c
@item FRAME_ARGS_ADDRESS_CORRECT
stack.c
+
@item FRAME_CHAIN
Given FRAME, return a pointer to the calling frame.
+
@item FRAME_CHAIN_COMBINE
blockframe.c
@item FRAME_CHAIN_VALID
@@ -2276,12 +2179,17 @@ frame.h
stack.c
@item FRAME_GET_BASEREG_VALUE
frame.h
-@item FRAME_NUM_ARGS
-tm-m68k.h
+
+@item FRAME_NUM_ARGS (val, fi)
+For the frame described by fi, set val to the number of arguments
+that are being passed.
+
@item FRAME_SPECIFICATION_DYADIC
stack.c
+
@item FRAME_SAVED_PC
Given FRAME, return the pc saved there. That is, the return address.
+
@item FUNCTION_EPILOGUE_SIZE
coffread.c
@item F_OK
@@ -2294,16 +2202,19 @@ dbxread.c
symtab.c
@item GCC_PRODUCER
dwarfread.c
+
@item GDB_TARGET_IS_HPPA
This determines whether horrible kludge code in dbxread.c and partial-stab.h
is used to mangle multiple-symbol-table files from HPPA's. This should all
be ripped out, and a scheme like elfread.c used.
+
@item GDB_TARGET_IS_MACH386
mach386-xdep.c
@item GDB_TARGET_IS_SUN3
a68v-xdep.c
@item GDB_TARGET_IS_SUN386
sun386-xdep.c
+
@item GET_LONGJMP_TARGET
For most machines, this is a target-dependent parameter. On the DECstation
and the Iris, this is a native-dependent parameter, since <setjmp.h> is
@@ -2313,6 +2224,7 @@ This macro determines the target PC address that longjmp() will jump
to, assuming that we have just stopped at a longjmp breakpoint. It
takes a CORE_ADDR * as argument, and stores the target PC value through
this pointer. It examines the current state of the machine as needed.
+
@item GET_SAVED_REGISTER
findvar.c
@item GPLUS_PRODUCER
@@ -2335,8 +2247,6 @@ inflow.c
arm-tdep.c
@item HOSTING_ONLY
xm-rtbsd.h
-@item HOST_BYTE_ORDER
-ieee-float.c
@item HPUX_ASM
xm-hp300hpux.h
@item HPUX_VERSION_5
@@ -2345,12 +2255,12 @@ hp300ux-xdep.c
infrun.c
@item I80960
remote-vx.c
+
@item IBM6000_TARGET
Shows that we are configured for an IBM RS/6000 target. This conditional
should be eliminated (FIXME) and replaced by feature-specific macros.
It was introduced in haste and we are repenting at leisure.
-@item IEEE_DEBUG
-ieee-float.c
+
@item IEEE_FLOAT
valprint.c
@item IGNORE_SYMBOL
@@ -2383,8 +2293,6 @@ dbxread.c
tm-ultra3.h
@item LCC_PRODUCER
dwarfread.c
-@item LITTLE_ENDIAN
-defs.h
@item LOG_FILE
remote-adapt.c
@item LONGERNAMES
@@ -2401,14 +2309,8 @@ defs.h
coffread.c
@item MACHKERNELDEBUG
hppabsd-tdep.c
-@item MAIN
-cplus-dem.c
@item MAINTENANCE
dwarfread.c
-@item MAINTENANCE_CMDS
-breakpoint.c
-@item MAINTENANCE_CMDS
-maint.c
@item MIPSEL
mips-tdep.c
@item MOTOROLA
@@ -2419,14 +2321,8 @@ altos-xdep.c
infrun.c
@item NEED_TEXT_START_END
exec.c
-@item NFAILURES
-regex.c
@item NNPC_REGNUM
infrun.c
-@item NORETURN
-defs.h
-@item NOTDEF
-regex.c
@item NOTDEF
remote-adapt.c
@item NOTDEF
@@ -2487,14 +2383,15 @@ tm-a29k.h
exec.c
@item REG_STRUCT_HAS_ADDR
findvar.c
-@item RE_NREGS
-regex.h
@item R_FP
dwarfread.c
@item R_OK
xm-altos.h
+
@item SDB_REG_TO_REGNUM
-coffread.c
+Define this to convert sdb register numbers
+into gdb regnums. If not defined, no conversion will be done.
+
@item SEEK_END
state.c
@item SEEK_SET
@@ -2507,72 +2404,89 @@ infrun.c
infrun.c
@item SHIFT_INST_REGS
breakpoint.c
-@item SIGN_EXTEND_CHAR
-regex.c
@item SIGTRAP_STOP_AFTER_LOAD
infrun.c
+
@item SKIP_PROLOGUE
-tm-m68k.h
+A C statement that advances the PC across any function entry
+prologue instructions so as to reach ``real'' code.
+
@item SKIP_PROLOGUE_FRAMELESS_P
-blockframe.c
+A C statement that should behave similarly, but that can stop
+as soon as the function is known to have a frame.
+If not defined, @code{SKIP_PROLOGUE} will be used instead.
+
@item SKIP_TRAMPOLINE_CODE
infrun.c
@item SOLIB_ADD
core.c
-@item SOLIB_CREATE_INFERIOR_HOOK
-infrun.c
@item SP_REGNUM
parse.c
+
@item STAB_REG_TO_REGNUM
-stabsread.h
+Define this to convert stab register numbers (as gotten from `r' declarations)
+into gdb regnums. If not defined, no conversion will be done.
+
@item STACK_ALIGN
valops.c
-@item STACK_DIRECTION
-alloca.c
@item START_INFERIOR_TRAPS_EXPECTED
infrun.c
@item STOP_SIGNAL
main.c
-@item STORE_RETURN_VALUE
-tm-m68k.h
+
+@item STORE_RETURN_VALUE (type, valbuf)
+A C expression that stores a function return value of type @var{type},
+where @var{valbuf} is the address of the value to be stored.
+
@item SUN4_COMPILER_FEATURE
infrun.c
@item SUN_FIXED_LBRAC_BUG
dbxread.c
@item SVR4_SHARED_LIBS
solib.c
-@item SWITCH_ENUM_BUG
-regex.c
@item SYM1
tm-ultra3.h
@item SYMBOL_RELOADING_DEFAULT
symfile.c
-@item SYNTAX_TABLE
-regex.c
-@item Sword
-regex.c
+
@item TARGET_BYTE_ORDER
-defs.h
+The ordering of bytes in the target.
+This must be defined to be either @code{BIG_ENDIAN} or @code{LITTLE_ENDIAN}.
+
@item TARGET_CHAR_BIT
-defs.h
+Number of bits in a char; defaults to 8.
+
@item TARGET_COMPLEX_BIT
-defs.h
+Number of bits in a complex number; defaults to @code{2 * TARGET_FLOAT_BIT}.
+
@item TARGET_DOUBLE_BIT
-defs.h
+Number of bits in a double float; defaults to @code{8 * TARGET_CHAR_BIT}.
+
@item TARGET_DOUBLE_COMPLEX_BIT
-defs.h
+Number of bits in a double complex; defaults to @code{2 * TARGET_DOUBLE_BIT}.
+
@item TARGET_FLOAT_BIT
-defs.h
+Number of bits in a float; defaults to @code{4 * TARGET_CHAR_BIT}.
+
@item TARGET_INT_BIT
-defs.h
+Number of bits in an integer; defaults to @code{4 * TARGET_CHAR_BIT}.
+
@item TARGET_LONG_BIT
-defs.h
+Number of bits in a long integer; defaults to @code{4 * TARGET_CHAR_BIT}.
+
@item TARGET_LONG_DOUBLE_BIT
-defs.h
+Number of bits in a long double float;
+defaults to @code{2 * TARGET_DOUBLE_BIT}.
+
@item TARGET_LONG_LONG_BIT
-defs.h
+Number of bits in a long long integer; defaults to @code{2 * TARGET_LONG_BIT}.
+
@item TARGET_PTR_BIT
-defs.h
+Number of bits in a pointer; defaults to @code{TARGET_INT_BIT}.
+
+@item TARGET_SHORT_BIT
+Number of bits in a short integer; defaults to @code{2 * TARGET_CHAR_BIT}.
+
@item TARGET_READ_PC
@item TARGET_WRITE_PC
@item TARGET_READ_SP
@@ -2588,10 +2502,6 @@ These macros are useful when a target keeps one of these registers in a
hard to get at place; for example, part in a segment register and part
in an ordinary register.
-@item TARGET_SHORT_BIT
-defs.h
-@item TDESC
-infrun.c
@item T_ARG
coffread.c
@item T_VOID
@@ -2612,14 +2522,8 @@ i386-xdep.c
dbxread.c
@item WRS_ORIG
remote-vx.c
-@item _LANG_c
-language.c
-@item _LANG_m2
-language.c
@item __GO32__
inflow.c
-@item __HAVE_68881__
-m68k-stub.c
@item __HPUX_ASM__
xm-hp300hpux.h
@item __INT_VARARGS_H
@@ -2628,8 +2532,6 @@ printcmd.c
pyr-xdep.c
@item GOULD_PN
gould-pinsn.c
-@item emacs
-alloca.c
@item hp800
xm-hppabsd.h
@item hpux
@@ -2642,20 +2544,14 @@ m68k-stub.c
ns32k-opcode.h
@item sgi
mips-tdep.c
-@item sparc
-regex.c
-@item static
-alloca.c
@item sun
m68k-tdep.c
@item sun386
tm-sun386.h
+
@item test
-regex.c
-@item x_name
-coffread.c
-@item x_zeroes
-coffread.c
+(Define this to enable testing code in regex.c.)
+
@end table
@node Native Conditionals
@@ -2667,9 +2563,11 @@ 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.
+
@item FETCH_INFERIOR_REGISTERS
Define this if the native-dependent code will provide its
own routines
@@ -2678,6 +2576,7 @@ own routines
If this symbol is @emph{not} defined, and @file{infptrace.c}
is included in this configuration, the default routines in
@file{infptrace.c} are used for these functions.
+
@item GET_LONGJMP_TARGET
For most machines, this is a target-dependent parameter. On the DECstation
and the Iris, this is a native-dependent parameter, since <setjmp.h> is
@@ -2687,22 +2586,32 @@ This macro determines the target PC address that longjmp() will jump
to, assuming that we have just stopped at a longjmp breakpoint. It
takes a CORE_ADDR * as argument, and stores the target PC value through
this pointer. It examines the current state of the machine as needed.
+
@item PROC_NAME_FMT
Defines the format for the name of a @file{/proc} device. Should be
defined in @file{nm.h} @emph{only} in order to override the default
definition in @file{procfs.c}.
+
@item PTRACE_FP_BUG
mach386-xdep.c
+
@item PTRACE_ARG3_TYPE
The type of the third argument to the @code{ptrace} system call, if it exists
and is different from @code{int}.
+
@item REGISTER_U_ADDR
Defines the offset of the registers in the ``u area''; @pxref{Host}.
+
+@item SOLIB_CREATE_INFERIOR_HOOK
+Define this to expand into any shared-library-relocation code
+that you want to be run just after the child process has been forked.
+
@item USE_PROC_FS
This determines whether small routines in @file{*-tdep.c}, which
translate register values
between GDB's internal representation and the /proc representation,
are compiled.
+
@item U_REGS_OFFSET
This is the offset of the registers in the upage. It need only be
defined if the generic ptrace register access routines in
@@ -2714,6 +2623,7 @@ from @file{infptrace.c} is good enough, leave it undefined.
The default value means that u.u_ar0 @emph{points to} the location of the
registers. I'm guessing that @code{#define U_REGS_OFFSET 0} means that
u.u_ar0 @emph{is} the location of the registers.
+
@end table
@node Obsolete Conditionals