123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431 |
- /* Ada language support definitions for GDB, the GNU debugger.
- Copyright (C) 1992-2022 Free Software Foundation, Inc.
- 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 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.
- 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;
- struct type_print_options;
- struct parser_state;
- #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 (__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 \
- "^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
- /* 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
- 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 encoded and decoded forms. */
- /* Defined in ada-lang.c */
- extern const struct ada_opname_map ada_opname_table[];
- /* 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
- {
- ada_catch_exception,
- ada_catch_exception_unhandled,
- ada_catch_assert,
- ada_catch_handlers
- };
- /* 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;
- /* The ID of the task. */
- CORE_ADDR task_id;
- /* 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;
- /* 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;
- /* 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 int ada_get_field_index (const struct type *type,
- const char *field_name,
- int maybe_missing);
- extern int ada_parse (struct parser_state *); /* 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 *);
- extern void ada_print_typedef (struct type *type, struct symbol *new_symbol,
- struct ui_file *stream);
- /* 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 void ada_value_print (struct value *, struct ui_file *,
- const struct value_print_options *);
- /* Defined in ada-lang.c */
- extern void ada_emit_char (int, struct type *, struct ui_file *, int, int);
- extern void ada_printchar (int, struct type *, struct ui_file *);
- extern void ada_printstr (struct ui_file *, struct type *, const gdb_byte *,
- unsigned int, const char *, int,
- const struct value_print_options *);
- struct value *ada_convert_actual (struct value *actual,
- 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 **);
- 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 *);
- 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 LONGEST ada_discrete_type_low_bound (struct type *);
- extern LONGEST ada_discrete_type_high_bound (struct type *);
- extern struct value *ada_get_decoded_value (struct value *value);
- extern struct type *ada_get_decoded_type (struct type *type);
- extern const char *ada_decode_symbol (const struct general_symbol_info *);
- /* 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 std::vector<struct block_symbol> ada_lookup_symbol_list
- (const char *, const struct block *, domain_enum);
- extern struct block_symbol ada_lookup_symbol (const char *,
- const struct block *,
- domain_enum);
- extern void ada_lookup_encoded_symbol
- (const char *name, const struct block *block, domain_enum domain,
- struct block_symbol *symbol_info);
- 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 int ada_is_constrained_packed_array_type (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 *);
- extern bool ada_is_character_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 gdb::unique_xmalloc_ptr<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);
- extern int ada_is_variant_part (struct type *, int);
- extern struct type *ada_variant_discrim_type (struct type *, struct type *);
- extern const char *ada_variant_discrim_name (struct type *);
- extern int ada_is_aligner_type (struct type *);
- extern struct type *ada_aligned_type (struct type *);
- extern const gdb_byte *ada_aligned_value_addr (struct type *,
- const gdb_byte *);
- extern int ada_is_system_address_type (struct type *);
- 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);
- 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,
- CORE_ADDR address,
- struct value *dval0,
- int keep_dynamic_fields);
- extern int ada_name_prefix_len (const char *);
- extern const char *ada_type_name (struct type *);
- extern struct type *ada_find_parallel_type (struct type *,
- const char *suffix);
- extern bool get_int_var_value (const char *, LONGEST &value);
- extern int ada_prefer_type (struct type *, struct type *);
- extern struct type *ada_get_base_type (struct type *);
- extern struct type *ada_check_typedef (struct type *);
- extern std::string ada_encode (const char *);
- extern const char *ada_enum_name (const char *);
- extern int ada_is_modular_type (struct type *);
- extern ULONGEST ada_modulus (struct type *);
- extern struct value *ada_value_ind (struct value *);
- extern void ada_print_scalar (struct type *, LONGEST, struct ui_file *);
- extern int ada_is_range_type_name (const char *);
- extern enum ada_renaming_category ada_parse_renaming (struct symbol *,
- const char **,
- int *, const char **);
- extern void ada_find_printable_frame (struct frame_info *fi);
- extern char *ada_breakpoint_rewrite (char *, int *);
- extern char *ada_main_name (void);
- 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);
- /* Return true if BP is an Ada catchpoint. */
- extern bool is_ada_exception_catchpoint (breakpoint *bp);
- /* Some information about a given Ada exception. */
- 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 std::vector<ada_exc_info> ada_exceptions_list (const char *regexp);
- /* Tasking-related: ada-tasks.c */
- 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
|