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