Internal error trying to print uninitialized string.
[deliverable/binutils-gdb.git] / gdb / ada-lang.h
index 6632b7e9df86afd6014a68eb9bdebc977f1d2a3b..964d569037415b072e56f3b74018dff5261cd893 100644 (file)
@@ -1,44 +1,40 @@
 /* Ada language support definitions for GDB, the GNU debugger.
 
-   Copyright (C) 1992, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
-   2005 Free Software Foundation, Inc.
+   Copyright (C) 1992-2014 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 3 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., 51 Franklin Street, Fifth Floor,
-Boston, MA 02110-1301, USA.  */
+   You should have received a copy of the GNU General Public License
+   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
 
 #if !defined (ADA_LANG_H)
 #define ADA_LANG_H 1
 
-struct partial_symbol;
 struct frame_info;
+struct inferior;
+struct type_print_options;
+struct parser_state;
 
 #include "value.h"
 #include "gdbtypes.h"
 #include "breakpoint.h"
+#include "vec.h"
 
 /* Names of specific files known to be part of the runtime
    system and that might consider (confusing) debugging information.
    Each name (a basic regular expression string) is followed by a
-   comma.  FIXME: Should be part of a configuration file. */
-#if defined(__alpha__) && defined(__osf__)
-#define ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS \
-   "^[agis]-.*\\.ad[bs]$", \
-   "/usr/shlib/libpthread\\.so",
-#elif defined (__linux__)
+   comma.  FIXME: Should be part of a configuration file.  */
+#if defined (__linux__)
 #define ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS \
    "^[agis]-.*\\.ad[bs]$", \
    "/lib.*/libpthread\\.so[.0-9]*$", "/lib.*/libpthread\\.a$", \
@@ -47,29 +43,31 @@ struct frame_info;
 
 #if !defined (ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS)
 #define ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS \
+   "^unwind-seh.c$", \
    "^[agis]-.*\\.ad[bs]$",
 #endif
 
 /* Names of compiler-generated auxiliary functions probably of no
-   interest to users. Each name (a basic regular expression string)
-   is followed by a comma. */
+   interest to users.  Each name (a basic regular expression string)
+   is followed by a comma.  */
 #define ADA_KNOWN_AUXILIARY_FUNCTION_NAME_PATTERNS \
-   "___clean[.a-zA-Z0-9_]*$",
+   "___clean[.$a-zA-Z0-9_]*$", \
+   "___finalizer[.$a-zA-Z0-9_]*$",
 
 /* The maximum number of frame levels searched for non-local,
  * non-global symbols.  This limit exists as a precaution to prevent
- * infinite search loops when the stack is screwed up. */
+ * infinite search loops when the stack is screwed up.  */
 #define MAX_ENCLOSING_FRAME_LEVELS 7
 
 /* Maximum number of steps followed in looking for the ultimate
    referent of a renaming.  This prevents certain infinite loops that
-   can otherwise result. */
+   can otherwise result.  */
 #define MAX_RENAMING_CHAIN_LENGTH 10
 
 struct block;
 
 /* Corresponding encoded/decoded names and opcodes for Ada user-definable
-   operators. */
+   operators.  */
 struct ada_opname_map
 {
   const char *encoded;
@@ -77,144 +75,136 @@ struct ada_opname_map
   enum exp_opcode op;
 };
 
-/* Table of Ada operators in encoded and decoded forms. */
+/* Table of Ada operators in encoded and decoded forms.  */
 /* Defined in ada-lang.c */
 extern const struct ada_opname_map ada_opname_table[];
 
-enum ada_operator 
-  {
-    /* X IN A'RANGE(N).  N is an immediate operand, surrounded by 
-       BINOP_IN_BOUNDS before and after.  A is an array, X an index 
-       value.  Evaluates to true iff X is within range of the Nth
-       dimension (1-based) of A.  (A multi-dimensional array
-       type is represented as array of array of ...) */
-    BINOP_IN_BOUNDS = OP_EXTENDED0,
-
-    /* X IN L .. U.  True iff L <= X <= U.  */
-    TERNOP_IN_RANGE,
-
-    /* Ada attributes ('Foo). */
-    OP_ATR_FIRST,
-    OP_ATR_LAST,
-    OP_ATR_LENGTH,
-    OP_ATR_IMAGE,
-    OP_ATR_MAX,
-    OP_ATR_MIN,
-    OP_ATR_MODULUS,
-    OP_ATR_POS,
-    OP_ATR_SIZE,
-    OP_ATR_TAG,
-    OP_ATR_VAL,
-
-    /* Ada type qualification.  It is encoded as for UNOP_CAST, above, 
-       and denotes the TYPE'(EXPR) construct. */
-    UNOP_QUAL,
-
-    /* X IN TYPE.  The `TYPE' argument is immediate, with 
-       UNOP_IN_RANGE before and after it. True iff X is a member of 
-       type TYPE (typically a subrange). */
-    UNOP_IN_RANGE,
-
-    /* End marker */
-    OP_ADA_LAST
-  };
+/* A tuple representing one instance of a symbol-lookup operation.  */
 
-/* A triple, (symbol, block, symtab), representing one instance of a 
- * symbol-lookup operation. */
-struct ada_symbol_info {
-  struct symbol* sym;
-  struct block* block;
-  struct symtab* symtab;
+struct ada_symbol_info
+{
+  /* The symbol that was found.  */
+  struct symbol *sym;
+
+  /* The block where the symbol was found.  */
+  const struct block *block;
 };
 
-/* Ada task structures.  */
+/* Denotes a type of renaming symbol (see ada_parse_renaming).  */
+enum ada_renaming_category
+  {
+    /* Indicates a symbol that does not encode a renaming.  */
+    ADA_NOT_RENAMING,
+
+    /* For symbols declared
+         Foo : TYPE renamed OBJECT;  */
+    ADA_OBJECT_RENAMING,
+
+    /* For symbols declared
+         Foo : exception renames EXCEPTION;  */
+    ADA_EXCEPTION_RENAMING,
+    /* For packages declared
+          package Foo renames PACKAGE; */
+    ADA_PACKAGE_RENAMING,
+    /* For subprograms declared
+          SUBPROGRAM_SPEC renames SUBPROGRAM;
+       (Currently not used).  */
+    ADA_SUBPROGRAM_RENAMING
+  };
 
-/* Ada task control block, as defined in the GNAT runt-time library.  */
+/* The different types of catchpoints that we introduced for catching
+   Ada exceptions.  */
 
-struct task_control_block
+enum ada_exception_catchpoint_kind
 {
-  char state;
-  CORE_ADDR parent;
-  int priority;
-  char image [32];
-  int image_len;    /* This field is not always present in the ATCB.  */
-  CORE_ADDR call;
-  CORE_ADDR thread;
-  CORE_ADDR lwp;    /* This field is not always present in the ATCB.  */
+  ada_catch_exception,
+  ada_catch_exception_unhandled,
+  ada_catch_assert
 };
 
-struct task_ptid
-{
-  int pid;                      /* The Process id */
-  long lwp;                     /* The Light Weight Process id */
-  long tid;                     /* The Thread id */
-};
-typedef struct task_ptid task_ptid_t;
+/* Ada task structures.  */
 
-struct task_entry
+struct ada_task_info
 {
+  /* The PTID of the thread that this task runs on.  This ptid is computed
+     in a target-dependent way from the associated Task Control Block.  */
+  ptid_t ptid;
+
+  /* The ID of the task.  */
   CORE_ADDR task_id;
-  struct task_control_block atcb;
-  int task_num;
-  int known_tasks_index;
-  struct task_entry *next_task;
-  task_ptid_t task_ptid;
-  int stack_per;
-};
 
-/* The maximum number of tasks known to the Ada runtime.  */
-extern const int MAX_NUMBER_OF_KNOWN_TASKS;
+  /* The name of the task.  */
+  char name[257];
+
+  /* The current state of the task.  */
+  int state;
+
+  /* The priority associated to the task.  */
+  int priority;
+
+  /* If non-zero, the task ID of the parent task.  */
+  CORE_ADDR parent;
 
-/* task entry list.  */
-extern struct task_entry *task_list;
+  /* If the task is waiting on a task entry, this field contains
+     the ID of the other task.  Zero otherwise.  */
+  CORE_ADDR called_task;
 
+  /* If the task is accepting a rendezvous with another task, this field
+     contains the ID of the calling task.  Zero otherwise.  */
+  CORE_ADDR caller_task;
+};
 
 /* Assuming V points to an array of S objects,  make sure that it contains at
-   least M objects, updating V and S as necessary. */
+   least M objects, updating V and S as necessary.  */
 
-#define GROW_VECT(v, s, m)                                              \
+#define GROW_VECT(v, s, m)                                    \
    if ((s) < (m)) (v) = grow_vect (v, &(s), m, sizeof *(v));
 
 extern void *grow_vect (void *, size_t *, size_t, int);
 
+extern void ada_ensure_varsize_limit (const struct type *type);
+
 extern int ada_get_field_index (const struct type *type,
                                 const char *field_name,
                                 int maybe_missing);
 
-extern int ada_parse (void);    /* Defined in ada-exp.y */
+extern int ada_parse (struct parser_state *);    /* Defined in ada-exp.y */
 
 extern void ada_error (char *); /* Defined in ada-exp.y */
 
                         /* Defined in ada-typeprint.c */
-extern void ada_print_type (struct type *, char *, struct ui_file *, int,
-                            int);
+extern void ada_print_type (struct type *, const char *, struct ui_file *, int,
+                            int, const struct type_print_options *);
 
-extern int ada_val_print (struct type *, const gdb_byte *, int, CORE_ADDR,
-                          struct ui_file *, int, int, int,
-                          enum val_prettyprint);
+extern void ada_print_typedef (struct type *type, struct symbol *new_symbol,
+                              struct ui_file *stream);
 
-extern int ada_value_print (struct value *, struct ui_file *, int,
-                            enum val_prettyprint);
+extern void ada_val_print (struct type *, const gdb_byte *, int, CORE_ADDR,
+                          struct ui_file *, int,
+                          const struct value *,
+                          const struct value_print_options *);
 
-                                /* Defined in ada-lang.c */
+extern void ada_value_print (struct value *, struct ui_file *,
+                            const struct value_print_options *);
 
-extern struct value *value_from_contents_and_address (struct type *,
-                                                     const gdb_byte *,
-                                                      CORE_ADDR);
+                                /* Defined in ada-lang.c */
 
-extern void ada_emit_char (int, struct ui_file *, int, int);
+extern void ada_emit_char (int, struct type *, struct ui_file *, int, int);
 
-extern void ada_printchar (int, struct ui_file *);
+extern void ada_printchar (int, struct type *, struct ui_file *);
 
-extern void ada_printstr (struct ui_file *, const gdb_byte *,
-                         unsigned int, int, int);
+extern void ada_printstr (struct ui_file *, struct type *, const gdb_byte *,
+                         unsigned int, const char *, int,
+                         const struct value_print_options *);
 
-extern void ada_convert_actuals (struct value *, int, struct value **,
-                                 CORE_ADDR *);
+struct value *ada_convert_actual (struct value *actual,
+                                  struct type *formal_type0);
 
 extern struct value *ada_value_subscript (struct value *, int,
                                           struct value **);
 
+extern void ada_fixup_array_indexes_type (struct type *index_desc_type);
+
 extern struct type *ada_array_element_type (struct type *, int);
 
 extern int ada_array_arity (struct type *);
@@ -223,27 +213,27 @@ struct type *ada_type_of_array (struct value *, int);
 
 extern struct value *ada_coerce_to_simple_array_ptr (struct value *);
 
+struct value *ada_coerce_to_simple_array (struct value *);
+
 extern int ada_is_simple_array_type (struct type *);
 
 extern int ada_is_array_descriptor_type (struct type *);
 
 extern int ada_is_bogus_array_descriptor (struct type *);
 
-extern struct type *ada_index_type (struct type *, int);
+extern LONGEST ada_discrete_type_low_bound (struct type *);
 
-extern struct value *ada_array_bound (struct value *, int, int);
+extern LONGEST ada_discrete_type_high_bound (struct type *);
 
-extern char *ada_decode_symbol (const struct general_symbol_info*);
+extern struct value *ada_get_decoded_value (struct value *value);
 
-extern const char *ada_decode (const char*);
+extern struct type *ada_get_decoded_type (struct type *type);
 
-extern enum language ada_update_initial_language (enum language, 
-                                                 struct partial_symtab*);
+extern const char *ada_decode_symbol (const struct general_symbol_info *);
 
-extern void clear_ada_sym_cache (void);
+extern const char *ada_decode (const char*);
 
-extern char **ada_make_symbol_completion_list (const char *text0,
-                                               const char *word);
+extern enum language ada_update_initial_language (enum language);
 
 extern int ada_lookup_symbol_list (const char *, const struct block *,
                                    domain_enum, struct ada_symbol_info**);
@@ -251,10 +241,13 @@ extern int ada_lookup_symbol_list (const char *, const struct block *,
 extern char *ada_fold_name (const char *);
 
 extern struct symbol *ada_lookup_symbol (const char *, const struct block *,
-                                         domain_enum, int *, 
-                                        struct symtab **);
+                                         domain_enum, int *);
+
+extern void ada_lookup_encoded_symbol
+  (const char *name, const struct block *block, domain_enum namespace,
+   struct ada_symbol_info *symbol_info);
 
-extern struct minimal_symbol *ada_lookup_simple_minsym (const char *);
+extern struct bound_minimal_symbol ada_lookup_simple_minsym (const char *);
 
 extern void ada_fill_in_ada_prototype (struct symbol *);
 
@@ -262,22 +255,13 @@ extern int user_select_syms (struct ada_symbol_info *, int, int);
 
 extern int get_selections (int *, int, int, int, char *);
 
-extern char *ada_start_decode_line_1 (char *);
-
-extern struct symtabs_and_lines ada_finish_decode_line_1 (char **,
-                                                          struct symtab *,
-                                                          int, char ***);
-
-extern struct symtabs_and_lines ada_sals_for_line (const char*, int,
-                                                  int, char***, int);
-
 extern int ada_scan_number (const char *, int, LONGEST *, int *);
 
 extern struct type *ada_parent_type (struct type *);
 
 extern int ada_is_ignored_field (struct type *, int);
 
-extern int ada_is_packed_array_type (struct type *);
+extern int ada_is_constrained_packed_array_type (struct type *);
 
 extern struct value *ada_value_primitive_packed_val (struct value *,
                                                     const gdb_byte *,
@@ -300,6 +284,8 @@ extern struct value *ada_value_tag (struct value *);
 
 extern const char *ada_tag_name (struct value *);
 
+extern struct value *ada_tag_value_at_base_address (struct value *obj);
+
 extern int ada_is_parent_field (struct type *, int);
 
 extern int ada_is_wrapper_field (struct type *, int);
@@ -314,7 +300,7 @@ extern int ada_in_variant (LONGEST, struct type *, int);
 
 extern char *ada_variant_discrim_name (struct type *);
 
-extern struct value *ada_value_struct_elt (struct value *, char *, char *);
+extern struct value *ada_value_struct_elt (struct value *, char *, int);
 
 extern int ada_is_aligner_type (struct type *);
 
@@ -335,19 +321,16 @@ extern DOUBLEST ada_fixed_to_float (struct type *, LONGEST);
 
 extern LONGEST ada_float_to_fixed (struct type *, DOUBLEST);
 
-extern int ada_is_vax_floating_type (struct type *);
-
-extern int ada_vax_float_type_suffix (struct type *);
-
-extern struct value *ada_vax_float_print_function (struct type *);
-
 extern struct type *ada_system_address_type (void);
 
 extern int ada_which_variant_applies (struct type *, struct type *,
                                      const gdb_byte *);
 
 extern struct type *ada_to_fixed_type (struct type *, const gdb_byte *,
-                                      CORE_ADDR, struct value *);
+                                      CORE_ADDR, struct value *,
+                                       int check_tag);
+
+extern struct value *ada_to_fixed_value (struct value *val);
 
 extern struct type *ada_template_to_fixed_record_type_1 (struct type *type,
                                                         const gdb_byte *valaddr,
@@ -357,19 +340,15 @@ extern struct type *ada_template_to_fixed_record_type_1 (struct type *type,
 
 extern int ada_name_prefix_len (const char *);
 
-extern char *ada_type_name (struct type *);
+extern const char *ada_type_name (struct type *);
 
 extern struct type *ada_find_parallel_type (struct type *,
                                             const char *suffix);
 
 extern LONGEST get_int_var_value (char *, int *);
 
-extern struct symbol *ada_find_any_symbol (const char *name);
-
-extern struct type *ada_find_any_type (const char *name);
-
-extern struct symbol *ada_find_renaming_symbol (const char *name,
-                                                struct block *block);
+extern struct symbol *ada_find_renaming_symbol (struct symbol *name_sym,
+                                                const struct block *block);
 
 extern int ada_prefer_type (struct type *, struct type *);
 
@@ -391,50 +370,52 @@ extern void ada_print_scalar (struct type *, LONGEST, struct ui_file *);
 
 extern int ada_is_range_type_name (const char *);
 
-extern const char *ada_renaming_type (struct type *);
+extern enum ada_renaming_category ada_parse_renaming (struct symbol *,
+                                                     const char **,
+                                                     int *, const char **);
 
-extern int ada_is_object_renaming (struct symbol *);
-
-extern char *ada_simple_renamed_entity (struct symbol *);
+extern void ada_find_printable_frame (struct frame_info *fi);
 
 extern char *ada_breakpoint_rewrite (char *, int *);
 
 extern char *ada_main_name (void);
 
-/* Tasking-related: ada-tasks.c */
-
-extern int valid_task_id (int);
+extern char *ada_name_for_lookup (const char *name);
 
-extern void init_task_list (void);
+extern void create_ada_exception_catchpoint
+  (struct gdbarch *gdbarch, enum ada_exception_catchpoint_kind ex_kind,
+   char *excep_string, char *cond_string, int tempflag, int disabled,
+   int from_tty);
 
-extern int ada_is_exception_breakpoint (bpstat bs);
+/* Some information about a given Ada exception.  */
 
-extern void ada_adjust_exception_stop (bpstat bs);
+typedef struct ada_exc_info
+{
+  /* The name of the exception.  */
+  const char *name;
 
-extern void ada_print_exception_stop (bpstat bs);
+  /* The address of the symbol corresponding to that exception.  */
+  CORE_ADDR addr;
+} ada_exc_info;
 
-extern int ada_get_current_task (ptid_t);
+DEF_VEC_O(ada_exc_info);
 
-extern int breakpoint_ada_task_match (CORE_ADDR, ptid_t);
+extern VEC(ada_exc_info) *ada_exceptions_list (const char *regexp);
 
-extern int ada_print_exception_breakpoint_nontask (struct breakpoint *);
+/* Tasking-related: ada-tasks.c */
 
-extern void ada_print_exception_breakpoint_task (struct breakpoint *);
+extern int valid_task_id (int);
 
-extern void ada_find_printable_frame (struct frame_info *fi);
+extern int ada_get_task_number (ptid_t);
 
-extern void ada_reset_thread_registers (void);
+typedef void (ada_task_list_iterator_ftype) (struct ada_task_info *task);
+extern void iterate_over_live_ada_tasks
+  (ada_task_list_iterator_ftype *iterator);
 
 extern int ada_build_task_list (void);
 
-/* Look up a symbol by name using the search conventions of 
-   a specific language (optional block, optional symtab). 
-   FIXME: Should be symtab.h. */
+extern void print_ada_task_info (struct ui_out *uiout,
+                                char *taskno_str,
+                                struct inferior *inf);
 
-extern struct symbol *lookup_symbol_in_language (const char *, 
-                                                const struct block *,
-                                                domain_enum, 
-                                                enum language,
-                                                int *,
-                                                struct symtab **);
 #endif
This page took 0.031774 seconds and 4 git commands to generate.