X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Fdefs.h;h=ab66d73118226974df3f37771d589a996ee4935e;hb=1c509ca8216de106f508b463a13ceea60ccce878;hp=b5fe805d64db6cab2d392d336abbb16d799c5f8a;hpb=494b7ec97ed90fe6aa44e6d4cfe94554b9b5f10f;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/defs.h b/gdb/defs.h index b5fe805d64..ab66d73118 100644 --- a/gdb/defs.h +++ b/gdb/defs.h @@ -1,6 +1,7 @@ /* *INDENT-OFF* */ /* ATTR_FORMAT confuses indent, avoid running it for now */ /* Basic, host-specific, and target-specific definitions for GDB. - Copyright (C) 1986, 1989, 1991-1996, 1998-2000 + Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, + 1997, 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc. This file is part of GDB. @@ -38,6 +39,9 @@ #include #endif +/* For ``enum target_signal''. */ +#include "gdb/signals.h" + /* Just in case they're not defined in stdio.h. */ #ifndef SEEK_SET @@ -58,10 +62,6 @@ #include "progress.h" -#ifdef USE_MMALLOC -#include "mmalloc.h" -#endif - /* For BFD64 and bfd_vma. */ #include "bfd.h" @@ -72,9 +72,12 @@ #define GDB_MULTI_ARCH_PARTIAL 1 -/* The target is multi-arched. The MULTI-ARCH vector provides all - definitions. "tm.h" is included and may provide definitions of - non- multi-arch macros.. */ +/* The target is partially multi-arched. Both the multi-arch vector + and "tm.h" provide definitions. "tm.h" cannot override a definition + provided by the multi-arch vector. It is detected as a compilation + error. + + This setting is only useful during a multi-arch conversion. */ #define GDB_MULTI_ARCH_TM 2 @@ -161,13 +164,6 @@ extern int is_cplus_marker (int); /* use tui interface if non-zero */ extern int tui_version; -#if defined(TUI) -/* all invocations of TUIDO should have two sets of parens */ -#define TUIDO(x) tuiDo x -#else -#define TUIDO(x) -#endif - /* enable xdb commands if set */ extern int xdb_commands; @@ -366,27 +362,18 @@ extern void free_current_contents (void *); extern void null_cleanup (void *); -extern void xfree (void *); - extern int myread (int, char *, int); -extern int query (char *, ...) ATTR_FORMAT (printf, 1, 2); - -#if !defined (USE_MMALLOC) -/* NOTE: cagney/2000-03-04: The mmalloc functions need to use PTR - rather than void* so that they are consistent with - ../mmalloc/mmalloc.h. */ -extern PTR mcalloc (PTR, size_t, size_t); -extern PTR mmalloc (PTR, size_t); -extern PTR mrealloc (PTR, PTR, size_t); -extern void mfree (PTR, PTR); -#endif +extern int query (const char *, ...) ATTR_FORMAT (printf, 1, 2); extern void init_page_info (void); extern CORE_ADDR host_pointer_to_address (void *ptr); extern void *address_to_host_pointer (CORE_ADDR addr); +extern char *gdb_realpath (const char *); +extern char *xfullpath (const char *); + /* From demangle.c */ extern void set_demangling_style (char *); @@ -397,7 +384,6 @@ struct type; typedef int (use_struct_convention_fn) (int gcc_p, struct type * value_type); extern use_struct_convention_fn generic_use_struct_convention; -typedef unsigned char *(breakpoint_from_pc_fn) (CORE_ADDR * pcptr, int *lenptr); /* Annotation stuff. */ @@ -426,16 +412,12 @@ extern struct ui_file *gdb_stdtarg; #if defined(TUI) #include "tui.h" -#include "tuiCommand.h" -#include "tuiData.h" -#include "tuiIO.h" -#include "tuiLayout.h" -#include "tuiWin.h" #endif #include "ui-file.h" -/* More generic printf like operations */ +/* More generic printf like operations. Filtered versions may return + non-locally on error. */ extern void fputs_filtered (const char *, struct ui_file *); @@ -445,6 +427,8 @@ extern int fputc_filtered (int c, struct ui_file *); extern int fputc_unfiltered (int c, struct ui_file *); +extern int putchar_filtered (int c); + extern int putchar_unfiltered (int c); extern void puts_filtered (const char *); @@ -500,12 +484,19 @@ extern char *paddr_d (LONGEST addr); extern char *phex (ULONGEST l, int sizeof_l); extern char *phex_nz (ULONGEST l, int sizeof_l); +/* Like paddr() only print/scan raw CORE_ADDR. The output from + core_addr_to_string() can be passed direct to + string_to_core_addr(). */ +extern const char *core_addr_to_string (const CORE_ADDR addr); +extern const char *core_addr_to_string_nz (const CORE_ADDR addr); +extern CORE_ADDR string_to_core_addr (const char *my_string); + extern void fprintf_symbol_filtered (struct ui_file *, char *, enum language, int); -extern NORETURN void perror_with_name (char *) ATTR_NORETURN; +extern NORETURN void perror_with_name (const char *) ATTR_NORETURN; -extern void print_sys_errmsg (char *, int); +extern void print_sys_errmsg (const char *, int); /* From regex.c or libc. BSD 4.4 declares this with the argument type as "const char *" in unistd.h, so we can't declare the argument @@ -563,7 +554,7 @@ extern void print_address (CORE_ADDR, struct ui_file *); /* From source.c */ -extern int openp (char *, int, char *, int, int, char **); +extern int openp (const char *, int, const char *, int, int, char **); extern int source_full_path_of (char *, char **); @@ -581,9 +572,12 @@ 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 (int, char *); +/* Take over the 'find_mapped_memory' vector from exec.c. */ +extern void exec_set_find_memory_regions (int (*) (int (*) (CORE_ADDR, + unsigned long, + int, int, int, + void *), + void *)); /* Possible lvalue types. Like enum language, this should be in value.h, but needs to be here for the same reason. */ @@ -670,7 +664,6 @@ struct continuation struct continuation_arg *arg_list; struct continuation *next; }; -struct continuation continuation; /* In infrun.c. */ extern struct continuation *cmd_continuation; @@ -709,6 +702,39 @@ enum val_prettyprint /* Use the default setting which the user has specified. */ Val_pretty_default }; + +/* The ptid struct is a collection of the various "ids" necessary + for identifying the inferior. This consists of the process id + (pid), thread id (tid), and other fields necessary for uniquely + identifying the inferior process/thread being debugged. When + manipulating ptids, the constructors, accessors, and predicate + declared in inferior.h should be used. These are as follows: + + ptid_build - Make a new ptid from a pid, lwp, and tid. + pid_to_ptid - Make a new ptid from just a pid. + ptid_get_pid - Fetch the pid component of a ptid. + ptid_get_lwp - Fetch the lwp component of a ptid. + ptid_get_tid - Fetch the tid component of a ptid. + ptid_equal - Test to see if two ptids are equal. + + Please do NOT access the struct ptid members directly (except, of + course, in the implementation of the above ptid manipulation + functions). */ + +struct ptid + { + /* Process id */ + int pid; + + /* Lightweight process id */ + long lwp; + + /* Thread id */ + long tid; + }; + +typedef struct ptid ptid_t; + /* Optional host machine definition. Pure autoconf targets will not @@ -753,31 +779,6 @@ enum val_prettyprint #include "fopen-same.h" #endif -/* Microsoft C can't deal with const pointers */ - -#ifdef _MSC_VER -#define CONST_PTR -#else -#define CONST_PTR const -#endif - -/* - * Allow things in gdb to be declared "volatile". If compiling ANSI, it - * just works. If compiling with gcc but non-ansi, redefine to __volatile__. - * If non-ansi, non-gcc, then eliminate "volatile" entirely, making those - * objects be read-write rather than read-only. - */ - -#ifndef volatile -#ifndef __STDC__ -#ifdef __GNUC__ -#define volatile __volatile__ -#else -#define volatile /* nothing */ -#endif /* GNUC */ -#endif /* STDC */ -#endif /* volatile */ - /* Defaults for system-wide constants (if not defined by xm.h, we fake it). FIXME: Assumes 2's complement arithmetic */ @@ -818,23 +819,27 @@ extern int longest_to_int (LONGEST); /* Assorted functions we can declare, now that const and volatile are defined. */ -extern char *savestring (const char *, int); - -extern char *msavestring (void *, const char *, int); +extern char *savestring (const char *, size_t); -extern char *strsave (const char *); +extern char *msavestring (void *, const char *, size_t); extern char *mstrsave (void *, const char *); -/* FIXME; was long, but this causes compile errors in msvc if already - defined */ -#ifdef _MSC_VER -extern PTR xmmalloc (PTR, size_t); -extern PTR xmrealloc (PTR, PTR, size_t); -#else -extern PTR xmmalloc (PTR, long); -extern PTR xmrealloc (PTR, PTR, long); -#endif +/* Robust versions of same. Throw an internal error when no memory, + guard against stray NULL arguments. */ +extern void *xmmalloc (void *md, size_t size); +extern void *xmrealloc (void *md, void *ptr, size_t size); +extern void *xmcalloc (void *md, size_t number, size_t size); +extern void xmfree (void *md, void *ptr); + +/* xmalloc(), xrealloc() and xcalloc() have already been declared in + "libiberty.h". */ +extern void xfree (void *); + +/* Utility macro to allocate typed memory. Avoids errors like + ``struct foo *foo = xmalloc (sizeof bar)'' and ``struct foo *foo = + (struct foo *) xmalloc (sizeof bar)''. */ +#define XMALLOC(TYPE) ((TYPE*) xmalloc (sizeof (TYPE))) /* Like asprintf/vasprintf but get an internal_error if the call fails. */ @@ -857,10 +862,7 @@ extern char *warning_pre_print; extern NORETURN void verror (const char *fmt, va_list ap) ATTR_NORETURN; -extern NORETURN void error (const char *fmt, ...) ATTR_NORETURN; - -/* DEPRECATED: Use error(), verror() or error_stream(). */ -extern NORETURN void error_begin (void); +extern NORETURN void error (const char *fmt, ...) ATTR_NORETURN ATTR_FORMAT (printf, 1, 2); extern NORETURN void error_stream (struct ui_file *) ATTR_NORETURN; @@ -868,43 +870,86 @@ extern NORETURN void error_stream (struct ui_file *) ATTR_NORETURN; message. */ extern char *error_last_message (void); -extern NORETURN void internal_verror (const char *, va_list ap) ATTR_NORETURN; +extern NORETURN void internal_verror (const char *file, int line, + const char *, va_list ap) ATTR_NORETURN; -extern NORETURN void internal_error (char *, ...) ATTR_NORETURN; +extern NORETURN void internal_error (const char *file, int line, + const char *, ...) ATTR_NORETURN ATTR_FORMAT (printf, 3, 4); extern NORETURN void nomem (long) ATTR_NORETURN; -/* Reasons for calling return_to_top_level. Note: enum value 0 is - reserved for internal use as the return value from an initial - setjmp(). */ +/* Reasons for calling throw_exception(). NOTE: all reason values + must be less than zero. enum value 0 is reserved for internal use + as the return value from an initial setjmp(). The function + catch_exceptions() reserves values >= 0 as legal results from its + wrapped function. */ enum return_reason { /* User interrupt. */ - RETURN_QUIT = 1, + RETURN_QUIT = -2, /* Any other error. */ RETURN_ERROR }; #define ALL_CLEANUPS ((struct cleanup *)0) -#define RETURN_MASK(reason) (1 << (int)(reason)) +#define RETURN_MASK(reason) (1 << (int)(-reason)) #define RETURN_MASK_QUIT RETURN_MASK (RETURN_QUIT) #define RETURN_MASK_ERROR RETURN_MASK (RETURN_ERROR) #define RETURN_MASK_ALL (RETURN_MASK_QUIT | RETURN_MASK_ERROR) typedef int return_mask; -extern NORETURN void return_to_top_level (enum return_reason) ATTR_NORETURN; +/* Throw an exception of type RETURN_REASON. Will execute a LONG JUMP + to the inner most containing exception handler established using + catch_exceptions() (or the legacy catch_errors()). + + Code normally throws an exception using error() et.al. For various + reaons, GDB also contains code that throws an exception directly. + For instance, the remote*.c targets contain CNTRL-C signal handlers + that propogate the QUIT event up the exception chain. ``This could + be a good thing or a dangerous thing.'' -- the Existential Wombat. */ + +extern NORETURN void throw_exception (enum return_reason) ATTR_NORETURN; + +/* Call FUNC(UIOUT, FUNC_ARGS) but wrapped within an exception + handler. If an exception (enum return_reason) is thrown using + throw_exception() than all cleanups installed since + catch_exceptions() was entered are invoked, the (-ve) exception + value is then returned by catch_exceptions. If FUNC() returns + normally (with a postive or zero return value) then that value is + returned by catch_exceptions(). It is an internal_error() for + FUNC() to return a negative value. + + For the period of the FUNC() call: UIOUT is installed as the output + builder; ERRSTRING is installed as the error/quit message; and a + new cleanup_chain is established. The old values are restored + before catch_exceptions() returns. + + FIXME; cagney/2001-08-13: The need to override the global UIOUT + builder variable should just go away. + + This function superseeds catch_errors(). + + This function uses SETJMP() and LONGJUMP(). */ + +struct ui_out; +typedef int (catch_exceptions_ftype) (struct ui_out *ui_out, void *args); +extern int catch_exceptions (struct ui_out *uiout, + catch_exceptions_ftype *func, void *func_args, + char *errstring, return_mask mask); /* If CATCH_ERRORS_FTYPE throws an error, catch_errors() returns zero otherwize the result from CATCH_ERRORS_FTYPE is returned. It is probably useful for CATCH_ERRORS_FTYPE to always return a non-zero value. It's unfortunate that, catch_errors() does not return an indication of the exact exception that it caught - quit_flag might - help. */ + help. + + This function is superseeded by catch_exceptions(). */ typedef int (catch_errors_ftype) (PTR); -extern int catch_errors (catch_errors_ftype *, PTR, char *, return_mask); +extern int catch_errors (catch_errors_ftype *, void *, char *, return_mask); /* Template to catch_errors() that wraps calls to command functions. */ @@ -912,10 +957,10 @@ extern int catch_errors (catch_errors_ftype *, PTR, char *, return_mask); typedef void (catch_command_errors_ftype) (char *, int); extern int catch_command_errors (catch_command_errors_ftype *func, char *command, int from_tty, return_mask); -extern void warning_begin (void); - extern void warning (const char *, ...) ATTR_FORMAT (printf, 1, 2); +extern void vwarning (const char *, va_list args); + /* Global functions from other, non-gdb GNU thingies. Libiberty thingies are no longer declared here. We include libiberty.h above, instead. */ @@ -931,11 +976,6 @@ extern char *getenv (const char *); #endif #ifdef HAVE_STDLIB_H -#if defined(_MSC_VER) && !defined(__cplusplus) -/* msvc defines these in stdlib.h for c code */ -#undef min -#undef max -#endif #include #endif #ifndef min @@ -959,22 +999,6 @@ extern int fclose (FILE *); extern double atof (const char *); /* X3.159-1989 4.10.1.1 */ #endif -#ifndef MALLOC_INCOMPATIBLE - -#ifdef NEED_DECLARATION_MALLOC -extern PTR malloc (); -#endif - -#ifdef NEED_DECLARATION_REALLOC -extern PTR realloc (); -#endif - -#ifdef NEED_DECLARATION_FREE -extern void free (); -#endif - -#endif /* MALLOC_INCOMPATIBLE */ - /* Various possibilities for alloca. */ #ifndef alloca #ifdef __GNUC__ @@ -990,30 +1014,12 @@ extern void free (); /* We need to be careful not to declare this in a way which conflicts with bison. Bison never declares it as char *, but under various circumstances (like __hpux) we need to use void *. */ -#if defined (__STDC__) || defined (__hpux) extern void *alloca (); -#else /* Don't use void *. */ -extern char *alloca (); -#endif /* Don't use void *. */ #endif /* Not _AIX */ #endif /* Not HAVE_ALLOCA_H */ #endif /* Not GNU C */ #endif /* alloca not defined */ -/* HOST_BYTE_ORDER must be defined to one of these. */ - -#ifdef HAVE_ENDIAN_H -#include -#endif - -#if !defined (BIG_ENDIAN) -#define BIG_ENDIAN 4321 -#endif - -#if !defined (LITTLE_ENDIAN) -#define LITTLE_ENDIAN 1234 -#endif - /* Dynamic target-system-dependent parameters for GDB. */ #include "gdbarch.h" #if (GDB_MULTI_ARCH == 0) @@ -1047,7 +1053,7 @@ extern char *alloca (); from byte/word byte order. */ #if !defined (BITS_BIG_ENDIAN) -#define BITS_BIG_ENDIAN (TARGET_BYTE_ORDER == BIG_ENDIAN) +#define BITS_BIG_ENDIAN (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG) #endif /* In findvar.c. */ @@ -1070,74 +1076,7 @@ extern void store_address (void *, int, LONGEST); extern void store_typed_address (void *buf, struct type *type, CORE_ADDR addr); -/* Setup definitions for host and target floating point formats. We need to - consider the format for `float', `double', and `long double' for both target - and host. We need to do this so that we know what kind of conversions need - to be done when converting target numbers to and from the hosts DOUBLEST - data type. */ - -/* This is used to indicate that we don't know the format of the floating point - number. Typically, this is useful for native ports, where the actual format - is irrelevant, since no conversions will be taking place. */ - -extern const struct floatformat floatformat_unknown; - -#if HOST_BYTE_ORDER == BIG_ENDIAN -#ifndef HOST_FLOAT_FORMAT -#define HOST_FLOAT_FORMAT &floatformat_ieee_single_big -#endif -#ifndef HOST_DOUBLE_FORMAT -#define HOST_DOUBLE_FORMAT &floatformat_ieee_double_big -#endif -#else /* LITTLE_ENDIAN */ -#ifndef HOST_FLOAT_FORMAT -#define HOST_FLOAT_FORMAT &floatformat_ieee_single_little -#endif -#ifndef HOST_DOUBLE_FORMAT -#define HOST_DOUBLE_FORMAT &floatformat_ieee_double_little -#endif -#endif - -#ifndef HOST_LONG_DOUBLE_FORMAT -#define HOST_LONG_DOUBLE_FORMAT &floatformat_unknown -#endif - -/* Use `long double' if the host compiler supports it. (Note that this is not - necessarily any longer than `double'. On SunOS/gcc, it's the same as - double.) This is necessary because GDB internally converts all floating - point values to the widest type supported by the host. - - There are problems however, when the target `long double' is longer than the - host's `long double'. In general, we'll probably reduce the precision of - any such values and print a warning. */ - -#ifdef HAVE_LONG_DOUBLE -typedef long double DOUBLEST; -#else -typedef double DOUBLEST; -#endif - -extern void floatformat_to_doublest (const struct floatformat *, - char *, DOUBLEST *); -extern void floatformat_from_doublest (const struct floatformat *, - DOUBLEST *, char *); -extern DOUBLEST extract_floating (void *, int); - -extern void store_floating (void *, int, DOUBLEST); -/* On some machines there are bits in addresses which are not really - part of the address, but are used by the kernel, the hardware, etc. - for special purposes. ADDR_BITS_REMOVE takes out any such bits - so we get a "real" address such as one would find in a symbol - table. This is used only for addresses of instructions, and even then - 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). */ -#if !defined (ADDR_BITS_REMOVE) -#define ADDR_BITS_REMOVE(addr) (addr) -#endif /* No ADDR_BITS_REMOVE. */ - /* From valops.c */ extern CORE_ADDR push_bytes (CORE_ADDR, char *, int); @@ -1148,10 +1087,8 @@ extern int watchdog; /* Hooks for alternate command interfaces. */ -#ifdef UI_OUT /* The name of the interpreter if specified on the command line. */ extern char *interpreter_p; -#endif /* If a given interpreter matches INTERPRETER_P then it should update command_loop_hook and init_ui_hook with the per-interpreter @@ -1190,7 +1127,8 @@ extern void (*readline_end_hook) (void); extern void (*register_changed_hook) (int regno); extern void (*memory_changed_hook) (CORE_ADDR addr, int len); extern void (*context_hook) (int); -extern int (*target_wait_hook) (int pid, struct target_waitstatus * status); +extern ptid_t (*target_wait_hook) (ptid_t ptid, + struct target_waitstatus * status); extern void (*attach_hook) (void); extern void (*detach_hook) (void); @@ -1218,51 +1156,25 @@ extern int use_windows; #define DIRNAME_SEPARATOR ':' #endif -#ifndef SLASH_P -#if defined(__GO32__)||defined(_WIN32) -#define SLASH_P(X) ((X)=='\\') -#else -#define SLASH_P(X) ((X)=='/') -#endif -#endif - -#ifndef SLASH_CHAR -#if defined(__GO32__)||defined(_WIN32) -#define SLASH_CHAR '\\' -#else -#define SLASH_CHAR '/' -#endif -#endif - #ifndef SLASH_STRING -#if defined(__GO32__)||defined(_WIN32) -#define SLASH_STRING "\\" -#else #define SLASH_STRING "/" #endif -#endif -#ifndef ROOTED_P -#define ROOTED_P(X) (SLASH_P((X)[0])) +#ifdef __MSDOS__ +# define CANT_FORK +# define GLOBAL_CURDIR #endif -/* On some systems, PIDGET is defined to extract the inferior pid from - an internal pid that has the thread id and pid in seperate bit - fields. If not defined, then just use the entire internal pid as - the actual pid. */ +/* Provide default definitions of PIDGET, TIDGET, and MERGEPID. + The name ``TIDGET'' is a historical accident. Many uses of TIDGET + in the code actually refer to a lightweight process id, i.e, + something that can be considered a process id in its own right for + certain purposes. */ #ifndef PIDGET -#define PIDGET(PID) (PID) -#define TIDGET(PID) 0 -#define MERGEPID(PID, TID) (PID) -#endif - -/* If under Cygwin, provide backwards compatibility with older - Cygwin compilers that don't define the current cpp define. */ -#ifdef __CYGWIN32__ -#ifndef __CYGWIN__ -#define __CYGWIN__ -#endif +#define PIDGET(PTID) (ptid_get_pid (PTID)) +#define TIDGET(PTID) (ptid_get_lwp (PTID)) +#define MERGEPID(PID, TID) ptid_build (PID, TID, 0) #endif /* Define well known filenos if the system does not define them. */ @@ -1282,44 +1194,4 @@ extern int use_windows; #define ISATTY(FP) (isatty (fileno (FP))) #endif - -/* FIXME: cagney/1999-12-13: The following will be moved to gdb.h / - libgdb.h or gdblib.h. */ - -/* Return-code (RC) from a gdb library call. (The abreviation RC is - taken from the sim/common directory.) */ - -enum gdb_rc { - /* The operation failed. The failure message can be fetched by - calling ``char *error_last_message(void)''. The value is - determined by the catch_errors() interface. */ - /* NOTE: Since ``defs.h:catch_errors()'' does not return an error / - internal / quit indication it is not possible to return that - here. */ - GDB_RC_FAIL = 0, - /* No error occured but nothing happened. Due to the catch_errors() - interface, this must be non-zero. */ - GDB_RC_NONE = 1, - /* The operation was successful. Due to the catch_errors() - interface, this must be non-zero. */ - GDB_RC_OK = 2 -}; - - -/* Print the specified breakpoint on GDB_STDOUT. (Eventually this - function will ``print'' the object on ``output''). */ -enum gdb_rc gdb_breakpoint_query (/* struct {ui,gdb}_out *output, */ int bnum); - -/* Create a breakpoint at ADDRESS (a GDB source and line). */ -enum gdb_rc gdb_breakpoint (char *address, char *condition, - int hardwareflag, int tempflag, - int thread, int ignore_count); -enum gdb_rc gdb_thread_select (/* output object */ char *tidstr); - -#ifdef UI_OUT -/* Print a list of known thread ids. */ -enum gdb_rc gdb_list_thread_ids (/* output object */); - -/* Switch thread and print notification. */ -#endif #endif /* #ifndef DEFS_H */