/* Ada language support definitions for GDB, the GNU debugger.
- Copyright 1992, 1997 Free Software Foundation, Inc.
-This file is part of GDB.
+ Copyright (C) 1992, 1997-2005, 2007-2012 Free Software Foundation,
+ Inc.
-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 file is part of GDB.
-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 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.
-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., 675 Mass Ave, Cambridge, MA 02139, USA. */
+ 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, see <http://www.gnu.org/licenses/>. */
#if !defined (ADA_LANG_H)
#define ADA_LANG_H 1
+struct frame_info;
+struct inferior;
+
#include "value.h"
#include "gdbtypes.h"
+#include "breakpoint.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__)
+#define ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS \
+ "^[agis]-.*\\.ad[bs]$", \
+ "/lib.*/libpthread\\.so[.0-9]*$", "/lib.*/libpthread\\.a$", \
+ "/lib.*/libc\\.so[.0-9]*$", "/lib.*/libc\\.a$",
+#endif
+
+#if !defined (ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS)
+#define ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS \
+ "^[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. */
+#define ADA_KNOWN_AUXILIARY_FUNCTION_NAME_PATTERNS \
+ "___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. */
+#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. */
+#define MAX_RENAMING_CHAIN_LENGTH 10
-/* A macro to reorder the bytes of an address depending on the endiannes
- of the target */
-#define EXTRACT_ADDRESS(x) ((void *) extract_address (&(x), sizeof (x)))
-/* A macro to reorder the bytes of an int depending on the endiannes
- of the target */
-#define EXTRACT_INT(x) ((int) extract_signed_integer (&(x), sizeof (x)))
-
-/* Chain of cleanups for arguments of OP_UNRESOLVED_VALUE names. Created in
- yyparse and freed in ada_resolve. */
-extern struct cleanup* unresolved_names;
-
-/* Corresponding mangled/demangled names and opcodes for Ada user-definable
- operators. */
-struct ada_opname_map {
- const char* mangled;
- const char* demangled;
+struct block;
+
+/* Corresponding encoded/decoded names and opcodes for Ada user-definable
+ operators. */
+struct ada_opname_map
+{
+ const char *encoded;
+ const char *decoded;
enum exp_opcode op;
};
-/* Table of Ada operators in mangled and demangled forms. */
+/* Table of Ada operators in encoded and decoded forms. */
/* Defined in ada-lang.c */
extern const struct ada_opname_map ada_opname_table[];
-/* The maximum number of tasks known to the Ada runtime */
-extern const int MAX_NUMBER_OF_KNOWN_TASKS;
-
-/* Identifiers for Ada attributes that need special processing. Be sure
- to update the table attribute_names in ada-lang.c whenever you change this.
- */
-
-enum ada_attribute {
- /* Invalid attribute for error checking. */
- ATR_INVALID,
-
- ATR_FIRST,
- ATR_LAST,
- ATR_LENGTH,
- ATR_IMAGE,
- ATR_IMG,
- ATR_MAX,
- ATR_MIN,
- ATR_MODULUS,
- ATR_POS,
- ATR_SIZE,
- ATR_TAG,
- ATR_VAL,
-
- /* Dummy last attribute. */
- ATR_END
-};
+/* A tuple representing one instance of a symbol-lookup operation. */
-enum task_states {
- Unactivated,
- Runnable,
- Terminated,
- Activator_Sleep,
- Acceptor_Sleep,
- Entry_Caller_Sleep,
- Async_Select_Sleep,
- Delay_Sleep,
- Master_Completion_Sleep,
- Master_Phase_2_Sleep
+struct ada_symbol_info
+{
+ /* The symbol that was found. */
+ struct symbol *sym;
+
+ /* The block where the symbol was found. */
+ struct block *block;
};
-extern char *ada_task_states[];
+/* 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 structures. */
+
+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;
-typedef struct {
- char *P_ARRAY;
- int *P_BOUNDS;
-} fat_string;
+ /* The ID of the task. */
+ CORE_ADDR task_id;
-typedef struct entry_call {
- void *self;
-} *entry_call_link;
+ /* The name of the task. */
+ char name[257];
-struct task_fields
-{
- int entry_num;
-#if (defined (VXWORKS_TARGET) || !defined (i386)) \
- && !(defined (VXWORKS_TARGET) && defined (M68K_TARGET))
- int pad1;
-#endif
- char state;
-#if (defined (VXWORKS_TARGET) && defined (M68K_TARGET))
- char pad_8bits;
-#endif
- void *parent;
+ /* The current state of the task. */
+ int state;
+
+ /* The priority associated to the task. */
int priority;
- int current_priority;
- fat_string image;
- entry_call_link call;
-#if (defined (sun) && defined (__SVR4)) && !defined (VXWORKS_TARGET)
- int pad2;
- unsigned thread;
- unsigned lwp;
-#else
- void *thread;
- void *lwp;
-#endif
-}
-#if (defined (VXWORKS_TARGET) && defined (M68K_TARGET))
-__attribute__ ((packed))
-#endif
-;
-struct task_entry
-{
- void *task_id;
- int task_num;
- int known_tasks_index;
- struct task_entry *next_task;
- void *thread;
- void *lwp;
- int stack_per;
-};
+ /* If non-zero, the task ID of the parent task. */
+ CORE_ADDR parent;
-extern struct type* builtin_type_ada_int;
-extern struct type* builtin_type_ada_short;
-extern struct type* builtin_type_ada_long;
-extern struct type* builtin_type_ada_long_long;
-extern struct type* builtin_type_ada_char;
-extern struct type* builtin_type_ada_float;
-extern struct type* builtin_type_ada_double;
-extern struct type* builtin_type_ada_long_double;
-extern struct type* builtin_type_ada_natural;
-extern struct type* builtin_type_ada_positive;
-extern struct type* builtin_type_ada_system_address;
+ /* If the task is waiting on a task entry, this field contains
+ the ID of the other task. Zero otherwise. */
+ CORE_ADDR called_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. */
+ /* 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;
+};
-#define GROW_VECT(v, s, m) \
- if ((s) < (m)) grow_vect ((void**) &(v), &(s), (m), sizeof(*(v)));
+/* Assuming V points to an array of S objects, make sure that it contains at
+ least M objects, updating V and S as necessary. */
-extern void grow_vect (void**, size_t*, size_t, int);
+#define GROW_VECT(v, s, m) \
+ if ((s) < (m)) (v) = grow_vect (v, &(s), m, sizeof *(v));
-extern int ada_parse (void); /* Defined in ada-exp.y */
+extern void *grow_vect (void *, size_t *, size_t, int);
-extern void ada_error (char *); /* Defined in ada-exp.y */
+extern int ada_get_field_index (const struct type *type,
+ const char *field_name,
+ int maybe_missing);
- /* Defined in ada-typeprint.c */
-extern void ada_print_type (struct type*, char*, struct ui_file*, int, int);
+extern int ada_parse (void); /* Defined in ada-exp.y */
-extern int ada_val_print (struct type*, char*, int, CORE_ADDR,
- struct ui_file*, int, int, int, enum val_prettyprint);
+extern void ada_error (char *); /* Defined in ada-exp.y */
-extern int ada_value_print (struct value*, struct ui_file*, int,
- enum val_prettyprint);
+ /* Defined in ada-typeprint.c */
+extern void ada_print_type (struct type *, const char *, struct ui_file *, int,
+ int);
- /* Defined in ada-lang.c */
+extern void ada_print_typedef (struct type *type, struct symbol *new_symbol,
+ struct ui_file *stream);
-extern struct value* value_from_contents_and_address (struct type*, char*, CORE_ADDR);
+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 *);
-extern void ada_emit_char (int, struct ui_file *, int, int);
+extern void ada_value_print (struct value *, struct ui_file *,
+ const struct value_print_options *);
-extern void ada_printchar (int, struct ui_file*);
+ /* Defined in ada-lang.c */
-extern void ada_printstr (struct ui_file*, char *, unsigned int, int, int);
+extern void ada_emit_char (int, struct type *, struct ui_file *, int, int);
-extern void ada_convert_actuals (struct value*, int, struct value**, CORE_ADDR*);
+extern void ada_printchar (int, struct type *, struct ui_file *);
-extern struct value* ada_value_subscript (struct value*, int, struct value**);
+extern void ada_printstr (struct ui_file *, struct type *, const gdb_byte *,
+ unsigned int, const char *, int,
+ const struct value_print_options *);
-extern struct type* ada_array_element_type (struct type*, int);
+struct value *ada_convert_actual (struct value *actual,
+ struct type *formal_type0);
-extern int ada_array_arity (struct type*);
+extern struct value *ada_value_subscript (struct value *, int,
+ struct value **);
-struct type* ada_type_of_array (struct value*, int);
+extern void ada_fixup_array_indexes_type (struct type *index_desc_type);
-extern struct value* ada_coerce_to_simple_array (struct value*);
+extern struct type *ada_array_element_type (struct type *, int);
-extern struct value* ada_coerce_to_simple_array_ptr (struct value*);
+extern int ada_array_arity (struct type *);
-extern int ada_is_simple_array (struct type*);
+struct type *ada_type_of_array (struct value *, int);
-extern int ada_is_array_descriptor (struct type*);
+extern struct value *ada_coerce_to_simple_array_ptr (struct value *);
-extern int ada_is_bogus_array_descriptor (struct type*);
+struct value *ada_coerce_to_simple_array (struct value *);
-extern struct type* ada_index_type (struct type*, int);
+extern int ada_is_simple_array_type (struct type *);
-extern struct value* ada_array_bound (struct value*, int, int);
+extern int ada_is_array_descriptor_type (struct type *);
-extern int ada_lookup_symbol_list (const char*, struct block*, namespace_enum,
- struct symbol***, struct block***);
+extern int ada_is_bogus_array_descriptor (struct type *);
-extern char* ada_fold_name (const char*);
+extern LONGEST ada_discrete_type_low_bound (struct type *);
-extern struct symbol* ada_lookup_symbol (const char*, struct block*, namespace_enum);
+extern LONGEST ada_discrete_type_high_bound (struct type *);
-extern struct minimal_symbol* ada_lookup_minimal_symbol (const char*);
+extern struct value *ada_get_decoded_value (struct value *value);
-extern void ada_resolve (struct expression**, struct type*);
+extern struct type *ada_get_decoded_type (struct type *type);
-extern int ada_resolve_function (struct symbol**, struct block**, int,
- struct value**, int, const char*, struct type*);
+extern char *ada_decode_symbol (const struct general_symbol_info*);
-extern void ada_fill_in_ada_prototype (struct symbol*);
+extern const char *ada_decode (const char*);
-extern int user_select_syms (struct symbol**, struct block**, int, int);
+extern enum language ada_update_initial_language (enum language);
-extern int get_selections (int*, int, int, int, char*);
+extern void clear_ada_sym_cache (void);
-extern char* ada_start_decode_line_1 (char*);
+extern int ada_lookup_symbol_list (const char *, const struct block *,
+ domain_enum, struct ada_symbol_info**,
+ int);
-extern struct symtabs_and_lines ada_finish_decode_line_1 (char**, struct symtab*, int, char***);
+extern char *ada_fold_name (const char *);
-extern int ada_scan_number (const char*, int, LONGEST*, int*);
+extern struct symbol *ada_lookup_symbol (const char *, const struct block *,
+ domain_enum, int *);
-extern struct type* ada_parent_type (struct type*);
+extern void ada_lookup_encoded_symbol
+ (const char *name, const struct block *block, domain_enum namespace,
+ struct ada_symbol_info *symbol_info);
-extern int ada_is_ignored_field (struct type*, int);
+extern struct minimal_symbol *ada_lookup_simple_minsym (const char *);
-extern int ada_is_packed_array_type (struct type*);
+extern void ada_fill_in_ada_prototype (struct symbol *);
-extern struct value* ada_value_primitive_packed_val (struct value*, char*, long, int,
- int, struct type*);
+extern int user_select_syms (struct ada_symbol_info *, int, int);
-extern struct type* ada_coerce_to_simple_array_type (struct type*);
+extern int get_selections (int *, int, int, int, char *);
-extern int ada_is_character_type (struct type*);
+extern int ada_scan_number (const char *, int, LONGEST *, int *);
-extern int ada_is_string_type (struct type*);
+extern struct type *ada_parent_type (struct type *);
-extern int ada_is_tagged_type (struct type*);
+extern int ada_is_ignored_field (struct type *, int);
-extern struct type* ada_tag_type (struct value*);
+extern int ada_is_constrained_packed_array_type (struct type *);
-extern struct value* ada_value_tag (struct value*);
+extern struct value *ada_value_primitive_packed_val (struct value *,
+ const gdb_byte *,
+ long, int, int,
+ struct type *);
-extern int ada_is_parent_field (struct type*, int);
+extern struct type *ada_coerce_to_simple_array_type (struct type *);
-extern int ada_is_wrapper_field (struct type*, int);
+extern int ada_is_character_type (struct type *);
-extern int ada_is_variant_part (struct type*, int);
+extern int ada_is_string_type (struct type *);
-extern struct type* ada_variant_discrim_type (struct type*, struct type*);
+extern int ada_is_tagged_type (struct type *, int);
-extern int ada_is_others_clause (struct type*, int);
+extern int ada_is_tag_type (struct type *);
-extern int ada_in_variant (LONGEST, struct type*, int);
+extern struct type *ada_tag_type (struct value *);
-extern char* ada_variant_discrim_name (struct type*);
+extern struct value *ada_value_tag (struct value *);
-extern struct type* ada_lookup_struct_elt_type (struct type*, char*, int, int*);
+extern const char *ada_tag_name (struct value *);
-extern struct value* ada_value_struct_elt (struct value*, char*, char*);
+extern int ada_is_parent_field (struct type *, int);
-extern struct value* ada_search_struct_field (char*, struct value*, int, struct type*);
+extern int ada_is_wrapper_field (struct type *, int);
-extern int ada_is_aligner_type (struct type*);
+extern int ada_is_variant_part (struct type *, int);
-extern struct type* ada_aligned_type (struct type*);
+extern struct type *ada_variant_discrim_type (struct type *, struct type *);
-extern char* ada_aligned_value_addr (struct type*, char*);
+extern int ada_is_others_clause (struct type *, int);
-extern const char* ada_attribute_name (int);
+extern int ada_in_variant (LONGEST, struct type *, int);
-extern int ada_is_fixed_point_type (struct type*);
+extern char *ada_variant_discrim_name (struct type *);
-extern DOUBLEST ada_delta (struct type*);
+extern struct value *ada_value_struct_elt (struct value *, char *, int);
-extern DOUBLEST ada_fixed_to_float (struct type *, LONGEST);
+extern int ada_is_aligner_type (struct type *);
-extern LONGEST ada_float_to_fixed (struct type*, DOUBLEST);
+extern struct type *ada_aligned_type (struct type *);
-extern int ada_is_vax_floating_type (struct type*);
+extern const gdb_byte *ada_aligned_value_addr (struct type *,
+ const gdb_byte *);
-extern int ada_vax_float_type_suffix (struct type*);
+extern const char *ada_attribute_name (enum exp_opcode);
-extern struct value* ada_vax_float_print_function (struct type*);
+extern int ada_is_fixed_point_type (struct type *);
-extern struct type* ada_system_address_type (void);
+extern int ada_is_system_address_type (struct type *);
-extern int ada_which_variant_applies (struct type*, struct type*, char*);
+extern DOUBLEST ada_delta (struct type *);
-extern struct value* ada_to_fixed_value (struct type*, char*, CORE_ADDR, struct value*);
+extern DOUBLEST ada_fixed_to_float (struct type *, LONGEST);
-extern struct type* ada_to_fixed_type (struct type*, char*, CORE_ADDR, struct value*);
+extern LONGEST ada_float_to_fixed (struct type *, DOUBLEST);
-extern int ada_name_prefix_len (const char*);
+extern struct type *ada_system_address_type (void);
-extern char* ada_type_name (struct type*);
+extern int ada_which_variant_applies (struct type *, struct type *,
+ const gdb_byte *);
-extern struct type* ada_find_parallel_type (struct type*, const char *suffix);
+extern struct type *ada_to_fixed_type (struct type *, const gdb_byte *,
+ CORE_ADDR, struct value *,
+ int check_tag);
-extern LONGEST get_int_var_value (char*, char*, int* );
+extern struct value *ada_to_fixed_value (struct value *val);
-extern struct type* ada_find_any_type (const char *name);
+extern struct type *ada_template_to_fixed_record_type_1 (struct type *type,
+ const gdb_byte *valaddr,
+ CORE_ADDR address,
+ struct value *dval0,
+ int keep_dynamic_fields);
-extern int ada_prefer_type (struct type*, struct type*);
+extern int ada_name_prefix_len (const char *);
-extern struct type* ada_get_base_type (struct type*);
+extern const char *ada_type_name (struct type *);
-extern struct type* ada_completed_type (struct type*);
+extern struct type *ada_find_parallel_type (struct type *,
+ const char *suffix);
-extern char* ada_mangle (const char*);
+extern LONGEST get_int_var_value (char *, int *);
-extern const char* ada_enum_name (const char*);
+extern struct symbol *ada_find_renaming_symbol (struct symbol *name_sym,
+ struct block *block);
-extern int ada_is_modular_type (struct type*);
+extern int ada_prefer_type (struct type *, struct type *);
-extern LONGEST ada_modulus (struct type*);
+extern struct type *ada_get_base_type (struct type *);
-extern struct value* ada_value_ind (struct value*);
+extern struct type *ada_check_typedef (struct type *);
-extern void ada_print_scalar (struct type*, LONGEST, struct ui_file*);
+extern char *ada_encode (const char *);
-extern int ada_is_range_type_name (const char*);
+extern const char *ada_enum_name (const char *);
-extern const char* ada_renaming_type (struct type*);
+extern int ada_is_modular_type (struct type *);
-extern int ada_is_object_renaming (struct symbol*);
+extern ULONGEST ada_modulus (struct type *);
-extern const char* ada_simple_renamed_entity (struct symbol*);
+extern struct value *ada_value_ind (struct value *);
-extern char* ada_breakpoint_rewrite (char*, int*);
+extern void ada_print_scalar (struct type *, LONGEST, struct ui_file *);
-/* Tasking-related: ada-tasks.c */
+extern int ada_is_range_type_name (const char *);
-extern int valid_task_id (int);
+extern enum ada_renaming_category ada_parse_renaming (struct symbol *,
+ const char **,
+ int *, const char **);
-extern int get_current_task (void);
+extern void ada_find_printable_frame (struct frame_info *fi);
-extern void init_task_list (void);
+extern char *ada_breakpoint_rewrite (char *, int *);
-extern void* get_self_id (void);
+extern char *ada_main_name (void);
-extern int get_current_task (void);
+extern char *ada_name_for_lookup (const char *name);
-extern int get_entry_number (void*);
+/* Tasking-related: ada-tasks.c */
+
+extern int valid_task_id (int);
-extern void ada_report_exception_break (struct breakpoint *);
+extern int ada_get_task_number (ptid_t);
-extern int ada_maybe_exception_partial_symbol (struct partial_symbol* sym);
+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_is_exception_sym (struct symbol* sym);
+extern int ada_build_task_list (void);
+extern void print_ada_task_info (struct ui_out *uiout,
+ char *taskno_str,
+ struct inferior *inf);
#endif