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