* tracepoint.c (trace_start_command): Set trace_running_p.
[deliverable/binutils-gdb.git] / gdb / defs.h
CommitLineData
7d9884b9 1/* Basic, host-specific, and target-specific definitions for GDB.
81afee37 2 Copyright (C) 1986, 1989, 1991, 1992, 1993, 1994, 1995, 1996
6f54efdc 3 Free Software Foundation, Inc.
bd5635a1
RP
4
5This file is part of GDB.
6
a10c0d36 7This program is free software; you can redistribute it and/or modify
bd5635a1 8it under the terms of the GNU General Public License as published by
a10c0d36
JG
9the Free Software Foundation; either version 2 of the License, or
10(at your option) any later version.
bd5635a1 11
a10c0d36 12This program is distributed in the hope that it will be useful,
bd5635a1
RP
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
a10c0d36 18along with this program; if not, write to the Free Software
b6d70e15 19Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
bd5635a1 20
09722039
SG
21#ifndef DEFS_H
22#define DEFS_H
d747e0af 23
a243a22f 24#include "config.h" /* Generated by configure */
d747e0af 25#include <stdio.h>
81afee37
FF
26#include <errno.h> /* System call error return status */
27
28/* Just in case they're not defined in stdio.h. */
29
30#ifndef SEEK_SET
31#define SEEK_SET 0
32#endif
33#ifndef SEEK_CUR
34#define SEEK_CUR 1
35#endif
d747e0af
MT
36
37/* First include ansidecl.h so we can use the various macro definitions
debd3443 38 here and in all subsequent file inclusions. */
d747e0af
MT
39
40#include "ansidecl.h"
41
45993f61
SC
42#ifdef ANSI_PROTOTYPES
43#include <stdarg.h>
44#else
45#include <varargs.h>
46#endif
47
97e7b66f
DE
48#include "libiberty.h"
49
50/* libiberty.h can't declare this one, but evidently we can. */
51extern char *strsignal PARAMS ((int));
52
c023fbf4
KH
53#include "progress.h"
54
031c4a7e 55#ifndef NO_MMALLOC
86db943c 56#include "mmalloc.h"
031c4a7e 57#endif
86db943c 58
7343d716
JK
59/* For BFD64 and bfd_vma. */
60#include "bfd.h"
61
62/* An address in the program being debugged. Host byte order. Rather
63 than duplicate all the logic in BFD which figures out what type
64 this is (long, long long, etc.) and whether it needs to be 64
65 bits (the host/target interactions are subtle), we just use
66 bfd_vma. */
67
68typedef bfd_vma CORE_ADDR;
bd5635a1 69
28444bf3 70#ifndef min
bd5635a1 71#define min(a, b) ((a) < (b) ? (a) : (b))
28444bf3
DP
72#endif
73#ifndef max
bd5635a1 74#define max(a, b) ((a) > (b) ? (a) : (b))
28444bf3 75#endif
bd5635a1 76
2e4964ad
FF
77/* Gdb does *lots* of string compares. Use macros to speed them up by
78 avoiding function calls if the first characters are not the same. */
79
bd5d07d9 80#define STRCMP(a,b) (*(a) == *(b) ? strcmp ((a), (b)) : (int)*(a) - (int)*(b))
2e4964ad
FF
81#define STREQ(a,b) (*(a) == *(b) ? !strcmp ((a), (b)) : 0)
82#define STREQN(a,b,c) (*(a) == *(b) ? !strncmp ((a), (b), (c)) : 0)
83
dd577ca5 84/* The character GNU C++ uses to build identifiers that must be unique from
bd5635a1
RP
85 the program's identifiers (such as $this and $$vptr). */
86#define CPLUS_MARKER '$' /* May be overridden to '.' for SysV */
87
81afee37
FF
88/* Check if a character is one of the commonly used C++ marker characters. */
89extern int is_cplus_marker PARAMS ((int));
bd5635a1
RP
90
91extern int quit_flag;
92extern int immediate_quit;
51b80b00 93extern int sevenbit_strings;
d747e0af 94
6f54efdc 95extern void quit PARAMS ((void));
bd5635a1 96
28444bf3
DP
97#ifdef QUIT
98/* do twice to force compiler warning */
16a43bf4
DP
99#define QUIT_FIXME "FIXME"
100#define QUIT_FIXME "ignoring redefinition of QUIT"
28444bf3 101#else
c023fbf4
KH
102#define QUIT { \
103 if (quit_flag) quit (); \
104 if (interactive_hook) interactive_hook (); \
105 PROGRESS (1); \
106}
28444bf3 107#endif
bd5635a1 108
e58de8a2
FF
109/* Command classes are top-level categories into which commands are broken
110 down for "help" purposes.
111 Notes on classes: class_alias is for alias commands which are not
112 abbreviations of the original command. class-pseudo is for commands
113 which are not really commands nor help topics ("stop"). */
bd5635a1
RP
114
115enum command_class
116{
117 /* Special args to help_list */
118 all_classes = -2, all_commands = -1,
119 /* Classes of commands */
120 no_class = -1, class_run = 0, class_vars, class_stack,
7e9576e0 121 class_files, class_support, class_info, class_breakpoint, class_trace,
e58de8a2
FF
122 class_alias, class_obscure, class_user, class_maintenance,
123 class_pseudo
bd5635a1
RP
124};
125
bd5d07d9
FF
126/* Languages represented in the symbol table and elsewhere.
127 This should probably be in language.h, but since enum's can't
128 be forward declared to satisfy opaque references before their
129 actual definition, needs to be here. */
130
131enum language
132{
133 language_unknown, /* Language not known */
134 language_auto, /* Placeholder for automatic setting */
135 language_c, /* C */
136 language_cplus, /* C++ */
7a9eb4c4 137 language_java, /* Java */
bd5d07d9 138 language_chill, /* Chill */
e52bfe0c 139 language_fortran, /* Fortran */
754e5da2 140 language_m2, /* Modula-2 */
0e4ca328
PB
141 language_asm, /* Assembly language */
142 language_scm /* Scheme / Guile */
bd5d07d9
FF
143};
144
bd5635a1
RP
145/* the cleanup list records things that have to be undone
146 if an error happens (descriptors to be closed, memory to be freed, etc.)
147 Each link in the chain records a function to call and an
148 argument to give it.
149
150 Use make_cleanup to add an element to the cleanup chain.
151 Use do_cleanups to do all cleanup actions back to a given
152 point in the chain. Use discard_cleanups to remove cleanups
153 from the chain back to a given point, not doing them. */
154
155struct cleanup
156{
157 struct cleanup *next;
d747e0af
MT
158 void (*function) PARAMS ((PTR));
159 PTR arg;
bd5635a1
RP
160};
161
413cba82
JL
162
163/* The ability to declare that a function never returns is useful, but
164 not really required to compile GDB successfully, so the NORETURN and
165 ATTR_NORETURN macros normally expand into nothing. */
166
167/* If compiling with older versions of GCC, a function may be declared
168 "volatile" to indicate that it does not return. */
169
170#ifndef NORETURN
171# if defined(__GNUC__) \
b6d70e15 172 && (__GNUC__ == 1 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7))
413cba82
JL
173# define NORETURN volatile
174# else
175# define NORETURN /* nothing */
176# endif
177#endif
178
179/* GCC 2.5 and later versions define a function attribute "noreturn",
b6d70e15
SC
180 which is the preferred way to declare that a function never returns.
181 However GCC 2.7 appears to be the first version in which this fully
182 works everywhere we use it. */
413cba82
JL
183
184#ifndef ATTR_NORETURN
b6d70e15 185# if defined(__GNUC__) && __GNUC__ >= 2 && __GNUC_MINOR__ >= 7
413cba82
JL
186# define ATTR_NORETURN __attribute__ ((noreturn))
187# else
188# define ATTR_NORETURN /* nothing */
189# endif
190#endif
191
192#ifndef ATTR_FORMAT
b6d70e15 193# if defined(__GNUC__) && __GNUC__ >= 2 && __GNUC_MINOR__ >= 4 && defined (__ANSI_PROTOTYPES)
413cba82
JL
194# define ATTR_FORMAT(type, x, y) __attribute__ ((format(type, x, y)))
195# else
196# define ATTR_FORMAT(type, x, y) /* nothing */
197# endif
198#endif
199
637b1661
SG
200/* Needed for various prototypes */
201
202#ifdef __STDC__
203struct symtab;
204struct breakpoint;
205#endif
206
d747e0af
MT
207/* From blockframe.c */
208
6f54efdc 209extern int inside_entry_func PARAMS ((CORE_ADDR));
d747e0af 210
6f54efdc 211extern int inside_entry_file PARAMS ((CORE_ADDR addr));
d747e0af 212
6f54efdc 213extern int inside_main_func PARAMS ((CORE_ADDR pc));
d747e0af 214
7532cf10
FF
215/* From ch-lang.c, for the moment. (FIXME) */
216
6f54efdc 217extern char *chill_demangle PARAMS ((const char *));
7532cf10 218
d747e0af
MT
219/* From utils.c */
220
b607efe7
FF
221extern void notice_quit PARAMS ((void));
222
6f54efdc 223extern int strcmp_iw PARAMS ((const char *, const char *));
d630b615 224
6f54efdc 225extern char *safe_strerror PARAMS ((int));
e146177e 226
6f54efdc 227extern char *safe_strsignal PARAMS ((int));
e146177e 228
6f54efdc 229extern void init_malloc PARAMS ((void *));
d747e0af 230
6f54efdc 231extern void request_quit PARAMS ((int));
d747e0af 232
6f54efdc 233extern void do_cleanups PARAMS ((struct cleanup *));
16a43bf4 234extern void do_final_cleanups PARAMS ((struct cleanup *));
7a9eb4c4 235extern void do_my_cleanups PARAMS ((struct cleanup **, struct cleanup *));
d747e0af 236
6f54efdc 237extern void discard_cleanups PARAMS ((struct cleanup *));
16a43bf4 238extern void discard_final_cleanups PARAMS ((struct cleanup *));
7a9eb4c4 239extern void discard_my_cleanups PARAMS ((struct cleanup **, struct cleanup *));
d747e0af
MT
240
241/* The bare make_cleanup function is one of those rare beasts that
242 takes almost any type of function as the first arg and anything that
243 will fit in a "void *" as the second arg.
244
245 Should be, once all calls and called-functions are cleaned up:
246extern struct cleanup *
84d59861 247make_cleanup PARAMS ((void (*function) (void *), void *));
d747e0af
MT
248
249 Until then, lint and/or various type-checking compiler options will
250 complain about make_cleanup calls. It'd be wrong to just cast things,
251 since the type actually passed when the function is called would be
252 wrong. */
253
6f54efdc 254extern struct cleanup *make_cleanup ();
16a43bf4
DP
255extern struct cleanup *
256make_final_cleanup PARAMS ((void (*function) (void *), void *));
257extern struct cleanup *
7a9eb4c4 258make_my_cleanup PARAMS ((struct cleanup **, void (*function) (void *), void *));
d747e0af 259
6f54efdc 260extern struct cleanup *save_cleanups PARAMS ((void));
16a43bf4 261extern struct cleanup *save_final_cleanups PARAMS ((void));
7a9eb4c4 262extern struct cleanup *save_my_cleanups PARAMS ((struct cleanup **));
d747e0af 263
6f54efdc 264extern void restore_cleanups PARAMS ((struct cleanup *));
16a43bf4 265extern void restore_final_cleanups PARAMS ((struct cleanup *));
7a9eb4c4 266extern void restore_my_cleanups PARAMS ((struct cleanup **, struct cleanup *));
d747e0af 267
6f54efdc 268extern void free_current_contents PARAMS ((char **));
d747e0af 269
b607efe7 270extern void null_cleanup PARAMS ((PTR));
d747e0af 271
6f54efdc 272extern int myread PARAMS ((int, char *, int));
d747e0af 273
413cba82
JL
274extern int query PARAMS((char *, ...))
275 ATTR_FORMAT(printf, 1, 2);
b607efe7
FF
276
277/* From demangle.c */
278
279extern void set_demangling_style PARAMS ((char *));
280
6c803036 281\f
96f7edbd
JK
282/* Annotation stuff. */
283
6c803036
JK
284extern int annotation_level; /* in stack.c */
285\f
6f54efdc 286extern void begin_line PARAMS ((void));
51b80b00 287
6f54efdc 288extern void wrap_here PARAMS ((char *));
d747e0af 289
6f54efdc 290extern void reinitialize_more_filter PARAMS ((void));
d747e0af 291
04f566a3
JK
292typedef FILE GDB_FILE;
293#define gdb_stdout stdout
294#define gdb_stderr stderr
295
6f54efdc 296extern void gdb_flush PARAMS ((GDB_FILE *));
04f566a3 297
6f54efdc 298extern GDB_FILE *gdb_fopen PARAMS ((char * name, char * mode));
04f566a3 299
6f54efdc 300extern void fputs_filtered PARAMS ((const char *, GDB_FILE *));
04f566a3 301
6f54efdc 302extern void fputs_unfiltered PARAMS ((const char *, GDB_FILE *));
d747e0af 303
8989d4fc 304extern int fputc_unfiltered PARAMS ((int c, GDB_FILE *));
04f566a3 305
8989d4fc 306extern int putchar_unfiltered PARAMS ((int c));
d747e0af 307
81afee37 308extern void puts_filtered PARAMS ((const char *));
d747e0af 309
81afee37 310extern void puts_unfiltered PARAMS ((const char *));
04f566a3 311
7e9576e0
MA
312extern void puts_debug PARAMS ((char *prefix, char *string, char *suffix));
313
81afee37 314extern void vprintf_filtered PARAMS ((const char *, va_list))
413cba82 315 ATTR_FORMAT(printf, 1, 0);
51b80b00 316
81afee37 317extern void vfprintf_filtered PARAMS ((FILE *, const char *, va_list))
413cba82 318 ATTR_FORMAT(printf, 2, 0);
a8e033f2 319
81afee37 320extern void fprintf_filtered PARAMS ((FILE *, const char *, ...))
413cba82 321 ATTR_FORMAT(printf, 2, 3);
d747e0af 322
81afee37 323extern void fprintfi_filtered PARAMS ((int, FILE *, const char *, ...))
413cba82 324 ATTR_FORMAT(printf, 3, 4);
a8e033f2 325
81afee37 326extern void printf_filtered PARAMS ((const char *, ...))
413cba82 327 ATTR_FORMAT(printf, 1, 2);
d747e0af 328
81afee37 329extern void printfi_filtered PARAMS ((int, const char *, ...))
413cba82 330 ATTR_FORMAT(printf, 2, 3);
a8e033f2 331
81afee37 332extern void vprintf_unfiltered PARAMS ((const char *, va_list))
413cba82 333 ATTR_FORMAT(printf, 1, 0);
04f566a3 334
81afee37 335extern void vfprintf_unfiltered PARAMS ((FILE *, const char *, va_list))
413cba82 336 ATTR_FORMAT(printf, 2, 0);
04f566a3 337
81afee37 338extern void fprintf_unfiltered PARAMS ((FILE *, const char *, ...))
413cba82 339 ATTR_FORMAT(printf, 2, 3);
d747e0af 340
81afee37 341extern void printf_unfiltered PARAMS ((const char *, ...))
413cba82 342 ATTR_FORMAT(printf, 1, 2);
04f566a3 343
6f54efdc 344extern void print_spaces PARAMS ((int, GDB_FILE *));
04f566a3 345
6f54efdc 346extern void print_spaces_filtered PARAMS ((int, GDB_FILE *));
d747e0af 347
6f54efdc 348extern char *n_spaces PARAMS ((int));
d747e0af 349
6f54efdc 350extern void gdb_printchar PARAMS ((int, GDB_FILE *, int));
d747e0af 351
833e0d94
JK
352extern void gdb_print_address PARAMS ((void *, GDB_FILE *));
353
28444bf3
DP
354typedef bfd_vma t_addr;
355typedef bfd_vma t_reg;
356extern char* paddr PARAMS ((t_addr addr));
357
358extern char* preg PARAMS ((t_reg reg));
359
16a43bf4
DP
360extern char* paddr_nz PARAMS ((t_addr addr));
361
362extern char* preg_nz PARAMS ((t_reg reg));
363
6f54efdc
SS
364extern void fprintf_symbol_filtered PARAMS ((GDB_FILE *, char *,
365 enum language, int));
d747e0af 366
56e327b3 367extern NORETURN void perror_with_name PARAMS ((char *)) ATTR_NORETURN;
d747e0af 368
6f54efdc 369extern void print_sys_errmsg PARAMS ((char *, int));
d747e0af 370
1bef45ea
JK
371/* From regex.c or libc. BSD 4.4 declares this with the argument type as
372 "const char *" in unistd.h, so we can't declare the argument
373 as "char *". */
d747e0af 374
6f54efdc 375extern char *re_comp PARAMS ((const char *));
d747e0af
MT
376
377/* From symfile.c */
378
6f54efdc 379extern void symbol_file_command PARAMS ((char *, int));
d747e0af 380
eba08643 381/* From top.c */
d747e0af 382
6f54efdc 383extern char *skip_quoted PARAMS ((char *));
d630b615 384
6f54efdc 385extern char *gdb_readline PARAMS ((char *));
d747e0af 386
6f54efdc 387extern char *command_line_input PARAMS ((char *, int, char *));
d747e0af 388
6f54efdc 389extern void print_prompt PARAMS ((void));
d747e0af 390
6f54efdc 391extern int input_from_terminal_p PARAMS ((void));
d747e0af 392
eba08643
C
393extern int info_verbose;
394
bd5635a1 395/* From printcmd.c */
d747e0af 396
6f54efdc 397extern void set_next_address PARAMS ((CORE_ADDR));
d747e0af 398
6f54efdc
SS
399extern void print_address_symbolic PARAMS ((CORE_ADDR, GDB_FILE *, int,
400 char *));
d747e0af 401
6f54efdc 402extern void print_address_numeric PARAMS ((CORE_ADDR, int, GDB_FILE *));
833e0d94 403
6f54efdc 404extern void print_address PARAMS ((CORE_ADDR, GDB_FILE *));
bd5635a1 405
e1ce8aa5 406/* From source.c */
d747e0af 407
6f54efdc 408extern int openp PARAMS ((char *, int, char *, int, int, char **));
d747e0af 409
6f54efdc 410extern void mod_path PARAMS ((char *, char **));
d747e0af 411
6f54efdc 412extern void directory_command PARAMS ((char *, int));
d747e0af 413
6f54efdc 414extern void init_source_path PARAMS ((void));
d747e0af 415
637b1661
SG
416extern char *symtab_to_filename PARAMS ((struct symtab *));
417
d747e0af
MT
418/* From findvar.c */
419
6f54efdc 420extern int read_relative_register_raw_bytes PARAMS ((int, char *));
e1ce8aa5 421
bd5635a1 422/* From readline (but not in any readline .h files). */
d747e0af 423
6f54efdc 424extern char *tilde_expand PARAMS ((char *));
bd5635a1 425
78751d4f
PS
426/* Control types for commands */
427
428enum misc_command_type
429{
430 ok_command,
431 end_command,
432 else_command,
433 nop_command
434};
435
436enum command_control_type
437{
438 simple_control,
439 break_control,
440 continue_control,
441 while_control,
442 if_control,
443 invalid_control
444};
445
bd5635a1
RP
446/* Structure for saved commands lines
447 (for breakpoints, defined commands, etc). */
448
449struct command_line
450{
451 struct command_line *next;
452 char *line;
78751d4f
PS
453 enum command_control_type control_type;
454 int body_count;
455 struct command_line **body_list;
bd5635a1
RP
456};
457
91550191 458extern struct command_line *read_command_lines PARAMS ((char *, int));
d747e0af 459
6f54efdc 460extern void free_command_lines PARAMS ((struct command_line **));
bd5635a1
RP
461
462/* String containing the current directory (what getwd would return). */
463
d747e0af 464extern char *current_directory;
bd5635a1
RP
465
466/* Default radixes for input and output. Only some values supported. */
467extern unsigned input_radix;
468extern unsigned output_radix;
469
a8a69e63
FF
470/* Possibilities for prettyprint parameters to routines which print
471 things. Like enum language, this should be in value.h, but needs
472 to be here for the same reason. FIXME: If we can eliminate this
473 as an arg to LA_VAL_PRINT, then we can probably move it back to
474 value.h. */
475
476enum val_prettyprint
477{
478 Val_no_prettyprint = 0,
479 Val_prettyprint,
480 /* Use the default setting which the user has specified. */
481 Val_pretty_default
482};
483
0a5d35ed
SG
484\f
485/* Host machine definition. This will be a symlink to one of the
486 xm-*.h files, built by the `configure' script. */
487
488#include "xm.h"
489
e58de8a2
FF
490/* Native machine support. This will be a symlink to one of the
491 nm-*.h files, built by the `configure' script. */
492
493#include "nm.h"
494
c023fbf4
KH
495/* Target machine definition. This will be a symlink to one of the
496 tm-*.h files, built by the `configure' script. */
497
498#include "tm.h"
499
e146177e
SEF
500/* If the xm.h file did not define the mode string used to open the
501 files, assume that binary files are opened the same way as text
502 files */
503#ifndef FOPEN_RB
504#include "fopen-same.h"
505#endif
506
b51843d8
FF
507/* Microsoft C can't deal with const pointers */
508
509#ifdef _MSC_VER
510#define CONST_PTR
511#else
512#define CONST_PTR const
513#endif
514
0a5d35ed 515/*
b51843d8
FF
516 * Allow things in gdb to be declared "volatile". If compiling ANSI, it
517 * just works. If compiling with gcc but non-ansi, redefine to __volatile__.
518 * If non-ansi, non-gcc, then eliminate "volatile" entirely, making those
0a5d35ed
SG
519 * objects be read-write rather than read-only.
520 */
521
0a5d35ed
SG
522#ifndef volatile
523#ifndef __STDC__
524# ifdef __GNUC__
525# define volatile __volatile__
526# else
527# define volatile /*nothing*/
528# endif /* GNUC */
529#endif /* STDC */
530#endif /* volatile */
531
3f550b59
FF
532/* Defaults for system-wide constants (if not defined by xm.h, we fake it).
533 FIXME: Assumes 2's complement arithmetic */
0a5d35ed 534
bd5635a1 535#if !defined (UINT_MAX)
38dc5e12 536#define UINT_MAX ((unsigned int)(~0)) /* 0xFFFFFFFF for 32-bits */
bd5635a1
RP
537#endif
538
e1ce8aa5 539#if !defined (INT_MAX)
dd577ca5 540#define INT_MAX ((int)(UINT_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */
e1ce8aa5
JK
541#endif
542
543#if !defined (INT_MIN)
3f550b59 544#define INT_MIN ((int)((int) ~0 ^ INT_MAX)) /* 0x80000000 for 32-bits */
38dc5e12
SG
545#endif
546
547#if !defined (ULONG_MAX)
548#define ULONG_MAX ((unsigned long)(~0L)) /* 0xFFFFFFFF for 32-bits */
549#endif
550
551#if !defined (LONG_MAX)
552#define LONG_MAX ((long)(ULONG_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */
e1ce8aa5
JK
553#endif
554
7a9eb4c4
PB
555#ifndef LONGEST
556
7343d716
JK
557#ifdef BFD64
558
559/* This is to make sure that LONGEST is at least as big as CORE_ADDR. */
560
70126bf9 561#define LONGEST BFD_HOST_64_BIT
16a43bf4 562#define ULONGEST BFD_HOST_U_64_BIT
7343d716
JK
563
564#else /* No BFD64 */
565
7efb57c3
FF
566# ifdef CC_HAS_LONG_LONG
567# define LONGEST long long
16a43bf4 568# define ULONGEST unsigned long long
7efb57c3 569# else
7a9eb4c4
PB
570/* BFD_HOST_64_BIT is defined for some hosts that don't have long long
571 (e.g. i386-windows) so try it. */
572# ifdef BFD_HOST_64_BIT
573# define LONGEST BFD_HOST_64_BIT
574# define ULONGEST BFD_HOST_U_64_BIT
575# else
576# define LONGEST long
577# define ULONGEST unsigned long
578# endif
7efb57c3 579# endif
7efb57c3 580
7343d716
JK
581#endif /* No BFD64 */
582
7a9eb4c4
PB
583#endif /* ! LONGEST */
584
7efb57c3
FF
585/* Convert a LONGEST to an int. This is used in contexts (e.g. number of
586 arguments to a function, number in a value history, register number, etc.)
587 where the value must not be larger than can fit in an int. */
588
fb0f4231 589extern int longest_to_int PARAMS ((LONGEST));
d747e0af 590
0a5d35ed
SG
591/* Assorted functions we can declare, now that const and volatile are
592 defined. */
d747e0af 593
6f54efdc 594extern char *savestring PARAMS ((const char *, int));
d747e0af 595
6f54efdc 596extern char *msavestring PARAMS ((void *, const char *, int));
318bf84f 597
6f54efdc 598extern char *strsave PARAMS ((const char *));
d747e0af 599
6f54efdc 600extern char *mstrsave PARAMS ((void *, const char *));
318bf84f 601
cad9cd60 602#ifdef _MSC_VER /* FIXME; was long, but this causes compile errors in msvc if already defined */
28444bf3
DP
603extern PTR xmmalloc PARAMS ((PTR, size_t));
604
605extern PTR xmrealloc PARAMS ((PTR, PTR, size_t));
606#else
6f54efdc 607extern PTR xmmalloc PARAMS ((PTR, long));
318bf84f 608
6f54efdc 609extern PTR xmrealloc PARAMS ((PTR, PTR, long));
28444bf3 610#endif
318bf84f 611
6f54efdc 612extern int parse_escape PARAMS ((char **));
d747e0af 613
86db943c 614extern char *reg_names[];
d747e0af 615
833e0d94
JK
616/* Message to be printed before the error message, when an error occurs. */
617
618extern char *error_pre_print;
619
8989d4fc
JK
620/* Message to be printed before the error message, when an error occurs. */
621
622extern char *quit_pre_print;
623
833e0d94
JK
624/* Message to be printed before the warning message, when a warning occurs. */
625
626extern char *warning_pre_print;
627
56e327b3 628extern NORETURN void error PARAMS((const char *, ...)) ATTR_NORETURN;
a0cf4681
JK
629
630extern void error_begin PARAMS ((void));
d747e0af 631
85c613aa 632extern NORETURN void fatal PARAMS((char *, ...)) ATTR_NORETURN;
d747e0af 633
6f54efdc 634extern NORETURN void nomem PARAMS ((long)) ATTR_NORETURN;
318bf84f 635
2fcdae93
PS
636/* Reasons for calling return_to_top_level. */
637enum return_reason {
638 /* User interrupt. */
639 RETURN_QUIT,
640
641 /* Any other error. */
642 RETURN_ERROR
643};
644
645#define RETURN_MASK_QUIT (1 << (int)RETURN_QUIT)
646#define RETURN_MASK_ERROR (1 << (int)RETURN_ERROR)
647#define RETURN_MASK_ALL (RETURN_MASK_QUIT | RETURN_MASK_ERROR)
648typedef int return_mask;
649
6f54efdc
SS
650extern NORETURN void
651return_to_top_level PARAMS ((enum return_reason)) ATTR_NORETURN;
2fcdae93 652
6f54efdc
SS
653extern int
654catch_errors PARAMS ((int (*) (char *), void *, char *, return_mask));
d747e0af 655
8989d4fc 656extern void warning_begin PARAMS ((void));
d747e0af 657
56e327b3 658extern void warning PARAMS ((const char *, ...))
413cba82 659 ATTR_FORMAT(printf, 1, 2);
d747e0af 660
97e7b66f
DE
661/* Global functions from other, non-gdb GNU thingies.
662 Libiberty thingies are no longer declared here. We include libiberty.h
663 above, instead. */
d747e0af 664
6b009ef6 665#ifndef GETENV_PROVIDED
6f54efdc 666extern char *getenv PARAMS ((const char *));
6b009ef6 667#endif
d747e0af 668
e146177e
SEF
669/* From other system libraries */
670
b51843d8 671#ifdef HAVE_STDDEF_H
d747e0af 672#include <stddef.h>
b51843d8
FF
673#endif
674
675#ifdef HAVE_STDLIB_H
28444bf3
DP
676#if defined(_MSC_VER) && !defined(__cplusplus)
677/* msvc defines these in stdlib.h for c code */
678#undef min
679#undef max
680#endif
e3be225e 681#include <stdlib.h>
0a5d35ed 682#endif
28444bf3
DP
683#ifndef min
684#define min(a, b) ((a) < (b) ? (a) : (b))
685#endif
686#ifndef max
687#define max(a, b) ((a) > (b) ? (a) : (b))
688#endif
d747e0af 689
6b009ef6
SC
690
691/* We take the address of fclose later, but some stdio's forget
692 to declare this. We can't always declare it since there's
693 no way to declare the parameters without upsetting some compiler
694 somewhere. */
695
696#ifndef FCLOSE_PROVIDED
b607efe7 697extern int fclose PARAMS ((FILE *));
6b009ef6 698#endif
e146177e 699
8989d4fc 700#ifndef atof
b607efe7 701extern double atof PARAMS ((const char *)); /* X3.159-1989 4.10.1.1 */
8989d4fc 702#endif
51b57ded 703
d747e0af 704#ifndef MALLOC_INCOMPATIBLE
318bf84f 705
b51843d8 706#ifdef NEED_DECLARATION_MALLOC
e3be225e 707extern PTR malloc ();
b51843d8 708#endif
d747e0af 709
b51843d8 710#ifdef NEED_DECLARATION_REALLOC
e3be225e 711extern PTR realloc ();
b51843d8 712#endif
318bf84f 713
b51843d8 714#ifdef NEED_DECLARATION_FREE
e3be225e 715extern void free ();
b51843d8 716#endif
d747e0af 717
e3be225e 718#endif /* MALLOC_INCOMPATIBLE */
d747e0af 719
0a5d35ed
SG
720/* Various possibilities for alloca. */
721#ifndef alloca
722# ifdef __GNUC__
723# define alloca __builtin_alloca
7343d716 724# else /* Not GNU C */
0a5d35ed 725# ifdef sparc
22fd4704 726# include <alloca.h> /* NOTE: Doesn't declare alloca() */
e676a15f 727# endif
7343d716
JK
728
729/* We need to be careful not to declare this in a way which conflicts with
730 bison. Bison never declares it as char *, but under various circumstances
731 (like __hpux) we need to use void *. */
732# if defined (__STDC__) || defined (__hpux)
733 extern void *alloca ();
734# else /* Don't use void *. */
0f552c5f 735 extern char *alloca ();
7343d716
JK
736# endif /* Don't use void *. */
737# endif /* Not GNU C */
738#endif /* alloca not defined */
e2aab031 739
479f0f18 740/* HOST_BYTE_ORDER must be defined to one of these. */
a10c0d36 741
d8efbc66
FF
742#ifdef HAVE_ENDIAN_H
743#include <endian.h>
744#endif
745
0a5d35ed
SG
746#if !defined (BIG_ENDIAN)
747#define BIG_ENDIAN 4321
748#endif
a10c0d36 749
0a5d35ed
SG
750#if !defined (LITTLE_ENDIAN)
751#define LITTLE_ENDIAN 1234
752#endif
a10c0d36 753
2fcdae93 754/* Target-system-dependent parameters for GDB. */
7d9884b9 755
479f0f18
SG
756#ifdef TARGET_BYTE_ORDER_SELECTABLE
757/* The target endianness is selectable at runtime. Define
758 TARGET_BYTE_ORDER to be a variable. The user can use the `set
759 endian' command to change it. */
760#undef TARGET_BYTE_ORDER
761#define TARGET_BYTE_ORDER target_byte_order
762extern int target_byte_order;
750b7942
AC
763/* Nonzero when target_byte_order auto-detected */
764extern int target_byte_order_auto;
479f0f18
SG
765#endif
766
767extern void set_endian_from_file PARAMS ((bfd *));
768
d0aba53f
AC
769/* The target architecture can be set at run-time. */
770extern int target_architecture_auto;
771extern const bfd_arch_info_type *target_architecture;
772extern void set_architecture_from_file PARAMS ((bfd *));
773/* Notify target of a change to the selected architecture. Zero return
774 status indicates that the target did not like the change. */
775extern int (*target_architecture_hook) PARAMS ((const bfd_arch_info_type *ap));
7e9576e0 776extern void set_architecture_from_arch_mach PARAMS ((enum bfd_architecture arch, unsigned long mach));
d0aba53f 777
04f566a3
JK
778/* Number of bits in a char or unsigned char for the target machine.
779 Just like CHAR_BIT in <limits.h> but describes the target machine. */
780#if !defined (TARGET_CHAR_BIT)
781#define TARGET_CHAR_BIT 8
782#endif
783
784/* Number of bits in a short or unsigned short for the target machine. */
785#if !defined (TARGET_SHORT_BIT)
786#define TARGET_SHORT_BIT (2 * TARGET_CHAR_BIT)
787#endif
788
789/* Number of bits in an int or unsigned int for the target machine. */
790#if !defined (TARGET_INT_BIT)
791#define TARGET_INT_BIT (4 * TARGET_CHAR_BIT)
792#endif
793
794/* Number of bits in a long or unsigned long for the target machine. */
795#if !defined (TARGET_LONG_BIT)
796#define TARGET_LONG_BIT (4 * TARGET_CHAR_BIT)
797#endif
798
799/* Number of bits in a long long or unsigned long long for the target machine. */
800#if !defined (TARGET_LONG_LONG_BIT)
801#define TARGET_LONG_LONG_BIT (2 * TARGET_LONG_BIT)
802#endif
803
804/* Number of bits in a float for the target machine. */
805#if !defined (TARGET_FLOAT_BIT)
806#define TARGET_FLOAT_BIT (4 * TARGET_CHAR_BIT)
807#endif
808
809/* Number of bits in a double for the target machine. */
810#if !defined (TARGET_DOUBLE_BIT)
811#define TARGET_DOUBLE_BIT (8 * TARGET_CHAR_BIT)
812#endif
813
814/* Number of bits in a long double for the target machine. */
815#if !defined (TARGET_LONG_DOUBLE_BIT)
816#define TARGET_LONG_DOUBLE_BIT (2 * TARGET_DOUBLE_BIT)
817#endif
818
04f566a3
JK
819/* Number of bits in a pointer for the target machine */
820#if !defined (TARGET_PTR_BIT)
821#define TARGET_PTR_BIT TARGET_INT_BIT
822#endif
823
824/* If we picked up a copy of CHAR_BIT from a configuration file
825 (which may get it by including <limits.h>) then use it to set
826 the number of bits in a host char. If not, use the same size
827 as the target. */
828
829#if defined (CHAR_BIT)
830#define HOST_CHAR_BIT CHAR_BIT
831#else
832#define HOST_CHAR_BIT TARGET_CHAR_BIT
833#endif
834
7d9884b9
JG
835/* The bit byte-order has to do just with numbering of bits in
836 debugging symbols and such. Conceptually, it's quite separate
837 from byte/word byte order. */
838
839#if !defined (BITS_BIG_ENDIAN)
479f0f18
SG
840#ifndef TARGET_BYTE_ORDER_SELECTABLE
841
7d9884b9
JG
842#if TARGET_BYTE_ORDER == BIG_ENDIAN
843#define BITS_BIG_ENDIAN 1
844#endif /* Big endian. */
845
846#if TARGET_BYTE_ORDER == LITTLE_ENDIAN
847#define BITS_BIG_ENDIAN 0
848#endif /* Little endian. */
479f0f18
SG
849
850#else /* defined (TARGET_BYTE_ORDER_SELECTABLE) */
851
852#define BITS_BIG_ENDIAN (TARGET_BYTE_ORDER == BIG_ENDIAN)
853
854#endif /* defined (TARGET_BYTE_ORDER_SELECTABLE) */
7d9884b9
JG
855#endif /* BITS_BIG_ENDIAN not defined. */
856
e3c16900 857/* In findvar.c. */
e3c16900 858
6f54efdc
SS
859extern LONGEST extract_signed_integer PARAMS ((void *, int));
860
16a43bf4 861extern ULONGEST extract_unsigned_integer PARAMS ((void *, int));
6f54efdc 862
a243a22f
SG
863extern int extract_long_unsigned_integer PARAMS ((void *, int, LONGEST *));
864
6f54efdc
SS
865extern CORE_ADDR extract_address PARAMS ((void *, int));
866
867extern void store_signed_integer PARAMS ((void *, int, LONGEST));
868
16a43bf4 869extern void store_unsigned_integer PARAMS ((void *, int, ULONGEST));
6f54efdc
SS
870
871extern void store_address PARAMS ((void *, int, CORE_ADDR));
872
a243a22f
SG
873/* Setup definitions for host and target floating point formats. We need to
874 consider the format for `float', `double', and `long double' for both target
875 and host. We need to do this so that we know what kind of conversions need
876 to be done when converting target numbers to and from the hosts DOUBLEST
877 data type. */
878
879/* This is used to indicate that we don't know the format of the floating point
880 number. Typically, this is useful for native ports, where the actual format
881 is irrelevant, since no conversions will be taking place. */
882
883extern const struct floatformat floatformat_unknown;
884
885#if HOST_BYTE_ORDER == BIG_ENDIAN
886# ifndef HOST_FLOAT_FORMAT
887# define HOST_FLOAT_FORMAT &floatformat_ieee_single_big
888# endif
889# ifndef HOST_DOUBLE_FORMAT
890# define HOST_DOUBLE_FORMAT &floatformat_ieee_double_big
891# endif
892#else /* LITTLE_ENDIAN */
893# ifndef HOST_FLOAT_FORMAT
894# define HOST_FLOAT_FORMAT &floatformat_ieee_single_little
895# endif
896# ifndef HOST_DOUBLE_FORMAT
897# define HOST_DOUBLE_FORMAT &floatformat_ieee_double_little
898# endif
899#endif
900
901#ifndef HOST_LONG_DOUBLE_FORMAT
902#define HOST_LONG_DOUBLE_FORMAT &floatformat_unknown
903#endif
904
905#ifndef TARGET_BYTE_ORDER_SELECTABLE
906# if TARGET_BYTE_ORDER == BIG_ENDIAN
907# ifndef TARGET_FLOAT_FORMAT
908# define TARGET_FLOAT_FORMAT &floatformat_ieee_single_big
909# endif
910# ifndef TARGET_DOUBLE_FORMAT
911# define TARGET_DOUBLE_FORMAT &floatformat_ieee_double_big
912# endif
913# else /* LITTLE_ENDIAN */
914# ifndef TARGET_FLOAT_FORMAT
915# define TARGET_FLOAT_FORMAT &floatformat_ieee_single_little
916# endif
917# ifndef TARGET_DOUBLE_FORMAT
918# define TARGET_DOUBLE_FORMAT &floatformat_ieee_double_little
919# endif
920# endif
a243a22f
SG
921#else /* TARGET_BYTE_ORDER_SELECTABLE */
922# ifndef TARGET_FLOAT_FORMAT
c6fbd98b
SG
923# define TARGET_FLOAT_FORMAT (target_byte_order == BIG_ENDIAN \
924 ? &floatformat_ieee_single_big \
925 : &floatformat_ieee_single_little)
a243a22f
SG
926# endif
927# ifndef TARGET_DOUBLE_FORMAT
c6fbd98b
SG
928# define TARGET_DOUBLE_FORMAT (target_byte_order == BIG_ENDIAN \
929 ? &floatformat_ieee_double_big \
930 : &floatformat_ieee_double_little)
a243a22f
SG
931# endif
932#endif
933
c6fbd98b
SG
934#ifndef TARGET_LONG_DOUBLE_FORMAT
935# define TARGET_LONG_DOUBLE_FORMAT &floatformat_unknown
936#endif
937
a243a22f
SG
938/* Use `long double' if the host compiler supports it. (Note that this is not
939 necessarily any longer than `double'. On SunOS/gcc, it's the same as
940 double.) This is necessary because GDB internally converts all floating
941 point values to the widest type supported by the host.
942
943 There are problems however, when the target `long double' is longer than the
944 host's `long double'. In general, we'll probably reduce the precision of
945 any such values and print a warning. */
946
947#ifdef HAVE_LONG_DOUBLE
948typedef long double DOUBLEST;
a243a22f
SG
949#else
950typedef double DOUBLEST;
951#endif
952
91550191
SG
953extern void floatformat_to_doublest PARAMS ((const struct floatformat *,
954 char *, DOUBLEST *));
955extern void floatformat_from_doublest PARAMS ((const struct floatformat *,
956 DOUBLEST *, char *));
a243a22f 957extern DOUBLEST extract_floating PARAMS ((void *, int));
04f566a3 958
a243a22f 959extern void store_floating PARAMS ((void *, int, DOUBLEST));
e3c16900 960\f
7d9884b9
JG
961/* On some machines there are bits in addresses which are not really
962 part of the address, but are used by the kernel, the hardware, etc.
963 for special purposes. ADDR_BITS_REMOVE takes out any such bits
964 so we get a "real" address such as one would find in a symbol
04f566a3 965 table. This is used only for addresses of instructions, and even then
e3c16900
JK
966 I'm not sure it's used in all contexts. It exists to deal with there
967 being a few stray bits in the PC which would mislead us, not as some sort
04f566a3
JK
968 of generic thing to handle alignment or segmentation (it's possible it
969 should be in TARGET_READ_PC instead). */
7d9884b9
JG
970#if !defined (ADDR_BITS_REMOVE)
971#define ADDR_BITS_REMOVE(addr) (addr)
7d9884b9
JG
972#endif /* No ADDR_BITS_REMOVE. */
973
d747e0af
MT
974/* From valops.c */
975
6f54efdc 976extern CORE_ADDR push_bytes PARAMS ((CORE_ADDR, char *, int));
d747e0af 977
16a43bf4 978extern CORE_ADDR push_word PARAMS ((CORE_ADDR, ULONGEST));
d747e0af 979
0239d9b3
FF
980/* Some parts of gdb might be considered optional, in the sense that they
981 are not essential for being able to build a working, usable debugger
982 for a specific environment. For example, the maintenance commands
983 are there for the benefit of gdb maintainers. As another example,
984 some environments really don't need gdb's that are able to read N
985 different object file formats. In order to make it possible (but
986 not necessarily recommended) to build "stripped down" versions of
987 gdb, the following defines control selective compilation of those
988 parts of gdb which can be safely left out when necessary. Note that
989 the default is to include everything. */
990
991#ifndef MAINTENANCE_CMDS
992#define MAINTENANCE_CMDS 1
993#endif
994
45993f61
SC
995#ifdef MAINTENANCE_CMDS
996extern int watchdog;
997#endif
998
09722039
SG
999#include "dis-asm.h" /* Get defs for disassemble_info */
1000
18b46e7c
SS
1001extern int dis_asm_read_memory PARAMS ((bfd_vma memaddr, bfd_byte *myaddr,
1002 int len, disassemble_info *info));
1003
1004extern void dis_asm_memory_error PARAMS ((int status, bfd_vma memaddr,
1005 disassemble_info *info));
1006
1007extern void dis_asm_print_address PARAMS ((bfd_vma addr,
1008 disassemble_info *info));
1009
1010extern int (*tm_print_insn) PARAMS ((bfd_vma, disassemble_info*));
91550191 1011extern disassemble_info tm_print_insn_info;
18b46e7c
SS
1012
1013/* Hooks for alternate command interfaces. */
1014
09722039
SG
1015#ifdef __STDC__
1016struct target_waitstatus;
1017struct cmd_list_element;
1018#endif
1019
750b7942 1020extern void (*init_ui_hook) PARAMS ((char *argv0));
8164ec2e 1021extern void (*command_loop_hook) PARAMS ((void));
18b46e7c
SS
1022extern void (*fputs_unfiltered_hook) PARAMS ((const char *linebuffer,
1023 FILE *stream));
1024extern void (*print_frame_info_listing_hook) PARAMS ((struct symtab *s,
1025 int line, int stopline,
1026 int noerror));
91550191 1027extern int (*query_hook) PARAMS ((const char *, va_list));
8164ec2e
SG
1028extern void (*flush_hook) PARAMS ((FILE *stream));
1029extern void (*create_breakpoint_hook) PARAMS ((struct breakpoint *b));
1030extern void (*delete_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
326ae3e2 1031extern void (*modify_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
b6d70e15 1032extern void (*target_output_hook) PARAMS ((char *));
637b1661 1033extern void (*interactive_hook) PARAMS ((void));
16041d53 1034extern void (*registers_changed_hook) PARAMS ((void));
91550191
SG
1035extern void (*readline_begin_hook) PARAMS ((char *, ...));
1036extern char * (*readline_hook) PARAMS ((char *));
1037extern void (*readline_end_hook) PARAMS ((void));
479f0f18
SG
1038
1039extern int (*target_wait_hook) PARAMS ((int pid,
1040 struct target_waitstatus *status));
1041
1042extern void (*call_command_hook) PARAMS ((struct cmd_list_element *c,
1043 char *cmd, int from_tty));
1044
b607efe7 1045extern NORETURN void (*error_hook) PARAMS ((void)) ATTR_NORETURN;
45993f61
SC
1046
1047
1048
754e5da2
SG
1049/* Inhibit window interface if non-zero. */
1050
c5197511 1051extern int use_windows;
754e5da2 1052
45993f61
SC
1053/* Symbolic definitions of filename-related things. */
1054/* FIXME, this doesn't work very well if host and executable
1055 filesystems conventions are different. */
1056
1057#ifndef DIRNAME_SEPARATOR
1058#define DIRNAME_SEPARATOR ':'
1059#endif
1060
1061#ifndef SLASH_P
9e77e83d 1062#if defined(__GO32__)||defined(_WIN32)
b6d70e15
SC
1063#define SLASH_P(X) ((X)=='\\')
1064#else
45993f61
SC
1065#define SLASH_P(X) ((X)=='/')
1066#endif
b6d70e15 1067#endif
45993f61
SC
1068
1069#ifndef SLASH_CHAR
9e77e83d 1070#if defined(__GO32__)||defined(_WIN32)
b6d70e15
SC
1071#define SLASH_CHAR '\\'
1072#else
45993f61
SC
1073#define SLASH_CHAR '/'
1074#endif
b6d70e15 1075#endif
45993f61
SC
1076
1077#ifndef SLASH_STRING
9e77e83d 1078#if defined(__GO32__)||defined(_WIN32)
b6d70e15
SC
1079#define SLASH_STRING "\\"
1080#else
45993f61
SC
1081#define SLASH_STRING "/"
1082#endif
b6d70e15 1083#endif
45993f61
SC
1084
1085#ifndef ROOTED_P
1086#define ROOTED_P(X) (SLASH_P((X)[0]))
1087#endif
1088
16a43bf4
DP
1089/* On some systems, PIDGET is defined to extract the inferior pid from
1090 an internal pid that has the thread id and pid in seperate bit
1091 fields. If not defined, then just use the entire internal pid as
1092 the actual pid. */
1093
1094#ifndef PIDGET
1095#define PIDGET(pid) (pid)
1096#endif
1097
09722039 1098#endif /* #ifndef DEFS_H */
This page took 0.381597 seconds and 4 git commands to generate.