gdb/defs.h

   1 /* *INDENT-OFF* */ /* ATTRIBUTE_PRINTF confuses indent, avoid running it
   2                       for now.  */
   3 /* Basic, host-specific, and target-specific definitions for GDB.
   4    Copyright (C) 1986-2017 Free Software Foundation, Inc.
   5
   6    This file is part of GDB.
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  20
  21 #ifndef DEFS_H
  22 #define DEFS_H
  23
  24 #ifdef GDBSERVER
  25 #  error gdbserver should not include gdb/defs.h
  26 #endif
  27
  28 #include "common-defs.h"
  29
  30 #include <sys/types.h>
  31 #include <limits.h>
  32
  33 /* The libdecnumber library, on which GDB depends, includes a header file
  34    called gstdint.h instead of relying directly on stdint.h.  GDB, on the
  35    other hand, includes stdint.h directly, relying on the fact that gnulib
  36    generates a copy if the system doesn't provide one or if it is missing
  37    some features.  Unfortunately, gstdint.h and stdint.h cannot be included
  38    at the same time, which may happen when we include a file from
  39    libdecnumber.
  40
  41    The following macro definition effectively prevents the inclusion of
  42    gstdint.h, as all the definitions it provides are guarded against
  43    the GCC_GENERATED_STDINT_H macro.  We already have gnulib/stdint.h
  44    included, so it's ok to blank out gstdint.h.  */
  45 #define GCC_GENERATED_STDINT_H 1
  46
  47 #include <unistd.h>
  48
  49 #include <fcntl.h>
  50
  51 #include "gdb_wchar.h"
  52
  53 #include "ui-file.h"
  54
  55 #include "host-defs.h"
  56 #include "common/enum-flags.h"
  57
  58 /* Scope types enumerator.  List the types of scopes the compiler will
  59    accept.  */
  60
  61 enum compile_i_scope_types
  62   {
  63     COMPILE_I_INVALID_SCOPE,
  64
  65     /* A simple scope.  Wrap an expression into a simple scope that
  66        takes no arguments, returns no value, and uses the generic
  67        function name "_gdb_expr". */
  68
  69     COMPILE_I_SIMPLE_SCOPE,
  70
  71     /* Do not wrap the expression,
  72        it has to provide function "_gdb_expr" on its own.  */
  73     COMPILE_I_RAW_SCOPE,
  74
  75     /* A printable expression scope.  Wrap an expression into a scope
  76        suitable for the "compile print" command.  It uses the generic
  77        function name "_gdb_expr".  COMPILE_I_PRINT_ADDRESS_SCOPE variant
  78        is the usual one, taking address of the object.
  79        COMPILE_I_PRINT_VALUE_SCOPE is needed for arrays where the array
  80        name already specifies its address.  See get_out_value_type.  */
  81     COMPILE_I_PRINT_ADDRESS_SCOPE,
  82     COMPILE_I_PRINT_VALUE_SCOPE,
  83   };
  84
  85
  86 template<typename T>
  87 using RequireLongest = gdb::Requires<gdb::Or<std::is_same<T, LONGEST>,
  88                                              std::is_same<T, ULONGEST>>>;
  89
  90 /* Just in case they're not defined in stdio.h.  */
  91
  92 #ifndef SEEK_SET
  93 #define SEEK_SET 0
  94 #endif
  95 #ifndef SEEK_CUR
  96 #define SEEK_CUR 1
  97 #endif
  98
  99 /* The O_BINARY flag is defined in fcntl.h on some non-Posix platforms.
 100    It is used as an access modifier in calls to open(), where it acts
 101    similarly to the "b" character in fopen()'s MODE argument.  On Posix
 102    platforms it should be a no-op, so it is defined as 0 here.  This
 103    ensures that the symbol may be used freely elsewhere in gdb.  */
 104
 105 #ifndef O_BINARY
 106 #define O_BINARY 0
 107 #endif
 108
 109 #include "hashtab.h"
 110
 111 /* * Enable dbx commands if set.  */
 112 extern int dbx_commands;
 113
 114 /* * System root path, used to find libraries etc.  */
 115 extern char *gdb_sysroot;
 116
 117 /* * GDB datadir, used to store data files.  */
 118 extern char *gdb_datadir;
 119
 120 /* * If non-NULL, the possibly relocated path to python's "lib" directory
 121    specified with --with-python.  */
 122 extern char *python_libdir;
 123
 124 /* * Search path for separate debug files.  */
 125 extern char *debug_file_directory;
 126
 127 /* GDB's SIGINT handler basically sets a flag; code that might take a
 128    long time before it gets back to the event loop, and which ought to
 129    be interruptible, checks this flag using the QUIT macro, which, if
 130    GDB has the terminal, throws a quit exception.
 131
 132    In addition to setting a flag, the SIGINT handler also marks a
 133    select/poll-able file descriptor as read-ready.  That is used by
 134    interruptible_select in order to support interrupting blocking I/O
 135    in a race-free manner.
 136
 137    These functions use the extension_language_ops API to allow extension
 138    language(s) and GDB SIGINT handling to coexist seamlessly.  */
 139
 140 /* * Evaluate to non-zero if the quit flag is set, zero otherwise.  This
 141    will clear the quit flag as a side effect.  */
 142 extern int check_quit_flag (void);
 143 /* * Set the quit flag.  */
 144 extern void set_quit_flag (void);
 145
 146 /* The current quit handler (and its type).  This is called from the
 147    QUIT macro.  See default_quit_handler below for default behavior.
 148    Parts of GDB temporarily override this to e.g., completely suppress
 149    Ctrl-C because it would not be safe to throw.  E.g., normally, you
 150    wouldn't want to quit between a RSP command and its response, as
 151    that would break the communication with the target, but you may
 152    still want to intercept the Ctrl-C and offer to disconnect if the
 153    user presses Ctrl-C multiple times while the target is stuck
 154    waiting for the wedged remote stub.  */
 155 typedef void (quit_handler_ftype) (void);
 156 extern quit_handler_ftype *quit_handler;
 157
 158 /* Override the current quit handler.  Sets NEW_QUIT_HANDLER as
 159    current quit handler, and installs a cleanup that when run restores
 160    the previous quit handler.  */
 161 struct cleanup *
 162   make_cleanup_override_quit_handler (quit_handler_ftype *new_quit_handler);
 163
 164 /* The default quit handler.  Checks whether Ctrl-C was pressed, and
 165    if so:
 166
 167      - If GDB owns the terminal, throws a quit exception.
 168
 169      - If GDB does not own the terminal, forwards the Ctrl-C to the
 170        target.
 171 */
 172 extern void default_quit_handler (void);
 173
 174 /* Flag that function quit should call quit_force.  */
 175 extern volatile int sync_quit_force_run;
 176
 177 extern void quit (void);
 178
 179 /* Helper for the QUIT macro.  */
 180
 181 extern void maybe_quit (void);
 182
 183 /* Check whether a Ctrl-C was typed, and if so, call the current quit
 184    handler.  */
 185 #define QUIT maybe_quit ()
 186
 187 /* Set the serial event associated with the quit flag.  */
 188 extern void quit_serial_event_set (void);
 189
 190 /* Clear the serial event associated with the quit flag.  */
 191 extern void quit_serial_event_clear (void);
 192
 193 /* * Languages represented in the symbol table and elsewhere.
 194    This should probably be in language.h, but since enum's can't
 195    be forward declared to satisfy opaque references before their
 196    actual definition, needs to be here.
 197
 198    The constants here are in priority order.  In particular,
 199    demangling is attempted according to this order.
 200
 201    Note that there's ambiguity between the mangling schemes of some of
 202    these languages, so some symbols could be successfully demangled by
 203    several languages.  For that reason, the constants here are sorted
 204    in the order we'll attempt demangling them.  For example: Rust uses
 205    C++ mangling, so must come after C++; Ada must come last (see
 206    ada_sniff_from_mangled_name).  (Keep this order in sync with the
 207    'languages' array in language.c.)  */
 208
 209 enum language
 210   {
 211     language_unknown,           /* Language not known */
 212     language_auto,              /* Placeholder for automatic setting */
 213     language_c,                 /* C */
 214     language_objc,              /* Objective-C */
 215     language_cplus,             /* C++ */
 216     language_d,                 /* D */
 217     language_go,                /* Go */
 218     language_fortran,           /* Fortran */
 219     language_m2,                /* Modula-2 */
 220     language_asm,               /* Assembly language */
 221     language_pascal,            /* Pascal */
 222     language_opencl,            /* OpenCL */
 223     language_rust,              /* Rust */
 224     language_minimal,           /* All other languages, minimal support only */
 225     language_ada,               /* Ada */
 226     nr_languages
 227   };
 228
 229 /* The number of bits needed to represent all languages, with enough
 230    padding to allow for reasonable growth.  */
 231 #define LANGUAGE_BITS 5
 232 gdb_static_assert (nr_languages <= (1 << LANGUAGE_BITS));
 233
 234 enum precision_type
 235   {
 236     single_precision,
 237     double_precision,
 238     unspecified_precision
 239   };
 240
 241 /* * A generic, not quite boolean, enumeration.  This is used for
 242    set/show commands in which the options are on/off/automatic.  */
 243 enum auto_boolean
 244 {
 245   AUTO_BOOLEAN_TRUE,
 246   AUTO_BOOLEAN_FALSE,
 247   AUTO_BOOLEAN_AUTO
 248 };
 249
 250 /* * Potential ways that a function can return a value of a given
 251    type.  */
 252
 253 enum return_value_convention
 254 {
 255   /* * Where the return value has been squeezed into one or more
 256      registers.  */
 257   RETURN_VALUE_REGISTER_CONVENTION,
 258   /* * Commonly known as the "struct return convention".  The caller
 259      passes an additional hidden first parameter to the caller.  That
 260      parameter contains the address at which the value being returned
 261      should be stored.  While typically, and historically, used for
 262      large structs, this is convention is applied to values of many
 263      different types.  */
 264   RETURN_VALUE_STRUCT_CONVENTION,
 265   /* * Like the "struct return convention" above, but where the ABI
 266      guarantees that the called function stores the address at which
 267      the value being returned is stored in a well-defined location,
 268      such as a register or memory slot in the stack frame.  Don't use
 269      this if the ABI doesn't explicitly guarantees this.  */
 270   RETURN_VALUE_ABI_RETURNS_ADDRESS,
 271   /* * Like the "struct return convention" above, but where the ABI
 272      guarantees that the address at which the value being returned is
 273      stored will be available in a well-defined location, such as a
 274      register or memory slot in the stack frame.  Don't use this if
 275      the ABI doesn't explicitly guarantees this.  */
 276   RETURN_VALUE_ABI_PRESERVES_ADDRESS,
 277 };
 278
 279 /* Needed for various prototypes */
 280
 281 struct symtab;
 282 struct breakpoint;
 283 struct frame_info;
 284 struct gdbarch;
 285 struct value;
 286
 287 /* From main.c.  */
 288
 289 /* This really belong in utils.c (path-utils.c?), but it references some
 290    globals that are currently only available to main.c.  */
 291 extern char *relocate_gdb_directory (const char *initial, int flag);
 292
 293 \f
 294 /* Annotation stuff.  */
 295
 296 extern int annotation_level;    /* in stack.c */
 297 \f
 298
 299 /* From regex.c or libc.  BSD 4.4 declares this with the argument type as
 300    "const char *" in unistd.h, so we can't declare the argument
 301    as "char *".  */
 302
 303 EXTERN_C char *re_comp (const char *);
 304
 305 /* From symfile.c */
 306
 307 extern void symbol_file_command (char *, int);
 308
 309 /* * Remote targets may wish to use this as their load function.  */
 310 extern void generic_load (const char *name, int from_tty);
 311
 312 /* From top.c */
 313
 314 typedef void initialize_file_ftype (void);
 315
 316 extern char *gdb_readline_wrapper (const char *);
 317
 318 extern char *command_line_input (const char *, int, const char *);
 319
 320 extern void print_prompt (void);
 321
 322 struct ui;
 323
 324 extern int input_interactive_p (struct ui *);
 325
 326 extern int info_verbose;
 327
 328 /* From printcmd.c */
 329
 330 extern void set_next_address (struct gdbarch *, CORE_ADDR);
 331
 332 extern int print_address_symbolic (struct gdbarch *, CORE_ADDR,
 333                                    struct ui_file *, int,
 334                                    const char *);
 335
 336 extern int build_address_symbolic (struct gdbarch *,
 337                                    CORE_ADDR addr,
 338                                    int do_demangle,
 339                                    char **name,
 340                                    int *offset,
 341                                    char **filename,
 342                                    int *line,
 343                                    int *unmapped);
 344
 345 extern void print_address (struct gdbarch *, CORE_ADDR, struct ui_file *);
 346 extern const char *pc_prefix (CORE_ADDR);
 347
 348 /* From source.c */
 349
 350 /* See openp function definition for their description.  */
 351 #define OPF_TRY_CWD_FIRST     0x01
 352 #define OPF_SEARCH_IN_PATH    0x02
 353 #define OPF_RETURN_REALPATH   0x04
 354
 355 extern int openp (const char *, int, const char *, int, char **);
 356
 357 extern int source_full_path_of (const char *, char **);
 358
 359 extern void mod_path (char *, char **);
 360
 361 extern void add_path (char *, char **, int);
 362
 363 extern void directory_switch (char *, int);
 364
 365 extern char *source_path;
 366
 367 extern void init_source_path (void);
 368
 369 /* From exec.c */
 370
 371 /* * Process memory area starting at ADDR with length SIZE.  Area is
 372    readable iff READ is non-zero, writable if WRITE is non-zero,
 373    executable if EXEC is non-zero.  Area is possibly changed against
 374    its original file based copy if MODIFIED is non-zero.  DATA is
 375    passed without changes from a caller.  */
 376
 377 typedef int (*find_memory_region_ftype) (CORE_ADDR addr, unsigned long size,
 378                                          int read, int write, int exec,
 379                                          int modified, void *data);
 380
 381 /* * Possible lvalue types.  Like enum language, this should be in
 382    value.h, but needs to be here for the same reason.  */
 383
 384 enum lval_type
 385   {
 386     /* * Not an lval.  */
 387     not_lval,
 388     /* * In memory.  */
 389     lval_memory,
 390     /* * In a register.  Registers are relative to a frame.  */
 391     lval_register,
 392     /* * In a gdb internal variable.  */
 393     lval_internalvar,
 394     /* * Value encapsulates a callable defined in an extension language.  */
 395     lval_xcallable,
 396     /* * Part of a gdb internal variable (structure field).  */
 397     lval_internalvar_component,
 398     /* * Value's bits are fetched and stored using functions provided
 399        by its creator.  */
 400     lval_computed
 401   };
 402
 403 /* * Parameters of the "info proc" command.  */
 404
 405 enum info_proc_what
 406   {
 407     /* * Display the default cmdline, cwd and exe outputs.  */
 408     IP_MINIMAL,
 409
 410     /* * Display `info proc mappings'.  */
 411     IP_MAPPINGS,
 412
 413     /* * Display `info proc status'.  */
 414     IP_STATUS,
 415
 416     /* * Display `info proc stat'.  */
 417     IP_STAT,
 418
 419     /* * Display `info proc cmdline'.  */
 420     IP_CMDLINE,
 421
 422     /* * Display `info proc exe'.  */
 423     IP_EXE,
 424
 425     /* * Display `info proc cwd'.  */
 426     IP_CWD,
 427
 428     /* * Display all of the above.  */
 429     IP_ALL
 430   };
 431
 432 /* * String containing the current directory (what getwd would return).  */
 433
 434 extern char *current_directory;
 435
 436 /* * Default radixes for input and output.  Only some values supported.  */
 437 extern unsigned input_radix;
 438 extern unsigned output_radix;
 439
 440 /* * Possibilities for prettyformat parameters to routines which print
 441    things.  Like enum language, this should be in value.h, but needs
 442    to be here for the same reason.  FIXME:  If we can eliminate this
 443    as an arg to LA_VAL_PRINT, then we can probably move it back to
 444    value.h.  */
 445
 446 enum val_prettyformat
 447   {
 448     Val_no_prettyformat = 0,
 449     Val_prettyformat,
 450     /* * Use the default setting which the user has specified.  */
 451     Val_prettyformat_default
 452   };
 453
 454 /* * Optional native machine support.  Non-native (and possibly pure
 455    multi-arch) targets do not need a "nm.h" file.  This will be a
 456    symlink to one of the nm-*.h files, built by the `configure'
 457    script.  */
 458
 459 #ifdef GDB_NM_FILE
 460 #include "nm.h"
 461 #endif
 462
 463 /* Assume that fopen accepts the letter "b" in the mode string.
 464    It is demanded by ISO C9X, and should be supported on all
 465    platforms that claim to have a standard-conforming C library.  On
 466    true POSIX systems it will be ignored and have no effect.  There
 467    may still be systems without a standard-conforming C library where
 468    an ISO C9X compiler (GCC) is available.  Known examples are SunOS
 469    4.x and 4.3BSD.  This assumption means these systems are no longer
 470    supported.  */
 471 #ifndef FOPEN_RB
 472 # include "fopen-bin.h"
 473 #endif
 474
 475 /* Defaults for system-wide constants (if not defined by xm.h, we fake it).
 476    FIXME: Assumes 2's complement arithmetic.  */
 477
 478 #if !defined (UINT_MAX)
 479 #define UINT_MAX ((unsigned int)(~0))       /* 0xFFFFFFFF for 32-bits */
 480 #endif
 481
 482 #if !defined (INT_MAX)
 483 #define INT_MAX ((int)(UINT_MAX >> 1))      /* 0x7FFFFFFF for 32-bits */
 484 #endif
 485
 486 #if !defined (INT_MIN)
 487 #define INT_MIN ((int)((int) ~0 ^ INT_MAX)) /* 0x80000000 for 32-bits */
 488 #endif
 489
 490 #if !defined (ULONG_MAX)
 491 #define ULONG_MAX ((unsigned long)(~0L))    /* 0xFFFFFFFF for 32-bits */
 492 #endif
 493
 494 #if !defined (LONG_MAX)
 495 #define LONG_MAX ((long)(ULONG_MAX >> 1))   /* 0x7FFFFFFF for 32-bits */
 496 #endif
 497
 498 #if !defined (ULONGEST_MAX)
 499 #define ULONGEST_MAX (~(ULONGEST)0)        /* 0xFFFFFFFFFFFFFFFF for 64-bits */
 500 #endif
 501
 502 #if !defined (LONGEST_MAX)                 /* 0x7FFFFFFFFFFFFFFF for 64-bits */
 503 #define LONGEST_MAX ((LONGEST)(ULONGEST_MAX >> 1))
 504 #endif
 505
 506 /* * Convert a LONGEST to an int.  This is used in contexts (e.g. number of
 507    arguments to a function, number in a value history, register number, etc.)
 508    where the value must not be larger than can fit in an int.  */
 509
 510 extern int longest_to_int (LONGEST);
 511
 512 /* * List of known OS ABIs.  If you change this, make sure to update the
 513    table in osabi.c.  */
 514 enum gdb_osabi
 515 {
 516   GDB_OSABI_UNINITIALIZED = -1, /* For struct gdbarch_info.  */
 517
 518   GDB_OSABI_UNKNOWN = 0,        /* keep this zero */
 519
 520   GDB_OSABI_SVR4,
 521   GDB_OSABI_HURD,
 522   GDB_OSABI_SOLARIS,
 523   GDB_OSABI_LINUX,
 524   GDB_OSABI_FREEBSD,
 525   GDB_OSABI_NETBSD,
 526   GDB_OSABI_OPENBSD,
 527   GDB_OSABI_WINCE,
 528   GDB_OSABI_GO32,
 529   GDB_OSABI_QNXNTO,
 530   GDB_OSABI_CYGWIN,
 531   GDB_OSABI_AIX,
 532   GDB_OSABI_DICOS,
 533   GDB_OSABI_DARWIN,
 534   GDB_OSABI_SYMBIAN,
 535   GDB_OSABI_OPENVMS,
 536   GDB_OSABI_LYNXOS178,
 537   GDB_OSABI_NEWLIB,
 538   GDB_OSABI_SDE,
 539
 540   GDB_OSABI_INVALID             /* keep this last */
 541 };
 542
 543 /* Enumerate the requirements a symbol has in order to be evaluated.
 544    These are listed in order of "strength" -- a later entry subsumes
 545    earlier ones.  This fine-grained distinction is important because
 546    it allows for the evaluation of a TLS symbol during unwinding --
 547    when unwinding one has access to registers, but not the frame
 548    itself, because that is being constructed.  */
 549
 550 enum symbol_needs_kind
 551 {
 552   /* No special requirements -- just memory.  */
 553   SYMBOL_NEEDS_NONE,
 554
 555   /* The symbol needs registers.  */
 556   SYMBOL_NEEDS_REGISTERS,
 557
 558   /* The symbol needs a frame.  */
 559   SYMBOL_NEEDS_FRAME
 560 };
 561
 562 /* Dynamic target-system-dependent parameters for GDB.  */
 563 #include "gdbarch.h"
 564
 565 /* * Maximum size of a register.  Something small, but large enough for
 566    all known ISAs.  If it turns out to be too small, make it bigger.  */
 567
 568 enum { MAX_REGISTER_SIZE = 64 };
 569
 570 /* In findvar.c.  */
 571
 572 template<typename T, typename = RequireLongest<T>>
 573 T extract_integer (const gdb_byte *addr, int len, enum bfd_endian byte_order);
 574
 575 static inline LONGEST
 576 extract_signed_integer (const gdb_byte *addr, int len,
 577                         enum bfd_endian byte_order)
 578 {
 579   return extract_integer<LONGEST> (addr, len, byte_order);
 580 }
 581
 582 static inline ULONGEST
 583 extract_unsigned_integer (const gdb_byte *addr, int len,
 584                           enum bfd_endian byte_order)
 585 {
 586   return extract_integer<ULONGEST> (addr, len, byte_order);
 587 }
 588
 589 extern int extract_long_unsigned_integer (const gdb_byte *, int,
 590                                           enum bfd_endian, LONGEST *);
 591
 592 extern CORE_ADDR extract_typed_address (const gdb_byte *buf,
 593                                         struct type *type);
 594
 595 /* All 'store' functions accept a host-format integer and store a
 596    target-format integer at ADDR which is LEN bytes long.  */
 597
 598 template<typename T, typename = RequireLongest<T>>
 599 extern void store_integer (gdb_byte *addr, int len, enum bfd_endian byte_order,
 600                            T val);
 601
 602 static inline void
 603 store_signed_integer (gdb_byte *addr, int len,
 604                       enum bfd_endian byte_order, LONGEST val)
 605 {
 606   return store_integer (addr, len, byte_order, val);
 607 }
 608
 609 static inline void
 610 store_unsigned_integer (gdb_byte *addr, int len,
 611                         enum bfd_endian byte_order, ULONGEST val)
 612 {
 613   return store_integer (addr, len, byte_order, val);
 614 }
 615
 616 extern void store_typed_address (gdb_byte *buf, struct type *type,
 617                                  CORE_ADDR addr);
 618
 619 extern void copy_integer_to_size (gdb_byte *dest, int dest_size,
 620                                   const gdb_byte *source, int source_size,
 621                                   bool is_signed, enum bfd_endian byte_order);
 622
 623 /* From valops.c */
 624
 625 extern int watchdog;
 626
 627 /* From dwarf2read.c */
 628
 629 ULONGEST read_unsigned_leb128 (bfd *, const gdb_byte *, unsigned int *);
 630
 631 /* Hooks for alternate command interfaces.  */
 632
 633 /* * The name of the interpreter if specified on the command line.  */
 634 extern char *interpreter_p;
 635
 636 struct target_waitstatus;
 637 struct cmd_list_element;
 638
 639 extern void (*deprecated_pre_add_symbol_hook) (const char *);
 640 extern void (*deprecated_post_add_symbol_hook) (void);
 641 extern void (*selected_frame_level_changed_hook) (int);
 642 extern int (*deprecated_ui_loop_hook) (int signo);
 643 extern void (*deprecated_show_load_progress) (const char *section,
 644                                               unsigned long section_sent,
 645                                               unsigned long section_size,
 646                                               unsigned long total_sent,
 647                                               unsigned long total_size);
 648 extern void (*deprecated_print_frame_info_listing_hook) (struct symtab * s,
 649                                                          int line,
 650                                                          int stopline,
 651                                                          int noerror);
 652 extern int (*deprecated_query_hook) (const char *, va_list)
 653      ATTRIBUTE_FPTR_PRINTF(1,0);
 654 extern void (*deprecated_warning_hook) (const char *, va_list)
 655      ATTRIBUTE_FPTR_PRINTF(1,0);
 656 extern void (*deprecated_interactive_hook) (void);
 657 extern void (*deprecated_readline_begin_hook) (const char *, ...)
 658      ATTRIBUTE_FPTR_PRINTF_1;
 659 extern char *(*deprecated_readline_hook) (const char *);
 660 extern void (*deprecated_readline_end_hook) (void);
 661 extern void (*deprecated_context_hook) (int);
 662 extern ptid_t (*deprecated_target_wait_hook) (ptid_t ptid,
 663                                               struct target_waitstatus *status,
 664                                               int options);
 665
 666 extern void (*deprecated_attach_hook) (void);
 667 extern void (*deprecated_detach_hook) (void);
 668 extern void (*deprecated_call_command_hook) (struct cmd_list_element * c,
 669                                              char *cmd, int from_tty);
 670
 671 extern int (*deprecated_ui_load_progress_hook) (const char *section,
 672                                                 unsigned long num);
 673
 674 /* If this definition isn't overridden by the header files, assume
 675    that isatty and fileno exist on this system.  */
 676 #ifndef ISATTY
 677 #define ISATTY(FP)      (isatty (fileno (FP)))
 678 #endif
 679
 680 /* * A width that can achieve a better legibility for GDB MI mode.  */
 681 #define GDB_MI_MSG_WIDTH  80
 682
 683 /* From progspace.c */
 684
 685 extern void initialize_progspace (void);
 686 extern void initialize_inferiors (void);
 687
 688 /* * Special block numbers */
 689
 690 enum block_enum
 691 {
 692   GLOBAL_BLOCK = 0,
 693   STATIC_BLOCK = 1,
 694   FIRST_LOCAL_BLOCK = 2
 695 };
 696
 697 /* User selection used in observer.h and multiple print functions.  */
 698
 699 enum user_selected_what_flag
 700   {
 701     /* Inferior selected.  */
 702     USER_SELECTED_INFERIOR = 1 << 1,
 703
 704     /* Thread selected.  */
 705     USER_SELECTED_THREAD = 1 << 2,
 706
 707     /* Frame selected.  */
 708     USER_SELECTED_FRAME = 1 << 3
 709   };
 710 DEF_ENUM_FLAGS_TYPE (enum user_selected_what_flag, user_selected_what);
 711
 712 #include "utils.h"
 713
 714 #endif /* #ifndef DEFS_H */