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