+/* *INDENT-OFF* */ /* ATTR_FORMAT confuses indent, avoid running it for now */
/* Basic, host-specific, and target-specific definitions for GDB.
- Copyright (C) 1986, 89, 91, 92, 93, 94, 95, 96, 1998
+ Copyright (C) 1986, 89, 91, 92, 93, 94, 95, 96, 98, 1999
Free Software Foundation, Inc.
-This file is part of GDB.
+ This file is part of GDB.
-This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
-(at your option) any later version.
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-GNU General Public License for more details.
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
-You should have received a copy of the GNU General Public License
-along with this program; if not, write to the Free Software
-Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 59 Temple Place - Suite 330,
+ Boston, MA 02111-1307, USA. */
#ifndef DEFS_H
#define DEFS_H
#include "config.h" /* Generated by configure */
#include <stdio.h>
#include <errno.h> /* System call error return status */
+#include <limits.h>
#ifdef HAVE_STDDEF_H
# include <stddef.h>
# include <sys/types.h> /* for size_t */
#endif
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
+#endif
+
/* Just in case they're not defined in stdio.h. */
#ifndef SEEK_SET
#include "ansidecl.h"
-#ifdef ANSI_PROTOTYPES
-#include <stdarg.h>
-#else
-#include <varargs.h>
-#endif
+#include <stdarg.h> /* for va_list */
#include "libiberty.h"
typedef bfd_vma CORE_ADDR;
+/* This is to make sure that LONGEST is at least as big as CORE_ADDR. */
+
+#ifndef LONGEST
+
+#ifdef BFD64
+
+#define LONGEST BFD_HOST_64_BIT
+#define ULONGEST BFD_HOST_U_64_BIT
+
+#else /* No BFD64 */
+
+# ifdef CC_HAS_LONG_LONG
+# define LONGEST long long
+# define ULONGEST unsigned long long
+# else
+/* BFD_HOST_64_BIT is defined for some hosts that don't have long long
+ (e.g. i386-windows) so try it. */
+# ifdef BFD_HOST_64_BIT
+# define LONGEST BFD_HOST_64_BIT
+# define ULONGEST BFD_HOST_U_64_BIT
+# else
+# define LONGEST long
+# define ULONGEST unsigned long
+# endif
+# endif
+
+#endif /* No BFD64 */
+
+#endif /* ! LONGEST */
+
+extern int core_addr_lessthan PARAMS ((CORE_ADDR lhs, CORE_ADDR rhs));
+extern int core_addr_greaterthan PARAMS ((CORE_ADDR lhs, CORE_ADDR rhs));
+
+
#ifndef min
#define min(a, b) ((a) < (b) ? (a) : (b))
#endif
}
#endif
-/* Command classes are top-level categories into which commands are broken
- down for "help" purposes.
- Notes on classes: class_alias is for alias commands which are not
- abbreviations of the original command. class-pseudo is for commands
- which are not really commands nor help topics ("stop"). */
-
-enum command_class
-{
- /* Special args to help_list */
- all_classes = -2, all_commands = -1,
- /* Classes of commands */
- no_class = -1, class_run = 0, class_vars, class_stack,
- class_files, class_support, class_info, class_breakpoint, class_trace,
- class_alias, class_obscure, class_user, class_maintenance,
- class_pseudo, class_tui, class_xdb
-};
-
/* Languages represented in the symbol table and elsewhere.
This should probably be in language.h, but since enum's can't
be forward declared to satisfy opaque references before their
language_auto, /* Placeholder for automatic setting */
language_c, /* C */
language_cplus, /* C++ */
- /* start-sanitize-java */
language_java, /* Java */
- /* end-sanitize-java */
language_chill, /* Chill */
language_fortran, /* Fortran */
language_m2, /* Modula-2 */
#endif
#ifndef ATTR_FORMAT
-# if defined(__GNUC__) && __GNUC__ >= 2 && __GNUC_MINOR__ >= 4 && defined (__ANSI_PROTOTYPES)
+# if defined(__GNUC__) && __GNUC__ >= 2 && __GNUC_MINOR__ >= 4
# define ATTR_FORMAT(type, x, y) __attribute__ ((format(type, x, y)))
# else
# define ATTR_FORMAT(type, x, y) /* nothing */
/* Needed for various prototypes */
-#ifdef __STDC__
struct symtab;
struct breakpoint;
-#endif
/* From blockframe.c */
/* From utils.c */
+extern void initialize_utils PARAMS ((void));
+
extern void notice_quit PARAMS ((void));
extern int strcmp_iw PARAMS ((const char *, const char *));
+extern int subset_compare PARAMS ((char *, char *));
+
extern char *safe_strerror PARAMS ((int));
extern char *safe_strsignal PARAMS ((int));
extern void do_final_cleanups PARAMS ((struct cleanup *));
extern void do_my_cleanups PARAMS ((struct cleanup **, struct cleanup *));
extern void do_run_cleanups PARAMS ((struct cleanup *));
+extern void do_exec_cleanups PARAMS ((struct cleanup *));
+extern void do_exec_error_cleanups PARAMS ((struct cleanup *));
extern void discard_cleanups PARAMS ((struct cleanup *));
extern void discard_final_cleanups PARAMS ((struct cleanup *));
+extern void discard_exec_error_cleanups PARAMS ((struct cleanup *));
extern void discard_my_cleanups PARAMS ((struct cleanup **, struct cleanup *));
typedef void (*make_cleanup_func) PARAMS ((void *));
extern struct cleanup *make_cleanup PARAMS ((make_cleanup_func, void *));
+extern struct cleanup *make_cleanup_freeargv PARAMS ((char **));
+
extern struct cleanup *make_final_cleanup PARAMS ((make_cleanup_func, void *));
extern struct cleanup *make_my_cleanup PARAMS ((struct cleanup **,
extern struct cleanup *make_run_cleanup PARAMS ((make_cleanup_func, void *));
+extern struct cleanup *make_exec_cleanup PARAMS ((make_cleanup_func, void *));
+extern struct cleanup *make_exec_error_cleanup PARAMS ((make_cleanup_func, void *));
+
extern struct cleanup *save_cleanups PARAMS ((void));
extern struct cleanup *save_final_cleanups PARAMS ((void));
extern struct cleanup *save_my_cleanups PARAMS ((struct cleanup **));
extern void mfree PARAMS ((PTR, PTR));
#endif
+extern void init_page_info PARAMS ((void));
+
/* From demangle.c */
extern void set_demangling_style PARAMS ((char *));
extern void reinitialize_more_filter PARAMS ((void));
-/* new */
-enum streamtype
-{
- afile,
- astring
-};
-
-/* new */
-typedef struct tui_stream
-{
- enum streamtype ts_streamtype;
- FILE *ts_filestream;
- char *ts_strbuf;
- int ts_buflen;
-} GDB_FILE;
+struct gdb_file;
+typedef struct gdb_file GDB_FILE; /* deprecated */
+/* Normal results */
extern GDB_FILE *gdb_stdout;
+/* Serious error notifications */
extern GDB_FILE *gdb_stderr;
-
-#if 0
-typedef FILE GDB_FILE;
-#define gdb_stdout stdout
-#define gdb_stderr stderr
-#endif
+/* Log/debug/trace messages that should bypass normal stdout/stderr
+ filtering. For momement, always call this stream using
+ *_unfiltered. In the very near future that restriction shall be
+ removed - either call shall be unfiltered. (cagney 1999-06-13). */
+extern GDB_FILE *gdb_stdlog;
+/* Target output that should bypass normal stdout/stderr filtering.
+ For momement, always call this stream using *_unfiltered. In the
+ very near future that restriction shall be removed - either call
+ shall be unfiltered. (cagney 1999-07-02). */
+extern GDB_FILE *gdb_stdtarg;
#if defined(TUI)
#include "tui.h"
#include "tuiWin.h"
#endif
+/* Create a new gdb_file with the specified methods. */
+
+typedef void (gdb_file_flush_ftype) PARAMS ((struct gdb_file *stream));
+extern void set_gdb_file_flush PARAMS ((struct gdb_file *stream, gdb_file_flush_ftype *flush));
+
+typedef void (gdb_file_fputs_ftype) PARAMS ((const char *, struct gdb_file *stream));
+extern void set_gdb_file_fputs PARAMS ((struct gdb_file *stream, gdb_file_fputs_ftype *fputs));
+
+typedef int (gdb_file_isatty_ftype) PARAMS ((struct gdb_file *stream));
+extern void set_gdb_file_isatty PARAMS ((struct gdb_file *stream, gdb_file_isatty_ftype *isatty));
+
+typedef void (gdb_file_rewind_ftype) PARAMS ((struct gdb_file *stream));
+extern void set_gdb_file_rewind PARAMS ((struct gdb_file *stream, gdb_file_rewind_ftype *rewind));
+
+typedef void (gdb_file_put_ftype) PARAMS ((struct gdb_file *stream, struct gdb_file *dest));
+extern void set_gdb_file_put PARAMS ((struct gdb_file *stream, gdb_file_put_ftype *put));
+
+typedef void (gdb_file_delete_ftype) PARAMS ((struct gdb_file *stream));
+extern void set_gdb_file_data PARAMS ((struct gdb_file *stream, void *data, gdb_file_delete_ftype *delete));
+
+extern struct gdb_file *gdb_file_new PARAMS ((void));
+
+extern void gdb_file_delete PARAMS ((struct gdb_file *stream));
+
+extern void gdb_file_rewind PARAMS ((struct gdb_file *stream));
+
+/* NOTE: copies left to right */
+extern void gdb_file_put PARAMS ((struct gdb_file *src, struct gdb_file *dest));
+
+extern void *gdb_file_data PARAMS ((struct gdb_file *file));
+
+/* Open the specified FILE as a gdb_file. */
+extern struct gdb_file *stdio_fileopen PARAMS ((FILE *));
+/* #if defined (TUI) */
+extern struct gdb_file *tui_fileopen PARAMS ((FILE *));
+/* #endif */
+
+/* deprecated - use gdb_file_delete */
extern void gdb_fclose PARAMS ((GDB_FILE **));
extern void gdb_flush PARAMS ((GDB_FILE *));
extern int gdb_file_isatty PARAMS ((GDB_FILE *));
+/* #if defined (TUI) */
extern GDB_FILE *gdb_file_init_astring PARAMS ((int));
+/* #endif */
extern void gdb_file_deallocate PARAMS ((GDB_FILE **));
+/* #if defined (TUI) */
extern char *gdb_file_get_strbuf PARAMS ((GDB_FILE *));
+/* #endif */
+/* #if defined (TUI) */
extern void gdb_file_adjust_strbuf PARAMS ((int, GDB_FILE *));
+/* #endif */
extern void print_spaces PARAMS ((int, GDB_FILE *));
extern char *n_spaces PARAMS ((int));
-extern void gdb_printchar PARAMS ((int, GDB_FILE *, int));
+extern void fputstr_filtered PARAMS ((const char *str, int quotr, GDB_FILE *stream));
-extern void gdb_print_address PARAMS ((void *, GDB_FILE *));
+extern void fputstr_unfiltered PARAMS ((const char *str, int quotr, GDB_FILE *stream));
-typedef bfd_vma t_addr;
-typedef bfd_vma t_reg;
-extern char* paddr PARAMS ((t_addr addr));
+extern void fputstrn_unfiltered PARAMS ((const char *str, int n, int quotr, GDB_FILE *stream));
-extern char* preg PARAMS ((t_reg reg));
+/* Display the host ADDR on STREAM formatted as ``0x%x''. */
+extern void gdb_print_host_address (void *addr, struct gdb_file *stream);
-extern char* paddr_nz PARAMS ((t_addr addr));
+/* Convert a CORE_ADDR into a HEX string. paddr() is like %08lx.
+ paddr_nz() is like %lx. paddr_u() is like %lu. paddr_width() is
+ for ``%*''. */
+extern int strlen_paddr (void);
+extern char* paddr (CORE_ADDR addr);
+extern char* paddr_nz (CORE_ADDR addr);
+extern char* paddr_u (CORE_ADDR addr);
+extern char* paddr_d (LONGEST addr);
-extern char* preg_nz PARAMS ((t_reg reg));
+typedef bfd_vma t_reg;
+extern char* preg (t_reg reg);
+extern char* preg_nz (t_reg reg);
extern void fprintf_symbol_filtered PARAMS ((GDB_FILE *, char *,
enum language, int));
/* From top.c */
+typedef void initialize_file_ftype (void);
+
extern char *skip_quoted PARAMS ((char *));
extern char *gdb_readline PARAMS ((char *));
extern char *symtab_to_filename PARAMS ((struct symtab *));
+/* From exec.c */
+
+extern void exec_set_section_offsets (bfd_signed_vma text_off,
+ bfd_signed_vma data_off,
+ bfd_signed_vma bss_off);
+
/* From findvar.c */
extern int read_relative_register_raw_bytes PARAMS ((int, char *));
+/* Possible lvalue types. Like enum language, this should be in
+ value.h, but needs to be here for the same reason. */
+
+enum lval_type
+ {
+ /* Not an lval. */
+ not_lval,
+ /* In memory. Could be a saved register. */
+ lval_memory,
+ /* In a register. */
+ lval_register,
+ /* In a gdb internal variable. */
+ lval_internalvar,
+ /* Part of a gdb internal variable (structure field). */
+ lval_internalvar_component,
+ /* In a register series in a frame not the current one, which may have been
+ partially saved or saved in different places (otherwise would be
+ lval_register or lval_memory). */
+ lval_reg_frame_relative
+ };
+
+struct frame_info;
+
+void default_get_saved_register PARAMS ((char *raw_buffer, int *optimized,
+ CORE_ADDR *addrp,
+ struct frame_info *frame, int regnum,
+ enum lval_type *lval));
+
/* From readline (but not in any readline .h files). */
extern char *tilde_expand PARAMS ((char *));
extern void free_command_lines PARAMS ((struct command_line **));
+/* To continue the execution commands when running gdb asynchronously.
+ A continuation structure contains a pointer to a function to be called
+ to finish the command, once the target has stopped. Such mechanism is
+ used bt the finish and until commands, and in the remote protocol
+ when opening an extended-remote connection. */
+
+struct continuation_arg
+{
+ struct continuation_arg *next;
+ PTR data;
+};
+
+struct continuation
+{
+ void (*continuation_hook) PARAMS ((struct continuation_arg *));
+ struct continuation_arg *arg_list;
+ struct continuation *next;
+}
+continuation;
+
+/* In infrun.c. */
+extern struct continuation *cmd_continuation;
+
+/* From utils.c */
+extern void add_continuation PARAMS ((void (*) PARAMS ((struct continuation_arg *)),
+ struct continuation_arg *));
+extern void do_all_continuations PARAMS ((void));
+extern void discard_all_continuations PARAMS ((void));
+
/* String containing the current directory (what getwd would return). */
extern char *current_directory;
#define LONG_MAX ((long)(ULONG_MAX >> 1)) /* 0x7FFFFFFF for 32-bits */
#endif
-#ifndef LONGEST
-
-#ifdef BFD64
-
-/* This is to make sure that LONGEST is at least as big as CORE_ADDR. */
-
-#define LONGEST BFD_HOST_64_BIT
-#define ULONGEST BFD_HOST_U_64_BIT
-
-#else /* No BFD64 */
-
-# ifdef CC_HAS_LONG_LONG
-# define LONGEST long long
-# define ULONGEST unsigned long long
-# else
-/* BFD_HOST_64_BIT is defined for some hosts that don't have long long
- (e.g. i386-windows) so try it. */
-# ifdef BFD_HOST_64_BIT
-# define LONGEST BFD_HOST_64_BIT
-# define ULONGEST BFD_HOST_U_64_BIT
-# else
-# define LONGEST long
-# define ULONGEST unsigned long
-# endif
-# endif
-
-#endif /* No BFD64 */
-
-#endif /* ! LONGEST */
-
/* Convert a LONGEST to an int. This is used in contexts (e.g. number of
arguments to a function, number in a value history, register number, etc.)
where the value must not be larger than can fit in an int. */
extern int parse_escape PARAMS ((char **));
-/* compat - handle old targets that just define REGISTER_NAMES */
-#ifndef REGISTER_NAME
-extern char *gdb_register_names[];
-#define REGISTER_NAME(i) gdb_register_names[i]
-#endif
-
/* Message to be printed before the error message, when an error occurs. */
extern char *error_pre_print;
extern void error_begin PARAMS ((void));
-extern NORETURN void fatal PARAMS((char *, ...)) ATTR_NORETURN;
+extern NORETURN void internal_error (char *, ...) ATTR_NORETURN;
extern NORETURN void nomem PARAMS ((long)) ATTR_NORETURN;
RETURN_ERROR
};
+#define ALL_CLEANUPS ((struct cleanup *)0)
+
#define RETURN_MASK_QUIT (1 << (int)RETURN_QUIT)
#define RETURN_MASK_ERROR (1 << (int)RETURN_ERROR)
#define RETURN_MASK_ALL (RETURN_MASK_QUIT | RETURN_MASK_ERROR)
extern NORETURN void
return_to_top_level PARAMS ((enum return_reason)) ATTR_NORETURN;
-extern int
-catch_errors PARAMS ((int (*) (char *), void *, char *, return_mask));
+typedef int (catch_errors_ftype) PARAMS ((PTR));
+extern int catch_errors PARAMS ((catch_errors_ftype *, PTR, char *, return_mask));
extern void warning_begin PARAMS ((void));
I'm not sure it's used in all contexts. It exists to deal with there
being a few stray bits in the PC which would mislead us, not as some sort
of generic thing to handle alignment or segmentation (it's possible it
- should be in TARGET_READ_PC instead). */
+ should be in TARGET_READ_PC instead). */
#if !defined (ADDR_BITS_REMOVE)
#define ADDR_BITS_REMOVE(addr) (addr)
#endif /* No ADDR_BITS_REMOVE. */
extern CORE_ADDR push_word PARAMS ((CORE_ADDR, ULONGEST));
-/* Some parts of gdb might be considered optional, in the sense that they
- are not essential for being able to build a working, usable debugger
- for a specific environment. For example, the maintenance commands
- are there for the benefit of gdb maintainers. As another example,
- some environments really don't need gdb's that are able to read N
- different object file formats. In order to make it possible (but
- not necessarily recommended) to build "stripped down" versions of
- gdb, the following defines control selective compilation of those
- parts of gdb which can be safely left out when necessary. Note that
- the default is to include everything. */
-
-#ifndef MAINTENANCE_CMDS
-#define MAINTENANCE_CMDS 1
-#endif
-
-#ifdef MAINTENANCE_CMDS
extern int watchdog;
-#endif
/* Hooks for alternate command interfaces. */
-
-#ifdef __STDC__
struct target_waitstatus;
struct cmd_list_element;
-#endif
+/* Should the asynchronous variant of the interpreter (using the
+ event-loop) be enabled? */
+extern int event_loop_p;
+
extern void (*init_ui_hook) PARAMS ((char *argv0));
extern void (*command_loop_hook) PARAMS ((void));
extern void (*fputs_unfiltered_hook) PARAMS ((const char *linebuffer,
extern void (*create_breakpoint_hook) PARAMS ((struct breakpoint *b));
extern void (*delete_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
extern void (*modify_breakpoint_hook) PARAMS ((struct breakpoint *bpt));
-extern void (*target_output_hook) PARAMS ((char *));
extern void (*interactive_hook) PARAMS ((void));
extern void (*registers_changed_hook) PARAMS ((void));
extern void (*readline_begin_hook) PARAMS ((char *, ...));
extern char * (*readline_hook) PARAMS ((char *));
extern void (*readline_end_hook) PARAMS ((void));
-extern void (*pc_changed_hook) PARAMS ((void));
+extern void (*register_changed_hook) PARAMS ((int regno));
+extern void (*memory_changed_hook) PARAMS ((CORE_ADDR addr, int len));
extern void (*context_hook) PARAMS ((int));
extern int (*target_wait_hook) PARAMS ((int pid,
struct target_waitstatus *status));
+extern void (*attach_hook) PARAMS ((void));
+extern void (*detach_hook) PARAMS ((void));
extern void (*call_command_hook) PARAMS ((struct cmd_list_element *c,
char *cmd, int from_tty));
+extern void (*set_hook) PARAMS ((struct cmd_list_element *c));
+
extern NORETURN void (*error_hook) PARAMS ((void)) ATTR_NORETURN;
+extern void (*error_begin_hook) PARAMS ((void));
/* Inhibit window interface if non-zero. */
#endif
#endif
+/* Define well known filenos if the system does not define them. */
+#ifndef STDIN_FILENO
+#define STDIN_FILENO 0
+#endif
+#ifndef STDOUT_FILENO
+#define STDOUT_FILENO 1
+#endif
+#ifndef STDERR_FILENO
+#define STDERR_FILENO 2
+#endif
+
+/* If this definition isn't overridden by the header files, assume
+ that isatty and fileno exist on this system. */
+#ifndef ISATTY
+#define ISATTY(FP) (isatty (fileno (FP)))
+#endif
+
#endif /* #ifndef DEFS_H */