gdb/defs.h

   1 /* *INDENT-OFF* */ /* ATTR_FORMAT confuses indent, avoid running it for now */
   2 /* Basic, host-specific, and target-specific definitions for GDB.
   3    Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
   4    1997, 1998, 1999, 2000, 2001
   5    Free Software Foundation, Inc.
   6
   7    This file is part of GDB.
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 59 Temple Place - Suite 330,
  22    Boston, MA 02111-1307, USA.  */
  23
  24 #ifndef DEFS_H
  25 #define DEFS_H
  26
  27 #include "config.h"             /* Generated by configure */
  28 #include <stdio.h>
  29 #include <errno.h>              /* System call error return status */
  30 #include <limits.h>
  31
  32 #ifdef HAVE_STDDEF_H
  33 #include <stddef.h>
  34 #else
  35 #include <sys/types.h>          /* for size_t */
  36 #endif
  37
  38 #ifdef HAVE_UNISTD_H
  39 #include <unistd.h>
  40 #endif
  41
  42 /* Just in case they're not defined in stdio.h. */
  43
  44 #ifndef SEEK_SET
  45 #define SEEK_SET 0
  46 #endif
  47 #ifndef SEEK_CUR
  48 #define SEEK_CUR 1
  49 #endif
  50
  51 /* First include ansidecl.h so we can use the various macro definitions
  52    here and in all subsequent file inclusions.  */
  53
  54 #include "ansidecl.h"
  55
  56 #include <stdarg.h>             /* for va_list */
  57
  58 #include "libiberty.h"
  59
  60 #include "progress.h"
  61
  62 #ifdef USE_MMALLOC
  63 #include "mmalloc.h"
  64 #endif
  65
  66 /* For BFD64 and bfd_vma.  */
  67 #include "bfd.h"
  68
  69
  70 /* The target is partially multi-arched.  Both "tm.h" and the
  71    multi-arch vector provide definitions.  "tm.h" normally overrides
  72    the multi-arch vector (but there are a few exceptions).  */
  73
  74 #define GDB_MULTI_ARCH_PARTIAL 1
  75
  76 /* The target is partially multi-arched. Both the multi-arch vector
  77    and "tm.h" provide definitions. "tm.h" cannot override a definition
  78    provided by the multi-arch vector.  It is detected as a compilation
  79    error.
  80
  81    This setting is only useful during a multi-arch conversion. */
  82
  83 #define GDB_MULTI_ARCH_TM 2
  84
  85 /* The target is pure multi-arch.  The MULTI-ARCH vector provides all
  86    definitions.  "tm.h" is linked to an empty file. */
  87
  88 #define GDB_MULTI_ARCH_PURE 3
  89
  90
  91
  92 /* An address in the program being debugged.  Host byte order.  Rather
  93    than duplicate all the logic in BFD which figures out what type
  94    this is (long, long long, etc.) and whether it needs to be 64
  95    bits (the host/target interactions are subtle), we just use
  96    bfd_vma.  */
  97
  98 typedef bfd_vma CORE_ADDR;
  99
 100 /* This is to make sure that LONGEST is at least as big as CORE_ADDR.  */
 101
 102 #ifndef LONGEST
 103
 104 #ifdef BFD64
 105
 106 #define LONGEST BFD_HOST_64_BIT
 107 #define ULONGEST BFD_HOST_U_64_BIT
 108
 109 #else /* No BFD64 */
 110
 111 #ifdef CC_HAS_LONG_LONG
 112 #define LONGEST long long
 113 #define ULONGEST unsigned long long
 114 #else
 115 #ifdef BFD_HOST_64_BIT
 116 /* BFD_HOST_64_BIT is defined for some hosts that don't have long long
 117    (e.g. i386-windows) so try it.  */
 118 #define LONGEST BFD_HOST_64_BIT
 119 #define ULONGEST BFD_HOST_U_64_BIT
 120 #else
 121 #define LONGEST long
 122 #define ULONGEST unsigned long
 123 #endif
 124 #endif
 125
 126 #endif /* No BFD64 */
 127
 128 #endif /* ! LONGEST */
 129
 130 #ifndef min
 131 #define min(a, b) ((a) < (b) ? (a) : (b))
 132 #endif
 133 #ifndef max
 134 #define max(a, b) ((a) > (b) ? (a) : (b))
 135 #endif
 136
 137 /* Macros to do string compares.
 138
 139    NOTE: cagney/2000-03-14:
 140
 141    While old code can continue to refer to these macros, new code is
 142    probably better off using strcmp() directly vis: ``strcmp() == 0''
 143    and ``strcmp() != 0''.
 144
 145    This is because modern compilers can directly inline strcmp()
 146    making the original justification for these macros - avoid function
 147    call overhead by pre-testing the first characters
 148    (``*X==*Y?...:0'') - redundant.
 149
 150    ``Even if [...] testing the first character does have a modest
 151    performance improvement, I'd rather that whenever a performance
 152    issue is found that we spend the effort on algorithmic
 153    optimizations than micro-optimizing.'' J.T. */
 154
 155 #define STREQ(a,b) (*(a) == *(b) ? !strcmp ((a), (b)) : 0)
 156 #define STREQN(a,b,c) (*(a) == *(b) ? !strncmp ((a), (b), (c)) : 0)
 157
 158 /* The character GNU C++ uses to build identifiers that must be unique from
 159    the program's identifiers (such as $this and $$vptr).  */
 160 #define CPLUS_MARKER '$'        /* May be overridden to '.' for SysV */
 161
 162 /* Check if a character is one of the commonly used C++ marker characters.  */
 163 extern int is_cplus_marker (int);
 164
 165 /* use tui interface if non-zero */
 166 extern int tui_version;
 167
 168 #if defined(TUI)
 169 /* all invocations of TUIDO should have two sets of parens */
 170 #define TUIDO(x)        tuiDo x
 171 #else
 172 #define TUIDO(x)
 173 #endif
 174
 175 /* enable xdb commands if set */
 176 extern int xdb_commands;
 177
 178 /* enable dbx commands if set */
 179 extern int dbx_commands;
 180
 181 extern int quit_flag;
 182 extern int immediate_quit;
 183 extern int sevenbit_strings;
 184
 185 extern void quit (void);
 186
 187 /* FIXME: cagney/2000-03-13: It has been suggested that the peformance
 188    benefits of having a ``QUIT'' macro rather than a function are
 189    marginal.  If the overhead of a QUIT function call is proving
 190    significant then its calling frequency should probably be reduced
 191    [kingdon].  A profile analyzing the current situtation is
 192    needed. */
 193
 194 #ifdef QUIT
 195 /* do twice to force compiler warning */
 196 #define QUIT_FIXME "FIXME"
 197 #define QUIT_FIXME "ignoring redefinition of QUIT"
 198 #else
 199 #define QUIT { \
 200   if (quit_flag) quit (); \
 201   if (interactive_hook) interactive_hook (); \
 202   PROGRESS (1); \
 203 }
 204 #endif
 205
 206 /* Languages represented in the symbol table and elsewhere.
 207    This should probably be in language.h, but since enum's can't
 208    be forward declared to satisfy opaque references before their
 209    actual definition, needs to be here. */
 210
 211 enum language
 212   {
 213     language_unknown,           /* Language not known */
 214     language_auto,              /* Placeholder for automatic setting */
 215     language_c,                 /* C */
 216     language_cplus,             /* C++ */
 217     language_java,              /* Java */
 218     language_chill,             /* Chill */
 219     language_fortran,           /* Fortran */
 220     language_m2,                /* Modula-2 */
 221     language_asm,               /* Assembly language */
 222     language_scm,               /* Scheme / Guile */
 223     language_pascal             /* Pascal */
 224   };
 225
 226 enum precision_type
 227   {
 228     single_precision,
 229     double_precision,
 230     unspecified_precision
 231   };
 232
 233 /* The numbering of these signals is chosen to match traditional unix
 234    signals (insofar as various unices use the same numbers, anyway).
 235    It is also the numbering of the GDB remote protocol.  Other remote
 236    protocols, if they use a different numbering, should make sure to
 237    translate appropriately.
 238
 239    Since these numbers have actually made it out into other software
 240    (stubs, etc.), you mustn't disturb the assigned numbering.  If you
 241    need to add new signals here, add them to the end of the explicitly
 242    numbered signals.
 243
 244    This is based strongly on Unix/POSIX signals for several reasons:
 245    (1) This set of signals represents a widely-accepted attempt to
 246    represent events of this sort in a portable fashion, (2) we want a
 247    signal to make it from wait to child_wait to the user intact, (3) many
 248    remote protocols use a similar encoding.  However, it is
 249    recognized that this set of signals has limitations (such as not
 250    distinguishing between various kinds of SIGSEGV, or not
 251    distinguishing hitting a breakpoint from finishing a single step).
 252    So in the future we may get around this either by adding additional
 253    signals for breakpoint, single-step, etc., or by adding signal
 254    codes; the latter seems more in the spirit of what BSD, System V,
 255    etc. are doing to address these issues.  */
 256
 257 /* For an explanation of what each signal means, see
 258    target_signal_to_string.  */
 259
 260 enum target_signal
 261   {
 262     /* Used some places (e.g. stop_signal) to record the concept that
 263        there is no signal.  */
 264     TARGET_SIGNAL_0 = 0,
 265     TARGET_SIGNAL_FIRST = 0,
 266     TARGET_SIGNAL_HUP = 1,
 267     TARGET_SIGNAL_INT = 2,
 268     TARGET_SIGNAL_QUIT = 3,
 269     TARGET_SIGNAL_ILL = 4,
 270     TARGET_SIGNAL_TRAP = 5,
 271     TARGET_SIGNAL_ABRT = 6,
 272     TARGET_SIGNAL_EMT = 7,
 273     TARGET_SIGNAL_FPE = 8,
 274     TARGET_SIGNAL_KILL = 9,
 275     TARGET_SIGNAL_BUS = 10,
 276     TARGET_SIGNAL_SEGV = 11,
 277     TARGET_SIGNAL_SYS = 12,
 278     TARGET_SIGNAL_PIPE = 13,
 279     TARGET_SIGNAL_ALRM = 14,
 280     TARGET_SIGNAL_TERM = 15,
 281     TARGET_SIGNAL_URG = 16,
 282     TARGET_SIGNAL_STOP = 17,
 283     TARGET_SIGNAL_TSTP = 18,
 284     TARGET_SIGNAL_CONT = 19,
 285     TARGET_SIGNAL_CHLD = 20,
 286     TARGET_SIGNAL_TTIN = 21,
 287     TARGET_SIGNAL_TTOU = 22,
 288     TARGET_SIGNAL_IO = 23,
 289     TARGET_SIGNAL_XCPU = 24,
 290     TARGET_SIGNAL_XFSZ = 25,
 291     TARGET_SIGNAL_VTALRM = 26,
 292     TARGET_SIGNAL_PROF = 27,
 293     TARGET_SIGNAL_WINCH = 28,
 294     TARGET_SIGNAL_LOST = 29,
 295     TARGET_SIGNAL_USR1 = 30,
 296     TARGET_SIGNAL_USR2 = 31,
 297     TARGET_SIGNAL_PWR = 32,
 298     /* Similar to SIGIO.  Perhaps they should have the same number.  */
 299     TARGET_SIGNAL_POLL = 33,
 300     TARGET_SIGNAL_WIND = 34,
 301     TARGET_SIGNAL_PHONE = 35,
 302     TARGET_SIGNAL_WAITING = 36,
 303     TARGET_SIGNAL_LWP = 37,
 304     TARGET_SIGNAL_DANGER = 38,
 305     TARGET_SIGNAL_GRANT = 39,
 306     TARGET_SIGNAL_RETRACT = 40,
 307     TARGET_SIGNAL_MSG = 41,
 308     TARGET_SIGNAL_SOUND = 42,
 309     TARGET_SIGNAL_SAK = 43,
 310     TARGET_SIGNAL_PRIO = 44,
 311     TARGET_SIGNAL_REALTIME_33 = 45,
 312     TARGET_SIGNAL_REALTIME_34 = 46,
 313     TARGET_SIGNAL_REALTIME_35 = 47,
 314     TARGET_SIGNAL_REALTIME_36 = 48,
 315     TARGET_SIGNAL_REALTIME_37 = 49,
 316     TARGET_SIGNAL_REALTIME_38 = 50,
 317     TARGET_SIGNAL_REALTIME_39 = 51,
 318     TARGET_SIGNAL_REALTIME_40 = 52,
 319     TARGET_SIGNAL_REALTIME_41 = 53,
 320     TARGET_SIGNAL_REALTIME_42 = 54,
 321     TARGET_SIGNAL_REALTIME_43 = 55,
 322     TARGET_SIGNAL_REALTIME_44 = 56,
 323     TARGET_SIGNAL_REALTIME_45 = 57,
 324     TARGET_SIGNAL_REALTIME_46 = 58,
 325     TARGET_SIGNAL_REALTIME_47 = 59,
 326     TARGET_SIGNAL_REALTIME_48 = 60,
 327     TARGET_SIGNAL_REALTIME_49 = 61,
 328     TARGET_SIGNAL_REALTIME_50 = 62,
 329     TARGET_SIGNAL_REALTIME_51 = 63,
 330     TARGET_SIGNAL_REALTIME_52 = 64,
 331     TARGET_SIGNAL_REALTIME_53 = 65,
 332     TARGET_SIGNAL_REALTIME_54 = 66,
 333     TARGET_SIGNAL_REALTIME_55 = 67,
 334     TARGET_SIGNAL_REALTIME_56 = 68,
 335     TARGET_SIGNAL_REALTIME_57 = 69,
 336     TARGET_SIGNAL_REALTIME_58 = 70,
 337     TARGET_SIGNAL_REALTIME_59 = 71,
 338     TARGET_SIGNAL_REALTIME_60 = 72,
 339     TARGET_SIGNAL_REALTIME_61 = 73,
 340     TARGET_SIGNAL_REALTIME_62 = 74,
 341     TARGET_SIGNAL_REALTIME_63 = 75,
 342
 343     /* Used internally by Solaris threads.  See signal(5) on Solaris.  */
 344     TARGET_SIGNAL_CANCEL = 76,
 345
 346     /* Yes, this pains me, too.  But LynxOS didn't have SIG32, and now
 347        Linux does, and we can't disturb the numbering, since it's part
 348        of the protocol.  Note that in some GDB's TARGET_SIGNAL_REALTIME_32
 349        is number 76.  */
 350     TARGET_SIGNAL_REALTIME_32,
 351     /* Yet another pain, IRIX 6 has SIG64.  */
 352     TARGET_SIGNAL_REALTIME_64,
 353
 354 #if defined(MACH) || defined(__MACH__)
 355     /* Mach exceptions */
 356     TARGET_EXC_BAD_ACCESS,
 357     TARGET_EXC_BAD_INSTRUCTION,
 358     TARGET_EXC_ARITHMETIC,
 359     TARGET_EXC_EMULATION,
 360     TARGET_EXC_SOFTWARE,
 361     TARGET_EXC_BREAKPOINT,
 362 #endif
 363     TARGET_SIGNAL_INFO,
 364
 365     /* Some signal we don't know about.  */
 366     TARGET_SIGNAL_UNKNOWN,
 367
 368     /* Use whatever signal we use when one is not specifically specified
 369        (for passing to proceed and so on).  */
 370     TARGET_SIGNAL_DEFAULT,
 371
 372     /* Last and unused enum value, for sizing arrays, etc.  */
 373     TARGET_SIGNAL_LAST
 374   };
 375
 376 /* the cleanup list records things that have to be undone
 377    if an error happens (descriptors to be closed, memory to be freed, etc.)
 378    Each link in the chain records a function to call and an
 379    argument to give it.
 380
 381    Use make_cleanup to add an element to the cleanup chain.
 382    Use do_cleanups to do all cleanup actions back to a given
 383    point in the chain.  Use discard_cleanups to remove cleanups
 384    from the chain back to a given point, not doing them.  */
 385
 386 struct cleanup
 387   {
 388     struct cleanup *next;
 389     void (*function) (PTR);
 390     PTR arg;
 391   };
 392
 393
 394 /* The ability to declare that a function never returns is useful, but
 395    not really required to compile GDB successfully, so the NORETURN and
 396    ATTR_NORETURN macros normally expand into nothing.  */
 397
 398 /* If compiling with older versions of GCC, a function may be declared
 399    "volatile" to indicate that it does not return.  */
 400
 401 #ifndef NORETURN
 402 #if defined(__GNUC__) \
 403      && (__GNUC__ == 1 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7))
 404 #define NORETURN volatile
 405 #else
 406 #define NORETURN                /* nothing */
 407 #endif
 408 #endif
 409
 410 /* GCC 2.5 and later versions define a function attribute "noreturn",
 411    which is the preferred way to declare that a function never returns.
 412    However GCC 2.7 appears to be the first version in which this fully
 413    works everywhere we use it. */
 414
 415 #ifndef ATTR_NORETURN
 416 #if defined(__GNUC__) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7))
 417 #define ATTR_NORETURN __attribute__ ((noreturn))
 418 #else
 419 #define ATTR_NORETURN           /* nothing */
 420 #endif
 421 #endif
 422
 423 #ifndef ATTR_FORMAT
 424 #if defined(__GNUC__) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4))
 425 #define ATTR_FORMAT(type, x, y) __attribute__ ((format(type, x, y)))
 426 #else
 427 #define ATTR_FORMAT(type, x, y) /* nothing */
 428 #endif
 429 #endif
 430
 431 /* Needed for various prototypes */
 432
 433 struct symtab;
 434 struct breakpoint;
 435
 436 /* From blockframe.c */
 437
 438 extern int inside_entry_func (CORE_ADDR);
 439
 440 extern int inside_entry_file (CORE_ADDR addr);
 441
 442 extern int inside_main_func (CORE_ADDR pc);
 443
 444 /* From ch-lang.c, for the moment. (FIXME) */
 445
 446 extern char *chill_demangle (const char *);
 447
 448 /* From utils.c */
 449
 450 extern void initialize_utils (void);
 451
 452 extern void notice_quit (void);
 453
 454 extern int strcmp_iw (const char *, const char *);
 455
 456 extern int subset_compare (char *, char *);
 457
 458 extern char *safe_strerror (int);
 459
 460 extern void init_malloc (void *);
 461
 462 extern void request_quit (int);
 463
 464 extern void do_cleanups (struct cleanup *);
 465 extern void do_final_cleanups (struct cleanup *);
 466 extern void do_my_cleanups (struct cleanup **, struct cleanup *);
 467 extern void do_run_cleanups (struct cleanup *);
 468 extern void do_exec_cleanups (struct cleanup *);
 469 extern void do_exec_error_cleanups (struct cleanup *);
 470
 471 extern void discard_cleanups (struct cleanup *);
 472 extern void discard_final_cleanups (struct cleanup *);
 473 extern void discard_exec_error_cleanups (struct cleanup *);
 474 extern void discard_my_cleanups (struct cleanup **, struct cleanup *);
 475
 476 /* NOTE: cagney/2000-03-04: This typedef is strictly for the
 477    make_cleanup function declarations below. Do not use this typedef
 478    as a cast when passing functions into the make_cleanup() code.
 479    Instead either use a bounce function or add a wrapper function.
 480    Calling a f(char*) function with f(void*) is non-portable. */
 481 typedef void (make_cleanup_ftype) (void *);
 482
 483 extern struct cleanup *make_cleanup (make_cleanup_ftype *, void *);
 484
 485 extern struct cleanup *make_cleanup_freeargv (char **);
 486
 487 struct ui_file;
 488 extern struct cleanup *make_cleanup_ui_file_delete (struct ui_file *);
 489
 490 extern struct cleanup *make_cleanup_close (int fd);
 491
 492 extern struct cleanup *make_cleanup_bfd_close (bfd *abfd);
 493
 494 extern struct cleanup *make_final_cleanup (make_cleanup_ftype *, void *);
 495
 496 extern struct cleanup *make_my_cleanup (struct cleanup **,
 497                                         make_cleanup_ftype *, void *);
 498
 499 extern struct cleanup *make_run_cleanup (make_cleanup_ftype *, void *);
 500
 501 extern struct cleanup *make_exec_cleanup (make_cleanup_ftype *, void *);
 502 extern struct cleanup *make_exec_error_cleanup (make_cleanup_ftype *, void *);
 503
 504 extern struct cleanup *save_cleanups (void);
 505 extern struct cleanup *save_final_cleanups (void);
 506 extern struct cleanup *save_my_cleanups (struct cleanup **);
 507
 508 extern void restore_cleanups (struct cleanup *);
 509 extern void restore_final_cleanups (struct cleanup *);
 510 extern void restore_my_cleanups (struct cleanup **, struct cleanup *);
 511
 512 extern void free_current_contents (void *);
 513
 514 extern void null_cleanup (void *);
 515
 516 extern int myread (int, char *, int);
 517
 518 extern int query (char *, ...) ATTR_FORMAT (printf, 1, 2);
 519
 520 extern void init_page_info (void);
 521
 522 extern CORE_ADDR host_pointer_to_address (void *ptr);
 523 extern void *address_to_host_pointer (CORE_ADDR addr);
 524
 525 /* From demangle.c */
 526
 527 extern void set_demangling_style (char *);
 528
 529 /* From tm.h */
 530
 531 struct type;
 532 typedef int (use_struct_convention_fn) (int gcc_p, struct type * value_type);
 533 extern use_struct_convention_fn generic_use_struct_convention;
 534
 535 typedef unsigned char *(breakpoint_from_pc_fn) (CORE_ADDR * pcptr, int *lenptr);
 536 \f
 537 /* Annotation stuff.  */
 538
 539 extern int annotation_level;    /* in stack.c */
 540 \f
 541 extern void begin_line (void);
 542
 543 extern void wrap_here (char *);
 544
 545 extern void reinitialize_more_filter (void);
 546
 547 /* Normal results */
 548 extern struct ui_file *gdb_stdout;
 549 /* Serious error notifications */
 550 extern struct ui_file *gdb_stderr;
 551 /* Log/debug/trace messages that should bypass normal stdout/stderr
 552    filtering.  For momement, always call this stream using
 553    *_unfiltered. In the very near future that restriction shall be
 554    removed - either call shall be unfiltered. (cagney 1999-06-13). */
 555 extern struct ui_file *gdb_stdlog;
 556 /* Target output that should bypass normal stdout/stderr filtering.
 557    For momement, always call this stream using *_unfiltered. In the
 558    very near future that restriction shall be removed - either call
 559    shall be unfiltered. (cagney 1999-07-02). */
 560 extern struct ui_file *gdb_stdtarg;
 561
 562 #if defined(TUI)
 563 #include "tui.h"
 564 #include "tuiCommand.h"
 565 #include "tuiData.h"
 566 #include "tuiIO.h"
 567 #include "tuiLayout.h"
 568 #include "tuiWin.h"
 569 #endif
 570
 571 #include "ui-file.h"
 572
 573 /* More generic printf like operations.  Filtered versions may return
 574    non-locally on error.  */
 575
 576 extern void fputs_filtered (const char *, struct ui_file *);
 577
 578 extern void fputs_unfiltered (const char *, struct ui_file *);
 579
 580 extern int fputc_filtered (int c, struct ui_file *);
 581
 582 extern int fputc_unfiltered (int c, struct ui_file *);
 583
 584 extern int putchar_filtered (int c);
 585
 586 extern int putchar_unfiltered (int c);
 587
 588 extern void puts_filtered (const char *);
 589
 590 extern void puts_unfiltered (const char *);
 591
 592 extern void puts_debug (char *prefix, char *string, char *suffix);
 593
 594 extern void vprintf_filtered (const char *, va_list) ATTR_FORMAT (printf, 1, 0);
 595
 596 extern void vfprintf_filtered (struct ui_file *, const char *, va_list) ATTR_FORMAT (printf, 2, 0);
 597
 598 extern void fprintf_filtered (struct ui_file *, const char *, ...) ATTR_FORMAT (printf, 2, 3);
 599
 600 extern void fprintfi_filtered (int, struct ui_file *, const char *, ...) ATTR_FORMAT (printf, 3, 4);
 601
 602 extern void printf_filtered (const char *, ...) ATTR_FORMAT (printf, 1, 2);
 603
 604 extern void printfi_filtered (int, const char *, ...) ATTR_FORMAT (printf, 2, 3);
 605
 606 extern void vprintf_unfiltered (const char *, va_list) ATTR_FORMAT (printf, 1, 0);
 607
 608 extern void vfprintf_unfiltered (struct ui_file *, const char *, va_list) ATTR_FORMAT (printf, 2, 0);
 609
 610 extern void fprintf_unfiltered (struct ui_file *, const char *, ...) ATTR_FORMAT (printf, 2, 3);
 611
 612 extern void printf_unfiltered (const char *, ...) ATTR_FORMAT (printf, 1, 2);
 613
 614 extern void print_spaces (int, struct ui_file *);
 615
 616 extern void print_spaces_filtered (int, struct ui_file *);
 617
 618 extern char *n_spaces (int);
 619
 620 extern void fputstr_filtered (const char *str, int quotr, struct ui_file * stream);
 621
 622 extern void fputstr_unfiltered (const char *str, int quotr, struct ui_file * stream);
 623
 624 extern void fputstrn_unfiltered (const char *str, int n, int quotr, struct ui_file * stream);
 625
 626 /* Display the host ADDR on STREAM formatted as ``0x%x''. */
 627 extern void gdb_print_host_address (void *addr, struct ui_file *stream);
 628
 629 /* Convert a CORE_ADDR into a HEX string.  paddr() is like %08lx.
 630    paddr_nz() is like %lx.  paddr_u() is like %lu. paddr_width() is
 631    for ``%*''. */
 632 extern int strlen_paddr (void);
 633 extern char *paddr (CORE_ADDR addr);
 634 extern char *paddr_nz (CORE_ADDR addr);
 635 extern char *paddr_u (CORE_ADDR addr);
 636 extern char *paddr_d (LONGEST addr);
 637
 638 extern char *phex (ULONGEST l, int sizeof_l);
 639 extern char *phex_nz (ULONGEST l, int sizeof_l);
 640
 641 extern void fprintf_symbol_filtered (struct ui_file *, char *,
 642                                      enum language, int);
 643
 644 extern NORETURN void perror_with_name (char *) ATTR_NORETURN;
 645
 646 extern void print_sys_errmsg (char *, int);
 647
 648 /* From regex.c or libc.  BSD 4.4 declares this with the argument type as
 649    "const char *" in unistd.h, so we can't declare the argument
 650    as "char *".  */
 651
 652 extern char *re_comp (const char *);
 653
 654 /* From symfile.c */
 655
 656 extern void symbol_file_command (char *, int);
 657
 658 /* Remote targets may wish to use this as their load function.  */
 659 extern void generic_load (char *name, int from_tty);
 660
 661 /* Summarise a download */
 662 extern void print_transfer_performance (struct ui_file *stream,
 663                                         unsigned long data_count,
 664                                         unsigned long write_count,
 665                                         unsigned long time_count);
 666
 667 /* From top.c */
 668
 669 typedef void initialize_file_ftype (void);
 670
 671 extern char *skip_quoted (char *);
 672
 673 extern char *gdb_readline (char *);
 674
 675 extern char *command_line_input (char *, int, char *);
 676
 677 extern void print_prompt (void);
 678
 679 extern int input_from_terminal_p (void);
 680
 681 extern int info_verbose;
 682
 683 /* From printcmd.c */
 684
 685 extern void set_next_address (CORE_ADDR);
 686
 687 extern void print_address_symbolic (CORE_ADDR, struct ui_file *, int,
 688                                     char *);
 689
 690 extern int build_address_symbolic (CORE_ADDR addr,
 691                                    int do_demangle,
 692                                    char **name,
 693                                    int *offset,
 694                                    char **filename,
 695                                    int *line,
 696                                    int *unmapped);
 697
 698 extern void print_address_numeric (CORE_ADDR, int, struct ui_file *);
 699
 700 extern void print_address (CORE_ADDR, struct ui_file *);
 701
 702 /* From source.c */
 703
 704 extern int openp (const char *, int, const char *, int, int, char **);
 705
 706 extern int source_full_path_of (char *, char **);
 707
 708 extern void mod_path (char *, char **);
 709
 710 extern void directory_command (char *, int);
 711
 712 extern void init_source_path (void);
 713
 714 extern char *symtab_to_filename (struct symtab *);
 715
 716 /* From exec.c */
 717
 718 extern void exec_set_section_offsets (bfd_signed_vma text_off,
 719                                       bfd_signed_vma data_off,
 720                                       bfd_signed_vma bss_off);
 721
 722 /* From findvar.c */
 723
 724 extern int read_relative_register_raw_bytes (int, char *);
 725
 726 /* Possible lvalue types.  Like enum language, this should be in
 727    value.h, but needs to be here for the same reason. */
 728
 729 enum lval_type
 730   {
 731     /* Not an lval. */
 732     not_lval,
 733     /* In memory.  Could be a saved register.  */
 734     lval_memory,
 735     /* In a register.  */
 736     lval_register,
 737     /* In a gdb internal variable.  */
 738     lval_internalvar,
 739     /* Part of a gdb internal variable (structure field).  */
 740     lval_internalvar_component,
 741     /* In a register series in a frame not the current one, which may have been
 742        partially saved or saved in different places (otherwise would be
 743        lval_register or lval_memory).  */
 744     lval_reg_frame_relative
 745   };
 746
 747 struct frame_info;
 748
 749 /* From readline (but not in any readline .h files).  */
 750
 751 extern char *tilde_expand (char *);
 752
 753 /* Control types for commands */
 754
 755 enum misc_command_type
 756   {
 757     ok_command,
 758     end_command,
 759     else_command,
 760     nop_command
 761   };
 762
 763 enum command_control_type
 764   {
 765     simple_control,
 766     break_control,
 767     continue_control,
 768     while_control,
 769     if_control,
 770     invalid_control
 771   };
 772
 773 /* Structure for saved commands lines
 774    (for breakpoints, defined commands, etc).  */
 775
 776 struct command_line
 777   {
 778     struct command_line *next;
 779     char *line;
 780     enum command_control_type control_type;
 781     int body_count;
 782     struct command_line **body_list;
 783   };
 784
 785 extern struct command_line *read_command_lines (char *, int);
 786
 787 extern void free_command_lines (struct command_line **);
 788
 789 /* To continue the execution commands when running gdb asynchronously.
 790    A continuation structure contains a pointer to a function to be called
 791    to finish the command, once the target has stopped. Such mechanism is
 792    used bt the finish and until commands, and in the remote protocol
 793    when opening an extended-remote connection. */
 794
 795 struct continuation_arg
 796   {
 797     struct continuation_arg *next;
 798     union continuation_data {
 799       void *pointer;
 800       int   integer;
 801       long  longint;
 802     } data;
 803   };
 804
 805 struct continuation
 806   {
 807     void (*continuation_hook) (struct continuation_arg *);
 808     struct continuation_arg *arg_list;
 809     struct continuation *next;
 810   };
 811
 812 /* In infrun.c. */
 813 extern struct continuation *cmd_continuation;
 814 /* Used only by the step_1 function. */
 815 extern struct continuation *intermediate_continuation;
 816
 817 /* From utils.c */
 818 extern void add_continuation (void (*)(struct continuation_arg *),
 819                               struct continuation_arg *);
 820 extern void do_all_continuations (void);
 821 extern void discard_all_continuations (void);
 822
 823 extern void add_intermediate_continuation (void (*)(struct continuation_arg *),
 824                               struct continuation_arg *);
 825 extern void do_all_intermediate_continuations (void);
 826 extern void discard_all_intermediate_continuations (void);
 827
 828 /* String containing the current directory (what getwd would return).  */
 829
 830 extern char *current_directory;
 831
 832 /* Default radixes for input and output.  Only some values supported.  */
 833 extern unsigned input_radix;
 834 extern unsigned output_radix;
 835
 836 /* Possibilities for prettyprint parameters to routines which print
 837    things.  Like enum language, this should be in value.h, but needs
 838    to be here for the same reason.  FIXME:  If we can eliminate this
 839    as an arg to LA_VAL_PRINT, then we can probably move it back to
 840    value.h. */
 841
 842 enum val_prettyprint
 843   {
 844     Val_no_prettyprint = 0,
 845     Val_prettyprint,
 846     /* Use the default setting which the user has specified.  */
 847     Val_pretty_default
 848   };
 849
 850 /* The ptid struct is a collection of the various "ids" necessary
 851    for identifying the inferior.  This consists of the process id
 852    (pid), thread id (tid), and other fields necessary for uniquely
 853    identifying the inferior process/thread being debugged.  When
 854    manipulating ptids, the constructors, accessors, and predicate
 855    declared in inferior.h should be used.  These are as follows:
 856
 857       ptid_build        - Make a new ptid from a pid, lwp, and tid.
 858       pid_to_ptid       - Make a new ptid from just a pid.
 859       ptid_get_pid      - Fetch the pid component of a ptid.
 860       ptid_get_lwp      - Fetch the lwp component of a ptid.
 861       ptid_get_tid      - Fetch the tid component of a ptid.
 862       ptid_equal        - Test to see if two ptids are equal.
 863
 864    Please do NOT access the struct ptid members directly (except, of
 865    course, in the implementation of the above ptid manipulation
 866    functions).  */
 867
 868 struct ptid
 869   {
 870     /* Process id */
 871     int pid;
 872
 873     /* Lightweight process id */
 874     long lwp;
 875
 876     /* Thread id */
 877     long tid;
 878   };
 879
 880 typedef struct ptid ptid_t;
 881
 882 \f
 883
 884 /* Optional host machine definition.  Pure autoconf targets will not
 885    need a "xm.h" file.  This will be a symlink to one of the xm-*.h
 886    files, built by the `configure' script.  */
 887
 888 #ifdef GDB_XM_FILE
 889 #include "xm.h"
 890 #endif
 891
 892 /* Optional native machine support.  Non-native (and possibly pure
 893    multi-arch) targets do not need a "nm.h" file.  This will be a
 894    symlink to one of the nm-*.h files, built by the `configure'
 895    script.  */
 896
 897 #ifdef GDB_NM_FILE
 898 #include "nm.h"
 899 #endif
 900
 901 /* Optional target machine definition.  Pure multi-arch configurations
 902    do not need a "tm.h" file.  This will be a symlink to one of the
 903    tm-*.h files, built by the `configure' script.  */
 904
 905 #ifdef GDB_TM_FILE
 906 #include "tm.h"
 907 #endif
 908
 909 /* GDB_MULTI_ARCH is normally set by configure.in using information
 910    from configure.tgt or the config/%/%.mt Makefile fragment.  Since
 911    some targets have defined it in their "tm.h" file, delay providing
 912    a default definition until after "tm.h" has been included.. */
 913
 914 #ifndef GDB_MULTI_ARCH
 915 #define GDB_MULTI_ARCH 0
 916 #endif
 917
 918
 919 /* If the xm.h file did not define the mode string used to open the
 920    files, assume that binary files are opened the same way as text
 921    files */
 922 #ifndef FOPEN_RB
 923 #include "fopen-same.h"
 924 #endif
 925
 926 #define CONST_PTR const
 927
 928 /* Defaults for system-wide constants (if not defined by xm.h, we fake it).
 929    FIXME: Assumes 2's complement arithmetic */
 930
 931 #if !defined (UINT_MAX)
 932 #define UINT_MAX ((unsigned int)(~0))   /* 0xFFFFFFFF for 32-bits */
 933 #endif
 934
 935 #if !defined (INT_MAX)
 936 #define INT_MAX ((int)(UINT_MAX >> 1))  /* 0x7FFFFFFF for 32-bits */
 937 #endif
 938
 939 #if !defined (INT_MIN)
 940 #define INT_MIN ((int)((int) ~0 ^ INT_MAX))     /* 0x80000000 for 32-bits */
 941 #endif
 942
 943 #if !defined (ULONG_MAX)
 944 #define ULONG_MAX ((unsigned long)(~0L))        /* 0xFFFFFFFF for 32-bits */
 945 #endif
 946
 947 #if !defined (LONG_MAX)
 948 #define LONG_MAX ((long)(ULONG_MAX >> 1))       /* 0x7FFFFFFF for 32-bits */
 949 #endif
 950
 951 #if !defined (ULONGEST_MAX)
 952 #define ULONGEST_MAX (~(ULONGEST)0)        /* 0xFFFFFFFFFFFFFFFF for 64-bits */
 953 #endif
 954
 955 #if !defined (LONGEST_MAX)                 /* 0x7FFFFFFFFFFFFFFF for 64-bits */
 956 #define LONGEST_MAX ((LONGEST)(ULONGEST_MAX >> 1))
 957 #endif
 958
 959 /* Convert a LONGEST to an int.  This is used in contexts (e.g. number of
 960    arguments to a function, number in a value history, register number, etc.)
 961    where the value must not be larger than can fit in an int.  */
 962
 963 extern int longest_to_int (LONGEST);
 964
 965 /* Assorted functions we can declare, now that const and volatile are
 966    defined.  */
 967
 968 extern char *savestring (const char *, size_t);
 969
 970 extern char *msavestring (void *, const char *, size_t);
 971
 972 extern char *mstrsave (void *, const char *);
 973
 974 #if !defined (USE_MMALLOC)
 975 /* NOTE: cagney/2000-03-04: The mmalloc functions need to use PTR
 976    rather than void* so that they are consistent with the delcaration
 977    in ../mmalloc/mmalloc.h. */
 978 extern PTR mcalloc (PTR, size_t, size_t);
 979 extern PTR mmalloc (PTR, size_t);
 980 extern PTR mrealloc (PTR, PTR, size_t);
 981 extern void mfree (PTR, PTR);
 982 #endif
 983
 984 /* Robust versions of same.  Throw an internal error when no memory,
 985    guard against stray NULL arguments. */
 986 extern void *xmmalloc (void *md, size_t size);
 987 extern void *xmrealloc (void *md, void *ptr, size_t size);
 988 extern void *xmcalloc (void *md, size_t number, size_t size);
 989 extern void xmfree (void *md, void *ptr);
 990
 991 /* xmalloc(), xrealloc() and xcalloc() have already been declared in
 992    "libiberty.h". */
 993 extern void xfree (void *);
 994
 995 /* Like asprintf/vasprintf but get an internal_error if the call
 996    fails. */
 997 extern void xasprintf (char **ret, const char *format, ...) ATTR_FORMAT (printf, 2, 3);
 998 extern void xvasprintf (char **ret, const char *format, va_list ap);
 999
1000 extern int parse_escape (char **);
1001
1002 /* Message to be printed before the error message, when an error occurs.  */
1003
1004 extern char *error_pre_print;
1005
1006 /* Message to be printed before the error message, when an error occurs.  */
1007
1008 extern char *quit_pre_print;
1009
1010 /* Message to be printed before the warning message, when a warning occurs.  */
1011
1012 extern char *warning_pre_print;
1013
1014 extern NORETURN void verror (const char *fmt, va_list ap) ATTR_NORETURN;
1015
1016 extern NORETURN void error (const char *fmt, ...) ATTR_NORETURN;
1017
1018 /* DEPRECATED: Use error(), verror() or error_stream(). */
1019 extern NORETURN void error_begin (void);
1020
1021 extern NORETURN void error_stream (struct ui_file *) ATTR_NORETURN;
1022
1023 /* Returns a freshly allocate buffer containing the last error
1024    message.  */
1025 extern char *error_last_message (void);
1026
1027 extern NORETURN void internal_verror (const char *file, int line,
1028                                       const char *, va_list ap) ATTR_NORETURN;
1029
1030 extern NORETURN void internal_error (const char *file, int line,
1031                                      const char *, ...) ATTR_NORETURN ATTR_FORMAT (printf, 3, 4);
1032
1033 extern NORETURN void nomem (long) ATTR_NORETURN;
1034
1035 /* Reasons for calling return_to_top_level.  Note: enum value 0 is
1036    reserved for internal use as the return value from an initial
1037    setjmp().  */
1038
1039 enum return_reason
1040   {
1041     /* User interrupt.  */
1042     RETURN_QUIT = 1,
1043     /* Any other error.  */
1044     RETURN_ERROR
1045   };
1046
1047 #define ALL_CLEANUPS    ((struct cleanup *)0)
1048
1049 #define RETURN_MASK(reason)     (1 << (int)(reason))
1050 #define RETURN_MASK_QUIT        RETURN_MASK (RETURN_QUIT)
1051 #define RETURN_MASK_ERROR       RETURN_MASK (RETURN_ERROR)
1052 #define RETURN_MASK_ALL         (RETURN_MASK_QUIT | RETURN_MASK_ERROR)
1053 typedef int return_mask;
1054
1055 extern NORETURN void return_to_top_level (enum return_reason) ATTR_NORETURN;
1056
1057 /* If CATCH_ERRORS_FTYPE throws an error, catch_errors() returns zero
1058    otherwize the result from CATCH_ERRORS_FTYPE is returned. It is
1059    probably useful for CATCH_ERRORS_FTYPE to always return a non-zero
1060    value. It's unfortunate that, catch_errors() does not return an
1061    indication of the exact exception that it caught - quit_flag might
1062    help. */
1063
1064 typedef int (catch_errors_ftype) (PTR);
1065 extern int catch_errors (catch_errors_ftype *, PTR, char *, return_mask);
1066
1067 /* Template to catch_errors() that wraps calls to command
1068    functions. */
1069
1070 typedef void (catch_command_errors_ftype) (char *, int);
1071 extern int catch_command_errors (catch_command_errors_ftype *func, char *command, int from_tty, return_mask);
1072
1073 extern void warning_begin (void);
1074
1075 extern void warning (const char *, ...) ATTR_FORMAT (printf, 1, 2);
1076
1077 /* Global functions from other, non-gdb GNU thingies.
1078    Libiberty thingies are no longer declared here.  We include libiberty.h
1079    above, instead.  */
1080
1081 #ifndef GETENV_PROVIDED
1082 extern char *getenv (const char *);
1083 #endif
1084
1085 /* From other system libraries */
1086
1087 #ifdef HAVE_STDDEF_H
1088 #include <stddef.h>
1089 #endif
1090
1091 #ifdef HAVE_STDLIB_H
1092 #include <stdlib.h>
1093 #endif
1094 #ifndef min
1095 #define min(a, b) ((a) < (b) ? (a) : (b))
1096 #endif
1097 #ifndef max
1098 #define max(a, b) ((a) > (b) ? (a) : (b))
1099 #endif
1100
1101
1102 /* We take the address of fclose later, but some stdio's forget
1103    to declare this.  We can't always declare it since there's
1104    no way to declare the parameters without upsetting some compiler
1105    somewhere. */
1106
1107 #ifndef FCLOSE_PROVIDED
1108 extern int fclose (FILE *);
1109 #endif
1110
1111 #ifndef atof
1112 extern double atof (const char *);      /* X3.159-1989  4.10.1.1 */
1113 #endif
1114
1115 /* Various possibilities for alloca.  */
1116 #ifndef alloca
1117 #ifdef __GNUC__
1118 #define alloca __builtin_alloca
1119 #else /* Not GNU C */
1120 #ifdef HAVE_ALLOCA_H
1121 #include <alloca.h>
1122 #else
1123 #ifdef _AIX
1124 #pragma alloca
1125 #else
1126
1127 /* We need to be careful not to declare this in a way which conflicts with
1128    bison.  Bison never declares it as char *, but under various circumstances
1129    (like __hpux) we need to use void *.  */
1130 extern void *alloca ();
1131 #endif /* Not _AIX */
1132 #endif /* Not HAVE_ALLOCA_H */
1133 #endif /* Not GNU C */
1134 #endif /* alloca not defined */
1135
1136 /* HOST_BYTE_ORDER must be defined to one of these.  */
1137
1138 #ifdef HAVE_ENDIAN_H
1139 #include <endian.h>
1140 #endif
1141
1142 #if !defined (BIG_ENDIAN)
1143 #define BIG_ENDIAN 4321
1144 #endif
1145
1146 #if !defined (LITTLE_ENDIAN)
1147 #define LITTLE_ENDIAN 1234
1148 #endif
1149
1150 /* Dynamic target-system-dependent parameters for GDB. */
1151 #include "gdbarch.h"
1152 #if (GDB_MULTI_ARCH == 0)
1153 /* Multi-arch targets _should_ be including "arch-utils.h" directly
1154    into their *-tdep.c file.  This is a prop to help old non-
1155    multi-arch targets to continue to compile. */
1156 #include "arch-utils.h"
1157 #endif
1158
1159 /* Static target-system-dependent parameters for GDB. */
1160
1161 /* Number of bits in a char or unsigned char for the target machine.
1162    Just like CHAR_BIT in <limits.h> but describes the target machine.  */
1163 #if !defined (TARGET_CHAR_BIT)
1164 #define TARGET_CHAR_BIT 8
1165 #endif
1166
1167 /* If we picked up a copy of CHAR_BIT from a configuration file
1168    (which may get it by including <limits.h>) then use it to set
1169    the number of bits in a host char.  If not, use the same size
1170    as the target. */
1171
1172 #if defined (CHAR_BIT)
1173 #define HOST_CHAR_BIT CHAR_BIT
1174 #else
1175 #define HOST_CHAR_BIT TARGET_CHAR_BIT
1176 #endif
1177
1178 /* The bit byte-order has to do just with numbering of bits in
1179    debugging symbols and such.  Conceptually, it's quite separate
1180    from byte/word byte order.  */
1181
1182 #if !defined (BITS_BIG_ENDIAN)
1183 #define BITS_BIG_ENDIAN (TARGET_BYTE_ORDER == BIG_ENDIAN)
1184 #endif
1185
1186 /* In findvar.c.  */
1187
1188 extern LONGEST extract_signed_integer (void *, int);
1189
1190 extern ULONGEST extract_unsigned_integer (void *, int);
1191
1192 extern int extract_long_unsigned_integer (void *, int, LONGEST *);
1193
1194 extern CORE_ADDR extract_address (void *, int);
1195
1196 extern CORE_ADDR extract_typed_address (void *buf, struct type *type);
1197
1198 extern void store_signed_integer (void *, int, LONGEST);
1199
1200 extern void store_unsigned_integer (void *, int, ULONGEST);
1201
1202 extern void store_address (void *, int, LONGEST);
1203
1204 extern void store_typed_address (void *buf, struct type *type, CORE_ADDR addr);
1205
1206 /* Setup definitions for host and target floating point formats.  We need to
1207    consider the format for `float', `double', and `long double' for both target
1208    and host.  We need to do this so that we know what kind of conversions need
1209    to be done when converting target numbers to and from the hosts DOUBLEST
1210    data type.  */
1211
1212 /* This is used to indicate that we don't know the format of the floating point
1213    number.  Typically, this is useful for native ports, where the actual format
1214    is irrelevant, since no conversions will be taking place.  */
1215
1216 extern const struct floatformat floatformat_unknown;
1217
1218 #if HOST_BYTE_ORDER == BIG_ENDIAN
1219 #ifndef HOST_FLOAT_FORMAT
1220 #define HOST_FLOAT_FORMAT &floatformat_ieee_single_big
1221 #endif
1222 #ifndef HOST_DOUBLE_FORMAT
1223 #define HOST_DOUBLE_FORMAT &floatformat_ieee_double_big
1224 #endif
1225 #else /* LITTLE_ENDIAN */
1226 #ifndef HOST_FLOAT_FORMAT
1227 #define HOST_FLOAT_FORMAT &floatformat_ieee_single_little
1228 #endif
1229 #ifndef HOST_DOUBLE_FORMAT
1230 #define HOST_DOUBLE_FORMAT &floatformat_ieee_double_little
1231 #endif
1232 #endif
1233
1234 #ifndef HOST_LONG_DOUBLE_FORMAT
1235 #define HOST_LONG_DOUBLE_FORMAT &floatformat_unknown
1236 #endif
1237
1238 /* Use `long double' if the host compiler supports it.  (Note that this is not
1239    necessarily any longer than `double'.  On SunOS/gcc, it's the same as
1240    double.)  This is necessary because GDB internally converts all floating
1241    point values to the widest type supported by the host.
1242
1243    There are problems however, when the target `long double' is longer than the
1244    host's `long double'.  In general, we'll probably reduce the precision of
1245    any such values and print a warning.  */
1246
1247 #ifdef HAVE_LONG_DOUBLE
1248 typedef long double DOUBLEST;
1249 #else
1250 typedef double DOUBLEST;
1251 #endif
1252
1253 extern void floatformat_to_doublest (const struct floatformat *,
1254                                      char *, DOUBLEST *);
1255 extern void floatformat_from_doublest (const struct floatformat *,
1256                                        DOUBLEST *, char *);
1257
1258 extern int floatformat_is_negative (const struct floatformat *, char *);
1259 extern int floatformat_is_nan (const struct floatformat *, char *);
1260 extern char *floatformat_mantissa (const struct floatformat *, char *);
1261
1262 extern DOUBLEST extract_floating (void *, int);
1263 extern void store_floating (void *, int, DOUBLEST);
1264 \f
1265 /* From valops.c */
1266
1267 extern CORE_ADDR push_bytes (CORE_ADDR, char *, int);
1268
1269 extern CORE_ADDR push_word (CORE_ADDR, ULONGEST);
1270
1271 extern int watchdog;
1272
1273 /* Hooks for alternate command interfaces.  */
1274
1275 #ifdef UI_OUT
1276 /* The name of the interpreter if specified on the command line. */
1277 extern char *interpreter_p;
1278 #endif
1279
1280 /* If a given interpreter matches INTERPRETER_P then it should update
1281    command_loop_hook and init_ui_hook with the per-interpreter
1282    implementation. */
1283 /* FIXME: command_loop_hook and init_ui_hook should be moved here. */
1284
1285 struct target_waitstatus;
1286 struct cmd_list_element;
1287
1288 /* Should the asynchronous variant of the interpreter (using the
1289    event-loop) be enabled? */
1290 extern int event_loop_p;
1291
1292 extern void (*init_ui_hook) (char *argv0);
1293 extern void (*command_loop_hook) (void);
1294 extern void (*show_load_progress) (const char *section,
1295                                    unsigned long section_sent,
1296                                    unsigned long section_size,
1297                                    unsigned long total_sent,
1298                                    unsigned long total_size);
1299 extern void (*print_frame_info_listing_hook) (struct symtab * s,
1300                                               int line, int stopline,
1301                                               int noerror);
1302 extern struct frame_info *parse_frame_specification (char *frame_exp);
1303 extern int (*query_hook) (const char *, va_list);
1304 extern void (*warning_hook) (const char *, va_list);
1305 extern void (*flush_hook) (struct ui_file * stream);
1306 extern void (*create_breakpoint_hook) (struct breakpoint * b);
1307 extern void (*delete_breakpoint_hook) (struct breakpoint * bpt);
1308 extern void (*modify_breakpoint_hook) (struct breakpoint * bpt);
1309 extern void (*interactive_hook) (void);
1310 extern void (*registers_changed_hook) (void);
1311 extern void (*readline_begin_hook) (char *,...);
1312 extern char *(*readline_hook) (char *);
1313 extern void (*readline_end_hook) (void);
1314 extern void (*register_changed_hook) (int regno);
1315 extern void (*memory_changed_hook) (CORE_ADDR addr, int len);
1316 extern void (*context_hook) (int);
1317 extern ptid_t (*target_wait_hook) (ptid_t ptid,
1318                                          struct target_waitstatus * status);
1319
1320 extern void (*attach_hook) (void);
1321 extern void (*detach_hook) (void);
1322 extern void (*call_command_hook) (struct cmd_list_element * c,
1323                                   char *cmd, int from_tty);
1324
1325 extern void (*set_hook) (struct cmd_list_element * c);
1326
1327 extern NORETURN void (*error_hook) (void) ATTR_NORETURN;
1328
1329 extern void (*error_begin_hook) (void);
1330
1331 extern int (*ui_load_progress_hook) (const char *section, unsigned long num);
1332
1333
1334 /* Inhibit window interface if non-zero. */
1335
1336 extern int use_windows;
1337
1338 /* Symbolic definitions of filename-related things.  */
1339 /* FIXME, this doesn't work very well if host and executable
1340    filesystems conventions are different.  */
1341
1342 #ifndef DIRNAME_SEPARATOR
1343 #define DIRNAME_SEPARATOR ':'
1344 #endif
1345
1346 #ifndef SLASH_STRING
1347 #ifdef _WIN32
1348 #define SLASH_STRING "\\"
1349 #else
1350 #define SLASH_STRING "/"
1351 #endif
1352 #endif
1353
1354 /* Provide default definitions of PIDGET, TIDGET, and MERGEPID.
1355    The name ``TIDGET'' is a historical accident.  Many uses of TIDGET
1356    in the code actually refer to a lightweight process id, i.e,
1357    something that can be considered a process id in its own right for
1358    certain purposes.  */
1359
1360 #ifndef PIDGET
1361 #define PIDGET(PTID) (ptid_get_pid (PTID))
1362 #define TIDGET(PTID) (ptid_get_lwp (PTID))
1363 #define MERGEPID(PID, TID) ptid_build (PID, TID, 0)
1364 #endif
1365
1366 /* Define well known filenos if the system does not define them.  */
1367 #ifndef STDIN_FILENO
1368 #define STDIN_FILENO   0
1369 #endif
1370 #ifndef STDOUT_FILENO
1371 #define STDOUT_FILENO  1
1372 #endif
1373 #ifndef STDERR_FILENO
1374 #define STDERR_FILENO  2
1375 #endif
1376
1377 /* If this definition isn't overridden by the header files, assume
1378    that isatty and fileno exist on this system.  */
1379 #ifndef ISATTY
1380 #define ISATTY(FP)      (isatty (fileno (FP)))
1381 #endif
1382
1383 \f
1384 /* FIXME: cagney/1999-12-13: The following will be moved to gdb.h /
1385    libgdb.h or gdblib.h. */
1386
1387 /* Return-code (RC) from a gdb library call.  (The abreviation RC is
1388    taken from the sim/common directory.) */
1389
1390 enum gdb_rc {
1391   /* The operation failed.  The failure message can be fetched by
1392      calling ``char *error_last_message(void)''. The value is
1393      determined by the catch_errors() interface. */
1394   /* NOTE: Since ``defs.h:catch_errors()'' does not return an error /
1395      internal / quit indication it is not possible to return that
1396      here. */
1397   GDB_RC_FAIL = 0,
1398   /* No error occured but nothing happened. Due to the catch_errors()
1399      interface, this must be non-zero. */
1400   GDB_RC_NONE = 1,
1401   /* The operation was successful. Due to the catch_errors()
1402      interface, this must be non-zero. */
1403   GDB_RC_OK = 2
1404 };
1405
1406
1407 /* Print the specified breakpoint on GDB_STDOUT. (Eventually this
1408    function will ``print'' the object on ``output''). */
1409 enum gdb_rc gdb_breakpoint_query (/* struct {ui,gdb}_out *output, */ int bnum);
1410
1411 /* Create a breakpoint at ADDRESS (a GDB source and line). */
1412 enum gdb_rc gdb_breakpoint (char *address, char *condition,
1413                             int hardwareflag, int tempflag,
1414                             int thread, int ignore_count);
1415 enum gdb_rc gdb_thread_select (/* output object */ char *tidstr);
1416
1417 #ifdef UI_OUT
1418 /* Print a list of known thread ids. */
1419 enum gdb_rc gdb_list_thread_ids (/* output object */);
1420
1421 /* Switch thread and print notification. */
1422 #endif
1423 #endif /* #ifndef DEFS_H */