X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Fada-lang.h;h=1480977f3b6d7c861da375ea254b30601803aabb;hb=a12ac51333cf97f4da0597d049cc694b4535e7dd;hp=45c156a1210d9cc998db0f3bc4f7a0d93c10b70b;hpb=fe898f56a1df2d8a610899df50e38d1590f3e57a;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/ada-lang.h b/gdb/ada-lang.h index 45c156a121..1480977f3b 100644 --- a/gdb/ada-lang.h +++ b/gdb/ada-lang.h @@ -1,204 +1,198 @@ /* 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-2016 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 . */ #if !defined (ADA_LANG_H) #define ADA_LANG_H 1 +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 (__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 -struct block; +#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. */ +#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 -/* 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))) +/* 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 -/* Chain of cleanups for arguments of OP_UNRESOLVED_VALUE names. Created in - yyparse and freed in ada_resolve. */ -extern struct cleanup *unresolved_names; +struct block; -/* Corresponding mangled/demangled names and opcodes for Ada user-definable - operators. */ +/* Corresponding encoded/decoded names and opcodes for Ada user-definable + operators. */ struct ada_opname_map { - const char *mangled; - const char *demangled; + 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 +/* 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 + }; + +/* The different types of catchpoints that we introduced for catching + Ada exceptions. */ + +enum ada_exception_catchpoint_kind { - /* 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 + ada_catch_exception, + ada_catch_exception_unhandled, + ada_catch_assert }; -enum task_states +/* Ada task structures. */ + +struct ada_task_info { - Unactivated, - Runnable, - Terminated, - Activator_Sleep, - Acceptor_Sleep, - Entry_Caller_Sleep, - Async_Select_Sleep, - Delay_Sleep, - Master_Completion_Sleep, - Master_Phase_2_Sleep -}; + /* 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; -extern char *ada_task_states[]; + /* The ID of the task. */ + CORE_ADDR task_id; -typedef struct -{ - char *P_ARRAY; - int *P_BOUNDS; -} -fat_string; + /* The name of the task. */ + char name[257]; -typedef struct entry_call -{ - void *self; -} - *entry_call_link; + /* The current state of the task. */ + int state; -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 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; + + /* 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; }; -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; +/* Assuming V points to an array of S objects, make sure that it contains at + least M objects, updating V and S as necessary. */ + +#define GROW_VECT(v, s, m) \ + if ((s) < (m)) (v) = (char *) grow_vect (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)) grow_vect ((void**) &(v), &(s), (m), sizeof(*(v))); +extern void ada_ensure_varsize_limit (const struct type *type); -extern void grow_vect (void **, size_t *, size_t, int); +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 */ +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); + /* Defined in ada-typeprint.c */ +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 *, char *, 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 *, char *, - 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 *, char *, 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 **); + struct value **); + +extern void ada_fixup_array_indexes_type (struct type *index_desc_type); extern struct type *ada_array_element_type (struct type *, int); @@ -206,48 +200,50 @@ extern int ada_array_arity (struct type *); struct type *ada_type_of_array (struct value *, int); -extern struct value *ada_coerce_to_simple_array (struct value *); - extern struct value *ada_coerce_to_simple_array_ptr (struct value *); -extern int ada_is_simple_array (struct type *); +struct value *ada_coerce_to_simple_array (struct value *); + +extern int ada_is_simple_array_type (struct type *); -extern int ada_is_array_descriptor (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 int ada_lookup_symbol_list (const char *, struct block *, - namespace_enum, struct symbol ***, - struct block ***); +extern struct value *ada_get_decoded_value (struct value *value); -extern char *ada_fold_name (const char *); +extern struct type *ada_get_decoded_type (struct type *type); -extern struct symbol *ada_lookup_symbol (const char *, struct block *, - namespace_enum); +extern const char *ada_decode_symbol (const struct general_symbol_info *); -extern struct minimal_symbol *ada_lookup_minimal_symbol (const char *); +extern const char *ada_decode (const char*); -extern void ada_resolve (struct expression **, struct type *); +extern enum language ada_update_initial_language (enum language); -extern int ada_resolve_function (struct symbol **, struct block **, int, - struct value **, int, const char *, - struct type *); +extern int ada_lookup_symbol_list (const char *, const struct block *, + domain_enum, struct block_symbol**); -extern void ada_fill_in_ada_prototype (struct symbol *); +extern char *ada_fold_name (const char *); -extern int user_select_syms (struct symbol **, struct block **, int, int); +extern struct block_symbol ada_lookup_symbol (const char *, + const struct block *, + domain_enum, int *); -extern int get_selections (int *, int, int, int, char *); +extern void ada_lookup_encoded_symbol + (const char *name, const struct block *block, domain_enum domain, + struct block_symbol *symbol_info); -extern char *ada_start_decode_line_1 (char *); +extern struct bound_minimal_symbol ada_lookup_simple_minsym (const char *); -extern struct symtabs_and_lines ada_finish_decode_line_1 (char **, - struct symtab *, - int, char ***); +extern void ada_fill_in_ada_prototype (struct symbol *); + +extern int user_select_syms (struct block_symbol *, int, int); + +extern int get_selections (int *, int, int, int, char *); extern int ada_scan_number (const char *, int, LONGEST *, int *); @@ -255,11 +251,12 @@ 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 *, char *, - long, int, int, - struct type *); +extern struct value *ada_value_primitive_packed_val (struct value *, + const gdb_byte *, + long, int, int, + struct type *); extern struct type *ada_coerce_to_simple_array_type (struct type *); @@ -267,12 +264,18 @@ extern int ada_is_character_type (struct type *); extern int ada_is_string_type (struct type *); -extern int ada_is_tagged_type (struct type *); +extern int ada_is_tagged_type (struct type *, int); + +extern int ada_is_tag_type (struct type *); extern struct type *ada_tag_type (struct value *); 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); @@ -287,70 +290,69 @@ extern int ada_in_variant (LONGEST, struct type *, int); extern char *ada_variant_discrim_name (struct type *); -extern struct type *ada_lookup_struct_elt_type (struct type *, char *, int, - int *); - -extern struct value *ada_value_struct_elt (struct value *, char *, char *); - -extern struct value *ada_search_struct_field (char *, struct value *, int, - struct type *); +extern struct value *ada_value_struct_elt (struct value *, char *, int); extern int ada_is_aligner_type (struct type *); extern struct type *ada_aligned_type (struct type *); -extern char *ada_aligned_value_addr (struct type *, char *); +extern const gdb_byte *ada_aligned_value_addr (struct type *, + const gdb_byte *); -extern const char *ada_attribute_name (int); +extern const char *ada_attribute_name (enum exp_opcode); extern int ada_is_fixed_point_type (struct type *); +extern int ada_is_system_address_type (struct type *); + extern DOUBLEST ada_delta (struct type *); 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 *, char *); +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 *, + int check_tag); -extern struct value *ada_to_fixed_value (struct type *, char *, CORE_ADDR, - struct value *); +extern struct value *ada_to_fixed_value (struct value *val); -extern struct type *ada_to_fixed_type (struct type *, char *, CORE_ADDR, - struct value *); +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_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); + const char *suffix); -extern LONGEST get_int_var_value (char *, char *, int *); +extern LONGEST get_int_var_value (char *, int *); -extern struct type *ada_find_any_type (const char *name); +extern struct symbol *ada_find_renaming_symbol (struct symbol *name_sym, + const struct block *block); extern int ada_prefer_type (struct type *, struct type *); extern struct type *ada_get_base_type (struct type *); -extern struct type *ada_completed_type (struct type *); +extern struct type *ada_check_typedef (struct type *); -extern char *ada_mangle (const char *); +extern char *ada_encode (const char *); extern const char *ada_enum_name (const char *); extern int ada_is_modular_type (struct type *); -extern LONGEST ada_modulus (struct type *); +extern ULONGEST ada_modulus (struct type *); extern struct value *ada_value_ind (struct value *); @@ -358,33 +360,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 const char *ada_simple_renamed_entity (struct symbol *); +extern void ada_find_printable_frame (struct frame_info *fi); extern char *ada_breakpoint_rewrite (char *, int *); -/* Tasking-related: ada-tasks.c */ +extern char *ada_main_name (void); -extern int valid_task_id (int); +extern char *ada_name_for_lookup (const char *name); -extern int get_current_task (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 void init_task_list (void); +/* Some information about a given Ada exception. */ -extern void *get_self_id (void); +typedef struct ada_exc_info +{ + /* The name of the exception. */ + const char *name; + + /* The address of the symbol corresponding to that exception. */ + CORE_ADDR addr; +} ada_exc_info; + +DEF_VEC_O(ada_exc_info); -extern int get_current_task (void); +extern VEC(ada_exc_info) *ada_exceptions_list (const char *regexp); -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