gdb/defs.h

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