/* Ada language support definitions for GDB, the GNU debugger.
- Copyright (C) 1992, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
- 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
+ Copyright (C) 1992-2021 Free Software Foundation, Inc.
This file is part of GDB.
#define ADA_LANG_H 1
struct frame_info;
+struct inferior;
+struct type_print_options;
+struct parser_state;
#include "value.h"
#include "gdbtypes.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$", \
#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;
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[];
-/* A tuple, (symbol, block), representing one instance of a
- * symbol-lookup operation. */
-struct ada_symbol_info {
- struct symbol* sym;
- struct block* block;
-};
-
/* Denotes a type of renaming symbol (see ada_parse_renaming). */
enum ada_renaming_category
{
ADA_NOT_RENAMING,
/* For symbols declared
- Foo : TYPE renamed OBJECT; */
+ Foo : TYPE renamed OBJECT; */
ADA_OBJECT_RENAMING,
/* For symbols declared
- Foo : exception renames EXCEPTION; */
+ Foo : exception renames EXCEPTION; */
ADA_EXCEPTION_RENAMING,
/* For packages declared
- package Foo renames PACKAGE; */
+ package Foo renames PACKAGE; */
ADA_PACKAGE_RENAMING,
/* For subprograms declared
- SUBPROGRAM_SPEC renames SUBPROGRAM;
+ 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
+{
+ ada_catch_exception,
+ ada_catch_exception_unhandled,
+ ada_catch_assert,
+ ada_catch_handlers
+};
+
/* Ada task structures. */
struct ada_task_info
/* 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. */
-#define GROW_VECT(v, s, m) \
- if ((s) < (m)) (v) = grow_vect (v, &(s), m, sizeof *(v));
+ /* The CPU on which the task is running. This is dependent on
+ the runtime actually providing that info, which is not always
+ the case. Normally, we should be able to count on it on
+ bare-metal targets. */
+ int base_cpu;
+};
-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);
+ 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 *, const char *, struct ui_file *, int,
+ int, const struct type_print_options *);
- /* Defined in ada-typeprint.c */
-extern void ada_print_type (struct type *, char *, struct ui_file *, int,
- int);
+extern void ada_print_typedef (struct type *type, struct symbol *new_symbol,
+ struct ui_file *stream);
-extern int ada_val_print (struct type *, const gdb_byte *, int, CORE_ADDR,
- struct ui_file *, int,
- const struct value_print_options *);
+/* Implement la_value_print_inner for Ada. */
+
+extern void ada_value_print_inner (struct value *, struct ui_file *, int,
+ const struct value_print_options *);
-extern int ada_value_print (struct value *, struct ui_file *,
- const struct value_print_options *);
+extern void ada_value_print (struct value *, struct ui_file *,
+ const struct value_print_options *);
- /* Defined in ada-lang.c */
+ /* Defined in ada-lang.c */
extern void ada_emit_char (int, struct type *, struct ui_file *, int, int);
const struct value_print_options *);
struct value *ada_convert_actual (struct value *actual,
- struct type *formal_type0,
- struct gdbarch *gdbarch,
- CORE_ADDR *sp);
+ struct type *formal_type0);
+
+extern bool ada_is_access_to_unconstrained_array (struct type *type);
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);
extern int ada_array_arity (struct type *);
-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 LONGEST ada_discrete_type_high_bound (struct type *);
-extern char *ada_decode_symbol (const struct general_symbol_info*);
-
-extern const char *ada_decode (const char*);
-
-extern enum language ada_update_initial_language (enum language);
+extern struct value *ada_get_decoded_value (struct value *value);
-extern void clear_ada_sym_cache (void);
+extern struct type *ada_get_decoded_type (struct type *type);
-extern int ada_lookup_symbol_list (const char *, const struct block *,
- domain_enum, struct ada_symbol_info**);
+extern const char *ada_decode_symbol (const struct general_symbol_info *);
-extern char *ada_fold_name (const char *);
+/* Decode the GNAT-encoded name NAME, returning the decoded name. If
+ the name does not appear to be GNAT-encoded, then the result
+ depends on WRAP. If WRAP is true (the default), then the result is
+ simply wrapped in <...>. If WRAP is false, then the empty string
+ will be returned. */
+extern std::string ada_decode (const char *name, bool wrap = true);
-extern struct symbol *ada_lookup_symbol (const char *, const struct block *,
- domain_enum, int *);
+extern std::vector<struct block_symbol> ada_lookup_symbol_list
+ (const char *, const struct block *, domain_enum);
-extern struct symbol *
-ada_lookup_encoded_symbol (const char *, const struct block *,
- domain_enum namespace, struct block **);
+extern struct block_symbol ada_lookup_symbol (const char *,
+ const struct block *,
+ domain_enum);
-extern struct minimal_symbol *ada_lookup_simple_minsym (const char *);
+extern void ada_lookup_encoded_symbol
+ (const char *name, const struct block *block, domain_enum domain,
+ struct block_symbol *symbol_info);
-extern void ada_fill_in_ada_prototype (struct symbol *);
-
-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 struct bound_minimal_symbol ada_lookup_simple_minsym (const char *);
extern int ada_scan_number (const char *, int, LONGEST *, int *);
+extern struct value *ada_value_primitive_field (struct value *arg1,
+ int offset,
+ int fieldno,
+ struct type *arg_type);
+
extern struct type *ada_parent_type (struct type *);
extern int ada_is_ignored_field (struct type *, int);
extern struct value *ada_value_primitive_packed_val (struct value *,
const gdb_byte *,
- long, int, int,
- struct type *);
+ long, int, int,
+ struct type *);
extern struct type *ada_coerce_to_simple_array_type (struct type *);
-extern int ada_is_character_type (struct type *);
+extern bool ada_is_character_type (struct type *);
-extern int ada_is_string_type (struct type *);
+extern bool ada_is_string_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 gdb::unique_xmalloc_ptr<char> ada_tag_name (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 struct type *ada_variant_discrim_type (struct type *, struct type *);
-extern int ada_is_others_clause (struct type *, int);
-
-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 *, int);
+extern const char *ada_variant_discrim_name (struct type *);
extern int ada_is_aligner_type (struct type *);
extern const gdb_byte *ada_aligned_value_addr (struct type *,
const gdb_byte *);
-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 struct type *ada_system_address_type (void);
-
-extern int ada_which_variant_applies (struct type *, struct type *,
- const gdb_byte *);
+extern int ada_which_variant_applies (struct type *, struct value *);
extern struct type *ada_to_fixed_type (struct type *, const gdb_byte *,
CORE_ADDR, struct value *,
- int check_tag);
+ 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,
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 *);
+ const char *suffix);
-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 bool get_int_var_value (const char *, LONGEST &value);
extern int ada_prefer_type (struct type *, struct type *);
extern struct type *ada_check_typedef (struct type *);
-extern char *ada_encode (const char *);
+extern std::string ada_encode (const char *);
extern const char *ada_enum_name (const char *);
extern char *ada_main_name (void);
-/* Tasking-related: ada-tasks.c */
+extern void create_ada_exception_catchpoint
+ (struct gdbarch *gdbarch, enum ada_exception_catchpoint_kind ex_kind,
+ const std::string &excep_string, const std::string &cond_string, int tempflag,
+ int disabled, int from_tty);
-extern int valid_task_id (int);
+/* Return true if BP is an Ada catchpoint. */
+
+extern bool is_ada_exception_catchpoint (breakpoint *bp);
+
+/* Some information about a given Ada exception. */
-extern int ada_get_task_number (ptid_t);
+struct ada_exc_info
+{
+ /* The name of the exception. */
+ const char *name;
+
+ /* The address of the symbol corresponding to that exception. */
+ CORE_ADDR addr;
+
+ bool operator< (const ada_exc_info &) const;
+ bool operator== (const ada_exc_info &) const;
+};
-extern int ada_build_task_list (int warn_if_null);
+extern std::vector<ada_exc_info> ada_exceptions_list (const char *regexp);
-extern int ada_exception_catchpoint_p (struct breakpoint *b);
-
-extern struct symtab_and_line
- ada_decode_exception_location (char *args, char **addr_string,
- char **exp_string, char **cond_string,
- struct expression **cond,
- struct breakpoint_ops **ops);
+/* Tasking-related: ada-tasks.c */
-extern struct symtab_and_line
- ada_decode_assert_location (char *args, char **addr_string,
- struct breakpoint_ops **ops);
+extern int valid_task_id (int);
+extern struct ada_task_info *ada_get_task_info_from_ptid (ptid_t ptid);
+
+extern int ada_get_task_number (thread_info *thread);
+
+typedef gdb::function_view<void (struct ada_task_info *task)>
+ ada_task_list_iterator_ftype;
+extern void iterate_over_live_ada_tasks
+ (ada_task_list_iterator_ftype iterator);
+
+extern const char *ada_get_tcb_types_info (void);
+
+extern void print_ada_task_info (struct ui_out *uiout,
+ const char *taskno_str,
+ struct inferior *inf);
+
+/* Look for a symbol for an overloaded operator for the operation OP.
+ PARSE_COMPLETION is true if currently parsing for completion.
+ NARGS and ARGVEC describe the arguments to the call. Returns a
+ "null" block_symbol if no such operator is found. */
+
+extern block_symbol ada_find_operator_symbol (enum exp_opcode op,
+ bool parse_completion,
+ int nargs, value *argvec[]);
+
+/* Resolve a function call, selecting among possible function symbols.
+ SYM and BLOCK are passed to ada_lookup_symbol_list. CONTEXT_TYPE
+ describes the calling context. PARSE_COMPLETION is true if
+ currently parsing for completion. NARGS and ARGVEC describe the
+ arguments to the call. This returns the chosen symbol and will
+ update TRACKER accordingly. */
+
+extern block_symbol ada_resolve_funcall (struct symbol *sym,
+ const struct block *block,
+ struct type *context_type,
+ bool parse_completion,
+ int nargs, value *argvec[],
+ innermost_block_tracker *tracker);
+
+/* Resolve a symbol reference, selecting among possible values. SYM
+ and BLOCK are passed to ada_lookup_symbol_list. CONTEXT_TYPE
+ describes the calling context. PARSE_COMPLETION is true if
+ currently parsing for completion. If DEPROCEDURE_P is nonzero,
+ then a symbol that names a zero-argument function will be passed
+ through ada_resolve_function. This returns the chosen symbol and
+ will update TRACKER accordingly. */
+
+extern block_symbol ada_resolve_variable (struct symbol *sym,
+ const struct block *block,
+ struct type *context_type,
+ bool parse_completion,
+ int deprocedure_p,
+ innermost_block_tracker *tracker);
+
+/* The type of nth index in arrays of given type (n numbering from 1).
+ Does not examine memory. Throws an error if N is invalid or TYPE
+ is not an array type. NAME is the name of the Ada attribute being
+ evaluated ('range, 'first, 'last, or 'length); it is used in building
+ the error message. */
+extern struct type *ada_index_type (struct type *type, int n,
+ const char *name);
#endif
projects / deliverable / binutils-gdb.git / blobdiff