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