1 /* Ada language support definitions for GDB, the GNU debugger.
3 Copyright (C) 1992, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 2005 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
23 #if !defined (ADA_LANG_H)
26 struct partial_symbol;
31 #include "breakpoint.h"
33 /* Names of specific files known to be part of the runtime
34 system and that might consider (confusing) debugging information.
35 Each name (a basic regular expression string) is followed by a
36 comma. FIXME: Should be part of a configuration file. */
37 #if defined(__alpha__) && defined(__osf__)
38 #define ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS \
39 "^[agis]-.*\\.ad[bs]$", \
40 "/usr/shlib/libpthread\\.so",
41 #elif defined (__linux__)
42 #define ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS \
43 "^[agis]-.*\\.ad[bs]$", \
44 "/lib.*/libpthread\\.so[.0-9]*$", "/lib.*/libpthread\\.a$", \
45 "/lib.*/libc\\.so[.0-9]*$", "/lib.*/libc\\.a$",
48 #if !defined (ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS)
49 #define ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS \
50 "^[agis]-.*\\.ad[bs]$",
53 /* Names of compiler-generated auxiliary functions probably of no
54 interest to users. Each name (a basic regular expression string)
55 is followed by a comma. */
56 #define ADA_KNOWN_AUXILIARY_FUNCTION_NAME_PATTERNS \
57 "___clean[.a-zA-Z0-9_]*$",
59 /* The maximum number of frame levels searched for non-local,
60 * non-global symbols. This limit exists as a precaution to prevent
61 * infinite search loops when the stack is screwed up. */
62 #define MAX_ENCLOSING_FRAME_LEVELS 7
64 /* Maximum number of steps followed in looking for the ultimate
65 referent of a renaming. This prevents certain infinite loops that
66 can otherwise result. */
67 #define MAX_RENAMING_CHAIN_LENGTH 10
71 /* Corresponding encoded/decoded names and opcodes for Ada user-definable
80 /* Table of Ada operators in encoded and decoded forms. */
81 /* Defined in ada-lang.c */
82 extern const struct ada_opname_map ada_opname_table[];
86 /* X IN A'RANGE(N). N is an immediate operand, surrounded by
87 BINOP_IN_BOUNDS before and after. A is an array, X an index
88 value. Evaluates to true iff X is within range of the Nth
89 dimension (1-based) of A. (A multi-dimensional array
90 type is represented as array of array of ...) */
91 BINOP_IN_BOUNDS = OP_EXTENDED0,
93 /* X IN L .. U. True iff L <= X <= U. */
96 /* Ada attributes ('Foo). */
109 /* Ada type qualification. It is encoded as for UNOP_CAST, above,
110 and denotes the TYPE'(EXPR) construct. */
113 /* X IN TYPE. The `TYPE' argument is immediate, with
114 UNOP_IN_RANGE before and after it. True iff X is a member of
115 type TYPE (typically a subrange). */
122 /* A triple, (symbol, block, symtab), representing one instance of a
123 * symbol-lookup operation. */
124 struct ada_symbol_info {
127 struct symtab* symtab;
130 /* Ada task structures. */
132 /* Ada task control block, as defined in the GNAT runt-time library. */
134 struct task_control_block
140 int image_len; /* This field is not always present in the ATCB. */
143 CORE_ADDR lwp; /* This field is not always present in the ATCB. */
148 int pid; /* The Process id */
149 long lwp; /* The Light Weight Process id */
150 long tid; /* The Thread id */
152 typedef struct task_ptid task_ptid_t;
157 struct task_control_block atcb;
159 int known_tasks_index;
160 struct task_entry *next_task;
161 task_ptid_t task_ptid;
165 /* The maximum number of tasks known to the Ada runtime. */
166 extern const int MAX_NUMBER_OF_KNOWN_TASKS;
168 /* task entry list. */
169 extern struct task_entry *task_list;
172 /* Assuming V points to an array of S objects, make sure that it contains at
173 least M objects, updating V and S as necessary. */
175 #define GROW_VECT(v, s, m) \
176 if ((s) < (m)) (v) = grow_vect (v, &(s), m, sizeof *(v));
178 extern void *grow_vect (void *, size_t *, size_t, int);
180 extern int ada_get_field_index (const struct type *type,
181 const char *field_name,
184 extern int ada_parse (void); /* Defined in ada-exp.y */
186 extern void ada_error (char *); /* Defined in ada-exp.y */
188 /* Defined in ada-typeprint.c */
189 extern void ada_print_type (struct type *, char *, struct ui_file *, int,
192 extern int ada_val_print (struct type *, const gdb_byte *, int, CORE_ADDR,
193 struct ui_file *, int, int, int,
194 enum val_prettyprint);
196 extern int ada_value_print (struct value *, struct ui_file *, int,
197 enum val_prettyprint);
199 /* Defined in ada-lang.c */
201 extern struct value *value_from_contents_and_address (struct type *,
205 extern void ada_emit_char (int, struct ui_file *, int, int);
207 extern void ada_printchar (int, struct ui_file *);
209 extern void ada_printstr (struct ui_file *, const gdb_byte *,
210 unsigned int, int, int);
212 extern void ada_convert_actuals (struct value *, int, struct value **,
215 extern struct value *ada_value_subscript (struct value *, int,
218 extern struct type *ada_array_element_type (struct type *, int);
220 extern int ada_array_arity (struct type *);
222 struct type *ada_type_of_array (struct value *, int);
224 extern struct value *ada_coerce_to_simple_array_ptr (struct value *);
226 extern int ada_is_simple_array_type (struct type *);
228 extern int ada_is_array_descriptor_type (struct type *);
230 extern int ada_is_bogus_array_descriptor (struct type *);
232 extern struct type *ada_index_type (struct type *, int);
234 extern struct value *ada_array_bound (struct value *, int, int);
236 extern char *ada_decode_symbol (const struct general_symbol_info*);
238 extern const char *ada_decode (const char*);
240 extern enum language ada_update_initial_language (enum language,
241 struct partial_symtab*);
243 extern void clear_ada_sym_cache (void);
245 extern char **ada_make_symbol_completion_list (const char *text0,
248 extern int ada_lookup_symbol_list (const char *, const struct block *,
249 domain_enum, struct ada_symbol_info**);
251 extern char *ada_fold_name (const char *);
253 extern struct symbol *ada_lookup_symbol (const char *, const struct block *,
257 extern struct minimal_symbol *ada_lookup_simple_minsym (const char *);
259 extern void ada_fill_in_ada_prototype (struct symbol *);
261 extern int user_select_syms (struct ada_symbol_info *, int, int);
263 extern int get_selections (int *, int, int, int, char *);
265 extern char *ada_start_decode_line_1 (char *);
267 extern struct symtabs_and_lines ada_finish_decode_line_1 (char **,
271 extern struct symtabs_and_lines ada_sals_for_line (const char*, int,
274 extern int ada_scan_number (const char *, int, LONGEST *, int *);
276 extern struct type *ada_parent_type (struct type *);
278 extern int ada_is_ignored_field (struct type *, int);
280 extern int ada_is_packed_array_type (struct type *);
282 extern struct value *ada_value_primitive_packed_val (struct value *,
287 extern struct type *ada_coerce_to_simple_array_type (struct type *);
289 extern int ada_is_character_type (struct type *);
291 extern int ada_is_string_type (struct type *);
293 extern int ada_is_tagged_type (struct type *, int);
295 extern int ada_is_tag_type (struct type *);
297 extern struct type *ada_tag_type (struct value *);
299 extern struct value *ada_value_tag (struct value *);
301 extern const char *ada_tag_name (struct value *);
303 extern int ada_is_parent_field (struct type *, int);
305 extern int ada_is_wrapper_field (struct type *, int);
307 extern int ada_is_variant_part (struct type *, int);
309 extern struct type *ada_variant_discrim_type (struct type *, struct type *);
311 extern int ada_is_others_clause (struct type *, int);
313 extern int ada_in_variant (LONGEST, struct type *, int);
315 extern char *ada_variant_discrim_name (struct type *);
317 extern struct value *ada_value_struct_elt (struct value *, char *, char *);
319 extern int ada_is_aligner_type (struct type *);
321 extern struct type *ada_aligned_type (struct type *);
323 extern const gdb_byte *ada_aligned_value_addr (struct type *,
326 extern const char *ada_attribute_name (enum exp_opcode);
328 extern int ada_is_fixed_point_type (struct type *);
330 extern int ada_is_system_address_type (struct type *);
332 extern DOUBLEST ada_delta (struct type *);
334 extern DOUBLEST ada_fixed_to_float (struct type *, LONGEST);
336 extern LONGEST ada_float_to_fixed (struct type *, DOUBLEST);
338 extern int ada_is_vax_floating_type (struct type *);
340 extern int ada_vax_float_type_suffix (struct type *);
342 extern struct value *ada_vax_float_print_function (struct type *);
344 extern struct type *ada_system_address_type (void);
346 extern int ada_which_variant_applies (struct type *, struct type *,
349 extern struct type *ada_to_fixed_type (struct type *, const gdb_byte *,
350 CORE_ADDR, struct value *);
352 extern struct type *ada_template_to_fixed_record_type_1 (struct type *type,
353 const gdb_byte *valaddr,
356 int keep_dynamic_fields);
358 extern int ada_name_prefix_len (const char *);
360 extern char *ada_type_name (struct type *);
362 extern struct type *ada_find_parallel_type (struct type *,
365 extern LONGEST get_int_var_value (char *, int *);
367 extern struct symbol *ada_find_any_symbol (const char *name);
369 extern struct type *ada_find_any_type (const char *name);
371 extern struct symbol *ada_find_renaming_symbol (const char *name,
372 struct block *block);
374 extern int ada_prefer_type (struct type *, struct type *);
376 extern struct type *ada_get_base_type (struct type *);
378 extern struct type *ada_check_typedef (struct type *);
380 extern char *ada_encode (const char *);
382 extern const char *ada_enum_name (const char *);
384 extern int ada_is_modular_type (struct type *);
386 extern ULONGEST ada_modulus (struct type *);
388 extern struct value *ada_value_ind (struct value *);
390 extern void ada_print_scalar (struct type *, LONGEST, struct ui_file *);
392 extern int ada_is_range_type_name (const char *);
394 extern const char *ada_renaming_type (struct type *);
396 extern int ada_is_object_renaming (struct symbol *);
398 extern char *ada_simple_renamed_entity (struct symbol *);
400 extern char *ada_breakpoint_rewrite (char *, int *);
402 extern char *ada_main_name (void);
404 /* Tasking-related: ada-tasks.c */
406 extern int valid_task_id (int);
408 extern void init_task_list (void);
410 extern int ada_is_exception_breakpoint (bpstat bs);
412 extern void ada_adjust_exception_stop (bpstat bs);
414 extern void ada_print_exception_stop (bpstat bs);
416 extern int ada_get_current_task (ptid_t);
418 extern int breakpoint_ada_task_match (CORE_ADDR, ptid_t);
420 extern int ada_print_exception_breakpoint_nontask (struct breakpoint *);
422 extern void ada_print_exception_breakpoint_task (struct breakpoint *);
424 extern void ada_find_printable_frame (struct frame_info *fi);
426 extern void ada_reset_thread_registers (void);
428 extern int ada_build_task_list (void);
430 /* Look up a symbol by name using the search conventions of
431 a specific language (optional block, optional symtab).
432 FIXME: Should be symtab.h. */
434 extern struct symbol *lookup_symbol_in_language (const char *,
435 const struct block *,