gdb/defs.h

   1 /* Basic, host-specific, and target-specific definitions for GDB.
   2    Copyright (C) 1986, 1989, 1991, 1992, 1993, 1994
   3    Free Software Foundation, Inc.
   4
   5 This file is part of GDB.
   6
   7 This program is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2 of the License, or
  10 (at your option) any later version.
  11
  12 This program is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with this program; if not, write to the Free Software
  19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  20
  21 #if !defined (DEFS_H)
  22 #define DEFS_H 1
  23
  24 #include <stdio.h>
  25
  26 /* First include ansidecl.h so we can use the various macro definitions
  27    here and in all subsequent file inclusions.  */
  28
  29 #include "ansidecl.h"
  30
  31 #include "libiberty.h"
  32
  33 /* libiberty.h can't declare this one, but evidently we can.  */
  34 extern char *strsignal PARAMS ((int));
  35
  36 /* For BFD64 and bfd_vma.  */
  37 #include "bfd.h"
  38
  39 /* An address in the program being debugged.  Host byte order.  Rather
  40    than duplicate all the logic in BFD which figures out what type
  41    this is (long, long long, etc.) and whether it needs to be 64
  42    bits (the host/target interactions are subtle), we just use
  43    bfd_vma.  */
  44
  45 typedef bfd_vma CORE_ADDR;
  46
  47 #define min(a, b) ((a) < (b) ? (a) : (b))
  48 #define max(a, b) ((a) > (b) ? (a) : (b))
  49
  50 /* Gdb does *lots* of string compares.  Use macros to speed them up by
  51    avoiding function calls if the first characters are not the same. */
  52
  53 #define STRCMP(a,b) (*(a) == *(b) ? strcmp ((a), (b)) : (int)*(a) - (int)*(b))
  54 #define STREQ(a,b) (*(a) == *(b) ? !strcmp ((a), (b)) : 0)
  55 #define STREQN(a,b,c) (*(a) == *(b) ? !strncmp ((a), (b), (c)) : 0)
  56
  57 /* The character GNU C++ uses to build identifiers that must be unique from
  58    the program's identifiers (such as $this and $$vptr).  */
  59 #define CPLUS_MARKER '$'        /* May be overridden to '.' for SysV */
  60
  61 #include <errno.h>              /* System call error return status */
  62
  63 extern int quit_flag;
  64 extern int immediate_quit;
  65 extern int sevenbit_strings;
  66
  67 extern void quit PARAMS ((void));
  68
  69 #define QUIT { if (quit_flag) quit (); if (interactive_hook) interactive_hook (); }
  70
  71 /* Command classes are top-level categories into which commands are broken
  72    down for "help" purposes.
  73    Notes on classes: class_alias is for alias commands which are not
  74    abbreviations of the original command.  class-pseudo is for commands
  75    which are not really commands nor help topics ("stop").  */
  76
  77 enum command_class
  78 {
  79   /* Special args to help_list */
  80   all_classes = -2, all_commands = -1,
  81   /* Classes of commands */
  82   no_class = -1, class_run = 0, class_vars, class_stack,
  83   class_files, class_support, class_info, class_breakpoint,
  84   class_alias, class_obscure, class_user, class_maintenance,
  85   class_pseudo
  86 };
  87
  88 /* Languages represented in the symbol table and elsewhere.
  89    This should probably be in language.h, but since enum's can't
  90    be forward declared to satisfy opaque references before their
  91    actual definition, needs to be here. */
  92
  93 enum language
  94 {
  95    language_unknown,            /* Language not known */
  96    language_auto,               /* Placeholder for automatic setting */
  97    language_c,                  /* C */
  98    language_cplus,              /* C++ */
  99    language_chill,              /* Chill */
 100    language_fortran,            /* Fortran */
 101    language_m2,                 /* Modula-2 */
 102    language_asm                 /* Assembly language */
 103 };
 104
 105 /* the cleanup list records things that have to be undone
 106    if an error happens (descriptors to be closed, memory to be freed, etc.)
 107    Each link in the chain records a function to call and an
 108    argument to give it.
 109
 110    Use make_cleanup to add an element to the cleanup chain.
 111    Use do_cleanups to do all cleanup actions back to a given
 112    point in the chain.  Use discard_cleanups to remove cleanups
 113    from the chain back to a given point, not doing them.  */
 114
 115 struct cleanup
 116 {
 117   struct cleanup *next;
 118   void (*function) PARAMS ((PTR));
 119   PTR arg;
 120 };
 121
 122 /* Needed for various prototypes */
 123
 124 #ifdef __STDC__
 125 struct symtab;
 126 struct breakpoint;
 127 #endif
 128
 129 /* From blockframe.c */
 130
 131 extern int inside_entry_func PARAMS ((CORE_ADDR));
 132
 133 extern int inside_entry_file PARAMS ((CORE_ADDR addr));
 134
 135 extern int inside_main_func PARAMS ((CORE_ADDR pc));
 136
 137 /* From ch-lang.c, for the moment. (FIXME) */
 138
 139 extern char *chill_demangle PARAMS ((const char *));
 140
 141 /* From libiberty.a */
 142
 143 extern char *cplus_demangle PARAMS ((const char *, int));
 144
 145 extern char *cplus_mangle_opname PARAMS ((char *, int));
 146
 147 /* From libmmalloc.a (memory mapped malloc library) */
 148
 149 extern PTR mmalloc_attach PARAMS ((int, PTR));
 150
 151 extern PTR mmalloc_detach PARAMS ((PTR));
 152
 153 extern PTR mmalloc PARAMS ((PTR, long));
 154
 155 extern PTR mrealloc PARAMS ((PTR, PTR, long));
 156
 157 extern void mfree PARAMS ((PTR, PTR));
 158
 159 extern int mmalloc_setkey PARAMS ((PTR, int, PTR));
 160
 161 extern PTR mmalloc_getkey PARAMS ((PTR, int));
 162
 163 /* From utils.c */
 164
 165 extern int strcmp_iw PARAMS ((const char *, const char *));
 166
 167 extern char *safe_strerror PARAMS ((int));
 168
 169 extern char *safe_strsignal PARAMS ((int));
 170
 171 extern void init_malloc PARAMS ((void *));
 172
 173 extern void request_quit PARAMS ((int));
 174
 175 extern void do_cleanups PARAMS ((struct cleanup *));
 176
 177 extern void discard_cleanups PARAMS ((struct cleanup *));
 178
 179 /* The bare make_cleanup function is one of those rare beasts that
 180    takes almost any type of function as the first arg and anything that
 181    will fit in a "void *" as the second arg.
 182
 183    Should be, once all calls and called-functions are cleaned up:
 184 extern struct cleanup *
 185 make_cleanup PARAMS ((void (*function) (void *), void *));
 186
 187    Until then, lint and/or various type-checking compiler options will
 188    complain about make_cleanup calls.  It'd be wrong to just cast things,
 189    since the type actually passed when the function is called would be
 190    wrong.  */
 191
 192 extern struct cleanup *make_cleanup ();
 193
 194 extern struct cleanup *save_cleanups PARAMS ((void));
 195
 196 extern void restore_cleanups PARAMS ((struct cleanup *));
 197
 198 extern void free_current_contents PARAMS ((char **));
 199
 200 extern void null_cleanup PARAMS ((char **));
 201
 202 extern int myread PARAMS ((int, char *, int));
 203
 204 extern int query ();
 205 \f
 206 /* Annotation stuff.  */
 207
 208 extern int annotation_level; /* in stack.c */
 209 \f
 210 extern void begin_line PARAMS ((void));
 211
 212 extern void wrap_here PARAMS ((char *));
 213
 214 extern void reinitialize_more_filter PARAMS ((void));
 215
 216 typedef FILE GDB_FILE;
 217 #define gdb_stdout stdout
 218 #define gdb_stderr stderr
 219
 220 extern int print_insn PARAMS ((CORE_ADDR, GDB_FILE *));
 221
 222 extern void gdb_flush PARAMS ((GDB_FILE *));
 223
 224 extern GDB_FILE *gdb_fopen PARAMS ((char * name, char * mode));
 225
 226 extern void fputs_filtered PARAMS ((const char *, GDB_FILE *));
 227
 228 extern void fputs_unfiltered PARAMS ((const char *, GDB_FILE *));
 229
 230 extern void fputc_unfiltered PARAMS ((int, GDB_FILE *));
 231
 232 extern void putc_unfiltered PARAMS ((int));
 233
 234 #define putchar_unfiltered(C)  putc_unfiltered(C)
 235
 236 extern void puts_filtered PARAMS ((char *));
 237
 238 extern void puts_unfiltered PARAMS ((char *));
 239
 240 extern void vprintf_filtered ();
 241
 242 extern void vfprintf_filtered ();
 243
 244 extern void fprintf_filtered ();
 245
 246 extern void fprintfi_filtered ();
 247
 248 extern void printf_filtered ();
 249
 250 extern void printfi_filtered ();
 251
 252 extern void vprintf_unfiltered ();
 253
 254 extern void vfprintf_unfiltered ();
 255
 256 extern void fprintf_unfiltered ();
 257
 258 extern void printf_unfiltered ();
 259
 260 extern void print_spaces PARAMS ((int, GDB_FILE *));
 261
 262 extern void print_spaces_filtered PARAMS ((int, GDB_FILE *));
 263
 264 extern char *n_spaces PARAMS ((int));
 265
 266 extern void gdb_printchar PARAMS ((int, GDB_FILE *, int));
 267
 268 extern void gdb_print_address PARAMS ((void *, GDB_FILE *));
 269
 270 extern void fprintf_symbol_filtered PARAMS ((GDB_FILE *, char *,
 271                                              enum language, int));
 272
 273 extern void perror_with_name PARAMS ((char *));
 274
 275 extern void print_sys_errmsg PARAMS ((char *, int));
 276
 277 /* From regex.c or libc.  BSD 4.4 declares this with the argument type as
 278    "const char *" in unistd.h, so we can't declare the argument
 279    as "char *".  */
 280
 281 extern char *re_comp PARAMS ((const char *));
 282
 283 /* From symfile.c */
 284
 285 extern void symbol_file_command PARAMS ((char *, int));
 286
 287 /* From main.c */
 288
 289 extern char *skip_quoted PARAMS ((char *));
 290
 291 extern char *gdb_readline PARAMS ((char *));
 292
 293 extern char *command_line_input PARAMS ((char *, int, char *));
 294
 295 extern void print_prompt PARAMS ((void));
 296
 297 extern int input_from_terminal_p PARAMS ((void));
 298
 299 /* From printcmd.c */
 300
 301 extern void set_next_address PARAMS ((CORE_ADDR));
 302
 303 extern void print_address_symbolic PARAMS ((CORE_ADDR, GDB_FILE *, int,
 304                                             char *));
 305
 306 extern void print_address_numeric PARAMS ((CORE_ADDR, int, GDB_FILE *));
 307
 308 extern void print_address PARAMS ((CORE_ADDR, GDB_FILE *));
 309
 310 /* From source.c */
 311
 312 extern int openp PARAMS ((char *, int, char *, int, int, char **));
 313
 314 extern void mod_path PARAMS ((char *, char **));
 315
 316 extern void directory_command PARAMS ((char *, int));
 317
 318 extern void init_source_path PARAMS ((void));
 319
 320 extern char *symtab_to_filename PARAMS ((struct symtab *));
 321
 322 /* From findvar.c */
 323
 324 extern int read_relative_register_raw_bytes PARAMS ((int, char *));
 325
 326 /* From readline (but not in any readline .h files).  */
 327
 328 extern char *tilde_expand PARAMS ((char *));
 329
 330 /* Control types for commands */
 331
 332 enum misc_command_type
 333 {
 334   ok_command,
 335   end_command,
 336   else_command,
 337   nop_command
 338 };
 339
 340 enum command_control_type
 341 {
 342   simple_control,
 343   break_control,
 344   continue_control,
 345   while_control,
 346   if_control,
 347   invalid_control
 348 };
 349
 350 /* Structure for saved commands lines
 351    (for breakpoints, defined commands, etc).  */
 352
 353 struct command_line
 354 {
 355   struct command_line *next;
 356   char *line;
 357   enum command_control_type control_type;
 358   int body_count;
 359   struct command_line **body_list;
 360 };
 361
 362 extern struct command_line *read_command_lines PARAMS ((void));
 363
 364 extern void free_command_lines PARAMS ((struct command_line **));
 365
 366 /* String containing the current directory (what getwd would return).  */
 367
 368 extern char *current_directory;
 369
 370 /* Default radixes for input and output.  Only some values supported.  */
 371 extern unsigned input_radix;
 372 extern unsigned output_radix;
 373
 374 /* Possibilities for prettyprint parameters to routines which print
 375    things.  Like enum language, this should be in value.h, but needs
 376    to be here for the same reason.  FIXME:  If we can eliminate this
 377    as an arg to LA_VAL_PRINT, then we can probably move it back to
 378    value.h. */
 379
 380 enum val_prettyprint
 381 {
 382   Val_no_prettyprint = 0,
 383   Val_prettyprint,
 384   /* Use the default setting which the user has specified.  */
 385   Val_pretty_default
 386 };
 387
 388 \f
 389 /* Host machine definition.  This will be a symlink to one of the
 390    xm-*.h files, built by the `configure' script.  */
 391
 392 #include "xm.h"
 393
 394 /* Native machine support.  This will be a symlink to one of the
 395    nm-*.h files, built by the `configure' script.  */
 396
 397 #include "nm.h"
 398
 399 /* If the xm.h file did not define the mode string used to open the
 400    files, assume that binary files are opened the same way as text
 401    files */
 402 #ifndef FOPEN_RB
 403 #include "fopen-same.h"
 404 #endif
 405
 406 /*
 407  * Allow things in gdb to be declared "const".  If compiling ANSI, it
 408  * just works.  If compiling with gcc but non-ansi, redefine to __const__.
 409  * If non-ansi, non-gcc, then eliminate "const" entirely, making those
 410  * objects be read-write rather than read-only.
 411  */
 412
 413 #ifndef const
 414 #ifndef __STDC__
 415 # ifdef __GNUC__
 416 #  define const __const__
 417 # else
 418 #  define const /*nothing*/
 419 # endif /* GNUC */
 420 #endif /* STDC */
 421 #endif /* const */
 422
 423 #ifndef volatile
 424 #ifndef __STDC__
 425 # ifdef __GNUC__
 426 #  define volatile __volatile__
 427 # else
 428 #  define volatile /*nothing*/
 429 # endif /* GNUC */
 430 #endif /* STDC */
 431 #endif /* volatile */
 432
 433 /* The ability to declare that a function never returns is useful, but
 434    not really required to compile GDB successfully, so the NORETURN and
 435    ATTR_NORETURN macros normally expand into nothing.  */
 436
 437 /* If compiling with older versions of GCC, a function may be declared
 438    "volatile" to indicate that it does not return.  */
 439
 440 #ifndef NORETURN
 441 # if defined(__GNUC__) \
 442      && (__GNUC__ == 1 || (__GNUC__ == 2 && __GNUC_MINOR__ < 5))
 443 #  define NORETURN volatile
 444 # else
 445 #  define NORETURN /* nothing */
 446 # endif
 447 #endif
 448
 449 /* GCC 2.5 and later versions define a function attribute "noreturn",
 450    which is the preferred way to declare that a function never returns.  */
 451
 452 #ifndef ATTR_NORETURN
 453 # if defined(__GNUC__) && __GNUC__ >= 2 && __GNUC_MINOR__ >= 5
 454 #  define ATTR_NORETURN __attribute__ ((noreturn))
 455 # else
 456 #  define ATTR_NORETURN /* nothing */
 457 # endif
 458 #endif
 459
 460 /* Defaults for system-wide constants (if not defined by xm.h, we fake it).  */
 461
 462 #if !defined (UINT_MAX)
 463 #define UINT_MAX ((unsigned int)(~0))           /* 0xFFFFFFFF for 32-bits */
 464 #endif
 465
 466 #if !defined (INT_MAX)
 467 #define INT_MAX ((int)(UINT_MAX >> 1))          /* 0x7FFFFFFF for 32-bits */
 468 #endif
 469
 470 #if !defined (INT_MIN)
 471 #define INT_MIN (-INT_MAX - 1)                  /* 0x80000000 for 32-bits */
 472 #endif
 473
 474 #if !defined (ULONG_MAX)
 475 #define ULONG_MAX ((unsigned long)(~0L))        /* 0xFFFFFFFF for 32-bits */
 476 #endif
 477
 478 #if !defined (LONG_MAX)
 479 #define LONG_MAX ((long)(ULONG_MAX >> 1))       /* 0x7FFFFFFF for 32-bits */
 480 #endif
 481
 482 #ifdef BFD64
 483
 484 /* This is to make sure that LONGEST is at least as big as CORE_ADDR.  */
 485
 486 #define LONGEST BFD_HOST_64_BIT
 487
 488 #else /* No BFD64 */
 489
 490 /* If all compilers for this host support "long long" and we want to
 491    use it for LONGEST (the performance hit is about 10% on a testsuite
 492    run based on one DECstation test), then the xm.h file can define
 493    CC_HAS_LONG_LONG.
 494
 495    Using GCC 1.39 on BSDI with long long causes about 700 new
 496    testsuite failures.  Using long long for LONGEST on the DECstation
 497    causes 3 new FAILs in the testsuite and many heuristic fencepost
 498    warnings.  These are not investigated, but a first guess would be
 499    that the BSDI problems are GCC bugs in long long support and the
 500    latter are GDB bugs.  */
 501
 502 #ifndef CC_HAS_LONG_LONG
 503 #  if defined (__GNUC__) && defined (FORCE_LONG_LONG)
 504 #    define CC_HAS_LONG_LONG 1
 505 #  endif
 506 #endif
 507
 508 /* LONGEST should not be a typedef, because "unsigned LONGEST" needs to work.
 509    CC_HAS_LONG_LONG is defined if the host compiler supports "long long"
 510    variables and we wish to make use of that support.  */
 511
 512 #ifndef LONGEST
 513 #  ifdef CC_HAS_LONG_LONG
 514 #    define LONGEST long long
 515 #  else
 516 #    define LONGEST long
 517 #  endif
 518 #endif
 519
 520 #endif /* No BFD64 */
 521
 522 /* Convert a LONGEST to an int.  This is used in contexts (e.g. number of
 523    arguments to a function, number in a value history, register number, etc.)
 524    where the value must not be larger than can fit in an int.  */
 525
 526 extern int longest_to_int PARAMS ((LONGEST));
 527
 528 /* Assorted functions we can declare, now that const and volatile are
 529    defined.  */
 530
 531 extern char *savestring PARAMS ((const char *, int));
 532
 533 extern char *msavestring PARAMS ((void *, const char *, int));
 534
 535 extern char *strsave PARAMS ((const char *));
 536
 537 extern char *mstrsave PARAMS ((void *, const char *));
 538
 539 extern PTR xmalloc PARAMS ((long));
 540
 541 extern PTR xrealloc PARAMS ((PTR, long));
 542
 543 extern PTR xmmalloc PARAMS ((PTR, long));
 544
 545 extern PTR xmrealloc PARAMS ((PTR, PTR, long));
 546
 547 extern PTR mmalloc PARAMS ((PTR, long));
 548
 549 extern PTR mrealloc PARAMS ((PTR, PTR, long));
 550
 551 extern void mfree PARAMS ((PTR, PTR));
 552
 553 extern int mmcheck PARAMS ((PTR, void (*) (void)));
 554
 555 extern int mmtrace PARAMS ((void));
 556
 557 extern int parse_escape PARAMS ((char **));
 558
 559 extern const char * const reg_names[];
 560
 561 /* Message to be printed before the error message, when an error occurs.  */
 562
 563 extern char *error_pre_print;
 564
 565 /* Message to be printed before the warning message, when a warning occurs.  */
 566
 567 extern char *warning_pre_print;
 568
 569 extern NORETURN void error () ATTR_NORETURN;
 570
 571 extern void error_begin PARAMS ((void));
 572
 573 extern NORETURN void fatal () ATTR_NORETURN;
 574
 575 extern NORETURN void exit PARAMS ((int)) ATTR_NORETURN; /* 4.10.4.3 */
 576
 577 extern NORETURN void nomem PARAMS ((long)) ATTR_NORETURN;
 578
 579 /* Reasons for calling return_to_top_level.  */
 580 enum return_reason {
 581   /* User interrupt.  */
 582   RETURN_QUIT,
 583
 584   /* Any other error.  */
 585   RETURN_ERROR
 586 };
 587
 588 #define RETURN_MASK_QUIT (1 << (int)RETURN_QUIT)
 589 #define RETURN_MASK_ERROR (1 << (int)RETURN_ERROR)
 590 #define RETURN_MASK_ALL (RETURN_MASK_QUIT | RETURN_MASK_ERROR)
 591 typedef int return_mask;
 592
 593 extern NORETURN void
 594 return_to_top_level PARAMS ((enum return_reason)) ATTR_NORETURN;
 595
 596 extern int
 597 catch_errors PARAMS ((int (*) (char *), void *, char *, return_mask));
 598
 599 extern void warning_setup PARAMS ((void));
 600
 601 extern void warning ();
 602
 603 /* Global functions from other, non-gdb GNU thingies.
 604    Libiberty thingies are no longer declared here.  We include libiberty.h
 605    above, instead.  */
 606
 607 extern char *getenv PARAMS ((const char *));
 608
 609 /* From other system libraries */
 610
 611 #ifndef PSIGNAL_IN_SIGNAL_H
 612 extern void psignal PARAMS ((unsigned, const char *));
 613 #endif
 614
 615 /* For now, we can't include <stdlib.h> because it conflicts with
 616    "../include/getopt.h".  (FIXME)
 617
 618    However, if a function is defined in the ANSI C standard and a prototype
 619    for that function is defined and visible in any header file in an ANSI
 620    conforming environment, then that prototype must match the definition in
 621    the ANSI standard.  So we can just duplicate them here without conflict,
 622    since they must be the same in all conforming ANSI environments.  If
 623    these cause problems, then the environment is not ANSI conformant. */
 624
 625 #ifdef __STDC__
 626 #include <stddef.h>
 627 #endif
 628
 629 extern int fclose PARAMS ((GDB_FILE *stream));          /* 4.9.5.1 */
 630
 631 extern void perror PARAMS ((const char *));             /* 4.9.10.4 */
 632
 633 extern double atof PARAMS ((const char *nptr));         /* 4.10.1.1 */
 634
 635 extern int atoi PARAMS ((const char *));                /* 4.10.1.2 */
 636
 637 #ifndef MALLOC_INCOMPATIBLE
 638
 639 extern PTR malloc PARAMS ((size_t size));               /* 4.10.3.3 */
 640
 641 extern PTR realloc PARAMS ((void *ptr, size_t size));   /* 4.10.3.4 */
 642
 643 extern void free PARAMS ((void *));                     /* 4.10.3.2 */
 644
 645 #endif  /* MALLOC_INCOMPATIBLE */
 646
 647 extern void
 648 qsort PARAMS ((void *base, size_t nmemb,                /* 4.10.5.2 */
 649                size_t size,
 650                int (*compar)(const void *, const void *)));
 651
 652 #ifndef MEM_FNS_DECLARED        /* Some non-ANSI use void *, not char *.  */
 653 extern PTR memcpy PARAMS ((void *, const void *, size_t));  /* 4.11.2.1 */
 654
 655 extern int memcmp PARAMS ((const void *, const void *, size_t)); /* 4.11.4.1 */
 656 #endif
 657
 658 extern char *strchr PARAMS ((const char *, int));       /* 4.11.5.2 */
 659
 660 extern char *strrchr PARAMS ((const char *, int));      /* 4.11.5.5 */
 661
 662 extern char *strstr PARAMS ((const char *, const char *)); /* 4.11.5.7 */
 663
 664 extern char *strtok PARAMS ((char *, const char *));    /* 4.11.5.8 */
 665
 666 #ifndef MEM_FNS_DECLARED        /* Some non-ANSI use void *, not char *.  */
 667 extern PTR memset PARAMS ((void *, int, size_t));       /* 4.11.6.1 */
 668 #endif
 669
 670 extern char *strerror PARAMS ((int));                   /* 4.11.6.2 */
 671
 672 /* Various possibilities for alloca.  */
 673 #ifndef alloca
 674 # ifdef __GNUC__
 675 #  define alloca __builtin_alloca
 676 # else /* Not GNU C */
 677 #  ifdef sparc
 678 #   include <alloca.h>          /* NOTE:  Doesn't declare alloca() */
 679 #  endif
 680
 681 /* We need to be careful not to declare this in a way which conflicts with
 682    bison.  Bison never declares it as char *, but under various circumstances
 683    (like __hpux) we need to use void *.  */
 684 #  if defined (__STDC__) || defined (__hpux)
 685    extern void *alloca ();
 686 #  else /* Don't use void *.  */
 687    extern char *alloca ();
 688 #  endif /* Don't use void *.  */
 689 # endif /* Not GNU C */
 690 #endif /* alloca not defined */
 691
 692 /* HOST_BYTE_ORDER must be defined to one of these.  */
 693
 694 #if !defined (BIG_ENDIAN)
 695 #define BIG_ENDIAN 4321
 696 #endif
 697
 698 #if !defined (LITTLE_ENDIAN)
 699 #define LITTLE_ENDIAN 1234
 700 #endif
 701
 702 /* Target-system-dependent parameters for GDB. */
 703
 704 /* Target machine definition.  This will be a symlink to one of the
 705    tm-*.h files, built by the `configure' script.  */
 706
 707 #include "tm.h"
 708
 709 #ifdef TARGET_BYTE_ORDER_SELECTABLE
 710 /* The target endianness is selectable at runtime.  Define
 711    TARGET_BYTE_ORDER to be a variable.  The user can use the `set
 712    endian' command to change it.  */
 713 #undef TARGET_BYTE_ORDER
 714 #define TARGET_BYTE_ORDER target_byte_order
 715 extern int target_byte_order;
 716 #endif
 717
 718 extern void set_endian_from_file PARAMS ((bfd *));
 719
 720 /* Number of bits in a char or unsigned char for the target machine.
 721    Just like CHAR_BIT in <limits.h> but describes the target machine.  */
 722 #if !defined (TARGET_CHAR_BIT)
 723 #define TARGET_CHAR_BIT 8
 724 #endif
 725
 726 /* Number of bits in a short or unsigned short for the target machine. */
 727 #if !defined (TARGET_SHORT_BIT)
 728 #define TARGET_SHORT_BIT (2 * TARGET_CHAR_BIT)
 729 #endif
 730
 731 /* Number of bits in an int or unsigned int for the target machine. */
 732 #if !defined (TARGET_INT_BIT)
 733 #define TARGET_INT_BIT (4 * TARGET_CHAR_BIT)
 734 #endif
 735
 736 /* Number of bits in a long or unsigned long for the target machine. */
 737 #if !defined (TARGET_LONG_BIT)
 738 #define TARGET_LONG_BIT (4 * TARGET_CHAR_BIT)
 739 #endif
 740
 741 /* Number of bits in a long long or unsigned long long for the target machine. */
 742 #if !defined (TARGET_LONG_LONG_BIT)
 743 #define TARGET_LONG_LONG_BIT (2 * TARGET_LONG_BIT)
 744 #endif
 745
 746 /* Number of bits in a float for the target machine. */
 747 #if !defined (TARGET_FLOAT_BIT)
 748 #define TARGET_FLOAT_BIT (4 * TARGET_CHAR_BIT)
 749 #endif
 750
 751 /* Number of bits in a double for the target machine. */
 752 #if !defined (TARGET_DOUBLE_BIT)
 753 #define TARGET_DOUBLE_BIT (8 * TARGET_CHAR_BIT)
 754 #endif
 755
 756 /* Number of bits in a long double for the target machine.  */
 757 #if !defined (TARGET_LONG_DOUBLE_BIT)
 758 #define TARGET_LONG_DOUBLE_BIT (2 * TARGET_DOUBLE_BIT)
 759 #endif
 760
 761 /* Number of bits in a "complex" for the target machine. */
 762 #if !defined (TARGET_COMPLEX_BIT)
 763 #define TARGET_COMPLEX_BIT (2 * TARGET_FLOAT_BIT)
 764 #endif
 765
 766 /* Number of bits in a "double complex" for the target machine. */
 767 #if !defined (TARGET_DOUBLE_COMPLEX_BIT)
 768 #define TARGET_DOUBLE_COMPLEX_BIT (2 * TARGET_DOUBLE_BIT)
 769 #endif
 770
 771 /* Number of bits in a pointer for the target machine */
 772 #if !defined (TARGET_PTR_BIT)
 773 #define TARGET_PTR_BIT TARGET_INT_BIT
 774 #endif
 775
 776 /* If we picked up a copy of CHAR_BIT from a configuration file
 777    (which may get it by including <limits.h>) then use it to set
 778    the number of bits in a host char.  If not, use the same size
 779    as the target. */
 780
 781 #if defined (CHAR_BIT)
 782 #define HOST_CHAR_BIT CHAR_BIT
 783 #else
 784 #define HOST_CHAR_BIT TARGET_CHAR_BIT
 785 #endif
 786
 787 /* The bit byte-order has to do just with numbering of bits in
 788    debugging symbols and such.  Conceptually, it's quite separate
 789    from byte/word byte order.  */
 790
 791 #if !defined (BITS_BIG_ENDIAN)
 792 #ifndef TARGET_BYTE_ORDER_SELECTABLE
 793
 794 #if TARGET_BYTE_ORDER == BIG_ENDIAN
 795 #define BITS_BIG_ENDIAN 1
 796 #endif /* Big endian.  */
 797
 798 #if TARGET_BYTE_ORDER == LITTLE_ENDIAN
 799 #define BITS_BIG_ENDIAN 0
 800 #endif /* Little endian.  */
 801
 802 #else /* defined (TARGET_BYTE_ORDER_SELECTABLE) */
 803
 804 #define BITS_BIG_ENDIAN (TARGET_BYTE_ORDER == BIG_ENDIAN)
 805
 806 #endif /* defined (TARGET_BYTE_ORDER_SELECTABLE) */
 807 #endif /* BITS_BIG_ENDIAN not defined.  */
 808
 809 /* In findvar.c.  */
 810
 811 extern LONGEST extract_signed_integer PARAMS ((void *, int));
 812
 813 extern unsigned LONGEST extract_unsigned_integer PARAMS ((void *, int));
 814
 815 extern CORE_ADDR extract_address PARAMS ((void *, int));
 816
 817 extern void store_signed_integer PARAMS ((void *, int, LONGEST));
 818
 819 extern void store_unsigned_integer PARAMS ((void *, int, unsigned LONGEST));
 820
 821 extern void store_address PARAMS ((void *, int, CORE_ADDR));
 822
 823 extern double extract_floating PARAMS ((void *, int));
 824
 825 extern void store_floating PARAMS ((void *, int, double));
 826 \f
 827 /* On some machines there are bits in addresses which are not really
 828    part of the address, but are used by the kernel, the hardware, etc.
 829    for special purposes.  ADDR_BITS_REMOVE takes out any such bits
 830    so we get a "real" address such as one would find in a symbol
 831    table.  This is used only for addresses of instructions, and even then
 832    I'm not sure it's used in all contexts.  It exists to deal with there
 833    being a few stray bits in the PC which would mislead us, not as some sort
 834    of generic thing to handle alignment or segmentation (it's possible it
 835    should be in TARGET_READ_PC instead).  */
 836 #if !defined (ADDR_BITS_REMOVE)
 837 #define ADDR_BITS_REMOVE(addr) (addr)
 838 #endif /* No ADDR_BITS_REMOVE.  */
 839
 840 /* From valops.c */
 841
 842 extern CORE_ADDR push_bytes PARAMS ((CORE_ADDR, char *, int));
 843
 844 extern CORE_ADDR push_word PARAMS ((CORE_ADDR, unsigned LONGEST));
 845
 846 /* Some parts of gdb might be considered optional, in the sense that they
 847    are not essential for being able to build a working, usable debugger
 848    for a specific environment.  For example, the maintenance commands
 849    are there for the benefit of gdb maintainers.  As another example,
 850    some environments really don't need gdb's that are able to read N
 851    different object file formats.  In order to make it possible (but
 852    not necessarily recommended) to build "stripped down" versions of
 853    gdb, the following defines control selective compilation of those
 854    parts of gdb which can be safely left out when necessary.  Note that
 855    the default is to include everything. */
 856
 857 #ifndef MAINTENANCE_CMDS
 858 #define MAINTENANCE_CMDS 1
 859 #endif
 860
 861 /* Hooks for alternate command interfaces.  */
 862
 863 extern void (*init_ui_hook) PARAMS ((void));
 864 extern void (*command_loop_hook) PARAMS ((void));
 865 extern void (*fputs_unfiltered_hook) PARAMS ((const char *linebuffer));
 866 extern void (*print_frame_info_listing_hook) PARAMS ((struct symtab *s, int line,
 867                                                int stopline, int noerror));
 868 extern int (*query_hook) PARAMS (());
 869 extern void (*flush_hook) PARAMS ((FILE *stream));
 870 extern void (*create_breakpoint_hook) PARAMS ((struct breakpoint *b));
 871 extern void (*delete_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
 872 extern void (*enable_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
 873 extern void (*disable_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
 874 extern void (*interactive_hook) PARAMS ((void));
 875
 876 #ifdef __STDC__
 877 struct target_waitstatus;
 878 struct cmd_list_element;
 879 #endif
 880
 881 extern int (*target_wait_hook) PARAMS ((int pid,
 882                                         struct target_waitstatus *status));
 883
 884 extern void (*call_command_hook) PARAMS ((struct cmd_list_element *c,
 885                                           char *cmd, int from_tty));
 886
 887 /* Inhibit window interface if non-zero. */
 888
 889 extern int use_windows;
 890
 891 #endif /* !defined (DEFS_H) */