Merge branch 'vendor/GDB'
[dragonfly.git] / contrib / gdb-7 / gdb / defs.h
index 51fc390..19b4780 100644 (file)
@@ -3,7 +3,7 @@
 /* Basic, host-specific, and target-specific definitions for GDB.
    Copyright (C) 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
    1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008, 2009,
-   2010 Free Software Foundation, Inc.
+   2010, 2011 Free Software Foundation, Inc.
 
    This file is part of GDB.
 
@@ -78,9 +78,9 @@
 
 /* The O_BINARY flag is defined in fcntl.h on some non-Posix platforms.
    It is used as an access modifier in calls to open(), where it acts
-   similarly to the "b" character in fopen()'s MODE argument. On Posix
-   platforms it should be a no-op, so it is defined as 0 here. This 
-   ensures that the symbol may be used freely elsewhere in gdb. */
+   similarly to the "b" character in fopen()'s MODE argument.  On Posix
+   platforms it should be a no-op, so it is defined as 0 here.  This 
+   ensures that the symbol may be used freely elsewhere in gdb.  */
 
 #ifndef O_BINARY
 #define O_BINARY 0
@@ -145,10 +145,10 @@ typedef bfd_vma CORE_ADDR;
 /* Check if a character is one of the commonly used C++ marker characters.  */
 extern int is_cplus_marker (int);
 
-/* enable xdb commands if set */
+/* Enable xdb commands if set.  */
 extern int xdb_commands;
 
-/* enable dbx commands if set */
+/* Enable dbx commands if set.  */
 extern int dbx_commands;
 
 /* System root path, used to find libraries etc.  */
@@ -175,7 +175,7 @@ extern void quit (void);
    marginal.  If the overhead of a QUIT function call is proving
    significant then its calling frequency should probably be reduced
    [kingdon].  A profile analyzing the current situtation is
-   needed. */
+   needed.  */
 
 #define QUIT { \
   if (quit_flag) quit (); \
@@ -185,7 +185,7 @@ extern void quit (void);
 /* 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
-   actual definition, needs to be here. */
+   actual definition, needs to be here.  */
 
 enum language
   {
@@ -201,7 +201,7 @@ enum language
     language_asm,              /* Assembly language */
     language_pascal,           /* Pascal */
     language_ada,              /* Ada */
-    language_scm,              /* Guile Scheme */
+    language_opencl,           /* OpenCL */
     language_minimal,          /* All other languages, minimal support only */
     nr_languages
   };
@@ -256,7 +256,7 @@ enum return_value_convention
    Use make_cleanup to add an element to the cleanup chain.
    Use do_cleanups to do all cleanup actions back to a given
    point in the chain.  Use discard_cleanups to remove cleanups
-   from the chain back to a given point, not doing them.  
+   from the chain back to a given point, not doing them.
 
    If the argument is pointer to allocated memory, then you need to
    to additionally set the 'free_arg' member to a function that will
@@ -321,10 +321,10 @@ extern void discard_final_cleanups (struct cleanup *);
 extern void discard_my_cleanups (struct cleanup **, struct cleanup *);
 
 /* NOTE: cagney/2000-03-04: This typedef is strictly for the
-   make_cleanup function declarations below. Do not use this typedef
+   make_cleanup function declarations below.  Do not use this typedef
    as a cast when passing functions into the make_cleanup() code.
    Instead either use a bounce function or add a wrapper function.
-   Calling a f(char*) function with f(void*) is non-portable. */
+   Calling a f(char*) function with f(void*) is non-portable.  */
 typedef void (make_cleanup_ftype) (void *);
 
 extern struct cleanup *make_cleanup (make_cleanup_ftype *, void *);
@@ -337,6 +337,10 @@ extern struct cleanup *make_cleanup_freeargv (char **);
 struct ui_file;
 extern struct cleanup *make_cleanup_ui_file_delete (struct ui_file *);
 
+struct ui_out;
+extern struct cleanup *
+  make_cleanup_ui_out_redirect_pop (struct ui_out *uiout);
+
 struct section_addr_info;
 extern struct cleanup *(make_cleanup_free_section_addr_info 
                         (struct section_addr_info *));
@@ -353,6 +357,9 @@ extern struct cleanup *make_cleanup_obstack_free (struct obstack *obstack);
 extern struct cleanup *make_cleanup_restore_integer (int *variable);
 extern struct cleanup *make_cleanup_restore_uinteger (unsigned int *variable);
 
+struct target_ops;
+extern struct cleanup *make_cleanup_unpush_target (struct target_ops *ops);
+
 extern struct cleanup *
   make_cleanup_restore_ui_file (struct ui_file **variable);
 
@@ -437,13 +444,13 @@ extern struct ui_file *gdb_stdin;
 extern struct ui_file *gdb_stderr;
 /* Log/debug/trace messages that should bypass normal stdout/stderr
    filtering.  For moment, 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). */
+   *_unfiltered.  In the very near future that restriction shall be
+   removed - either call shall be unfiltered.  (cagney 1999-06-13).  */
 extern struct ui_file *gdb_stdlog;
 /* Target output that should bypass normal stdout/stderr filtering.
-   For moment, always call this stream using *_unfiltered. In the
+   For moment, 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). */
+   shall be unfiltered.  (cagney 1999-07-02).  */
 extern struct ui_file *gdb_stdtarg;
 extern struct ui_file *gdb_stdtargerr;
 extern struct ui_file *gdb_stdtargin;
@@ -475,11 +482,14 @@ extern void puts_debug (char *prefix, char *string, char *suffix);
 
 extern void vprintf_filtered (const char *, va_list) ATTRIBUTE_PRINTF (1, 0);
 
-extern void vfprintf_filtered (struct ui_file *, const char *, va_list) ATTRIBUTE_PRINTF (2, 0);
+extern void vfprintf_filtered (struct ui_file *, const char *, va_list)
+  ATTRIBUTE_PRINTF (2, 0);
 
-extern void fprintf_filtered (struct ui_file *, const char *, ...) ATTRIBUTE_PRINTF (2, 3);
+extern void fprintf_filtered (struct ui_file *, const char *, ...)
+  ATTRIBUTE_PRINTF (2, 3);
 
-extern void fprintfi_filtered (int, struct ui_file *, const char *, ...) ATTRIBUTE_PRINTF (3, 4);
+extern void fprintfi_filtered (int, struct ui_file *, const char *, ...)
+  ATTRIBUTE_PRINTF (3, 4);
 
 extern void printf_filtered (const char *, ...) ATTRIBUTE_PRINTF (1, 2);
 
@@ -487,9 +497,11 @@ extern void printfi_filtered (int, const char *, ...) ATTRIBUTE_PRINTF (2, 3);
 
 extern void vprintf_unfiltered (const char *, va_list) ATTRIBUTE_PRINTF (1, 0);
 
-extern void vfprintf_unfiltered (struct ui_file *, const char *, va_list) ATTRIBUTE_PRINTF (2, 0);
+extern void vfprintf_unfiltered (struct ui_file *, const char *, va_list)
+  ATTRIBUTE_PRINTF (2, 0);
 
-extern void fprintf_unfiltered (struct ui_file *, const char *, ...) ATTRIBUTE_PRINTF (2, 3);
+extern void fprintf_unfiltered (struct ui_file *, const char *, ...)
+  ATTRIBUTE_PRINTF (2, 3);
 
 extern void printf_unfiltered (const char *, ...) ATTRIBUTE_PRINTF (1, 2);
 
@@ -499,15 +511,19 @@ extern void print_spaces_filtered (int, struct ui_file *);
 
 extern char *n_spaces (int);
 
-extern void fputstr_filtered (const char *str, int quotr, struct ui_file * stream);
+extern void fputstr_filtered (const char *str, int quotr,
+                             struct ui_file * stream);
 
-extern void fputstr_unfiltered (const char *str, int quotr, struct ui_file * stream);
+extern void fputstr_unfiltered (const char *str, int quotr,
+                               struct ui_file * stream);
 
-extern void fputstrn_filtered (const char *str, int n, int quotr, struct ui_file * stream);
+extern void fputstrn_filtered (const char *str, int n, int quotr,
+                              struct ui_file * stream);
 
-extern void fputstrn_unfiltered (const char *str, int n, int quotr, struct ui_file * stream);
+extern void fputstrn_unfiltered (const char *str, int n, int quotr,
+                                struct ui_file * stream);
 
-/* Display the host ADDR on STREAM formatted as ``0x%x''. */
+/* Display the host ADDR on STREAM formatted as ``0x%x''.  */
 extern void gdb_print_host_address (const void *addr, struct ui_file *stream);
 
 extern const char *host_address_to_string (const void *addr);
@@ -516,6 +532,12 @@ extern const char *host_address_to_string (const void *addr);
    This is usually formatted similar to 0x%lx.  */
 extern const char *paddress (struct gdbarch *gdbarch, CORE_ADDR addr);
 
+/* Return a string representation in hexadecimal notation of ADDRESS,
+   which is suitable for printing.  */
+
+extern const char *print_core_address (struct gdbarch *gdbarch,
+                                      CORE_ADDR address);
+
 /* %d for LONGEST */
 extern char *plongest (LONGEST l);
 /* %u for ULONGEST */
@@ -558,7 +580,7 @@ extern void symbol_file_command (char *, int);
 extern void generic_load (char *name, int from_tty);
 
 /* Report on STREAM the performance of memory transfer operation,
-   such as 'load'. 
+   such as 'load'.
    DATA_COUNT is the number of bytes transferred.
    WRITE_COUNT is the number of separate write operations, or 0,
    if that information is not available.
@@ -631,19 +653,20 @@ extern void init_source_path (void);
 
 /* From exec.c */
 
-/* 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 *));
+typedef int (*find_memory_region_ftype) (CORE_ADDR addr, unsigned long size,
+                                        int read, int write, int exec,
+                                        void *data);
+
+/* Take over the 'find_mapped_memory' vector from exec.c.  */
+extern void exec_set_find_memory_regions
+  (int (*func) (find_memory_region_ftype func, void *data));
 
 /* Possible lvalue types.  Like enum language, this should be in
-   value.h, but needs to be here for the same reason. */
+   value.h, but needs to be here for the same reason.  */
 
 enum lval_type
   {
-    /* Not an lval. */
+    /* Not an lval.  */
     not_lval,
     /* In memory.  */
     lval_memory,
@@ -691,10 +714,9 @@ struct command_line
     enum command_control_type control_type;
     /* The number of elements in body_list.  */
     int body_count;
-    /* For composite commands, the nested lists of
-       commands. For example, for "if" command this
-       will contain the then branch and the else
-       branch, if that is available.  */
+    /* For composite commands, the nested lists of commands.  For
+       example, for "if" command this will contain the then branch and
+       the else branch, if that is available.  */
     struct command_line **body_list;
   };
 
@@ -707,11 +729,11 @@ extern struct command_line *read_command_lines_1 (char * (*) (void), int,
 
 extern void free_command_lines (struct command_line **);
 
-/* To continue the execution commands when running gdb asynchronously. 
+/* 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
+   to finish the command, once the target has stopped.  Such mechanism is
    used by the finish and until commands, and in the remote protocol
-   when opening an extended-remote connection. */
+   when opening an extended-remote connection.  */
 
 struct continuation;
 struct thread_info;
@@ -757,7 +779,7 @@ extern unsigned output_radix;
    things.  Like enum language, this should be in value.h, but needs
    to be here for the same reason.  FIXME:  If we can eliminate this
    as an arg to LA_VAL_PRINT, then we can probably move it back to
-   value.h. */
+   value.h.  */
 
 enum val_prettyprint
   {
@@ -824,26 +846,26 @@ typedef struct ptid ptid_t;
 #endif
 
 /* Defaults for system-wide constants (if not defined by xm.h, we fake it).
-   FIXME: Assumes 2's complement arithmetic */
+   FIXME: Assumes 2's complement arithmetic */
 
 #if !defined (UINT_MAX)
-#define        UINT_MAX ((unsigned int)(~0))   /* 0xFFFFFFFF for 32-bits */
+#define        UINT_MAX ((unsigned int)(~0))       /* 0xFFFFFFFF for 32-bits */
 #endif
 
 #if !defined (INT_MAX)
-#define        INT_MAX ((int)(UINT_MAX >> 1))  /* 0x7FFFFFFF for 32-bits */
+#define        INT_MAX ((int)(UINT_MAX >> 1))      /* 0x7FFFFFFF for 32-bits */
 #endif
 
 #if !defined (INT_MIN)
-#define INT_MIN ((int)((int) ~0 ^ INT_MAX))    /* 0x80000000 for 32-bits */
+#define INT_MIN ((int)((int) ~0 ^ INT_MAX)) /* 0x80000000 for 32-bits */
 #endif
 
 #if !defined (ULONG_MAX)
-#define        ULONG_MAX ((unsigned long)(~0L))        /* 0xFFFFFFFF for 32-bits */
+#define        ULONG_MAX ((unsigned long)(~0L))    /* 0xFFFFFFFF for 32-bits */
 #endif
 
 #if !defined (LONG_MAX)
-#define        LONG_MAX ((long)(ULONG_MAX >> 1))       /* 0x7FFFFFFF for 32-bits */
+#define        LONG_MAX ((long)(ULONG_MAX >> 1))   /* 0x7FFFFFFF for 32-bits */
 #endif
 
 #if !defined (ULONGEST_MAX)
@@ -866,7 +888,7 @@ extern int longest_to_int (LONGEST);
 extern char *savestring (const char *, size_t);
 
 /* xmalloc(), xrealloc() and xcalloc() have already been declared in
-   "libiberty.h". */
+   "libiberty.h".  */
 extern void xfree (void *);
 
 /* Like xmalloc, but zero the memory.  */
@@ -880,8 +902,9 @@ extern void *xzalloc (size_t);
 #define XCALLOC(NMEMB, TYPE) ((TYPE*) xcalloc ((NMEMB), sizeof (TYPE)))
 
 /* Like asprintf/vasprintf but get an internal_error if the call
-   fails. */
-extern void xasprintf (char **ret, const char *format, ...) ATTRIBUTE_PRINTF (2, 3);
+   fails.  */
+extern void xasprintf (char **ret, const char *format, ...)
+     ATTRIBUTE_PRINTF (2, 3);
 extern void xvasprintf (char **ret, const char *format, va_list ap)
      ATTRIBUTE_PRINTF (2, 0);
 
@@ -1024,15 +1047,15 @@ extern void *alloca ();
 #endif /* Not GNU C */
 #endif /* alloca not defined */
 
-/* Dynamic target-system-dependent parameters for GDB. */
+/* Dynamic target-system-dependent parameters for GDB.  */
 #include "gdbarch.h"
 
 /* Maximum size of a register.  Something small, but large enough for
    all known ISAs.  If it turns out to be too small, make it bigger.  */
 
-enum { MAX_REGISTER_SIZE = 32 };
+enum { MAX_REGISTER_SIZE = 64 };
 
-/* Static target-system-dependent parameters for GDB. */
+/* Static target-system-dependent parameters for GDB.  */
 
 /* Number of bits in a char or unsigned char for the target machine.
    Just like CHAR_BIT in <limits.h> but describes the target machine.  */
@@ -1043,7 +1066,7 @@ enum { MAX_REGISTER_SIZE = 32 };
 /* If we picked up a copy of CHAR_BIT from a configuration file
    (which may get it by including <limits.h>) then use it to set
    the number of bits in a host char.  If not, use the same size
-   as the target. */
+   as the target.  */
 
 #if defined (CHAR_BIT)
 #define HOST_CHAR_BIT CHAR_BIT
@@ -1081,14 +1104,14 @@ extern int watchdog;
 
 /* Hooks for alternate command interfaces.  */
 
-/* The name of the interpreter if specified on the command line. */
+/* The name of the interpreter if specified on the command line.  */
 extern char *interpreter_p;
 
 /* If a given interpreter matches INTERPRETER_P then it should update
    deprecated_command_loop_hook and deprecated_init_ui_hook with the
    per-interpreter implementation.  */
 /* FIXME: deprecated_command_loop_hook and deprecated_init_ui_hook
-   should be moved here. */
+   should be moved here.  */
 
 struct target_waitstatus;
 struct cmd_list_element;
@@ -1105,7 +1128,8 @@ extern void (*deprecated_show_load_progress) (const char *section,
                                              unsigned long total_sent, 
                                              unsigned long total_size);
 extern void (*deprecated_print_frame_info_listing_hook) (struct symtab * s,
-                                                        int line, int stopline,
+                                                        int line,
+                                                        int stopline,
                                                         int noerror);
 extern int (*deprecated_query_hook) (const char *, va_list)
      ATTRIBUTE_FPTR_PRINTF(1,0);
@@ -1136,7 +1160,7 @@ extern int (*deprecated_ui_load_progress_hook) (const char *section,
                                                unsigned long num);
 
 
-/* Inhibit window interface if non-zero. */
+/* Inhibit window interface if non-zero.  */
 
 extern int use_windows;