From cdc647da07d5aa8116f75f1e429e7fccd2ce2f61 Mon Sep 17 00:00:00 2001 From: Stan Shebs Date: Fri, 15 Jul 1994 01:48:01 +0000 Subject: [PATCH] * gdbint.texinfo: Removed mentions of many incorrectly placed and obsolete conditionals, described some others. --- gdb/doc/ChangeLog | 5 + gdb/doc/gdbint.texinfo | 354 +++++++++++++++-------------------------- 2 files changed, 137 insertions(+), 222 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 36eb7c87970..afa86adcc3f 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 edd1d0b1b2d..929ee93ae0e 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 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 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 -- 2.30.2