mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-11-27 12:03:41 +08:00
4a94e36819
This commit brings all the changes made by running gdb/copyright.py as per GDB's Start of New Year Procedure. For the avoidance of doubt, all changes in this commits were performed by the script.
432 lines
14 KiB
C++
432 lines
14 KiB
C++
/* 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
|