PR symtab/12984:
[deliverable/binutils-gdb.git] / gdb / defs.h
index 9d8f6fce5565ef07ead40b89bd9ef7d03014fd18..71b7cd291d6f0697835e0557bd6f554f8c52e04a 100644 (file)
@@ -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
   {
@@ -256,9 +256,9 @@ 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
+   If the argument is pointer to allocated memory, then you need
    to additionally set the 'free_arg' member to a function that will
    free that memory.  This function will be called both when the cleanup
    is executed and when it's discarded.  */
@@ -271,18 +271,10 @@ struct cleanup
     void *arg;
   };
 
-/* Be conservative and use enum bitfields only with GCC.
-   This is copied from gcc 3.3.1, system.h.  */
-
-#if defined(__GNUC__) && (__GNUC__ >= 2)
-#define ENUM_BITFIELD(TYPE) enum TYPE
-#else
-#define ENUM_BITFIELD(TYPE) unsigned int
-#endif
-
-/* vec.h-style vectors of strings want a typedef for char * .  */
+/* vec.h-style vectors of strings want a typedef for char * or const char *.  */
 
 typedef char * char_ptr;
+typedef const char * const_char_ptr;
 
 /* Needed for various prototypes */
 
@@ -290,6 +282,13 @@ struct symtab;
 struct breakpoint;
 struct frame_info;
 struct gdbarch;
+struct value;
+
+/* From main.c.  */
+
+/* This really belong in utils.c (path-utils.c?), but it references some
+   globals that are currently only available to main.c.  */
+extern char *relocate_gdb_directory (const char *initial, int flag);
 
 /* From utils.c */
 
@@ -321,10 +320,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 *);
@@ -363,6 +362,9 @@ extern struct cleanup *make_cleanup_unpush_target (struct target_ops *ops);
 extern struct cleanup *
   make_cleanup_restore_ui_file (struct ui_file **variable);
 
+extern struct cleanup *make_cleanup_value_free_to_mark (struct value *);
+extern struct cleanup *make_cleanup_value_free (struct value *);
+
 extern struct cleanup *make_final_cleanup (make_cleanup_ftype *, void *);
 
 extern struct cleanup *make_my_cleanup (struct cleanup **,
@@ -444,13 +446,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;
@@ -482,11 +484,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);
 
@@ -494,9 +499,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);
 
@@ -506,15 +513,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);
@@ -523,6 +534,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 */
@@ -565,7 +582,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.
@@ -642,16 +659,16 @@ 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. */
+/* 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,
@@ -699,10 +716,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;
   };
 
@@ -715,44 +731,6 @@ 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. 
-   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 by the finish and until commands, and in the remote protocol
-   when opening an extended-remote connection. */
-
-struct continuation;
-struct thread_info;
-struct inferior;
-
-/* From utils.c */
-
-/* Thread specific continuations.  */
-
-extern void add_continuation (struct thread_info *,
-                             void (*)(void *), void *,
-                             void (*)(void *));
-extern void do_all_continuations (void);
-extern void do_all_continuations_thread (struct thread_info *);
-extern void discard_all_continuations (void);
-extern void discard_all_continuations_thread (struct thread_info *);
-
-extern void add_intermediate_continuation (struct thread_info *,
-                                          void (*)(void *), void *,
-                                          void (*)(void *));
-extern void do_all_intermediate_continuations (void);
-extern void do_all_intermediate_continuations_thread (struct thread_info *);
-extern void discard_all_intermediate_continuations (void);
-extern void discard_all_intermediate_continuations_thread (struct thread_info *);
-
-/* Inferior specific (any thread) continuations.  */
-
-extern void add_inferior_continuation (void (*) (void *),
-                                      void *,
-                                      void (*) (void *));
-extern void do_all_inferior_continuations (void);
-extern void discard_all_inferior_continuations (struct inferior *inf);
-
 /* String containing the current directory (what getwd would return).  */
 
 extern char *current_directory;
@@ -765,7 +743,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
   {
@@ -832,26 +810,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)
@@ -874,7 +852,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.  */
@@ -888,8 +866,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);
 
@@ -1031,7 +1010,7 @@ 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
@@ -1039,7 +1018,7 @@ extern void *alloca ();
 
 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.  */
@@ -1050,7 +1029,7 @@ enum { MAX_REGISTER_SIZE = 64 };
 /* 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
@@ -1088,14 +1067,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;
@@ -1112,7 +1091,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);
@@ -1143,7 +1123,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;
 
@@ -1240,4 +1220,13 @@ void dummy_obstack_deallocate (void *object, void *data);
 extern void initialize_progspace (void);
 extern void initialize_inferiors (void);
 
+/* Special block numbers */
+
+enum block_enum
+{
+  GLOBAL_BLOCK = 0,
+  STATIC_BLOCK = 1,
+  FIRST_LOCAL_BLOCK = 2
+};
+
 #endif /* #ifndef DEFS_H */
This page took 0.0287 seconds and 4 git commands to generate.