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