* readelf.c (dump_section): Don't print 32-bit values, which
[deliverable/binutils-gdb.git] / gdb / defs.h
... / ...
CommitLineData
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, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
4 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005
5 Free Software Foundation, Inc.
6
7 This file is part of GDB.
8
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
13
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
18
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 51 Franklin Street, Fifth Floor,
22 Boston, MA 02110-1301, USA. */
23
24#ifndef DEFS_H
25#define DEFS_H
26
27#include "config.h" /* Generated by configure. */
28
29#include <sys/types.h>
30#include <stdio.h>
31#include <errno.h> /* System call error return status. */
32#include <limits.h>
33
34#ifdef HAVE_STDDEF_H
35#include <stddef.h>
36#endif
37
38#ifdef HAVE_UNISTD_H
39#include <unistd.h>
40#endif
41
42#include <fcntl.h>
43
44/* First include ansidecl.h so we can use the various macro definitions
45 here and in all subsequent file inclusions. */
46
47#include "ansidecl.h"
48
49#include "gdb_locale.h"
50
51/* For ``enum target_signal''. */
52#include "gdb/signals.h"
53
54/* Just in case they're not defined in stdio.h. */
55
56#ifndef SEEK_SET
57#define SEEK_SET 0
58#endif
59#ifndef SEEK_CUR
60#define SEEK_CUR 1
61#endif
62
63/* The O_BINARY flag is defined in fcntl.h on some non-Posix platforms.
64 It is used as an access modifier in calls to open(), where it acts
65 similarly to the "b" character in fopen()'s MODE argument. On Posix
66 platforms it should be a no-op, so it is defined as 0 here. This
67 ensures that the symbol may be used freely elsewhere in gdb. */
68
69#ifndef O_BINARY
70#define O_BINARY 0
71#endif
72
73#include <stdarg.h> /* For va_list. */
74
75#include "libiberty.h"
76
77/* Rather than duplicate all the logic in BFD for figuring out what
78 types to use (which can be pretty complicated), symply define them
79 in terms of the corresponding type from BFD. */
80
81#include "bfd.h"
82
83/* A byte from the program being debugged. */
84typedef bfd_byte gdb_byte;
85
86/* An address in the program being debugged. Host byte order. */
87typedef bfd_vma CORE_ADDR;
88
89/* This is to make sure that LONGEST is at least as big as CORE_ADDR. */
90
91#ifndef LONGEST
92
93#ifdef BFD64
94
95#define LONGEST BFD_HOST_64_BIT
96#define ULONGEST BFD_HOST_U_64_BIT
97
98#else /* No BFD64 */
99
100#ifdef CC_HAS_LONG_LONG
101#define LONGEST long long
102#define ULONGEST unsigned long long
103#else
104#ifdef BFD_HOST_64_BIT
105/* BFD_HOST_64_BIT is defined for some hosts that don't have long long
106 (e.g. i386-windows) so try it. */
107#define LONGEST BFD_HOST_64_BIT
108#define ULONGEST BFD_HOST_U_64_BIT
109#else
110#define LONGEST long
111#define ULONGEST unsigned long
112#endif
113#endif
114
115#endif /* No BFD64 */
116
117#endif /* ! LONGEST */
118
119#ifndef min
120#define min(a, b) ((a) < (b) ? (a) : (b))
121#endif
122#ifndef max
123#define max(a, b) ((a) > (b) ? (a) : (b))
124#endif
125
126/* Macros to do string compares.
127
128 NOTE: cagney/2000-03-14:
129
130 While old code can continue to refer to these macros, new code is
131 probably better off using strcmp() directly vis: ``strcmp() == 0''
132 and ``strcmp() != 0''.
133
134 This is because modern compilers can directly inline strcmp()
135 making the original justification for these macros - avoid function
136 call overhead by pre-testing the first characters
137 (``*X==*Y?...:0'') - redundant.
138
139 ``Even if [...] testing the first character does have a modest
140 performance improvement, I'd rather that whenever a performance
141 issue is found that we spend the effort on algorithmic
142 optimizations than micro-optimizing.'' J.T. */
143
144/* NOTE: cagney/2003-11-23: All instances of STREQ[N] covered by
145 testing GDB on a stabs system have been replaced by equivalent
146 str[n]cmp calls. To avoid the possability of introducing bugs when
147 making untested changes, the remaining references were deprecated
148 rather than replaced. */
149
150/* DISCLAIMER: cagney/2003-11-23: Simplified definition of these
151 macros so that they just map directly onto strcmp equivalent. I'm
152 not responsible for any breakage due to code that relied on the old
153 underlying implementation. */
154
155#define DEPRECATED_STREQ(a,b) (strcmp ((a), (b)) == 0)
156#define DEPRECATED_STREQN(a,b,c) (strncmp ((a), (b), (c)) == 0)
157
158/* Check if a character is one of the commonly used C++ marker characters. */
159extern int is_cplus_marker (int);
160
161/* enable xdb commands if set */
162extern int xdb_commands;
163
164/* enable dbx commands if set */
165extern int dbx_commands;
166
167/* System root path, used to find libraries etc. */
168extern char *gdb_sysroot;
169
170extern int quit_flag;
171extern int immediate_quit;
172extern int sevenbit_strings;
173
174extern void quit (void);
175
176/* FIXME: cagney/2000-03-13: It has been suggested that the peformance
177 benefits of having a ``QUIT'' macro rather than a function are
178 marginal. If the overhead of a QUIT function call is proving
179 significant then its calling frequency should probably be reduced
180 [kingdon]. A profile analyzing the current situtation is
181 needed. */
182
183#ifdef QUIT
184/* do twice to force compiler warning */
185#define QUIT_FIXME "FIXME"
186#define QUIT_FIXME "ignoring redefinition of QUIT"
187#else
188#define QUIT { \
189 if (quit_flag) quit (); \
190 if (deprecated_interactive_hook) deprecated_interactive_hook (); \
191}
192#endif
193
194/* Languages represented in the symbol table and elsewhere.
195 This should probably be in language.h, but since enum's can't
196 be forward declared to satisfy opaque references before their
197 actual definition, needs to be here. */
198
199enum language
200 {
201 language_unknown, /* Language not known */
202 language_auto, /* Placeholder for automatic setting */
203 language_c, /* C */
204 language_cplus, /* C++ */
205 language_objc, /* Objective-C */
206 language_java, /* Java */
207 language_fortran, /* Fortran */
208 language_m2, /* Modula-2 */
209 language_asm, /* Assembly language */
210 language_scm, /* Scheme / Guile */
211 language_pascal, /* Pascal */
212 language_ada, /* Ada */
213 language_minimal, /* All other languages, minimal support only */
214 nr_languages
215 };
216
217enum precision_type
218 {
219 single_precision,
220 double_precision,
221 unspecified_precision
222 };
223
224/* A generic, not quite boolean, enumeration. */
225enum auto_boolean
226{
227 AUTO_BOOLEAN_TRUE,
228 AUTO_BOOLEAN_FALSE,
229 AUTO_BOOLEAN_AUTO
230};
231
232/* Potential ways that a function can return a value of a given type. */
233enum return_value_convention
234{
235 /* Where the return value has been squeezed into one or more
236 registers. */
237 RETURN_VALUE_REGISTER_CONVENTION,
238 /* Commonly known as the "struct return convention". The caller
239 passes an additional hidden first parameter to the caller. That
240 parameter contains the address at which the value being returned
241 should be stored. While typically, and historically, used for
242 large structs, this is convention is applied to values of many
243 different types. */
244 RETURN_VALUE_STRUCT_CONVENTION,
245 /* Like the "struct return convention" above, but where the ABI
246 guarantees that the called function stores the address at which
247 the value being returned is stored in a well-defined location,
248 such as a register or memory slot in the stack frame. Don't use
249 this if the ABI doesn't explicitly guarantees this. */
250 RETURN_VALUE_ABI_RETURNS_ADDRESS,
251 /* Like the "struct return convention" above, but where the ABI
252 guarantees that the address at which the value being returned is
253 stored will be available in a well-defined location, such as a
254 register or memory slot in the stack frame. Don't use this if
255 the ABI doesn't explicitly guarantees this. */
256 RETURN_VALUE_ABI_PRESERVES_ADDRESS,
257};
258
259/* the cleanup list records things that have to be undone
260 if an error happens (descriptors to be closed, memory to be freed, etc.)
261 Each link in the chain records a function to call and an
262 argument to give it.
263
264 Use make_cleanup to add an element to the cleanup chain.
265 Use do_cleanups to do all cleanup actions back to a given
266 point in the chain. Use discard_cleanups to remove cleanups
267 from the chain back to a given point, not doing them. */
268
269struct cleanup
270 {
271 struct cleanup *next;
272 void (*function) (void *);
273 void *arg;
274 };
275
276
277/* The ability to declare that a function never returns is useful, but
278 not really required to compile GDB successfully, so the NORETURN and
279 ATTR_NORETURN macros normally expand into nothing. */
280
281/* If compiling with older versions of GCC, a function may be declared
282 "volatile" to indicate that it does not return. */
283
284#ifndef NORETURN
285#if defined(__GNUC__) \
286 && (__GNUC__ == 1 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7))
287#define NORETURN volatile
288#else
289#define NORETURN /* nothing */
290#endif
291#endif
292
293/* GCC 2.5 and later versions define a function attribute "noreturn",
294 which is the preferred way to declare that a function never returns.
295 However GCC 2.7 appears to be the first version in which this fully
296 works everywhere we use it. */
297
298#ifndef ATTR_NORETURN
299#if defined(__GNUC__) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7))
300#define ATTR_NORETURN __attribute__ ((noreturn))
301#else
302#define ATTR_NORETURN /* nothing */
303#endif
304#endif
305
306#ifndef ATTR_FORMAT
307#if defined(__GNUC__) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4))
308#define ATTR_FORMAT(type, x, y) __attribute__ ((format(type, x, y)))
309#else
310#define ATTR_FORMAT(type, x, y) /* nothing */
311#endif
312#endif
313
314/* Be conservative and use enum bitfields only with GCC.
315 This is copied from gcc 3.3.1, system.h. */
316
317#if defined(__GNUC__) && (__GNUC__ >= 2)
318#define ENUM_BITFIELD(TYPE) enum TYPE
319#else
320#define ENUM_BITFIELD(TYPE) unsigned int
321#endif
322
323/* Needed for various prototypes */
324
325struct symtab;
326struct breakpoint;
327struct frame_info;
328
329/* From utils.c */
330
331extern void initialize_utils (void);
332
333extern void notice_quit (void);
334
335extern int strcmp_iw (const char *, const char *);
336
337extern int strcmp_iw_ordered (const char *, const char *);
338
339extern int streq (const char *, const char *);
340
341extern int subset_compare (char *, char *);
342
343extern char *safe_strerror (int);
344
345extern void request_quit (int);
346
347#define ALL_CLEANUPS ((struct cleanup *)0)
348
349extern void do_cleanups (struct cleanup *);
350extern void do_final_cleanups (struct cleanup *);
351extern void do_run_cleanups (struct cleanup *);
352extern void do_exec_cleanups (struct cleanup *);
353extern void do_exec_error_cleanups (struct cleanup *);
354
355extern void discard_cleanups (struct cleanup *);
356extern void discard_final_cleanups (struct cleanup *);
357extern void discard_exec_error_cleanups (struct cleanup *);
358extern void discard_my_cleanups (struct cleanup **, struct cleanup *);
359
360/* NOTE: cagney/2000-03-04: This typedef is strictly for the
361 make_cleanup function declarations below. Do not use this typedef
362 as a cast when passing functions into the make_cleanup() code.
363 Instead either use a bounce function or add a wrapper function.
364 Calling a f(char*) function with f(void*) is non-portable. */
365typedef void (make_cleanup_ftype) (void *);
366
367extern struct cleanup *make_cleanup (make_cleanup_ftype *, void *);
368
369extern struct cleanup *make_cleanup_freeargv (char **);
370
371struct ui_file;
372extern struct cleanup *make_cleanup_ui_file_delete (struct ui_file *);
373
374struct section_addr_info;
375extern struct cleanup *(make_cleanup_free_section_addr_info
376 (struct section_addr_info *));
377
378extern struct cleanup *make_cleanup_close (int fd);
379
380extern struct cleanup *make_cleanup_bfd_close (bfd *abfd);
381
382extern struct cleanup *make_final_cleanup (make_cleanup_ftype *, void *);
383
384extern struct cleanup *make_my_cleanup (struct cleanup **,
385 make_cleanup_ftype *, void *);
386
387extern struct cleanup *make_run_cleanup (make_cleanup_ftype *, void *);
388
389extern struct cleanup *make_exec_cleanup (make_cleanup_ftype *, void *);
390extern struct cleanup *make_exec_error_cleanup (make_cleanup_ftype *, void *);
391
392extern struct cleanup *save_cleanups (void);
393extern struct cleanup *save_final_cleanups (void);
394extern struct cleanup *save_my_cleanups (struct cleanup **);
395
396extern void restore_cleanups (struct cleanup *);
397extern void restore_final_cleanups (struct cleanup *);
398extern void restore_my_cleanups (struct cleanup **, struct cleanup *);
399
400extern void free_current_contents (void *);
401
402extern void null_cleanup (void *);
403
404extern int myread (int, char *, int);
405
406extern int query (const char *, ...) ATTR_FORMAT (printf, 1, 2);
407extern int nquery (const char *, ...) ATTR_FORMAT (printf, 1, 2);
408extern int yquery (const char *, ...) ATTR_FORMAT (printf, 1, 2);
409
410extern void init_page_info (void);
411
412extern char *gdb_realpath (const char *);
413extern char *xfullpath (const char *);
414
415extern unsigned long gnu_debuglink_crc32 (unsigned long crc,
416 unsigned char *buf, size_t len);
417
418ULONGEST strtoulst (const char *num, const char **trailer, int base);
419
420/* From demangle.c */
421
422extern void set_demangling_style (char *);
423
424/* From tm.h */
425
426struct type;
427typedef int (use_struct_convention_fn) (int gcc_p, struct type * value_type);
428extern use_struct_convention_fn generic_use_struct_convention;
429
430\f
431/* Annotation stuff. */
432
433extern int annotation_level; /* in stack.c */
434\f
435extern void begin_line (void);
436
437extern void wrap_here (char *);
438
439extern void reinitialize_more_filter (void);
440
441/* Normal results */
442extern struct ui_file *gdb_stdout;
443/* Input stream */
444extern struct ui_file *gdb_stdin;
445/* Serious error notifications */
446extern struct ui_file *gdb_stderr;
447/* Log/debug/trace messages that should bypass normal stdout/stderr
448 filtering. For moment, always call this stream using
449 *_unfiltered. In the very near future that restriction shall be
450 removed - either call shall be unfiltered. (cagney 1999-06-13). */
451extern struct ui_file *gdb_stdlog;
452/* Target output that should bypass normal stdout/stderr filtering.
453 For moment, always call this stream using *_unfiltered. In the
454 very near future that restriction shall be removed - either call
455 shall be unfiltered. (cagney 1999-07-02). */
456extern struct ui_file *gdb_stdtarg;
457extern struct ui_file *gdb_stdtargerr;
458extern struct ui_file *gdb_stdtargin;
459
460#include "ui-file.h"
461
462/* More generic printf like operations. Filtered versions may return
463 non-locally on error. */
464
465extern void fputs_filtered (const char *, struct ui_file *);
466
467extern void fputs_unfiltered (const char *, struct ui_file *);
468
469extern int fputc_filtered (int c, struct ui_file *);
470
471extern int fputc_unfiltered (int c, struct ui_file *);
472
473extern int putchar_filtered (int c);
474
475extern int putchar_unfiltered (int c);
476
477extern void puts_filtered (const char *);
478
479extern void puts_unfiltered (const char *);
480
481extern void puts_filtered_tabular (char *string, int width, int right);
482
483extern void puts_debug (char *prefix, char *string, char *suffix);
484
485extern void vprintf_filtered (const char *, va_list) ATTR_FORMAT (printf, 1, 0);
486
487extern void vfprintf_filtered (struct ui_file *, const char *, va_list) ATTR_FORMAT (printf, 2, 0);
488
489extern void fprintf_filtered (struct ui_file *, const char *, ...) ATTR_FORMAT (printf, 2, 3);
490
491extern void fprintfi_filtered (int, struct ui_file *, const char *, ...) ATTR_FORMAT (printf, 3, 4);
492
493extern void printf_filtered (const char *, ...) ATTR_FORMAT (printf, 1, 2);
494
495extern void printfi_filtered (int, const char *, ...) ATTR_FORMAT (printf, 2, 3);
496
497extern void vprintf_unfiltered (const char *, va_list) ATTR_FORMAT (printf, 1, 0);
498
499extern void vfprintf_unfiltered (struct ui_file *, const char *, va_list) ATTR_FORMAT (printf, 2, 0);
500
501extern void fprintf_unfiltered (struct ui_file *, const char *, ...) ATTR_FORMAT (printf, 2, 3);
502
503extern void printf_unfiltered (const char *, ...) ATTR_FORMAT (printf, 1, 2);
504
505extern void print_spaces (int, struct ui_file *);
506
507extern void print_spaces_filtered (int, struct ui_file *);
508
509extern char *n_spaces (int);
510
511extern void fputstr_filtered (const char *str, int quotr, struct ui_file * stream);
512
513extern void fputstr_unfiltered (const char *str, int quotr, struct ui_file * stream);
514
515extern void fputstrn_filtered (const char *str, int n, int quotr, struct ui_file * stream);
516
517extern void fputstrn_unfiltered (const char *str, int n, int quotr, struct ui_file * stream);
518
519/* Display the host ADDR on STREAM formatted as ``0x%x''. */
520extern void gdb_print_host_address (const void *addr, struct ui_file *stream);
521
522/* Convert a CORE_ADDR into a HEX string. paddr() is like %08lx.
523 paddr_nz() is like %lx. paddr_u() is like %lu. paddr_width() is
524 for ``%*''. */
525extern int strlen_paddr (void);
526extern char *paddr (CORE_ADDR addr);
527extern char *paddr_nz (CORE_ADDR addr);
528extern char *paddr_u (CORE_ADDR addr);
529extern char *paddr_d (LONGEST addr);
530
531/* Like 0x%lx, replaces deprecated_print_address_numeric. */
532extern const char *paddress (CORE_ADDR addr);
533
534extern char *phex (ULONGEST l, int sizeof_l);
535extern char *phex_nz (ULONGEST l, int sizeof_l);
536extern char *int_string (LONGEST, int, int, int, int);
537
538/* Like paddr() only print/scan raw CORE_ADDR. The output from
539 core_addr_to_string() can be passed direct to
540 string_to_core_addr(). */
541extern const char *core_addr_to_string (const CORE_ADDR addr);
542extern const char *core_addr_to_string_nz (const CORE_ADDR addr);
543extern CORE_ADDR string_to_core_addr (const char *my_string);
544
545/* Return a string that contains a number formatted as a hex
546 string. */
547extern char *hex_string (LONGEST);
548extern char *hex_string_custom (LONGEST, int);
549
550extern void fprintf_symbol_filtered (struct ui_file *, char *,
551 enum language, int);
552
553extern NORETURN void perror_with_name (const char *) ATTR_NORETURN;
554
555extern void print_sys_errmsg (const char *, int);
556
557/* From regex.c or libc. BSD 4.4 declares this with the argument type as
558 "const char *" in unistd.h, so we can't declare the argument
559 as "char *". */
560
561extern char *re_comp (const char *);
562
563/* From symfile.c */
564
565extern void symbol_file_command (char *, int);
566
567/* Remote targets may wish to use this as their load function. */
568extern void generic_load (char *name, int from_tty);
569
570/* Report on STREAM the performance of memory transfer operation,
571 such as 'load'.
572 DATA_COUNT is the number of bytes transferred.
573 WRITE_COUNT is the number of separate write operations, or 0,
574 if that information is not available.
575 START_TIME is the time at which an operation was started.
576 END_TIME is the time at which an operation ended. */
577struct timeval;
578extern void print_transfer_performance (struct ui_file *stream,
579 unsigned long data_count,
580 unsigned long write_count,
581 const struct timeval *start_time,
582 const struct timeval *end_time);
583
584/* From top.c */
585
586typedef void initialize_file_ftype (void);
587
588extern char *skip_quoted (char *);
589
590extern char *gdb_readline (char *);
591
592extern char *gdb_readline_wrapper (char *);
593
594extern char *command_line_input (char *, int, char *);
595
596extern void print_prompt (void);
597
598extern int input_from_terminal_p (void);
599
600extern int info_verbose;
601
602/* From printcmd.c */
603
604extern void set_next_address (CORE_ADDR);
605
606extern void print_address_symbolic (CORE_ADDR, struct ui_file *, int,
607 char *);
608
609extern int build_address_symbolic (CORE_ADDR addr,
610 int do_demangle,
611 char **name,
612 int *offset,
613 char **filename,
614 int *line,
615 int *unmapped);
616
617extern void deprecated_print_address_numeric (CORE_ADDR, int, struct ui_file *);
618
619extern void print_address (CORE_ADDR, struct ui_file *);
620
621/* From source.c */
622
623#define OPF_TRY_CWD_FIRST 0x01
624#define OPF_SEARCH_IN_PATH 0x02
625
626extern int openp (const char *, int, const char *, int, int, char **);
627
628extern int source_full_path_of (char *, char **);
629
630extern void mod_path (char *, char **);
631
632extern void add_path (char *, char **, int);
633
634extern void directory_command (char *, int);
635
636extern void directory_switch (char *, int);
637
638extern char *source_path;
639
640extern void init_source_path (void);
641
642extern void init_last_source_visited (void);
643
644/* From exec.c */
645
646extern void exec_set_section_offsets (bfd_signed_vma text_off,
647 bfd_signed_vma data_off,
648 bfd_signed_vma bss_off);
649
650/* Take over the 'find_mapped_memory' vector from exec.c. */
651extern void exec_set_find_memory_regions (int (*) (int (*) (CORE_ADDR,
652 unsigned long,
653 int, int, int,
654 void *),
655 void *));
656
657/* Possible lvalue types. Like enum language, this should be in
658 value.h, but needs to be here for the same reason. */
659
660enum lval_type
661 {
662 /* Not an lval. */
663 not_lval,
664 /* In memory. */
665 lval_memory,
666 /* In a register. Registers are relative to a frame. */
667 lval_register,
668 /* In a gdb internal variable. */
669 lval_internalvar,
670 /* Part of a gdb internal variable (structure field). */
671 lval_internalvar_component
672 };
673
674/* Control types for commands */
675
676enum misc_command_type
677 {
678 ok_command,
679 end_command,
680 else_command,
681 nop_command
682 };
683
684enum command_control_type
685 {
686 simple_control,
687 break_control,
688 continue_control,
689 while_control,
690 if_control,
691 invalid_control
692 };
693
694/* Structure for saved commands lines
695 (for breakpoints, defined commands, etc). */
696
697struct command_line
698 {
699 struct command_line *next;
700 char *line;
701 enum command_control_type control_type;
702 int body_count;
703 struct command_line **body_list;
704 };
705
706extern struct command_line *read_command_lines (char *, int);
707
708extern void free_command_lines (struct command_line **);
709
710/* To continue the execution commands when running gdb asynchronously.
711 A continuation structure contains a pointer to a function to be called
712 to finish the command, once the target has stopped. Such mechanism is
713 used bt the finish and until commands, and in the remote protocol
714 when opening an extended-remote connection. */
715
716struct continuation_arg
717 {
718 struct continuation_arg *next;
719 union continuation_data {
720 void *pointer;
721 int integer;
722 long longint;
723 } data;
724 };
725
726struct continuation
727 {
728 void (*continuation_hook) (struct continuation_arg *);
729 struct continuation_arg *arg_list;
730 struct continuation *next;
731 };
732
733/* In infrun.c. */
734extern struct continuation *cmd_continuation;
735/* Used only by the step_1 function. */
736extern struct continuation *intermediate_continuation;
737
738/* From utils.c */
739extern void add_continuation (void (*)(struct continuation_arg *),
740 struct continuation_arg *);
741extern void do_all_continuations (void);
742extern void discard_all_continuations (void);
743
744extern void add_intermediate_continuation (void (*)(struct continuation_arg *),
745 struct continuation_arg *);
746extern void do_all_intermediate_continuations (void);
747extern void discard_all_intermediate_continuations (void);
748
749/* String containing the current directory (what getwd would return). */
750
751extern char *current_directory;
752
753/* Default radixes for input and output. Only some values supported. */
754extern unsigned input_radix;
755extern unsigned output_radix;
756
757/* Possibilities for prettyprint parameters to routines which print
758 things. Like enum language, this should be in value.h, but needs
759 to be here for the same reason. FIXME: If we can eliminate this
760 as an arg to LA_VAL_PRINT, then we can probably move it back to
761 value.h. */
762
763enum val_prettyprint
764 {
765 Val_no_prettyprint = 0,
766 Val_prettyprint,
767 /* Use the default setting which the user has specified. */
768 Val_pretty_default
769 };
770
771/* The ptid struct is a collection of the various "ids" necessary
772 for identifying the inferior. This consists of the process id
773 (pid), thread id (tid), and other fields necessary for uniquely
774 identifying the inferior process/thread being debugged. When
775 manipulating ptids, the constructors, accessors, and predicate
776 declared in inferior.h should be used. These are as follows:
777
778 ptid_build - Make a new ptid from a pid, lwp, and tid.
779 pid_to_ptid - Make a new ptid from just a pid.
780 ptid_get_pid - Fetch the pid component of a ptid.
781 ptid_get_lwp - Fetch the lwp component of a ptid.
782 ptid_get_tid - Fetch the tid component of a ptid.
783 ptid_equal - Test to see if two ptids are equal.
784
785 Please do NOT access the struct ptid members directly (except, of
786 course, in the implementation of the above ptid manipulation
787 functions). */
788
789struct ptid
790 {
791 /* Process id */
792 int pid;
793
794 /* Lightweight process id */
795 long lwp;
796
797 /* Thread id */
798 long tid;
799 };
800
801typedef struct ptid ptid_t;
802
803\f
804
805/* Optional host machine definition. Pure autoconf targets will not
806 need a "xm.h" file. This will be a symlink to one of the xm-*.h
807 files, built by the `configure' script. */
808
809#ifdef GDB_XM_FILE
810#include "xm.h"
811#endif
812
813/* Optional native machine support. Non-native (and possibly pure
814 multi-arch) targets do not need a "nm.h" file. This will be a
815 symlink to one of the nm-*.h files, built by the `configure'
816 script. */
817
818#ifdef GDB_NM_FILE
819#include "nm.h"
820#endif
821
822/* Optional target machine definition. Pure multi-arch configurations
823 do not need a "tm.h" file. This will be a symlink to one of the
824 tm-*.h files, built by the `configure' script. */
825
826#ifdef GDB_TM_FILE
827#include "tm.h"
828#endif
829
830/* Assume that fopen accepts the letter "b" in the mode string.
831 It is demanded by ISO C9X, and should be supported on all
832 platforms that claim to have a standard-conforming C library. On
833 true POSIX systems it will be ignored and have no effect. There
834 may still be systems without a standard-conforming C library where
835 an ISO C9X compiler (GCC) is available. Known examples are SunOS
836 4.x and 4.3BSD. This assumption means these systems are no longer
837 supported. */
838#ifndef FOPEN_RB
839# include "fopen-bin.h"
840#endif
841
842/* Defaults for system-wide constants (if not defined by xm.h, we fake it).
843 FIXME: Assumes 2's complement arithmetic */
844
845#if !defined (UINT_MAX)
846#define UINT_MAX ((unsigned int)(~0)) /* 0xFFFFFFFF for 32-bits */
847#endif
848
849#if !defined (INT_MAX)
850#define INT_MAX ((int)(UINT_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */
851#endif
852
853#if !defined (INT_MIN)
854#define INT_MIN ((int)((int) ~0 ^ INT_MAX)) /* 0x80000000 for 32-bits */
855#endif
856
857#if !defined (ULONG_MAX)
858#define ULONG_MAX ((unsigned long)(~0L)) /* 0xFFFFFFFF for 32-bits */
859#endif
860
861#if !defined (LONG_MAX)
862#define LONG_MAX ((long)(ULONG_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */
863#endif
864
865#if !defined (ULONGEST_MAX)
866#define ULONGEST_MAX (~(ULONGEST)0) /* 0xFFFFFFFFFFFFFFFF for 64-bits */
867#endif
868
869#if !defined (LONGEST_MAX) /* 0x7FFFFFFFFFFFFFFF for 64-bits */
870#define LONGEST_MAX ((LONGEST)(ULONGEST_MAX >> 1))
871#endif
872
873/* Convert a LONGEST to an int. This is used in contexts (e.g. number of
874 arguments to a function, number in a value history, register number, etc.)
875 where the value must not be larger than can fit in an int. */
876
877extern int longest_to_int (LONGEST);
878
879/* Assorted functions we can declare, now that const and volatile are
880 defined. */
881
882extern char *savestring (const char *, size_t);
883
884/* xmalloc(), xrealloc() and xcalloc() have already been declared in
885 "libiberty.h". */
886extern void xfree (void *);
887
888/* Like xmalloc, but zero the memory. */
889extern void *xzalloc (size_t);
890
891/* Utility macros to allocate typed memory. Avoids errors like:
892 struct foo *foo = xmalloc (sizeof struct bar); and memset (foo,
893 sizeof (struct foo), 0). */
894#define XZALLOC(TYPE) ((TYPE*) xzalloc (sizeof (TYPE)))
895#define XMALLOC(TYPE) ((TYPE*) xmalloc (sizeof (TYPE)))
896#define XCALLOC(NMEMB, TYPE) ((TYPE*) xcalloc ((NMEMB), sizeof (TYPE)))
897
898/* Like asprintf/vasprintf but get an internal_error if the call
899 fails. */
900extern void xasprintf (char **ret, const char *format, ...) ATTR_FORMAT (printf, 2, 3);
901extern void xvasprintf (char **ret, const char *format, va_list ap)
902 ATTR_FORMAT (printf, 2, 0);
903
904/* Like asprintf and vasprintf, but return the string, throw an error
905 if no memory. */
906extern char *xstrprintf (const char *format, ...) ATTR_FORMAT (printf, 1, 2);
907extern char *xstrvprintf (const char *format, va_list ap)
908 ATTR_FORMAT (printf, 1, 0);
909
910/* Like snprintf, but throw an error if the output buffer is too small. */
911extern int xsnprintf (char *str, size_t size, const char *format, ...)
912 ATTR_FORMAT (printf, 3, 4);
913
914extern int parse_escape (char **);
915
916/* Message to be printed before the error message, when an error occurs. */
917
918extern char *error_pre_print;
919
920/* Message to be printed before the error message, when an error occurs. */
921
922extern char *quit_pre_print;
923
924/* Message to be printed before the warning message, when a warning occurs. */
925
926extern char *warning_pre_print;
927
928extern NORETURN void verror (const char *fmt, va_list ap)
929 ATTR_NORETURN ATTR_FORMAT (printf, 1, 0);
930
931extern NORETURN void error (const char *fmt, ...) ATTR_NORETURN ATTR_FORMAT (printf, 1, 2);
932
933extern NORETURN void error_stream (struct ui_file *) ATTR_NORETURN;
934
935extern NORETURN void vfatal (const char *fmt, va_list ap)
936 ATTR_NORETURN ATTR_FORMAT (printf, 1, 0);
937
938extern NORETURN void fatal (const char *fmt, ...) ATTR_NORETURN ATTR_FORMAT (printf, 1, 2);
939
940extern NORETURN void internal_verror (const char *file, int line,
941 const char *, va_list ap)
942 ATTR_NORETURN ATTR_FORMAT (printf, 3, 0);
943
944extern NORETURN void internal_error (const char *file, int line,
945 const char *, ...) ATTR_NORETURN ATTR_FORMAT (printf, 3, 4);
946
947extern void internal_vwarning (const char *file, int line,
948 const char *, va_list ap)
949 ATTR_FORMAT (printf, 3, 0);
950
951extern void internal_warning (const char *file, int line,
952 const char *, ...) ATTR_FORMAT (printf, 3, 4);
953
954extern NORETURN void nomem (long) ATTR_NORETURN;
955
956extern void warning (const char *, ...) ATTR_FORMAT (printf, 1, 2);
957
958extern void vwarning (const char *, va_list args) ATTR_FORMAT (printf, 1, 0);
959
960/* List of known OS ABIs. If you change this, make sure to update the
961 table in osabi.c. */
962enum gdb_osabi
963{
964 GDB_OSABI_UNINITIALIZED = -1, /* For struct gdbarch_info. */
965
966 GDB_OSABI_UNKNOWN = 0, /* keep this zero */
967
968 GDB_OSABI_SVR4,
969 GDB_OSABI_HURD,
970 GDB_OSABI_SOLARIS,
971 GDB_OSABI_OSF1,
972 GDB_OSABI_LINUX,
973 GDB_OSABI_FREEBSD_AOUT,
974 GDB_OSABI_FREEBSD_ELF,
975 GDB_OSABI_NETBSD_AOUT,
976 GDB_OSABI_NETBSD_ELF,
977 GDB_OSABI_OPENBSD_ELF,
978 GDB_OSABI_WINCE,
979 GDB_OSABI_GO32,
980 GDB_OSABI_NETWARE,
981 GDB_OSABI_IRIX,
982 GDB_OSABI_LYNXOS,
983 GDB_OSABI_INTERIX,
984 GDB_OSABI_HPUX_ELF,
985 GDB_OSABI_HPUX_SOM,
986
987 GDB_OSABI_QNXNTO,
988
989 GDB_OSABI_CYGWIN,
990 GDB_OSABI_AIX,
991
992 GDB_OSABI_INVALID /* keep this last */
993};
994
995/* Global functions from other, non-gdb GNU thingies.
996 Libiberty thingies are no longer declared here. We include libiberty.h
997 above, instead. */
998
999/* From other system libraries */
1000
1001#ifdef HAVE_STDDEF_H
1002#include <stddef.h>
1003#endif
1004
1005#ifdef HAVE_STDLIB_H
1006#include <stdlib.h>
1007#endif
1008#ifndef min
1009#define min(a, b) ((a) < (b) ? (a) : (b))
1010#endif
1011#ifndef max
1012#define max(a, b) ((a) > (b) ? (a) : (b))
1013#endif
1014
1015
1016#ifndef atof
1017extern double atof (const char *); /* X3.159-1989 4.10.1.1 */
1018#endif
1019
1020/* Various possibilities for alloca. */
1021#ifndef alloca
1022#ifdef __GNUC__
1023#define alloca __builtin_alloca
1024#else /* Not GNU C */
1025#ifdef HAVE_ALLOCA_H
1026#include <alloca.h>
1027#else
1028#ifdef _AIX
1029#pragma alloca
1030#else
1031
1032/* We need to be careful not to declare this in a way which conflicts with
1033 bison. Bison never declares it as char *, but under various circumstances
1034 (like __hpux) we need to use void *. */
1035extern void *alloca ();
1036#endif /* Not _AIX */
1037#endif /* Not HAVE_ALLOCA_H */
1038#endif /* Not GNU C */
1039#endif /* alloca not defined */
1040
1041/* Dynamic target-system-dependent parameters for GDB. */
1042#include "gdbarch.h"
1043
1044/* Maximum size of a register. Something small, but large enough for
1045 all known ISAs. If it turns out to be too small, make it bigger. */
1046
1047enum { MAX_REGISTER_SIZE = 16 };
1048
1049/* Static target-system-dependent parameters for GDB. */
1050
1051/* Number of bits in a char or unsigned char for the target machine.
1052 Just like CHAR_BIT in <limits.h> but describes the target machine. */
1053#if !defined (TARGET_CHAR_BIT)
1054#define TARGET_CHAR_BIT 8
1055#endif
1056
1057/* If we picked up a copy of CHAR_BIT from a configuration file
1058 (which may get it by including <limits.h>) then use it to set
1059 the number of bits in a host char. If not, use the same size
1060 as the target. */
1061
1062#if defined (CHAR_BIT)
1063#define HOST_CHAR_BIT CHAR_BIT
1064#else
1065#define HOST_CHAR_BIT TARGET_CHAR_BIT
1066#endif
1067
1068/* The bit byte-order has to do just with numbering of bits in
1069 debugging symbols and such. Conceptually, it's quite separate
1070 from byte/word byte order. */
1071
1072#if !defined (BITS_BIG_ENDIAN)
1073#define BITS_BIG_ENDIAN (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG)
1074#endif
1075
1076/* In findvar.c. */
1077
1078extern LONGEST extract_signed_integer (const gdb_byte *, int);
1079
1080extern ULONGEST extract_unsigned_integer (const gdb_byte *, int);
1081
1082extern int extract_long_unsigned_integer (const gdb_byte *, int, LONGEST *);
1083
1084extern CORE_ADDR extract_typed_address (const gdb_byte *buf,
1085 struct type *type);
1086
1087extern void store_signed_integer (gdb_byte *, int, LONGEST);
1088
1089extern void store_unsigned_integer (gdb_byte *, int, ULONGEST);
1090
1091extern void store_typed_address (gdb_byte *buf, struct type *type,
1092 CORE_ADDR addr);
1093
1094\f
1095/* From valops.c */
1096
1097extern int watchdog;
1098
1099/* Hooks for alternate command interfaces. */
1100
1101/* The name of the interpreter if specified on the command line. */
1102extern char *interpreter_p;
1103
1104/* If a given interpreter matches INTERPRETER_P then it should update
1105 deprecated_command_loop_hook and deprecated_init_ui_hook with the
1106 per-interpreter implementation. */
1107/* FIXME: deprecated_command_loop_hook and deprecated_init_ui_hook
1108 should be moved here. */
1109
1110struct target_waitstatus;
1111struct cmd_list_element;
1112
1113extern void (*deprecated_pre_add_symbol_hook) (const char *);
1114extern void (*deprecated_post_add_symbol_hook) (void);
1115extern void (*selected_frame_level_changed_hook) (int);
1116extern int (*deprecated_ui_loop_hook) (int signo);
1117extern void (*deprecated_init_ui_hook) (char *argv0);
1118extern void (*deprecated_command_loop_hook) (void);
1119extern void (*deprecated_show_load_progress) (const char *section,
1120 unsigned long section_sent,
1121 unsigned long section_size,
1122 unsigned long total_sent,
1123 unsigned long total_size);
1124extern void (*deprecated_print_frame_info_listing_hook) (struct symtab * s,
1125 int line, int stopline,
1126 int noerror);
1127extern int (*deprecated_query_hook) (const char *, va_list)
1128 ATTRIBUTE_FPTR_PRINTF(1,0);
1129extern void (*deprecated_warning_hook) (const char *, va_list)
1130 ATTRIBUTE_FPTR_PRINTF(1,0);
1131extern void (*deprecated_flush_hook) (struct ui_file * stream);
1132extern void (*deprecated_create_breakpoint_hook) (struct breakpoint * b);
1133extern void (*deprecated_delete_breakpoint_hook) (struct breakpoint * bpt);
1134extern void (*deprecated_modify_breakpoint_hook) (struct breakpoint * bpt);
1135extern void (*deprecated_interactive_hook) (void);
1136extern void (*deprecated_registers_changed_hook) (void);
1137extern void (*deprecated_readline_begin_hook) (char *, ...)
1138 ATTRIBUTE_FPTR_PRINTF_1;
1139extern char *(*deprecated_readline_hook) (char *);
1140extern void (*deprecated_readline_end_hook) (void);
1141extern void (*deprecated_register_changed_hook) (int regno);
1142extern void (*deprecated_memory_changed_hook) (CORE_ADDR addr, int len);
1143extern void (*deprecated_context_hook) (int);
1144extern ptid_t (*deprecated_target_wait_hook) (ptid_t ptid,
1145 struct target_waitstatus * status);
1146
1147extern void (*deprecated_attach_hook) (void);
1148extern void (*deprecated_detach_hook) (void);
1149extern void (*deprecated_call_command_hook) (struct cmd_list_element * c,
1150 char *cmd, int from_tty);
1151
1152extern void (*deprecated_set_hook) (struct cmd_list_element * c);
1153
1154extern void (*deprecated_error_hook) (void);
1155
1156extern void (*deprecated_error_begin_hook) (void);
1157
1158extern int (*deprecated_ui_load_progress_hook) (const char *section,
1159 unsigned long num);
1160
1161
1162/* Inhibit window interface if non-zero. */
1163
1164extern int use_windows;
1165
1166/* Symbolic definitions of filename-related things. */
1167/* FIXME, this doesn't work very well if host and executable
1168 filesystems conventions are different. */
1169
1170#ifdef __MSDOS__
1171# define CANT_FORK
1172# define GLOBAL_CURDIR
1173# define DIRNAME_SEPARATOR ';'
1174#endif
1175
1176#if !defined (__CYGWIN__) && defined (_WIN32)
1177# define DIRNAME_SEPARATOR ';'
1178#endif
1179
1180#ifndef DIRNAME_SEPARATOR
1181#define DIRNAME_SEPARATOR ':'
1182#endif
1183
1184#ifndef SLASH_STRING
1185#define SLASH_STRING "/"
1186#endif
1187
1188/* Provide default definitions of PIDGET, TIDGET, and MERGEPID.
1189 The name ``TIDGET'' is a historical accident. Many uses of TIDGET
1190 in the code actually refer to a lightweight process id, i.e,
1191 something that can be considered a process id in its own right for
1192 certain purposes. */
1193
1194#ifndef PIDGET
1195#define PIDGET(PTID) (ptid_get_pid (PTID))
1196#define TIDGET(PTID) (ptid_get_lwp (PTID))
1197#define MERGEPID(PID, TID) ptid_build (PID, TID, 0)
1198#endif
1199
1200/* Define well known filenos if the system does not define them. */
1201#ifndef STDIN_FILENO
1202#define STDIN_FILENO 0
1203#endif
1204#ifndef STDOUT_FILENO
1205#define STDOUT_FILENO 1
1206#endif
1207#ifndef STDERR_FILENO
1208#define STDERR_FILENO 2
1209#endif
1210
1211/* If this definition isn't overridden by the header files, assume
1212 that isatty and fileno exist on this system. */
1213#ifndef ISATTY
1214#define ISATTY(FP) (isatty (fileno (FP)))
1215#endif
1216
1217/* Ensure that V is aligned to an N byte boundary (B's assumed to be a
1218 power of 2). Round up/down when necessary. Examples of correct
1219 use include:
1220
1221 addr = align_up (addr, 8); -- VALUE needs 8 byte alignment
1222 write_memory (addr, value, len);
1223 addr += len;
1224
1225 and:
1226
1227 sp = align_down (sp - len, 16); -- Keep SP 16 byte aligned
1228 write_memory (sp, value, len);
1229
1230 Note that uses such as:
1231
1232 write_memory (addr, value, len);
1233 addr += align_up (len, 8);
1234
1235 and:
1236
1237 sp -= align_up (len, 8);
1238 write_memory (sp, value, len);
1239
1240 are typically not correct as they don't ensure that the address (SP
1241 or ADDR) is correctly aligned (relying on previous alignment to
1242 keep things right). This is also why the methods are called
1243 "align_..." instead of "round_..." as the latter reads better with
1244 this incorrect coding style. */
1245
1246extern ULONGEST align_up (ULONGEST v, int n);
1247extern ULONGEST align_down (ULONGEST v, int n);
1248
1249/* Allocation and deallocation functions for the libiberty hash table
1250 which use obstacks. */
1251void *hashtab_obstack_allocate (void *data, size_t size, size_t count);
1252void dummy_obstack_deallocate (void *object, void *data);
1253
1254#endif /* #ifndef DEFS_H */
This page took 0.026179 seconds and 4 git commands to generate.