gdb/defs.h

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