1 /* Ada language support routines for GDB, the GNU debugger.
3 Copyright (C) 1992-2019 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
24 #include "gdb_regex.h"
29 #include "expression.h"
30 #include "parser-defs.h"
37 #include "breakpoint.h"
40 #include "gdb_obstack.h"
42 #include "completer.h"
47 #include "dictionary.h"
51 #include "observable.h"
52 #include "common/vec.h"
54 #include "common/gdb_vecs.h"
55 #include "typeprint.h"
56 #include "namespace.h"
60 #include "mi/mi-common.h"
61 #include "arch-utils.h"
62 #include "cli/cli-utils.h"
63 #include "common/function-view.h"
64 #include "common/byte-vector.h"
67 /* Define whether or not the C operator '/' truncates towards zero for
68 differently signed operands (truncation direction is undefined in C).
69 Copied from valarith.c. */
71 #ifndef TRUNCATION_TOWARDS_ZERO
72 #define TRUNCATION_TOWARDS_ZERO ((-5 / 2) == -2)
75 static struct type *desc_base_type (struct type *);
77 static struct type *desc_bounds_type (struct type *);
79 static struct value *desc_bounds (struct value *);
81 static int fat_pntr_bounds_bitpos (struct type *);
83 static int fat_pntr_bounds_bitsize (struct type *);
85 static struct type *desc_data_target_type (struct type *);
87 static struct value *desc_data (struct value *);
89 static int fat_pntr_data_bitpos (struct type *);
91 static int fat_pntr_data_bitsize (struct type *);
93 static struct value *desc_one_bound (struct value *, int, int);
95 static int desc_bound_bitpos (struct type *, int, int);
97 static int desc_bound_bitsize (struct type *, int, int);
99 static struct type *desc_index_type (struct type *, int);
101 static int desc_arity (struct type *);
103 static int ada_type_match (struct type *, struct type *, int);
105 static int ada_args_match (struct symbol *, struct value **, int);
107 static struct value *make_array_descriptor (struct type *, struct value *);
109 static void ada_add_block_symbols (struct obstack *,
110 const struct block *,
111 const lookup_name_info &lookup_name,
112 domain_enum, struct objfile *);
114 static void ada_add_all_symbols (struct obstack *, const struct block *,
115 const lookup_name_info &lookup_name,
116 domain_enum, int, int *);
118 static int is_nonfunction (struct block_symbol *, int);
120 static void add_defn_to_vec (struct obstack *, struct symbol *,
121 const struct block *);
123 static int num_defns_collected (struct obstack *);
125 static struct block_symbol *defns_collected (struct obstack *, int);
127 static struct value *resolve_subexp (expression_up *, int *, int,
130 static void replace_operator_with_call (expression_up *, int, int, int,
131 struct symbol *, const struct block *);
133 static int possible_user_operator_p (enum exp_opcode, struct value **);
135 static const char *ada_op_name (enum exp_opcode);
137 static const char *ada_decoded_op_name (enum exp_opcode);
139 static int numeric_type_p (struct type *);
141 static int integer_type_p (struct type *);
143 static int scalar_type_p (struct type *);
145 static int discrete_type_p (struct type *);
147 static enum ada_renaming_category parse_old_style_renaming (struct type *,
152 static struct symbol *find_old_style_renaming_symbol (const char *,
153 const struct block *);
155 static struct type *ada_lookup_struct_elt_type (struct type *, const char *,
158 static struct value *evaluate_subexp_type (struct expression *, int *);
160 static struct type *ada_find_parallel_type_with_name (struct type *,
163 static int is_dynamic_field (struct type *, int);
165 static struct type *to_fixed_variant_branch_type (struct type *,
167 CORE_ADDR, struct value *);
169 static struct type *to_fixed_array_type (struct type *, struct value *, int);
171 static struct type *to_fixed_range_type (struct type *, struct value *);
173 static struct type *to_static_fixed_type (struct type *);
174 static struct type *static_unwrap_type (struct type *type);
176 static struct value *unwrap_value (struct value *);
178 static struct type *constrained_packed_array_type (struct type *, long *);
180 static struct type *decode_constrained_packed_array_type (struct type *);
182 static long decode_packed_array_bitsize (struct type *);
184 static struct value *decode_constrained_packed_array (struct value *);
186 static int ada_is_packed_array_type (struct type *);
188 static int ada_is_unconstrained_packed_array_type (struct type *);
190 static struct value *value_subscript_packed (struct value *, int,
193 static struct value *coerce_unspec_val_to_type (struct value *,
196 static int lesseq_defined_than (struct symbol *, struct symbol *);
198 static int equiv_types (struct type *, struct type *);
200 static int is_name_suffix (const char *);
202 static int advance_wild_match (const char **, const char *, int);
204 static bool wild_match (const char *name, const char *patn);
206 static struct value *ada_coerce_ref (struct value *);
208 static LONGEST pos_atr (struct value *);
210 static struct value *value_pos_atr (struct type *, struct value *);
212 static struct value *value_val_atr (struct type *, struct value *);
214 static struct symbol *standard_lookup (const char *, const struct block *,
217 static struct value *ada_search_struct_field (const char *, struct value *, int,
220 static struct value *ada_value_primitive_field (struct value *, int, int,
223 static int find_struct_field (const char *, struct type *, int,
224 struct type **, int *, int *, int *, int *);
226 static int ada_resolve_function (struct block_symbol *, int,
227 struct value **, int, const char *,
230 static int ada_is_direct_array_type (struct type *);
232 static void ada_language_arch_info (struct gdbarch *,
233 struct language_arch_info *);
235 static struct value *ada_index_struct_field (int, struct value *, int,
238 static struct value *assign_aggregate (struct value *, struct value *,
242 static void aggregate_assign_from_choices (struct value *, struct value *,
244 int *, LONGEST *, int *,
245 int, LONGEST, LONGEST);
247 static void aggregate_assign_positional (struct value *, struct value *,
249 int *, LONGEST *, int *, int,
253 static void aggregate_assign_others (struct value *, struct value *,
255 int *, LONGEST *, int, LONGEST, LONGEST);
258 static void add_component_interval (LONGEST, LONGEST, LONGEST *, int *, int);
261 static struct value *ada_evaluate_subexp (struct type *, struct expression *,
264 static void ada_forward_operator_length (struct expression *, int, int *,
267 static struct type *ada_find_any_type (const char *name);
269 static symbol_name_matcher_ftype *ada_get_symbol_name_matcher
270 (const lookup_name_info &lookup_name);
274 /* The result of a symbol lookup to be stored in our symbol cache. */
278 /* The name used to perform the lookup. */
280 /* The namespace used during the lookup. */
282 /* The symbol returned by the lookup, or NULL if no matching symbol
285 /* The block where the symbol was found, or NULL if no matching
287 const struct block *block;
288 /* A pointer to the next entry with the same hash. */
289 struct cache_entry *next;
292 /* The Ada symbol cache, used to store the result of Ada-mode symbol
293 lookups in the course of executing the user's commands.
295 The cache is implemented using a simple, fixed-sized hash.
296 The size is fixed on the grounds that there are not likely to be
297 all that many symbols looked up during any given session, regardless
298 of the size of the symbol table. If we decide to go to a resizable
299 table, let's just use the stuff from libiberty instead. */
301 #define HASH_SIZE 1009
303 struct ada_symbol_cache
305 /* An obstack used to store the entries in our cache. */
306 struct obstack cache_space;
308 /* The root of the hash table used to implement our symbol cache. */
309 struct cache_entry *root[HASH_SIZE];
312 static void ada_free_symbol_cache (struct ada_symbol_cache *sym_cache);
314 /* Maximum-sized dynamic type. */
315 static unsigned int varsize_limit;
317 static const char ada_completer_word_break_characters[] =
319 " \t\n!@#%^&*()+=|~`}{[]\";:?/,-";
321 " \t\n!@#$%^&*()+=|~`}{[]\";:?/,-";
324 /* The name of the symbol to use to get the name of the main subprogram. */
325 static const char ADA_MAIN_PROGRAM_SYMBOL_NAME[]
326 = "__gnat_ada_main_program_name";
328 /* Limit on the number of warnings to raise per expression evaluation. */
329 static int warning_limit = 2;
331 /* Number of warning messages issued; reset to 0 by cleanups after
332 expression evaluation. */
333 static int warnings_issued = 0;
335 static const char *known_runtime_file_name_patterns[] = {
336 ADA_KNOWN_RUNTIME_FILE_NAME_PATTERNS NULL
339 static const char *known_auxiliary_function_name_patterns[] = {
340 ADA_KNOWN_AUXILIARY_FUNCTION_NAME_PATTERNS NULL
343 /* Maintenance-related settings for this module. */
345 static struct cmd_list_element *maint_set_ada_cmdlist;
346 static struct cmd_list_element *maint_show_ada_cmdlist;
348 /* Implement the "maintenance set ada" (prefix) command. */
351 maint_set_ada_cmd (const char *args, int from_tty)
353 help_list (maint_set_ada_cmdlist, "maintenance set ada ", all_commands,
357 /* Implement the "maintenance show ada" (prefix) command. */
360 maint_show_ada_cmd (const char *args, int from_tty)
362 cmd_show_list (maint_show_ada_cmdlist, from_tty, "");
365 /* The "maintenance ada set/show ignore-descriptive-type" value. */
367 static int ada_ignore_descriptive_types_p = 0;
369 /* Inferior-specific data. */
371 /* Per-inferior data for this module. */
373 struct ada_inferior_data
375 /* The ada__tags__type_specific_data type, which is used when decoding
376 tagged types. With older versions of GNAT, this type was directly
377 accessible through a component ("tsd") in the object tag. But this
378 is no longer the case, so we cache it for each inferior. */
379 struct type *tsd_type;
381 /* The exception_support_info data. This data is used to determine
382 how to implement support for Ada exception catchpoints in a given
384 const struct exception_support_info *exception_info;
387 /* Our key to this module's inferior data. */
388 static const struct inferior_data *ada_inferior_data;
390 /* A cleanup routine for our inferior data. */
392 ada_inferior_data_cleanup (struct inferior *inf, void *arg)
394 struct ada_inferior_data *data;
396 data = (struct ada_inferior_data *) inferior_data (inf, ada_inferior_data);
401 /* Return our inferior data for the given inferior (INF).
403 This function always returns a valid pointer to an allocated
404 ada_inferior_data structure. If INF's inferior data has not
405 been previously set, this functions creates a new one with all
406 fields set to zero, sets INF's inferior to it, and then returns
407 a pointer to that newly allocated ada_inferior_data. */
409 static struct ada_inferior_data *
410 get_ada_inferior_data (struct inferior *inf)
412 struct ada_inferior_data *data;
414 data = (struct ada_inferior_data *) inferior_data (inf, ada_inferior_data);
417 data = XCNEW (struct ada_inferior_data);
418 set_inferior_data (inf, ada_inferior_data, data);
424 /* Perform all necessary cleanups regarding our module's inferior data
425 that is required after the inferior INF just exited. */
428 ada_inferior_exit (struct inferior *inf)
430 ada_inferior_data_cleanup (inf, NULL);
431 set_inferior_data (inf, ada_inferior_data, NULL);
435 /* program-space-specific data. */
437 /* This module's per-program-space data. */
438 struct ada_pspace_data
440 /* The Ada symbol cache. */
441 struct ada_symbol_cache *sym_cache;
444 /* Key to our per-program-space data. */
445 static const struct program_space_data *ada_pspace_data_handle;
447 /* Return this module's data for the given program space (PSPACE).
448 If not is found, add a zero'ed one now.
450 This function always returns a valid object. */
452 static struct ada_pspace_data *
453 get_ada_pspace_data (struct program_space *pspace)
455 struct ada_pspace_data *data;
457 data = ((struct ada_pspace_data *)
458 program_space_data (pspace, ada_pspace_data_handle));
461 data = XCNEW (struct ada_pspace_data);
462 set_program_space_data (pspace, ada_pspace_data_handle, data);
468 /* The cleanup callback for this module's per-program-space data. */
471 ada_pspace_data_cleanup (struct program_space *pspace, void *data)
473 struct ada_pspace_data *pspace_data = (struct ada_pspace_data *) data;
475 if (pspace_data->sym_cache != NULL)
476 ada_free_symbol_cache (pspace_data->sym_cache);
482 /* If TYPE is a TYPE_CODE_TYPEDEF type, return the target type after
483 all typedef layers have been peeled. Otherwise, return TYPE.
485 Normally, we really expect a typedef type to only have 1 typedef layer.
486 In other words, we really expect the target type of a typedef type to be
487 a non-typedef type. This is particularly true for Ada units, because
488 the language does not have a typedef vs not-typedef distinction.
489 In that respect, the Ada compiler has been trying to eliminate as many
490 typedef definitions in the debugging information, since they generally
491 do not bring any extra information (we still use typedef under certain
492 circumstances related mostly to the GNAT encoding).
494 Unfortunately, we have seen situations where the debugging information
495 generated by the compiler leads to such multiple typedef layers. For
496 instance, consider the following example with stabs:
498 .stabs "pck__float_array___XUP:Tt(0,46)=s16P_ARRAY:(0,47)=[...]"[...]
499 .stabs "pck__float_array___XUP:t(0,36)=(0,46)",128,0,6,0
501 This is an error in the debugging information which causes type
502 pck__float_array___XUP to be defined twice, and the second time,
503 it is defined as a typedef of a typedef.
505 This is on the fringe of legality as far as debugging information is
506 concerned, and certainly unexpected. But it is easy to handle these
507 situations correctly, so we can afford to be lenient in this case. */
510 ada_typedef_target_type (struct type *type)
512 while (TYPE_CODE (type) == TYPE_CODE_TYPEDEF)
513 type = TYPE_TARGET_TYPE (type);
517 /* Given DECODED_NAME a string holding a symbol name in its
518 decoded form (ie using the Ada dotted notation), returns
519 its unqualified name. */
522 ada_unqualified_name (const char *decoded_name)
526 /* If the decoded name starts with '<', it means that the encoded
527 name does not follow standard naming conventions, and thus that
528 it is not your typical Ada symbol name. Trying to unqualify it
529 is therefore pointless and possibly erroneous. */
530 if (decoded_name[0] == '<')
533 result = strrchr (decoded_name, '.');
535 result++; /* Skip the dot... */
537 result = decoded_name;
542 /* Return a string starting with '<', followed by STR, and '>'. */
545 add_angle_brackets (const char *str)
547 return string_printf ("<%s>", str);
551 ada_get_gdb_completer_word_break_characters (void)
553 return ada_completer_word_break_characters;
556 /* Print an array element index using the Ada syntax. */
559 ada_print_array_index (struct value *index_value, struct ui_file *stream,
560 const struct value_print_options *options)
562 LA_VALUE_PRINT (index_value, stream, options);
563 fprintf_filtered (stream, " => ");
566 /* la_watch_location_expression for Ada. */
568 gdb::unique_xmalloc_ptr<char>
569 ada_watch_location_expression (struct type *type, CORE_ADDR addr)
571 type = check_typedef (TYPE_TARGET_TYPE (check_typedef (type)));
572 std::string name = type_to_string (type);
573 return gdb::unique_xmalloc_ptr<char>
574 (xstrprintf ("{%s} %s", name.c_str (), core_addr_to_string (addr)));
577 /* Assuming VECT points to an array of *SIZE objects of size
578 ELEMENT_SIZE, grow it to contain at least MIN_SIZE objects,
579 updating *SIZE as necessary and returning the (new) array. */
582 grow_vect (void *vect, size_t *size, size_t min_size, int element_size)
584 if (*size < min_size)
587 if (*size < min_size)
589 vect = xrealloc (vect, *size * element_size);
594 /* True (non-zero) iff TARGET matches FIELD_NAME up to any trailing
595 suffix of FIELD_NAME beginning "___". */
598 field_name_match (const char *field_name, const char *target)
600 int len = strlen (target);
603 (strncmp (field_name, target, len) == 0
604 && (field_name[len] == '\0'
605 || (startswith (field_name + len, "___")
606 && strcmp (field_name + strlen (field_name) - 6,
611 /* Assuming TYPE is a TYPE_CODE_STRUCT or a TYPE_CODE_TYPDEF to
612 a TYPE_CODE_STRUCT, find the field whose name matches FIELD_NAME,
613 and return its index. This function also handles fields whose name
614 have ___ suffixes because the compiler sometimes alters their name
615 by adding such a suffix to represent fields with certain constraints.
616 If the field could not be found, return a negative number if
617 MAYBE_MISSING is set. Otherwise raise an error. */
620 ada_get_field_index (const struct type *type, const char *field_name,
624 struct type *struct_type = check_typedef ((struct type *) type);
626 for (fieldno = 0; fieldno < TYPE_NFIELDS (struct_type); fieldno++)
627 if (field_name_match (TYPE_FIELD_NAME (struct_type, fieldno), field_name))
631 error (_("Unable to find field %s in struct %s. Aborting"),
632 field_name, TYPE_NAME (struct_type));
637 /* The length of the prefix of NAME prior to any "___" suffix. */
640 ada_name_prefix_len (const char *name)
646 const char *p = strstr (name, "___");
649 return strlen (name);
655 /* Return non-zero if SUFFIX is a suffix of STR.
656 Return zero if STR is null. */
659 is_suffix (const char *str, const char *suffix)
666 len2 = strlen (suffix);
667 return (len1 >= len2 && strcmp (str + len1 - len2, suffix) == 0);
670 /* The contents of value VAL, treated as a value of type TYPE. The
671 result is an lval in memory if VAL is. */
673 static struct value *
674 coerce_unspec_val_to_type (struct value *val, struct type *type)
676 type = ada_check_typedef (type);
677 if (value_type (val) == type)
681 struct value *result;
683 /* Make sure that the object size is not unreasonable before
684 trying to allocate some memory for it. */
685 ada_ensure_varsize_limit (type);
688 || TYPE_LENGTH (type) > TYPE_LENGTH (value_type (val)))
689 result = allocate_value_lazy (type);
692 result = allocate_value (type);
693 value_contents_copy_raw (result, 0, val, 0, TYPE_LENGTH (type));
695 set_value_component_location (result, val);
696 set_value_bitsize (result, value_bitsize (val));
697 set_value_bitpos (result, value_bitpos (val));
698 set_value_address (result, value_address (val));
703 static const gdb_byte *
704 cond_offset_host (const gdb_byte *valaddr, long offset)
709 return valaddr + offset;
713 cond_offset_target (CORE_ADDR address, long offset)
718 return address + offset;
721 /* Issue a warning (as for the definition of warning in utils.c, but
722 with exactly one argument rather than ...), unless the limit on the
723 number of warnings has passed during the evaluation of the current
726 /* FIXME: cagney/2004-10-10: This function is mimicking the behavior
727 provided by "complaint". */
728 static void lim_warning (const char *format, ...) ATTRIBUTE_PRINTF (1, 2);
731 lim_warning (const char *format, ...)
735 va_start (args, format);
736 warnings_issued += 1;
737 if (warnings_issued <= warning_limit)
738 vwarning (format, args);
743 /* Issue an error if the size of an object of type T is unreasonable,
744 i.e. if it would be a bad idea to allocate a value of this type in
748 ada_ensure_varsize_limit (const struct type *type)
750 if (TYPE_LENGTH (type) > varsize_limit)
751 error (_("object size is larger than varsize-limit"));
754 /* Maximum value of a SIZE-byte signed integer type. */
756 max_of_size (int size)
758 LONGEST top_bit = (LONGEST) 1 << (size * 8 - 2);
760 return top_bit | (top_bit - 1);
763 /* Minimum value of a SIZE-byte signed integer type. */
765 min_of_size (int size)
767 return -max_of_size (size) - 1;
770 /* Maximum value of a SIZE-byte unsigned integer type. */
772 umax_of_size (int size)
774 ULONGEST top_bit = (ULONGEST) 1 << (size * 8 - 1);
776 return top_bit | (top_bit - 1);
779 /* Maximum value of integral type T, as a signed quantity. */
781 max_of_type (struct type *t)
783 if (TYPE_UNSIGNED (t))
784 return (LONGEST) umax_of_size (TYPE_LENGTH (t));
786 return max_of_size (TYPE_LENGTH (t));
789 /* Minimum value of integral type T, as a signed quantity. */
791 min_of_type (struct type *t)
793 if (TYPE_UNSIGNED (t))
796 return min_of_size (TYPE_LENGTH (t));
799 /* The largest value in the domain of TYPE, a discrete type, as an integer. */
801 ada_discrete_type_high_bound (struct type *type)
803 type = resolve_dynamic_type (type, NULL, 0);
804 switch (TYPE_CODE (type))
806 case TYPE_CODE_RANGE:
807 return TYPE_HIGH_BOUND (type);
809 return TYPE_FIELD_ENUMVAL (type, TYPE_NFIELDS (type) - 1);
814 return max_of_type (type);
816 error (_("Unexpected type in ada_discrete_type_high_bound."));
820 /* The smallest value in the domain of TYPE, a discrete type, as an integer. */
822 ada_discrete_type_low_bound (struct type *type)
824 type = resolve_dynamic_type (type, NULL, 0);
825 switch (TYPE_CODE (type))
827 case TYPE_CODE_RANGE:
828 return TYPE_LOW_BOUND (type);
830 return TYPE_FIELD_ENUMVAL (type, 0);
835 return min_of_type (type);
837 error (_("Unexpected type in ada_discrete_type_low_bound."));
841 /* The identity on non-range types. For range types, the underlying
842 non-range scalar type. */
845 get_base_type (struct type *type)
847 while (type != NULL && TYPE_CODE (type) == TYPE_CODE_RANGE)
849 if (type == TYPE_TARGET_TYPE (type) || TYPE_TARGET_TYPE (type) == NULL)
851 type = TYPE_TARGET_TYPE (type);
856 /* Return a decoded version of the given VALUE. This means returning
857 a value whose type is obtained by applying all the GNAT-specific
858 encondings, making the resulting type a static but standard description
859 of the initial type. */
862 ada_get_decoded_value (struct value *value)
864 struct type *type = ada_check_typedef (value_type (value));
866 if (ada_is_array_descriptor_type (type)
867 || (ada_is_constrained_packed_array_type (type)
868 && TYPE_CODE (type) != TYPE_CODE_PTR))
870 if (TYPE_CODE (type) == TYPE_CODE_TYPEDEF) /* array access type. */
871 value = ada_coerce_to_simple_array_ptr (value);
873 value = ada_coerce_to_simple_array (value);
876 value = ada_to_fixed_value (value);
881 /* Same as ada_get_decoded_value, but with the given TYPE.
882 Because there is no associated actual value for this type,
883 the resulting type might be a best-effort approximation in
884 the case of dynamic types. */
887 ada_get_decoded_type (struct type *type)
889 type = to_static_fixed_type (type);
890 if (ada_is_constrained_packed_array_type (type))
891 type = ada_coerce_to_simple_array_type (type);
897 /* Language Selection */
899 /* If the main program is in Ada, return language_ada, otherwise return LANG
900 (the main program is in Ada iif the adainit symbol is found). */
903 ada_update_initial_language (enum language lang)
905 if (lookup_minimal_symbol ("adainit", (const char *) NULL,
906 (struct objfile *) NULL).minsym != NULL)
912 /* If the main procedure is written in Ada, then return its name.
913 The result is good until the next call. Return NULL if the main
914 procedure doesn't appear to be in Ada. */
919 struct bound_minimal_symbol msym;
920 static gdb::unique_xmalloc_ptr<char> main_program_name;
922 /* For Ada, the name of the main procedure is stored in a specific
923 string constant, generated by the binder. Look for that symbol,
924 extract its address, and then read that string. If we didn't find
925 that string, then most probably the main procedure is not written
927 msym = lookup_minimal_symbol (ADA_MAIN_PROGRAM_SYMBOL_NAME, NULL, NULL);
929 if (msym.minsym != NULL)
931 CORE_ADDR main_program_name_addr;
934 main_program_name_addr = BMSYMBOL_VALUE_ADDRESS (msym);
935 if (main_program_name_addr == 0)
936 error (_("Invalid address for Ada main program name."));
938 target_read_string (main_program_name_addr, &main_program_name,
943 return main_program_name.get ();
946 /* The main procedure doesn't seem to be in Ada. */
952 /* Table of Ada operators and their GNAT-encoded names. Last entry is pair
955 const struct ada_opname_map ada_opname_table[] = {
956 {"Oadd", "\"+\"", BINOP_ADD},
957 {"Osubtract", "\"-\"", BINOP_SUB},
958 {"Omultiply", "\"*\"", BINOP_MUL},
959 {"Odivide", "\"/\"", BINOP_DIV},
960 {"Omod", "\"mod\"", BINOP_MOD},
961 {"Orem", "\"rem\"", BINOP_REM},
962 {"Oexpon", "\"**\"", BINOP_EXP},
963 {"Olt", "\"<\"", BINOP_LESS},
964 {"Ole", "\"<=\"", BINOP_LEQ},
965 {"Ogt", "\">\"", BINOP_GTR},
966 {"Oge", "\">=\"", BINOP_GEQ},
967 {"Oeq", "\"=\"", BINOP_EQUAL},
968 {"One", "\"/=\"", BINOP_NOTEQUAL},
969 {"Oand", "\"and\"", BINOP_BITWISE_AND},
970 {"Oor", "\"or\"", BINOP_BITWISE_IOR},
971 {"Oxor", "\"xor\"", BINOP_BITWISE_XOR},
972 {"Oconcat", "\"&\"", BINOP_CONCAT},
973 {"Oabs", "\"abs\"", UNOP_ABS},
974 {"Onot", "\"not\"", UNOP_LOGICAL_NOT},
975 {"Oadd", "\"+\"", UNOP_PLUS},
976 {"Osubtract", "\"-\"", UNOP_NEG},
980 /* The "encoded" form of DECODED, according to GNAT conventions. The
981 result is valid until the next call to ada_encode. If
982 THROW_ERRORS, throw an error if invalid operator name is found.
983 Otherwise, return NULL in that case. */
986 ada_encode_1 (const char *decoded, bool throw_errors)
988 static char *encoding_buffer = NULL;
989 static size_t encoding_buffer_size = 0;
996 GROW_VECT (encoding_buffer, encoding_buffer_size,
997 2 * strlen (decoded) + 10);
1000 for (p = decoded; *p != '\0'; p += 1)
1004 encoding_buffer[k] = encoding_buffer[k + 1] = '_';
1009 const struct ada_opname_map *mapping;
1011 for (mapping = ada_opname_table;
1012 mapping->encoded != NULL
1013 && !startswith (p, mapping->decoded); mapping += 1)
1015 if (mapping->encoded == NULL)
1018 error (_("invalid Ada operator name: %s"), p);
1022 strcpy (encoding_buffer + k, mapping->encoded);
1023 k += strlen (mapping->encoded);
1028 encoding_buffer[k] = *p;
1033 encoding_buffer[k] = '\0';
1034 return encoding_buffer;
1037 /* The "encoded" form of DECODED, according to GNAT conventions.
1038 The result is valid until the next call to ada_encode. */
1041 ada_encode (const char *decoded)
1043 return ada_encode_1 (decoded, true);
1046 /* Return NAME folded to lower case, or, if surrounded by single
1047 quotes, unfolded, but with the quotes stripped away. Result good
1051 ada_fold_name (const char *name)
1053 static char *fold_buffer = NULL;
1054 static size_t fold_buffer_size = 0;
1056 int len = strlen (name);
1057 GROW_VECT (fold_buffer, fold_buffer_size, len + 1);
1059 if (name[0] == '\'')
1061 strncpy (fold_buffer, name + 1, len - 2);
1062 fold_buffer[len - 2] = '\000';
1068 for (i = 0; i <= len; i += 1)
1069 fold_buffer[i] = tolower (name[i]);
1075 /* Return nonzero if C is either a digit or a lowercase alphabet character. */
1078 is_lower_alphanum (const char c)
1080 return (isdigit (c) || (isalpha (c) && islower (c)));
1083 /* ENCODED is the linkage name of a symbol and LEN contains its length.
1084 This function saves in LEN the length of that same symbol name but
1085 without either of these suffixes:
1091 These are suffixes introduced by the compiler for entities such as
1092 nested subprogram for instance, in order to avoid name clashes.
1093 They do not serve any purpose for the debugger. */
1096 ada_remove_trailing_digits (const char *encoded, int *len)
1098 if (*len > 1 && isdigit (encoded[*len - 1]))
1102 while (i > 0 && isdigit (encoded[i]))
1104 if (i >= 0 && encoded[i] == '.')
1106 else if (i >= 0 && encoded[i] == '$')
1108 else if (i >= 2 && startswith (encoded + i - 2, "___"))
1110 else if (i >= 1 && startswith (encoded + i - 1, "__"))
1115 /* Remove the suffix introduced by the compiler for protected object
1119 ada_remove_po_subprogram_suffix (const char *encoded, int *len)
1121 /* Remove trailing N. */
1123 /* Protected entry subprograms are broken into two
1124 separate subprograms: The first one is unprotected, and has
1125 a 'N' suffix; the second is the protected version, and has
1126 the 'P' suffix. The second calls the first one after handling
1127 the protection. Since the P subprograms are internally generated,
1128 we leave these names undecoded, giving the user a clue that this
1129 entity is internal. */
1132 && encoded[*len - 1] == 'N'
1133 && (isdigit (encoded[*len - 2]) || islower (encoded[*len - 2])))
1137 /* Remove trailing X[bn]* suffixes (indicating names in package bodies). */
1140 ada_remove_Xbn_suffix (const char *encoded, int *len)
1144 while (i > 0 && (encoded[i] == 'b' || encoded[i] == 'n'))
1147 if (encoded[i] != 'X')
1153 if (isalnum (encoded[i-1]))
1157 /* If ENCODED follows the GNAT entity encoding conventions, then return
1158 the decoded form of ENCODED. Otherwise, return "<%s>" where "%s" is
1159 replaced by ENCODED.
1161 The resulting string is valid until the next call of ada_decode.
1162 If the string is unchanged by decoding, the original string pointer
1166 ada_decode (const char *encoded)
1173 static char *decoding_buffer = NULL;
1174 static size_t decoding_buffer_size = 0;
1176 /* With function descriptors on PPC64, the value of a symbol named
1177 ".FN", if it exists, is the entry point of the function "FN". */
1178 if (encoded[0] == '.')
1181 /* The name of the Ada main procedure starts with "_ada_".
1182 This prefix is not part of the decoded name, so skip this part
1183 if we see this prefix. */
1184 if (startswith (encoded, "_ada_"))
1187 /* If the name starts with '_', then it is not a properly encoded
1188 name, so do not attempt to decode it. Similarly, if the name
1189 starts with '<', the name should not be decoded. */
1190 if (encoded[0] == '_' || encoded[0] == '<')
1193 len0 = strlen (encoded);
1195 ada_remove_trailing_digits (encoded, &len0);
1196 ada_remove_po_subprogram_suffix (encoded, &len0);
1198 /* Remove the ___X.* suffix if present. Do not forget to verify that
1199 the suffix is located before the current "end" of ENCODED. We want
1200 to avoid re-matching parts of ENCODED that have previously been
1201 marked as discarded (by decrementing LEN0). */
1202 p = strstr (encoded, "___");
1203 if (p != NULL && p - encoded < len0 - 3)
1211 /* Remove any trailing TKB suffix. It tells us that this symbol
1212 is for the body of a task, but that information does not actually
1213 appear in the decoded name. */
1215 if (len0 > 3 && startswith (encoded + len0 - 3, "TKB"))
1218 /* Remove any trailing TB suffix. The TB suffix is slightly different
1219 from the TKB suffix because it is used for non-anonymous task
1222 if (len0 > 2 && startswith (encoded + len0 - 2, "TB"))
1225 /* Remove trailing "B" suffixes. */
1226 /* FIXME: brobecker/2006-04-19: Not sure what this are used for... */
1228 if (len0 > 1 && startswith (encoded + len0 - 1, "B"))
1231 /* Make decoded big enough for possible expansion by operator name. */
1233 GROW_VECT (decoding_buffer, decoding_buffer_size, 2 * len0 + 1);
1234 decoded = decoding_buffer;
1236 /* Remove trailing __{digit}+ or trailing ${digit}+. */
1238 if (len0 > 1 && isdigit (encoded[len0 - 1]))
1241 while ((i >= 0 && isdigit (encoded[i]))
1242 || (i >= 1 && encoded[i] == '_' && isdigit (encoded[i - 1])))
1244 if (i > 1 && encoded[i] == '_' && encoded[i - 1] == '_')
1246 else if (encoded[i] == '$')
1250 /* The first few characters that are not alphabetic are not part
1251 of any encoding we use, so we can copy them over verbatim. */
1253 for (i = 0, j = 0; i < len0 && !isalpha (encoded[i]); i += 1, j += 1)
1254 decoded[j] = encoded[i];
1259 /* Is this a symbol function? */
1260 if (at_start_name && encoded[i] == 'O')
1264 for (k = 0; ada_opname_table[k].encoded != NULL; k += 1)
1266 int op_len = strlen (ada_opname_table[k].encoded);
1267 if ((strncmp (ada_opname_table[k].encoded + 1, encoded + i + 1,
1269 && !isalnum (encoded[i + op_len]))
1271 strcpy (decoded + j, ada_opname_table[k].decoded);
1274 j += strlen (ada_opname_table[k].decoded);
1278 if (ada_opname_table[k].encoded != NULL)
1283 /* Replace "TK__" with "__", which will eventually be translated
1284 into "." (just below). */
1286 if (i < len0 - 4 && startswith (encoded + i, "TK__"))
1289 /* Replace "__B_{DIGITS}+__" sequences by "__", which will eventually
1290 be translated into "." (just below). These are internal names
1291 generated for anonymous blocks inside which our symbol is nested. */
1293 if (len0 - i > 5 && encoded [i] == '_' && encoded [i+1] == '_'
1294 && encoded [i+2] == 'B' && encoded [i+3] == '_'
1295 && isdigit (encoded [i+4]))
1299 while (k < len0 && isdigit (encoded[k]))
1300 k++; /* Skip any extra digit. */
1302 /* Double-check that the "__B_{DIGITS}+" sequence we found
1303 is indeed followed by "__". */
1304 if (len0 - k > 2 && encoded [k] == '_' && encoded [k+1] == '_')
1308 /* Remove _E{DIGITS}+[sb] */
1310 /* Just as for protected object subprograms, there are 2 categories
1311 of subprograms created by the compiler for each entry. The first
1312 one implements the actual entry code, and has a suffix following
1313 the convention above; the second one implements the barrier and
1314 uses the same convention as above, except that the 'E' is replaced
1317 Just as above, we do not decode the name of barrier functions
1318 to give the user a clue that the code he is debugging has been
1319 internally generated. */
1321 if (len0 - i > 3 && encoded [i] == '_' && encoded[i+1] == 'E'
1322 && isdigit (encoded[i+2]))
1326 while (k < len0 && isdigit (encoded[k]))
1330 && (encoded[k] == 'b' || encoded[k] == 's'))
1333 /* Just as an extra precaution, make sure that if this
1334 suffix is followed by anything else, it is a '_'.
1335 Otherwise, we matched this sequence by accident. */
1337 || (k < len0 && encoded[k] == '_'))
1342 /* Remove trailing "N" in [a-z0-9]+N__. The N is added by
1343 the GNAT front-end in protected object subprograms. */
1346 && encoded[i] == 'N' && encoded[i+1] == '_' && encoded[i+2] == '_')
1348 /* Backtrack a bit up until we reach either the begining of
1349 the encoded name, or "__". Make sure that we only find
1350 digits or lowercase characters. */
1351 const char *ptr = encoded + i - 1;
1353 while (ptr >= encoded && is_lower_alphanum (ptr[0]))
1356 || (ptr > encoded && ptr[0] == '_' && ptr[-1] == '_'))
1360 if (encoded[i] == 'X' && i != 0 && isalnum (encoded[i - 1]))
1362 /* This is a X[bn]* sequence not separated from the previous
1363 part of the name with a non-alpha-numeric character (in other
1364 words, immediately following an alpha-numeric character), then
1365 verify that it is placed at the end of the encoded name. If
1366 not, then the encoding is not valid and we should abort the
1367 decoding. Otherwise, just skip it, it is used in body-nested
1371 while (i < len0 && (encoded[i] == 'b' || encoded[i] == 'n'));
1375 else if (i < len0 - 2 && encoded[i] == '_' && encoded[i + 1] == '_')
1377 /* Replace '__' by '.'. */
1385 /* It's a character part of the decoded name, so just copy it
1387 decoded[j] = encoded[i];
1392 decoded[j] = '\000';
1394 /* Decoded names should never contain any uppercase character.
1395 Double-check this, and abort the decoding if we find one. */
1397 for (i = 0; decoded[i] != '\0'; i += 1)
1398 if (isupper (decoded[i]) || decoded[i] == ' ')
1401 if (strcmp (decoded, encoded) == 0)
1407 GROW_VECT (decoding_buffer, decoding_buffer_size, strlen (encoded) + 3);
1408 decoded = decoding_buffer;
1409 if (encoded[0] == '<')
1410 strcpy (decoded, encoded);
1412 xsnprintf (decoded, decoding_buffer_size, "<%s>", encoded);
1417 /* Table for keeping permanent unique copies of decoded names. Once
1418 allocated, names in this table are never released. While this is a
1419 storage leak, it should not be significant unless there are massive
1420 changes in the set of decoded names in successive versions of a
1421 symbol table loaded during a single session. */
1422 static struct htab *decoded_names_store;
1424 /* Returns the decoded name of GSYMBOL, as for ada_decode, caching it
1425 in the language-specific part of GSYMBOL, if it has not been
1426 previously computed. Tries to save the decoded name in the same
1427 obstack as GSYMBOL, if possible, and otherwise on the heap (so that,
1428 in any case, the decoded symbol has a lifetime at least that of
1430 The GSYMBOL parameter is "mutable" in the C++ sense: logically
1431 const, but nevertheless modified to a semantically equivalent form
1432 when a decoded name is cached in it. */
1435 ada_decode_symbol (const struct general_symbol_info *arg)
1437 struct general_symbol_info *gsymbol = (struct general_symbol_info *) arg;
1438 const char **resultp =
1439 &gsymbol->language_specific.demangled_name;
1441 if (!gsymbol->ada_mangled)
1443 const char *decoded = ada_decode (gsymbol->name);
1444 struct obstack *obstack = gsymbol->language_specific.obstack;
1446 gsymbol->ada_mangled = 1;
1448 if (obstack != NULL)
1450 = (const char *) obstack_copy0 (obstack, decoded, strlen (decoded));
1453 /* Sometimes, we can't find a corresponding objfile, in
1454 which case, we put the result on the heap. Since we only
1455 decode when needed, we hope this usually does not cause a
1456 significant memory leak (FIXME). */
1458 char **slot = (char **) htab_find_slot (decoded_names_store,
1462 *slot = xstrdup (decoded);
1471 ada_la_decode (const char *encoded, int options)
1473 return xstrdup (ada_decode (encoded));
1476 /* Implement la_sniff_from_mangled_name for Ada. */
1479 ada_sniff_from_mangled_name (const char *mangled, char **out)
1481 const char *demangled = ada_decode (mangled);
1485 if (demangled != mangled && demangled != NULL && demangled[0] != '<')
1487 /* Set the gsymbol language to Ada, but still return 0.
1488 Two reasons for that:
1490 1. For Ada, we prefer computing the symbol's decoded name
1491 on the fly rather than pre-compute it, in order to save
1492 memory (Ada projects are typically very large).
1494 2. There are some areas in the definition of the GNAT
1495 encoding where, with a bit of bad luck, we might be able
1496 to decode a non-Ada symbol, generating an incorrect
1497 demangled name (Eg: names ending with "TB" for instance
1498 are identified as task bodies and so stripped from
1499 the decoded name returned).
1501 Returning 1, here, but not setting *DEMANGLED, helps us get a
1502 little bit of the best of both worlds. Because we're last,
1503 we should not affect any of the other languages that were
1504 able to demangle the symbol before us; we get to correctly
1505 tag Ada symbols as such; and even if we incorrectly tagged a
1506 non-Ada symbol, which should be rare, any routing through the
1507 Ada language should be transparent (Ada tries to behave much
1508 like C/C++ with non-Ada symbols). */
1519 /* Assuming that INDEX_DESC_TYPE is an ___XA structure, a structure
1520 generated by the GNAT compiler to describe the index type used
1521 for each dimension of an array, check whether it follows the latest
1522 known encoding. If not, fix it up to conform to the latest encoding.
1523 Otherwise, do nothing. This function also does nothing if
1524 INDEX_DESC_TYPE is NULL.
1526 The GNAT encoding used to describle the array index type evolved a bit.
1527 Initially, the information would be provided through the name of each
1528 field of the structure type only, while the type of these fields was
1529 described as unspecified and irrelevant. The debugger was then expected
1530 to perform a global type lookup using the name of that field in order
1531 to get access to the full index type description. Because these global
1532 lookups can be very expensive, the encoding was later enhanced to make
1533 the global lookup unnecessary by defining the field type as being
1534 the full index type description.
1536 The purpose of this routine is to allow us to support older versions
1537 of the compiler by detecting the use of the older encoding, and by
1538 fixing up the INDEX_DESC_TYPE to follow the new one (at this point,
1539 we essentially replace each field's meaningless type by the associated
1543 ada_fixup_array_indexes_type (struct type *index_desc_type)
1547 if (index_desc_type == NULL)
1549 gdb_assert (TYPE_NFIELDS (index_desc_type) > 0);
1551 /* Check if INDEX_DESC_TYPE follows the older encoding (it is sufficient
1552 to check one field only, no need to check them all). If not, return
1555 If our INDEX_DESC_TYPE was generated using the older encoding,
1556 the field type should be a meaningless integer type whose name
1557 is not equal to the field name. */
1558 if (TYPE_NAME (TYPE_FIELD_TYPE (index_desc_type, 0)) != NULL
1559 && strcmp (TYPE_NAME (TYPE_FIELD_TYPE (index_desc_type, 0)),
1560 TYPE_FIELD_NAME (index_desc_type, 0)) == 0)
1563 /* Fixup each field of INDEX_DESC_TYPE. */
1564 for (i = 0; i < TYPE_NFIELDS (index_desc_type); i++)
1566 const char *name = TYPE_FIELD_NAME (index_desc_type, i);
1567 struct type *raw_type = ada_check_typedef (ada_find_any_type (name));
1570 TYPE_FIELD_TYPE (index_desc_type, i) = raw_type;
1574 /* Names of MAX_ADA_DIMENS bounds in P_BOUNDS fields of array descriptors. */
1576 static const char *bound_name[] = {
1577 "LB0", "UB0", "LB1", "UB1", "LB2", "UB2", "LB3", "UB3",
1578 "LB4", "UB4", "LB5", "UB5", "LB6", "UB6", "LB7", "UB7"
1581 /* Maximum number of array dimensions we are prepared to handle. */
1583 #define MAX_ADA_DIMENS (sizeof(bound_name) / (2*sizeof(char *)))
1586 /* The desc_* routines return primitive portions of array descriptors
1589 /* The descriptor or array type, if any, indicated by TYPE; removes
1590 level of indirection, if needed. */
1592 static struct type *
1593 desc_base_type (struct type *type)
1597 type = ada_check_typedef (type);
1598 if (TYPE_CODE (type) == TYPE_CODE_TYPEDEF)
1599 type = ada_typedef_target_type (type);
1602 && (TYPE_CODE (type) == TYPE_CODE_PTR
1603 || TYPE_CODE (type) == TYPE_CODE_REF))
1604 return ada_check_typedef (TYPE_TARGET_TYPE (type));
1609 /* True iff TYPE indicates a "thin" array pointer type. */
1612 is_thin_pntr (struct type *type)
1615 is_suffix (ada_type_name (desc_base_type (type)), "___XUT")
1616 || is_suffix (ada_type_name (desc_base_type (type)), "___XUT___XVE");
1619 /* The descriptor type for thin pointer type TYPE. */
1621 static struct type *
1622 thin_descriptor_type (struct type *type)
1624 struct type *base_type = desc_base_type (type);
1626 if (base_type == NULL)
1628 if (is_suffix (ada_type_name (base_type), "___XVE"))
1632 struct type *alt_type = ada_find_parallel_type (base_type, "___XVE");
1634 if (alt_type == NULL)
1641 /* A pointer to the array data for thin-pointer value VAL. */
1643 static struct value *
1644 thin_data_pntr (struct value *val)
1646 struct type *type = ada_check_typedef (value_type (val));
1647 struct type *data_type = desc_data_target_type (thin_descriptor_type (type));
1649 data_type = lookup_pointer_type (data_type);
1651 if (TYPE_CODE (type) == TYPE_CODE_PTR)
1652 return value_cast (data_type, value_copy (val));
1654 return value_from_longest (data_type, value_address (val));
1657 /* True iff TYPE indicates a "thick" array pointer type. */
1660 is_thick_pntr (struct type *type)
1662 type = desc_base_type (type);
1663 return (type != NULL && TYPE_CODE (type) == TYPE_CODE_STRUCT
1664 && lookup_struct_elt_type (type, "P_BOUNDS", 1) != NULL);
1667 /* If TYPE is the type of an array descriptor (fat or thin pointer) or a
1668 pointer to one, the type of its bounds data; otherwise, NULL. */
1670 static struct type *
1671 desc_bounds_type (struct type *type)
1675 type = desc_base_type (type);
1679 else if (is_thin_pntr (type))
1681 type = thin_descriptor_type (type);
1684 r = lookup_struct_elt_type (type, "BOUNDS", 1);
1686 return ada_check_typedef (r);
1688 else if (TYPE_CODE (type) == TYPE_CODE_STRUCT)
1690 r = lookup_struct_elt_type (type, "P_BOUNDS", 1);
1692 return ada_check_typedef (TYPE_TARGET_TYPE (ada_check_typedef (r)));
1697 /* If ARR is an array descriptor (fat or thin pointer), or pointer to
1698 one, a pointer to its bounds data. Otherwise NULL. */
1700 static struct value *
1701 desc_bounds (struct value *arr)
1703 struct type *type = ada_check_typedef (value_type (arr));
1705 if (is_thin_pntr (type))
1707 struct type *bounds_type =
1708 desc_bounds_type (thin_descriptor_type (type));
1711 if (bounds_type == NULL)
1712 error (_("Bad GNAT array descriptor"));
1714 /* NOTE: The following calculation is not really kosher, but
1715 since desc_type is an XVE-encoded type (and shouldn't be),
1716 the correct calculation is a real pain. FIXME (and fix GCC). */
1717 if (TYPE_CODE (type) == TYPE_CODE_PTR)
1718 addr = value_as_long (arr);
1720 addr = value_address (arr);
1723 value_from_longest (lookup_pointer_type (bounds_type),
1724 addr - TYPE_LENGTH (bounds_type));
1727 else if (is_thick_pntr (type))
1729 struct value *p_bounds = value_struct_elt (&arr, NULL, "P_BOUNDS", NULL,
1730 _("Bad GNAT array descriptor"));
1731 struct type *p_bounds_type = value_type (p_bounds);
1734 && TYPE_CODE (p_bounds_type) == TYPE_CODE_PTR)
1736 struct type *target_type = TYPE_TARGET_TYPE (p_bounds_type);
1738 if (TYPE_STUB (target_type))
1739 p_bounds = value_cast (lookup_pointer_type
1740 (ada_check_typedef (target_type)),
1744 error (_("Bad GNAT array descriptor"));
1752 /* If TYPE is the type of an array-descriptor (fat pointer), the bit
1753 position of the field containing the address of the bounds data. */
1756 fat_pntr_bounds_bitpos (struct type *type)
1758 return TYPE_FIELD_BITPOS (desc_base_type (type), 1);
1761 /* If TYPE is the type of an array-descriptor (fat pointer), the bit
1762 size of the field containing the address of the bounds data. */
1765 fat_pntr_bounds_bitsize (struct type *type)
1767 type = desc_base_type (type);
1769 if (TYPE_FIELD_BITSIZE (type, 1) > 0)
1770 return TYPE_FIELD_BITSIZE (type, 1);
1772 return 8 * TYPE_LENGTH (ada_check_typedef (TYPE_FIELD_TYPE (type, 1)));
1775 /* If TYPE is the type of an array descriptor (fat or thin pointer) or a
1776 pointer to one, the type of its array data (a array-with-no-bounds type);
1777 otherwise, NULL. Use ada_type_of_array to get an array type with bounds
1780 static struct type *
1781 desc_data_target_type (struct type *type)
1783 type = desc_base_type (type);
1785 /* NOTE: The following is bogus; see comment in desc_bounds. */
1786 if (is_thin_pntr (type))
1787 return desc_base_type (TYPE_FIELD_TYPE (thin_descriptor_type (type), 1));
1788 else if (is_thick_pntr (type))
1790 struct type *data_type = lookup_struct_elt_type (type, "P_ARRAY", 1);
1793 && TYPE_CODE (ada_check_typedef (data_type)) == TYPE_CODE_PTR)
1794 return ada_check_typedef (TYPE_TARGET_TYPE (data_type));
1800 /* If ARR is an array descriptor (fat or thin pointer), a pointer to
1803 static struct value *
1804 desc_data (struct value *arr)
1806 struct type *type = value_type (arr);
1808 if (is_thin_pntr (type))
1809 return thin_data_pntr (arr);
1810 else if (is_thick_pntr (type))
1811 return value_struct_elt (&arr, NULL, "P_ARRAY", NULL,
1812 _("Bad GNAT array descriptor"));
1818 /* If TYPE is the type of an array-descriptor (fat pointer), the bit
1819 position of the field containing the address of the data. */
1822 fat_pntr_data_bitpos (struct type *type)
1824 return TYPE_FIELD_BITPOS (desc_base_type (type), 0);
1827 /* If TYPE is the type of an array-descriptor (fat pointer), the bit
1828 size of the field containing the address of the data. */
1831 fat_pntr_data_bitsize (struct type *type)
1833 type = desc_base_type (type);
1835 if (TYPE_FIELD_BITSIZE (type, 0) > 0)
1836 return TYPE_FIELD_BITSIZE (type, 0);
1838 return TARGET_CHAR_BIT * TYPE_LENGTH (TYPE_FIELD_TYPE (type, 0));
1841 /* If BOUNDS is an array-bounds structure (or pointer to one), return
1842 the Ith lower bound stored in it, if WHICH is 0, and the Ith upper
1843 bound, if WHICH is 1. The first bound is I=1. */
1845 static struct value *
1846 desc_one_bound (struct value *bounds, int i, int which)
1848 return value_struct_elt (&bounds, NULL, bound_name[2 * i + which - 2], NULL,
1849 _("Bad GNAT array descriptor bounds"));
1852 /* If BOUNDS is an array-bounds structure type, return the bit position
1853 of the Ith lower bound stored in it, if WHICH is 0, and the Ith upper
1854 bound, if WHICH is 1. The first bound is I=1. */
1857 desc_bound_bitpos (struct type *type, int i, int which)
1859 return TYPE_FIELD_BITPOS (desc_base_type (type), 2 * i + which - 2);
1862 /* If BOUNDS is an array-bounds structure type, return the bit field size
1863 of the Ith lower bound stored in it, if WHICH is 0, and the Ith upper
1864 bound, if WHICH is 1. The first bound is I=1. */
1867 desc_bound_bitsize (struct type *type, int i, int which)
1869 type = desc_base_type (type);
1871 if (TYPE_FIELD_BITSIZE (type, 2 * i + which - 2) > 0)
1872 return TYPE_FIELD_BITSIZE (type, 2 * i + which - 2);
1874 return 8 * TYPE_LENGTH (TYPE_FIELD_TYPE (type, 2 * i + which - 2));
1877 /* If TYPE is the type of an array-bounds structure, the type of its
1878 Ith bound (numbering from 1). Otherwise, NULL. */
1880 static struct type *
1881 desc_index_type (struct type *type, int i)
1883 type = desc_base_type (type);
1885 if (TYPE_CODE (type) == TYPE_CODE_STRUCT)
1886 return lookup_struct_elt_type (type, bound_name[2 * i - 2], 1);
1891 /* The number of index positions in the array-bounds type TYPE.
1892 Return 0 if TYPE is NULL. */
1895 desc_arity (struct type *type)
1897 type = desc_base_type (type);
1900 return TYPE_NFIELDS (type) / 2;
1904 /* Non-zero iff TYPE is a simple array type (not a pointer to one) or
1905 an array descriptor type (representing an unconstrained array
1909 ada_is_direct_array_type (struct type *type)
1913 type = ada_check_typedef (type);
1914 return (TYPE_CODE (type) == TYPE_CODE_ARRAY
1915 || ada_is_array_descriptor_type (type));
1918 /* Non-zero iff TYPE represents any kind of array in Ada, or a pointer
1922 ada_is_array_type (struct type *type)
1925 && (TYPE_CODE (type) == TYPE_CODE_PTR
1926 || TYPE_CODE (type) == TYPE_CODE_REF))
1927 type = TYPE_TARGET_TYPE (type);
1928 return ada_is_direct_array_type (type);
1931 /* Non-zero iff TYPE is a simple array type or pointer to one. */
1934 ada_is_simple_array_type (struct type *type)
1938 type = ada_check_typedef (type);
1939 return (TYPE_CODE (type) == TYPE_CODE_ARRAY
1940 || (TYPE_CODE (type) == TYPE_CODE_PTR
1941 && TYPE_CODE (ada_check_typedef (TYPE_TARGET_TYPE (type)))
1942 == TYPE_CODE_ARRAY));
1945 /* Non-zero iff TYPE belongs to a GNAT array descriptor. */
1948 ada_is_array_descriptor_type (struct type *type)
1950 struct type *data_type = desc_data_target_type (type);
1954 type = ada_check_typedef (type);
1955 return (data_type != NULL
1956 && TYPE_CODE (data_type) == TYPE_CODE_ARRAY
1957 && desc_arity (desc_bounds_type (type)) > 0);
1960 /* Non-zero iff type is a partially mal-formed GNAT array
1961 descriptor. FIXME: This is to compensate for some problems with
1962 debugging output from GNAT. Re-examine periodically to see if it
1966 ada_is_bogus_array_descriptor (struct type *type)
1970 && TYPE_CODE (type) == TYPE_CODE_STRUCT
1971 && (lookup_struct_elt_type (type, "P_BOUNDS", 1) != NULL
1972 || lookup_struct_elt_type (type, "P_ARRAY", 1) != NULL)
1973 && !ada_is_array_descriptor_type (type);
1977 /* If ARR has a record type in the form of a standard GNAT array descriptor,
1978 (fat pointer) returns the type of the array data described---specifically,
1979 a pointer-to-array type. If BOUNDS is non-zero, the bounds data are filled
1980 in from the descriptor; otherwise, they are left unspecified. If
1981 the ARR denotes a null array descriptor and BOUNDS is non-zero,
1982 returns NULL. The result is simply the type of ARR if ARR is not
1985 ada_type_of_array (struct value *arr, int bounds)
1987 if (ada_is_constrained_packed_array_type (value_type (arr)))
1988 return decode_constrained_packed_array_type (value_type (arr));
1990 if (!ada_is_array_descriptor_type (value_type (arr)))
1991 return value_type (arr);
1995 struct type *array_type =
1996 ada_check_typedef (desc_data_target_type (value_type (arr)));
1998 if (ada_is_unconstrained_packed_array_type (value_type (arr)))
1999 TYPE_FIELD_BITSIZE (array_type, 0) =
2000 decode_packed_array_bitsize (value_type (arr));
2006 struct type *elt_type;
2008 struct value *descriptor;
2010 elt_type = ada_array_element_type (value_type (arr), -1);
2011 arity = ada_array_arity (value_type (arr));
2013 if (elt_type == NULL || arity == 0)
2014 return ada_check_typedef (value_type (arr));
2016 descriptor = desc_bounds (arr);
2017 if (value_as_long (descriptor) == 0)
2021 struct type *range_type = alloc_type_copy (value_type (arr));
2022 struct type *array_type = alloc_type_copy (value_type (arr));
2023 struct value *low = desc_one_bound (descriptor, arity, 0);
2024 struct value *high = desc_one_bound (descriptor, arity, 1);
2027 create_static_range_type (range_type, value_type (low),
2028 longest_to_int (value_as_long (low)),
2029 longest_to_int (value_as_long (high)));
2030 elt_type = create_array_type (array_type, elt_type, range_type);
2032 if (ada_is_unconstrained_packed_array_type (value_type (arr)))
2034 /* We need to store the element packed bitsize, as well as
2035 recompute the array size, because it was previously
2036 computed based on the unpacked element size. */
2037 LONGEST lo = value_as_long (low);
2038 LONGEST hi = value_as_long (high);
2040 TYPE_FIELD_BITSIZE (elt_type, 0) =
2041 decode_packed_array_bitsize (value_type (arr));
2042 /* If the array has no element, then the size is already
2043 zero, and does not need to be recomputed. */
2047 (hi - lo + 1) * TYPE_FIELD_BITSIZE (elt_type, 0);
2049 TYPE_LENGTH (array_type) = (array_bitsize + 7) / 8;
2054 return lookup_pointer_type (elt_type);
2058 /* If ARR does not represent an array, returns ARR unchanged.
2059 Otherwise, returns either a standard GDB array with bounds set
2060 appropriately or, if ARR is a non-null fat pointer, a pointer to a standard
2061 GDB array. Returns NULL if ARR is a null fat pointer. */
2064 ada_coerce_to_simple_array_ptr (struct value *arr)
2066 if (ada_is_array_descriptor_type (value_type (arr)))
2068 struct type *arrType = ada_type_of_array (arr, 1);
2070 if (arrType == NULL)
2072 return value_cast (arrType, value_copy (desc_data (arr)));
2074 else if (ada_is_constrained_packed_array_type (value_type (arr)))
2075 return decode_constrained_packed_array (arr);
2080 /* If ARR does not represent an array, returns ARR unchanged.
2081 Otherwise, returns a standard GDB array describing ARR (which may
2082 be ARR itself if it already is in the proper form). */
2085 ada_coerce_to_simple_array (struct value *arr)
2087 if (ada_is_array_descriptor_type (value_type (arr)))
2089 struct value *arrVal = ada_coerce_to_simple_array_ptr (arr);
2092 error (_("Bounds unavailable for null array pointer."));
2093 ada_ensure_varsize_limit (TYPE_TARGET_TYPE (value_type (arrVal)));
2094 return value_ind (arrVal);
2096 else if (ada_is_constrained_packed_array_type (value_type (arr)))
2097 return decode_constrained_packed_array (arr);
2102 /* If TYPE represents a GNAT array type, return it translated to an
2103 ordinary GDB array type (possibly with BITSIZE fields indicating
2104 packing). For other types, is the identity. */
2107 ada_coerce_to_simple_array_type (struct type *type)
2109 if (ada_is_constrained_packed_array_type (type))
2110 return decode_constrained_packed_array_type (type);
2112 if (ada_is_array_descriptor_type (type))
2113 return ada_check_typedef (desc_data_target_type (type));
2118 /* Non-zero iff TYPE represents a standard GNAT packed-array type. */
2121 ada_is_packed_array_type (struct type *type)
2125 type = desc_base_type (type);
2126 type = ada_check_typedef (type);
2128 ada_type_name (type) != NULL
2129 && strstr (ada_type_name (type), "___XP") != NULL;
2132 /* Non-zero iff TYPE represents a standard GNAT constrained
2133 packed-array type. */
2136 ada_is_constrained_packed_array_type (struct type *type)
2138 return ada_is_packed_array_type (type)
2139 && !ada_is_array_descriptor_type (type);
2142 /* Non-zero iff TYPE represents an array descriptor for a
2143 unconstrained packed-array type. */
2146 ada_is_unconstrained_packed_array_type (struct type *type)
2148 return ada_is_packed_array_type (type)
2149 && ada_is_array_descriptor_type (type);
2152 /* Given that TYPE encodes a packed array type (constrained or unconstrained),
2153 return the size of its elements in bits. */
2156 decode_packed_array_bitsize (struct type *type)
2158 const char *raw_name;
2162 /* Access to arrays implemented as fat pointers are encoded as a typedef
2163 of the fat pointer type. We need the name of the fat pointer type
2164 to do the decoding, so strip the typedef layer. */
2165 if (TYPE_CODE (type) == TYPE_CODE_TYPEDEF)
2166 type = ada_typedef_target_type (type);
2168 raw_name = ada_type_name (ada_check_typedef (type));
2170 raw_name = ada_type_name (desc_base_type (type));
2175 tail = strstr (raw_name, "___XP");
2176 gdb_assert (tail != NULL);
2178 if (sscanf (tail + sizeof ("___XP") - 1, "%ld", &bits) != 1)
2181 (_("could not understand bit size information on packed array"));
2188 /* Given that TYPE is a standard GDB array type with all bounds filled
2189 in, and that the element size of its ultimate scalar constituents
2190 (that is, either its elements, or, if it is an array of arrays, its
2191 elements' elements, etc.) is *ELT_BITS, return an identical type,
2192 but with the bit sizes of its elements (and those of any
2193 constituent arrays) recorded in the BITSIZE components of its
2194 TYPE_FIELD_BITSIZE values, and with *ELT_BITS set to its total size
2197 Note that, for arrays whose index type has an XA encoding where
2198 a bound references a record discriminant, getting that discriminant,
2199 and therefore the actual value of that bound, is not possible
2200 because none of the given parameters gives us access to the record.
2201 This function assumes that it is OK in the context where it is being
2202 used to return an array whose bounds are still dynamic and where
2203 the length is arbitrary. */
2205 static struct type *
2206 constrained_packed_array_type (struct type *type, long *elt_bits)
2208 struct type *new_elt_type;
2209 struct type *new_type;
2210 struct type *index_type_desc;
2211 struct type *index_type;
2212 LONGEST low_bound, high_bound;
2214 type = ada_check_typedef (type);
2215 if (TYPE_CODE (type) != TYPE_CODE_ARRAY)
2218 index_type_desc = ada_find_parallel_type (type, "___XA");
2219 if (index_type_desc)
2220 index_type = to_fixed_range_type (TYPE_FIELD_TYPE (index_type_desc, 0),
2223 index_type = TYPE_INDEX_TYPE (type);
2225 new_type = alloc_type_copy (type);
2227 constrained_packed_array_type (ada_check_typedef (TYPE_TARGET_TYPE (type)),
2229 create_array_type (new_type, new_elt_type, index_type);
2230 TYPE_FIELD_BITSIZE (new_type, 0) = *elt_bits;
2231 TYPE_NAME (new_type) = ada_type_name (type);
2233 if ((TYPE_CODE (check_typedef (index_type)) == TYPE_CODE_RANGE
2234 && is_dynamic_type (check_typedef (index_type)))
2235 || get_discrete_bounds (index_type, &low_bound, &high_bound) < 0)
2236 low_bound = high_bound = 0;
2237 if (high_bound < low_bound)
2238 *elt_bits = TYPE_LENGTH (new_type) = 0;
2241 *elt_bits *= (high_bound - low_bound + 1);
2242 TYPE_LENGTH (new_type) =
2243 (*elt_bits + HOST_CHAR_BIT - 1) / HOST_CHAR_BIT;
2246 TYPE_FIXED_INSTANCE (new_type) = 1;
2250 /* The array type encoded by TYPE, where
2251 ada_is_constrained_packed_array_type (TYPE). */
2253 static struct type *
2254 decode_constrained_packed_array_type (struct type *type)
2256 const char *raw_name = ada_type_name (ada_check_typedef (type));
2259 struct type *shadow_type;
2263 raw_name = ada_type_name (desc_base_type (type));
2268 name = (char *) alloca (strlen (raw_name) + 1);
2269 tail = strstr (raw_name, "___XP");
2270 type = desc_base_type (type);
2272 memcpy (name, raw_name, tail - raw_name);
2273 name[tail - raw_name] = '\000';
2275 shadow_type = ada_find_parallel_type_with_name (type, name);
2277 if (shadow_type == NULL)
2279 lim_warning (_("could not find bounds information on packed array"));
2282 shadow_type = check_typedef (shadow_type);
2284 if (TYPE_CODE (shadow_type) != TYPE_CODE_ARRAY)
2286 lim_warning (_("could not understand bounds "
2287 "information on packed array"));
2291 bits = decode_packed_array_bitsize (type);
2292 return constrained_packed_array_type (shadow_type, &bits);
2295 /* Given that ARR is a struct value *indicating a GNAT constrained packed
2296 array, returns a simple array that denotes that array. Its type is a
2297 standard GDB array type except that the BITSIZEs of the array
2298 target types are set to the number of bits in each element, and the
2299 type length is set appropriately. */
2301 static struct value *
2302 decode_constrained_packed_array (struct value *arr)
2306 /* If our value is a pointer, then dereference it. Likewise if
2307 the value is a reference. Make sure that this operation does not
2308 cause the target type to be fixed, as this would indirectly cause
2309 this array to be decoded. The rest of the routine assumes that
2310 the array hasn't been decoded yet, so we use the basic "coerce_ref"
2311 and "value_ind" routines to perform the dereferencing, as opposed
2312 to using "ada_coerce_ref" or "ada_value_ind". */
2313 arr = coerce_ref (arr);
2314 if (TYPE_CODE (ada_check_typedef (value_type (arr))) == TYPE_CODE_PTR)
2315 arr = value_ind (arr);
2317 type = decode_constrained_packed_array_type (value_type (arr));
2320 error (_("can't unpack array"));
2324 if (gdbarch_bits_big_endian (get_type_arch (value_type (arr)))
2325 && ada_is_modular_type (value_type (arr)))
2327 /* This is a (right-justified) modular type representing a packed
2328 array with no wrapper. In order to interpret the value through
2329 the (left-justified) packed array type we just built, we must
2330 first left-justify it. */
2331 int bit_size, bit_pos;
2334 mod = ada_modulus (value_type (arr)) - 1;
2341 bit_pos = HOST_CHAR_BIT * TYPE_LENGTH (value_type (arr)) - bit_size;
2342 arr = ada_value_primitive_packed_val (arr, NULL,
2343 bit_pos / HOST_CHAR_BIT,
2344 bit_pos % HOST_CHAR_BIT,
2349 return coerce_unspec_val_to_type (arr, type);
2353 /* The value of the element of packed array ARR at the ARITY indices
2354 given in IND. ARR must be a simple array. */
2356 static struct value *
2357 value_subscript_packed (struct value *arr, int arity, struct value **ind)
2360 int bits, elt_off, bit_off;
2361 long elt_total_bit_offset;
2362 struct type *elt_type;
2366 elt_total_bit_offset = 0;
2367 elt_type = ada_check_typedef (value_type (arr));
2368 for (i = 0; i < arity; i += 1)
2370 if (TYPE_CODE (elt_type) != TYPE_CODE_ARRAY
2371 || TYPE_FIELD_BITSIZE (elt_type, 0) == 0)
2373 (_("attempt to do packed indexing of "
2374 "something other than a packed array"));
2377 struct type *range_type = TYPE_INDEX_TYPE (elt_type);
2378 LONGEST lowerbound, upperbound;
2381 if (get_discrete_bounds (range_type, &lowerbound, &upperbound) < 0)
2383 lim_warning (_("don't know bounds of array"));
2384 lowerbound = upperbound = 0;
2387 idx = pos_atr (ind[i]);
2388 if (idx < lowerbound || idx > upperbound)
2389 lim_warning (_("packed array index %ld out of bounds"),
2391 bits = TYPE_FIELD_BITSIZE (elt_type, 0);
2392 elt_total_bit_offset += (idx - lowerbound) * bits;
2393 elt_type = ada_check_typedef (TYPE_TARGET_TYPE (elt_type));
2396 elt_off = elt_total_bit_offset / HOST_CHAR_BIT;
2397 bit_off = elt_total_bit_offset % HOST_CHAR_BIT;
2399 v = ada_value_primitive_packed_val (arr, NULL, elt_off, bit_off,
2404 /* Non-zero iff TYPE includes negative integer values. */
2407 has_negatives (struct type *type)
2409 switch (TYPE_CODE (type))
2414 return !TYPE_UNSIGNED (type);
2415 case TYPE_CODE_RANGE:
2416 return TYPE_LOW_BOUND (type) < 0;
2420 /* With SRC being a buffer containing BIT_SIZE bits of data at BIT_OFFSET,
2421 unpack that data into UNPACKED. UNPACKED_LEN is the size in bytes of
2422 the unpacked buffer.
2424 The size of the unpacked buffer (UNPACKED_LEN) is expected to be large
2425 enough to contain at least BIT_OFFSET bits. If not, an error is raised.
2427 IS_BIG_ENDIAN is nonzero if the data is stored in big endian mode,
2430 IS_SIGNED_TYPE is nonzero if the data corresponds to a signed type.
2432 IS_SCALAR is nonzero if the data corresponds to a signed type. */
2435 ada_unpack_from_contents (const gdb_byte *src, int bit_offset, int bit_size,
2436 gdb_byte *unpacked, int unpacked_len,
2437 int is_big_endian, int is_signed_type,
2440 int src_len = (bit_size + bit_offset + HOST_CHAR_BIT - 1) / 8;
2441 int src_idx; /* Index into the source area */
2442 int src_bytes_left; /* Number of source bytes left to process. */
2443 int srcBitsLeft; /* Number of source bits left to move */
2444 int unusedLS; /* Number of bits in next significant
2445 byte of source that are unused */
2447 int unpacked_idx; /* Index into the unpacked buffer */
2448 int unpacked_bytes_left; /* Number of bytes left to set in unpacked. */
2450 unsigned long accum; /* Staging area for bits being transferred */
2451 int accumSize; /* Number of meaningful bits in accum */
2454 /* Transmit bytes from least to most significant; delta is the direction
2455 the indices move. */
2456 int delta = is_big_endian ? -1 : 1;
2458 /* Make sure that unpacked is large enough to receive the BIT_SIZE
2460 if ((bit_size + HOST_CHAR_BIT - 1) / HOST_CHAR_BIT > unpacked_len)
2461 error (_("Cannot unpack %d bits into buffer of %d bytes"),
2462 bit_size, unpacked_len);
2464 srcBitsLeft = bit_size;
2465 src_bytes_left = src_len;
2466 unpacked_bytes_left = unpacked_len;
2471 src_idx = src_len - 1;
2473 && ((src[0] << bit_offset) & (1 << (HOST_CHAR_BIT - 1))))
2477 (HOST_CHAR_BIT - (bit_size + bit_offset) % HOST_CHAR_BIT)
2483 unpacked_idx = unpacked_len - 1;
2487 /* Non-scalar values must be aligned at a byte boundary... */
2489 (HOST_CHAR_BIT - bit_size % HOST_CHAR_BIT) % HOST_CHAR_BIT;
2490 /* ... And are placed at the beginning (most-significant) bytes
2492 unpacked_idx = (bit_size + HOST_CHAR_BIT - 1) / HOST_CHAR_BIT - 1;
2493 unpacked_bytes_left = unpacked_idx + 1;
2498 int sign_bit_offset = (bit_size + bit_offset - 1) % 8;
2500 src_idx = unpacked_idx = 0;
2501 unusedLS = bit_offset;
2504 if (is_signed_type && (src[src_len - 1] & (1 << sign_bit_offset)))
2509 while (src_bytes_left > 0)
2511 /* Mask for removing bits of the next source byte that are not
2512 part of the value. */
2513 unsigned int unusedMSMask =
2514 (1 << (srcBitsLeft >= HOST_CHAR_BIT ? HOST_CHAR_BIT : srcBitsLeft)) -
2516 /* Sign-extend bits for this byte. */
2517 unsigned int signMask = sign & ~unusedMSMask;
2520 (((src[src_idx] >> unusedLS) & unusedMSMask) | signMask) << accumSize;
2521 accumSize += HOST_CHAR_BIT - unusedLS;
2522 if (accumSize >= HOST_CHAR_BIT)
2524 unpacked[unpacked_idx] = accum & ~(~0UL << HOST_CHAR_BIT);
2525 accumSize -= HOST_CHAR_BIT;
2526 accum >>= HOST_CHAR_BIT;
2527 unpacked_bytes_left -= 1;
2528 unpacked_idx += delta;
2530 srcBitsLeft -= HOST_CHAR_BIT - unusedLS;
2532 src_bytes_left -= 1;
2535 while (unpacked_bytes_left > 0)
2537 accum |= sign << accumSize;
2538 unpacked[unpacked_idx] = accum & ~(~0UL << HOST_CHAR_BIT);
2539 accumSize -= HOST_CHAR_BIT;
2542 accum >>= HOST_CHAR_BIT;
2543 unpacked_bytes_left -= 1;
2544 unpacked_idx += delta;
2548 /* Create a new value of type TYPE from the contents of OBJ starting
2549 at byte OFFSET, and bit offset BIT_OFFSET within that byte,
2550 proceeding for BIT_SIZE bits. If OBJ is an lval in memory, then
2551 assigning through the result will set the field fetched from.
2552 VALADDR is ignored unless OBJ is NULL, in which case,
2553 VALADDR+OFFSET must address the start of storage containing the
2554 packed value. The value returned in this case is never an lval.
2555 Assumes 0 <= BIT_OFFSET < HOST_CHAR_BIT. */
2558 ada_value_primitive_packed_val (struct value *obj, const gdb_byte *valaddr,
2559 long offset, int bit_offset, int bit_size,
2563 const gdb_byte *src; /* First byte containing data to unpack */
2565 const int is_scalar = is_scalar_type (type);
2566 const int is_big_endian = gdbarch_bits_big_endian (get_type_arch (type));
2567 gdb::byte_vector staging;
2569 type = ada_check_typedef (type);
2572 src = valaddr + offset;
2574 src = value_contents (obj) + offset;
2576 if (is_dynamic_type (type))
2578 /* The length of TYPE might by dynamic, so we need to resolve
2579 TYPE in order to know its actual size, which we then use
2580 to create the contents buffer of the value we return.
2581 The difficulty is that the data containing our object is
2582 packed, and therefore maybe not at a byte boundary. So, what
2583 we do, is unpack the data into a byte-aligned buffer, and then
2584 use that buffer as our object's value for resolving the type. */
2585 int staging_len = (bit_size + HOST_CHAR_BIT - 1) / HOST_CHAR_BIT;
2586 staging.resize (staging_len);
2588 ada_unpack_from_contents (src, bit_offset, bit_size,
2589 staging.data (), staging.size (),
2590 is_big_endian, has_negatives (type),
2592 type = resolve_dynamic_type (type, staging.data (), 0);
2593 if (TYPE_LENGTH (type) < (bit_size + HOST_CHAR_BIT - 1) / HOST_CHAR_BIT)
2595 /* This happens when the length of the object is dynamic,
2596 and is actually smaller than the space reserved for it.
2597 For instance, in an array of variant records, the bit_size
2598 we're given is the array stride, which is constant and
2599 normally equal to the maximum size of its element.
2600 But, in reality, each element only actually spans a portion
2602 bit_size = TYPE_LENGTH (type) * HOST_CHAR_BIT;
2608 v = allocate_value (type);
2609 src = valaddr + offset;
2611 else if (VALUE_LVAL (obj) == lval_memory && value_lazy (obj))
2613 int src_len = (bit_size + bit_offset + HOST_CHAR_BIT - 1) / 8;
2616 v = value_at (type, value_address (obj) + offset);
2617 buf = (gdb_byte *) alloca (src_len);
2618 read_memory (value_address (v), buf, src_len);
2623 v = allocate_value (type);
2624 src = value_contents (obj) + offset;
2629 long new_offset = offset;
2631 set_value_component_location (v, obj);
2632 set_value_bitpos (v, bit_offset + value_bitpos (obj));
2633 set_value_bitsize (v, bit_size);
2634 if (value_bitpos (v) >= HOST_CHAR_BIT)
2637 set_value_bitpos (v, value_bitpos (v) - HOST_CHAR_BIT);
2639 set_value_offset (v, new_offset);
2641 /* Also set the parent value. This is needed when trying to
2642 assign a new value (in inferior memory). */
2643 set_value_parent (v, obj);
2646 set_value_bitsize (v, bit_size);
2647 unpacked = value_contents_writeable (v);
2651 memset (unpacked, 0, TYPE_LENGTH (type));
2655 if (staging.size () == TYPE_LENGTH (type))
2657 /* Small short-cut: If we've unpacked the data into a buffer
2658 of the same size as TYPE's length, then we can reuse that,
2659 instead of doing the unpacking again. */
2660 memcpy (unpacked, staging.data (), staging.size ());
2663 ada_unpack_from_contents (src, bit_offset, bit_size,
2664 unpacked, TYPE_LENGTH (type),
2665 is_big_endian, has_negatives (type), is_scalar);
2670 /* Store the contents of FROMVAL into the location of TOVAL.
2671 Return a new value with the location of TOVAL and contents of
2672 FROMVAL. Handles assignment into packed fields that have
2673 floating-point or non-scalar types. */
2675 static struct value *
2676 ada_value_assign (struct value *toval, struct value *fromval)
2678 struct type *type = value_type (toval);
2679 int bits = value_bitsize (toval);
2681 toval = ada_coerce_ref (toval);
2682 fromval = ada_coerce_ref (fromval);
2684 if (ada_is_direct_array_type (value_type (toval)))
2685 toval = ada_coerce_to_simple_array (toval);
2686 if (ada_is_direct_array_type (value_type (fromval)))
2687 fromval = ada_coerce_to_simple_array (fromval);
2689 if (!deprecated_value_modifiable (toval))
2690 error (_("Left operand of assignment is not a modifiable lvalue."));
2692 if (VALUE_LVAL (toval) == lval_memory
2694 && (TYPE_CODE (type) == TYPE_CODE_FLT
2695 || TYPE_CODE (type) == TYPE_CODE_STRUCT))
2697 int len = (value_bitpos (toval)
2698 + bits + HOST_CHAR_BIT - 1) / HOST_CHAR_BIT;
2700 gdb_byte *buffer = (gdb_byte *) alloca (len);
2702 CORE_ADDR to_addr = value_address (toval);
2704 if (TYPE_CODE (type) == TYPE_CODE_FLT)
2705 fromval = value_cast (type, fromval);
2707 read_memory (to_addr, buffer, len);
2708 from_size = value_bitsize (fromval);
2710 from_size = TYPE_LENGTH (value_type (fromval)) * TARGET_CHAR_BIT;
2711 if (gdbarch_bits_big_endian (get_type_arch (type)))
2712 copy_bitwise (buffer, value_bitpos (toval),
2713 value_contents (fromval), from_size - bits, bits, 1);
2715 copy_bitwise (buffer, value_bitpos (toval),
2716 value_contents (fromval), 0, bits, 0);
2717 write_memory_with_notification (to_addr, buffer, len);
2719 val = value_copy (toval);
2720 memcpy (value_contents_raw (val), value_contents (fromval),
2721 TYPE_LENGTH (type));
2722 deprecated_set_value_type (val, type);
2727 return value_assign (toval, fromval);
2731 /* Given that COMPONENT is a memory lvalue that is part of the lvalue
2732 CONTAINER, assign the contents of VAL to COMPONENTS's place in
2733 CONTAINER. Modifies the VALUE_CONTENTS of CONTAINER only, not
2734 COMPONENT, and not the inferior's memory. The current contents
2735 of COMPONENT are ignored.
2737 Although not part of the initial design, this function also works
2738 when CONTAINER and COMPONENT are not_lval's: it works as if CONTAINER
2739 had a null address, and COMPONENT had an address which is equal to
2740 its offset inside CONTAINER. */
2743 value_assign_to_component (struct value *container, struct value *component,
2746 LONGEST offset_in_container =
2747 (LONGEST) (value_address (component) - value_address (container));
2748 int bit_offset_in_container =
2749 value_bitpos (component) - value_bitpos (container);
2752 val = value_cast (value_type (component), val);
2754 if (value_bitsize (component) == 0)
2755 bits = TARGET_CHAR_BIT * TYPE_LENGTH (value_type (component));
2757 bits = value_bitsize (component);
2759 if (gdbarch_bits_big_endian (get_type_arch (value_type (container))))
2763 if (is_scalar_type (check_typedef (value_type (component))))
2765 = TYPE_LENGTH (value_type (component)) * TARGET_CHAR_BIT - bits;
2768 copy_bitwise (value_contents_writeable (container) + offset_in_container,
2769 value_bitpos (container) + bit_offset_in_container,
2770 value_contents (val), src_offset, bits, 1);
2773 copy_bitwise (value_contents_writeable (container) + offset_in_container,
2774 value_bitpos (container) + bit_offset_in_container,
2775 value_contents (val), 0, bits, 0);
2778 /* Determine if TYPE is an access to an unconstrained array. */
2781 ada_is_access_to_unconstrained_array (struct type *type)
2783 return (TYPE_CODE (type) == TYPE_CODE_TYPEDEF
2784 && is_thick_pntr (ada_typedef_target_type (type)));
2787 /* The value of the element of array ARR at the ARITY indices given in IND.
2788 ARR may be either a simple array, GNAT array descriptor, or pointer
2792 ada_value_subscript (struct value *arr, int arity, struct value **ind)
2796 struct type *elt_type;
2798 elt = ada_coerce_to_simple_array (arr);
2800 elt_type = ada_check_typedef (value_type (elt));
2801 if (TYPE_CODE (elt_type) == TYPE_CODE_ARRAY
2802 && TYPE_FIELD_BITSIZE (elt_type, 0) > 0)
2803 return value_subscript_packed (elt, arity, ind);
2805 for (k = 0; k < arity; k += 1)
2807 struct type *saved_elt_type = TYPE_TARGET_TYPE (elt_type);
2809 if (TYPE_CODE (elt_type) != TYPE_CODE_ARRAY)
2810 error (_("too many subscripts (%d expected)"), k);
2812 elt = value_subscript (elt, pos_atr (ind[k]));
2814 if (ada_is_access_to_unconstrained_array (saved_elt_type)
2815 && TYPE_CODE (value_type (elt)) != TYPE_CODE_TYPEDEF)
2817 /* The element is a typedef to an unconstrained array,
2818 except that the value_subscript call stripped the
2819 typedef layer. The typedef layer is GNAT's way to
2820 specify that the element is, at the source level, an
2821 access to the unconstrained array, rather than the
2822 unconstrained array. So, we need to restore that
2823 typedef layer, which we can do by forcing the element's
2824 type back to its original type. Otherwise, the returned
2825 value is going to be printed as the array, rather
2826 than as an access. Another symptom of the same issue
2827 would be that an expression trying to dereference the
2828 element would also be improperly rejected. */
2829 deprecated_set_value_type (elt, saved_elt_type);
2832 elt_type = ada_check_typedef (value_type (elt));
2838 /* Assuming ARR is a pointer to a GDB array, the value of the element
2839 of *ARR at the ARITY indices given in IND.
2840 Does not read the entire array into memory.
2842 Note: Unlike what one would expect, this function is used instead of
2843 ada_value_subscript for basically all non-packed array types. The reason
2844 for this is that a side effect of doing our own pointer arithmetics instead
2845 of relying on value_subscript is that there is no implicit typedef peeling.
2846 This is important for arrays of array accesses, where it allows us to
2847 preserve the fact that the array's element is an array access, where the
2848 access part os encoded in a typedef layer. */
2850 static struct value *
2851 ada_value_ptr_subscript (struct value *arr, int arity, struct value **ind)
2854 struct value *array_ind = ada_value_ind (arr);
2856 = check_typedef (value_enclosing_type (array_ind));
2858 if (TYPE_CODE (type) == TYPE_CODE_ARRAY
2859 && TYPE_FIELD_BITSIZE (type, 0) > 0)
2860 return value_subscript_packed (array_ind, arity, ind);
2862 for (k = 0; k < arity; k += 1)
2865 struct value *lwb_value;
2867 if (TYPE_CODE (type) != TYPE_CODE_ARRAY)
2868 error (_("too many subscripts (%d expected)"), k);
2869 arr = value_cast (lookup_pointer_type (TYPE_TARGET_TYPE (type)),
2871 get_discrete_bounds (TYPE_INDEX_TYPE (type), &lwb, &upb);
2872 lwb_value = value_from_longest (value_type(ind[k]), lwb);
2873 arr = value_ptradd (arr, pos_atr (ind[k]) - pos_atr (lwb_value));
2874 type = TYPE_TARGET_TYPE (type);
2877 return value_ind (arr);
2880 /* Given that ARRAY_PTR is a pointer or reference to an array of type TYPE (the
2881 actual type of ARRAY_PTR is ignored), returns the Ada slice of
2882 HIGH'Pos-LOW'Pos+1 elements starting at index LOW. The lower bound of
2883 this array is LOW, as per Ada rules. */
2884 static struct value *
2885 ada_value_slice_from_ptr (struct value *array_ptr, struct type *type,
2888 struct type *type0 = ada_check_typedef (type);
2889 struct type *base_index_type = TYPE_TARGET_TYPE (TYPE_INDEX_TYPE (type0));
2890 struct type *index_type
2891 = create_static_range_type (NULL, base_index_type, low, high);
2892 struct type *slice_type = create_array_type_with_stride
2893 (NULL, TYPE_TARGET_TYPE (type0), index_type,
2894 get_dyn_prop (DYN_PROP_BYTE_STRIDE, type0),
2895 TYPE_FIELD_BITSIZE (type0, 0));
2896 int base_low = ada_discrete_type_low_bound (TYPE_INDEX_TYPE (type0));
2897 LONGEST base_low_pos, low_pos;
2900 if (!discrete_position (base_index_type, low, &low_pos)
2901 || !discrete_position (base_index_type, base_low, &base_low_pos))
2903 warning (_("unable to get positions in slice, use bounds instead"));
2905 base_low_pos = base_low;
2908 base = value_as_address (array_ptr)
2909 + ((low_pos - base_low_pos)
2910 * TYPE_LENGTH (TYPE_TARGET_TYPE (type0)));
2911 return value_at_lazy (slice_type, base);
2915 static struct value *
2916 ada_value_slice (struct value *array, int low, int high)
2918 struct type *type = ada_check_typedef (value_type (array));
2919 struct type *base_index_type = TYPE_TARGET_TYPE (TYPE_INDEX_TYPE (type));
2920 struct type *index_type
2921 = create_static_range_type (NULL, TYPE_INDEX_TYPE (type), low, high);
2922 struct type *slice_type = create_array_type_with_stride
2923 (NULL, TYPE_TARGET_TYPE (type), index_type,
2924 get_dyn_prop (DYN_PROP_BYTE_STRIDE, type),
2925 TYPE_FIELD_BITSIZE (type, 0));
2926 LONGEST low_pos, high_pos;
2928 if (!discrete_position (base_index_type, low, &low_pos)
2929 || !discrete_position (base_index_type, high, &high_pos))
2931 warning (_("unable to get positions in slice, use bounds instead"));
2936 return value_cast (slice_type,
2937 value_slice (array, low, high_pos - low_pos + 1));
2940 /* If type is a record type in the form of a standard GNAT array
2941 descriptor, returns the number of dimensions for type. If arr is a
2942 simple array, returns the number of "array of"s that prefix its
2943 type designation. Otherwise, returns 0. */
2946 ada_array_arity (struct type *type)
2953 type = desc_base_type (type);
2956 if (TYPE_CODE (type) == TYPE_CODE_STRUCT)
2957 return desc_arity (desc_bounds_type (type));
2959 while (TYPE_CODE (type) == TYPE_CODE_ARRAY)
2962 type = ada_check_typedef (TYPE_TARGET_TYPE (type));
2968 /* If TYPE is a record type in the form of a standard GNAT array
2969 descriptor or a simple array type, returns the element type for
2970 TYPE after indexing by NINDICES indices, or by all indices if
2971 NINDICES is -1. Otherwise, returns NULL. */
2974 ada_array_element_type (struct type *type, int nindices)
2976 type = desc_base_type (type);
2978 if (TYPE_CODE (type) == TYPE_CODE_STRUCT)
2981 struct type *p_array_type;
2983 p_array_type = desc_data_target_type (type);
2985 k = ada_array_arity (type);
2989 /* Initially p_array_type = elt_type(*)[]...(k times)...[]. */
2990 if (nindices >= 0 && k > nindices)
2992 while (k > 0 && p_array_type != NULL)
2994 p_array_type = ada_check_typedef (TYPE_TARGET_TYPE (p_array_type));
2997 return p_array_type;
2999 else if (TYPE_CODE (type) == TYPE_CODE_ARRAY)
3001 while (nindices != 0 && TYPE_CODE (type) == TYPE_CODE_ARRAY)
3003 type = TYPE_TARGET_TYPE (type);
3012 /* The type of nth index in arrays of given type (n numbering from 1).
3013 Does not examine memory. Throws an error if N is invalid or TYPE
3014 is not an array type. NAME is the name of the Ada attribute being
3015 evaluated ('range, 'first, 'last, or 'length); it is used in building
3016 the error message. */
3018 static struct type *
3019 ada_index_type (struct type *type, int n, const char *name)
3021 struct type *result_type;
3023 type = desc_base_type (type);
3025 if (n < 0 || n > ada_array_arity (type))
3026 error (_("invalid dimension number to '%s"), name);
3028 if (ada_is_simple_array_type (type))
3032 for (i = 1; i < n; i += 1)
3033 type = TYPE_TARGET_TYPE (type);
3034 result_type = TYPE_TARGET_TYPE (TYPE_INDEX_TYPE (type));
3035 /* FIXME: The stabs type r(0,0);bound;bound in an array type
3036 has a target type of TYPE_CODE_UNDEF. We compensate here, but
3037 perhaps stabsread.c would make more sense. */
3038 if (result_type && TYPE_CODE (result_type) == TYPE_CODE_UNDEF)
3043 result_type = desc_index_type (desc_bounds_type (type), n);
3044 if (result_type == NULL)
3045 error (_("attempt to take bound of something that is not an array"));
3051 /* Given that arr is an array type, returns the lower bound of the
3052 Nth index (numbering from 1) if WHICH is 0, and the upper bound if
3053 WHICH is 1. This returns bounds 0 .. -1 if ARR_TYPE is an
3054 array-descriptor type. It works for other arrays with bounds supplied
3055 by run-time quantities other than discriminants. */
3058 ada_array_bound_from_type (struct type *arr_type, int n, int which)
3060 struct type *type, *index_type_desc, *index_type;
3063 gdb_assert (which == 0 || which == 1);
3065 if (ada_is_constrained_packed_array_type (arr_type))
3066 arr_type = decode_constrained_packed_array_type (arr_type);
3068 if (arr_type == NULL || !ada_is_simple_array_type (arr_type))
3069 return (LONGEST) - which;
3071 if (TYPE_CODE (arr_type) == TYPE_CODE_PTR)
3072 type = TYPE_TARGET_TYPE (arr_type);
3076 if (TYPE_FIXED_INSTANCE (type))
3078 /* The array has already been fixed, so we do not need to
3079 check the parallel ___XA type again. That encoding has
3080 already been applied, so ignore it now. */
3081 index_type_desc = NULL;
3085 index_type_desc = ada_find_parallel_type (type, "___XA");
3086 ada_fixup_array_indexes_type (index_type_desc);
3089 if (index_type_desc != NULL)
3090 index_type = to_fixed_range_type (TYPE_FIELD_TYPE (index_type_desc, n - 1),
3094 struct type *elt_type = check_typedef (type);
3096 for (i = 1; i < n; i++)
3097 elt_type = check_typedef (TYPE_TARGET_TYPE (elt_type));
3099 index_type = TYPE_INDEX_TYPE (elt_type);
3103 (LONGEST) (which == 0
3104 ? ada_discrete_type_low_bound (index_type)
3105 : ada_discrete_type_high_bound (index_type));
3108 /* Given that arr is an array value, returns the lower bound of the
3109 nth index (numbering from 1) if WHICH is 0, and the upper bound if
3110 WHICH is 1. This routine will also work for arrays with bounds
3111 supplied by run-time quantities other than discriminants. */
3114 ada_array_bound (struct value *arr, int n, int which)
3116 struct type *arr_type;
3118 if (TYPE_CODE (check_typedef (value_type (arr))) == TYPE_CODE_PTR)
3119 arr = value_ind (arr);
3120 arr_type = value_enclosing_type (arr);
3122 if (ada_is_constrained_packed_array_type (arr_type))
3123 return ada_array_bound (decode_constrained_packed_array (arr), n, which);
3124 else if (ada_is_simple_array_type (arr_type))
3125 return ada_array_bound_from_type (arr_type, n, which);
3127 return value_as_long (desc_one_bound (desc_bounds (arr), n, which));
3130 /* Given that arr is an array value, returns the length of the
3131 nth index. This routine will also work for arrays with bounds
3132 supplied by run-time quantities other than discriminants.
3133 Does not work for arrays indexed by enumeration types with representation
3134 clauses at the moment. */
3137 ada_array_length (struct value *arr, int n)
3139 struct type *arr_type, *index_type;
3142 if (TYPE_CODE (check_typedef (value_type (arr))) == TYPE_CODE_PTR)
3143 arr = value_ind (arr);
3144 arr_type = value_enclosing_type (arr);
3146 if (ada_is_constrained_packed_array_type (arr_type))
3147 return ada_array_length (decode_constrained_packed_array (arr), n);
3149 if (ada_is_simple_array_type (arr_type))
3151 low = ada_array_bound_from_type (arr_type, n, 0);
3152 high = ada_array_bound_from_type (arr_type, n, 1);
3156 low = value_as_long (desc_one_bound (desc_bounds (arr), n, 0));
3157 high = value_as_long (desc_one_bound (desc_bounds (arr), n, 1));
3160 arr_type = check_typedef (arr_type);
3161 index_type = ada_index_type (arr_type, n, "length");
3162 if (index_type != NULL)
3164 struct type *base_type;
3165 if (TYPE_CODE (index_type) == TYPE_CODE_RANGE)
3166 base_type = TYPE_TARGET_TYPE (index_type);
3168 base_type = index_type;
3170 low = pos_atr (value_from_longest (base_type, low));
3171 high = pos_atr (value_from_longest (base_type, high));
3173 return high - low + 1;
3176 /* An empty array whose type is that of ARR_TYPE (an array type),
3177 with bounds LOW to LOW-1. */
3179 static struct value *
3180 empty_array (struct type *arr_type, int low)
3182 struct type *arr_type0 = ada_check_typedef (arr_type);
3183 struct type *index_type
3184 = create_static_range_type
3185 (NULL, TYPE_TARGET_TYPE (TYPE_INDEX_TYPE (arr_type0)), low, low - 1);
3186 struct type *elt_type = ada_array_element_type (arr_type0, 1);
3188 return allocate_value (create_array_type (NULL, elt_type, index_type));
3192 /* Name resolution */
3194 /* The "decoded" name for the user-definable Ada operator corresponding
3198 ada_decoded_op_name (enum exp_opcode op)
3202 for (i = 0; ada_opname_table[i].encoded != NULL; i += 1)
3204 if (ada_opname_table[i].op == op)
3205 return ada_opname_table[i].decoded;
3207 error (_("Could not find operator name for opcode"));
3211 /* Same as evaluate_type (*EXP), but resolves ambiguous symbol
3212 references (marked by OP_VAR_VALUE nodes in which the symbol has an
3213 undefined namespace) and converts operators that are
3214 user-defined into appropriate function calls. If CONTEXT_TYPE is
3215 non-null, it provides a preferred result type [at the moment, only
3216 type void has any effect---causing procedures to be preferred over
3217 functions in calls]. A null CONTEXT_TYPE indicates that a non-void
3218 return type is preferred. May change (expand) *EXP. */
3221 resolve (expression_up *expp, int void_context_p)
3223 struct type *context_type = NULL;
3227 context_type = builtin_type ((*expp)->gdbarch)->builtin_void;
3229 resolve_subexp (expp, &pc, 1, context_type);
3232 /* Resolve the operator of the subexpression beginning at
3233 position *POS of *EXPP. "Resolving" consists of replacing
3234 the symbols that have undefined namespaces in OP_VAR_VALUE nodes
3235 with their resolutions, replacing built-in operators with
3236 function calls to user-defined operators, where appropriate, and,
3237 when DEPROCEDURE_P is non-zero, converting function-valued variables
3238 into parameterless calls. May expand *EXPP. The CONTEXT_TYPE functions
3239 are as in ada_resolve, above. */
3241 static struct value *
3242 resolve_subexp (expression_up *expp, int *pos, int deprocedure_p,
3243 struct type *context_type)
3247 struct expression *exp; /* Convenience: == *expp. */
3248 enum exp_opcode op = (*expp)->elts[pc].opcode;
3249 struct value **argvec; /* Vector of operand types (alloca'ed). */
3250 int nargs; /* Number of operands. */
3257 /* Pass one: resolve operands, saving their types and updating *pos,
3262 if (exp->elts[pc + 3].opcode == OP_VAR_VALUE
3263 && SYMBOL_DOMAIN (exp->elts[pc + 5].symbol) == UNDEF_DOMAIN)
3268 resolve_subexp (expp, pos, 0, NULL);
3270 nargs = longest_to_int (exp->elts[pc + 1].longconst);
3275 resolve_subexp (expp, pos, 0, NULL);
3280 resolve_subexp (expp, pos, 1, check_typedef (exp->elts[pc + 1].type));
3283 case OP_ATR_MODULUS:
3293 case TERNOP_IN_RANGE:
3294 case BINOP_IN_BOUNDS:
3300 case OP_DISCRETE_RANGE:
3302 ada_forward_operator_length (exp, pc, &oplen, &nargs);
3311 arg1 = resolve_subexp (expp, pos, 0, NULL);
3313 resolve_subexp (expp, pos, 1, NULL);
3315 resolve_subexp (expp, pos, 1, value_type (arg1));
3332 case BINOP_LOGICAL_AND:
3333 case BINOP_LOGICAL_OR:
3334 case BINOP_BITWISE_AND:
3335 case BINOP_BITWISE_IOR:
3336 case BINOP_BITWISE_XOR:
3339 case BINOP_NOTEQUAL:
3346 case BINOP_SUBSCRIPT:
3354 case UNOP_LOGICAL_NOT:
3364 case OP_VAR_MSYM_VALUE:
3371 case OP_INTERNALVAR:
3381 *pos += 4 + BYTES_TO_EXP_ELEM (exp->elts[pc + 1].longconst + 1);
3384 case STRUCTOP_STRUCT:
3385 *pos += 4 + BYTES_TO_EXP_ELEM (exp->elts[pc + 1].longconst + 1);
3398 error (_("Unexpected operator during name resolution"));
3401 argvec = XALLOCAVEC (struct value *, nargs + 1);
3402 for (i = 0; i < nargs; i += 1)
3403 argvec[i] = resolve_subexp (expp, pos, 1, NULL);
3407 /* Pass two: perform any resolution on principal operator. */
3414 if (SYMBOL_DOMAIN (exp->elts[pc + 2].symbol) == UNDEF_DOMAIN)
3416 std::vector<struct block_symbol> candidates;
3420 ada_lookup_symbol_list (SYMBOL_LINKAGE_NAME
3421 (exp->elts[pc + 2].symbol),
3422 exp->elts[pc + 1].block, VAR_DOMAIN,
3425 if (n_candidates > 1)
3427 /* Types tend to get re-introduced locally, so if there
3428 are any local symbols that are not types, first filter
3431 for (j = 0; j < n_candidates; j += 1)
3432 switch (SYMBOL_CLASS (candidates[j].symbol))
3437 case LOC_REGPARM_ADDR:
3445 if (j < n_candidates)
3448 while (j < n_candidates)
3450 if (SYMBOL_CLASS (candidates[j].symbol) == LOC_TYPEDEF)
3452 candidates[j] = candidates[n_candidates - 1];
3461 if (n_candidates == 0)
3462 error (_("No definition found for %s"),
3463 SYMBOL_PRINT_NAME (exp->elts[pc + 2].symbol));
3464 else if (n_candidates == 1)
3466 else if (deprocedure_p
3467 && !is_nonfunction (candidates.data (), n_candidates))
3469 i = ada_resolve_function
3470 (candidates.data (), n_candidates, NULL, 0,
3471 SYMBOL_LINKAGE_NAME (exp->elts[pc + 2].symbol),
3474 error (_("Could not find a match for %s"),
3475 SYMBOL_PRINT_NAME (exp->elts[pc + 2].symbol));
3479 printf_filtered (_("Multiple matches for %s\n"),
3480 SYMBOL_PRINT_NAME (exp->elts[pc + 2].symbol));
3481 user_select_syms (candidates.data (), n_candidates, 1);
3485 exp->elts[pc + 1].block = candidates[i].block;
3486 exp->elts[pc + 2].symbol = candidates[i].symbol;
3487 innermost_block.update (candidates[i]);
3491 && (TYPE_CODE (SYMBOL_TYPE (exp->elts[pc + 2].symbol))
3494 replace_operator_with_call (expp, pc, 0, 4,
3495 exp->elts[pc + 2].symbol,
3496 exp->elts[pc + 1].block);
3503 if (exp->elts[pc + 3].opcode == OP_VAR_VALUE
3504 && SYMBOL_DOMAIN (exp->elts[pc + 5].symbol) == UNDEF_DOMAIN)
3506 std::vector<struct block_symbol> candidates;
3510 ada_lookup_symbol_list (SYMBOL_LINKAGE_NAME
3511 (exp->elts[pc + 5].symbol),
3512 exp->elts[pc + 4].block, VAR_DOMAIN,
3515 if (n_candidates == 1)
3519 i = ada_resolve_function
3520 (candidates.data (), n_candidates,
3522 SYMBOL_LINKAGE_NAME (exp->elts[pc + 5].symbol),
3525 error (_("Could not find a match for %s"),
3526 SYMBOL_PRINT_NAME (exp->elts[pc + 5].symbol));
3529 exp->elts[pc + 4].block = candidates[i].block;
3530 exp->elts[pc + 5].symbol = candidates[i].symbol;
3531 innermost_block.update (candidates[i]);
3542 case BINOP_BITWISE_AND:
3543 case BINOP_BITWISE_IOR:
3544 case BINOP_BITWISE_XOR:
3546 case BINOP_NOTEQUAL:
3554 case UNOP_LOGICAL_NOT:
3556 if (possible_user_operator_p (op, argvec))
3558 std::vector<struct block_symbol> candidates;
3562 ada_lookup_symbol_list (ada_decoded_op_name (op),
3563 (struct block *) NULL, VAR_DOMAIN,
3566 i = ada_resolve_function (candidates.data (), n_candidates, argvec,
3567 nargs, ada_decoded_op_name (op), NULL);
3571 replace_operator_with_call (expp, pc, nargs, 1,
3572 candidates[i].symbol,
3573 candidates[i].block);
3584 if (exp->elts[pc].opcode == OP_VAR_MSYM_VALUE)
3585 return evaluate_var_msym_value (EVAL_AVOID_SIDE_EFFECTS,
3586 exp->elts[pc + 1].objfile,
3587 exp->elts[pc + 2].msymbol);
3589 return evaluate_subexp_type (exp, pos);
3592 /* Return non-zero if formal type FTYPE matches actual type ATYPE. If
3593 MAY_DEREF is non-zero, the formal may be a pointer and the actual
3595 /* The term "match" here is rather loose. The match is heuristic and
3599 ada_type_match (struct type *ftype, struct type *atype, int may_deref)
3601 ftype = ada_check_typedef (ftype);
3602 atype = ada_check_typedef (atype);
3604 if (TYPE_CODE (ftype) == TYPE_CODE_REF)
3605 ftype = TYPE_TARGET_TYPE (ftype);
3606 if (TYPE_CODE (atype) == TYPE_CODE_REF)
3607 atype = TYPE_TARGET_TYPE (atype);
3609 switch (TYPE_CODE (ftype))
3612 return TYPE_CODE (ftype) == TYPE_CODE (atype);
3614 if (TYPE_CODE (atype) == TYPE_CODE_PTR)
3615 return ada_type_match (TYPE_TARGET_TYPE (ftype),
3616 TYPE_TARGET_TYPE (atype), 0);
3619 && ada_type_match (TYPE_TARGET_TYPE (ftype), atype, 0));
3621 case TYPE_CODE_ENUM:
3622 case TYPE_CODE_RANGE:
3623 switch (TYPE_CODE (atype))
3626 case TYPE_CODE_ENUM:
3627 case TYPE_CODE_RANGE:
3633 case TYPE_CODE_ARRAY:
3634 return (TYPE_CODE (atype) == TYPE_CODE_ARRAY
3635 || ada_is_array_descriptor_type (atype));
3637 case TYPE_CODE_STRUCT:
3638 if (ada_is_array_descriptor_type (ftype))
3639 return (TYPE_CODE (atype) == TYPE_CODE_ARRAY
3640 || ada_is_array_descriptor_type (atype));
3642 return (TYPE_CODE (atype) == TYPE_CODE_STRUCT
3643 && !ada_is_array_descriptor_type (atype));
3645 case TYPE_CODE_UNION:
3647 return (TYPE_CODE (atype) == TYPE_CODE (ftype));
3651 /* Return non-zero if the formals of FUNC "sufficiently match" the
3652 vector of actual argument types ACTUALS of size N_ACTUALS. FUNC
3653 may also be an enumeral, in which case it is treated as a 0-
3654 argument function. */
3657 ada_args_match (struct symbol *func, struct value **actuals, int n_actuals)
3660 struct type *func_type = SYMBOL_TYPE (func);
3662 if (SYMBOL_CLASS (func) == LOC_CONST
3663 && TYPE_CODE (func_type) == TYPE_CODE_ENUM)
3664 return (n_actuals == 0);
3665 else if (func_type == NULL || TYPE_CODE (func_type) != TYPE_CODE_FUNC)
3668 if (TYPE_NFIELDS (func_type) != n_actuals)
3671 for (i = 0; i < n_actuals; i += 1)
3673 if (actuals[i] == NULL)
3677 struct type *ftype = ada_check_typedef (TYPE_FIELD_TYPE (func_type,
3679 struct type *atype = ada_check_typedef (value_type (actuals[i]));
3681 if (!ada_type_match (ftype, atype, 1))
3688 /* False iff function type FUNC_TYPE definitely does not produce a value
3689 compatible with type CONTEXT_TYPE. Conservatively returns 1 if
3690 FUNC_TYPE is not a valid function type with a non-null return type
3691 or an enumerated type. A null CONTEXT_TYPE indicates any non-void type. */
3694 return_match (struct type *func_type, struct type *context_type)
3696 struct type *return_type;
3698 if (func_type == NULL)
3701 if (TYPE_CODE (func_type) == TYPE_CODE_FUNC)
3702 return_type = get_base_type (TYPE_TARGET_TYPE (func_type));
3704 return_type = get_base_type (func_type);
3705 if (return_type == NULL)
3708 context_type = get_base_type (context_type);
3710 if (TYPE_CODE (return_type) == TYPE_CODE_ENUM)
3711 return context_type == NULL || return_type == context_type;
3712 else if (context_type == NULL)
3713 return TYPE_CODE (return_type) != TYPE_CODE_VOID;
3715 return TYPE_CODE (return_type) == TYPE_CODE (context_type);
3719 /* Returns the index in SYMS[0..NSYMS-1] that contains the symbol for the
3720 function (if any) that matches the types of the NARGS arguments in
3721 ARGS. If CONTEXT_TYPE is non-null and there is at least one match
3722 that returns that type, then eliminate matches that don't. If
3723 CONTEXT_TYPE is void and there is at least one match that does not
3724 return void, eliminate all matches that do.
3726 Asks the user if there is more than one match remaining. Returns -1
3727 if there is no such symbol or none is selected. NAME is used
3728 solely for messages. May re-arrange and modify SYMS in
3729 the process; the index returned is for the modified vector. */
3732 ada_resolve_function (struct block_symbol syms[],
3733 int nsyms, struct value **args, int nargs,
3734 const char *name, struct type *context_type)
3738 int m; /* Number of hits */
3741 /* In the first pass of the loop, we only accept functions matching
3742 context_type. If none are found, we add a second pass of the loop
3743 where every function is accepted. */
3744 for (fallback = 0; m == 0 && fallback < 2; fallback++)
3746 for (k = 0; k < nsyms; k += 1)
3748 struct type *type = ada_check_typedef (SYMBOL_TYPE (syms[k].symbol));
3750 if (ada_args_match (syms[k].symbol, args, nargs)
3751 && (fallback || return_match (type, context_type)))
3759 /* If we got multiple matches, ask the user which one to use. Don't do this
3760 interactive thing during completion, though, as the purpose of the
3761 completion is providing a list of all possible matches. Prompting the
3762 user to filter it down would be completely unexpected in this case. */
3765 else if (m > 1 && !parse_completion)
3767 printf_filtered (_("Multiple matches for %s\n"), name);
3768 user_select_syms (syms, m, 1);
3774 /* Returns true (non-zero) iff decoded name N0 should appear before N1
3775 in a listing of choices during disambiguation (see sort_choices, below).
3776 The idea is that overloadings of a subprogram name from the
3777 same package should sort in their source order. We settle for ordering
3778 such symbols by their trailing number (__N or $N). */
3781 encoded_ordered_before (const char *N0, const char *N1)
3785 else if (N0 == NULL)
3791 for (k0 = strlen (N0) - 1; k0 > 0 && isdigit (N0[k0]); k0 -= 1)
3793 for (k1 = strlen (N1) - 1; k1 > 0 && isdigit (N1[k1]); k1 -= 1)
3795 if ((N0[k0] == '_' || N0[k0] == '$') && N0[k0 + 1] != '\000'
3796 && (N1[k1] == '_' || N1[k1] == '$') && N1[k1 + 1] != '\000')
3801 while (N0[n0] == '_' && n0 > 0 && N0[n0 - 1] == '_')
3804 while (N1[n1] == '_' && n1 > 0 && N1[n1 - 1] == '_')
3806 if (n0 == n1 && strncmp (N0, N1, n0) == 0)
3807 return (atoi (N0 + k0 + 1) < atoi (N1 + k1 + 1));
3809 return (strcmp (N0, N1) < 0);
3813 /* Sort SYMS[0..NSYMS-1] to put the choices in a canonical order by the
3817 sort_choices (struct block_symbol syms[], int nsyms)
3821 for (i = 1; i < nsyms; i += 1)
3823 struct block_symbol sym = syms[i];
3826 for (j = i - 1; j >= 0; j -= 1)
3828 if (encoded_ordered_before (SYMBOL_LINKAGE_NAME (syms[j].symbol),
3829 SYMBOL_LINKAGE_NAME (sym.symbol)))
3831 syms[j + 1] = syms[j];
3837 /* Whether GDB should display formals and return types for functions in the
3838 overloads selection menu. */
3839 static int print_signatures = 1;
3841 /* Print the signature for SYM on STREAM according to the FLAGS options. For
3842 all but functions, the signature is just the name of the symbol. For
3843 functions, this is the name of the function, the list of types for formals
3844 and the return type (if any). */
3847 ada_print_symbol_signature (struct ui_file *stream, struct symbol *sym,
3848 const struct type_print_options *flags)
3850 struct type *type = SYMBOL_TYPE (sym);
3852 fprintf_filtered (stream, "%s", SYMBOL_PRINT_NAME (sym));
3853 if (!print_signatures
3855 || TYPE_CODE (type) != TYPE_CODE_FUNC)
3858 if (TYPE_NFIELDS (type) > 0)
3862 fprintf_filtered (stream, " (");
3863 for (i = 0; i < TYPE_NFIELDS (type); ++i)
3866 fprintf_filtered (stream, "; ");
3867 ada_print_type (TYPE_FIELD_TYPE (type, i), NULL, stream, -1, 0,
3870 fprintf_filtered (stream, ")");
3872 if (TYPE_TARGET_TYPE (type) != NULL
3873 && TYPE_CODE (TYPE_TARGET_TYPE (type)) != TYPE_CODE_VOID)
3875 fprintf_filtered (stream, " return ");
3876 ada_print_type (TYPE_TARGET_TYPE (type), NULL, stream, -1, 0, flags);
3880 /* Given a list of NSYMS symbols in SYMS, select up to MAX_RESULTS>0
3881 by asking the user (if necessary), returning the number selected,
3882 and setting the first elements of SYMS items. Error if no symbols
3885 /* NOTE: Adapted from decode_line_2 in symtab.c, with which it ought
3886 to be re-integrated one of these days. */
3889 user_select_syms (struct block_symbol *syms, int nsyms, int max_results)
3892 int *chosen = XALLOCAVEC (int , nsyms);
3894 int first_choice = (max_results == 1) ? 1 : 2;
3895 const char *select_mode = multiple_symbols_select_mode ();
3897 if (max_results < 1)
3898 error (_("Request to select 0 symbols!"));
3902 if (select_mode == multiple_symbols_cancel)
3904 canceled because the command is ambiguous\n\
3905 See set/show multiple-symbol."));
3907 /* If select_mode is "all", then return all possible symbols.
3908 Only do that if more than one symbol can be selected, of course.
3909 Otherwise, display the menu as usual. */
3910 if (select_mode == multiple_symbols_all && max_results > 1)
3913 printf_filtered (_("[0] cancel\n"));
3914 if (max_results > 1)
3915 printf_filtered (_("[1] all\n"));
3917 sort_choices (syms, nsyms);
3919 for (i = 0; i < nsyms; i += 1)
3921 if (syms[i].symbol == NULL)
3924 if (SYMBOL_CLASS (syms[i].symbol) == LOC_BLOCK)
3926 struct symtab_and_line sal =
3927 find_function_start_sal (syms[i].symbol, 1);
3929 printf_filtered ("[%d] ", i + first_choice);
3930 ada_print_symbol_signature (gdb_stdout, syms[i].symbol,
3931 &type_print_raw_options);
3932 if (sal.symtab == NULL)
3933 printf_filtered (_(" at <no source file available>:%d\n"),
3936 printf_filtered (_(" at %s:%d\n"),
3937 symtab_to_filename_for_display (sal.symtab),
3944 (SYMBOL_CLASS (syms[i].symbol) == LOC_CONST
3945 && SYMBOL_TYPE (syms[i].symbol) != NULL
3946 && TYPE_CODE (SYMBOL_TYPE (syms[i].symbol)) == TYPE_CODE_ENUM);
3947 struct symtab *symtab = NULL;
3949 if (SYMBOL_OBJFILE_OWNED (syms[i].symbol))
3950 symtab = symbol_symtab (syms[i].symbol);
3952 if (SYMBOL_LINE (syms[i].symbol) != 0 && symtab != NULL)
3954 printf_filtered ("[%d] ", i + first_choice);
3955 ada_print_symbol_signature (gdb_stdout, syms[i].symbol,
3956 &type_print_raw_options);
3957 printf_filtered (_(" at %s:%d\n"),
3958 symtab_to_filename_for_display (symtab),
3959 SYMBOL_LINE (syms[i].symbol));
3961 else if (is_enumeral
3962 && TYPE_NAME (SYMBOL_TYPE (syms[i].symbol)) != NULL)
3964 printf_filtered (("[%d] "), i + first_choice);
3965 ada_print_type (SYMBOL_TYPE (syms[i].symbol), NULL,
3966 gdb_stdout, -1, 0, &type_print_raw_options);
3967 printf_filtered (_("'(%s) (enumeral)\n"),
3968 SYMBOL_PRINT_NAME (syms[i].symbol));
3972 printf_filtered ("[%d] ", i + first_choice);
3973 ada_print_symbol_signature (gdb_stdout, syms[i].symbol,
3974 &type_print_raw_options);
3977 printf_filtered (is_enumeral
3978 ? _(" in %s (enumeral)\n")
3980 symtab_to_filename_for_display (symtab));
3982 printf_filtered (is_enumeral
3983 ? _(" (enumeral)\n")
3989 n_chosen = get_selections (chosen, nsyms, max_results, max_results > 1,
3992 for (i = 0; i < n_chosen; i += 1)
3993 syms[i] = syms[chosen[i]];
3998 /* Read and validate a set of numeric choices from the user in the
3999 range 0 .. N_CHOICES-1. Place the results in increasing
4000 order in CHOICES[0 .. N-1], and return N.
4002 The user types choices as a sequence of numbers on one line
4003 separated by blanks, encoding them as follows:
4005 + A choice of 0 means to cancel the selection, throwing an error.
4006 + If IS_ALL_CHOICE, a choice of 1 selects the entire set 0 .. N_CHOICES-1.
4007 + The user chooses k by typing k+IS_ALL_CHOICE+1.
4009 The user is not allowed to choose more than MAX_RESULTS values.
4011 ANNOTATION_SUFFIX, if present, is used to annotate the input
4012 prompts (for use with the -f switch). */
4015 get_selections (int *choices, int n_choices, int max_results,
4016 int is_all_choice, const char *annotation_suffix)
4021 int first_choice = is_all_choice ? 2 : 1;
4023 prompt = getenv ("PS2");
4027 args = command_line_input (prompt, annotation_suffix);
4030 error_no_arg (_("one or more choice numbers"));
4034 /* Set choices[0 .. n_chosen-1] to the users' choices in ascending
4035 order, as given in args. Choices are validated. */
4041 args = skip_spaces (args);
4042 if (*args == '\0' && n_chosen == 0)
4043 error_no_arg (_("one or more choice numbers"));
4044 else if (*args == '\0')
4047 choice = strtol (args, &args2, 10);
4048 if (args == args2 || choice < 0
4049 || choice > n_choices + first_choice - 1)
4050 error (_("Argument must be choice number"));
4054 error (_("cancelled"));
4056 if (choice < first_choice)
4058 n_chosen = n_choices;
4059 for (j = 0; j < n_choices; j += 1)
4063 choice -= first_choice;
4065 for (j = n_chosen - 1; j >= 0 && choice < choices[j]; j -= 1)
4069 if (j < 0 || choice != choices[j])
4073 for (k = n_chosen - 1; k > j; k -= 1)
4074 choices[k + 1] = choices[k];
4075 choices[j + 1] = choice;
4080 if (n_chosen > max_results)
4081 error (_("Select no more than %d of the above"), max_results);
4086 /* Replace the operator of length OPLEN at position PC in *EXPP with a call
4087 on the function identified by SYM and BLOCK, and taking NARGS
4088 arguments. Update *EXPP as needed to hold more space. */
4091 replace_operator_with_call (expression_up *expp, int pc, int nargs,
4092 int oplen, struct symbol *sym,
4093 const struct block *block)
4095 /* A new expression, with 6 more elements (3 for funcall, 4 for function
4096 symbol, -oplen for operator being replaced). */
4097 struct expression *newexp = (struct expression *)
4098 xzalloc (sizeof (struct expression)
4099 + EXP_ELEM_TO_BYTES ((*expp)->nelts + 7 - oplen));
4100 struct expression *exp = expp->get ();
4102 newexp->nelts = exp->nelts + 7 - oplen;
4103 newexp->language_defn = exp->language_defn;
4104 newexp->gdbarch = exp->gdbarch;
4105 memcpy (newexp->elts, exp->elts, EXP_ELEM_TO_BYTES (pc));
4106 memcpy (newexp->elts + pc + 7, exp->elts + pc + oplen,
4107 EXP_ELEM_TO_BYTES (exp->nelts - pc - oplen));
4109 newexp->elts[pc].opcode = newexp->elts[pc + 2].opcode = OP_FUNCALL;
4110 newexp->elts[pc + 1].longconst = (LONGEST) nargs;
4112 newexp->elts[pc + 3].opcode = newexp->elts[pc + 6].opcode = OP_VAR_VALUE;
4113 newexp->elts[pc + 4].block = block;
4114 newexp->elts[pc + 5].symbol = sym;
4116 expp->reset (newexp);
4119 /* Type-class predicates */
4121 /* True iff TYPE is numeric (i.e., an INT, RANGE (of numeric type),
4125 numeric_type_p (struct type *type)
4131 switch (TYPE_CODE (type))
4136 case TYPE_CODE_RANGE:
4137 return (type == TYPE_TARGET_TYPE (type)
4138 || numeric_type_p (TYPE_TARGET_TYPE (type)));
4145 /* True iff TYPE is integral (an INT or RANGE of INTs). */
4148 integer_type_p (struct type *type)
4154 switch (TYPE_CODE (type))
4158 case TYPE_CODE_RANGE:
4159 return (type == TYPE_TARGET_TYPE (type)
4160 || integer_type_p (TYPE_TARGET_TYPE (type)));
4167 /* True iff TYPE is scalar (INT, RANGE, FLOAT, ENUM). */
4170 scalar_type_p (struct type *type)
4176 switch (TYPE_CODE (type))
4179 case TYPE_CODE_RANGE:
4180 case TYPE_CODE_ENUM:
4189 /* True iff TYPE is discrete (INT, RANGE, ENUM). */
4192 discrete_type_p (struct type *type)
4198 switch (TYPE_CODE (type))
4201 case TYPE_CODE_RANGE:
4202 case TYPE_CODE_ENUM:
4203 case TYPE_CODE_BOOL:
4211 /* Returns non-zero if OP with operands in the vector ARGS could be
4212 a user-defined function. Errs on the side of pre-defined operators
4213 (i.e., result 0). */
4216 possible_user_operator_p (enum exp_opcode op, struct value *args[])
4218 struct type *type0 =
4219 (args[0] == NULL) ? NULL : ada_check_typedef (value_type (args[0]));
4220 struct type *type1 =
4221 (args[1] == NULL) ? NULL : ada_check_typedef (value_type (args[1]));
4235 return (!(numeric_type_p (type0) && numeric_type_p (type1)));
4239 case BINOP_BITWISE_AND:
4240 case BINOP_BITWISE_IOR:
4241 case BINOP_BITWISE_XOR:
4242 return (!(integer_type_p (type0) && integer_type_p (type1)));
4245 case BINOP_NOTEQUAL:
4250 return (!(scalar_type_p (type0) && scalar_type_p (type1)));
4253 return !ada_is_array_type (type0) || !ada_is_array_type (type1);
4256 return (!(numeric_type_p (type0) && integer_type_p (type1)));
4260 case UNOP_LOGICAL_NOT:
4262 return (!numeric_type_p (type0));
4271 1. In the following, we assume that a renaming type's name may
4272 have an ___XD suffix. It would be nice if this went away at some
4274 2. We handle both the (old) purely type-based representation of
4275 renamings and the (new) variable-based encoding. At some point,
4276 it is devoutly to be hoped that the former goes away
4277 (FIXME: hilfinger-2007-07-09).
4278 3. Subprogram renamings are not implemented, although the XRS
4279 suffix is recognized (FIXME: hilfinger-2007-07-09). */
4281 /* If SYM encodes a renaming,
4283 <renaming> renames <renamed entity>,
4285 sets *LEN to the length of the renamed entity's name,
4286 *RENAMED_ENTITY to that name (not null-terminated), and *RENAMING_EXPR to
4287 the string describing the subcomponent selected from the renamed
4288 entity. Returns ADA_NOT_RENAMING if SYM does not encode a renaming
4289 (in which case, the values of *RENAMED_ENTITY, *LEN, and *RENAMING_EXPR
4290 are undefined). Otherwise, returns a value indicating the category
4291 of entity renamed: an object (ADA_OBJECT_RENAMING), exception
4292 (ADA_EXCEPTION_RENAMING), package (ADA_PACKAGE_RENAMING), or
4293 subprogram (ADA_SUBPROGRAM_RENAMING). Does no allocation; the
4294 strings returned in *RENAMED_ENTITY and *RENAMING_EXPR should not be
4295 deallocated. The values of RENAMED_ENTITY, LEN, or RENAMING_EXPR
4296 may be NULL, in which case they are not assigned.
4298 [Currently, however, GCC does not generate subprogram renamings.] */
4300 enum ada_renaming_category
4301 ada_parse_renaming (struct symbol *sym,
4302 const char **renamed_entity, int *len,
4303 const char **renaming_expr)
4305 enum ada_renaming_category kind;
4310 return ADA_NOT_RENAMING;
4311 switch (SYMBOL_CLASS (sym))
4314 return ADA_NOT_RENAMING;
4316 return parse_old_style_renaming (SYMBOL_TYPE (sym),
4317 renamed_entity, len, renaming_expr);
4321 case LOC_OPTIMIZED_OUT:
4322 info = strstr (SYMBOL_LINKAGE_NAME (sym), "___XR");
4324 return ADA_NOT_RENAMING;
4328 kind = ADA_OBJECT_RENAMING;
4332 kind = ADA_EXCEPTION_RENAMING;
4336 kind = ADA_PACKAGE_RENAMING;
4340 kind = ADA_SUBPROGRAM_RENAMING;
4344 return ADA_NOT_RENAMING;
4348 if (renamed_entity != NULL)
4349 *renamed_entity = info;
4350 suffix = strstr (info, "___XE");
4351 if (suffix == NULL || suffix == info)
4352 return ADA_NOT_RENAMING;
4354 *len = strlen (info) - strlen (suffix);
4356 if (renaming_expr != NULL)
4357 *renaming_expr = suffix;
4361 /* Assuming TYPE encodes a renaming according to the old encoding in
4362 exp_dbug.ads, returns details of that renaming in *RENAMED_ENTITY,
4363 *LEN, and *RENAMING_EXPR, as for ada_parse_renaming, above. Returns
4364 ADA_NOT_RENAMING otherwise. */
4365 static enum ada_renaming_category
4366 parse_old_style_renaming (struct type *type,
4367 const char **renamed_entity, int *len,
4368 const char **renaming_expr)
4370 enum ada_renaming_category kind;
4375 if (type == NULL || TYPE_CODE (type) != TYPE_CODE_ENUM
4376 || TYPE_NFIELDS (type) != 1)
4377 return ADA_NOT_RENAMING;
4379 name = TYPE_NAME (type);
4381 return ADA_NOT_RENAMING;
4383 name = strstr (name, "___XR");
4385 return ADA_NOT_RENAMING;
4390 kind = ADA_OBJECT_RENAMING;
4393 kind = ADA_EXCEPTION_RENAMING;
4396 kind = ADA_PACKAGE_RENAMING;
4399 kind = ADA_SUBPROGRAM_RENAMING;
4402 return ADA_NOT_RENAMING;
4405 info = TYPE_FIELD_NAME (type, 0);
4407 return ADA_NOT_RENAMING;
4408 if (renamed_entity != NULL)
4409 *renamed_entity = info;
4410 suffix = strstr (info, "___XE");
4411 if (renaming_expr != NULL)
4412 *renaming_expr = suffix + 5;
4413 if (suffix == NULL || suffix == info)
4414 return ADA_NOT_RENAMING;
4416 *len = suffix - info;
4420 /* Compute the value of the given RENAMING_SYM, which is expected to
4421 be a symbol encoding a renaming expression. BLOCK is the block
4422 used to evaluate the renaming. */
4424 static struct value *
4425 ada_read_renaming_var_value (struct symbol *renaming_sym,
4426 const struct block *block)
4428 const char *sym_name;
4430 sym_name = SYMBOL_LINKAGE_NAME (renaming_sym);
4431 expression_up expr = parse_exp_1 (&sym_name, 0, block, 0);
4432 return evaluate_expression (expr.get ());
4436 /* Evaluation: Function Calls */
4438 /* Return an lvalue containing the value VAL. This is the identity on
4439 lvalues, and otherwise has the side-effect of allocating memory
4440 in the inferior where a copy of the value contents is copied. */
4442 static struct value *
4443 ensure_lval (struct value *val)
4445 if (VALUE_LVAL (val) == not_lval
4446 || VALUE_LVAL (val) == lval_internalvar)
4448 int len = TYPE_LENGTH (ada_check_typedef (value_type (val)));
4449 const CORE_ADDR addr =
4450 value_as_long (value_allocate_space_in_inferior (len));
4452 VALUE_LVAL (val) = lval_memory;
4453 set_value_address (val, addr);
4454 write_memory (addr, value_contents (val), len);
4460 /* Return the value ACTUAL, converted to be an appropriate value for a
4461 formal of type FORMAL_TYPE. Use *SP as a stack pointer for
4462 allocating any necessary descriptors (fat pointers), or copies of
4463 values not residing in memory, updating it as needed. */
4466 ada_convert_actual (struct value *actual, struct type *formal_type0)
4468 struct type *actual_type = ada_check_typedef (value_type (actual));
4469 struct type *formal_type = ada_check_typedef (formal_type0);
4470 struct type *formal_target =
4471 TYPE_CODE (formal_type) == TYPE_CODE_PTR
4472 ? ada_check_typedef (TYPE_TARGET_TYPE (formal_type)) : formal_type;
4473 struct type *actual_target =
4474 TYPE_CODE (actual_type) == TYPE_CODE_PTR
4475 ? ada_check_typedef (TYPE_TARGET_TYPE (actual_type)) : actual_type;
4477 if (ada_is_array_descriptor_type (formal_target)
4478 && TYPE_CODE (actual_target) == TYPE_CODE_ARRAY)
4479 return make_array_descriptor (formal_type, actual);
4480 else if (TYPE_CODE (formal_type) == TYPE_CODE_PTR
4481 || TYPE_CODE (formal_type) == TYPE_CODE_REF)
4483 struct value *result;
4485 if (TYPE_CODE (formal_target) == TYPE_CODE_ARRAY
4486 && ada_is_array_descriptor_type (actual_target))
4487 result = desc_data (actual);
4488 else if (TYPE_CODE (formal_type) != TYPE_CODE_PTR)
4490 if (VALUE_LVAL (actual) != lval_memory)
4494 actual_type = ada_check_typedef (value_type (actual));
4495 val = allocate_value (actual_type);
4496 memcpy ((char *) value_contents_raw (val),
4497 (char *) value_contents (actual),
4498 TYPE_LENGTH (actual_type));
4499 actual = ensure_lval (val);
4501 result = value_addr (actual);
4505 return value_cast_pointers (formal_type, result, 0);
4507 else if (TYPE_CODE (actual_type) == TYPE_CODE_PTR)
4508 return ada_value_ind (actual);
4509 else if (ada_is_aligner_type (formal_type))
4511 /* We need to turn this parameter into an aligner type
4513 struct value *aligner = allocate_value (formal_type);
4514 struct value *component = ada_value_struct_elt (aligner, "F", 0);
4516 value_assign_to_component (aligner, component, actual);
4523 /* Convert VALUE (which must be an address) to a CORE_ADDR that is a pointer of
4524 type TYPE. This is usually an inefficient no-op except on some targets
4525 (such as AVR) where the representation of a pointer and an address
4529 value_pointer (struct value *value, struct type *type)
4531 struct gdbarch *gdbarch = get_type_arch (type);
4532 unsigned len = TYPE_LENGTH (type);
4533 gdb_byte *buf = (gdb_byte *) alloca (len);
4536 addr = value_address (value);
4537 gdbarch_address_to_pointer (gdbarch, type, buf, addr);
4538 addr = extract_unsigned_integer (buf, len, gdbarch_byte_order (gdbarch));
4543 /* Push a descriptor of type TYPE for array value ARR on the stack at
4544 *SP, updating *SP to reflect the new descriptor. Return either
4545 an lvalue representing the new descriptor, or (if TYPE is a pointer-
4546 to-descriptor type rather than a descriptor type), a struct value *
4547 representing a pointer to this descriptor. */
4549 static struct value *
4550 make_array_descriptor (struct type *type, struct value *arr)
4552 struct type *bounds_type = desc_bounds_type (type);
4553 struct type *desc_type = desc_base_type (type);
4554 struct value *descriptor = allocate_value (desc_type);
4555 struct value *bounds = allocate_value (bounds_type);
4558 for (i = ada_array_arity (ada_check_typedef (value_type (arr)));
4561 modify_field (value_type (bounds), value_contents_writeable (bounds),
4562 ada_array_bound (arr, i, 0),
4563 desc_bound_bitpos (bounds_type, i, 0),
4564 desc_bound_bitsize (bounds_type, i, 0));
4565 modify_field (value_type (bounds), value_contents_writeable (bounds),
4566 ada_array_bound (arr, i, 1),
4567 desc_bound_bitpos (bounds_type, i, 1),
4568 desc_bound_bitsize (bounds_type, i, 1));
4571 bounds = ensure_lval (bounds);
4573 modify_field (value_type (descriptor),
4574 value_contents_writeable (descriptor),
4575 value_pointer (ensure_lval (arr),
4576 TYPE_FIELD_TYPE (desc_type, 0)),
4577 fat_pntr_data_bitpos (desc_type),
4578 fat_pntr_data_bitsize (desc_type));
4580 modify_field (value_type (descriptor),
4581 value_contents_writeable (descriptor),
4582 value_pointer (bounds,
4583 TYPE_FIELD_TYPE (desc_type, 1)),
4584 fat_pntr_bounds_bitpos (desc_type),
4585 fat_pntr_bounds_bitsize (desc_type));
4587 descriptor = ensure_lval (descriptor);
4589 if (TYPE_CODE (type) == TYPE_CODE_PTR)
4590 return value_addr (descriptor);
4595 /* Symbol Cache Module */
4597 /* Performance measurements made as of 2010-01-15 indicate that
4598 this cache does bring some noticeable improvements. Depending
4599 on the type of entity being printed, the cache can make it as much
4600 as an order of magnitude faster than without it.
4602 The descriptive type DWARF extension has significantly reduced
4603 the need for this cache, at least when DWARF is being used. However,
4604 even in this case, some expensive name-based symbol searches are still
4605 sometimes necessary - to find an XVZ variable, mostly. */
4607 /* Initialize the contents of SYM_CACHE. */
4610 ada_init_symbol_cache (struct ada_symbol_cache *sym_cache)
4612 obstack_init (&sym_cache->cache_space);
4613 memset (sym_cache->root, '\000', sizeof (sym_cache->root));
4616 /* Free the memory used by SYM_CACHE. */
4619 ada_free_symbol_cache (struct ada_symbol_cache *sym_cache)
4621 obstack_free (&sym_cache->cache_space, NULL);
4625 /* Return the symbol cache associated to the given program space PSPACE.
4626 If not allocated for this PSPACE yet, allocate and initialize one. */
4628 static struct ada_symbol_cache *
4629 ada_get_symbol_cache (struct program_space *pspace)
4631 struct ada_pspace_data *pspace_data = get_ada_pspace_data (pspace);
4633 if (pspace_data->sym_cache == NULL)
4635 pspace_data->sym_cache = XCNEW (struct ada_symbol_cache);
4636 ada_init_symbol_cache (pspace_data->sym_cache);
4639 return pspace_data->sym_cache;
4642 /* Clear all entries from the symbol cache. */
4645 ada_clear_symbol_cache (void)
4647 struct ada_symbol_cache *sym_cache
4648 = ada_get_symbol_cache (current_program_space);
4650 obstack_free (&sym_cache->cache_space, NULL);
4651 ada_init_symbol_cache (sym_cache);
4654 /* Search our cache for an entry matching NAME and DOMAIN.
4655 Return it if found, or NULL otherwise. */
4657 static struct cache_entry **
4658 find_entry (const char *name, domain_enum domain)
4660 struct ada_symbol_cache *sym_cache
4661 = ada_get_symbol_cache (current_program_space);
4662 int h = msymbol_hash (name) % HASH_SIZE;
4663 struct cache_entry **e;
4665 for (e = &sym_cache->root[h]; *e != NULL; e = &(*e)->next)
4667 if (domain == (*e)->domain && strcmp (name, (*e)->name) == 0)
4673 /* Search the symbol cache for an entry matching NAME and DOMAIN.
4674 Return 1 if found, 0 otherwise.
4676 If an entry was found and SYM is not NULL, set *SYM to the entry's
4677 SYM. Same principle for BLOCK if not NULL. */
4680 lookup_cached_symbol (const char *name, domain_enum domain,
4681 struct symbol **sym, const struct block **block)
4683 struct cache_entry **e = find_entry (name, domain);
4690 *block = (*e)->block;
4694 /* Assuming that (SYM, BLOCK) is the result of the lookup of NAME
4695 in domain DOMAIN, save this result in our symbol cache. */
4698 cache_symbol (const char *name, domain_enum domain, struct symbol *sym,
4699 const struct block *block)
4701 struct ada_symbol_cache *sym_cache
4702 = ada_get_symbol_cache (current_program_space);
4705 struct cache_entry *e;
4707 /* Symbols for builtin types don't have a block.
4708 For now don't cache such symbols. */
4709 if (sym != NULL && !SYMBOL_OBJFILE_OWNED (sym))
4712 /* If the symbol is a local symbol, then do not cache it, as a search
4713 for that symbol depends on the context. To determine whether
4714 the symbol is local or not, we check the block where we found it
4715 against the global and static blocks of its associated symtab. */
4717 && BLOCKVECTOR_BLOCK (SYMTAB_BLOCKVECTOR (symbol_symtab (sym)),
4718 GLOBAL_BLOCK) != block
4719 && BLOCKVECTOR_BLOCK (SYMTAB_BLOCKVECTOR (symbol_symtab (sym)),
4720 STATIC_BLOCK) != block)
4723 h = msymbol_hash (name) % HASH_SIZE;
4724 e = XOBNEW (&sym_cache->cache_space, cache_entry);
4725 e->next = sym_cache->root[h];
4726 sym_cache->root[h] = e;
4728 = (char *) obstack_alloc (&sym_cache->cache_space, strlen (name) + 1);
4729 strcpy (copy, name);
4737 /* Return the symbol name match type that should be used used when
4738 searching for all symbols matching LOOKUP_NAME.
4740 LOOKUP_NAME is expected to be a symbol name after transformation
4743 static symbol_name_match_type
4744 name_match_type_from_name (const char *lookup_name)
4746 return (strstr (lookup_name, "__") == NULL
4747 ? symbol_name_match_type::WILD
4748 : symbol_name_match_type::FULL);
4751 /* Return the result of a standard (literal, C-like) lookup of NAME in
4752 given DOMAIN, visible from lexical block BLOCK. */
4754 static struct symbol *
4755 standard_lookup (const char *name, const struct block *block,
4758 /* Initialize it just to avoid a GCC false warning. */
4759 struct block_symbol sym = {NULL, NULL};
4761 if (lookup_cached_symbol (name, domain, &sym.symbol, NULL))
4763 ada_lookup_encoded_symbol (name, block, domain, &sym);
4764 cache_symbol (name, domain, sym.symbol, sym.block);
4769 /* Non-zero iff there is at least one non-function/non-enumeral symbol
4770 in the symbol fields of SYMS[0..N-1]. We treat enumerals as functions,
4771 since they contend in overloading in the same way. */
4773 is_nonfunction (struct block_symbol syms[], int n)
4777 for (i = 0; i < n; i += 1)
4778 if (TYPE_CODE (SYMBOL_TYPE (syms[i].symbol)) != TYPE_CODE_FUNC
4779 && (TYPE_CODE (SYMBOL_TYPE (syms[i].symbol)) != TYPE_CODE_ENUM
4780 || SYMBOL_CLASS (syms[i].symbol) != LOC_CONST))
4786 /* If true (non-zero), then TYPE0 and TYPE1 represent equivalent
4787 struct types. Otherwise, they may not. */
4790 equiv_types (struct type *type0, struct type *type1)
4794 if (type0 == NULL || type1 == NULL
4795 || TYPE_CODE (type0) != TYPE_CODE (type1))
4797 if ((TYPE_CODE (type0) == TYPE_CODE_STRUCT
4798 || TYPE_CODE (type0) == TYPE_CODE_ENUM)
4799 && ada_type_name (type0) != NULL && ada_type_name (type1) != NULL
4800 && strcmp (ada_type_name (type0), ada_type_name (type1)) == 0)
4806 /* True iff SYM0 represents the same entity as SYM1, or one that is
4807 no more defined than that of SYM1. */
4810 lesseq_defined_than (struct symbol *sym0, struct symbol *sym1)
4814 if (SYMBOL_DOMAIN (sym0) != SYMBOL_DOMAIN (sym1)
4815 || SYMBOL_CLASS (sym0) != SYMBOL_CLASS (sym1))
4818 switch (SYMBOL_CLASS (sym0))
4824 struct type *type0 = SYMBOL_TYPE (sym0);
4825 struct type *type1 = SYMBOL_TYPE (sym1);
4826 const char *name0 = SYMBOL_LINKAGE_NAME (sym0);
4827 const char *name1 = SYMBOL_LINKAGE_NAME (sym1);
4828 int len0 = strlen (name0);
4831 TYPE_CODE (type0) == TYPE_CODE (type1)
4832 && (equiv_types (type0, type1)
4833 || (len0 < strlen (name1) && strncmp (name0, name1, len0) == 0
4834 && startswith (name1 + len0, "___XV")));
4837 return SYMBOL_VALUE (sym0) == SYMBOL_VALUE (sym1)
4838 && equiv_types (SYMBOL_TYPE (sym0), SYMBOL_TYPE (sym1));
4844 /* Append (SYM,BLOCK,SYMTAB) to the end of the array of struct block_symbol
4845 records in OBSTACKP. Do nothing if SYM is a duplicate. */
4848 add_defn_to_vec (struct obstack *obstackp,
4850 const struct block *block)
4853 struct block_symbol *prevDefns = defns_collected (obstackp, 0);
4855 /* Do not try to complete stub types, as the debugger is probably
4856 already scanning all symbols matching a certain name at the
4857 time when this function is called. Trying to replace the stub
4858 type by its associated full type will cause us to restart a scan
4859 which may lead to an infinite recursion. Instead, the client
4860 collecting the matching symbols will end up collecting several
4861 matches, with at least one of them complete. It can then filter
4862 out the stub ones if needed. */
4864 for (i = num_defns_collected (obstackp) - 1; i >= 0; i -= 1)
4866 if (lesseq_defined_than (sym, prevDefns[i].symbol))
4868 else if (lesseq_defined_than (prevDefns[i].symbol, sym))
4870 prevDefns[i].symbol = sym;
4871 prevDefns[i].block = block;
4877 struct block_symbol info;
4881 obstack_grow (obstackp, &info, sizeof (struct block_symbol));
4885 /* Number of block_symbol structures currently collected in current vector in
4889 num_defns_collected (struct obstack *obstackp)
4891 return obstack_object_size (obstackp) / sizeof (struct block_symbol);
4894 /* Vector of block_symbol structures currently collected in current vector in
4895 OBSTACKP. If FINISH, close off the vector and return its final address. */
4897 static struct block_symbol *
4898 defns_collected (struct obstack *obstackp, int finish)
4901 return (struct block_symbol *) obstack_finish (obstackp);
4903 return (struct block_symbol *) obstack_base (obstackp);
4906 /* Return a bound minimal symbol matching NAME according to Ada
4907 decoding rules. Returns an invalid symbol if there is no such
4908 minimal symbol. Names prefixed with "standard__" are handled
4909 specially: "standard__" is first stripped off, and only static and
4910 global symbols are searched. */
4912 struct bound_minimal_symbol
4913 ada_lookup_simple_minsym (const char *name)
4915 struct bound_minimal_symbol result;
4917 memset (&result, 0, sizeof (result));
4919 symbol_name_match_type match_type = name_match_type_from_name (name);
4920 lookup_name_info lookup_name (name, match_type);
4922 symbol_name_matcher_ftype *match_name
4923 = ada_get_symbol_name_matcher (lookup_name);
4925 for (objfile *objfile : current_program_space->objfiles ())
4927 for (minimal_symbol *msymbol : objfile->msymbols ())
4929 if (match_name (MSYMBOL_LINKAGE_NAME (msymbol), lookup_name, NULL)
4930 && MSYMBOL_TYPE (msymbol) != mst_solib_trampoline)
4932 result.minsym = msymbol;
4933 result.objfile = objfile;
4942 /* For all subprograms that statically enclose the subprogram of the
4943 selected frame, add symbols matching identifier NAME in DOMAIN
4944 and their blocks to the list of data in OBSTACKP, as for
4945 ada_add_block_symbols (q.v.). If WILD_MATCH_P, treat as NAME
4946 with a wildcard prefix. */
4949 add_symbols_from_enclosing_procs (struct obstack *obstackp,
4950 const lookup_name_info &lookup_name,
4955 /* True if TYPE is definitely an artificial type supplied to a symbol
4956 for which no debugging information was given in the symbol file. */
4959 is_nondebugging_type (struct type *type)
4961 const char *name = ada_type_name (type);
4963 return (name != NULL && strcmp (name, "<variable, no debug info>") == 0);
4966 /* Return nonzero if TYPE1 and TYPE2 are two enumeration types
4967 that are deemed "identical" for practical purposes.
4969 This function assumes that TYPE1 and TYPE2 are both TYPE_CODE_ENUM
4970 types and that their number of enumerals is identical (in other
4971 words, TYPE_NFIELDS (type1) == TYPE_NFIELDS (type2)). */
4974 ada_identical_enum_types_p (struct type *type1, struct type *type2)
4978 /* The heuristic we use here is fairly conservative. We consider
4979 that 2 enumerate types are identical if they have the same
4980 number of enumerals and that all enumerals have the same
4981 underlying value and name. */
4983 /* All enums in the type should have an identical underlying value. */
4984 for (i = 0; i < TYPE_NFIELDS (type1); i++)
4985 if (TYPE_FIELD_ENUMVAL (type1, i) != TYPE_FIELD_ENUMVAL (type2, i))
4988 /* All enumerals should also have the same name (modulo any numerical
4990 for (i = 0; i < TYPE_NFIELDS (type1); i++)
4992 const char *name_1 = TYPE_FIELD_NAME (type1, i);
4993 const char *name_2 = TYPE_FIELD_NAME (type2, i);
4994 int len_1 = strlen (name_1);
4995 int len_2 = strlen (name_2);
4997 ada_remove_trailing_digits (TYPE_FIELD_NAME (type1, i), &len_1);
4998 ada_remove_trailing_digits (TYPE_FIELD_NAME (type2, i), &len_2);
5000 || strncmp (TYPE_FIELD_NAME (type1, i),
5001 TYPE_FIELD_NAME (type2, i),
5009 /* Return nonzero if all the symbols in SYMS are all enumeral symbols
5010 that are deemed "identical" for practical purposes. Sometimes,
5011 enumerals are not strictly identical, but their types are so similar
5012 that they can be considered identical.
5014 For instance, consider the following code:
5016 type Color is (Black, Red, Green, Blue, White);
5017 type RGB_Color is new Color range Red .. Blue;
5019 Type RGB_Color is a subrange of an implicit type which is a copy
5020 of type Color. If we call that implicit type RGB_ColorB ("B" is
5021 for "Base Type"), then type RGB_ColorB is a copy of type Color.
5022 As a result, when an expression references any of the enumeral
5023 by name (Eg. "print green"), the expression is technically
5024 ambiguous and the user should be asked to disambiguate. But
5025 doing so would only hinder the user, since it wouldn't matter
5026 what choice he makes, the outcome would always be the same.
5027 So, for practical purposes, we consider them as the same. */
5030 symbols_are_identical_enums (const std::vector<struct block_symbol> &syms)
5034 /* Before performing a thorough comparison check of each type,
5035 we perform a series of inexpensive checks. We expect that these
5036 checks will quickly fail in the vast majority of cases, and thus
5037 help prevent the unnecessary use of a more expensive comparison.
5038 Said comparison also expects us to make some of these checks
5039 (see ada_identical_enum_types_p). */
5041 /* Quick check: All symbols should have an enum type. */
5042 for (i = 0; i < syms.size (); i++)
5043 if (TYPE_CODE (SYMBOL_TYPE (syms[i].symbol)) != TYPE_CODE_ENUM)
5046 /* Quick check: They should all have the same value. */
5047 for (i = 1; i < syms.size (); i++)
5048 if (SYMBOL_VALUE (syms[i].symbol) != SYMBOL_VALUE (syms[0].symbol))
5051 /* Quick check: They should all have the same number of enumerals. */
5052 for (i = 1; i < syms.size (); i++)
5053 if (TYPE_NFIELDS (SYMBOL_TYPE (syms[i].symbol))
5054 != TYPE_NFIELDS (SYMBOL_TYPE (syms[0].symbol)))
5057 /* All the sanity checks passed, so we might have a set of
5058 identical enumeration types. Perform a more complete
5059 comparison of the type of each symbol. */
5060 for (i = 1; i < syms.size (); i++)
5061 if (!ada_identical_enum_types_p (SYMBOL_TYPE (syms[i].symbol),
5062 SYMBOL_TYPE (syms[0].symbol)))
5068 /* Remove any non-debugging symbols in SYMS that definitely
5069 duplicate other symbols in the list (The only case I know of where
5070 this happens is when object files containing stabs-in-ecoff are
5071 linked with files containing ordinary ecoff debugging symbols (or no
5072 debugging symbols)). Modifies SYMS to squeeze out deleted entries.
5073 Returns the number of items in the modified list. */
5076 remove_extra_symbols (std::vector<struct block_symbol> *syms)
5080 /* We should never be called with less than 2 symbols, as there
5081 cannot be any extra symbol in that case. But it's easy to
5082 handle, since we have nothing to do in that case. */
5083 if (syms->size () < 2)
5084 return syms->size ();
5087 while (i < syms->size ())
5091 /* If two symbols have the same name and one of them is a stub type,
5092 the get rid of the stub. */
5094 if (TYPE_STUB (SYMBOL_TYPE ((*syms)[i].symbol))
5095 && SYMBOL_LINKAGE_NAME ((*syms)[i].symbol) != NULL)
5097 for (j = 0; j < syms->size (); j++)
5100 && !TYPE_STUB (SYMBOL_TYPE ((*syms)[j].symbol))
5101 && SYMBOL_LINKAGE_NAME ((*syms)[j].symbol) != NULL
5102 && strcmp (SYMBOL_LINKAGE_NAME ((*syms)[i].symbol),
5103 SYMBOL_LINKAGE_NAME ((*syms)[j].symbol)) == 0)
5108 /* Two symbols with the same name, same class and same address
5109 should be identical. */
5111 else if (SYMBOL_LINKAGE_NAME ((*syms)[i].symbol) != NULL
5112 && SYMBOL_CLASS ((*syms)[i].symbol) == LOC_STATIC
5113 && is_nondebugging_type (SYMBOL_TYPE ((*syms)[i].symbol)))
5115 for (j = 0; j < syms->size (); j += 1)
5118 && SYMBOL_LINKAGE_NAME ((*syms)[j].symbol) != NULL
5119 && strcmp (SYMBOL_LINKAGE_NAME ((*syms)[i].symbol),
5120 SYMBOL_LINKAGE_NAME ((*syms)[j].symbol)) == 0
5121 && SYMBOL_CLASS ((*syms)[i].symbol)
5122 == SYMBOL_CLASS ((*syms)[j].symbol)
5123 && SYMBOL_VALUE_ADDRESS ((*syms)[i].symbol)
5124 == SYMBOL_VALUE_ADDRESS ((*syms)[j].symbol))
5130 syms->erase (syms->begin () + i);
5135 /* If all the remaining symbols are identical enumerals, then
5136 just keep the first one and discard the rest.
5138 Unlike what we did previously, we do not discard any entry
5139 unless they are ALL identical. This is because the symbol
5140 comparison is not a strict comparison, but rather a practical
5141 comparison. If all symbols are considered identical, then
5142 we can just go ahead and use the first one and discard the rest.
5143 But if we cannot reduce the list to a single element, we have
5144 to ask the user to disambiguate anyways. And if we have to
5145 present a multiple-choice menu, it's less confusing if the list
5146 isn't missing some choices that were identical and yet distinct. */
5147 if (symbols_are_identical_enums (*syms))
5150 return syms->size ();
5153 /* Given a type that corresponds to a renaming entity, use the type name
5154 to extract the scope (package name or function name, fully qualified,
5155 and following the GNAT encoding convention) where this renaming has been
5159 xget_renaming_scope (struct type *renaming_type)
5161 /* The renaming types adhere to the following convention:
5162 <scope>__<rename>___<XR extension>.
5163 So, to extract the scope, we search for the "___XR" extension,
5164 and then backtrack until we find the first "__". */
5166 const char *name = TYPE_NAME (renaming_type);
5167 const char *suffix = strstr (name, "___XR");
5170 /* Now, backtrack a bit until we find the first "__". Start looking
5171 at suffix - 3, as the <rename> part is at least one character long. */
5173 for (last = suffix - 3; last > name; last--)
5174 if (last[0] == '_' && last[1] == '_')
5177 /* Make a copy of scope and return it. */
5178 return std::string (name, last);
5181 /* Return nonzero if NAME corresponds to a package name. */
5184 is_package_name (const char *name)
5186 /* Here, We take advantage of the fact that no symbols are generated
5187 for packages, while symbols are generated for each function.
5188 So the condition for NAME represent a package becomes equivalent
5189 to NAME not existing in our list of symbols. There is only one
5190 small complication with library-level functions (see below). */
5192 /* If it is a function that has not been defined at library level,
5193 then we should be able to look it up in the symbols. */
5194 if (standard_lookup (name, NULL, VAR_DOMAIN) != NULL)
5197 /* Library-level function names start with "_ada_". See if function
5198 "_ada_" followed by NAME can be found. */
5200 /* Do a quick check that NAME does not contain "__", since library-level
5201 functions names cannot contain "__" in them. */
5202 if (strstr (name, "__") != NULL)
5205 std::string fun_name = string_printf ("_ada_%s", name);
5207 return (standard_lookup (fun_name.c_str (), NULL, VAR_DOMAIN) == NULL);
5210 /* Return nonzero if SYM corresponds to a renaming entity that is
5211 not visible from FUNCTION_NAME. */
5214 old_renaming_is_invisible (const struct symbol *sym, const char *function_name)
5216 if (SYMBOL_CLASS (sym) != LOC_TYPEDEF)
5219 std::string scope = xget_renaming_scope (SYMBOL_TYPE (sym));
5221 /* If the rename has been defined in a package, then it is visible. */
5222 if (is_package_name (scope.c_str ()))
5225 /* Check that the rename is in the current function scope by checking
5226 that its name starts with SCOPE. */
5228 /* If the function name starts with "_ada_", it means that it is
5229 a library-level function. Strip this prefix before doing the
5230 comparison, as the encoding for the renaming does not contain
5232 if (startswith (function_name, "_ada_"))
5235 return !startswith (function_name, scope.c_str ());
5238 /* Remove entries from SYMS that corresponds to a renaming entity that
5239 is not visible from the function associated with CURRENT_BLOCK or
5240 that is superfluous due to the presence of more specific renaming
5241 information. Places surviving symbols in the initial entries of
5242 SYMS and returns the number of surviving symbols.
5245 First, in cases where an object renaming is implemented as a
5246 reference variable, GNAT may produce both the actual reference
5247 variable and the renaming encoding. In this case, we discard the
5250 Second, GNAT emits a type following a specified encoding for each renaming
5251 entity. Unfortunately, STABS currently does not support the definition
5252 of types that are local to a given lexical block, so all renamings types
5253 are emitted at library level. As a consequence, if an application
5254 contains two renaming entities using the same name, and a user tries to
5255 print the value of one of these entities, the result of the ada symbol
5256 lookup will also contain the wrong renaming type.
5258 This function partially covers for this limitation by attempting to
5259 remove from the SYMS list renaming symbols that should be visible
5260 from CURRENT_BLOCK. However, there does not seem be a 100% reliable
5261 method with the current information available. The implementation
5262 below has a couple of limitations (FIXME: brobecker-2003-05-12):
5264 - When the user tries to print a rename in a function while there
5265 is another rename entity defined in a package: Normally, the
5266 rename in the function has precedence over the rename in the
5267 package, so the latter should be removed from the list. This is
5268 currently not the case.
5270 - This function will incorrectly remove valid renames if
5271 the CURRENT_BLOCK corresponds to a function which symbol name
5272 has been changed by an "Export" pragma. As a consequence,
5273 the user will be unable to print such rename entities. */
5276 remove_irrelevant_renamings (std::vector<struct block_symbol> *syms,
5277 const struct block *current_block)
5279 struct symbol *current_function;
5280 const char *current_function_name;
5282 int is_new_style_renaming;
5284 /* If there is both a renaming foo___XR... encoded as a variable and
5285 a simple variable foo in the same block, discard the latter.
5286 First, zero out such symbols, then compress. */
5287 is_new_style_renaming = 0;
5288 for (i = 0; i < syms->size (); i += 1)
5290 struct symbol *sym = (*syms)[i].symbol;
5291 const struct block *block = (*syms)[i].block;
5295 if (sym == NULL || SYMBOL_CLASS (sym) == LOC_TYPEDEF)
5297 name = SYMBOL_LINKAGE_NAME (sym);
5298 suffix = strstr (name, "___XR");
5302 int name_len = suffix - name;
5305 is_new_style_renaming = 1;
5306 for (j = 0; j < syms->size (); j += 1)
5307 if (i != j && (*syms)[j].symbol != NULL
5308 && strncmp (name, SYMBOL_LINKAGE_NAME ((*syms)[j].symbol),
5310 && block == (*syms)[j].block)
5311 (*syms)[j].symbol = NULL;
5314 if (is_new_style_renaming)
5318 for (j = k = 0; j < syms->size (); j += 1)
5319 if ((*syms)[j].symbol != NULL)
5321 (*syms)[k] = (*syms)[j];
5327 /* Extract the function name associated to CURRENT_BLOCK.
5328 Abort if unable to do so. */
5330 if (current_block == NULL)
5331 return syms->size ();
5333 current_function = block_linkage_function (current_block);
5334 if (current_function == NULL)
5335 return syms->size ();
5337 current_function_name = SYMBOL_LINKAGE_NAME (current_function);
5338 if (current_function_name == NULL)
5339 return syms->size ();
5341 /* Check each of the symbols, and remove it from the list if it is
5342 a type corresponding to a renaming that is out of the scope of
5343 the current block. */
5346 while (i < syms->size ())
5348 if (ada_parse_renaming ((*syms)[i].symbol, NULL, NULL, NULL)
5349 == ADA_OBJECT_RENAMING
5350 && old_renaming_is_invisible ((*syms)[i].symbol,
5351 current_function_name))
5352 syms->erase (syms->begin () + i);
5357 return syms->size ();
5360 /* Add to OBSTACKP all symbols from BLOCK (and its super-blocks)
5361 whose name and domain match NAME and DOMAIN respectively.
5362 If no match was found, then extend the search to "enclosing"
5363 routines (in other words, if we're inside a nested function,
5364 search the symbols defined inside the enclosing functions).
5365 If WILD_MATCH_P is nonzero, perform the naming matching in
5366 "wild" mode (see function "wild_match" for more info).
5368 Note: This function assumes that OBSTACKP has 0 (zero) element in it. */
5371 ada_add_local_symbols (struct obstack *obstackp,
5372 const lookup_name_info &lookup_name,
5373 const struct block *block, domain_enum domain)
5375 int block_depth = 0;
5377 while (block != NULL)
5380 ada_add_block_symbols (obstackp, block, lookup_name, domain, NULL);
5382 /* If we found a non-function match, assume that's the one. */
5383 if (is_nonfunction (defns_collected (obstackp, 0),
5384 num_defns_collected (obstackp)))
5387 block = BLOCK_SUPERBLOCK (block);
5390 /* If no luck so far, try to find NAME as a local symbol in some lexically
5391 enclosing subprogram. */
5392 if (num_defns_collected (obstackp) == 0 && block_depth > 2)
5393 add_symbols_from_enclosing_procs (obstackp, lookup_name, domain);
5396 /* An object of this type is used as the user_data argument when
5397 calling the map_matching_symbols method. */
5401 struct objfile *objfile;
5402 struct obstack *obstackp;
5403 struct symbol *arg_sym;
5407 /* A callback for add_nonlocal_symbols that adds SYM, found in BLOCK,
5408 to a list of symbols. DATA0 is a pointer to a struct match_data *
5409 containing the obstack that collects the symbol list, the file that SYM
5410 must come from, a flag indicating whether a non-argument symbol has
5411 been found in the current block, and the last argument symbol
5412 passed in SYM within the current block (if any). When SYM is null,
5413 marking the end of a block, the argument symbol is added if no
5414 other has been found. */
5417 aux_add_nonlocal_symbols (struct block *block, struct symbol *sym, void *data0)
5419 struct match_data *data = (struct match_data *) data0;
5423 if (!data->found_sym && data->arg_sym != NULL)
5424 add_defn_to_vec (data->obstackp,
5425 fixup_symbol_section (data->arg_sym, data->objfile),
5427 data->found_sym = 0;
5428 data->arg_sym = NULL;
5432 if (SYMBOL_CLASS (sym) == LOC_UNRESOLVED)
5434 else if (SYMBOL_IS_ARGUMENT (sym))
5435 data->arg_sym = sym;
5438 data->found_sym = 1;
5439 add_defn_to_vec (data->obstackp,
5440 fixup_symbol_section (sym, data->objfile),
5447 /* Helper for add_nonlocal_symbols. Find symbols in DOMAIN which are
5448 targeted by renamings matching LOOKUP_NAME in BLOCK. Add these
5449 symbols to OBSTACKP. Return whether we found such symbols. */
5452 ada_add_block_renamings (struct obstack *obstackp,
5453 const struct block *block,
5454 const lookup_name_info &lookup_name,
5457 struct using_direct *renaming;
5458 int defns_mark = num_defns_collected (obstackp);
5460 symbol_name_matcher_ftype *name_match
5461 = ada_get_symbol_name_matcher (lookup_name);
5463 for (renaming = block_using (block);
5465 renaming = renaming->next)
5469 /* Avoid infinite recursions: skip this renaming if we are actually
5470 already traversing it.
5472 Currently, symbol lookup in Ada don't use the namespace machinery from
5473 C++/Fortran support: skip namespace imports that use them. */
5474 if (renaming->searched
5475 || (renaming->import_src != NULL
5476 && renaming->import_src[0] != '\0')
5477 || (renaming->import_dest != NULL
5478 && renaming->import_dest[0] != '\0'))
5480 renaming->searched = 1;
5482 /* TODO: here, we perform another name-based symbol lookup, which can
5483 pull its own multiple overloads. In theory, we should be able to do
5484 better in this case since, in DWARF, DW_AT_import is a DIE reference,
5485 not a simple name. But in order to do this, we would need to enhance
5486 the DWARF reader to associate a symbol to this renaming, instead of a
5487 name. So, for now, we do something simpler: re-use the C++/Fortran
5488 namespace machinery. */
5489 r_name = (renaming->alias != NULL
5491 : renaming->declaration);
5492 if (name_match (r_name, lookup_name, NULL))
5494 lookup_name_info decl_lookup_name (renaming->declaration,
5495 lookup_name.match_type ());
5496 ada_add_all_symbols (obstackp, block, decl_lookup_name, domain,
5499 renaming->searched = 0;
5501 return num_defns_collected (obstackp) != defns_mark;
5504 /* Implements compare_names, but only applying the comparision using
5505 the given CASING. */
5508 compare_names_with_case (const char *string1, const char *string2,
5509 enum case_sensitivity casing)
5511 while (*string1 != '\0' && *string2 != '\0')
5515 if (isspace (*string1) || isspace (*string2))
5516 return strcmp_iw_ordered (string1, string2);
5518 if (casing == case_sensitive_off)
5520 c1 = tolower (*string1);
5521 c2 = tolower (*string2);
5538 return strcmp_iw_ordered (string1, string2);
5540 if (*string2 == '\0')
5542 if (is_name_suffix (string1))
5549 if (*string2 == '(')
5550 return strcmp_iw_ordered (string1, string2);
5553 if (casing == case_sensitive_off)
5554 return tolower (*string1) - tolower (*string2);
5556 return *string1 - *string2;
5561 /* Compare STRING1 to STRING2, with results as for strcmp.
5562 Compatible with strcmp_iw_ordered in that...
5564 strcmp_iw_ordered (STRING1, STRING2) <= 0
5568 compare_names (STRING1, STRING2) <= 0
5570 (they may differ as to what symbols compare equal). */
5573 compare_names (const char *string1, const char *string2)
5577 /* Similar to what strcmp_iw_ordered does, we need to perform
5578 a case-insensitive comparison first, and only resort to
5579 a second, case-sensitive, comparison if the first one was
5580 not sufficient to differentiate the two strings. */
5582 result = compare_names_with_case (string1, string2, case_sensitive_off);
5584 result = compare_names_with_case (string1, string2, case_sensitive_on);
5589 /* Convenience function to get at the Ada encoded lookup name for
5590 LOOKUP_NAME, as a C string. */
5593 ada_lookup_name (const lookup_name_info &lookup_name)
5595 return lookup_name.ada ().lookup_name ().c_str ();
5598 /* Add to OBSTACKP all non-local symbols whose name and domain match
5599 LOOKUP_NAME and DOMAIN respectively. The search is performed on
5600 GLOBAL_BLOCK symbols if GLOBAL is non-zero, or on STATIC_BLOCK
5601 symbols otherwise. */
5604 add_nonlocal_symbols (struct obstack *obstackp,
5605 const lookup_name_info &lookup_name,
5606 domain_enum domain, int global)
5608 struct match_data data;
5610 memset (&data, 0, sizeof data);
5611 data.obstackp = obstackp;
5613 bool is_wild_match = lookup_name.ada ().wild_match_p ();
5615 for (objfile *objfile : current_program_space->objfiles ())
5617 data.objfile = objfile;
5620 objfile->sf->qf->map_matching_symbols (objfile, lookup_name.name ().c_str (),
5622 aux_add_nonlocal_symbols, &data,
5623 symbol_name_match_type::WILD,
5626 objfile->sf->qf->map_matching_symbols (objfile, lookup_name.name ().c_str (),
5628 aux_add_nonlocal_symbols, &data,
5629 symbol_name_match_type::FULL,
5632 for (compunit_symtab *cu : objfile->compunits ())
5634 const struct block *global_block
5635 = BLOCKVECTOR_BLOCK (COMPUNIT_BLOCKVECTOR (cu), GLOBAL_BLOCK);
5637 if (ada_add_block_renamings (obstackp, global_block, lookup_name,
5643 if (num_defns_collected (obstackp) == 0 && global && !is_wild_match)
5645 const char *name = ada_lookup_name (lookup_name);
5646 std::string name1 = std::string ("<_ada_") + name + '>';
5648 for (objfile *objfile : current_program_space->objfiles ())
5650 data.objfile = objfile;
5651 objfile->sf->qf->map_matching_symbols (objfile, name1.c_str (),
5653 aux_add_nonlocal_symbols,
5655 symbol_name_match_type::FULL,
5661 /* Find symbols in DOMAIN matching LOOKUP_NAME, in BLOCK and, if
5662 FULL_SEARCH is non-zero, enclosing scope and in global scopes,
5663 returning the number of matches. Add these to OBSTACKP.
5665 When FULL_SEARCH is non-zero, any non-function/non-enumeral
5666 symbol match within the nest of blocks whose innermost member is BLOCK,
5667 is the one match returned (no other matches in that or
5668 enclosing blocks is returned). If there are any matches in or
5669 surrounding BLOCK, then these alone are returned.
5671 Names prefixed with "standard__" are handled specially:
5672 "standard__" is first stripped off (by the lookup_name
5673 constructor), and only static and global symbols are searched.
5675 If MADE_GLOBAL_LOOKUP_P is non-null, set it before return to whether we had
5676 to lookup global symbols. */
5679 ada_add_all_symbols (struct obstack *obstackp,
5680 const struct block *block,
5681 const lookup_name_info &lookup_name,
5684 int *made_global_lookup_p)
5688 if (made_global_lookup_p)
5689 *made_global_lookup_p = 0;
5691 /* Special case: If the user specifies a symbol name inside package
5692 Standard, do a non-wild matching of the symbol name without
5693 the "standard__" prefix. This was primarily introduced in order
5694 to allow the user to specifically access the standard exceptions
5695 using, for instance, Standard.Constraint_Error when Constraint_Error
5696 is ambiguous (due to the user defining its own Constraint_Error
5697 entity inside its program). */
5698 if (lookup_name.ada ().standard_p ())
5701 /* Check the non-global symbols. If we have ANY match, then we're done. */
5706 ada_add_local_symbols (obstackp, lookup_name, block, domain);
5709 /* In the !full_search case we're are being called by
5710 ada_iterate_over_symbols, and we don't want to search
5712 ada_add_block_symbols (obstackp, block, lookup_name, domain, NULL);
5714 if (num_defns_collected (obstackp) > 0 || !full_search)
5718 /* No non-global symbols found. Check our cache to see if we have
5719 already performed this search before. If we have, then return
5722 if (lookup_cached_symbol (ada_lookup_name (lookup_name),
5723 domain, &sym, &block))
5726 add_defn_to_vec (obstackp, sym, block);
5730 if (made_global_lookup_p)
5731 *made_global_lookup_p = 1;
5733 /* Search symbols from all global blocks. */
5735 add_nonlocal_symbols (obstackp, lookup_name, domain, 1);
5737 /* Now add symbols from all per-file blocks if we've gotten no hits
5738 (not strictly correct, but perhaps better than an error). */
5740 if (num_defns_collected (obstackp) == 0)
5741 add_nonlocal_symbols (obstackp, lookup_name, domain, 0);
5744 /* Find symbols in DOMAIN matching LOOKUP_NAME, in BLOCK and, if FULL_SEARCH
5745 is non-zero, enclosing scope and in global scopes, returning the number of
5747 Fills *RESULTS with (SYM,BLOCK) tuples, indicating the symbols
5748 found and the blocks and symbol tables (if any) in which they were
5751 When full_search is non-zero, any non-function/non-enumeral
5752 symbol match within the nest of blocks whose innermost member is BLOCK,
5753 is the one match returned (no other matches in that or
5754 enclosing blocks is returned). If there are any matches in or
5755 surrounding BLOCK, then these alone are returned.
5757 Names prefixed with "standard__" are handled specially: "standard__"
5758 is first stripped off, and only static and global symbols are searched. */
5761 ada_lookup_symbol_list_worker (const lookup_name_info &lookup_name,
5762 const struct block *block,
5764 std::vector<struct block_symbol> *results,
5767 int syms_from_global_search;
5769 auto_obstack obstack;
5771 ada_add_all_symbols (&obstack, block, lookup_name,
5772 domain, full_search, &syms_from_global_search);
5774 ndefns = num_defns_collected (&obstack);
5776 struct block_symbol *base = defns_collected (&obstack, 1);
5777 for (int i = 0; i < ndefns; ++i)
5778 results->push_back (base[i]);
5780 ndefns = remove_extra_symbols (results);
5782 if (ndefns == 0 && full_search && syms_from_global_search)
5783 cache_symbol (ada_lookup_name (lookup_name), domain, NULL, NULL);
5785 if (ndefns == 1 && full_search && syms_from_global_search)
5786 cache_symbol (ada_lookup_name (lookup_name), domain,
5787 (*results)[0].symbol, (*results)[0].block);
5789 ndefns = remove_irrelevant_renamings (results, block);
5794 /* Find symbols in DOMAIN matching NAME, in BLOCK and enclosing scope and
5795 in global scopes, returning the number of matches, and filling *RESULTS
5796 with (SYM,BLOCK) tuples.
5798 See ada_lookup_symbol_list_worker for further details. */
5801 ada_lookup_symbol_list (const char *name, const struct block *block,
5803 std::vector<struct block_symbol> *results)
5805 symbol_name_match_type name_match_type = name_match_type_from_name (name);
5806 lookup_name_info lookup_name (name, name_match_type);
5808 return ada_lookup_symbol_list_worker (lookup_name, block, domain, results, 1);
5811 /* Implementation of the la_iterate_over_symbols method. */
5814 ada_iterate_over_symbols
5815 (const struct block *block, const lookup_name_info &name,
5817 gdb::function_view<symbol_found_callback_ftype> callback)
5820 std::vector<struct block_symbol> results;
5822 ndefs = ada_lookup_symbol_list_worker (name, block, domain, &results, 0);
5824 for (i = 0; i < ndefs; ++i)
5826 if (!callback (&results[i]))
5831 /* The result is as for ada_lookup_symbol_list with FULL_SEARCH set
5832 to 1, but choosing the first symbol found if there are multiple
5835 The result is stored in *INFO, which must be non-NULL.
5836 If no match is found, INFO->SYM is set to NULL. */
5839 ada_lookup_encoded_symbol (const char *name, const struct block *block,
5841 struct block_symbol *info)
5843 /* Since we already have an encoded name, wrap it in '<>' to force a
5844 verbatim match. Otherwise, if the name happens to not look like
5845 an encoded name (because it doesn't include a "__"),
5846 ada_lookup_name_info would re-encode/fold it again, and that
5847 would e.g., incorrectly lowercase object renaming names like
5848 "R28b" -> "r28b". */
5849 std::string verbatim = std::string ("<") + name + '>';
5851 gdb_assert (info != NULL);
5852 *info = ada_lookup_symbol (verbatim.c_str (), block, domain, NULL);
5855 /* Return a symbol in DOMAIN matching NAME, in BLOCK0 and enclosing
5856 scope and in global scopes, or NULL if none. NAME is folded and
5857 encoded first. Otherwise, the result is as for ada_lookup_symbol_list,
5858 choosing the first symbol if there are multiple choices.
5859 If IS_A_FIELD_OF_THIS is not NULL, it is set to zero. */
5862 ada_lookup_symbol (const char *name, const struct block *block0,
5863 domain_enum domain, int *is_a_field_of_this)
5865 if (is_a_field_of_this != NULL)
5866 *is_a_field_of_this = 0;
5868 std::vector<struct block_symbol> candidates;
5871 n_candidates = ada_lookup_symbol_list (name, block0, domain, &candidates);
5873 if (n_candidates == 0)
5876 block_symbol info = candidates[0];
5877 info.symbol = fixup_symbol_section (info.symbol, NULL);
5881 static struct block_symbol
5882 ada_lookup_symbol_nonlocal (const struct language_defn *langdef,
5884 const struct block *block,
5885 const domain_enum domain)
5887 struct block_symbol sym;
5889 sym = ada_lookup_symbol (name, block_static_block (block), domain, NULL);
5890 if (sym.symbol != NULL)
5893 /* If we haven't found a match at this point, try the primitive
5894 types. In other languages, this search is performed before
5895 searching for global symbols in order to short-circuit that
5896 global-symbol search if it happens that the name corresponds
5897 to a primitive type. But we cannot do the same in Ada, because
5898 it is perfectly legitimate for a program to declare a type which
5899 has the same name as a standard type. If looking up a type in
5900 that situation, we have traditionally ignored the primitive type
5901 in favor of user-defined types. This is why, unlike most other
5902 languages, we search the primitive types this late and only after
5903 having searched the global symbols without success. */
5905 if (domain == VAR_DOMAIN)
5907 struct gdbarch *gdbarch;
5910 gdbarch = target_gdbarch ();
5912 gdbarch = block_gdbarch (block);
5913 sym.symbol = language_lookup_primitive_type_as_symbol (langdef, gdbarch, name);
5914 if (sym.symbol != NULL)
5918 return (struct block_symbol) {NULL, NULL};
5922 /* True iff STR is a possible encoded suffix of a normal Ada name
5923 that is to be ignored for matching purposes. Suffixes of parallel
5924 names (e.g., XVE) are not included here. Currently, the possible suffixes
5925 are given by any of the regular expressions:
5927 [.$][0-9]+ [nested subprogram suffix, on platforms such as GNU/Linux]
5928 ___[0-9]+ [nested subprogram suffix, on platforms such as HP/UX]
5929 TKB [subprogram suffix for task bodies]
5930 _E[0-9]+[bs]$ [protected object entry suffixes]
5931 (X[nb]*)?((\$|__)[0-9](_?[0-9]+)|___(JM|LJM|X([FDBUP].*|R[^T]?)))?$
5933 Also, any leading "__[0-9]+" sequence is skipped before the suffix
5934 match is performed. This sequence is used to differentiate homonyms,
5935 is an optional part of a valid name suffix. */
5938 is_name_suffix (const char *str)
5941 const char *matching;
5942 const int len = strlen (str);
5944 /* Skip optional leading __[0-9]+. */
5946 if (len > 3 && str[0] == '_' && str[1] == '_' && isdigit (str[2]))
5949 while (isdigit (str[0]))
5955 if (str[0] == '.' || str[0] == '$')
5958 while (isdigit (matching[0]))
5960 if (matching[0] == '\0')
5966 if (len > 3 && str[0] == '_' && str[1] == '_' && str[2] == '_')
5969 while (isdigit (matching[0]))
5971 if (matching[0] == '\0')
5975 /* "TKB" suffixes are used for subprograms implementing task bodies. */
5977 if (strcmp (str, "TKB") == 0)
5981 /* FIXME: brobecker/2005-09-23: Protected Object subprograms end
5982 with a N at the end. Unfortunately, the compiler uses the same
5983 convention for other internal types it creates. So treating
5984 all entity names that end with an "N" as a name suffix causes
5985 some regressions. For instance, consider the case of an enumerated
5986 type. To support the 'Image attribute, it creates an array whose
5988 Having a single character like this as a suffix carrying some
5989 information is a bit risky. Perhaps we should change the encoding
5990 to be something like "_N" instead. In the meantime, do not do
5991 the following check. */
5992 /* Protected Object Subprograms */
5993 if (len == 1 && str [0] == 'N')
5998 if (len > 3 && str[0] == '_' && str [1] == 'E' && isdigit (str[2]))
6001 while (isdigit (matching[0]))
6003 if ((matching[0] == 'b' || matching[0] == 's')
6004 && matching [1] == '\0')
6008 /* ??? We should not modify STR directly, as we are doing below. This
6009 is fine in this case, but may become problematic later if we find
6010 that this alternative did not work, and want to try matching
6011 another one from the begining of STR. Since we modified it, we
6012 won't be able to find the begining of the string anymore! */
6016 while (str[0] != '_' && str[0] != '\0')
6018 if (str[0] != 'n' && str[0] != 'b')
6024 if (str[0] == '\000')
6029 if (str[1] != '_' || str[2] == '\000')
6033 if (strcmp (str + 3, "JM") == 0)
6035 /* FIXME: brobecker/2004-09-30: GNAT will soon stop using
6036 the LJM suffix in favor of the JM one. But we will
6037 still accept LJM as a valid suffix for a reasonable
6038 amount of time, just to allow ourselves to debug programs
6039 compiled using an older version of GNAT. */
6040 if (strcmp (str + 3, "LJM") == 0)
6044 if (str[4] == 'F' || str[4] == 'D' || str[4] == 'B'
6045 || str[4] == 'U' || str[4] == 'P')
6047 if (str[4] == 'R' && str[5] != 'T')
6051 if (!isdigit (str[2]))
6053 for (k = 3; str[k] != '\0'; k += 1)
6054 if (!isdigit (str[k]) && str[k] != '_')
6058 if (str[0] == '$' && isdigit (str[1]))
6060 for (k = 2; str[k] != '\0'; k += 1)
6061 if (!isdigit (str[k]) && str[k] != '_')
6068 /* Return non-zero if the string starting at NAME and ending before
6069 NAME_END contains no capital letters. */
6072 is_valid_name_for_wild_match (const char *name0)
6074 const char *decoded_name = ada_decode (name0);
6077 /* If the decoded name starts with an angle bracket, it means that
6078 NAME0 does not follow the GNAT encoding format. It should then
6079 not be allowed as a possible wild match. */
6080 if (decoded_name[0] == '<')
6083 for (i=0; decoded_name[i] != '\0'; i++)
6084 if (isalpha (decoded_name[i]) && !islower (decoded_name[i]))
6090 /* Advance *NAMEP to next occurrence of TARGET0 in the string NAME0
6091 that could start a simple name. Assumes that *NAMEP points into
6092 the string beginning at NAME0. */
6095 advance_wild_match (const char **namep, const char *name0, int target0)
6097 const char *name = *namep;
6107 if ((t1 >= 'a' && t1 <= 'z') || (t1 >= '0' && t1 <= '9'))
6110 if (name == name0 + 5 && startswith (name0, "_ada"))
6115 else if (t1 == '_' && ((name[2] >= 'a' && name[2] <= 'z')
6116 || name[2] == target0))
6124 else if ((t0 >= 'a' && t0 <= 'z') || (t0 >= '0' && t0 <= '9'))
6134 /* Return true iff NAME encodes a name of the form prefix.PATN.
6135 Ignores any informational suffixes of NAME (i.e., for which
6136 is_name_suffix is true). Assumes that PATN is a lower-cased Ada
6140 wild_match (const char *name, const char *patn)
6143 const char *name0 = name;
6147 const char *match = name;
6151 for (name += 1, p = patn + 1; *p != '\0'; name += 1, p += 1)
6154 if (*p == '\0' && is_name_suffix (name))
6155 return match == name0 || is_valid_name_for_wild_match (name0);
6157 if (name[-1] == '_')
6160 if (!advance_wild_match (&name, name0, *patn))
6165 /* Returns true iff symbol name SYM_NAME matches SEARCH_NAME, ignoring
6166 any trailing suffixes that encode debugging information or leading
6167 _ada_ on SYM_NAME (see is_name_suffix commentary for the debugging
6168 information that is ignored). */
6171 full_match (const char *sym_name, const char *search_name)
6173 size_t search_name_len = strlen (search_name);
6175 if (strncmp (sym_name, search_name, search_name_len) == 0
6176 && is_name_suffix (sym_name + search_name_len))
6179 if (startswith (sym_name, "_ada_")
6180 && strncmp (sym_name + 5, search_name, search_name_len) == 0
6181 && is_name_suffix (sym_name + search_name_len + 5))
6187 /* Add symbols from BLOCK matching LOOKUP_NAME in DOMAIN to vector
6188 *defn_symbols, updating the list of symbols in OBSTACKP (if
6189 necessary). OBJFILE is the section containing BLOCK. */
6192 ada_add_block_symbols (struct obstack *obstackp,
6193 const struct block *block,
6194 const lookup_name_info &lookup_name,
6195 domain_enum domain, struct objfile *objfile)
6197 struct block_iterator iter;
6198 /* A matching argument symbol, if any. */
6199 struct symbol *arg_sym;
6200 /* Set true when we find a matching non-argument symbol. */
6206 for (sym = block_iter_match_first (block, lookup_name, &iter);
6208 sym = block_iter_match_next (lookup_name, &iter))
6210 if (symbol_matches_domain (SYMBOL_LANGUAGE (sym),
6211 SYMBOL_DOMAIN (sym), domain))
6213 if (SYMBOL_CLASS (sym) != LOC_UNRESOLVED)
6215 if (SYMBOL_IS_ARGUMENT (sym))
6220 add_defn_to_vec (obstackp,
6221 fixup_symbol_section (sym, objfile),
6228 /* Handle renamings. */
6230 if (ada_add_block_renamings (obstackp, block, lookup_name, domain))
6233 if (!found_sym && arg_sym != NULL)
6235 add_defn_to_vec (obstackp,
6236 fixup_symbol_section (arg_sym, objfile),
6240 if (!lookup_name.ada ().wild_match_p ())
6244 const std::string &ada_lookup_name = lookup_name.ada ().lookup_name ();
6245 const char *name = ada_lookup_name.c_str ();
6246 size_t name_len = ada_lookup_name.size ();
6248 ALL_BLOCK_SYMBOLS (block, iter, sym)
6250 if (symbol_matches_domain (SYMBOL_LANGUAGE (sym),
6251 SYMBOL_DOMAIN (sym), domain))
6255 cmp = (int) '_' - (int) SYMBOL_LINKAGE_NAME (sym)[0];
6258 cmp = !startswith (SYMBOL_LINKAGE_NAME (sym), "_ada_");
6260 cmp = strncmp (name, SYMBOL_LINKAGE_NAME (sym) + 5,
6265 && is_name_suffix (SYMBOL_LINKAGE_NAME (sym) + name_len + 5))
6267 if (SYMBOL_CLASS (sym) != LOC_UNRESOLVED)
6269 if (SYMBOL_IS_ARGUMENT (sym))
6274 add_defn_to_vec (obstackp,
6275 fixup_symbol_section (sym, objfile),
6283 /* NOTE: This really shouldn't be needed for _ada_ symbols.
6284 They aren't parameters, right? */
6285 if (!found_sym && arg_sym != NULL)
6287 add_defn_to_vec (obstackp,
6288 fixup_symbol_section (arg_sym, objfile),
6295 /* Symbol Completion */
6300 ada_lookup_name_info::matches
6301 (const char *sym_name,
6302 symbol_name_match_type match_type,
6303 completion_match_result *comp_match_res) const
6306 const char *text = m_encoded_name.c_str ();
6307 size_t text_len = m_encoded_name.size ();
6309 /* First, test against the fully qualified name of the symbol. */
6311 if (strncmp (sym_name, text, text_len) == 0)
6314 if (match && !m_encoded_p)
6316 /* One needed check before declaring a positive match is to verify
6317 that iff we are doing a verbatim match, the decoded version
6318 of the symbol name starts with '<'. Otherwise, this symbol name
6319 is not a suitable completion. */
6320 const char *sym_name_copy = sym_name;
6321 bool has_angle_bracket;
6323 sym_name = ada_decode (sym_name);
6324 has_angle_bracket = (sym_name[0] == '<');
6325 match = (has_angle_bracket == m_verbatim_p);
6326 sym_name = sym_name_copy;
6329 if (match && !m_verbatim_p)
6331 /* When doing non-verbatim match, another check that needs to
6332 be done is to verify that the potentially matching symbol name
6333 does not include capital letters, because the ada-mode would
6334 not be able to understand these symbol names without the
6335 angle bracket notation. */
6338 for (tmp = sym_name; *tmp != '\0' && !isupper (*tmp); tmp++);
6343 /* Second: Try wild matching... */
6345 if (!match && m_wild_match_p)
6347 /* Since we are doing wild matching, this means that TEXT
6348 may represent an unqualified symbol name. We therefore must
6349 also compare TEXT against the unqualified name of the symbol. */
6350 sym_name = ada_unqualified_name (ada_decode (sym_name));
6352 if (strncmp (sym_name, text, text_len) == 0)
6356 /* Finally: If we found a match, prepare the result to return. */
6361 if (comp_match_res != NULL)
6363 std::string &match_str = comp_match_res->match.storage ();
6366 match_str = ada_decode (sym_name);
6370 match_str = add_angle_brackets (sym_name);
6372 match_str = sym_name;
6376 comp_match_res->set_match (match_str.c_str ());
6382 /* Add the list of possible symbol names completing TEXT to TRACKER.
6383 WORD is the entire command on which completion is made. */
6386 ada_collect_symbol_completion_matches (completion_tracker &tracker,
6387 complete_symbol_mode mode,
6388 symbol_name_match_type name_match_type,
6389 const char *text, const char *word,
6390 enum type_code code)
6393 const struct block *b, *surrounding_static_block = 0;
6394 struct block_iterator iter;
6396 gdb_assert (code == TYPE_CODE_UNDEF);
6398 lookup_name_info lookup_name (text, name_match_type, true);
6400 /* First, look at the partial symtab symbols. */
6401 expand_symtabs_matching (NULL,
6407 /* At this point scan through the misc symbol vectors and add each
6408 symbol you find to the list. Eventually we want to ignore
6409 anything that isn't a text symbol (everything else will be
6410 handled by the psymtab code above). */
6412 for (objfile *objfile : current_program_space->objfiles ())
6414 for (minimal_symbol *msymbol : objfile->msymbols ())
6418 if (completion_skip_symbol (mode, msymbol))
6421 language symbol_language = MSYMBOL_LANGUAGE (msymbol);
6423 /* Ada minimal symbols won't have their language set to Ada. If
6424 we let completion_list_add_name compare using the
6425 default/C-like matcher, then when completing e.g., symbols in a
6426 package named "pck", we'd match internal Ada symbols like
6427 "pckS", which are invalid in an Ada expression, unless you wrap
6428 them in '<' '>' to request a verbatim match.
6430 Unfortunately, some Ada encoded names successfully demangle as
6431 C++ symbols (using an old mangling scheme), such as "name__2Xn"
6432 -> "Xn::name(void)" and thus some Ada minimal symbols end up
6433 with the wrong language set. Paper over that issue here. */
6434 if (symbol_language == language_auto
6435 || symbol_language == language_cplus)
6436 symbol_language = language_ada;
6438 completion_list_add_name (tracker,
6440 MSYMBOL_LINKAGE_NAME (msymbol),
6441 lookup_name, text, word);
6445 /* Search upwards from currently selected frame (so that we can
6446 complete on local vars. */
6448 for (b = get_selected_block (0); b != NULL; b = BLOCK_SUPERBLOCK (b))
6450 if (!BLOCK_SUPERBLOCK (b))
6451 surrounding_static_block = b; /* For elmin of dups */
6453 ALL_BLOCK_SYMBOLS (b, iter, sym)
6455 if (completion_skip_symbol (mode, sym))
6458 completion_list_add_name (tracker,
6459 SYMBOL_LANGUAGE (sym),
6460 SYMBOL_LINKAGE_NAME (sym),
6461 lookup_name, text, word);
6465 /* Go through the symtabs and check the externs and statics for
6466 symbols which match. */
6468 for (objfile *objfile : current_program_space->objfiles ())
6470 for (compunit_symtab *s : objfile->compunits ())
6473 b = BLOCKVECTOR_BLOCK (COMPUNIT_BLOCKVECTOR (s), GLOBAL_BLOCK);
6474 ALL_BLOCK_SYMBOLS (b, iter, sym)
6476 if (completion_skip_symbol (mode, sym))
6479 completion_list_add_name (tracker,
6480 SYMBOL_LANGUAGE (sym),
6481 SYMBOL_LINKAGE_NAME (sym),
6482 lookup_name, text, word);
6487 for (objfile *objfile : current_program_space->objfiles ())
6489 for (compunit_symtab *s : objfile->compunits ())
6492 b = BLOCKVECTOR_BLOCK (COMPUNIT_BLOCKVECTOR (s), STATIC_BLOCK);
6493 /* Don't do this block twice. */
6494 if (b == surrounding_static_block)
6496 ALL_BLOCK_SYMBOLS (b, iter, sym)
6498 if (completion_skip_symbol (mode, sym))
6501 completion_list_add_name (tracker,
6502 SYMBOL_LANGUAGE (sym),
6503 SYMBOL_LINKAGE_NAME (sym),
6504 lookup_name, text, word);
6512 /* Return non-zero if TYPE is a pointer to the GNAT dispatch table used
6513 for tagged types. */
6516 ada_is_dispatch_table_ptr_type (struct type *type)
6520 if (TYPE_CODE (type) != TYPE_CODE_PTR)
6523 name = TYPE_NAME (TYPE_TARGET_TYPE (type));
6527 return (strcmp (name, "ada__tags__dispatch_table") == 0);
6530 /* Return non-zero if TYPE is an interface tag. */
6533 ada_is_interface_tag (struct type *type)
6535 const char *name = TYPE_NAME (type);
6540 return (strcmp (name, "ada__tags__interface_tag") == 0);
6543 /* True if field number FIELD_NUM in struct or union type TYPE is supposed
6544 to be invisible to users. */
6547 ada_is_ignored_field (struct type *type, int field_num)
6549 if (field_num < 0 || field_num > TYPE_NFIELDS (type))
6552 /* Check the name of that field. */
6554 const char *name = TYPE_FIELD_NAME (type, field_num);
6556 /* Anonymous field names should not be printed.
6557 brobecker/2007-02-20: I don't think this can actually happen
6558 but we don't want to print the value of annonymous fields anyway. */
6562 /* Normally, fields whose name start with an underscore ("_")
6563 are fields that have been internally generated by the compiler,
6564 and thus should not be printed. The "_parent" field is special,
6565 however: This is a field internally generated by the compiler
6566 for tagged types, and it contains the components inherited from
6567 the parent type. This field should not be printed as is, but
6568 should not be ignored either. */
6569 if (name[0] == '_' && !startswith (name, "_parent"))
6573 /* If this is the dispatch table of a tagged type or an interface tag,
6575 if (ada_is_tagged_type (type, 1)
6576 && (ada_is_dispatch_table_ptr_type (TYPE_FIELD_TYPE (type, field_num))
6577 || ada_is_interface_tag (TYPE_FIELD_TYPE (type, field_num))))
6580 /* Not a special field, so it should not be ignored. */
6584 /* True iff TYPE has a tag field. If REFOK, then TYPE may also be a
6585 pointer or reference type whose ultimate target has a tag field. */
6588 ada_is_tagged_type (struct type *type, int refok)
6590 return (ada_lookup_struct_elt_type (type, "_tag", refok, 1) != NULL);
6593 /* True iff TYPE represents the type of X'Tag */
6596 ada_is_tag_type (struct type *type)
6598 type = ada_check_typedef (type);
6600 if (type == NULL || TYPE_CODE (type) != TYPE_CODE_PTR)
6604 const char *name = ada_type_name (TYPE_TARGET_TYPE (type));
6606 return (name != NULL
6607 && strcmp (name, "ada__tags__dispatch_table") == 0);
6611 /* The type of the tag on VAL. */
6614 ada_tag_type (struct value *val)
6616 return ada_lookup_struct_elt_type (value_type (val), "_tag", 1, 0);
6619 /* Return 1 if TAG follows the old scheme for Ada tags (used for Ada 95,
6620 retired at Ada 05). */
6623 is_ada95_tag (struct value *tag)
6625 return ada_value_struct_elt (tag, "tsd", 1) != NULL;
6628 /* The value of the tag on VAL. */
6631 ada_value_tag (struct value *val)
6633 return ada_value_struct_elt (val, "_tag", 0);
6636 /* The value of the tag on the object of type TYPE whose contents are
6637 saved at VALADDR, if it is non-null, or is at memory address
6640 static struct value *
6641 value_tag_from_contents_and_address (struct type *type,
6642 const gdb_byte *valaddr,
6645 int tag_byte_offset;
6646 struct type *tag_type;
6648 if (find_struct_field ("_tag", type, 0, &tag_type, &tag_byte_offset,
6651 const gdb_byte *valaddr1 = ((valaddr == NULL)
6653 : valaddr + tag_byte_offset);
6654 CORE_ADDR address1 = (address == 0) ? 0 : address + tag_byte_offset;
6656 return value_from_contents_and_address (tag_type, valaddr1, address1);
6661 static struct type *
6662 type_from_tag (struct value *tag)
6664 const char *type_name = ada_tag_name (tag);
6666 if (type_name != NULL)
6667 return ada_find_any_type (ada_encode (type_name));
6671 /* Given a value OBJ of a tagged type, return a value of this
6672 type at the base address of the object. The base address, as
6673 defined in Ada.Tags, it is the address of the primary tag of
6674 the object, and therefore where the field values of its full
6675 view can be fetched. */
6678 ada_tag_value_at_base_address (struct value *obj)
6681 LONGEST offset_to_top = 0;
6682 struct type *ptr_type, *obj_type;
6684 CORE_ADDR base_address;
6686 obj_type = value_type (obj);
6688 /* It is the responsability of the caller to deref pointers. */
6690 if (TYPE_CODE (obj_type) == TYPE_CODE_PTR
6691 || TYPE_CODE (obj_type) == TYPE_CODE_REF)
6694 tag = ada_value_tag (obj);
6698 /* Base addresses only appeared with Ada 05 and multiple inheritance. */
6700 if (is_ada95_tag (tag))
6703 ptr_type = language_lookup_primitive_type
6704 (language_def (language_ada), target_gdbarch(), "storage_offset");
6705 ptr_type = lookup_pointer_type (ptr_type);
6706 val = value_cast (ptr_type, tag);
6710 /* It is perfectly possible that an exception be raised while
6711 trying to determine the base address, just like for the tag;
6712 see ada_tag_name for more details. We do not print the error
6713 message for the same reason. */
6717 offset_to_top = value_as_long (value_ind (value_ptradd (val, -2)));
6720 CATCH (e, RETURN_MASK_ERROR)
6726 /* If offset is null, nothing to do. */
6728 if (offset_to_top == 0)
6731 /* -1 is a special case in Ada.Tags; however, what should be done
6732 is not quite clear from the documentation. So do nothing for
6735 if (offset_to_top == -1)
6738 /* OFFSET_TO_TOP used to be a positive value to be subtracted
6739 from the base address. This was however incompatible with
6740 C++ dispatch table: C++ uses a *negative* value to *add*
6741 to the base address. Ada's convention has therefore been
6742 changed in GNAT 19.0w 20171023: since then, C++ and Ada
6743 use the same convention. Here, we support both cases by
6744 checking the sign of OFFSET_TO_TOP. */
6746 if (offset_to_top > 0)
6747 offset_to_top = -offset_to_top;
6749 base_address = value_address (obj) + offset_to_top;
6750 tag = value_tag_from_contents_and_address (obj_type, NULL, base_address);
6752 /* Make sure that we have a proper tag at the new address.
6753 Otherwise, offset_to_top is bogus (which can happen when
6754 the object is not initialized yet). */
6759 obj_type = type_from_tag (tag);
6764 return value_from_contents_and_address (obj_type, NULL, base_address);
6767 /* Return the "ada__tags__type_specific_data" type. */
6769 static struct type *
6770 ada_get_tsd_type (struct inferior *inf)
6772 struct ada_inferior_data *data = get_ada_inferior_data (inf);
6774 if (data->tsd_type == 0)
6775 data->tsd_type = ada_find_any_type ("ada__tags__type_specific_data");
6776 return data->tsd_type;
6779 /* Return the TSD (type-specific data) associated to the given TAG.
6780 TAG is assumed to be the tag of a tagged-type entity.
6782 May return NULL if we are unable to get the TSD. */
6784 static struct value *
6785 ada_get_tsd_from_tag (struct value *tag)
6790 /* First option: The TSD is simply stored as a field of our TAG.
6791 Only older versions of GNAT would use this format, but we have
6792 to test it first, because there are no visible markers for
6793 the current approach except the absence of that field. */
6795 val = ada_value_struct_elt (tag, "tsd", 1);
6799 /* Try the second representation for the dispatch table (in which
6800 there is no explicit 'tsd' field in the referent of the tag pointer,
6801 and instead the tsd pointer is stored just before the dispatch
6804 type = ada_get_tsd_type (current_inferior());
6807 type = lookup_pointer_type (lookup_pointer_type (type));
6808 val = value_cast (type, tag);
6811 return value_ind (value_ptradd (val, -1));
6814 /* Given the TSD of a tag (type-specific data), return a string
6815 containing the name of the associated type.
6817 The returned value is good until the next call. May return NULL
6818 if we are unable to determine the tag name. */
6821 ada_tag_name_from_tsd (struct value *tsd)
6823 static char name[1024];
6827 val = ada_value_struct_elt (tsd, "expanded_name", 1);
6830 read_memory_string (value_as_address (val), name, sizeof (name) - 1);
6831 for (p = name; *p != '\0'; p += 1)
6837 /* The type name of the dynamic type denoted by the 'tag value TAG, as
6840 Return NULL if the TAG is not an Ada tag, or if we were unable to
6841 determine the name of that tag. The result is good until the next
6845 ada_tag_name (struct value *tag)
6849 if (!ada_is_tag_type (value_type (tag)))
6852 /* It is perfectly possible that an exception be raised while trying
6853 to determine the TAG's name, even under normal circumstances:
6854 The associated variable may be uninitialized or corrupted, for
6855 instance. We do not let any exception propagate past this point.
6856 instead we return NULL.
6858 We also do not print the error message either (which often is very
6859 low-level (Eg: "Cannot read memory at 0x[...]"), but instead let
6860 the caller print a more meaningful message if necessary. */
6863 struct value *tsd = ada_get_tsd_from_tag (tag);
6866 name = ada_tag_name_from_tsd (tsd);
6868 CATCH (e, RETURN_MASK_ERROR)
6876 /* The parent type of TYPE, or NULL if none. */
6879 ada_parent_type (struct type *type)
6883 type = ada_check_typedef (type);
6885 if (type == NULL || TYPE_CODE (type) != TYPE_CODE_STRUCT)
6888 for (i = 0; i < TYPE_NFIELDS (type); i += 1)
6889 if (ada_is_parent_field (type, i))
6891 struct type *parent_type = TYPE_FIELD_TYPE (type, i);
6893 /* If the _parent field is a pointer, then dereference it. */
6894 if (TYPE_CODE (parent_type) == TYPE_CODE_PTR)
6895 parent_type = TYPE_TARGET_TYPE (parent_type);
6896 /* If there is a parallel XVS type, get the actual base type. */
6897 parent_type = ada_get_base_type (parent_type);
6899 return ada_check_typedef (parent_type);
6905 /* True iff field number FIELD_NUM of structure type TYPE contains the
6906 parent-type (inherited) fields of a derived type. Assumes TYPE is
6907 a structure type with at least FIELD_NUM+1 fields. */
6910 ada_is_parent_field (struct type *type, int field_num)
6912 const char *name = TYPE_FIELD_NAME (ada_check_typedef (type), field_num);
6914 return (name != NULL
6915 && (startswith (name, "PARENT")
6916 || startswith (name, "_parent")));
6919 /* True iff field number FIELD_NUM of structure type TYPE is a
6920 transparent wrapper field (which should be silently traversed when doing
6921 field selection and flattened when printing). Assumes TYPE is a
6922 structure type with at least FIELD_NUM+1 fields. Such fields are always
6926 ada_is_wrapper_field (struct type *type, int field_num)
6928 const char *name = TYPE_FIELD_NAME (type, field_num);
6930 if (name != NULL && strcmp (name, "RETVAL") == 0)
6932 /* This happens in functions with "out" or "in out" parameters
6933 which are passed by copy. For such functions, GNAT describes
6934 the function's return type as being a struct where the return
6935 value is in a field called RETVAL, and where the other "out"
6936 or "in out" parameters are fields of that struct. This is not
6941 return (name != NULL
6942 && (startswith (name, "PARENT")
6943 || strcmp (name, "REP") == 0
6944 || startswith (name, "_parent")
6945 || name[0] == 'S' || name[0] == 'R' || name[0] == 'O'));
6948 /* True iff field number FIELD_NUM of structure or union type TYPE
6949 is a variant wrapper. Assumes TYPE is a structure type with at least
6950 FIELD_NUM+1 fields. */
6953 ada_is_variant_part (struct type *type, int field_num)
6955 struct type *field_type = TYPE_FIELD_TYPE (type, field_num);
6957 return (TYPE_CODE (field_type) == TYPE_CODE_UNION
6958 || (is_dynamic_field (type, field_num)
6959 && (TYPE_CODE (TYPE_TARGET_TYPE (field_type))
6960 == TYPE_CODE_UNION)));
6963 /* Assuming that VAR_TYPE is a variant wrapper (type of the variant part)
6964 whose discriminants are contained in the record type OUTER_TYPE,
6965 returns the type of the controlling discriminant for the variant.
6966 May return NULL if the type could not be found. */
6969 ada_variant_discrim_type (struct type *var_type, struct type *outer_type)
6971 const char *name = ada_variant_discrim_name (var_type);
6973 return ada_lookup_struct_elt_type (outer_type, name, 1, 1);
6976 /* Assuming that TYPE is the type of a variant wrapper, and FIELD_NUM is a
6977 valid field number within it, returns 1 iff field FIELD_NUM of TYPE
6978 represents a 'when others' clause; otherwise 0. */
6981 ada_is_others_clause (struct type *type, int field_num)
6983 const char *name = TYPE_FIELD_NAME (type, field_num);
6985 return (name != NULL && name[0] == 'O');
6988 /* Assuming that TYPE0 is the type of the variant part of a record,
6989 returns the name of the discriminant controlling the variant.
6990 The value is valid until the next call to ada_variant_discrim_name. */
6993 ada_variant_discrim_name (struct type *type0)
6995 static char *result = NULL;
6996 static size_t result_len = 0;
6999 const char *discrim_end;
7000 const char *discrim_start;
7002 if (TYPE_CODE (type0) == TYPE_CODE_PTR)
7003 type = TYPE_TARGET_TYPE (type0);
7007 name = ada_type_name (type);
7009 if (name == NULL || name[0] == '\000')
7012 for (discrim_end = name + strlen (name) - 6; discrim_end != name;
7015 if (startswith (discrim_end, "___XVN"))
7018 if (discrim_end == name)
7021 for (discrim_start = discrim_end; discrim_start != name + 3;
7024 if (discrim_start == name + 1)
7026 if ((discrim_start > name + 3
7027 && startswith (discrim_start - 3, "___"))
7028 || discrim_start[-1] == '.')
7032 GROW_VECT (result, result_len, discrim_end - discrim_start + 1);
7033 strncpy (result, discrim_start, discrim_end - discrim_start);
7034 result[discrim_end - discrim_start] = '\0';
7038 /* Scan STR for a subtype-encoded number, beginning at position K.
7039 Put the position of the character just past the number scanned in
7040 *NEW_K, if NEW_K!=NULL. Put the scanned number in *R, if R!=NULL.
7041 Return 1 if there was a valid number at the given position, and 0
7042 otherwise. A "subtype-encoded" number consists of the absolute value
7043 in decimal, followed by the letter 'm' to indicate a negative number.
7044 Assumes 0m does not occur. */
7047 ada_scan_number (const char str[], int k, LONGEST * R, int *new_k)
7051 if (!isdigit (str[k]))
7054 /* Do it the hard way so as not to make any assumption about
7055 the relationship of unsigned long (%lu scan format code) and
7058 while (isdigit (str[k]))
7060 RU = RU * 10 + (str[k] - '0');
7067 *R = (-(LONGEST) (RU - 1)) - 1;
7073 /* NOTE on the above: Technically, C does not say what the results of
7074 - (LONGEST) RU or (LONGEST) -RU are for RU == largest positive
7075 number representable as a LONGEST (although either would probably work
7076 in most implementations). When RU>0, the locution in the then branch
7077 above is always equivalent to the negative of RU. */
7084 /* Assuming that TYPE is a variant part wrapper type (a VARIANTS field),
7085 and FIELD_NUM is a valid field number within it, returns 1 iff VAL is
7086 in the range encoded by field FIELD_NUM of TYPE; otherwise 0. */
7089 ada_in_variant (LONGEST val, struct type *type, int field_num)
7091 const char *name = TYPE_FIELD_NAME (type, field_num);
7105 if (!ada_scan_number (name, p + 1, &W, &p))
7115 if (!ada_scan_number (name, p + 1, &L, &p)
7116 || name[p] != 'T' || !ada_scan_number (name, p + 1, &U, &p))
7118 if (val >= L && val <= U)
7130 /* FIXME: Lots of redundancy below. Try to consolidate. */
7132 /* Given a value ARG1 (offset by OFFSET bytes) of a struct or union type
7133 ARG_TYPE, extract and return the value of one of its (non-static)
7134 fields. FIELDNO says which field. Differs from value_primitive_field
7135 only in that it can handle packed values of arbitrary type. */
7137 static struct value *
7138 ada_value_primitive_field (struct value *arg1, int offset, int fieldno,
7139 struct type *arg_type)
7143 arg_type = ada_check_typedef (arg_type);
7144 type = TYPE_FIELD_TYPE (arg_type, fieldno);
7146 /* Handle packed fields. */
7148 if (TYPE_FIELD_BITSIZE (arg_type, fieldno) != 0)
7150 int bit_pos = TYPE_FIELD_BITPOS (arg_type, fieldno);
7151 int bit_size = TYPE_FIELD_BITSIZE (arg_type, fieldno);
7153 return ada_value_primitive_packed_val (arg1, value_contents (arg1),
7154 offset + bit_pos / 8,
7155 bit_pos % 8, bit_size, type);
7158 return value_primitive_field (arg1, offset, fieldno, arg_type);
7161 /* Find field with name NAME in object of type TYPE. If found,
7162 set the following for each argument that is non-null:
7163 - *FIELD_TYPE_P to the field's type;
7164 - *BYTE_OFFSET_P to OFFSET + the byte offset of the field within
7165 an object of that type;
7166 - *BIT_OFFSET_P to the bit offset modulo byte size of the field;
7167 - *BIT_SIZE_P to its size in bits if the field is packed, and
7169 If INDEX_P is non-null, increment *INDEX_P by the number of source-visible
7170 fields up to but not including the desired field, or by the total
7171 number of fields if not found. A NULL value of NAME never
7172 matches; the function just counts visible fields in this case.
7174 Notice that we need to handle when a tagged record hierarchy
7175 has some components with the same name, like in this scenario:
7177 type Top_T is tagged record
7183 type Middle_T is new Top.Top_T with record
7184 N : Character := 'a';
7188 type Bottom_T is new Middle.Middle_T with record
7190 C : Character := '5';
7192 A : Character := 'J';
7195 Let's say we now have a variable declared and initialized as follow:
7197 TC : Top_A := new Bottom_T;
7199 And then we use this variable to call this function
7201 procedure Assign (Obj: in out Top_T; TV : Integer);
7205 Assign (Top_T (B), 12);
7207 Now, we're in the debugger, and we're inside that procedure
7208 then and we want to print the value of obj.c:
7210 Usually, the tagged record or one of the parent type owns the
7211 component to print and there's no issue but in this particular
7212 case, what does it mean to ask for Obj.C? Since the actual
7213 type for object is type Bottom_T, it could mean two things: type
7214 component C from the Middle_T view, but also component C from
7215 Bottom_T. So in that "undefined" case, when the component is
7216 not found in the non-resolved type (which includes all the
7217 components of the parent type), then resolve it and see if we
7218 get better luck once expanded.
7220 In the case of homonyms in the derived tagged type, we don't
7221 guaranty anything, and pick the one that's easiest for us
7224 Returns 1 if found, 0 otherwise. */
7227 find_struct_field (const char *name, struct type *type, int offset,
7228 struct type **field_type_p,
7229 int *byte_offset_p, int *bit_offset_p, int *bit_size_p,
7233 int parent_offset = -1;
7235 type = ada_check_typedef (type);
7237 if (field_type_p != NULL)
7238 *field_type_p = NULL;
7239 if (byte_offset_p != NULL)
7241 if (bit_offset_p != NULL)
7243 if (bit_size_p != NULL)
7246 for (i = 0; i < TYPE_NFIELDS (type); i += 1)
7248 int bit_pos = TYPE_FIELD_BITPOS (type, i);
7249 int fld_offset = offset + bit_pos / 8;
7250 const char *t_field_name = TYPE_FIELD_NAME (type, i);
7252 if (t_field_name == NULL)
7255 else if (ada_is_parent_field (type, i))
7257 /* This is a field pointing us to the parent type of a tagged
7258 type. As hinted in this function's documentation, we give
7259 preference to fields in the current record first, so what
7260 we do here is just record the index of this field before
7261 we skip it. If it turns out we couldn't find our field
7262 in the current record, then we'll get back to it and search
7263 inside it whether the field might exist in the parent. */
7269 else if (name != NULL && field_name_match (t_field_name, name))
7271 int bit_size = TYPE_FIELD_BITSIZE (type, i);
7273 if (field_type_p != NULL)
7274 *field_type_p = TYPE_FIELD_TYPE (type, i);
7275 if (byte_offset_p != NULL)
7276 *byte_offset_p = fld_offset;
7277 if (bit_offset_p != NULL)
7278 *bit_offset_p = bit_pos % 8;
7279 if (bit_size_p != NULL)
7280 *bit_size_p = bit_size;
7283 else if (ada_is_wrapper_field (type, i))
7285 if (find_struct_field (name, TYPE_FIELD_TYPE (type, i), fld_offset,
7286 field_type_p, byte_offset_p, bit_offset_p,
7287 bit_size_p, index_p))
7290 else if (ada_is_variant_part (type, i))
7292 /* PNH: Wait. Do we ever execute this section, or is ARG always of
7295 struct type *field_type
7296 = ada_check_typedef (TYPE_FIELD_TYPE (type, i));
7298 for (j = 0; j < TYPE_NFIELDS (field_type); j += 1)
7300 if (find_struct_field (name, TYPE_FIELD_TYPE (field_type, j),
7302 + TYPE_FIELD_BITPOS (field_type, j) / 8,
7303 field_type_p, byte_offset_p,
7304 bit_offset_p, bit_size_p, index_p))
7308 else if (index_p != NULL)
7312 /* Field not found so far. If this is a tagged type which
7313 has a parent, try finding that field in the parent now. */
7315 if (parent_offset != -1)
7317 int bit_pos = TYPE_FIELD_BITPOS (type, parent_offset);
7318 int fld_offset = offset + bit_pos / 8;
7320 if (find_struct_field (name, TYPE_FIELD_TYPE (type, parent_offset),
7321 fld_offset, field_type_p, byte_offset_p,
7322 bit_offset_p, bit_size_p, index_p))
7329 /* Number of user-visible fields in record type TYPE. */
7332 num_visible_fields (struct type *type)
7337 find_struct_field (NULL, type, 0, NULL, NULL, NULL, NULL, &n);
7341 /* Look for a field NAME in ARG. Adjust the address of ARG by OFFSET bytes,
7342 and search in it assuming it has (class) type TYPE.
7343 If found, return value, else return NULL.
7345 Searches recursively through wrapper fields (e.g., '_parent').
7347 In the case of homonyms in the tagged types, please refer to the
7348 long explanation in find_struct_field's function documentation. */
7350 static struct value *
7351 ada_search_struct_field (const char *name, struct value *arg, int offset,
7355 int parent_offset = -1;
7357 type = ada_check_typedef (type);
7358 for (i = 0; i < TYPE_NFIELDS (type); i += 1)
7360 const char *t_field_name = TYPE_FIELD_NAME (type, i);
7362 if (t_field_name == NULL)
7365 else if (ada_is_parent_field (type, i))
7367 /* This is a field pointing us to the parent type of a tagged
7368 type. As hinted in this function's documentation, we give
7369 preference to fields in the current record first, so what
7370 we do here is just record the index of this field before
7371 we skip it. If it turns out we couldn't find our field
7372 in the current record, then we'll get back to it and search
7373 inside it whether the field might exist in the parent. */
7379 else if (field_name_match (t_field_name, name))
7380 return ada_value_primitive_field (arg, offset, i, type);
7382 else if (ada_is_wrapper_field (type, i))
7384 struct value *v = /* Do not let indent join lines here. */
7385 ada_search_struct_field (name, arg,
7386 offset + TYPE_FIELD_BITPOS (type, i) / 8,
7387 TYPE_FIELD_TYPE (type, i));
7393 else if (ada_is_variant_part (type, i))
7395 /* PNH: Do we ever get here? See find_struct_field. */
7397 struct type *field_type = ada_check_typedef (TYPE_FIELD_TYPE (type,
7399 int var_offset = offset + TYPE_FIELD_BITPOS (type, i) / 8;
7401 for (j = 0; j < TYPE_NFIELDS (field_type); j += 1)
7403 struct value *v = ada_search_struct_field /* Force line
7406 var_offset + TYPE_FIELD_BITPOS (field_type, j) / 8,
7407 TYPE_FIELD_TYPE (field_type, j));
7415 /* Field not found so far. If this is a tagged type which
7416 has a parent, try finding that field in the parent now. */
7418 if (parent_offset != -1)
7420 struct value *v = ada_search_struct_field (
7421 name, arg, offset + TYPE_FIELD_BITPOS (type, parent_offset) / 8,
7422 TYPE_FIELD_TYPE (type, parent_offset));
7431 static struct value *ada_index_struct_field_1 (int *, struct value *,
7432 int, struct type *);
7435 /* Return field #INDEX in ARG, where the index is that returned by
7436 * find_struct_field through its INDEX_P argument. Adjust the address
7437 * of ARG by OFFSET bytes, and search in it assuming it has (class) type TYPE.
7438 * If found, return value, else return NULL. */
7440 static struct value *
7441 ada_index_struct_field (int index, struct value *arg, int offset,
7444 return ada_index_struct_field_1 (&index, arg, offset, type);
7448 /* Auxiliary function for ada_index_struct_field. Like
7449 * ada_index_struct_field, but takes index from *INDEX_P and modifies
7452 static struct value *
7453 ada_index_struct_field_1 (int *index_p, struct value *arg, int offset,
7457 type = ada_check_typedef (type);
7459 for (i = 0; i < TYPE_NFIELDS (type); i += 1)
7461 if (TYPE_FIELD_NAME (type, i) == NULL)
7463 else if (ada_is_wrapper_field (type, i))
7465 struct value *v = /* Do not let indent join lines here. */
7466 ada_index_struct_field_1 (index_p, arg,
7467 offset + TYPE_FIELD_BITPOS (type, i) / 8,
7468 TYPE_FIELD_TYPE (type, i));
7474 else if (ada_is_variant_part (type, i))
7476 /* PNH: Do we ever get here? See ada_search_struct_field,
7477 find_struct_field. */
7478 error (_("Cannot assign this kind of variant record"));
7480 else if (*index_p == 0)
7481 return ada_value_primitive_field (arg, offset, i, type);
7488 /* Given ARG, a value of type (pointer or reference to a)*
7489 structure/union, extract the component named NAME from the ultimate
7490 target structure/union and return it as a value with its
7493 The routine searches for NAME among all members of the structure itself
7494 and (recursively) among all members of any wrapper members
7497 If NO_ERR, then simply return NULL in case of error, rather than
7501 ada_value_struct_elt (struct value *arg, const char *name, int no_err)
7503 struct type *t, *t1;
7508 t1 = t = ada_check_typedef (value_type (arg));
7509 if (TYPE_CODE (t) == TYPE_CODE_REF)
7511 t1 = TYPE_TARGET_TYPE (t);
7514 t1 = ada_check_typedef (t1);
7515 if (TYPE_CODE (t1) == TYPE_CODE_PTR)
7517 arg = coerce_ref (arg);
7522 while (TYPE_CODE (t) == TYPE_CODE_PTR)
7524 t1 = TYPE_TARGET_TYPE (t);
7527 t1 = ada_check_typedef (t1);
7528 if (TYPE_CODE (t1) == TYPE_CODE_PTR)
7530 arg = value_ind (arg);
7537 if (TYPE_CODE (t1) != TYPE_CODE_STRUCT && TYPE_CODE (t1) != TYPE_CODE_UNION)
7541 v = ada_search_struct_field (name, arg, 0, t);
7544 int bit_offset, bit_size, byte_offset;
7545 struct type *field_type;
7548 if (TYPE_CODE (t) == TYPE_CODE_PTR)
7549 address = value_address (ada_value_ind (arg));
7551 address = value_address (ada_coerce_ref (arg));
7553 /* Check to see if this is a tagged type. We also need to handle
7554 the case where the type is a reference to a tagged type, but
7555 we have to be careful to exclude pointers to tagged types.
7556 The latter should be shown as usual (as a pointer), whereas
7557 a reference should mostly be transparent to the user. */
7559 if (ada_is_tagged_type (t1, 0)
7560 || (TYPE_CODE (t1) == TYPE_CODE_REF
7561 && ada_is_tagged_type (TYPE_TARGET_TYPE (t1), 0)))
7563 /* We first try to find the searched field in the current type.
7564 If not found then let's look in the fixed type. */
7566 if (!find_struct_field (name, t1, 0,
7567 &field_type, &byte_offset, &bit_offset,
7576 /* Convert to fixed type in all cases, so that we have proper
7577 offsets to each field in unconstrained record types. */
7578 t1 = ada_to_fixed_type (ada_get_base_type (t1), NULL,
7579 address, NULL, check_tag);
7581 if (find_struct_field (name, t1, 0,
7582 &field_type, &byte_offset, &bit_offset,
7587 if (TYPE_CODE (t) == TYPE_CODE_REF)
7588 arg = ada_coerce_ref (arg);
7590 arg = ada_value_ind (arg);
7591 v = ada_value_primitive_packed_val (arg, NULL, byte_offset,
7592 bit_offset, bit_size,
7596 v = value_at_lazy (field_type, address + byte_offset);
7600 if (v != NULL || no_err)
7603 error (_("There is no member named %s."), name);
7609 error (_("Attempt to extract a component of "
7610 "a value that is not a record."));
7613 /* Return a string representation of type TYPE. */
7616 type_as_string (struct type *type)
7618 string_file tmp_stream;
7620 type_print (type, "", &tmp_stream, -1);
7622 return std::move (tmp_stream.string ());
7625 /* Given a type TYPE, look up the type of the component of type named NAME.
7626 If DISPP is non-null, add its byte displacement from the beginning of a
7627 structure (pointed to by a value) of type TYPE to *DISPP (does not
7628 work for packed fields).
7630 Matches any field whose name has NAME as a prefix, possibly
7633 TYPE can be either a struct or union. If REFOK, TYPE may also
7634 be a (pointer or reference)+ to a struct or union, and the
7635 ultimate target type will be searched.
7637 Looks recursively into variant clauses and parent types.
7639 In the case of homonyms in the tagged types, please refer to the
7640 long explanation in find_struct_field's function documentation.
7642 If NOERR is nonzero, return NULL if NAME is not suitably defined or
7643 TYPE is not a type of the right kind. */
7645 static struct type *
7646 ada_lookup_struct_elt_type (struct type *type, const char *name, int refok,
7650 int parent_offset = -1;
7655 if (refok && type != NULL)
7658 type = ada_check_typedef (type);
7659 if (TYPE_CODE (type) != TYPE_CODE_PTR
7660 && TYPE_CODE (type) != TYPE_CODE_REF)
7662 type = TYPE_TARGET_TYPE (type);
7666 || (TYPE_CODE (type) != TYPE_CODE_STRUCT
7667 && TYPE_CODE (type) != TYPE_CODE_UNION))
7672 error (_("Type %s is not a structure or union type"),
7673 type != NULL ? type_as_string (type).c_str () : _("(null)"));
7676 type = to_static_fixed_type (type);
7678 for (i = 0; i < TYPE_NFIELDS (type); i += 1)
7680 const char *t_field_name = TYPE_FIELD_NAME (type, i);
7683 if (t_field_name == NULL)
7686 else if (ada_is_parent_field (type, i))
7688 /* This is a field pointing us to the parent type of a tagged
7689 type. As hinted in this function's documentation, we give
7690 preference to fields in the current record first, so what
7691 we do here is just record the index of this field before
7692 we skip it. If it turns out we couldn't find our field
7693 in the current record, then we'll get back to it and search
7694 inside it whether the field might exist in the parent. */
7700 else if (field_name_match (t_field_name, name))
7701 return TYPE_FIELD_TYPE (type, i);
7703 else if (ada_is_wrapper_field (type, i))
7705 t = ada_lookup_struct_elt_type (TYPE_FIELD_TYPE (type, i), name,
7711 else if (ada_is_variant_part (type, i))
7714 struct type *field_type = ada_check_typedef (TYPE_FIELD_TYPE (type,
7717 for (j = TYPE_NFIELDS (field_type) - 1; j >= 0; j -= 1)
7719 /* FIXME pnh 2008/01/26: We check for a field that is
7720 NOT wrapped in a struct, since the compiler sometimes
7721 generates these for unchecked variant types. Revisit
7722 if the compiler changes this practice. */
7723 const char *v_field_name = TYPE_FIELD_NAME (field_type, j);
7725 if (v_field_name != NULL
7726 && field_name_match (v_field_name, name))
7727 t = TYPE_FIELD_TYPE (field_type, j);
7729 t = ada_lookup_struct_elt_type (TYPE_FIELD_TYPE (field_type,
7740 /* Field not found so far. If this is a tagged type which
7741 has a parent, try finding that field in the parent now. */
7743 if (parent_offset != -1)
7747 t = ada_lookup_struct_elt_type (TYPE_FIELD_TYPE (type, parent_offset),
7756 const char *name_str = name != NULL ? name : _("<null>");
7758 error (_("Type %s has no component named %s"),
7759 type_as_string (type).c_str (), name_str);
7765 /* Assuming that VAR_TYPE is the type of a variant part of a record (a union),
7766 within a value of type OUTER_TYPE, return true iff VAR_TYPE
7767 represents an unchecked union (that is, the variant part of a
7768 record that is named in an Unchecked_Union pragma). */
7771 is_unchecked_variant (struct type *var_type, struct type *outer_type)
7773 const char *discrim_name = ada_variant_discrim_name (var_type);
7775 return (ada_lookup_struct_elt_type (outer_type, discrim_name, 0, 1) == NULL);
7779 /* Assuming that VAR_TYPE is the type of a variant part of a record (a union),
7780 within a value of type OUTER_TYPE that is stored in GDB at
7781 OUTER_VALADDR, determine which variant clause (field number in VAR_TYPE,
7782 numbering from 0) is applicable. Returns -1 if none are. */
7785 ada_which_variant_applies (struct type *var_type, struct type *outer_type,
7786 const gdb_byte *outer_valaddr)
7790 const char *discrim_name = ada_variant_discrim_name (var_type);
7791 struct value *outer;
7792 struct value *discrim;
7793 LONGEST discrim_val;
7795 /* Using plain value_from_contents_and_address here causes problems
7796 because we will end up trying to resolve a type that is currently
7797 being constructed. */
7798 outer = value_from_contents_and_address_unresolved (outer_type,
7800 discrim = ada_value_struct_elt (outer, discrim_name, 1);
7801 if (discrim == NULL)
7803 discrim_val = value_as_long (discrim);
7806 for (i = 0; i < TYPE_NFIELDS (var_type); i += 1)
7808 if (ada_is_others_clause (var_type, i))
7810 else if (ada_in_variant (discrim_val, var_type, i))
7814 return others_clause;
7819 /* Dynamic-Sized Records */
7821 /* Strategy: The type ostensibly attached to a value with dynamic size
7822 (i.e., a size that is not statically recorded in the debugging
7823 data) does not accurately reflect the size or layout of the value.
7824 Our strategy is to convert these values to values with accurate,
7825 conventional types that are constructed on the fly. */
7827 /* There is a subtle and tricky problem here. In general, we cannot
7828 determine the size of dynamic records without its data. However,
7829 the 'struct value' data structure, which GDB uses to represent
7830 quantities in the inferior process (the target), requires the size
7831 of the type at the time of its allocation in order to reserve space
7832 for GDB's internal copy of the data. That's why the
7833 'to_fixed_xxx_type' routines take (target) addresses as parameters,
7834 rather than struct value*s.
7836 However, GDB's internal history variables ($1, $2, etc.) are
7837 struct value*s containing internal copies of the data that are not, in
7838 general, the same as the data at their corresponding addresses in
7839 the target. Fortunately, the types we give to these values are all
7840 conventional, fixed-size types (as per the strategy described
7841 above), so that we don't usually have to perform the
7842 'to_fixed_xxx_type' conversions to look at their values.
7843 Unfortunately, there is one exception: if one of the internal
7844 history variables is an array whose elements are unconstrained
7845 records, then we will need to create distinct fixed types for each
7846 element selected. */
7848 /* The upshot of all of this is that many routines take a (type, host
7849 address, target address) triple as arguments to represent a value.
7850 The host address, if non-null, is supposed to contain an internal
7851 copy of the relevant data; otherwise, the program is to consult the
7852 target at the target address. */
7854 /* Assuming that VAL0 represents a pointer value, the result of
7855 dereferencing it. Differs from value_ind in its treatment of
7856 dynamic-sized types. */
7859 ada_value_ind (struct value *val0)
7861 struct value *val = value_ind (val0);
7863 if (ada_is_tagged_type (value_type (val), 0))
7864 val = ada_tag_value_at_base_address (val);
7866 return ada_to_fixed_value (val);
7869 /* The value resulting from dereferencing any "reference to"
7870 qualifiers on VAL0. */
7872 static struct value *
7873 ada_coerce_ref (struct value *val0)
7875 if (TYPE_CODE (value_type (val0)) == TYPE_CODE_REF)
7877 struct value *val = val0;
7879 val = coerce_ref (val);
7881 if (ada_is_tagged_type (value_type (val), 0))
7882 val = ada_tag_value_at_base_address (val);
7884 return ada_to_fixed_value (val);
7890 /* Return OFF rounded upward if necessary to a multiple of
7891 ALIGNMENT (a power of 2). */
7894 align_value (unsigned int off, unsigned int alignment)
7896 return (off + alignment - 1) & ~(alignment - 1);
7899 /* Return the bit alignment required for field #F of template type TYPE. */
7902 field_alignment (struct type *type, int f)
7904 const char *name = TYPE_FIELD_NAME (type, f);
7908 /* The field name should never be null, unless the debugging information
7909 is somehow malformed. In this case, we assume the field does not
7910 require any alignment. */
7914 len = strlen (name);
7916 if (!isdigit (name[len - 1]))
7919 if (isdigit (name[len - 2]))
7920 align_offset = len - 2;
7922 align_offset = len - 1;
7924 if (align_offset < 7 || !startswith (name + align_offset - 6, "___XV"))
7925 return TARGET_CHAR_BIT;
7927 return atoi (name + align_offset) * TARGET_CHAR_BIT;
7930 /* Find a typedef or tag symbol named NAME. Ignores ambiguity. */
7932 static struct symbol *
7933 ada_find_any_type_symbol (const char *name)
7937 sym = standard_lookup (name, get_selected_block (NULL), VAR_DOMAIN);
7938 if (sym != NULL && SYMBOL_CLASS (sym) == LOC_TYPEDEF)
7941 sym = standard_lookup (name, NULL, STRUCT_DOMAIN);
7945 /* Find a type named NAME. Ignores ambiguity. This routine will look
7946 solely for types defined by debug info, it will not search the GDB
7949 static struct type *
7950 ada_find_any_type (const char *name)
7952 struct symbol *sym = ada_find_any_type_symbol (name);
7955 return SYMBOL_TYPE (sym);
7960 /* Given NAME_SYM and an associated BLOCK, find a "renaming" symbol
7961 associated with NAME_SYM's name. NAME_SYM may itself be a renaming
7962 symbol, in which case it is returned. Otherwise, this looks for
7963 symbols whose name is that of NAME_SYM suffixed with "___XR".
7964 Return symbol if found, and NULL otherwise. */
7967 ada_find_renaming_symbol (struct symbol *name_sym, const struct block *block)
7969 const char *name = SYMBOL_LINKAGE_NAME (name_sym);
7972 if (strstr (name, "___XR") != NULL)
7975 sym = find_old_style_renaming_symbol (name, block);
7980 /* Not right yet. FIXME pnh 7/20/2007. */
7981 sym = ada_find_any_type_symbol (name);
7982 if (sym != NULL && strstr (SYMBOL_LINKAGE_NAME (sym), "___XR") != NULL)
7988 static struct symbol *
7989 find_old_style_renaming_symbol (const char *name, const struct block *block)
7991 const struct symbol *function_sym = block_linkage_function (block);
7994 if (function_sym != NULL)
7996 /* If the symbol is defined inside a function, NAME is not fully
7997 qualified. This means we need to prepend the function name
7998 as well as adding the ``___XR'' suffix to build the name of
7999 the associated renaming symbol. */
8000 const char *function_name = SYMBOL_LINKAGE_NAME (function_sym);
8001 /* Function names sometimes contain suffixes used
8002 for instance to qualify nested subprograms. When building
8003 the XR type name, we need to make sure that this suffix is
8004 not included. So do not include any suffix in the function
8005 name length below. */
8006 int function_name_len = ada_name_prefix_len (function_name);
8007 const int rename_len = function_name_len + 2 /* "__" */
8008 + strlen (name) + 6 /* "___XR\0" */ ;
8010 /* Strip the suffix if necessary. */
8011 ada_remove_trailing_digits (function_name, &function_name_len);
8012 ada_remove_po_subprogram_suffix (function_name, &function_name_len);
8013 ada_remove_Xbn_suffix (function_name, &function_name_len);
8015 /* Library-level functions are a special case, as GNAT adds
8016 a ``_ada_'' prefix to the function name to avoid namespace
8017 pollution. However, the renaming symbols themselves do not
8018 have this prefix, so we need to skip this prefix if present. */
8019 if (function_name_len > 5 /* "_ada_" */
8020 && strstr (function_name, "_ada_") == function_name)
8023 function_name_len -= 5;
8026 rename = (char *) alloca (rename_len * sizeof (char));
8027 strncpy (rename, function_name, function_name_len);
8028 xsnprintf (rename + function_name_len, rename_len - function_name_len,
8033 const int rename_len = strlen (name) + 6;
8035 rename = (char *) alloca (rename_len * sizeof (char));
8036 xsnprintf (rename, rename_len * sizeof (char), "%s___XR", name);
8039 return ada_find_any_type_symbol (rename);
8042 /* Because of GNAT encoding conventions, several GDB symbols may match a
8043 given type name. If the type denoted by TYPE0 is to be preferred to
8044 that of TYPE1 for purposes of type printing, return non-zero;
8045 otherwise return 0. */
8048 ada_prefer_type (struct type *type0, struct type *type1)
8052 else if (type0 == NULL)
8054 else if (TYPE_CODE (type1) == TYPE_CODE_VOID)
8056 else if (TYPE_CODE (type0) == TYPE_CODE_VOID)
8058 else if (TYPE_NAME (type1) == NULL && TYPE_NAME (type0) != NULL)
8060 else if (ada_is_constrained_packed_array_type (type0))
8062 else if (ada_is_array_descriptor_type (type0)
8063 && !ada_is_array_descriptor_type (type1))
8067 const char *type0_name = TYPE_NAME (type0);
8068 const char *type1_name = TYPE_NAME (type1);
8070 if (type0_name != NULL && strstr (type0_name, "___XR") != NULL
8071 && (type1_name == NULL || strstr (type1_name, "___XR") == NULL))
8077 /* The name of TYPE, which is its TYPE_NAME. Null if TYPE is
8081 ada_type_name (struct type *type)
8085 return TYPE_NAME (type);
8088 /* Search the list of "descriptive" types associated to TYPE for a type
8089 whose name is NAME. */
8091 static struct type *
8092 find_parallel_type_by_descriptive_type (struct type *type, const char *name)
8094 struct type *result, *tmp;
8096 if (ada_ignore_descriptive_types_p)
8099 /* If there no descriptive-type info, then there is no parallel type
8101 if (!HAVE_GNAT_AUX_INFO (type))
8104 result = TYPE_DESCRIPTIVE_TYPE (type);
8105 while (result != NULL)
8107 const char *result_name = ada_type_name (result);
8109 if (result_name == NULL)
8111 warning (_("unexpected null name on descriptive type"));
8115 /* If the names match, stop. */
8116 if (strcmp (result_name, name) == 0)
8119 /* Otherwise, look at the next item on the list, if any. */
8120 if (HAVE_GNAT_AUX_INFO (result))
8121 tmp = TYPE_DESCRIPTIVE_TYPE (result);
8125 /* If not found either, try after having resolved the typedef. */
8130 result = check_typedef (result);
8131 if (HAVE_GNAT_AUX_INFO (result))
8132 result = TYPE_DESCRIPTIVE_TYPE (result);
8138 /* If we didn't find a match, see whether this is a packed array. With
8139 older compilers, the descriptive type information is either absent or
8140 irrelevant when it comes to packed arrays so the above lookup fails.
8141 Fall back to using a parallel lookup by name in this case. */
8142 if (result == NULL && ada_is_constrained_packed_array_type (type))
8143 return ada_find_any_type (name);
8148 /* Find a parallel type to TYPE with the specified NAME, using the
8149 descriptive type taken from the debugging information, if available,
8150 and otherwise using the (slower) name-based method. */
8152 static struct type *
8153 ada_find_parallel_type_with_name (struct type *type, const char *name)
8155 struct type *result = NULL;
8157 if (HAVE_GNAT_AUX_INFO (type))
8158 result = find_parallel_type_by_descriptive_type (type, name);
8160 result = ada_find_any_type (name);
8165 /* Same as above, but specify the name of the parallel type by appending
8166 SUFFIX to the name of TYPE. */
8169 ada_find_parallel_type (struct type *type, const char *suffix)
8172 const char *type_name = ada_type_name (type);
8175 if (type_name == NULL)
8178 len = strlen (type_name);
8180 name = (char *) alloca (len + strlen (suffix) + 1);
8182 strcpy (name, type_name);
8183 strcpy (name + len, suffix);
8185 return ada_find_parallel_type_with_name (type, name);
8188 /* If TYPE is a variable-size record type, return the corresponding template
8189 type describing its fields. Otherwise, return NULL. */
8191 static struct type *
8192 dynamic_template_type (struct type *type)
8194 type = ada_check_typedef (type);
8196 if (type == NULL || TYPE_CODE (type) != TYPE_CODE_STRUCT
8197 || ada_type_name (type) == NULL)
8201 int len = strlen (ada_type_name (type));
8203 if (len > 6 && strcmp (ada_type_name (type) + len - 6, "___XVE") == 0)
8206 return ada_find_parallel_type (type, "___XVE");
8210 /* Assuming that TEMPL_TYPE is a union or struct type, returns
8211 non-zero iff field FIELD_NUM of TEMPL_TYPE has dynamic size. */
8214 is_dynamic_field (struct type *templ_type, int field_num)
8216 const char *name = TYPE_FIELD_NAME (templ_type, field_num);
8219 && TYPE_CODE (TYPE_FIELD_TYPE (templ_type, field_num)) == TYPE_CODE_PTR
8220 && strstr (name, "___XVL") != NULL;
8223 /* The index of the variant field of TYPE, or -1 if TYPE does not
8224 represent a variant record type. */
8227 variant_field_index (struct type *type)
8231 if (type == NULL || TYPE_CODE (type) != TYPE_CODE_STRUCT)
8234 for (f = 0; f < TYPE_NFIELDS (type); f += 1)
8236 if (ada_is_variant_part (type, f))
8242 /* A record type with no fields. */
8244 static struct type *
8245 empty_record (struct type *templ)
8247 struct type *type = alloc_type_copy (templ);
8249 TYPE_CODE (type) = TYPE_CODE_STRUCT;
8250 TYPE_NFIELDS (type) = 0;
8251 TYPE_FIELDS (type) = NULL;
8252 INIT_CPLUS_SPECIFIC (type);
8253 TYPE_NAME (type) = "<empty>";
8254 TYPE_LENGTH (type) = 0;
8258 /* An ordinary record type (with fixed-length fields) that describes
8259 the value of type TYPE at VALADDR or ADDRESS (see comments at
8260 the beginning of this section) VAL according to GNAT conventions.
8261 DVAL0 should describe the (portion of a) record that contains any
8262 necessary discriminants. It should be NULL if value_type (VAL) is
8263 an outer-level type (i.e., as opposed to a branch of a variant.) A
8264 variant field (unless unchecked) is replaced by a particular branch
8267 If not KEEP_DYNAMIC_FIELDS, then all fields whose position or
8268 length are not statically known are discarded. As a consequence,
8269 VALADDR, ADDRESS and DVAL0 are ignored.
8271 NOTE: Limitations: For now, we assume that dynamic fields and
8272 variants occupy whole numbers of bytes. However, they need not be
8276 ada_template_to_fixed_record_type_1 (struct type *type,
8277 const gdb_byte *valaddr,
8278 CORE_ADDR address, struct value *dval0,
8279 int keep_dynamic_fields)
8281 struct value *mark = value_mark ();
8284 int nfields, bit_len;
8290 /* Compute the number of fields in this record type that are going
8291 to be processed: unless keep_dynamic_fields, this includes only
8292 fields whose position and length are static will be processed. */
8293 if (keep_dynamic_fields)
8294 nfields = TYPE_NFIELDS (type);
8298 while (nfields < TYPE_NFIELDS (type)
8299 && !ada_is_variant_part (type, nfields)
8300 && !is_dynamic_field (type, nfields))
8304 rtype = alloc_type_copy (type);
8305 TYPE_CODE (rtype) = TYPE_CODE_STRUCT;
8306 INIT_CPLUS_SPECIFIC (rtype);
8307 TYPE_NFIELDS (rtype) = nfields;
8308 TYPE_FIELDS (rtype) = (struct field *)
8309 TYPE_ALLOC (rtype, nfields * sizeof (struct field));
8310 memset (TYPE_FIELDS (rtype), 0, sizeof (struct field) * nfields);
8311 TYPE_NAME (rtype) = ada_type_name (type);
8312 TYPE_FIXED_INSTANCE (rtype) = 1;
8318 for (f = 0; f < nfields; f += 1)
8320 off = align_value (off, field_alignment (type, f))
8321 + TYPE_FIELD_BITPOS (type, f);
8322 SET_FIELD_BITPOS (TYPE_FIELD (rtype, f), off);
8323 TYPE_FIELD_BITSIZE (rtype, f) = 0;
8325 if (ada_is_variant_part (type, f))
8330 else if (is_dynamic_field (type, f))
8332 const gdb_byte *field_valaddr = valaddr;
8333 CORE_ADDR field_address = address;
8334 struct type *field_type =
8335 TYPE_TARGET_TYPE (TYPE_FIELD_TYPE (type, f));
8339 /* rtype's length is computed based on the run-time
8340 value of discriminants. If the discriminants are not
8341 initialized, the type size may be completely bogus and
8342 GDB may fail to allocate a value for it. So check the
8343 size first before creating the value. */
8344 ada_ensure_varsize_limit (rtype);
8345 /* Using plain value_from_contents_and_address here
8346 causes problems because we will end up trying to
8347 resolve a type that is currently being
8349 dval = value_from_contents_and_address_unresolved (rtype,
8352 rtype = value_type (dval);
8357 /* If the type referenced by this field is an aligner type, we need
8358 to unwrap that aligner type, because its size might not be set.
8359 Keeping the aligner type would cause us to compute the wrong
8360 size for this field, impacting the offset of the all the fields
8361 that follow this one. */
8362 if (ada_is_aligner_type (field_type))
8364 long field_offset = TYPE_FIELD_BITPOS (field_type, f);
8366 field_valaddr = cond_offset_host (field_valaddr, field_offset);
8367 field_address = cond_offset_target (field_address, field_offset);
8368 field_type = ada_aligned_type (field_type);
8371 field_valaddr = cond_offset_host (field_valaddr,
8372 off / TARGET_CHAR_BIT);
8373 field_address = cond_offset_target (field_address,
8374 off / TARGET_CHAR_BIT);
8376 /* Get the fixed type of the field. Note that, in this case,
8377 we do not want to get the real type out of the tag: if
8378 the current field is the parent part of a tagged record,
8379 we will get the tag of the object. Clearly wrong: the real
8380 type of the parent is not the real type of the child. We
8381 would end up in an infinite loop. */
8382 field_type = ada_get_base_type (field_type);
8383 field_type = ada_to_fixed_type (field_type, field_valaddr,
8384 field_address, dval, 0);
8385 /* If the field size is already larger than the maximum
8386 object size, then the record itself will necessarily
8387 be larger than the maximum object size. We need to make
8388 this check now, because the size might be so ridiculously
8389 large (due to an uninitialized variable in the inferior)
8390 that it would cause an overflow when adding it to the
8392 ada_ensure_varsize_limit (field_type);
8394 TYPE_FIELD_TYPE (rtype, f) = field_type;
8395 TYPE_FIELD_NAME (rtype, f) = TYPE_FIELD_NAME (type, f);
8396 /* The multiplication can potentially overflow. But because
8397 the field length has been size-checked just above, and
8398 assuming that the maximum size is a reasonable value,
8399 an overflow should not happen in practice. So rather than
8400 adding overflow recovery code to this already complex code,
8401 we just assume that it's not going to happen. */
8403 TYPE_LENGTH (TYPE_FIELD_TYPE (rtype, f)) * TARGET_CHAR_BIT;
8407 /* Note: If this field's type is a typedef, it is important
8408 to preserve the typedef layer.
8410 Otherwise, we might be transforming a typedef to a fat
8411 pointer (encoding a pointer to an unconstrained array),
8412 into a basic fat pointer (encoding an unconstrained
8413 array). As both types are implemented using the same
8414 structure, the typedef is the only clue which allows us
8415 to distinguish between the two options. Stripping it
8416 would prevent us from printing this field appropriately. */
8417 TYPE_FIELD_TYPE (rtype, f) = TYPE_FIELD_TYPE (type, f);
8418 TYPE_FIELD_NAME (rtype, f) = TYPE_FIELD_NAME (type, f);
8419 if (TYPE_FIELD_BITSIZE (type, f) > 0)
8421 TYPE_FIELD_BITSIZE (rtype, f) = TYPE_FIELD_BITSIZE (type, f);
8424 struct type *field_type = TYPE_FIELD_TYPE (type, f);
8426 /* We need to be careful of typedefs when computing
8427 the length of our field. If this is a typedef,
8428 get the length of the target type, not the length
8430 if (TYPE_CODE (field_type) == TYPE_CODE_TYPEDEF)
8431 field_type = ada_typedef_target_type (field_type);
8434 TYPE_LENGTH (ada_check_typedef (field_type)) * TARGET_CHAR_BIT;
8437 if (off + fld_bit_len > bit_len)
8438 bit_len = off + fld_bit_len;
8440 TYPE_LENGTH (rtype) =
8441 align_value (bit_len, TARGET_CHAR_BIT) / TARGET_CHAR_BIT;
8444 /* We handle the variant part, if any, at the end because of certain
8445 odd cases in which it is re-ordered so as NOT to be the last field of
8446 the record. This can happen in the presence of representation
8448 if (variant_field >= 0)
8450 struct type *branch_type;
8452 off = TYPE_FIELD_BITPOS (rtype, variant_field);
8456 /* Using plain value_from_contents_and_address here causes
8457 problems because we will end up trying to resolve a type
8458 that is currently being constructed. */
8459 dval = value_from_contents_and_address_unresolved (rtype, valaddr,
8461 rtype = value_type (dval);
8467 to_fixed_variant_branch_type
8468 (TYPE_FIELD_TYPE (type, variant_field),
8469 cond_offset_host (valaddr, off / TARGET_CHAR_BIT),
8470 cond_offset_target (address, off / TARGET_CHAR_BIT), dval);
8471 if (branch_type == NULL)
8473 for (f = variant_field + 1; f < TYPE_NFIELDS (rtype); f += 1)
8474 TYPE_FIELDS (rtype)[f - 1] = TYPE_FIELDS (rtype)[f];
8475 TYPE_NFIELDS (rtype) -= 1;
8479 TYPE_FIELD_TYPE (rtype, variant_field) = branch_type;
8480 TYPE_FIELD_NAME (rtype, variant_field) = "S";
8482 TYPE_LENGTH (TYPE_FIELD_TYPE (rtype, variant_field)) *
8484 if (off + fld_bit_len > bit_len)
8485 bit_len = off + fld_bit_len;
8486 TYPE_LENGTH (rtype) =
8487 align_value (bit_len, TARGET_CHAR_BIT) / TARGET_CHAR_BIT;
8491 /* According to exp_dbug.ads, the size of TYPE for variable-size records
8492 should contain the alignment of that record, which should be a strictly
8493 positive value. If null or negative, then something is wrong, most
8494 probably in the debug info. In that case, we don't round up the size
8495 of the resulting type. If this record is not part of another structure,
8496 the current RTYPE length might be good enough for our purposes. */
8497 if (TYPE_LENGTH (type) <= 0)
8499 if (TYPE_NAME (rtype))
8500 warning (_("Invalid type size for `%s' detected: %d."),
8501 TYPE_NAME (rtype), TYPE_LENGTH (type));
8503 warning (_("Invalid type size for <unnamed> detected: %d."),
8504 TYPE_LENGTH (type));
8508 TYPE_LENGTH (rtype) = align_value (TYPE_LENGTH (rtype),
8509 TYPE_LENGTH (type));
8512 value_free_to_mark (mark);
8513 if (TYPE_LENGTH (rtype) > varsize_limit)
8514 error (_("record type with dynamic size is larger than varsize-limit"));
8518 /* As for ada_template_to_fixed_record_type_1 with KEEP_DYNAMIC_FIELDS
8521 static struct type *
8522 template_to_fixed_record_type (struct type *type, const gdb_byte *valaddr,
8523 CORE_ADDR address, struct value *dval0)
8525 return ada_template_to_fixed_record_type_1 (type, valaddr,
8529 /* An ordinary record type in which ___XVL-convention fields and
8530 ___XVU- and ___XVN-convention field types in TYPE0 are replaced with
8531 static approximations, containing all possible fields. Uses
8532 no runtime values. Useless for use in values, but that's OK,
8533 since the results are used only for type determinations. Works on both
8534 structs and unions. Representation note: to save space, we memorize
8535 the result of this function in the TYPE_TARGET_TYPE of the
8538 static struct type *
8539 template_to_static_fixed_type (struct type *type0)
8545 /* No need no do anything if the input type is already fixed. */
8546 if (TYPE_FIXED_INSTANCE (type0))
8549 /* Likewise if we already have computed the static approximation. */
8550 if (TYPE_TARGET_TYPE (type0) != NULL)
8551 return TYPE_TARGET_TYPE (type0);
8553 /* Don't clone TYPE0 until we are sure we are going to need a copy. */
8555 nfields = TYPE_NFIELDS (type0);
8557 /* Whether or not we cloned TYPE0, cache the result so that we don't do
8558 recompute all over next time. */
8559 TYPE_TARGET_TYPE (type0) = type;
8561 for (f = 0; f < nfields; f += 1)
8563 struct type *field_type = TYPE_FIELD_TYPE (type0, f);
8564 struct type *new_type;
8566 if (is_dynamic_field (type0, f))
8568 field_type = ada_check_typedef (field_type);
8569 new_type = to_static_fixed_type (TYPE_TARGET_TYPE (field_type));
8572 new_type = static_unwrap_type (field_type);
8574 if (new_type != field_type)
8576 /* Clone TYPE0 only the first time we get a new field type. */
8579 TYPE_TARGET_TYPE (type0) = type = alloc_type_copy (type0);
8580 TYPE_CODE (type) = TYPE_CODE (type0);
8581 INIT_CPLUS_SPECIFIC (type);
8582 TYPE_NFIELDS (type) = nfields;
8583 TYPE_FIELDS (type) = (struct field *)
8584 TYPE_ALLOC (type, nfields * sizeof (struct field));
8585 memcpy (TYPE_FIELDS (type), TYPE_FIELDS (type0),
8586 sizeof (struct field) * nfields);
8587 TYPE_NAME (type) = ada_type_name (type0);
8588 TYPE_FIXED_INSTANCE (type) = 1;
8589 TYPE_LENGTH (type) = 0;
8591 TYPE_FIELD_TYPE (type, f) = new_type;
8592 TYPE_FIELD_NAME (type, f) = TYPE_FIELD_NAME (type0, f);
8599 /* Given an object of type TYPE whose contents are at VALADDR and
8600 whose address in memory is ADDRESS, returns a revision of TYPE,
8601 which should be a non-dynamic-sized record, in which the variant
8602 part, if any, is replaced with the appropriate branch. Looks
8603 for discriminant values in DVAL0, which can be NULL if the record
8604 contains the necessary discriminant values. */
8606 static struct type *
8607 to_record_with_fixed_variant_part (struct type *type, const gdb_byte *valaddr,
8608 CORE_ADDR address, struct value *dval0)
8610 struct value *mark = value_mark ();
8613 struct type *branch_type;
8614 int nfields = TYPE_NFIELDS (type);
8615 int variant_field = variant_field_index (type);
8617 if (variant_field == -1)
8622 dval = value_from_contents_and_address (type, valaddr, address);
8623 type = value_type (dval);
8628 rtype = alloc_type_copy (type);
8629 TYPE_CODE (rtype) = TYPE_CODE_STRUCT;
8630 INIT_CPLUS_SPECIFIC (rtype);
8631 TYPE_NFIELDS (rtype) = nfields;
8632 TYPE_FIELDS (rtype) =
8633 (struct field *) TYPE_ALLOC (rtype, nfields * sizeof (struct field));
8634 memcpy (TYPE_FIELDS (rtype), TYPE_FIELDS (type),
8635 sizeof (struct field) * nfields);
8636 TYPE_NAME (rtype) = ada_type_name (type);
8637 TYPE_FIXED_INSTANCE (rtype) = 1;
8638 TYPE_LENGTH (rtype) = TYPE_LENGTH (type);
8640 branch_type = to_fixed_variant_branch_type
8641 (TYPE_FIELD_TYPE (type, variant_field),
8642 cond_offset_host (valaddr,
8643 TYPE_FIELD_BITPOS (type, variant_field)
8645 cond_offset_target (address,
8646 TYPE_FIELD_BITPOS (type, variant_field)
8647 / TARGET_CHAR_BIT), dval);
8648 if (branch_type == NULL)
8652 for (f = variant_field + 1; f < nfields; f += 1)
8653 TYPE_FIELDS (rtype)[f - 1] = TYPE_FIELDS (rtype)[f];
8654 TYPE_NFIELDS (rtype) -= 1;
8658 TYPE_FIELD_TYPE (rtype, variant_field) = branch_type;
8659 TYPE_FIELD_NAME (rtype, variant_field) = "S";
8660 TYPE_FIELD_BITSIZE (rtype, variant_field) = 0;
8661 TYPE_LENGTH (rtype) += TYPE_LENGTH (branch_type);
8663 TYPE_LENGTH (rtype) -= TYPE_LENGTH (TYPE_FIELD_TYPE (type, variant_field));
8665 value_free_to_mark (mark);
8669 /* An ordinary record type (with fixed-length fields) that describes
8670 the value at (TYPE0, VALADDR, ADDRESS) [see explanation at
8671 beginning of this section]. Any necessary discriminants' values
8672 should be in DVAL, a record value; it may be NULL if the object
8673 at ADDR itself contains any necessary discriminant values.
8674 Additionally, VALADDR and ADDRESS may also be NULL if no discriminant
8675 values from the record are needed. Except in the case that DVAL,
8676 VALADDR, and ADDRESS are all 0 or NULL, a variant field (unless
8677 unchecked) is replaced by a particular branch of the variant.
8679 NOTE: the case in which DVAL and VALADDR are NULL and ADDRESS is 0
8680 is questionable and may be removed. It can arise during the
8681 processing of an unconstrained-array-of-record type where all the
8682 variant branches have exactly the same size. This is because in
8683 such cases, the compiler does not bother to use the XVS convention
8684 when encoding the record. I am currently dubious of this
8685 shortcut and suspect the compiler should be altered. FIXME. */
8687 static struct type *
8688 to_fixed_record_type (struct type *type0, const gdb_byte *valaddr,
8689 CORE_ADDR address, struct value *dval)
8691 struct type *templ_type;
8693 if (TYPE_FIXED_INSTANCE (type0))
8696 templ_type = dynamic_template_type (type0);
8698 if (templ_type != NULL)
8699 return template_to_fixed_record_type (templ_type, valaddr, address, dval);
8700 else if (variant_field_index (type0) >= 0)
8702 if (dval == NULL && valaddr == NULL && address == 0)
8704 return to_record_with_fixed_variant_part (type0, valaddr, address,
8709 TYPE_FIXED_INSTANCE (type0) = 1;
8715 /* An ordinary record type (with fixed-length fields) that describes
8716 the value at (VAR_TYPE0, VALADDR, ADDRESS), where VAR_TYPE0 is a
8717 union type. Any necessary discriminants' values should be in DVAL,
8718 a record value. That is, this routine selects the appropriate
8719 branch of the union at ADDR according to the discriminant value
8720 indicated in the union's type name. Returns VAR_TYPE0 itself if
8721 it represents a variant subject to a pragma Unchecked_Union. */
8723 static struct type *
8724 to_fixed_variant_branch_type (struct type *var_type0, const gdb_byte *valaddr,
8725 CORE_ADDR address, struct value *dval)
8728 struct type *templ_type;
8729 struct type *var_type;
8731 if (TYPE_CODE (var_type0) == TYPE_CODE_PTR)
8732 var_type = TYPE_TARGET_TYPE (var_type0);
8734 var_type = var_type0;
8736 templ_type = ada_find_parallel_type (var_type, "___XVU");
8738 if (templ_type != NULL)
8739 var_type = templ_type;
8741 if (is_unchecked_variant (var_type, value_type (dval)))
8744 ada_which_variant_applies (var_type,
8745 value_type (dval), value_contents (dval));
8748 return empty_record (var_type);
8749 else if (is_dynamic_field (var_type, which))
8750 return to_fixed_record_type
8751 (TYPE_TARGET_TYPE (TYPE_FIELD_TYPE (var_type, which)),
8752 valaddr, address, dval);
8753 else if (variant_field_index (TYPE_FIELD_TYPE (var_type, which)) >= 0)
8755 to_fixed_record_type
8756 (TYPE_FIELD_TYPE (var_type, which), valaddr, address, dval);
8758 return TYPE_FIELD_TYPE (var_type, which);
8761 /* Assuming RANGE_TYPE is a TYPE_CODE_RANGE, return nonzero if
8762 ENCODING_TYPE, a type following the GNAT conventions for discrete
8763 type encodings, only carries redundant information. */
8766 ada_is_redundant_range_encoding (struct type *range_type,
8767 struct type *encoding_type)
8769 const char *bounds_str;
8773 gdb_assert (TYPE_CODE (range_type) == TYPE_CODE_RANGE);
8775 if (TYPE_CODE (get_base_type (range_type))
8776 != TYPE_CODE (get_base_type (encoding_type)))
8778 /* The compiler probably used a simple base type to describe
8779 the range type instead of the range's actual base type,
8780 expecting us to get the real base type from the encoding
8781 anyway. In this situation, the encoding cannot be ignored
8786 if (is_dynamic_type (range_type))
8789 if (TYPE_NAME (encoding_type) == NULL)
8792 bounds_str = strstr (TYPE_NAME (encoding_type), "___XDLU_");
8793 if (bounds_str == NULL)
8796 n = 8; /* Skip "___XDLU_". */
8797 if (!ada_scan_number (bounds_str, n, &lo, &n))
8799 if (TYPE_LOW_BOUND (range_type) != lo)
8802 n += 2; /* Skip the "__" separator between the two bounds. */
8803 if (!ada_scan_number (bounds_str, n, &hi, &n))
8805 if (TYPE_HIGH_BOUND (range_type) != hi)
8811 /* Given the array type ARRAY_TYPE, return nonzero if DESC_TYPE,
8812 a type following the GNAT encoding for describing array type
8813 indices, only carries redundant information. */
8816 ada_is_redundant_index_type_desc (struct type *array_type,
8817 struct type *desc_type)
8819 struct type *this_layer = check_typedef (array_type);
8822 for (i = 0; i < TYPE_NFIELDS (desc_type); i++)
8824 if (!ada_is_redundant_range_encoding (TYPE_INDEX_TYPE (this_layer),
8825 TYPE_FIELD_TYPE (desc_type, i)))
8827 this_layer = check_typedef (TYPE_TARGET_TYPE (this_layer));
8833 /* Assuming that TYPE0 is an array type describing the type of a value
8834 at ADDR, and that DVAL describes a record containing any
8835 discriminants used in TYPE0, returns a type for the value that
8836 contains no dynamic components (that is, no components whose sizes
8837 are determined by run-time quantities). Unless IGNORE_TOO_BIG is
8838 true, gives an error message if the resulting type's size is over
8841 static struct type *
8842 to_fixed_array_type (struct type *type0, struct value *dval,
8845 struct type *index_type_desc;
8846 struct type *result;
8847 int constrained_packed_array_p;
8848 static const char *xa_suffix = "___XA";
8850 type0 = ada_check_typedef (type0);
8851 if (TYPE_FIXED_INSTANCE (type0))
8854 constrained_packed_array_p = ada_is_constrained_packed_array_type (type0);
8855 if (constrained_packed_array_p)
8856 type0 = decode_constrained_packed_array_type (type0);
8858 index_type_desc = ada_find_parallel_type (type0, xa_suffix);
8860 /* As mentioned in exp_dbug.ads, for non bit-packed arrays an
8861 encoding suffixed with 'P' may still be generated. If so,
8862 it should be used to find the XA type. */
8864 if (index_type_desc == NULL)
8866 const char *type_name = ada_type_name (type0);
8868 if (type_name != NULL)
8870 const int len = strlen (type_name);
8871 char *name = (char *) alloca (len + strlen (xa_suffix));
8873 if (type_name[len - 1] == 'P')
8875 strcpy (name, type_name);
8876 strcpy (name + len - 1, xa_suffix);
8877 index_type_desc = ada_find_parallel_type_with_name (type0, name);
8882 ada_fixup_array_indexes_type (index_type_desc);
8883 if (index_type_desc != NULL
8884 && ada_is_redundant_index_type_desc (type0, index_type_desc))
8886 /* Ignore this ___XA parallel type, as it does not bring any
8887 useful information. This allows us to avoid creating fixed
8888 versions of the array's index types, which would be identical
8889 to the original ones. This, in turn, can also help avoid
8890 the creation of fixed versions of the array itself. */
8891 index_type_desc = NULL;
8894 if (index_type_desc == NULL)
8896 struct type *elt_type0 = ada_check_typedef (TYPE_TARGET_TYPE (type0));
8898 /* NOTE: elt_type---the fixed version of elt_type0---should never
8899 depend on the contents of the array in properly constructed
8901 /* Create a fixed version of the array element type.
8902 We're not providing the address of an element here,
8903 and thus the actual object value cannot be inspected to do
8904 the conversion. This should not be a problem, since arrays of
8905 unconstrained objects are not allowed. In particular, all
8906 the elements of an array of a tagged type should all be of
8907 the same type specified in the debugging info. No need to
8908 consult the object tag. */
8909 struct type *elt_type = ada_to_fixed_type (elt_type0, 0, 0, dval, 1);
8911 /* Make sure we always create a new array type when dealing with
8912 packed array types, since we're going to fix-up the array
8913 type length and element bitsize a little further down. */
8914 if (elt_type0 == elt_type && !constrained_packed_array_p)
8917 result = create_array_type (alloc_type_copy (type0),
8918 elt_type, TYPE_INDEX_TYPE (type0));
8923 struct type *elt_type0;
8926 for (i = TYPE_NFIELDS (index_type_desc); i > 0; i -= 1)
8927 elt_type0 = TYPE_TARGET_TYPE (elt_type0);
8929 /* NOTE: result---the fixed version of elt_type0---should never
8930 depend on the contents of the array in properly constructed
8932 /* Create a fixed version of the array element type.
8933 We're not providing the address of an element here,
8934 and thus the actual object value cannot be inspected to do
8935 the conversion. This should not be a problem, since arrays of
8936 unconstrained objects are not allowed. In particular, all
8937 the elements of an array of a tagged type should all be of
8938 the same type specified in the debugging info. No need to
8939 consult the object tag. */
8941 ada_to_fixed_type (ada_check_typedef (elt_type0), 0, 0, dval, 1);
8944 for (i = TYPE_NFIELDS (index_type_desc) - 1; i >= 0; i -= 1)
8946 struct type *range_type =
8947 to_fixed_range_type (TYPE_FIELD_TYPE (index_type_desc, i), dval);
8949 result = create_array_type (alloc_type_copy (elt_type0),
8950 result, range_type);
8951 elt_type0 = TYPE_TARGET_TYPE (elt_type0);
8953 if (!ignore_too_big && TYPE_LENGTH (result) > varsize_limit)
8954 error (_("array type with dynamic size is larger than varsize-limit"));
8957 /* We want to preserve the type name. This can be useful when
8958 trying to get the type name of a value that has already been
8959 printed (for instance, if the user did "print VAR; whatis $". */
8960 TYPE_NAME (result) = TYPE_NAME (type0);
8962 if (constrained_packed_array_p)
8964 /* So far, the resulting type has been created as if the original
8965 type was a regular (non-packed) array type. As a result, the
8966 bitsize of the array elements needs to be set again, and the array
8967 length needs to be recomputed based on that bitsize. */
8968 int len = TYPE_LENGTH (result) / TYPE_LENGTH (TYPE_TARGET_TYPE (result));
8969 int elt_bitsize = TYPE_FIELD_BITSIZE (type0, 0);
8971 TYPE_FIELD_BITSIZE (result, 0) = TYPE_FIELD_BITSIZE (type0, 0);
8972 TYPE_LENGTH (result) = len * elt_bitsize / HOST_CHAR_BIT;
8973 if (TYPE_LENGTH (result) * HOST_CHAR_BIT < len * elt_bitsize)
8974 TYPE_LENGTH (result)++;
8977 TYPE_FIXED_INSTANCE (result) = 1;
8982 /* A standard type (containing no dynamically sized components)
8983 corresponding to TYPE for the value (TYPE, VALADDR, ADDRESS)
8984 DVAL describes a record containing any discriminants used in TYPE0,
8985 and may be NULL if there are none, or if the object of type TYPE at
8986 ADDRESS or in VALADDR contains these discriminants.
8988 If CHECK_TAG is not null, in the case of tagged types, this function
8989 attempts to locate the object's tag and use it to compute the actual
8990 type. However, when ADDRESS is null, we cannot use it to determine the
8991 location of the tag, and therefore compute the tagged type's actual type.
8992 So we return the tagged type without consulting the tag. */
8994 static struct type *
8995 ada_to_fixed_type_1 (struct type *type, const gdb_byte *valaddr,
8996 CORE_ADDR address, struct value *dval, int check_tag)
8998 type = ada_check_typedef (type);
8999 switch (TYPE_CODE (type))
9003 case TYPE_CODE_STRUCT:
9005 struct type *static_type = to_static_fixed_type (type);
9006 struct type *fixed_record_type =
9007 to_fixed_record_type (type, valaddr, address, NULL);
9009 /* If STATIC_TYPE is a tagged type and we know the object's address,
9010 then we can determine its tag, and compute the object's actual
9011 type from there. Note that we have to use the fixed record
9012 type (the parent part of the record may have dynamic fields
9013 and the way the location of _tag is expressed may depend on
9016 if (check_tag && address != 0 && ada_is_tagged_type (static_type, 0))
9019 value_tag_from_contents_and_address
9023 struct type *real_type = type_from_tag (tag);
9025 value_from_contents_and_address (fixed_record_type,
9028 fixed_record_type = value_type (obj);
9029 if (real_type != NULL)
9030 return to_fixed_record_type
9032 value_address (ada_tag_value_at_base_address (obj)), NULL);
9035 /* Check to see if there is a parallel ___XVZ variable.
9036 If there is, then it provides the actual size of our type. */
9037 else if (ada_type_name (fixed_record_type) != NULL)
9039 const char *name = ada_type_name (fixed_record_type);
9041 = (char *) alloca (strlen (name) + 7 /* "___XVZ\0" */);
9042 bool xvz_found = false;
9045 xsnprintf (xvz_name, strlen (name) + 7, "%s___XVZ", name);
9048 xvz_found = get_int_var_value (xvz_name, size);
9050 CATCH (except, RETURN_MASK_ERROR)
9052 /* We found the variable, but somehow failed to read
9053 its value. Rethrow the same error, but with a little
9054 bit more information, to help the user understand
9055 what went wrong (Eg: the variable might have been
9057 throw_error (except.error,
9058 _("unable to read value of %s (%s)"),
9059 xvz_name, except.message);
9063 if (xvz_found && TYPE_LENGTH (fixed_record_type) != size)
9065 fixed_record_type = copy_type (fixed_record_type);
9066 TYPE_LENGTH (fixed_record_type) = size;
9068 /* The FIXED_RECORD_TYPE may have be a stub. We have
9069 observed this when the debugging info is STABS, and
9070 apparently it is something that is hard to fix.
9072 In practice, we don't need the actual type definition
9073 at all, because the presence of the XVZ variable allows us
9074 to assume that there must be a XVS type as well, which we
9075 should be able to use later, when we need the actual type
9078 In the meantime, pretend that the "fixed" type we are
9079 returning is NOT a stub, because this can cause trouble
9080 when using this type to create new types targeting it.
9081 Indeed, the associated creation routines often check
9082 whether the target type is a stub and will try to replace
9083 it, thus using a type with the wrong size. This, in turn,
9084 might cause the new type to have the wrong size too.
9085 Consider the case of an array, for instance, where the size
9086 of the array is computed from the number of elements in
9087 our array multiplied by the size of its element. */
9088 TYPE_STUB (fixed_record_type) = 0;
9091 return fixed_record_type;
9093 case TYPE_CODE_ARRAY:
9094 return to_fixed_array_type (type, dval, 1);
9095 case TYPE_CODE_UNION:
9099 return to_fixed_variant_branch_type (type, valaddr, address, dval);
9103 /* The same as ada_to_fixed_type_1, except that it preserves the type
9104 if it is a TYPE_CODE_TYPEDEF of a type that is already fixed.
9106 The typedef layer needs be preserved in order to differentiate between
9107 arrays and array pointers when both types are implemented using the same
9108 fat pointer. In the array pointer case, the pointer is encoded as
9109 a typedef of the pointer type. For instance, considering:
9111 type String_Access is access String;
9112 S1 : String_Access := null;
9114 To the debugger, S1 is defined as a typedef of type String. But
9115 to the user, it is a pointer. So if the user tries to print S1,
9116 we should not dereference the array, but print the array address
9119 If we didn't preserve the typedef layer, we would lose the fact that
9120 the type is to be presented as a pointer (needs de-reference before
9121 being printed). And we would also use the source-level type name. */
9124 ada_to_fixed_type (struct type *type, const gdb_byte *valaddr,
9125 CORE_ADDR address, struct value *dval, int check_tag)
9128 struct type *fixed_type =
9129 ada_to_fixed_type_1 (type, valaddr, address, dval, check_tag);
9131 /* If TYPE is a typedef and its target type is the same as the FIXED_TYPE,
9132 then preserve the typedef layer.
9134 Implementation note: We can only check the main-type portion of
9135 the TYPE and FIXED_TYPE, because eliminating the typedef layer
9136 from TYPE now returns a type that has the same instance flags
9137 as TYPE. For instance, if TYPE is a "typedef const", and its
9138 target type is a "struct", then the typedef elimination will return
9139 a "const" version of the target type. See check_typedef for more
9140 details about how the typedef layer elimination is done.
9142 brobecker/2010-11-19: It seems to me that the only case where it is
9143 useful to preserve the typedef layer is when dealing with fat pointers.
9144 Perhaps, we could add a check for that and preserve the typedef layer
9145 only in that situation. But this seems unecessary so far, probably
9146 because we call check_typedef/ada_check_typedef pretty much everywhere.
9148 if (TYPE_CODE (type) == TYPE_CODE_TYPEDEF
9149 && (TYPE_MAIN_TYPE (ada_typedef_target_type (type))
9150 == TYPE_MAIN_TYPE (fixed_type)))
9156 /* A standard (static-sized) type corresponding as well as possible to
9157 TYPE0, but based on no runtime data. */
9159 static struct type *
9160 to_static_fixed_type (struct type *type0)
9167 if (TYPE_FIXED_INSTANCE (type0))
9170 type0 = ada_check_typedef (type0);
9172 switch (TYPE_CODE (type0))
9176 case TYPE_CODE_STRUCT:
9177 type = dynamic_template_type (type0);
9179 return template_to_static_fixed_type (type);
9181 return template_to_static_fixed_type (type0);
9182 case TYPE_CODE_UNION:
9183 type = ada_find_parallel_type (type0, "___XVU");
9185 return template_to_static_fixed_type (type);
9187 return template_to_static_fixed_type (type0);
9191 /* A static approximation of TYPE with all type wrappers removed. */
9193 static struct type *
9194 static_unwrap_type (struct type *type)
9196 if (ada_is_aligner_type (type))
9198 struct type *type1 = TYPE_FIELD_TYPE (ada_check_typedef (type), 0);
9199 if (ada_type_name (type1) == NULL)
9200 TYPE_NAME (type1) = ada_type_name (type);
9202 return static_unwrap_type (type1);
9206 struct type *raw_real_type = ada_get_base_type (type);
9208 if (raw_real_type == type)
9211 return to_static_fixed_type (raw_real_type);
9215 /* In some cases, incomplete and private types require
9216 cross-references that are not resolved as records (for example,
9218 type FooP is access Foo;
9220 type Foo is array ...;
9221 ). In these cases, since there is no mechanism for producing
9222 cross-references to such types, we instead substitute for FooP a
9223 stub enumeration type that is nowhere resolved, and whose tag is
9224 the name of the actual type. Call these types "non-record stubs". */
9226 /* A type equivalent to TYPE that is not a non-record stub, if one
9227 exists, otherwise TYPE. */
9230 ada_check_typedef (struct type *type)
9235 /* If our type is an access to an unconstrained array, which is encoded
9236 as a TYPE_CODE_TYPEDEF of a fat pointer, then we're done.
9237 We don't want to strip the TYPE_CODE_TYPDEF layer, because this is
9238 what allows us to distinguish between fat pointers that represent
9239 array types, and fat pointers that represent array access types
9240 (in both cases, the compiler implements them as fat pointers). */
9241 if (ada_is_access_to_unconstrained_array (type))
9244 type = check_typedef (type);
9245 if (type == NULL || TYPE_CODE (type) != TYPE_CODE_ENUM
9246 || !TYPE_STUB (type)
9247 || TYPE_NAME (type) == NULL)
9251 const char *name = TYPE_NAME (type);
9252 struct type *type1 = ada_find_any_type (name);
9257 /* TYPE1 might itself be a TYPE_CODE_TYPEDEF (this can happen with
9258 stubs pointing to arrays, as we don't create symbols for array
9259 types, only for the typedef-to-array types). If that's the case,
9260 strip the typedef layer. */
9261 if (TYPE_CODE (type1) == TYPE_CODE_TYPEDEF)
9262 type1 = ada_check_typedef (type1);
9268 /* A value representing the data at VALADDR/ADDRESS as described by
9269 type TYPE0, but with a standard (static-sized) type that correctly
9270 describes it. If VAL0 is not NULL and TYPE0 already is a standard
9271 type, then return VAL0 [this feature is simply to avoid redundant
9272 creation of struct values]. */
9274 static struct value *
9275 ada_to_fixed_value_create (struct type *type0, CORE_ADDR address,
9278 struct type *type = ada_to_fixed_type (type0, 0, address, NULL, 1);
9280 if (type == type0 && val0 != NULL)
9283 if (VALUE_LVAL (val0) != lval_memory)
9285 /* Our value does not live in memory; it could be a convenience
9286 variable, for instance. Create a not_lval value using val0's
9288 return value_from_contents (type, value_contents (val0));
9291 return value_from_contents_and_address (type, 0, address);
9294 /* A value representing VAL, but with a standard (static-sized) type
9295 that correctly describes it. Does not necessarily create a new
9299 ada_to_fixed_value (struct value *val)
9301 val = unwrap_value (val);
9302 val = ada_to_fixed_value_create (value_type (val), value_address (val), val);
9309 /* Table mapping attribute numbers to names.
9310 NOTE: Keep up to date with enum ada_attribute definition in ada-lang.h. */
9312 static const char *attribute_names[] = {
9330 ada_attribute_name (enum exp_opcode n)
9332 if (n >= OP_ATR_FIRST && n <= (int) OP_ATR_VAL)
9333 return attribute_names[n - OP_ATR_FIRST + 1];
9335 return attribute_names[0];
9338 /* Evaluate the 'POS attribute applied to ARG. */
9341 pos_atr (struct value *arg)
9343 struct value *val = coerce_ref (arg);
9344 struct type *type = value_type (val);
9347 if (!discrete_type_p (type))
9348 error (_("'POS only defined on discrete types"));
9350 if (!discrete_position (type, value_as_long (val), &result))
9351 error (_("enumeration value is invalid: can't find 'POS"));
9356 static struct value *
9357 value_pos_atr (struct type *type, struct value *arg)
9359 return value_from_longest (type, pos_atr (arg));
9362 /* Evaluate the TYPE'VAL attribute applied to ARG. */
9364 static struct value *
9365 value_val_atr (struct type *type, struct value *arg)
9367 if (!discrete_type_p (type))
9368 error (_("'VAL only defined on discrete types"));
9369 if (!integer_type_p (value_type (arg)))
9370 error (_("'VAL requires integral argument"));
9372 if (TYPE_CODE (type) == TYPE_CODE_ENUM)
9374 long pos = value_as_long (arg);
9376 if (pos < 0 || pos >= TYPE_NFIELDS (type))
9377 error (_("argument to 'VAL out of range"));
9378 return value_from_longest (type, TYPE_FIELD_ENUMVAL (type, pos));
9381 return value_from_longest (type, value_as_long (arg));
9387 /* True if TYPE appears to be an Ada character type.
9388 [At the moment, this is true only for Character and Wide_Character;
9389 It is a heuristic test that could stand improvement]. */
9392 ada_is_character_type (struct type *type)
9396 /* If the type code says it's a character, then assume it really is,
9397 and don't check any further. */
9398 if (TYPE_CODE (type) == TYPE_CODE_CHAR)
9401 /* Otherwise, assume it's a character type iff it is a discrete type
9402 with a known character type name. */
9403 name = ada_type_name (type);
9404 return (name != NULL
9405 && (TYPE_CODE (type) == TYPE_CODE_INT
9406 || TYPE_CODE (type) == TYPE_CODE_RANGE)
9407 && (strcmp (name, "character") == 0
9408 || strcmp (name, "wide_character") == 0
9409 || strcmp (name, "wide_wide_character") == 0
9410 || strcmp (name, "unsigned char") == 0));
9413 /* True if TYPE appears to be an Ada string type. */
9416 ada_is_string_type (struct type *type)
9418 type = ada_check_typedef (type);
9420 && TYPE_CODE (type) != TYPE_CODE_PTR
9421 && (ada_is_simple_array_type (type)
9422 || ada_is_array_descriptor_type (type))
9423 && ada_array_arity (type) == 1)
9425 struct type *elttype = ada_array_element_type (type, 1);
9427 return ada_is_character_type (elttype);
9433 /* The compiler sometimes provides a parallel XVS type for a given
9434 PAD type. Normally, it is safe to follow the PAD type directly,
9435 but older versions of the compiler have a bug that causes the offset
9436 of its "F" field to be wrong. Following that field in that case
9437 would lead to incorrect results, but this can be worked around
9438 by ignoring the PAD type and using the associated XVS type instead.
9440 Set to True if the debugger should trust the contents of PAD types.
9441 Otherwise, ignore the PAD type if there is a parallel XVS type. */
9442 static int trust_pad_over_xvs = 1;
9444 /* True if TYPE is a struct type introduced by the compiler to force the
9445 alignment of a value. Such types have a single field with a
9446 distinctive name. */
9449 ada_is_aligner_type (struct type *type)
9451 type = ada_check_typedef (type);
9453 if (!trust_pad_over_xvs && ada_find_parallel_type (type, "___XVS") != NULL)
9456 return (TYPE_CODE (type) == TYPE_CODE_STRUCT
9457 && TYPE_NFIELDS (type) == 1
9458 && strcmp (TYPE_FIELD_NAME (type, 0), "F") == 0);
9461 /* If there is an ___XVS-convention type parallel to SUBTYPE, return
9462 the parallel type. */
9465 ada_get_base_type (struct type *raw_type)
9467 struct type *real_type_namer;
9468 struct type *raw_real_type;
9470 if (raw_type == NULL || TYPE_CODE (raw_type) != TYPE_CODE_STRUCT)
9473 if (ada_is_aligner_type (raw_type))
9474 /* The encoding specifies that we should always use the aligner type.
9475 So, even if this aligner type has an associated XVS type, we should
9478 According to the compiler gurus, an XVS type parallel to an aligner
9479 type may exist because of a stabs limitation. In stabs, aligner
9480 types are empty because the field has a variable-sized type, and
9481 thus cannot actually be used as an aligner type. As a result,
9482 we need the associated parallel XVS type to decode the type.
9483 Since the policy in the compiler is to not change the internal
9484 representation based on the debugging info format, we sometimes
9485 end up having a redundant XVS type parallel to the aligner type. */
9488 real_type_namer = ada_find_parallel_type (raw_type, "___XVS");
9489 if (real_type_namer == NULL
9490 || TYPE_CODE (real_type_namer) != TYPE_CODE_STRUCT
9491 || TYPE_NFIELDS (real_type_namer) != 1)
9494 if (TYPE_CODE (TYPE_FIELD_TYPE (real_type_namer, 0)) != TYPE_CODE_REF)
9496 /* This is an older encoding form where the base type needs to be
9497 looked up by name. We prefer the newer enconding because it is
9499 raw_real_type = ada_find_any_type (TYPE_FIELD_NAME (real_type_namer, 0));
9500 if (raw_real_type == NULL)
9503 return raw_real_type;
9506 /* The field in our XVS type is a reference to the base type. */
9507 return TYPE_TARGET_TYPE (TYPE_FIELD_TYPE (real_type_namer, 0));
9510 /* The type of value designated by TYPE, with all aligners removed. */
9513 ada_aligned_type (struct type *type)
9515 if (ada_is_aligner_type (type))
9516 return ada_aligned_type (TYPE_FIELD_TYPE (type, 0));
9518 return ada_get_base_type (type);
9522 /* The address of the aligned value in an object at address VALADDR
9523 having type TYPE. Assumes ada_is_aligner_type (TYPE). */
9526 ada_aligned_value_addr (struct type *type, const gdb_byte *valaddr)
9528 if (ada_is_aligner_type (type))
9529 return ada_aligned_value_addr (TYPE_FIELD_TYPE (type, 0),
9531 TYPE_FIELD_BITPOS (type,
9532 0) / TARGET_CHAR_BIT);
9539 /* The printed representation of an enumeration literal with encoded
9540 name NAME. The value is good to the next call of ada_enum_name. */
9542 ada_enum_name (const char *name)
9544 static char *result;
9545 static size_t result_len = 0;
9548 /* First, unqualify the enumeration name:
9549 1. Search for the last '.' character. If we find one, then skip
9550 all the preceding characters, the unqualified name starts
9551 right after that dot.
9552 2. Otherwise, we may be debugging on a target where the compiler
9553 translates dots into "__". Search forward for double underscores,
9554 but stop searching when we hit an overloading suffix, which is
9555 of the form "__" followed by digits. */
9557 tmp = strrchr (name, '.');
9562 while ((tmp = strstr (name, "__")) != NULL)
9564 if (isdigit (tmp[2]))
9575 if (name[1] == 'U' || name[1] == 'W')
9577 if (sscanf (name + 2, "%x", &v) != 1)
9583 GROW_VECT (result, result_len, 16);
9584 if (isascii (v) && isprint (v))
9585 xsnprintf (result, result_len, "'%c'", v);
9586 else if (name[1] == 'U')
9587 xsnprintf (result, result_len, "[\"%02x\"]", v);
9589 xsnprintf (result, result_len, "[\"%04x\"]", v);
9595 tmp = strstr (name, "__");
9597 tmp = strstr (name, "$");
9600 GROW_VECT (result, result_len, tmp - name + 1);
9601 strncpy (result, name, tmp - name);
9602 result[tmp - name] = '\0';
9610 /* Evaluate the subexpression of EXP starting at *POS as for
9611 evaluate_type, updating *POS to point just past the evaluated
9614 static struct value *
9615 evaluate_subexp_type (struct expression *exp, int *pos)
9617 return evaluate_subexp (NULL_TYPE, exp, pos, EVAL_AVOID_SIDE_EFFECTS);
9620 /* If VAL is wrapped in an aligner or subtype wrapper, return the
9623 static struct value *
9624 unwrap_value (struct value *val)
9626 struct type *type = ada_check_typedef (value_type (val));
9628 if (ada_is_aligner_type (type))
9630 struct value *v = ada_value_struct_elt (val, "F", 0);
9631 struct type *val_type = ada_check_typedef (value_type (v));
9633 if (ada_type_name (val_type) == NULL)
9634 TYPE_NAME (val_type) = ada_type_name (type);
9636 return unwrap_value (v);
9640 struct type *raw_real_type =
9641 ada_check_typedef (ada_get_base_type (type));
9643 /* If there is no parallel XVS or XVE type, then the value is
9644 already unwrapped. Return it without further modification. */
9645 if ((type == raw_real_type)
9646 && ada_find_parallel_type (type, "___XVE") == NULL)
9650 coerce_unspec_val_to_type
9651 (val, ada_to_fixed_type (raw_real_type, 0,
9652 value_address (val),
9657 static struct value *
9658 cast_from_fixed (struct type *type, struct value *arg)
9660 struct value *scale = ada_scaling_factor (value_type (arg));
9661 arg = value_cast (value_type (scale), arg);
9663 arg = value_binop (arg, scale, BINOP_MUL);
9664 return value_cast (type, arg);
9667 static struct value *
9668 cast_to_fixed (struct type *type, struct value *arg)
9670 if (type == value_type (arg))
9673 struct value *scale = ada_scaling_factor (type);
9674 if (ada_is_fixed_point_type (value_type (arg)))
9675 arg = cast_from_fixed (value_type (scale), arg);
9677 arg = value_cast (value_type (scale), arg);
9679 arg = value_binop (arg, scale, BINOP_DIV);
9680 return value_cast (type, arg);
9683 /* Given two array types T1 and T2, return nonzero iff both arrays
9684 contain the same number of elements. */
9687 ada_same_array_size_p (struct type *t1, struct type *t2)
9689 LONGEST lo1, hi1, lo2, hi2;
9691 /* Get the array bounds in order to verify that the size of
9692 the two arrays match. */
9693 if (!get_array_bounds (t1, &lo1, &hi1)
9694 || !get_array_bounds (t2, &lo2, &hi2))
9695 error (_("unable to determine array bounds"));
9697 /* To make things easier for size comparison, normalize a bit
9698 the case of empty arrays by making sure that the difference
9699 between upper bound and lower bound is always -1. */
9705 return (hi1 - lo1 == hi2 - lo2);
9708 /* Assuming that VAL is an array of integrals, and TYPE represents
9709 an array with the same number of elements, but with wider integral
9710 elements, return an array "casted" to TYPE. In practice, this
9711 means that the returned array is built by casting each element
9712 of the original array into TYPE's (wider) element type. */
9714 static struct value *
9715 ada_promote_array_of_integrals (struct type *type, struct value *val)
9717 struct type *elt_type = TYPE_TARGET_TYPE (type);
9722 /* Verify that both val and type are arrays of scalars, and
9723 that the size of val's elements is smaller than the size
9724 of type's element. */
9725 gdb_assert (TYPE_CODE (type) == TYPE_CODE_ARRAY);
9726 gdb_assert (is_integral_type (TYPE_TARGET_TYPE (type)));
9727 gdb_assert (TYPE_CODE (value_type (val)) == TYPE_CODE_ARRAY);
9728 gdb_assert (is_integral_type (TYPE_TARGET_TYPE (value_type (val))));
9729 gdb_assert (TYPE_LENGTH (TYPE_TARGET_TYPE (type))
9730 > TYPE_LENGTH (TYPE_TARGET_TYPE (value_type (val))));
9732 if (!get_array_bounds (type, &lo, &hi))
9733 error (_("unable to determine array bounds"));
9735 res = allocate_value (type);
9737 /* Promote each array element. */
9738 for (i = 0; i < hi - lo + 1; i++)
9740 struct value *elt = value_cast (elt_type, value_subscript (val, lo + i));
9742 memcpy (value_contents_writeable (res) + (i * TYPE_LENGTH (elt_type)),
9743 value_contents_all (elt), TYPE_LENGTH (elt_type));
9749 /* Coerce VAL as necessary for assignment to an lval of type TYPE, and
9750 return the converted value. */
9752 static struct value *
9753 coerce_for_assign (struct type *type, struct value *val)
9755 struct type *type2 = value_type (val);
9760 type2 = ada_check_typedef (type2);
9761 type = ada_check_typedef (type);
9763 if (TYPE_CODE (type2) == TYPE_CODE_PTR
9764 && TYPE_CODE (type) == TYPE_CODE_ARRAY)
9766 val = ada_value_ind (val);
9767 type2 = value_type (val);
9770 if (TYPE_CODE (type2) == TYPE_CODE_ARRAY
9771 && TYPE_CODE (type) == TYPE_CODE_ARRAY)
9773 if (!ada_same_array_size_p (type, type2))
9774 error (_("cannot assign arrays of different length"));
9776 if (is_integral_type (TYPE_TARGET_TYPE (type))
9777 && is_integral_type (TYPE_TARGET_TYPE (type2))
9778 && TYPE_LENGTH (TYPE_TARGET_TYPE (type2))
9779 < TYPE_LENGTH (TYPE_TARGET_TYPE (type)))
9781 /* Allow implicit promotion of the array elements to
9783 return ada_promote_array_of_integrals (type, val);
9786 if (TYPE_LENGTH (TYPE_TARGET_TYPE (type2))
9787 != TYPE_LENGTH (TYPE_TARGET_TYPE (type)))
9788 error (_("Incompatible types in assignment"));
9789 deprecated_set_value_type (val, type);
9794 static struct value *
9795 ada_value_binop (struct value *arg1, struct value *arg2, enum exp_opcode op)
9798 struct type *type1, *type2;
9801 arg1 = coerce_ref (arg1);
9802 arg2 = coerce_ref (arg2);
9803 type1 = get_base_type (ada_check_typedef (value_type (arg1)));
9804 type2 = get_base_type (ada_check_typedef (value_type (arg2)));
9806 if (TYPE_CODE (type1) != TYPE_CODE_INT
9807 || TYPE_CODE (type2) != TYPE_CODE_INT)
9808 return value_binop (arg1, arg2, op);
9817 return value_binop (arg1, arg2, op);
9820 v2 = value_as_long (arg2);
9822 error (_("second operand of %s must not be zero."), op_string (op));
9824 if (TYPE_UNSIGNED (type1) || op == BINOP_MOD)
9825 return value_binop (arg1, arg2, op);
9827 v1 = value_as_long (arg1);
9832 if (!TRUNCATION_TOWARDS_ZERO && v1 * (v1 % v2) < 0)
9833 v += v > 0 ? -1 : 1;
9841 /* Should not reach this point. */
9845 val = allocate_value (type1);
9846 store_unsigned_integer (value_contents_raw (val),
9847 TYPE_LENGTH (value_type (val)),
9848 gdbarch_byte_order (get_type_arch (type1)), v);
9853 ada_value_equal (struct value *arg1, struct value *arg2)
9855 if (ada_is_direct_array_type (value_type (arg1))
9856 || ada_is_direct_array_type (value_type (arg2)))
9858 struct type *arg1_type, *arg2_type;
9860 /* Automatically dereference any array reference before
9861 we attempt to perform the comparison. */
9862 arg1 = ada_coerce_ref (arg1);
9863 arg2 = ada_coerce_ref (arg2);
9865 arg1 = ada_coerce_to_simple_array (arg1);
9866 arg2 = ada_coerce_to_simple_array (arg2);
9868 arg1_type = ada_check_typedef (value_type (arg1));
9869 arg2_type = ada_check_typedef (value_type (arg2));
9871 if (TYPE_CODE (arg1_type) != TYPE_CODE_ARRAY
9872 || TYPE_CODE (arg2_type) != TYPE_CODE_ARRAY)
9873 error (_("Attempt to compare array with non-array"));
9874 /* FIXME: The following works only for types whose
9875 representations use all bits (no padding or undefined bits)
9876 and do not have user-defined equality. */
9877 return (TYPE_LENGTH (arg1_type) == TYPE_LENGTH (arg2_type)
9878 && memcmp (value_contents (arg1), value_contents (arg2),
9879 TYPE_LENGTH (arg1_type)) == 0);
9881 return value_equal (arg1, arg2);
9884 /* Total number of component associations in the aggregate starting at
9885 index PC in EXP. Assumes that index PC is the start of an
9889 num_component_specs (struct expression *exp, int pc)
9893 m = exp->elts[pc + 1].longconst;
9896 for (i = 0; i < m; i += 1)
9898 switch (exp->elts[pc].opcode)
9904 n += exp->elts[pc + 1].longconst;
9907 ada_evaluate_subexp (NULL, exp, &pc, EVAL_SKIP);
9912 /* Assign the result of evaluating EXP starting at *POS to the INDEXth
9913 component of LHS (a simple array or a record), updating *POS past
9914 the expression, assuming that LHS is contained in CONTAINER. Does
9915 not modify the inferior's memory, nor does it modify LHS (unless
9916 LHS == CONTAINER). */
9919 assign_component (struct value *container, struct value *lhs, LONGEST index,
9920 struct expression *exp, int *pos)
9922 struct value *mark = value_mark ();
9924 struct type *lhs_type = check_typedef (value_type (lhs));
9926 if (TYPE_CODE (lhs_type) == TYPE_CODE_ARRAY)
9928 struct type *index_type = builtin_type (exp->gdbarch)->builtin_int;
9929 struct value *index_val = value_from_longest (index_type, index);
9931 elt = unwrap_value (ada_value_subscript (lhs, 1, &index_val));
9935 elt = ada_index_struct_field (index, lhs, 0, value_type (lhs));
9936 elt = ada_to_fixed_value (elt);
9939 if (exp->elts[*pos].opcode == OP_AGGREGATE)
9940 assign_aggregate (container, elt, exp, pos, EVAL_NORMAL);
9942 value_assign_to_component (container, elt,
9943 ada_evaluate_subexp (NULL, exp, pos,
9946 value_free_to_mark (mark);
9949 /* Assuming that LHS represents an lvalue having a record or array
9950 type, and EXP->ELTS[*POS] is an OP_AGGREGATE, evaluate an assignment
9951 of that aggregate's value to LHS, advancing *POS past the
9952 aggregate. NOSIDE is as for evaluate_subexp. CONTAINER is an
9953 lvalue containing LHS (possibly LHS itself). Does not modify
9954 the inferior's memory, nor does it modify the contents of
9955 LHS (unless == CONTAINER). Returns the modified CONTAINER. */
9957 static struct value *
9958 assign_aggregate (struct value *container,
9959 struct value *lhs, struct expression *exp,
9960 int *pos, enum noside noside)
9962 struct type *lhs_type;
9963 int n = exp->elts[*pos+1].longconst;
9964 LONGEST low_index, high_index;
9967 int max_indices, num_indices;
9971 if (noside != EVAL_NORMAL)
9973 for (i = 0; i < n; i += 1)
9974 ada_evaluate_subexp (NULL, exp, pos, noside);
9978 container = ada_coerce_ref (container);
9979 if (ada_is_direct_array_type (value_type (container)))
9980 container = ada_coerce_to_simple_array (container);
9981 lhs = ada_coerce_ref (lhs);
9982 if (!deprecated_value_modifiable (lhs))
9983 error (_("Left operand of assignment is not a modifiable lvalue."));
9985 lhs_type = check_typedef (value_type (lhs));
9986 if (ada_is_direct_array_type (lhs_type))
9988 lhs = ada_coerce_to_simple_array (lhs);
9989 lhs_type = check_typedef (value_type (lhs));
9990 low_index = TYPE_ARRAY_LOWER_BOUND_VALUE (lhs_type);
9991 high_index = TYPE_ARRAY_UPPER_BOUND_VALUE (lhs_type);
9993 else if (TYPE_CODE (lhs_type) == TYPE_CODE_STRUCT)
9996 high_index = num_visible_fields (lhs_type) - 1;
9999 error (_("Left-hand side must be array or record."));
10001 num_specs = num_component_specs (exp, *pos - 3);
10002 max_indices = 4 * num_specs + 4;
10003 indices = XALLOCAVEC (LONGEST, max_indices);
10004 indices[0] = indices[1] = low_index - 1;
10005 indices[2] = indices[3] = high_index + 1;
10008 for (i = 0; i < n; i += 1)
10010 switch (exp->elts[*pos].opcode)
10013 aggregate_assign_from_choices (container, lhs, exp, pos, indices,
10014 &num_indices, max_indices,
10015 low_index, high_index);
10017 case OP_POSITIONAL:
10018 aggregate_assign_positional (container, lhs, exp, pos, indices,
10019 &num_indices, max_indices,
10020 low_index, high_index);
10024 error (_("Misplaced 'others' clause"));
10025 aggregate_assign_others (container, lhs, exp, pos, indices,
10026 num_indices, low_index, high_index);
10029 error (_("Internal error: bad aggregate clause"));
10036 /* Assign into the component of LHS indexed by the OP_POSITIONAL
10037 construct at *POS, updating *POS past the construct, given that
10038 the positions are relative to lower bound LOW, where HIGH is the
10039 upper bound. Record the position in INDICES[0 .. MAX_INDICES-1]
10040 updating *NUM_INDICES as needed. CONTAINER is as for
10041 assign_aggregate. */
10043 aggregate_assign_positional (struct value *container,
10044 struct value *lhs, struct expression *exp,
10045 int *pos, LONGEST *indices, int *num_indices,
10046 int max_indices, LONGEST low, LONGEST high)
10048 LONGEST ind = longest_to_int (exp->elts[*pos + 1].longconst) + low;
10050 if (ind - 1 == high)
10051 warning (_("Extra components in aggregate ignored."));
10054 add_component_interval (ind, ind, indices, num_indices, max_indices);
10056 assign_component (container, lhs, ind, exp, pos);
10059 ada_evaluate_subexp (NULL, exp, pos, EVAL_SKIP);
10062 /* Assign into the components of LHS indexed by the OP_CHOICES
10063 construct at *POS, updating *POS past the construct, given that
10064 the allowable indices are LOW..HIGH. Record the indices assigned
10065 to in INDICES[0 .. MAX_INDICES-1], updating *NUM_INDICES as
10066 needed. CONTAINER is as for assign_aggregate. */
10068 aggregate_assign_from_choices (struct value *container,
10069 struct value *lhs, struct expression *exp,
10070 int *pos, LONGEST *indices, int *num_indices,
10071 int max_indices, LONGEST low, LONGEST high)
10074 int n_choices = longest_to_int (exp->elts[*pos+1].longconst);
10075 int choice_pos, expr_pc;
10076 int is_array = ada_is_direct_array_type (value_type (lhs));
10078 choice_pos = *pos += 3;
10080 for (j = 0; j < n_choices; j += 1)
10081 ada_evaluate_subexp (NULL, exp, pos, EVAL_SKIP);
10083 ada_evaluate_subexp (NULL, exp, pos, EVAL_SKIP);
10085 for (j = 0; j < n_choices; j += 1)
10087 LONGEST lower, upper;
10088 enum exp_opcode op = exp->elts[choice_pos].opcode;
10090 if (op == OP_DISCRETE_RANGE)
10093 lower = value_as_long (ada_evaluate_subexp (NULL, exp, pos,
10095 upper = value_as_long (ada_evaluate_subexp (NULL, exp, pos,
10100 lower = value_as_long (ada_evaluate_subexp (NULL, exp, &choice_pos,
10112 name = &exp->elts[choice_pos + 2].string;
10115 name = SYMBOL_NATURAL_NAME (exp->elts[choice_pos + 2].symbol);
10118 error (_("Invalid record component association."));
10120 ada_evaluate_subexp (NULL, exp, &choice_pos, EVAL_SKIP);
10122 if (! find_struct_field (name, value_type (lhs), 0,
10123 NULL, NULL, NULL, NULL, &ind))
10124 error (_("Unknown component name: %s."), name);
10125 lower = upper = ind;
10128 if (lower <= upper && (lower < low || upper > high))
10129 error (_("Index in component association out of bounds."));
10131 add_component_interval (lower, upper, indices, num_indices,
10133 while (lower <= upper)
10138 assign_component (container, lhs, lower, exp, &pos1);
10144 /* Assign the value of the expression in the OP_OTHERS construct in
10145 EXP at *POS into the components of LHS indexed from LOW .. HIGH that
10146 have not been previously assigned. The index intervals already assigned
10147 are in INDICES[0 .. NUM_INDICES-1]. Updates *POS to after the
10148 OP_OTHERS clause. CONTAINER is as for assign_aggregate. */
10150 aggregate_assign_others (struct value *container,
10151 struct value *lhs, struct expression *exp,
10152 int *pos, LONGEST *indices, int num_indices,
10153 LONGEST low, LONGEST high)
10156 int expr_pc = *pos + 1;
10158 for (i = 0; i < num_indices - 2; i += 2)
10162 for (ind = indices[i + 1] + 1; ind < indices[i + 2]; ind += 1)
10166 localpos = expr_pc;
10167 assign_component (container, lhs, ind, exp, &localpos);
10170 ada_evaluate_subexp (NULL, exp, pos, EVAL_SKIP);
10173 /* Add the interval [LOW .. HIGH] to the sorted set of intervals
10174 [ INDICES[0] .. INDICES[1] ],..., [ INDICES[*SIZE-2] .. INDICES[*SIZE-1] ],
10175 modifying *SIZE as needed. It is an error if *SIZE exceeds
10176 MAX_SIZE. The resulting intervals do not overlap. */
10178 add_component_interval (LONGEST low, LONGEST high,
10179 LONGEST* indices, int *size, int max_size)
10183 for (i = 0; i < *size; i += 2) {
10184 if (high >= indices[i] && low <= indices[i + 1])
10188 for (kh = i + 2; kh < *size; kh += 2)
10189 if (high < indices[kh])
10191 if (low < indices[i])
10193 indices[i + 1] = indices[kh - 1];
10194 if (high > indices[i + 1])
10195 indices[i + 1] = high;
10196 memcpy (indices + i + 2, indices + kh, *size - kh);
10197 *size -= kh - i - 2;
10200 else if (high < indices[i])
10204 if (*size == max_size)
10205 error (_("Internal error: miscounted aggregate components."));
10207 for (j = *size-1; j >= i+2; j -= 1)
10208 indices[j] = indices[j - 2];
10210 indices[i + 1] = high;
10213 /* Perform and Ada cast of ARG2 to type TYPE if the type of ARG2
10216 static struct value *
10217 ada_value_cast (struct type *type, struct value *arg2)
10219 if (type == ada_check_typedef (value_type (arg2)))
10222 if (ada_is_fixed_point_type (type))
10223 return cast_to_fixed (type, arg2);
10225 if (ada_is_fixed_point_type (value_type (arg2)))
10226 return cast_from_fixed (type, arg2);
10228 return value_cast (type, arg2);
10231 /* Evaluating Ada expressions, and printing their result.
10232 ------------------------------------------------------
10237 We usually evaluate an Ada expression in order to print its value.
10238 We also evaluate an expression in order to print its type, which
10239 happens during the EVAL_AVOID_SIDE_EFFECTS phase of the evaluation,
10240 but we'll focus mostly on the EVAL_NORMAL phase. In practice, the
10241 EVAL_AVOID_SIDE_EFFECTS phase allows us to simplify certain aspects of
10242 the evaluation compared to the EVAL_NORMAL, but is otherwise very
10245 Evaluating expressions is a little more complicated for Ada entities
10246 than it is for entities in languages such as C. The main reason for
10247 this is that Ada provides types whose definition might be dynamic.
10248 One example of such types is variant records. Or another example
10249 would be an array whose bounds can only be known at run time.
10251 The following description is a general guide as to what should be
10252 done (and what should NOT be done) in order to evaluate an expression
10253 involving such types, and when. This does not cover how the semantic
10254 information is encoded by GNAT as this is covered separatly. For the
10255 document used as the reference for the GNAT encoding, see exp_dbug.ads
10256 in the GNAT sources.
10258 Ideally, we should embed each part of this description next to its
10259 associated code. Unfortunately, the amount of code is so vast right
10260 now that it's hard to see whether the code handling a particular
10261 situation might be duplicated or not. One day, when the code is
10262 cleaned up, this guide might become redundant with the comments
10263 inserted in the code, and we might want to remove it.
10265 2. ``Fixing'' an Entity, the Simple Case:
10266 -----------------------------------------
10268 When evaluating Ada expressions, the tricky issue is that they may
10269 reference entities whose type contents and size are not statically
10270 known. Consider for instance a variant record:
10272 type Rec (Empty : Boolean := True) is record
10275 when False => Value : Integer;
10278 Yes : Rec := (Empty => False, Value => 1);
10279 No : Rec := (empty => True);
10281 The size and contents of that record depends on the value of the
10282 descriminant (Rec.Empty). At this point, neither the debugging
10283 information nor the associated type structure in GDB are able to
10284 express such dynamic types. So what the debugger does is to create
10285 "fixed" versions of the type that applies to the specific object.
10286 We also informally refer to this opperation as "fixing" an object,
10287 which means creating its associated fixed type.
10289 Example: when printing the value of variable "Yes" above, its fixed
10290 type would look like this:
10297 On the other hand, if we printed the value of "No", its fixed type
10304 Things become a little more complicated when trying to fix an entity
10305 with a dynamic type that directly contains another dynamic type,
10306 such as an array of variant records, for instance. There are
10307 two possible cases: Arrays, and records.
10309 3. ``Fixing'' Arrays:
10310 ---------------------
10312 The type structure in GDB describes an array in terms of its bounds,
10313 and the type of its elements. By design, all elements in the array
10314 have the same type and we cannot represent an array of variant elements
10315 using the current type structure in GDB. When fixing an array,
10316 we cannot fix the array element, as we would potentially need one
10317 fixed type per element of the array. As a result, the best we can do
10318 when fixing an array is to produce an array whose bounds and size
10319 are correct (allowing us to read it from memory), but without having
10320 touched its element type. Fixing each element will be done later,
10321 when (if) necessary.
10323 Arrays are a little simpler to handle than records, because the same
10324 amount of memory is allocated for each element of the array, even if
10325 the amount of space actually used by each element differs from element
10326 to element. Consider for instance the following array of type Rec:
10328 type Rec_Array is array (1 .. 2) of Rec;
10330 The actual amount of memory occupied by each element might be different
10331 from element to element, depending on the value of their discriminant.
10332 But the amount of space reserved for each element in the array remains
10333 fixed regardless. So we simply need to compute that size using
10334 the debugging information available, from which we can then determine
10335 the array size (we multiply the number of elements of the array by
10336 the size of each element).
10338 The simplest case is when we have an array of a constrained element
10339 type. For instance, consider the following type declarations:
10341 type Bounded_String (Max_Size : Integer) is
10343 Buffer : String (1 .. Max_Size);
10345 type Bounded_String_Array is array (1 ..2) of Bounded_String (80);
10347 In this case, the compiler describes the array as an array of
10348 variable-size elements (identified by its XVS suffix) for which
10349 the size can be read in the parallel XVZ variable.
10351 In the case of an array of an unconstrained element type, the compiler
10352 wraps the array element inside a private PAD type. This type should not
10353 be shown to the user, and must be "unwrap"'ed before printing. Note
10354 that we also use the adjective "aligner" in our code to designate
10355 these wrapper types.
10357 In some cases, the size allocated for each element is statically
10358 known. In that case, the PAD type already has the correct size,
10359 and the array element should remain unfixed.
10361 But there are cases when this size is not statically known.
10362 For instance, assuming that "Five" is an integer variable:
10364 type Dynamic is array (1 .. Five) of Integer;
10365 type Wrapper (Has_Length : Boolean := False) is record
10368 when True => Length : Integer;
10369 when False => null;
10372 type Wrapper_Array is array (1 .. 2) of Wrapper;
10374 Hello : Wrapper_Array := (others => (Has_Length => True,
10375 Data => (others => 17),
10379 The debugging info would describe variable Hello as being an
10380 array of a PAD type. The size of that PAD type is not statically
10381 known, but can be determined using a parallel XVZ variable.
10382 In that case, a copy of the PAD type with the correct size should
10383 be used for the fixed array.
10385 3. ``Fixing'' record type objects:
10386 ----------------------------------
10388 Things are slightly different from arrays in the case of dynamic
10389 record types. In this case, in order to compute the associated
10390 fixed type, we need to determine the size and offset of each of
10391 its components. This, in turn, requires us to compute the fixed
10392 type of each of these components.
10394 Consider for instance the example:
10396 type Bounded_String (Max_Size : Natural) is record
10397 Str : String (1 .. Max_Size);
10400 My_String : Bounded_String (Max_Size => 10);
10402 In that case, the position of field "Length" depends on the size
10403 of field Str, which itself depends on the value of the Max_Size
10404 discriminant. In order to fix the type of variable My_String,
10405 we need to fix the type of field Str. Therefore, fixing a variant
10406 record requires us to fix each of its components.
10408 However, if a component does not have a dynamic size, the component
10409 should not be fixed. In particular, fields that use a PAD type
10410 should not fixed. Here is an example where this might happen
10411 (assuming type Rec above):
10413 type Container (Big : Boolean) is record
10417 when True => Another : Integer;
10418 when False => null;
10421 My_Container : Container := (Big => False,
10422 First => (Empty => True),
10425 In that example, the compiler creates a PAD type for component First,
10426 whose size is constant, and then positions the component After just
10427 right after it. The offset of component After is therefore constant
10430 The debugger computes the position of each field based on an algorithm
10431 that uses, among other things, the actual position and size of the field
10432 preceding it. Let's now imagine that the user is trying to print
10433 the value of My_Container. If the type fixing was recursive, we would
10434 end up computing the offset of field After based on the size of the
10435 fixed version of field First. And since in our example First has
10436 only one actual field, the size of the fixed type is actually smaller
10437 than the amount of space allocated to that field, and thus we would
10438 compute the wrong offset of field After.
10440 To make things more complicated, we need to watch out for dynamic
10441 components of variant records (identified by the ___XVL suffix in
10442 the component name). Even if the target type is a PAD type, the size
10443 of that type might not be statically known. So the PAD type needs
10444 to be unwrapped and the resulting type needs to be fixed. Otherwise,
10445 we might end up with the wrong size for our component. This can be
10446 observed with the following type declarations:
10448 type Octal is new Integer range 0 .. 7;
10449 type Octal_Array is array (Positive range <>) of Octal;
10450 pragma Pack (Octal_Array);
10452 type Octal_Buffer (Size : Positive) is record
10453 Buffer : Octal_Array (1 .. Size);
10457 In that case, Buffer is a PAD type whose size is unset and needs
10458 to be computed by fixing the unwrapped type.
10460 4. When to ``Fix'' un-``Fixed'' sub-elements of an entity:
10461 ----------------------------------------------------------
10463 Lastly, when should the sub-elements of an entity that remained unfixed
10464 thus far, be actually fixed?
10466 The answer is: Only when referencing that element. For instance
10467 when selecting one component of a record, this specific component
10468 should be fixed at that point in time. Or when printing the value
10469 of a record, each component should be fixed before its value gets
10470 printed. Similarly for arrays, the element of the array should be
10471 fixed when printing each element of the array, or when extracting
10472 one element out of that array. On the other hand, fixing should
10473 not be performed on the elements when taking a slice of an array!
10475 Note that one of the side effects of miscomputing the offset and
10476 size of each field is that we end up also miscomputing the size
10477 of the containing type. This can have adverse results when computing
10478 the value of an entity. GDB fetches the value of an entity based
10479 on the size of its type, and thus a wrong size causes GDB to fetch
10480 the wrong amount of memory. In the case where the computed size is
10481 too small, GDB fetches too little data to print the value of our
10482 entity. Results in this case are unpredictable, as we usually read
10483 past the buffer containing the data =:-o. */
10485 /* Evaluate a subexpression of EXP, at index *POS, and return a value
10486 for that subexpression cast to TO_TYPE. Advance *POS over the
10490 ada_evaluate_subexp_for_cast (expression *exp, int *pos,
10491 enum noside noside, struct type *to_type)
10495 if (exp->elts[pc].opcode == OP_VAR_MSYM_VALUE
10496 || exp->elts[pc].opcode == OP_VAR_VALUE)
10501 if (exp->elts[pc].opcode == OP_VAR_MSYM_VALUE)
10503 if (noside == EVAL_AVOID_SIDE_EFFECTS)
10504 return value_zero (to_type, not_lval);
10506 val = evaluate_var_msym_value (noside,
10507 exp->elts[pc + 1].objfile,
10508 exp->elts[pc + 2].msymbol);
10511 val = evaluate_var_value (noside,
10512 exp->elts[pc + 1].block,
10513 exp->elts[pc + 2].symbol);
10515 if (noside == EVAL_SKIP)
10516 return eval_skip_value (exp);
10518 val = ada_value_cast (to_type, val);
10520 /* Follow the Ada language semantics that do not allow taking
10521 an address of the result of a cast (view conversion in Ada). */
10522 if (VALUE_LVAL (val) == lval_memory)
10524 if (value_lazy (val))
10525 value_fetch_lazy (val);
10526 VALUE_LVAL (val) = not_lval;
10531 value *val = evaluate_subexp (to_type, exp, pos, noside);
10532 if (noside == EVAL_SKIP)
10533 return eval_skip_value (exp);
10534 return ada_value_cast (to_type, val);
10537 /* Implement the evaluate_exp routine in the exp_descriptor structure
10538 for the Ada language. */
10540 static struct value *
10541 ada_evaluate_subexp (struct type *expect_type, struct expression *exp,
10542 int *pos, enum noside noside)
10544 enum exp_opcode op;
10548 struct value *arg1 = NULL, *arg2 = NULL, *arg3;
10551 struct value **argvec;
10555 op = exp->elts[pc].opcode;
10561 arg1 = evaluate_subexp_standard (expect_type, exp, pos, noside);
10563 if (noside == EVAL_NORMAL)
10564 arg1 = unwrap_value (arg1);
10566 /* If evaluating an OP_FLOAT and an EXPECT_TYPE was provided,
10567 then we need to perform the conversion manually, because
10568 evaluate_subexp_standard doesn't do it. This conversion is
10569 necessary in Ada because the different kinds of float/fixed
10570 types in Ada have different representations.
10572 Similarly, we need to perform the conversion from OP_LONG
10574 if ((op == OP_FLOAT || op == OP_LONG) && expect_type != NULL)
10575 arg1 = ada_value_cast (expect_type, arg1);
10581 struct value *result;
10584 result = evaluate_subexp_standard (expect_type, exp, pos, noside);
10585 /* The result type will have code OP_STRING, bashed there from
10586 OP_ARRAY. Bash it back. */
10587 if (TYPE_CODE (value_type (result)) == TYPE_CODE_STRING)
10588 TYPE_CODE (value_type (result)) = TYPE_CODE_ARRAY;
10594 type = exp->elts[pc + 1].type;
10595 return ada_evaluate_subexp_for_cast (exp, pos, noside, type);
10599 type = exp->elts[pc + 1].type;
10600 return ada_evaluate_subexp (type, exp, pos, noside);
10603 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
10604 if (exp->elts[*pos].opcode == OP_AGGREGATE)
10606 arg1 = assign_aggregate (arg1, arg1, exp, pos, noside);
10607 if (noside == EVAL_SKIP || noside == EVAL_AVOID_SIDE_EFFECTS)
10609 return ada_value_assign (arg1, arg1);
10611 /* Force the evaluation of the rhs ARG2 to the type of the lhs ARG1,
10612 except if the lhs of our assignment is a convenience variable.
10613 In the case of assigning to a convenience variable, the lhs
10614 should be exactly the result of the evaluation of the rhs. */
10615 type = value_type (arg1);
10616 if (VALUE_LVAL (arg1) == lval_internalvar)
10618 arg2 = evaluate_subexp (type, exp, pos, noside);
10619 if (noside == EVAL_SKIP || noside == EVAL_AVOID_SIDE_EFFECTS)
10621 if (ada_is_fixed_point_type (value_type (arg1)))
10622 arg2 = cast_to_fixed (value_type (arg1), arg2);
10623 else if (ada_is_fixed_point_type (value_type (arg2)))
10625 (_("Fixed-point values must be assigned to fixed-point variables"));
10627 arg2 = coerce_for_assign (value_type (arg1), arg2);
10628 return ada_value_assign (arg1, arg2);
10631 arg1 = evaluate_subexp_with_coercion (exp, pos, noside);
10632 arg2 = evaluate_subexp_with_coercion (exp, pos, noside);
10633 if (noside == EVAL_SKIP)
10635 if (TYPE_CODE (value_type (arg1)) == TYPE_CODE_PTR)
10636 return (value_from_longest
10637 (value_type (arg1),
10638 value_as_long (arg1) + value_as_long (arg2)));
10639 if (TYPE_CODE (value_type (arg2)) == TYPE_CODE_PTR)
10640 return (value_from_longest
10641 (value_type (arg2),
10642 value_as_long (arg1) + value_as_long (arg2)));
10643 if ((ada_is_fixed_point_type (value_type (arg1))
10644 || ada_is_fixed_point_type (value_type (arg2)))
10645 && value_type (arg1) != value_type (arg2))
10646 error (_("Operands of fixed-point addition must have the same type"));
10647 /* Do the addition, and cast the result to the type of the first
10648 argument. We cannot cast the result to a reference type, so if
10649 ARG1 is a reference type, find its underlying type. */
10650 type = value_type (arg1);
10651 while (TYPE_CODE (type) == TYPE_CODE_REF)
10652 type = TYPE_TARGET_TYPE (type);
10653 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
10654 return value_cast (type, value_binop (arg1, arg2, BINOP_ADD));
10657 arg1 = evaluate_subexp_with_coercion (exp, pos, noside);
10658 arg2 = evaluate_subexp_with_coercion (exp, pos, noside);
10659 if (noside == EVAL_SKIP)
10661 if (TYPE_CODE (value_type (arg1)) == TYPE_CODE_PTR)
10662 return (value_from_longest
10663 (value_type (arg1),
10664 value_as_long (arg1) - value_as_long (arg2)));
10665 if (TYPE_CODE (value_type (arg2)) == TYPE_CODE_PTR)
10666 return (value_from_longest
10667 (value_type (arg2),
10668 value_as_long (arg1) - value_as_long (arg2)));
10669 if ((ada_is_fixed_point_type (value_type (arg1))
10670 || ada_is_fixed_point_type (value_type (arg2)))
10671 && value_type (arg1) != value_type (arg2))
10672 error (_("Operands of fixed-point subtraction "
10673 "must have the same type"));
10674 /* Do the substraction, and cast the result to the type of the first
10675 argument. We cannot cast the result to a reference type, so if
10676 ARG1 is a reference type, find its underlying type. */
10677 type = value_type (arg1);
10678 while (TYPE_CODE (type) == TYPE_CODE_REF)
10679 type = TYPE_TARGET_TYPE (type);
10680 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
10681 return value_cast (type, value_binop (arg1, arg2, BINOP_SUB));
10687 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
10688 arg2 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
10689 if (noside == EVAL_SKIP)
10691 else if (noside == EVAL_AVOID_SIDE_EFFECTS)
10693 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
10694 return value_zero (value_type (arg1), not_lval);
10698 type = builtin_type (exp->gdbarch)->builtin_double;
10699 if (ada_is_fixed_point_type (value_type (arg1)))
10700 arg1 = cast_from_fixed (type, arg1);
10701 if (ada_is_fixed_point_type (value_type (arg2)))
10702 arg2 = cast_from_fixed (type, arg2);
10703 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
10704 return ada_value_binop (arg1, arg2, op);
10708 case BINOP_NOTEQUAL:
10709 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
10710 arg2 = evaluate_subexp (value_type (arg1), exp, pos, noside);
10711 if (noside == EVAL_SKIP)
10713 if (noside == EVAL_AVOID_SIDE_EFFECTS)
10717 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
10718 tem = ada_value_equal (arg1, arg2);
10720 if (op == BINOP_NOTEQUAL)
10722 type = language_bool_type (exp->language_defn, exp->gdbarch);
10723 return value_from_longest (type, (LONGEST) tem);
10726 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
10727 if (noside == EVAL_SKIP)
10729 else if (ada_is_fixed_point_type (value_type (arg1)))
10730 return value_cast (value_type (arg1), value_neg (arg1));
10733 unop_promote (exp->language_defn, exp->gdbarch, &arg1);
10734 return value_neg (arg1);
10737 case BINOP_LOGICAL_AND:
10738 case BINOP_LOGICAL_OR:
10739 case UNOP_LOGICAL_NOT:
10744 val = evaluate_subexp_standard (expect_type, exp, pos, noside);
10745 type = language_bool_type (exp->language_defn, exp->gdbarch);
10746 return value_cast (type, val);
10749 case BINOP_BITWISE_AND:
10750 case BINOP_BITWISE_IOR:
10751 case BINOP_BITWISE_XOR:
10755 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, EVAL_AVOID_SIDE_EFFECTS);
10757 val = evaluate_subexp_standard (expect_type, exp, pos, noside);
10759 return value_cast (value_type (arg1), val);
10765 if (noside == EVAL_SKIP)
10771 if (SYMBOL_DOMAIN (exp->elts[pc + 2].symbol) == UNDEF_DOMAIN)
10772 /* Only encountered when an unresolved symbol occurs in a
10773 context other than a function call, in which case, it is
10775 error (_("Unexpected unresolved symbol, %s, during evaluation"),
10776 SYMBOL_PRINT_NAME (exp->elts[pc + 2].symbol));
10778 if (noside == EVAL_AVOID_SIDE_EFFECTS)
10780 type = static_unwrap_type (SYMBOL_TYPE (exp->elts[pc + 2].symbol));
10781 /* Check to see if this is a tagged type. We also need to handle
10782 the case where the type is a reference to a tagged type, but
10783 we have to be careful to exclude pointers to tagged types.
10784 The latter should be shown as usual (as a pointer), whereas
10785 a reference should mostly be transparent to the user. */
10786 if (ada_is_tagged_type (type, 0)
10787 || (TYPE_CODE (type) == TYPE_CODE_REF
10788 && ada_is_tagged_type (TYPE_TARGET_TYPE (type), 0)))
10790 /* Tagged types are a little special in the fact that the real
10791 type is dynamic and can only be determined by inspecting the
10792 object's tag. This means that we need to get the object's
10793 value first (EVAL_NORMAL) and then extract the actual object
10796 Note that we cannot skip the final step where we extract
10797 the object type from its tag, because the EVAL_NORMAL phase
10798 results in dynamic components being resolved into fixed ones.
10799 This can cause problems when trying to print the type
10800 description of tagged types whose parent has a dynamic size:
10801 We use the type name of the "_parent" component in order
10802 to print the name of the ancestor type in the type description.
10803 If that component had a dynamic size, the resolution into
10804 a fixed type would result in the loss of that type name,
10805 thus preventing us from printing the name of the ancestor
10806 type in the type description. */
10807 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, EVAL_NORMAL);
10809 if (TYPE_CODE (type) != TYPE_CODE_REF)
10811 struct type *actual_type;
10813 actual_type = type_from_tag (ada_value_tag (arg1));
10814 if (actual_type == NULL)
10815 /* If, for some reason, we were unable to determine
10816 the actual type from the tag, then use the static
10817 approximation that we just computed as a fallback.
10818 This can happen if the debugging information is
10819 incomplete, for instance. */
10820 actual_type = type;
10821 return value_zero (actual_type, not_lval);
10825 /* In the case of a ref, ada_coerce_ref takes care
10826 of determining the actual type. But the evaluation
10827 should return a ref as it should be valid to ask
10828 for its address; so rebuild a ref after coerce. */
10829 arg1 = ada_coerce_ref (arg1);
10830 return value_ref (arg1, TYPE_CODE_REF);
10834 /* Records and unions for which GNAT encodings have been
10835 generated need to be statically fixed as well.
10836 Otherwise, non-static fixing produces a type where
10837 all dynamic properties are removed, which prevents "ptype"
10838 from being able to completely describe the type.
10839 For instance, a case statement in a variant record would be
10840 replaced by the relevant components based on the actual
10841 value of the discriminants. */
10842 if ((TYPE_CODE (type) == TYPE_CODE_STRUCT
10843 && dynamic_template_type (type) != NULL)
10844 || (TYPE_CODE (type) == TYPE_CODE_UNION
10845 && ada_find_parallel_type (type, "___XVU") != NULL))
10848 return value_zero (to_static_fixed_type (type), not_lval);
10852 arg1 = evaluate_subexp_standard (expect_type, exp, pos, noside);
10853 return ada_to_fixed_value (arg1);
10858 /* Allocate arg vector, including space for the function to be
10859 called in argvec[0] and a terminating NULL. */
10860 nargs = longest_to_int (exp->elts[pc + 1].longconst);
10861 argvec = XALLOCAVEC (struct value *, nargs + 2);
10863 if (exp->elts[*pos].opcode == OP_VAR_VALUE
10864 && SYMBOL_DOMAIN (exp->elts[pc + 5].symbol) == UNDEF_DOMAIN)
10865 error (_("Unexpected unresolved symbol, %s, during evaluation"),
10866 SYMBOL_PRINT_NAME (exp->elts[pc + 5].symbol));
10869 for (tem = 0; tem <= nargs; tem += 1)
10870 argvec[tem] = evaluate_subexp (NULL_TYPE, exp, pos, noside);
10873 if (noside == EVAL_SKIP)
10877 if (ada_is_constrained_packed_array_type
10878 (desc_base_type (value_type (argvec[0]))))
10879 argvec[0] = ada_coerce_to_simple_array (argvec[0]);
10880 else if (TYPE_CODE (value_type (argvec[0])) == TYPE_CODE_ARRAY
10881 && TYPE_FIELD_BITSIZE (value_type (argvec[0]), 0) != 0)
10882 /* This is a packed array that has already been fixed, and
10883 therefore already coerced to a simple array. Nothing further
10886 else if (TYPE_CODE (value_type (argvec[0])) == TYPE_CODE_REF)
10888 /* Make sure we dereference references so that all the code below
10889 feels like it's really handling the referenced value. Wrapping
10890 types (for alignment) may be there, so make sure we strip them as
10892 argvec[0] = ada_to_fixed_value (coerce_ref (argvec[0]));
10894 else if (TYPE_CODE (value_type (argvec[0])) == TYPE_CODE_ARRAY
10895 && VALUE_LVAL (argvec[0]) == lval_memory)
10896 argvec[0] = value_addr (argvec[0]);
10898 type = ada_check_typedef (value_type (argvec[0]));
10900 /* Ada allows us to implicitly dereference arrays when subscripting
10901 them. So, if this is an array typedef (encoding use for array
10902 access types encoded as fat pointers), strip it now. */
10903 if (TYPE_CODE (type) == TYPE_CODE_TYPEDEF)
10904 type = ada_typedef_target_type (type);
10906 if (TYPE_CODE (type) == TYPE_CODE_PTR)
10908 switch (TYPE_CODE (ada_check_typedef (TYPE_TARGET_TYPE (type))))
10910 case TYPE_CODE_FUNC:
10911 type = ada_check_typedef (TYPE_TARGET_TYPE (type));
10913 case TYPE_CODE_ARRAY:
10915 case TYPE_CODE_STRUCT:
10916 if (noside != EVAL_AVOID_SIDE_EFFECTS)
10917 argvec[0] = ada_value_ind (argvec[0]);
10918 type = ada_check_typedef (TYPE_TARGET_TYPE (type));
10921 error (_("cannot subscript or call something of type `%s'"),
10922 ada_type_name (value_type (argvec[0])));
10927 switch (TYPE_CODE (type))
10929 case TYPE_CODE_FUNC:
10930 if (noside == EVAL_AVOID_SIDE_EFFECTS)
10932 if (TYPE_TARGET_TYPE (type) == NULL)
10933 error_call_unknown_return_type (NULL);
10934 return allocate_value (TYPE_TARGET_TYPE (type));
10936 return call_function_by_hand (argvec[0], NULL,
10937 gdb::make_array_view (argvec + 1,
10939 case TYPE_CODE_INTERNAL_FUNCTION:
10940 if (noside == EVAL_AVOID_SIDE_EFFECTS)
10941 /* We don't know anything about what the internal
10942 function might return, but we have to return
10944 return value_zero (builtin_type (exp->gdbarch)->builtin_int,
10947 return call_internal_function (exp->gdbarch, exp->language_defn,
10948 argvec[0], nargs, argvec + 1);
10950 case TYPE_CODE_STRUCT:
10954 arity = ada_array_arity (type);
10955 type = ada_array_element_type (type, nargs);
10957 error (_("cannot subscript or call a record"));
10958 if (arity != nargs)
10959 error (_("wrong number of subscripts; expecting %d"), arity);
10960 if (noside == EVAL_AVOID_SIDE_EFFECTS)
10961 return value_zero (ada_aligned_type (type), lval_memory);
10963 unwrap_value (ada_value_subscript
10964 (argvec[0], nargs, argvec + 1));
10966 case TYPE_CODE_ARRAY:
10967 if (noside == EVAL_AVOID_SIDE_EFFECTS)
10969 type = ada_array_element_type (type, nargs);
10971 error (_("element type of array unknown"));
10973 return value_zero (ada_aligned_type (type), lval_memory);
10976 unwrap_value (ada_value_subscript
10977 (ada_coerce_to_simple_array (argvec[0]),
10978 nargs, argvec + 1));
10979 case TYPE_CODE_PTR: /* Pointer to array */
10980 if (noside == EVAL_AVOID_SIDE_EFFECTS)
10982 type = to_fixed_array_type (TYPE_TARGET_TYPE (type), NULL, 1);
10983 type = ada_array_element_type (type, nargs);
10985 error (_("element type of array unknown"));
10987 return value_zero (ada_aligned_type (type), lval_memory);
10990 unwrap_value (ada_value_ptr_subscript (argvec[0],
10991 nargs, argvec + 1));
10994 error (_("Attempt to index or call something other than an "
10995 "array or function"));
11000 struct value *array = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11001 struct value *low_bound_val =
11002 evaluate_subexp (NULL_TYPE, exp, pos, noside);
11003 struct value *high_bound_val =
11004 evaluate_subexp (NULL_TYPE, exp, pos, noside);
11006 LONGEST high_bound;
11008 low_bound_val = coerce_ref (low_bound_val);
11009 high_bound_val = coerce_ref (high_bound_val);
11010 low_bound = value_as_long (low_bound_val);
11011 high_bound = value_as_long (high_bound_val);
11013 if (noside == EVAL_SKIP)
11016 /* If this is a reference to an aligner type, then remove all
11018 if (TYPE_CODE (value_type (array)) == TYPE_CODE_REF
11019 && ada_is_aligner_type (TYPE_TARGET_TYPE (value_type (array))))
11020 TYPE_TARGET_TYPE (value_type (array)) =
11021 ada_aligned_type (TYPE_TARGET_TYPE (value_type (array)));
11023 if (ada_is_constrained_packed_array_type (value_type (array)))
11024 error (_("cannot slice a packed array"));
11026 /* If this is a reference to an array or an array lvalue,
11027 convert to a pointer. */
11028 if (TYPE_CODE (value_type (array)) == TYPE_CODE_REF
11029 || (TYPE_CODE (value_type (array)) == TYPE_CODE_ARRAY
11030 && VALUE_LVAL (array) == lval_memory))
11031 array = value_addr (array);
11033 if (noside == EVAL_AVOID_SIDE_EFFECTS
11034 && ada_is_array_descriptor_type (ada_check_typedef
11035 (value_type (array))))
11036 return empty_array (ada_type_of_array (array, 0), low_bound);
11038 array = ada_coerce_to_simple_array_ptr (array);
11040 /* If we have more than one level of pointer indirection,
11041 dereference the value until we get only one level. */
11042 while (TYPE_CODE (value_type (array)) == TYPE_CODE_PTR
11043 && (TYPE_CODE (TYPE_TARGET_TYPE (value_type (array)))
11045 array = value_ind (array);
11047 /* Make sure we really do have an array type before going further,
11048 to avoid a SEGV when trying to get the index type or the target
11049 type later down the road if the debug info generated by
11050 the compiler is incorrect or incomplete. */
11051 if (!ada_is_simple_array_type (value_type (array)))
11052 error (_("cannot take slice of non-array"));
11054 if (TYPE_CODE (ada_check_typedef (value_type (array)))
11057 struct type *type0 = ada_check_typedef (value_type (array));
11059 if (high_bound < low_bound || noside == EVAL_AVOID_SIDE_EFFECTS)
11060 return empty_array (TYPE_TARGET_TYPE (type0), low_bound);
11063 struct type *arr_type0 =
11064 to_fixed_array_type (TYPE_TARGET_TYPE (type0), NULL, 1);
11066 return ada_value_slice_from_ptr (array, arr_type0,
11067 longest_to_int (low_bound),
11068 longest_to_int (high_bound));
11071 else if (noside == EVAL_AVOID_SIDE_EFFECTS)
11073 else if (high_bound < low_bound)
11074 return empty_array (value_type (array), low_bound);
11076 return ada_value_slice (array, longest_to_int (low_bound),
11077 longest_to_int (high_bound));
11080 case UNOP_IN_RANGE:
11082 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11083 type = check_typedef (exp->elts[pc + 1].type);
11085 if (noside == EVAL_SKIP)
11088 switch (TYPE_CODE (type))
11091 lim_warning (_("Membership test incompletely implemented; "
11092 "always returns true"));
11093 type = language_bool_type (exp->language_defn, exp->gdbarch);
11094 return value_from_longest (type, (LONGEST) 1);
11096 case TYPE_CODE_RANGE:
11097 arg2 = value_from_longest (type, TYPE_LOW_BOUND (type));
11098 arg3 = value_from_longest (type, TYPE_HIGH_BOUND (type));
11099 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
11100 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg3);
11101 type = language_bool_type (exp->language_defn, exp->gdbarch);
11103 value_from_longest (type,
11104 (value_less (arg1, arg3)
11105 || value_equal (arg1, arg3))
11106 && (value_less (arg2, arg1)
11107 || value_equal (arg2, arg1)));
11110 case BINOP_IN_BOUNDS:
11112 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11113 arg2 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11115 if (noside == EVAL_SKIP)
11118 if (noside == EVAL_AVOID_SIDE_EFFECTS)
11120 type = language_bool_type (exp->language_defn, exp->gdbarch);
11121 return value_zero (type, not_lval);
11124 tem = longest_to_int (exp->elts[pc + 1].longconst);
11126 type = ada_index_type (value_type (arg2), tem, "range");
11128 type = value_type (arg1);
11130 arg3 = value_from_longest (type, ada_array_bound (arg2, tem, 1));
11131 arg2 = value_from_longest (type, ada_array_bound (arg2, tem, 0));
11133 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
11134 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg3);
11135 type = language_bool_type (exp->language_defn, exp->gdbarch);
11137 value_from_longest (type,
11138 (value_less (arg1, arg3)
11139 || value_equal (arg1, arg3))
11140 && (value_less (arg2, arg1)
11141 || value_equal (arg2, arg1)));
11143 case TERNOP_IN_RANGE:
11144 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11145 arg2 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11146 arg3 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11148 if (noside == EVAL_SKIP)
11151 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
11152 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg3);
11153 type = language_bool_type (exp->language_defn, exp->gdbarch);
11155 value_from_longest (type,
11156 (value_less (arg1, arg3)
11157 || value_equal (arg1, arg3))
11158 && (value_less (arg2, arg1)
11159 || value_equal (arg2, arg1)));
11163 case OP_ATR_LENGTH:
11165 struct type *type_arg;
11167 if (exp->elts[*pos].opcode == OP_TYPE)
11169 evaluate_subexp (NULL_TYPE, exp, pos, EVAL_SKIP);
11171 type_arg = check_typedef (exp->elts[pc + 2].type);
11175 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11179 if (exp->elts[*pos].opcode != OP_LONG)
11180 error (_("Invalid operand to '%s"), ada_attribute_name (op));
11181 tem = longest_to_int (exp->elts[*pos + 2].longconst);
11184 if (noside == EVAL_SKIP)
11187 if (type_arg == NULL)
11189 arg1 = ada_coerce_ref (arg1);
11191 if (ada_is_constrained_packed_array_type (value_type (arg1)))
11192 arg1 = ada_coerce_to_simple_array (arg1);
11194 if (op == OP_ATR_LENGTH)
11195 type = builtin_type (exp->gdbarch)->builtin_int;
11198 type = ada_index_type (value_type (arg1), tem,
11199 ada_attribute_name (op));
11201 type = builtin_type (exp->gdbarch)->builtin_int;
11204 if (noside == EVAL_AVOID_SIDE_EFFECTS)
11205 return allocate_value (type);
11209 default: /* Should never happen. */
11210 error (_("unexpected attribute encountered"));
11212 return value_from_longest
11213 (type, ada_array_bound (arg1, tem, 0));
11215 return value_from_longest
11216 (type, ada_array_bound (arg1, tem, 1));
11217 case OP_ATR_LENGTH:
11218 return value_from_longest
11219 (type, ada_array_length (arg1, tem));
11222 else if (discrete_type_p (type_arg))
11224 struct type *range_type;
11225 const char *name = ada_type_name (type_arg);
11228 if (name != NULL && TYPE_CODE (type_arg) != TYPE_CODE_ENUM)
11229 range_type = to_fixed_range_type (type_arg, NULL);
11230 if (range_type == NULL)
11231 range_type = type_arg;
11235 error (_("unexpected attribute encountered"));
11237 return value_from_longest
11238 (range_type, ada_discrete_type_low_bound (range_type));
11240 return value_from_longest
11241 (range_type, ada_discrete_type_high_bound (range_type));
11242 case OP_ATR_LENGTH:
11243 error (_("the 'length attribute applies only to array types"));
11246 else if (TYPE_CODE (type_arg) == TYPE_CODE_FLT)
11247 error (_("unimplemented type attribute"));
11252 if (ada_is_constrained_packed_array_type (type_arg))
11253 type_arg = decode_constrained_packed_array_type (type_arg);
11255 if (op == OP_ATR_LENGTH)
11256 type = builtin_type (exp->gdbarch)->builtin_int;
11259 type = ada_index_type (type_arg, tem, ada_attribute_name (op));
11261 type = builtin_type (exp->gdbarch)->builtin_int;
11264 if (noside == EVAL_AVOID_SIDE_EFFECTS)
11265 return allocate_value (type);
11270 error (_("unexpected attribute encountered"));
11272 low = ada_array_bound_from_type (type_arg, tem, 0);
11273 return value_from_longest (type, low);
11275 high = ada_array_bound_from_type (type_arg, tem, 1);
11276 return value_from_longest (type, high);
11277 case OP_ATR_LENGTH:
11278 low = ada_array_bound_from_type (type_arg, tem, 0);
11279 high = ada_array_bound_from_type (type_arg, tem, 1);
11280 return value_from_longest (type, high - low + 1);
11286 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11287 if (noside == EVAL_SKIP)
11290 if (noside == EVAL_AVOID_SIDE_EFFECTS)
11291 return value_zero (ada_tag_type (arg1), not_lval);
11293 return ada_value_tag (arg1);
11297 evaluate_subexp (NULL_TYPE, exp, pos, EVAL_SKIP);
11298 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11299 arg2 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11300 if (noside == EVAL_SKIP)
11302 else if (noside == EVAL_AVOID_SIDE_EFFECTS)
11303 return value_zero (value_type (arg1), not_lval);
11306 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
11307 return value_binop (arg1, arg2,
11308 op == OP_ATR_MIN ? BINOP_MIN : BINOP_MAX);
11311 case OP_ATR_MODULUS:
11313 struct type *type_arg = check_typedef (exp->elts[pc + 2].type);
11315 evaluate_subexp (NULL_TYPE, exp, pos, EVAL_SKIP);
11316 if (noside == EVAL_SKIP)
11319 if (!ada_is_modular_type (type_arg))
11320 error (_("'modulus must be applied to modular type"));
11322 return value_from_longest (TYPE_TARGET_TYPE (type_arg),
11323 ada_modulus (type_arg));
11328 evaluate_subexp (NULL_TYPE, exp, pos, EVAL_SKIP);
11329 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11330 if (noside == EVAL_SKIP)
11332 type = builtin_type (exp->gdbarch)->builtin_int;
11333 if (noside == EVAL_AVOID_SIDE_EFFECTS)
11334 return value_zero (type, not_lval);
11336 return value_pos_atr (type, arg1);
11339 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11340 type = value_type (arg1);
11342 /* If the argument is a reference, then dereference its type, since
11343 the user is really asking for the size of the actual object,
11344 not the size of the pointer. */
11345 if (TYPE_CODE (type) == TYPE_CODE_REF)
11346 type = TYPE_TARGET_TYPE (type);
11348 if (noside == EVAL_SKIP)
11350 else if (noside == EVAL_AVOID_SIDE_EFFECTS)
11351 return value_zero (builtin_type (exp->gdbarch)->builtin_int, not_lval);
11353 return value_from_longest (builtin_type (exp->gdbarch)->builtin_int,
11354 TARGET_CHAR_BIT * TYPE_LENGTH (type));
11357 evaluate_subexp (NULL_TYPE, exp, pos, EVAL_SKIP);
11358 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11359 type = exp->elts[pc + 2].type;
11360 if (noside == EVAL_SKIP)
11362 else if (noside == EVAL_AVOID_SIDE_EFFECTS)
11363 return value_zero (type, not_lval);
11365 return value_val_atr (type, arg1);
11368 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11369 arg2 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11370 if (noside == EVAL_SKIP)
11372 else if (noside == EVAL_AVOID_SIDE_EFFECTS)
11373 return value_zero (value_type (arg1), not_lval);
11376 /* For integer exponentiation operations,
11377 only promote the first argument. */
11378 if (is_integral_type (value_type (arg2)))
11379 unop_promote (exp->language_defn, exp->gdbarch, &arg1);
11381 binop_promote (exp->language_defn, exp->gdbarch, &arg1, &arg2);
11383 return value_binop (arg1, arg2, op);
11387 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11388 if (noside == EVAL_SKIP)
11394 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11395 if (noside == EVAL_SKIP)
11397 unop_promote (exp->language_defn, exp->gdbarch, &arg1);
11398 if (value_less (arg1, value_zero (value_type (arg1), not_lval)))
11399 return value_neg (arg1);
11404 preeval_pos = *pos;
11405 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11406 if (noside == EVAL_SKIP)
11408 type = ada_check_typedef (value_type (arg1));
11409 if (noside == EVAL_AVOID_SIDE_EFFECTS)
11411 if (ada_is_array_descriptor_type (type))
11412 /* GDB allows dereferencing GNAT array descriptors. */
11414 struct type *arrType = ada_type_of_array (arg1, 0);
11416 if (arrType == NULL)
11417 error (_("Attempt to dereference null array pointer."));
11418 return value_at_lazy (arrType, 0);
11420 else if (TYPE_CODE (type) == TYPE_CODE_PTR
11421 || TYPE_CODE (type) == TYPE_CODE_REF
11422 /* In C you can dereference an array to get the 1st elt. */
11423 || TYPE_CODE (type) == TYPE_CODE_ARRAY)
11425 /* As mentioned in the OP_VAR_VALUE case, tagged types can
11426 only be determined by inspecting the object's tag.
11427 This means that we need to evaluate completely the
11428 expression in order to get its type. */
11430 if ((TYPE_CODE (type) == TYPE_CODE_REF
11431 || TYPE_CODE (type) == TYPE_CODE_PTR)
11432 && ada_is_tagged_type (TYPE_TARGET_TYPE (type), 0))
11434 arg1 = evaluate_subexp (NULL_TYPE, exp, &preeval_pos,
11436 type = value_type (ada_value_ind (arg1));
11440 type = to_static_fixed_type
11442 (ada_check_typedef (TYPE_TARGET_TYPE (type))));
11444 ada_ensure_varsize_limit (type);
11445 return value_zero (type, lval_memory);
11447 else if (TYPE_CODE (type) == TYPE_CODE_INT)
11449 /* GDB allows dereferencing an int. */
11450 if (expect_type == NULL)
11451 return value_zero (builtin_type (exp->gdbarch)->builtin_int,
11456 to_static_fixed_type (ada_aligned_type (expect_type));
11457 return value_zero (expect_type, lval_memory);
11461 error (_("Attempt to take contents of a non-pointer value."));
11463 arg1 = ada_coerce_ref (arg1); /* FIXME: What is this for?? */
11464 type = ada_check_typedef (value_type (arg1));
11466 if (TYPE_CODE (type) == TYPE_CODE_INT)
11467 /* GDB allows dereferencing an int. If we were given
11468 the expect_type, then use that as the target type.
11469 Otherwise, assume that the target type is an int. */
11471 if (expect_type != NULL)
11472 return ada_value_ind (value_cast (lookup_pointer_type (expect_type),
11475 return value_at_lazy (builtin_type (exp->gdbarch)->builtin_int,
11476 (CORE_ADDR) value_as_address (arg1));
11479 if (ada_is_array_descriptor_type (type))
11480 /* GDB allows dereferencing GNAT array descriptors. */
11481 return ada_coerce_to_simple_array (arg1);
11483 return ada_value_ind (arg1);
11485 case STRUCTOP_STRUCT:
11486 tem = longest_to_int (exp->elts[pc + 1].longconst);
11487 (*pos) += 3 + BYTES_TO_EXP_ELEM (tem + 1);
11488 preeval_pos = *pos;
11489 arg1 = evaluate_subexp (NULL_TYPE, exp, pos, noside);
11490 if (noside == EVAL_SKIP)
11492 if (noside == EVAL_AVOID_SIDE_EFFECTS)
11494 struct type *type1 = value_type (arg1);
11496 if (ada_is_tagged_type (type1, 1))
11498 type = ada_lookup_struct_elt_type (type1,
11499 &exp->elts[pc + 2].string,
11502 /* If the field is not found, check if it exists in the
11503 extension of this object's type. This means that we
11504 need to evaluate completely the expression. */
11508 arg1 = evaluate_subexp (NULL_TYPE, exp, &preeval_pos,
11510 arg1 = ada_value_struct_elt (arg1,
11511 &exp->elts[pc + 2].string,
11513 arg1 = unwrap_value (arg1);
11514 type = value_type (ada_to_fixed_value (arg1));
11519 ada_lookup_struct_elt_type (type1, &exp->elts[pc + 2].string, 1,
11522 return value_zero (ada_aligned_type (type), lval_memory);
11526 arg1 = ada_value_struct_elt (arg1, &exp->elts[pc + 2].string, 0);
11527 arg1 = unwrap_value (arg1);
11528 return ada_to_fixed_value (arg1);
11532 /* The value is not supposed to be used. This is here to make it
11533 easier to accommodate expressions that contain types. */
11535 if (noside == EVAL_SKIP)
11537 else if (noside == EVAL_AVOID_SIDE_EFFECTS)
11538 return allocate_value (exp->elts[pc + 1].type);
11540 error (_("Attempt to use a type name as an expression"));
11545 case OP_DISCRETE_RANGE:
11546 case OP_POSITIONAL:
11548 if (noside == EVAL_NORMAL)
11552 error (_("Undefined name, ambiguous name, or renaming used in "
11553 "component association: %s."), &exp->elts[pc+2].string);
11555 error (_("Aggregates only allowed on the right of an assignment"));
11557 internal_error (__FILE__, __LINE__,
11558 _("aggregate apparently mangled"));
11561 ada_forward_operator_length (exp, pc, &oplen, &nargs);
11563 for (tem = 0; tem < nargs; tem += 1)
11564 ada_evaluate_subexp (NULL, exp, pos, noside);
11569 return eval_skip_value (exp);
11575 /* If TYPE encodes an Ada fixed-point type, return the suffix of the
11576 type name that encodes the 'small and 'delta information.
11577 Otherwise, return NULL. */
11579 static const char *
11580 fixed_type_info (struct type *type)
11582 const char *name = ada_type_name (type);
11583 enum type_code code = (type == NULL) ? TYPE_CODE_UNDEF : TYPE_CODE (type);
11585 if ((code == TYPE_CODE_INT || code == TYPE_CODE_RANGE) && name != NULL)
11587 const char *tail = strstr (name, "___XF_");
11594 else if (code == TYPE_CODE_RANGE && TYPE_TARGET_TYPE (type) != type)
11595 return fixed_type_info (TYPE_TARGET_TYPE (type));
11600 /* Returns non-zero iff TYPE represents an Ada fixed-point type. */
11603 ada_is_fixed_point_type (struct type *type)
11605 return fixed_type_info (type) != NULL;
11608 /* Return non-zero iff TYPE represents a System.Address type. */
11611 ada_is_system_address_type (struct type *type)
11613 return (TYPE_NAME (type)
11614 && strcmp (TYPE_NAME (type), "system__address") == 0);
11617 /* Assuming that TYPE is the representation of an Ada fixed-point
11618 type, return the target floating-point type to be used to represent
11619 of this type during internal computation. */
11621 static struct type *
11622 ada_scaling_type (struct type *type)
11624 return builtin_type (get_type_arch (type))->builtin_long_double;
11627 /* Assuming that TYPE is the representation of an Ada fixed-point
11628 type, return its delta, or NULL if the type is malformed and the
11629 delta cannot be determined. */
11632 ada_delta (struct type *type)
11634 const char *encoding = fixed_type_info (type);
11635 struct type *scale_type = ada_scaling_type (type);
11637 long long num, den;
11639 if (sscanf (encoding, "_%lld_%lld", &num, &den) < 2)
11642 return value_binop (value_from_longest (scale_type, num),
11643 value_from_longest (scale_type, den), BINOP_DIV);
11646 /* Assuming that ada_is_fixed_point_type (TYPE), return the scaling
11647 factor ('SMALL value) associated with the type. */
11650 ada_scaling_factor (struct type *type)
11652 const char *encoding = fixed_type_info (type);
11653 struct type *scale_type = ada_scaling_type (type);
11655 long long num0, den0, num1, den1;
11658 n = sscanf (encoding, "_%lld_%lld_%lld_%lld",
11659 &num0, &den0, &num1, &den1);
11662 return value_from_longest (scale_type, 1);
11664 return value_binop (value_from_longest (scale_type, num1),
11665 value_from_longest (scale_type, den1), BINOP_DIV);
11667 return value_binop (value_from_longest (scale_type, num0),
11668 value_from_longest (scale_type, den0), BINOP_DIV);
11675 /* Scan STR beginning at position K for a discriminant name, and
11676 return the value of that discriminant field of DVAL in *PX. If
11677 PNEW_K is not null, put the position of the character beyond the
11678 name scanned in *PNEW_K. Return 1 if successful; return 0 and do
11679 not alter *PX and *PNEW_K if unsuccessful. */
11682 scan_discrim_bound (const char *str, int k, struct value *dval, LONGEST * px,
11685 static char *bound_buffer = NULL;
11686 static size_t bound_buffer_len = 0;
11687 const char *pstart, *pend, *bound;
11688 struct value *bound_val;
11690 if (dval == NULL || str == NULL || str[k] == '\0')
11694 pend = strstr (pstart, "__");
11698 k += strlen (bound);
11702 int len = pend - pstart;
11704 /* Strip __ and beyond. */
11705 GROW_VECT (bound_buffer, bound_buffer_len, len + 1);
11706 strncpy (bound_buffer, pstart, len);
11707 bound_buffer[len] = '\0';
11709 bound = bound_buffer;
11713 bound_val = ada_search_struct_field (bound, dval, 0, value_type (dval));
11714 if (bound_val == NULL)
11717 *px = value_as_long (bound_val);
11718 if (pnew_k != NULL)
11723 /* Value of variable named NAME in the current environment. If
11724 no such variable found, then if ERR_MSG is null, returns 0, and
11725 otherwise causes an error with message ERR_MSG. */
11727 static struct value *
11728 get_var_value (const char *name, const char *err_msg)
11730 lookup_name_info lookup_name (name, symbol_name_match_type::FULL);
11732 std::vector<struct block_symbol> syms;
11733 int nsyms = ada_lookup_symbol_list_worker (lookup_name,
11734 get_selected_block (0),
11735 VAR_DOMAIN, &syms, 1);
11739 if (err_msg == NULL)
11742 error (("%s"), err_msg);
11745 return value_of_variable (syms[0].symbol, syms[0].block);
11748 /* Value of integer variable named NAME in the current environment.
11749 If no such variable is found, returns false. Otherwise, sets VALUE
11750 to the variable's value and returns true. */
11753 get_int_var_value (const char *name, LONGEST &value)
11755 struct value *var_val = get_var_value (name, 0);
11760 value = value_as_long (var_val);
11765 /* Return a range type whose base type is that of the range type named
11766 NAME in the current environment, and whose bounds are calculated
11767 from NAME according to the GNAT range encoding conventions.
11768 Extract discriminant values, if needed, from DVAL. ORIG_TYPE is the
11769 corresponding range type from debug information; fall back to using it
11770 if symbol lookup fails. If a new type must be created, allocate it
11771 like ORIG_TYPE was. The bounds information, in general, is encoded
11772 in NAME, the base type given in the named range type. */
11774 static struct type *
11775 to_fixed_range_type (struct type *raw_type, struct value *dval)
11778 struct type *base_type;
11779 const char *subtype_info;
11781 gdb_assert (raw_type != NULL);
11782 gdb_assert (TYPE_NAME (raw_type) != NULL);
11784 if (TYPE_CODE (raw_type) == TYPE_CODE_RANGE)
11785 base_type = TYPE_TARGET_TYPE (raw_type);
11787 base_type = raw_type;
11789 name = TYPE_NAME (raw_type);
11790 subtype_info = strstr (name, "___XD");
11791 if (subtype_info == NULL)
11793 LONGEST L = ada_discrete_type_low_bound (raw_type);
11794 LONGEST U = ada_discrete_type_high_bound (raw_type);
11796 if (L < INT_MIN || U > INT_MAX)
11799 return create_static_range_type (alloc_type_copy (raw_type), raw_type,
11804 static char *name_buf = NULL;
11805 static size_t name_len = 0;
11806 int prefix_len = subtype_info - name;
11809 const char *bounds_str;
11812 GROW_VECT (name_buf, name_len, prefix_len + 5);
11813 strncpy (name_buf, name, prefix_len);
11814 name_buf[prefix_len] = '\0';
11817 bounds_str = strchr (subtype_info, '_');
11820 if (*subtype_info == 'L')
11822 if (!ada_scan_number (bounds_str, n, &L, &n)
11823 && !scan_discrim_bound (bounds_str, n, dval, &L, &n))
11825 if (bounds_str[n] == '_')
11827 else if (bounds_str[n] == '.') /* FIXME? SGI Workshop kludge. */
11833 strcpy (name_buf + prefix_len, "___L");
11834 if (!get_int_var_value (name_buf, L))
11836 lim_warning (_("Unknown lower bound, using 1."));
11841 if (*subtype_info == 'U')
11843 if (!ada_scan_number (bounds_str, n, &U, &n)
11844 && !scan_discrim_bound (bounds_str, n, dval, &U, &n))
11849 strcpy (name_buf + prefix_len, "___U");
11850 if (!get_int_var_value (name_buf, U))
11852 lim_warning (_("Unknown upper bound, using %ld."), (long) L);
11857 type = create_static_range_type (alloc_type_copy (raw_type),
11859 /* create_static_range_type alters the resulting type's length
11860 to match the size of the base_type, which is not what we want.
11861 Set it back to the original range type's length. */
11862 TYPE_LENGTH (type) = TYPE_LENGTH (raw_type);
11863 TYPE_NAME (type) = name;
11868 /* True iff NAME is the name of a range type. */
11871 ada_is_range_type_name (const char *name)
11873 return (name != NULL && strstr (name, "___XD"));
11877 /* Modular types */
11879 /* True iff TYPE is an Ada modular type. */
11882 ada_is_modular_type (struct type *type)
11884 struct type *subranged_type = get_base_type (type);
11886 return (subranged_type != NULL && TYPE_CODE (type) == TYPE_CODE_RANGE
11887 && TYPE_CODE (subranged_type) == TYPE_CODE_INT
11888 && TYPE_UNSIGNED (subranged_type));
11891 /* Assuming ada_is_modular_type (TYPE), the modulus of TYPE. */
11894 ada_modulus (struct type *type)
11896 return (ULONGEST) TYPE_HIGH_BOUND (type) + 1;
11900 /* Ada exception catchpoint support:
11901 ---------------------------------
11903 We support 3 kinds of exception catchpoints:
11904 . catchpoints on Ada exceptions
11905 . catchpoints on unhandled Ada exceptions
11906 . catchpoints on failed assertions
11908 Exceptions raised during failed assertions, or unhandled exceptions
11909 could perfectly be caught with the general catchpoint on Ada exceptions.
11910 However, we can easily differentiate these two special cases, and having
11911 the option to distinguish these two cases from the rest can be useful
11912 to zero-in on certain situations.
11914 Exception catchpoints are a specialized form of breakpoint,
11915 since they rely on inserting breakpoints inside known routines
11916 of the GNAT runtime. The implementation therefore uses a standard
11917 breakpoint structure of the BP_BREAKPOINT type, but with its own set
11920 Support in the runtime for exception catchpoints have been changed
11921 a few times already, and these changes affect the implementation
11922 of these catchpoints. In order to be able to support several
11923 variants of the runtime, we use a sniffer that will determine
11924 the runtime variant used by the program being debugged. */
11926 /* Ada's standard exceptions.
11928 The Ada 83 standard also defined Numeric_Error. But there so many
11929 situations where it was unclear from the Ada 83 Reference Manual
11930 (RM) whether Constraint_Error or Numeric_Error should be raised,
11931 that the ARG (Ada Rapporteur Group) eventually issued a Binding
11932 Interpretation saying that anytime the RM says that Numeric_Error
11933 should be raised, the implementation may raise Constraint_Error.
11934 Ada 95 went one step further and pretty much removed Numeric_Error
11935 from the list of standard exceptions (it made it a renaming of
11936 Constraint_Error, to help preserve compatibility when compiling
11937 an Ada83 compiler). As such, we do not include Numeric_Error from
11938 this list of standard exceptions. */
11940 static const char *standard_exc[] = {
11941 "constraint_error",
11947 typedef CORE_ADDR (ada_unhandled_exception_name_addr_ftype) (void);
11949 /* A structure that describes how to support exception catchpoints
11950 for a given executable. */
11952 struct exception_support_info
11954 /* The name of the symbol to break on in order to insert
11955 a catchpoint on exceptions. */
11956 const char *catch_exception_sym;
11958 /* The name of the symbol to break on in order to insert
11959 a catchpoint on unhandled exceptions. */
11960 const char *catch_exception_unhandled_sym;
11962 /* The name of the symbol to break on in order to insert
11963 a catchpoint on failed assertions. */
11964 const char *catch_assert_sym;
11966 /* The name of the symbol to break on in order to insert
11967 a catchpoint on exception handling. */
11968 const char *catch_handlers_sym;
11970 /* Assuming that the inferior just triggered an unhandled exception
11971 catchpoint, this function is responsible for returning the address
11972 in inferior memory where the name of that exception is stored.
11973 Return zero if the address could not be computed. */
11974 ada_unhandled_exception_name_addr_ftype *unhandled_exception_name_addr;
11977 static CORE_ADDR ada_unhandled_exception_name_addr (void);
11978 static CORE_ADDR ada_unhandled_exception_name_addr_from_raise (void);
11980 /* The following exception support info structure describes how to
11981 implement exception catchpoints with the latest version of the
11982 Ada runtime (as of 2007-03-06). */
11984 static const struct exception_support_info default_exception_support_info =
11986 "__gnat_debug_raise_exception", /* catch_exception_sym */
11987 "__gnat_unhandled_exception", /* catch_exception_unhandled_sym */
11988 "__gnat_debug_raise_assert_failure", /* catch_assert_sym */
11989 "__gnat_begin_handler", /* catch_handlers_sym */
11990 ada_unhandled_exception_name_addr
11993 /* The following exception support info structure describes how to
11994 implement exception catchpoints with a slightly older version
11995 of the Ada runtime. */
11997 static const struct exception_support_info exception_support_info_fallback =
11999 "__gnat_raise_nodefer_with_msg", /* catch_exception_sym */
12000 "__gnat_unhandled_exception", /* catch_exception_unhandled_sym */
12001 "system__assertions__raise_assert_failure", /* catch_assert_sym */
12002 "__gnat_begin_handler", /* catch_handlers_sym */
12003 ada_unhandled_exception_name_addr_from_raise
12006 /* Return nonzero if we can detect the exception support routines
12007 described in EINFO.
12009 This function errors out if an abnormal situation is detected
12010 (for instance, if we find the exception support routines, but
12011 that support is found to be incomplete). */
12014 ada_has_this_exception_support (const struct exception_support_info *einfo)
12016 struct symbol *sym;
12018 /* The symbol we're looking up is provided by a unit in the GNAT runtime
12019 that should be compiled with debugging information. As a result, we
12020 expect to find that symbol in the symtabs. */
12022 sym = standard_lookup (einfo->catch_exception_sym, NULL, VAR_DOMAIN);
12025 /* Perhaps we did not find our symbol because the Ada runtime was
12026 compiled without debugging info, or simply stripped of it.
12027 It happens on some GNU/Linux distributions for instance, where
12028 users have to install a separate debug package in order to get
12029 the runtime's debugging info. In that situation, let the user
12030 know why we cannot insert an Ada exception catchpoint.
12032 Note: Just for the purpose of inserting our Ada exception
12033 catchpoint, we could rely purely on the associated minimal symbol.
12034 But we would be operating in degraded mode anyway, since we are
12035 still lacking the debugging info needed later on to extract
12036 the name of the exception being raised (this name is printed in
12037 the catchpoint message, and is also used when trying to catch
12038 a specific exception). We do not handle this case for now. */
12039 struct bound_minimal_symbol msym
12040 = lookup_minimal_symbol (einfo->catch_exception_sym, NULL, NULL);
12042 if (msym.minsym && MSYMBOL_TYPE (msym.minsym) != mst_solib_trampoline)
12043 error (_("Your Ada runtime appears to be missing some debugging "
12044 "information.\nCannot insert Ada exception catchpoint "
12045 "in this configuration."));
12050 /* Make sure that the symbol we found corresponds to a function. */
12052 if (SYMBOL_CLASS (sym) != LOC_BLOCK)
12053 error (_("Symbol \"%s\" is not a function (class = %d)"),
12054 SYMBOL_LINKAGE_NAME (sym), SYMBOL_CLASS (sym));
12059 /* Inspect the Ada runtime and determine which exception info structure
12060 should be used to provide support for exception catchpoints.
12062 This function will always set the per-inferior exception_info,
12063 or raise an error. */
12066 ada_exception_support_info_sniffer (void)
12068 struct ada_inferior_data *data = get_ada_inferior_data (current_inferior ());
12070 /* If the exception info is already known, then no need to recompute it. */
12071 if (data->exception_info != NULL)
12074 /* Check the latest (default) exception support info. */
12075 if (ada_has_this_exception_support (&default_exception_support_info))
12077 data->exception_info = &default_exception_support_info;
12081 /* Try our fallback exception suport info. */
12082 if (ada_has_this_exception_support (&exception_support_info_fallback))
12084 data->exception_info = &exception_support_info_fallback;
12088 /* Sometimes, it is normal for us to not be able to find the routine
12089 we are looking for. This happens when the program is linked with
12090 the shared version of the GNAT runtime, and the program has not been
12091 started yet. Inform the user of these two possible causes if
12094 if (ada_update_initial_language (language_unknown) != language_ada)
12095 error (_("Unable to insert catchpoint. Is this an Ada main program?"));
12097 /* If the symbol does not exist, then check that the program is
12098 already started, to make sure that shared libraries have been
12099 loaded. If it is not started, this may mean that the symbol is
12100 in a shared library. */
12102 if (inferior_ptid.pid () == 0)
12103 error (_("Unable to insert catchpoint. Try to start the program first."));
12105 /* At this point, we know that we are debugging an Ada program and
12106 that the inferior has been started, but we still are not able to
12107 find the run-time symbols. That can mean that we are in
12108 configurable run time mode, or that a-except as been optimized
12109 out by the linker... In any case, at this point it is not worth
12110 supporting this feature. */
12112 error (_("Cannot insert Ada exception catchpoints in this configuration."));
12115 /* True iff FRAME is very likely to be that of a function that is
12116 part of the runtime system. This is all very heuristic, but is
12117 intended to be used as advice as to what frames are uninteresting
12121 is_known_support_routine (struct frame_info *frame)
12123 enum language func_lang;
12125 const char *fullname;
12127 /* If this code does not have any debugging information (no symtab),
12128 This cannot be any user code. */
12130 symtab_and_line sal = find_frame_sal (frame);
12131 if (sal.symtab == NULL)
12134 /* If there is a symtab, but the associated source file cannot be
12135 located, then assume this is not user code: Selecting a frame
12136 for which we cannot display the code would not be very helpful
12137 for the user. This should also take care of case such as VxWorks
12138 where the kernel has some debugging info provided for a few units. */
12140 fullname = symtab_to_fullname (sal.symtab);
12141 if (access (fullname, R_OK) != 0)
12144 /* Check the unit filename againt the Ada runtime file naming.
12145 We also check the name of the objfile against the name of some
12146 known system libraries that sometimes come with debugging info
12149 for (i = 0; known_runtime_file_name_patterns[i] != NULL; i += 1)
12151 re_comp (known_runtime_file_name_patterns[i]);
12152 if (re_exec (lbasename (sal.symtab->filename)))
12154 if (SYMTAB_OBJFILE (sal.symtab) != NULL
12155 && re_exec (objfile_name (SYMTAB_OBJFILE (sal.symtab))))
12159 /* Check whether the function is a GNAT-generated entity. */
12161 gdb::unique_xmalloc_ptr<char> func_name
12162 = find_frame_funname (frame, &func_lang, NULL);
12163 if (func_name == NULL)
12166 for (i = 0; known_auxiliary_function_name_patterns[i] != NULL; i += 1)
12168 re_comp (known_auxiliary_function_name_patterns[i]);
12169 if (re_exec (func_name.get ()))
12176 /* Find the first frame that contains debugging information and that is not
12177 part of the Ada run-time, starting from FI and moving upward. */
12180 ada_find_printable_frame (struct frame_info *fi)
12182 for (; fi != NULL; fi = get_prev_frame (fi))
12184 if (!is_known_support_routine (fi))
12193 /* Assuming that the inferior just triggered an unhandled exception
12194 catchpoint, return the address in inferior memory where the name
12195 of the exception is stored.
12197 Return zero if the address could not be computed. */
12200 ada_unhandled_exception_name_addr (void)
12202 return parse_and_eval_address ("e.full_name");
12205 /* Same as ada_unhandled_exception_name_addr, except that this function
12206 should be used when the inferior uses an older version of the runtime,
12207 where the exception name needs to be extracted from a specific frame
12208 several frames up in the callstack. */
12211 ada_unhandled_exception_name_addr_from_raise (void)
12214 struct frame_info *fi;
12215 struct ada_inferior_data *data = get_ada_inferior_data (current_inferior ());
12217 /* To determine the name of this exception, we need to select
12218 the frame corresponding to RAISE_SYM_NAME. This frame is
12219 at least 3 levels up, so we simply skip the first 3 frames
12220 without checking the name of their associated function. */
12221 fi = get_current_frame ();
12222 for (frame_level = 0; frame_level < 3; frame_level += 1)
12224 fi = get_prev_frame (fi);
12228 enum language func_lang;
12230 gdb::unique_xmalloc_ptr<char> func_name
12231 = find_frame_funname (fi, &func_lang, NULL);
12232 if (func_name != NULL)
12234 if (strcmp (func_name.get (),
12235 data->exception_info->catch_exception_sym) == 0)
12236 break; /* We found the frame we were looking for... */
12238 fi = get_prev_frame (fi);
12245 return parse_and_eval_address ("id.full_name");
12248 /* Assuming the inferior just triggered an Ada exception catchpoint
12249 (of any type), return the address in inferior memory where the name
12250 of the exception is stored, if applicable.
12252 Assumes the selected frame is the current frame.
12254 Return zero if the address could not be computed, or if not relevant. */
12257 ada_exception_name_addr_1 (enum ada_exception_catchpoint_kind ex,
12258 struct breakpoint *b)
12260 struct ada_inferior_data *data = get_ada_inferior_data (current_inferior ());
12264 case ada_catch_exception:
12265 return (parse_and_eval_address ("e.full_name"));
12268 case ada_catch_exception_unhandled:
12269 return data->exception_info->unhandled_exception_name_addr ();
12272 case ada_catch_handlers:
12273 return 0; /* The runtimes does not provide access to the exception
12277 case ada_catch_assert:
12278 return 0; /* Exception name is not relevant in this case. */
12282 internal_error (__FILE__, __LINE__, _("unexpected catchpoint type"));
12286 return 0; /* Should never be reached. */
12289 /* Assuming the inferior is stopped at an exception catchpoint,
12290 return the message which was associated to the exception, if
12291 available. Return NULL if the message could not be retrieved.
12293 Note: The exception message can be associated to an exception
12294 either through the use of the Raise_Exception function, or
12295 more simply (Ada 2005 and later), via:
12297 raise Exception_Name with "exception message";
12301 static gdb::unique_xmalloc_ptr<char>
12302 ada_exception_message_1 (void)
12304 struct value *e_msg_val;
12307 /* For runtimes that support this feature, the exception message
12308 is passed as an unbounded string argument called "message". */
12309 e_msg_val = parse_and_eval ("message");
12310 if (e_msg_val == NULL)
12311 return NULL; /* Exception message not supported. */
12313 e_msg_val = ada_coerce_to_simple_array (e_msg_val);
12314 gdb_assert (e_msg_val != NULL);
12315 e_msg_len = TYPE_LENGTH (value_type (e_msg_val));
12317 /* If the message string is empty, then treat it as if there was
12318 no exception message. */
12319 if (e_msg_len <= 0)
12322 gdb::unique_xmalloc_ptr<char> e_msg ((char *) xmalloc (e_msg_len + 1));
12323 read_memory_string (value_address (e_msg_val), e_msg.get (), e_msg_len + 1);
12324 e_msg.get ()[e_msg_len] = '\0';
12329 /* Same as ada_exception_message_1, except that all exceptions are
12330 contained here (returning NULL instead). */
12332 static gdb::unique_xmalloc_ptr<char>
12333 ada_exception_message (void)
12335 gdb::unique_xmalloc_ptr<char> e_msg;
12339 e_msg = ada_exception_message_1 ();
12341 CATCH (e, RETURN_MASK_ERROR)
12343 e_msg.reset (nullptr);
12350 /* Same as ada_exception_name_addr_1, except that it intercepts and contains
12351 any error that ada_exception_name_addr_1 might cause to be thrown.
12352 When an error is intercepted, a warning with the error message is printed,
12353 and zero is returned. */
12356 ada_exception_name_addr (enum ada_exception_catchpoint_kind ex,
12357 struct breakpoint *b)
12359 CORE_ADDR result = 0;
12363 result = ada_exception_name_addr_1 (ex, b);
12366 CATCH (e, RETURN_MASK_ERROR)
12368 warning (_("failed to get exception name: %s"), e.message);
12376 static std::string ada_exception_catchpoint_cond_string
12377 (const char *excep_string,
12378 enum ada_exception_catchpoint_kind ex);
12380 /* Ada catchpoints.
12382 In the case of catchpoints on Ada exceptions, the catchpoint will
12383 stop the target on every exception the program throws. When a user
12384 specifies the name of a specific exception, we translate this
12385 request into a condition expression (in text form), and then parse
12386 it into an expression stored in each of the catchpoint's locations.
12387 We then use this condition to check whether the exception that was
12388 raised is the one the user is interested in. If not, then the
12389 target is resumed again. We store the name of the requested
12390 exception, in order to be able to re-set the condition expression
12391 when symbols change. */
12393 /* An instance of this type is used to represent an Ada catchpoint
12394 breakpoint location. */
12396 class ada_catchpoint_location : public bp_location
12399 ada_catchpoint_location (breakpoint *owner)
12400 : bp_location (owner)
12403 /* The condition that checks whether the exception that was raised
12404 is the specific exception the user specified on catchpoint
12406 expression_up excep_cond_expr;
12409 /* An instance of this type is used to represent an Ada catchpoint. */
12411 struct ada_catchpoint : public breakpoint
12413 /* The name of the specific exception the user specified. */
12414 std::string excep_string;
12417 /* Parse the exception condition string in the context of each of the
12418 catchpoint's locations, and store them for later evaluation. */
12421 create_excep_cond_exprs (struct ada_catchpoint *c,
12422 enum ada_exception_catchpoint_kind ex)
12424 struct bp_location *bl;
12426 /* Nothing to do if there's no specific exception to catch. */
12427 if (c->excep_string.empty ())
12430 /* Same if there are no locations... */
12431 if (c->loc == NULL)
12434 /* Compute the condition expression in text form, from the specific
12435 expection we want to catch. */
12436 std::string cond_string
12437 = ada_exception_catchpoint_cond_string (c->excep_string.c_str (), ex);
12439 /* Iterate over all the catchpoint's locations, and parse an
12440 expression for each. */
12441 for (bl = c->loc; bl != NULL; bl = bl->next)
12443 struct ada_catchpoint_location *ada_loc
12444 = (struct ada_catchpoint_location *) bl;
12447 if (!bl->shlib_disabled)
12451 s = cond_string.c_str ();
12454 exp = parse_exp_1 (&s, bl->address,
12455 block_for_pc (bl->address),
12458 CATCH (e, RETURN_MASK_ERROR)
12460 warning (_("failed to reevaluate internal exception condition "
12461 "for catchpoint %d: %s"),
12462 c->number, e.message);
12467 ada_loc->excep_cond_expr = std::move (exp);
12471 /* Implement the ALLOCATE_LOCATION method in the breakpoint_ops
12472 structure for all exception catchpoint kinds. */
12474 static struct bp_location *
12475 allocate_location_exception (enum ada_exception_catchpoint_kind ex,
12476 struct breakpoint *self)
12478 return new ada_catchpoint_location (self);
12481 /* Implement the RE_SET method in the breakpoint_ops structure for all
12482 exception catchpoint kinds. */
12485 re_set_exception (enum ada_exception_catchpoint_kind ex, struct breakpoint *b)
12487 struct ada_catchpoint *c = (struct ada_catchpoint *) b;
12489 /* Call the base class's method. This updates the catchpoint's
12491 bkpt_breakpoint_ops.re_set (b);
12493 /* Reparse the exception conditional expressions. One for each
12495 create_excep_cond_exprs (c, ex);
12498 /* Returns true if we should stop for this breakpoint hit. If the
12499 user specified a specific exception, we only want to cause a stop
12500 if the program thrown that exception. */
12503 should_stop_exception (const struct bp_location *bl)
12505 struct ada_catchpoint *c = (struct ada_catchpoint *) bl->owner;
12506 const struct ada_catchpoint_location *ada_loc
12507 = (const struct ada_catchpoint_location *) bl;
12510 /* With no specific exception, should always stop. */
12511 if (c->excep_string.empty ())
12514 if (ada_loc->excep_cond_expr == NULL)
12516 /* We will have a NULL expression if back when we were creating
12517 the expressions, this location's had failed to parse. */
12524 struct value *mark;
12526 mark = value_mark ();
12527 stop = value_true (evaluate_expression (ada_loc->excep_cond_expr.get ()));
12528 value_free_to_mark (mark);
12530 CATCH (ex, RETURN_MASK_ALL)
12532 exception_fprintf (gdb_stderr, ex,
12533 _("Error in testing exception condition:\n"));
12540 /* Implement the CHECK_STATUS method in the breakpoint_ops structure
12541 for all exception catchpoint kinds. */
12544 check_status_exception (enum ada_exception_catchpoint_kind ex, bpstat bs)
12546 bs->stop = should_stop_exception (bs->bp_location_at);
12549 /* Implement the PRINT_IT method in the breakpoint_ops structure
12550 for all exception catchpoint kinds. */
12552 static enum print_stop_action
12553 print_it_exception (enum ada_exception_catchpoint_kind ex, bpstat bs)
12555 struct ui_out *uiout = current_uiout;
12556 struct breakpoint *b = bs->breakpoint_at;
12558 annotate_catchpoint (b->number);
12560 if (uiout->is_mi_like_p ())
12562 uiout->field_string ("reason",
12563 async_reason_lookup (EXEC_ASYNC_BREAKPOINT_HIT));
12564 uiout->field_string ("disp", bpdisp_text (b->disposition));
12567 uiout->text (b->disposition == disp_del
12568 ? "\nTemporary catchpoint " : "\nCatchpoint ");
12569 uiout->field_int ("bkptno", b->number);
12570 uiout->text (", ");
12572 /* ada_exception_name_addr relies on the selected frame being the
12573 current frame. Need to do this here because this function may be
12574 called more than once when printing a stop, and below, we'll
12575 select the first frame past the Ada run-time (see
12576 ada_find_printable_frame). */
12577 select_frame (get_current_frame ());
12581 case ada_catch_exception:
12582 case ada_catch_exception_unhandled:
12583 case ada_catch_handlers:
12585 const CORE_ADDR addr = ada_exception_name_addr (ex, b);
12586 char exception_name[256];
12590 read_memory (addr, (gdb_byte *) exception_name,
12591 sizeof (exception_name) - 1);
12592 exception_name [sizeof (exception_name) - 1] = '\0';
12596 /* For some reason, we were unable to read the exception
12597 name. This could happen if the Runtime was compiled
12598 without debugging info, for instance. In that case,
12599 just replace the exception name by the generic string
12600 "exception" - it will read as "an exception" in the
12601 notification we are about to print. */
12602 memcpy (exception_name, "exception", sizeof ("exception"));
12604 /* In the case of unhandled exception breakpoints, we print
12605 the exception name as "unhandled EXCEPTION_NAME", to make
12606 it clearer to the user which kind of catchpoint just got
12607 hit. We used ui_out_text to make sure that this extra
12608 info does not pollute the exception name in the MI case. */
12609 if (ex == ada_catch_exception_unhandled)
12610 uiout->text ("unhandled ");
12611 uiout->field_string ("exception-name", exception_name);
12614 case ada_catch_assert:
12615 /* In this case, the name of the exception is not really
12616 important. Just print "failed assertion" to make it clearer
12617 that his program just hit an assertion-failure catchpoint.
12618 We used ui_out_text because this info does not belong in
12620 uiout->text ("failed assertion");
12624 gdb::unique_xmalloc_ptr<char> exception_message = ada_exception_message ();
12625 if (exception_message != NULL)
12627 uiout->text (" (");
12628 uiout->field_string ("exception-message", exception_message.get ());
12632 uiout->text (" at ");
12633 ada_find_printable_frame (get_current_frame ());
12635 return PRINT_SRC_AND_LOC;
12638 /* Implement the PRINT_ONE method in the breakpoint_ops structure
12639 for all exception catchpoint kinds. */
12642 print_one_exception (enum ada_exception_catchpoint_kind ex,
12643 struct breakpoint *b, struct bp_location **last_loc)
12645 struct ui_out *uiout = current_uiout;
12646 struct ada_catchpoint *c = (struct ada_catchpoint *) b;
12647 struct value_print_options opts;
12649 get_user_print_options (&opts);
12650 if (opts.addressprint)
12652 annotate_field (4);
12653 uiout->field_core_addr ("addr", b->loc->gdbarch, b->loc->address);
12656 annotate_field (5);
12657 *last_loc = b->loc;
12660 case ada_catch_exception:
12661 if (!c->excep_string.empty ())
12663 std::string msg = string_printf (_("`%s' Ada exception"),
12664 c->excep_string.c_str ());
12666 uiout->field_string ("what", msg);
12669 uiout->field_string ("what", "all Ada exceptions");
12673 case ada_catch_exception_unhandled:
12674 uiout->field_string ("what", "unhandled Ada exceptions");
12677 case ada_catch_handlers:
12678 if (!c->excep_string.empty ())
12680 uiout->field_fmt ("what",
12681 _("`%s' Ada exception handlers"),
12682 c->excep_string.c_str ());
12685 uiout->field_string ("what", "all Ada exceptions handlers");
12688 case ada_catch_assert:
12689 uiout->field_string ("what", "failed Ada assertions");
12693 internal_error (__FILE__, __LINE__, _("unexpected catchpoint type"));
12698 /* Implement the PRINT_MENTION method in the breakpoint_ops structure
12699 for all exception catchpoint kinds. */
12702 print_mention_exception (enum ada_exception_catchpoint_kind ex,
12703 struct breakpoint *b)
12705 struct ada_catchpoint *c = (struct ada_catchpoint *) b;
12706 struct ui_out *uiout = current_uiout;
12708 uiout->text (b->disposition == disp_del ? _("Temporary catchpoint ")
12709 : _("Catchpoint "));
12710 uiout->field_int ("bkptno", b->number);
12711 uiout->text (": ");
12715 case ada_catch_exception:
12716 if (!c->excep_string.empty ())
12718 std::string info = string_printf (_("`%s' Ada exception"),
12719 c->excep_string.c_str ());
12720 uiout->text (info.c_str ());
12723 uiout->text (_("all Ada exceptions"));
12726 case ada_catch_exception_unhandled:
12727 uiout->text (_("unhandled Ada exceptions"));
12730 case ada_catch_handlers:
12731 if (!c->excep_string.empty ())
12734 = string_printf (_("`%s' Ada exception handlers"),
12735 c->excep_string.c_str ());
12736 uiout->text (info.c_str ());
12739 uiout->text (_("all Ada exceptions handlers"));
12742 case ada_catch_assert:
12743 uiout->text (_("failed Ada assertions"));
12747 internal_error (__FILE__, __LINE__, _("unexpected catchpoint type"));
12752 /* Implement the PRINT_RECREATE method in the breakpoint_ops structure
12753 for all exception catchpoint kinds. */
12756 print_recreate_exception (enum ada_exception_catchpoint_kind ex,
12757 struct breakpoint *b, struct ui_file *fp)
12759 struct ada_catchpoint *c = (struct ada_catchpoint *) b;
12763 case ada_catch_exception:
12764 fprintf_filtered (fp, "catch exception");
12765 if (!c->excep_string.empty ())
12766 fprintf_filtered (fp, " %s", c->excep_string.c_str ());
12769 case ada_catch_exception_unhandled:
12770 fprintf_filtered (fp, "catch exception unhandled");
12773 case ada_catch_handlers:
12774 fprintf_filtered (fp, "catch handlers");
12777 case ada_catch_assert:
12778 fprintf_filtered (fp, "catch assert");
12782 internal_error (__FILE__, __LINE__, _("unexpected catchpoint type"));
12784 print_recreate_thread (b, fp);
12787 /* Virtual table for "catch exception" breakpoints. */
12789 static struct bp_location *
12790 allocate_location_catch_exception (struct breakpoint *self)
12792 return allocate_location_exception (ada_catch_exception, self);
12796 re_set_catch_exception (struct breakpoint *b)
12798 re_set_exception (ada_catch_exception, b);
12802 check_status_catch_exception (bpstat bs)
12804 check_status_exception (ada_catch_exception, bs);
12807 static enum print_stop_action
12808 print_it_catch_exception (bpstat bs)
12810 return print_it_exception (ada_catch_exception, bs);
12814 print_one_catch_exception (struct breakpoint *b, struct bp_location **last_loc)
12816 print_one_exception (ada_catch_exception, b, last_loc);
12820 print_mention_catch_exception (struct breakpoint *b)
12822 print_mention_exception (ada_catch_exception, b);
12826 print_recreate_catch_exception (struct breakpoint *b, struct ui_file *fp)
12828 print_recreate_exception (ada_catch_exception, b, fp);
12831 static struct breakpoint_ops catch_exception_breakpoint_ops;
12833 /* Virtual table for "catch exception unhandled" breakpoints. */
12835 static struct bp_location *
12836 allocate_location_catch_exception_unhandled (struct breakpoint *self)
12838 return allocate_location_exception (ada_catch_exception_unhandled, self);
12842 re_set_catch_exception_unhandled (struct breakpoint *b)
12844 re_set_exception (ada_catch_exception_unhandled, b);
12848 check_status_catch_exception_unhandled (bpstat bs)
12850 check_status_exception (ada_catch_exception_unhandled, bs);
12853 static enum print_stop_action
12854 print_it_catch_exception_unhandled (bpstat bs)
12856 return print_it_exception (ada_catch_exception_unhandled, bs);
12860 print_one_catch_exception_unhandled (struct breakpoint *b,
12861 struct bp_location **last_loc)
12863 print_one_exception (ada_catch_exception_unhandled, b, last_loc);
12867 print_mention_catch_exception_unhandled (struct breakpoint *b)
12869 print_mention_exception (ada_catch_exception_unhandled, b);
12873 print_recreate_catch_exception_unhandled (struct breakpoint *b,
12874 struct ui_file *fp)
12876 print_recreate_exception (ada_catch_exception_unhandled, b, fp);
12879 static struct breakpoint_ops catch_exception_unhandled_breakpoint_ops;
12881 /* Virtual table for "catch assert" breakpoints. */
12883 static struct bp_location *
12884 allocate_location_catch_assert (struct breakpoint *self)
12886 return allocate_location_exception (ada_catch_assert, self);
12890 re_set_catch_assert (struct breakpoint *b)
12892 re_set_exception (ada_catch_assert, b);
12896 check_status_catch_assert (bpstat bs)
12898 check_status_exception (ada_catch_assert, bs);
12901 static enum print_stop_action
12902 print_it_catch_assert (bpstat bs)
12904 return print_it_exception (ada_catch_assert, bs);
12908 print_one_catch_assert (struct breakpoint *b, struct bp_location **last_loc)
12910 print_one_exception (ada_catch_assert, b, last_loc);
12914 print_mention_catch_assert (struct breakpoint *b)
12916 print_mention_exception (ada_catch_assert, b);
12920 print_recreate_catch_assert (struct breakpoint *b, struct ui_file *fp)
12922 print_recreate_exception (ada_catch_assert, b, fp);
12925 static struct breakpoint_ops catch_assert_breakpoint_ops;
12927 /* Virtual table for "catch handlers" breakpoints. */
12929 static struct bp_location *
12930 allocate_location_catch_handlers (struct breakpoint *self)
12932 return allocate_location_exception (ada_catch_handlers, self);
12936 re_set_catch_handlers (struct breakpoint *b)
12938 re_set_exception (ada_catch_handlers, b);
12942 check_status_catch_handlers (bpstat bs)
12944 check_status_exception (ada_catch_handlers, bs);
12947 static enum print_stop_action
12948 print_it_catch_handlers (bpstat bs)
12950 return print_it_exception (ada_catch_handlers, bs);
12954 print_one_catch_handlers (struct breakpoint *b,
12955 struct bp_location **last_loc)
12957 print_one_exception (ada_catch_handlers, b, last_loc);
12961 print_mention_catch_handlers (struct breakpoint *b)
12963 print_mention_exception (ada_catch_handlers, b);
12967 print_recreate_catch_handlers (struct breakpoint *b,
12968 struct ui_file *fp)
12970 print_recreate_exception (ada_catch_handlers, b, fp);
12973 static struct breakpoint_ops catch_handlers_breakpoint_ops;
12975 /* Split the arguments specified in a "catch exception" command.
12976 Set EX to the appropriate catchpoint type.
12977 Set EXCEP_STRING to the name of the specific exception if
12978 specified by the user.
12979 IS_CATCH_HANDLERS_CMD: True if the arguments are for a
12980 "catch handlers" command. False otherwise.
12981 If a condition is found at the end of the arguments, the condition
12982 expression is stored in COND_STRING (memory must be deallocated
12983 after use). Otherwise COND_STRING is set to NULL. */
12986 catch_ada_exception_command_split (const char *args,
12987 bool is_catch_handlers_cmd,
12988 enum ada_exception_catchpoint_kind *ex,
12989 std::string *excep_string,
12990 std::string *cond_string)
12992 std::string exception_name;
12994 exception_name = extract_arg (&args);
12995 if (exception_name == "if")
12997 /* This is not an exception name; this is the start of a condition
12998 expression for a catchpoint on all exceptions. So, "un-get"
12999 this token, and set exception_name to NULL. */
13000 exception_name.clear ();
13004 /* Check to see if we have a condition. */
13006 args = skip_spaces (args);
13007 if (startswith (args, "if")
13008 && (isspace (args[2]) || args[2] == '\0'))
13011 args = skip_spaces (args);
13013 if (args[0] == '\0')
13014 error (_("Condition missing after `if' keyword"));
13015 *cond_string = args;
13017 args += strlen (args);
13020 /* Check that we do not have any more arguments. Anything else
13023 if (args[0] != '\0')
13024 error (_("Junk at end of expression"));
13026 if (is_catch_handlers_cmd)
13028 /* Catch handling of exceptions. */
13029 *ex = ada_catch_handlers;
13030 *excep_string = exception_name;
13032 else if (exception_name.empty ())
13034 /* Catch all exceptions. */
13035 *ex = ada_catch_exception;
13036 excep_string->clear ();
13038 else if (exception_name == "unhandled")
13040 /* Catch unhandled exceptions. */
13041 *ex = ada_catch_exception_unhandled;
13042 excep_string->clear ();
13046 /* Catch a specific exception. */
13047 *ex = ada_catch_exception;
13048 *excep_string = exception_name;
13052 /* Return the name of the symbol on which we should break in order to
13053 implement a catchpoint of the EX kind. */
13055 static const char *
13056 ada_exception_sym_name (enum ada_exception_catchpoint_kind ex)
13058 struct ada_inferior_data *data = get_ada_inferior_data (current_inferior ());
13060 gdb_assert (data->exception_info != NULL);
13064 case ada_catch_exception:
13065 return (data->exception_info->catch_exception_sym);
13067 case ada_catch_exception_unhandled:
13068 return (data->exception_info->catch_exception_unhandled_sym);
13070 case ada_catch_assert:
13071 return (data->exception_info->catch_assert_sym);
13073 case ada_catch_handlers:
13074 return (data->exception_info->catch_handlers_sym);
13077 internal_error (__FILE__, __LINE__,
13078 _("unexpected catchpoint kind (%d)"), ex);
13082 /* Return the breakpoint ops "virtual table" used for catchpoints
13085 static const struct breakpoint_ops *
13086 ada_exception_breakpoint_ops (enum ada_exception_catchpoint_kind ex)
13090 case ada_catch_exception:
13091 return (&catch_exception_breakpoint_ops);
13093 case ada_catch_exception_unhandled:
13094 return (&catch_exception_unhandled_breakpoint_ops);
13096 case ada_catch_assert:
13097 return (&catch_assert_breakpoint_ops);
13099 case ada_catch_handlers:
13100 return (&catch_handlers_breakpoint_ops);
13103 internal_error (__FILE__, __LINE__,
13104 _("unexpected catchpoint kind (%d)"), ex);
13108 /* Return the condition that will be used to match the current exception
13109 being raised with the exception that the user wants to catch. This
13110 assumes that this condition is used when the inferior just triggered
13111 an exception catchpoint.
13112 EX: the type of catchpoints used for catching Ada exceptions. */
13115 ada_exception_catchpoint_cond_string (const char *excep_string,
13116 enum ada_exception_catchpoint_kind ex)
13119 bool is_standard_exc = false;
13120 std::string result;
13122 if (ex == ada_catch_handlers)
13124 /* For exception handlers catchpoints, the condition string does
13125 not use the same parameter as for the other exceptions. */
13126 result = ("long_integer (GNAT_GCC_exception_Access"
13127 "(gcc_exception).all.occurrence.id)");
13130 result = "long_integer (e)";
13132 /* The standard exceptions are a special case. They are defined in
13133 runtime units that have been compiled without debugging info; if
13134 EXCEP_STRING is the not-fully-qualified name of a standard
13135 exception (e.g. "constraint_error") then, during the evaluation
13136 of the condition expression, the symbol lookup on this name would
13137 *not* return this standard exception. The catchpoint condition
13138 may then be set only on user-defined exceptions which have the
13139 same not-fully-qualified name (e.g. my_package.constraint_error).
13141 To avoid this unexcepted behavior, these standard exceptions are
13142 systematically prefixed by "standard". This means that "catch
13143 exception constraint_error" is rewritten into "catch exception
13144 standard.constraint_error".
13146 If an exception named contraint_error is defined in another package of
13147 the inferior program, then the only way to specify this exception as a
13148 breakpoint condition is to use its fully-qualified named:
13149 e.g. my_package.constraint_error. */
13151 for (i = 0; i < sizeof (standard_exc) / sizeof (char *); i++)
13153 if (strcmp (standard_exc [i], excep_string) == 0)
13155 is_standard_exc = true;
13162 if (is_standard_exc)
13163 string_appendf (result, "long_integer (&standard.%s)", excep_string);
13165 string_appendf (result, "long_integer (&%s)", excep_string);
13170 /* Return the symtab_and_line that should be used to insert an exception
13171 catchpoint of the TYPE kind.
13173 ADDR_STRING returns the name of the function where the real
13174 breakpoint that implements the catchpoints is set, depending on the
13175 type of catchpoint we need to create. */
13177 static struct symtab_and_line
13178 ada_exception_sal (enum ada_exception_catchpoint_kind ex,
13179 std::string *addr_string, const struct breakpoint_ops **ops)
13181 const char *sym_name;
13182 struct symbol *sym;
13184 /* First, find out which exception support info to use. */
13185 ada_exception_support_info_sniffer ();
13187 /* Then lookup the function on which we will break in order to catch
13188 the Ada exceptions requested by the user. */
13189 sym_name = ada_exception_sym_name (ex);
13190 sym = standard_lookup (sym_name, NULL, VAR_DOMAIN);
13193 error (_("Catchpoint symbol not found: %s"), sym_name);
13195 if (SYMBOL_CLASS (sym) != LOC_BLOCK)
13196 error (_("Unable to insert catchpoint. %s is not a function."), sym_name);
13198 /* Set ADDR_STRING. */
13199 *addr_string = sym_name;
13202 *ops = ada_exception_breakpoint_ops (ex);
13204 return find_function_start_sal (sym, 1);
13207 /* Create an Ada exception catchpoint.
13209 EX_KIND is the kind of exception catchpoint to be created.
13211 If EXCEPT_STRING is empty, this catchpoint is expected to trigger
13212 for all exceptions. Otherwise, EXCEPT_STRING indicates the name
13213 of the exception to which this catchpoint applies.
13215 COND_STRING, if not empty, is the catchpoint condition.
13217 TEMPFLAG, if nonzero, means that the underlying breakpoint
13218 should be temporary.
13220 FROM_TTY is the usual argument passed to all commands implementations. */
13223 create_ada_exception_catchpoint (struct gdbarch *gdbarch,
13224 enum ada_exception_catchpoint_kind ex_kind,
13225 const std::string &excep_string,
13226 const std::string &cond_string,
13231 std::string addr_string;
13232 const struct breakpoint_ops *ops = NULL;
13233 struct symtab_and_line sal = ada_exception_sal (ex_kind, &addr_string, &ops);
13235 std::unique_ptr<ada_catchpoint> c (new ada_catchpoint ());
13236 init_ada_exception_breakpoint (c.get (), gdbarch, sal, addr_string.c_str (),
13237 ops, tempflag, disabled, from_tty);
13238 c->excep_string = excep_string;
13239 create_excep_cond_exprs (c.get (), ex_kind);
13240 if (!cond_string.empty ())
13241 set_breakpoint_condition (c.get (), cond_string.c_str (), from_tty);
13242 install_breakpoint (0, std::move (c), 1);
13245 /* Implement the "catch exception" command. */
13248 catch_ada_exception_command (const char *arg_entry, int from_tty,
13249 struct cmd_list_element *command)
13251 const char *arg = arg_entry;
13252 struct gdbarch *gdbarch = get_current_arch ();
13254 enum ada_exception_catchpoint_kind ex_kind;
13255 std::string excep_string;
13256 std::string cond_string;
13258 tempflag = get_cmd_context (command) == CATCH_TEMPORARY;
13262 catch_ada_exception_command_split (arg, false, &ex_kind, &excep_string,
13264 create_ada_exception_catchpoint (gdbarch, ex_kind,
13265 excep_string, cond_string,
13266 tempflag, 1 /* enabled */,
13270 /* Implement the "catch handlers" command. */
13273 catch_ada_handlers_command (const char *arg_entry, int from_tty,
13274 struct cmd_list_element *command)
13276 const char *arg = arg_entry;
13277 struct gdbarch *gdbarch = get_current_arch ();
13279 enum ada_exception_catchpoint_kind ex_kind;
13280 std::string excep_string;
13281 std::string cond_string;
13283 tempflag = get_cmd_context (command) == CATCH_TEMPORARY;
13287 catch_ada_exception_command_split (arg, true, &ex_kind, &excep_string,
13289 create_ada_exception_catchpoint (gdbarch, ex_kind,
13290 excep_string, cond_string,
13291 tempflag, 1 /* enabled */,
13295 /* Split the arguments specified in a "catch assert" command.
13297 ARGS contains the command's arguments (or the empty string if
13298 no arguments were passed).
13300 If ARGS contains a condition, set COND_STRING to that condition
13301 (the memory needs to be deallocated after use). */
13304 catch_ada_assert_command_split (const char *args, std::string &cond_string)
13306 args = skip_spaces (args);
13308 /* Check whether a condition was provided. */
13309 if (startswith (args, "if")
13310 && (isspace (args[2]) || args[2] == '\0'))
13313 args = skip_spaces (args);
13314 if (args[0] == '\0')
13315 error (_("condition missing after `if' keyword"));
13316 cond_string.assign (args);
13319 /* Otherwise, there should be no other argument at the end of
13321 else if (args[0] != '\0')
13322 error (_("Junk at end of arguments."));
13325 /* Implement the "catch assert" command. */
13328 catch_assert_command (const char *arg_entry, int from_tty,
13329 struct cmd_list_element *command)
13331 const char *arg = arg_entry;
13332 struct gdbarch *gdbarch = get_current_arch ();
13334 std::string cond_string;
13336 tempflag = get_cmd_context (command) == CATCH_TEMPORARY;
13340 catch_ada_assert_command_split (arg, cond_string);
13341 create_ada_exception_catchpoint (gdbarch, ada_catch_assert,
13343 tempflag, 1 /* enabled */,
13347 /* Return non-zero if the symbol SYM is an Ada exception object. */
13350 ada_is_exception_sym (struct symbol *sym)
13352 const char *type_name = TYPE_NAME (SYMBOL_TYPE (sym));
13354 return (SYMBOL_CLASS (sym) != LOC_TYPEDEF
13355 && SYMBOL_CLASS (sym) != LOC_BLOCK
13356 && SYMBOL_CLASS (sym) != LOC_CONST
13357 && SYMBOL_CLASS (sym) != LOC_UNRESOLVED
13358 && type_name != NULL && strcmp (type_name, "exception") == 0);
13361 /* Given a global symbol SYM, return non-zero iff SYM is a non-standard
13362 Ada exception object. This matches all exceptions except the ones
13363 defined by the Ada language. */
13366 ada_is_non_standard_exception_sym (struct symbol *sym)
13370 if (!ada_is_exception_sym (sym))
13373 for (i = 0; i < ARRAY_SIZE (standard_exc); i++)
13374 if (strcmp (SYMBOL_LINKAGE_NAME (sym), standard_exc[i]) == 0)
13375 return 0; /* A standard exception. */
13377 /* Numeric_Error is also a standard exception, so exclude it.
13378 See the STANDARD_EXC description for more details as to why
13379 this exception is not listed in that array. */
13380 if (strcmp (SYMBOL_LINKAGE_NAME (sym), "numeric_error") == 0)
13386 /* A helper function for std::sort, comparing two struct ada_exc_info
13389 The comparison is determined first by exception name, and then
13390 by exception address. */
13393 ada_exc_info::operator< (const ada_exc_info &other) const
13397 result = strcmp (name, other.name);
13400 if (result == 0 && addr < other.addr)
13406 ada_exc_info::operator== (const ada_exc_info &other) const
13408 return addr == other.addr && strcmp (name, other.name) == 0;
13411 /* Sort EXCEPTIONS using compare_ada_exception_info as the comparison
13412 routine, but keeping the first SKIP elements untouched.
13414 All duplicates are also removed. */
13417 sort_remove_dups_ada_exceptions_list (std::vector<ada_exc_info> *exceptions,
13420 std::sort (exceptions->begin () + skip, exceptions->end ());
13421 exceptions->erase (std::unique (exceptions->begin () + skip, exceptions->end ()),
13422 exceptions->end ());
13425 /* Add all exceptions defined by the Ada standard whose name match
13426 a regular expression.
13428 If PREG is not NULL, then this regexp_t object is used to
13429 perform the symbol name matching. Otherwise, no name-based
13430 filtering is performed.
13432 EXCEPTIONS is a vector of exceptions to which matching exceptions
13436 ada_add_standard_exceptions (compiled_regex *preg,
13437 std::vector<ada_exc_info> *exceptions)
13441 for (i = 0; i < ARRAY_SIZE (standard_exc); i++)
13444 || preg->exec (standard_exc[i], 0, NULL, 0) == 0)
13446 struct bound_minimal_symbol msymbol
13447 = ada_lookup_simple_minsym (standard_exc[i]);
13449 if (msymbol.minsym != NULL)
13451 struct ada_exc_info info
13452 = {standard_exc[i], BMSYMBOL_VALUE_ADDRESS (msymbol)};
13454 exceptions->push_back (info);
13460 /* Add all Ada exceptions defined locally and accessible from the given
13463 If PREG is not NULL, then this regexp_t object is used to
13464 perform the symbol name matching. Otherwise, no name-based
13465 filtering is performed.
13467 EXCEPTIONS is a vector of exceptions to which matching exceptions
13471 ada_add_exceptions_from_frame (compiled_regex *preg,
13472 struct frame_info *frame,
13473 std::vector<ada_exc_info> *exceptions)
13475 const struct block *block = get_frame_block (frame, 0);
13479 struct block_iterator iter;
13480 struct symbol *sym;
13482 ALL_BLOCK_SYMBOLS (block, iter, sym)
13484 switch (SYMBOL_CLASS (sym))
13491 if (ada_is_exception_sym (sym))
13493 struct ada_exc_info info = {SYMBOL_PRINT_NAME (sym),
13494 SYMBOL_VALUE_ADDRESS (sym)};
13496 exceptions->push_back (info);
13500 if (BLOCK_FUNCTION (block) != NULL)
13502 block = BLOCK_SUPERBLOCK (block);
13506 /* Return true if NAME matches PREG or if PREG is NULL. */
13509 name_matches_regex (const char *name, compiled_regex *preg)
13511 return (preg == NULL
13512 || preg->exec (ada_decode (name), 0, NULL, 0) == 0);
13515 /* Add all exceptions defined globally whose name name match
13516 a regular expression, excluding standard exceptions.
13518 The reason we exclude standard exceptions is that they need
13519 to be handled separately: Standard exceptions are defined inside
13520 a runtime unit which is normally not compiled with debugging info,
13521 and thus usually do not show up in our symbol search. However,
13522 if the unit was in fact built with debugging info, we need to
13523 exclude them because they would duplicate the entry we found
13524 during the special loop that specifically searches for those
13525 standard exceptions.
13527 If PREG is not NULL, then this regexp_t object is used to
13528 perform the symbol name matching. Otherwise, no name-based
13529 filtering is performed.
13531 EXCEPTIONS is a vector of exceptions to which matching exceptions
13535 ada_add_global_exceptions (compiled_regex *preg,
13536 std::vector<ada_exc_info> *exceptions)
13538 /* In Ada, the symbol "search name" is a linkage name, whereas the
13539 regular expression used to do the matching refers to the natural
13540 name. So match against the decoded name. */
13541 expand_symtabs_matching (NULL,
13542 lookup_name_info::match_any (),
13543 [&] (const char *search_name)
13545 const char *decoded = ada_decode (search_name);
13546 return name_matches_regex (decoded, preg);
13551 for (objfile *objfile : current_program_space->objfiles ())
13553 for (compunit_symtab *s : objfile->compunits ())
13555 const struct blockvector *bv = COMPUNIT_BLOCKVECTOR (s);
13558 for (i = GLOBAL_BLOCK; i <= STATIC_BLOCK; i++)
13560 struct block *b = BLOCKVECTOR_BLOCK (bv, i);
13561 struct block_iterator iter;
13562 struct symbol *sym;
13564 ALL_BLOCK_SYMBOLS (b, iter, sym)
13565 if (ada_is_non_standard_exception_sym (sym)
13566 && name_matches_regex (SYMBOL_NATURAL_NAME (sym), preg))
13568 struct ada_exc_info info
13569 = {SYMBOL_PRINT_NAME (sym), SYMBOL_VALUE_ADDRESS (sym)};
13571 exceptions->push_back (info);
13578 /* Implements ada_exceptions_list with the regular expression passed
13579 as a regex_t, rather than a string.
13581 If not NULL, PREG is used to filter out exceptions whose names
13582 do not match. Otherwise, all exceptions are listed. */
13584 static std::vector<ada_exc_info>
13585 ada_exceptions_list_1 (compiled_regex *preg)
13587 std::vector<ada_exc_info> result;
13590 /* First, list the known standard exceptions. These exceptions
13591 need to be handled separately, as they are usually defined in
13592 runtime units that have been compiled without debugging info. */
13594 ada_add_standard_exceptions (preg, &result);
13596 /* Next, find all exceptions whose scope is local and accessible
13597 from the currently selected frame. */
13599 if (has_stack_frames ())
13601 prev_len = result.size ();
13602 ada_add_exceptions_from_frame (preg, get_selected_frame (NULL),
13604 if (result.size () > prev_len)
13605 sort_remove_dups_ada_exceptions_list (&result, prev_len);
13608 /* Add all exceptions whose scope is global. */
13610 prev_len = result.size ();
13611 ada_add_global_exceptions (preg, &result);
13612 if (result.size () > prev_len)
13613 sort_remove_dups_ada_exceptions_list (&result, prev_len);
13618 /* Return a vector of ada_exc_info.
13620 If REGEXP is NULL, all exceptions are included in the result.
13621 Otherwise, it should contain a valid regular expression,
13622 and only the exceptions whose names match that regular expression
13623 are included in the result.
13625 The exceptions are sorted in the following order:
13626 - Standard exceptions (defined by the Ada language), in
13627 alphabetical order;
13628 - Exceptions only visible from the current frame, in
13629 alphabetical order;
13630 - Exceptions whose scope is global, in alphabetical order. */
13632 std::vector<ada_exc_info>
13633 ada_exceptions_list (const char *regexp)
13635 if (regexp == NULL)
13636 return ada_exceptions_list_1 (NULL);
13638 compiled_regex reg (regexp, REG_NOSUB, _("invalid regular expression"));
13639 return ada_exceptions_list_1 (®);
13642 /* Implement the "info exceptions" command. */
13645 info_exceptions_command (const char *regexp, int from_tty)
13647 struct gdbarch *gdbarch = get_current_arch ();
13649 std::vector<ada_exc_info> exceptions = ada_exceptions_list (regexp);
13651 if (regexp != NULL)
13653 (_("All Ada exceptions matching regular expression \"%s\":\n"), regexp);
13655 printf_filtered (_("All defined Ada exceptions:\n"));
13657 for (const ada_exc_info &info : exceptions)
13658 printf_filtered ("%s: %s\n", info.name, paddress (gdbarch, info.addr));
13662 /* Information about operators given special treatment in functions
13664 /* Format: OP_DEFN (<operator>, <operator length>, <# args>, <binop>). */
13666 #define ADA_OPERATORS \
13667 OP_DEFN (OP_VAR_VALUE, 4, 0, 0) \
13668 OP_DEFN (BINOP_IN_BOUNDS, 3, 2, 0) \
13669 OP_DEFN (TERNOP_IN_RANGE, 1, 3, 0) \
13670 OP_DEFN (OP_ATR_FIRST, 1, 2, 0) \
13671 OP_DEFN (OP_ATR_LAST, 1, 2, 0) \
13672 OP_DEFN (OP_ATR_LENGTH, 1, 2, 0) \
13673 OP_DEFN (OP_ATR_IMAGE, 1, 2, 0) \
13674 OP_DEFN (OP_ATR_MAX, 1, 3, 0) \
13675 OP_DEFN (OP_ATR_MIN, 1, 3, 0) \
13676 OP_DEFN (OP_ATR_MODULUS, 1, 1, 0) \
13677 OP_DEFN (OP_ATR_POS, 1, 2, 0) \
13678 OP_DEFN (OP_ATR_SIZE, 1, 1, 0) \
13679 OP_DEFN (OP_ATR_TAG, 1, 1, 0) \
13680 OP_DEFN (OP_ATR_VAL, 1, 2, 0) \
13681 OP_DEFN (UNOP_QUAL, 3, 1, 0) \
13682 OP_DEFN (UNOP_IN_RANGE, 3, 1, 0) \
13683 OP_DEFN (OP_OTHERS, 1, 1, 0) \
13684 OP_DEFN (OP_POSITIONAL, 3, 1, 0) \
13685 OP_DEFN (OP_DISCRETE_RANGE, 1, 2, 0)
13688 ada_operator_length (const struct expression *exp, int pc, int *oplenp,
13691 switch (exp->elts[pc - 1].opcode)
13694 operator_length_standard (exp, pc, oplenp, argsp);
13697 #define OP_DEFN(op, len, args, binop) \
13698 case op: *oplenp = len; *argsp = args; break;
13704 *argsp = longest_to_int (exp->elts[pc - 2].longconst);
13709 *argsp = longest_to_int (exp->elts[pc - 2].longconst) + 1;
13714 /* Implementation of the exp_descriptor method operator_check. */
13717 ada_operator_check (struct expression *exp, int pos,
13718 int (*objfile_func) (struct objfile *objfile, void *data),
13721 const union exp_element *const elts = exp->elts;
13722 struct type *type = NULL;
13724 switch (elts[pos].opcode)
13726 case UNOP_IN_RANGE:
13728 type = elts[pos + 1].type;
13732 return operator_check_standard (exp, pos, objfile_func, data);
13735 /* Invoke callbacks for TYPE and OBJFILE if they were set as non-NULL. */
13737 if (type && TYPE_OBJFILE (type)
13738 && (*objfile_func) (TYPE_OBJFILE (type), data))
13744 static const char *
13745 ada_op_name (enum exp_opcode opcode)
13750 return op_name_standard (opcode);
13752 #define OP_DEFN(op, len, args, binop) case op: return #op;
13757 return "OP_AGGREGATE";
13759 return "OP_CHOICES";
13765 /* As for operator_length, but assumes PC is pointing at the first
13766 element of the operator, and gives meaningful results only for the
13767 Ada-specific operators, returning 0 for *OPLENP and *ARGSP otherwise. */
13770 ada_forward_operator_length (struct expression *exp, int pc,
13771 int *oplenp, int *argsp)
13773 switch (exp->elts[pc].opcode)
13776 *oplenp = *argsp = 0;
13779 #define OP_DEFN(op, len, args, binop) \
13780 case op: *oplenp = len; *argsp = args; break;
13786 *argsp = longest_to_int (exp->elts[pc + 1].longconst);
13791 *argsp = longest_to_int (exp->elts[pc + 1].longconst) + 1;
13797 int len = longest_to_int (exp->elts[pc + 1].longconst);
13799 *oplenp = 4 + BYTES_TO_EXP_ELEM (len + 1);
13807 ada_dump_subexp_body (struct expression *exp, struct ui_file *stream, int elt)
13809 enum exp_opcode op = exp->elts[elt].opcode;
13814 ada_forward_operator_length (exp, elt, &oplen, &nargs);
13818 /* Ada attributes ('Foo). */
13821 case OP_ATR_LENGTH:
13825 case OP_ATR_MODULUS:
13832 case UNOP_IN_RANGE:
13834 /* XXX: gdb_sprint_host_address, type_sprint */
13835 fprintf_filtered (stream, _("Type @"));
13836 gdb_print_host_address (exp->elts[pc + 1].type, stream);
13837 fprintf_filtered (stream, " (");
13838 type_print (exp->elts[pc + 1].type, NULL, stream, 0);
13839 fprintf_filtered (stream, ")");
13841 case BINOP_IN_BOUNDS:
13842 fprintf_filtered (stream, " (%d)",
13843 longest_to_int (exp->elts[pc + 2].longconst));
13845 case TERNOP_IN_RANGE:
13850 case OP_DISCRETE_RANGE:
13851 case OP_POSITIONAL:
13858 char *name = &exp->elts[elt + 2].string;
13859 int len = longest_to_int (exp->elts[elt + 1].longconst);
13861 fprintf_filtered (stream, "Text: `%.*s'", len, name);
13866 return dump_subexp_body_standard (exp, stream, elt);
13870 for (i = 0; i < nargs; i += 1)
13871 elt = dump_subexp (exp, stream, elt);
13876 /* The Ada extension of print_subexp (q.v.). */
13879 ada_print_subexp (struct expression *exp, int *pos,
13880 struct ui_file *stream, enum precedence prec)
13882 int oplen, nargs, i;
13884 enum exp_opcode op = exp->elts[pc].opcode;
13886 ada_forward_operator_length (exp, pc, &oplen, &nargs);
13893 print_subexp_standard (exp, pos, stream, prec);
13897 fputs_filtered (SYMBOL_NATURAL_NAME (exp->elts[pc + 2].symbol), stream);
13900 case BINOP_IN_BOUNDS:
13901 /* XXX: sprint_subexp */
13902 print_subexp (exp, pos, stream, PREC_SUFFIX);
13903 fputs_filtered (" in ", stream);
13904 print_subexp (exp, pos, stream, PREC_SUFFIX);
13905 fputs_filtered ("'range", stream);
13906 if (exp->elts[pc + 1].longconst > 1)
13907 fprintf_filtered (stream, "(%ld)",
13908 (long) exp->elts[pc + 1].longconst);
13911 case TERNOP_IN_RANGE:
13912 if (prec >= PREC_EQUAL)
13913 fputs_filtered ("(", stream);
13914 /* XXX: sprint_subexp */
13915 print_subexp (exp, pos, stream, PREC_SUFFIX);
13916 fputs_filtered (" in ", stream);
13917 print_subexp (exp, pos, stream, PREC_EQUAL);
13918 fputs_filtered (" .. ", stream);
13919 print_subexp (exp, pos, stream, PREC_EQUAL);
13920 if (prec >= PREC_EQUAL)
13921 fputs_filtered (")", stream);
13926 case OP_ATR_LENGTH:
13930 case OP_ATR_MODULUS:
13935 if (exp->elts[*pos].opcode == OP_TYPE)
13937 if (TYPE_CODE (exp->elts[*pos + 1].type) != TYPE_CODE_VOID)
13938 LA_PRINT_TYPE (exp->elts[*pos + 1].type, "", stream, 0, 0,
13939 &type_print_raw_options);
13943 print_subexp (exp, pos, stream, PREC_SUFFIX);
13944 fprintf_filtered (stream, "'%s", ada_attribute_name (op));
13949 for (tem = 1; tem < nargs; tem += 1)
13951 fputs_filtered ((tem == 1) ? " (" : ", ", stream);
13952 print_subexp (exp, pos, stream, PREC_ABOVE_COMMA);
13954 fputs_filtered (")", stream);
13959 type_print (exp->elts[pc + 1].type, "", stream, 0);
13960 fputs_filtered ("'(", stream);
13961 print_subexp (exp, pos, stream, PREC_PREFIX);
13962 fputs_filtered (")", stream);
13965 case UNOP_IN_RANGE:
13966 /* XXX: sprint_subexp */
13967 print_subexp (exp, pos, stream, PREC_SUFFIX);
13968 fputs_filtered (" in ", stream);
13969 LA_PRINT_TYPE (exp->elts[pc + 1].type, "", stream, 1, 0,
13970 &type_print_raw_options);
13973 case OP_DISCRETE_RANGE:
13974 print_subexp (exp, pos, stream, PREC_SUFFIX);
13975 fputs_filtered ("..", stream);
13976 print_subexp (exp, pos, stream, PREC_SUFFIX);
13980 fputs_filtered ("others => ", stream);
13981 print_subexp (exp, pos, stream, PREC_SUFFIX);
13985 for (i = 0; i < nargs-1; i += 1)
13988 fputs_filtered ("|", stream);
13989 print_subexp (exp, pos, stream, PREC_SUFFIX);
13991 fputs_filtered (" => ", stream);
13992 print_subexp (exp, pos, stream, PREC_SUFFIX);
13995 case OP_POSITIONAL:
13996 print_subexp (exp, pos, stream, PREC_SUFFIX);
14000 fputs_filtered ("(", stream);
14001 for (i = 0; i < nargs; i += 1)
14004 fputs_filtered (", ", stream);
14005 print_subexp (exp, pos, stream, PREC_SUFFIX);
14007 fputs_filtered (")", stream);
14012 /* Table mapping opcodes into strings for printing operators
14013 and precedences of the operators. */
14015 static const struct op_print ada_op_print_tab[] = {
14016 {":=", BINOP_ASSIGN, PREC_ASSIGN, 1},
14017 {"or else", BINOP_LOGICAL_OR, PREC_LOGICAL_OR, 0},
14018 {"and then", BINOP_LOGICAL_AND, PREC_LOGICAL_AND, 0},
14019 {"or", BINOP_BITWISE_IOR, PREC_BITWISE_IOR, 0},
14020 {"xor", BINOP_BITWISE_XOR, PREC_BITWISE_XOR, 0},
14021 {"and", BINOP_BITWISE_AND, PREC_BITWISE_AND, 0},
14022 {"=", BINOP_EQUAL, PREC_EQUAL, 0},
14023 {"/=", BINOP_NOTEQUAL, PREC_EQUAL, 0},
14024 {"<=", BINOP_LEQ, PREC_ORDER, 0},
14025 {">=", BINOP_GEQ, PREC_ORDER, 0},
14026 {">", BINOP_GTR, PREC_ORDER, 0},
14027 {"<", BINOP_LESS, PREC_ORDER, 0},
14028 {">>", BINOP_RSH, PREC_SHIFT, 0},
14029 {"<<", BINOP_LSH, PREC_SHIFT, 0},
14030 {"+", BINOP_ADD, PREC_ADD, 0},
14031 {"-", BINOP_SUB, PREC_ADD, 0},
14032 {"&", BINOP_CONCAT, PREC_ADD, 0},
14033 {"*", BINOP_MUL, PREC_MUL, 0},
14034 {"/", BINOP_DIV, PREC_MUL, 0},
14035 {"rem", BINOP_REM, PREC_MUL, 0},
14036 {"mod", BINOP_MOD, PREC_MUL, 0},
14037 {"**", BINOP_EXP, PREC_REPEAT, 0},
14038 {"@", BINOP_REPEAT, PREC_REPEAT, 0},
14039 {"-", UNOP_NEG, PREC_PREFIX, 0},
14040 {"+", UNOP_PLUS, PREC_PREFIX, 0},
14041 {"not ", UNOP_LOGICAL_NOT, PREC_PREFIX, 0},
14042 {"not ", UNOP_COMPLEMENT, PREC_PREFIX, 0},
14043 {"abs ", UNOP_ABS, PREC_PREFIX, 0},
14044 {".all", UNOP_IND, PREC_SUFFIX, 1},
14045 {"'access", UNOP_ADDR, PREC_SUFFIX, 1},
14046 {"'size", OP_ATR_SIZE, PREC_SUFFIX, 1},
14047 {NULL, OP_NULL, PREC_SUFFIX, 0}
14050 enum ada_primitive_types {
14051 ada_primitive_type_int,
14052 ada_primitive_type_long,
14053 ada_primitive_type_short,
14054 ada_primitive_type_char,
14055 ada_primitive_type_float,
14056 ada_primitive_type_double,
14057 ada_primitive_type_void,
14058 ada_primitive_type_long_long,
14059 ada_primitive_type_long_double,
14060 ada_primitive_type_natural,
14061 ada_primitive_type_positive,
14062 ada_primitive_type_system_address,
14063 ada_primitive_type_storage_offset,
14064 nr_ada_primitive_types
14068 ada_language_arch_info (struct gdbarch *gdbarch,
14069 struct language_arch_info *lai)
14071 const struct builtin_type *builtin = builtin_type (gdbarch);
14073 lai->primitive_type_vector
14074 = GDBARCH_OBSTACK_CALLOC (gdbarch, nr_ada_primitive_types + 1,
14077 lai->primitive_type_vector [ada_primitive_type_int]
14078 = arch_integer_type (gdbarch, gdbarch_int_bit (gdbarch),
14080 lai->primitive_type_vector [ada_primitive_type_long]
14081 = arch_integer_type (gdbarch, gdbarch_long_bit (gdbarch),
14082 0, "long_integer");
14083 lai->primitive_type_vector [ada_primitive_type_short]
14084 = arch_integer_type (gdbarch, gdbarch_short_bit (gdbarch),
14085 0, "short_integer");
14086 lai->string_char_type
14087 = lai->primitive_type_vector [ada_primitive_type_char]
14088 = arch_character_type (gdbarch, TARGET_CHAR_BIT, 0, "character");
14089 lai->primitive_type_vector [ada_primitive_type_float]
14090 = arch_float_type (gdbarch, gdbarch_float_bit (gdbarch),
14091 "float", gdbarch_float_format (gdbarch));
14092 lai->primitive_type_vector [ada_primitive_type_double]
14093 = arch_float_type (gdbarch, gdbarch_double_bit (gdbarch),
14094 "long_float", gdbarch_double_format (gdbarch));
14095 lai->primitive_type_vector [ada_primitive_type_long_long]
14096 = arch_integer_type (gdbarch, gdbarch_long_long_bit (gdbarch),
14097 0, "long_long_integer");
14098 lai->primitive_type_vector [ada_primitive_type_long_double]
14099 = arch_float_type (gdbarch, gdbarch_long_double_bit (gdbarch),
14100 "long_long_float", gdbarch_long_double_format (gdbarch));
14101 lai->primitive_type_vector [ada_primitive_type_natural]
14102 = arch_integer_type (gdbarch, gdbarch_int_bit (gdbarch),
14104 lai->primitive_type_vector [ada_primitive_type_positive]
14105 = arch_integer_type (gdbarch, gdbarch_int_bit (gdbarch),
14107 lai->primitive_type_vector [ada_primitive_type_void]
14108 = builtin->builtin_void;
14110 lai->primitive_type_vector [ada_primitive_type_system_address]
14111 = lookup_pointer_type (arch_type (gdbarch, TYPE_CODE_VOID, TARGET_CHAR_BIT,
14113 TYPE_NAME (lai->primitive_type_vector [ada_primitive_type_system_address])
14114 = "system__address";
14116 /* Create the equivalent of the System.Storage_Elements.Storage_Offset
14117 type. This is a signed integral type whose size is the same as
14118 the size of addresses. */
14120 unsigned int addr_length = TYPE_LENGTH
14121 (lai->primitive_type_vector [ada_primitive_type_system_address]);
14123 lai->primitive_type_vector [ada_primitive_type_storage_offset]
14124 = arch_integer_type (gdbarch, addr_length * HOST_CHAR_BIT, 0,
14128 lai->bool_type_symbol = NULL;
14129 lai->bool_type_default = builtin->builtin_bool;
14132 /* Language vector */
14134 /* Not really used, but needed in the ada_language_defn. */
14137 emit_char (int c, struct type *type, struct ui_file *stream, int quoter)
14139 ada_emit_char (c, type, stream, quoter, 1);
14143 parse (struct parser_state *ps)
14145 warnings_issued = 0;
14146 return ada_parse (ps);
14149 static const struct exp_descriptor ada_exp_descriptor = {
14151 ada_operator_length,
14152 ada_operator_check,
14154 ada_dump_subexp_body,
14155 ada_evaluate_subexp
14158 /* symbol_name_matcher_ftype adapter for wild_match. */
14161 do_wild_match (const char *symbol_search_name,
14162 const lookup_name_info &lookup_name,
14163 completion_match_result *comp_match_res)
14165 return wild_match (symbol_search_name, ada_lookup_name (lookup_name));
14168 /* symbol_name_matcher_ftype adapter for full_match. */
14171 do_full_match (const char *symbol_search_name,
14172 const lookup_name_info &lookup_name,
14173 completion_match_result *comp_match_res)
14175 return full_match (symbol_search_name, ada_lookup_name (lookup_name));
14178 /* symbol_name_matcher_ftype for exact (verbatim) matches. */
14181 do_exact_match (const char *symbol_search_name,
14182 const lookup_name_info &lookup_name,
14183 completion_match_result *comp_match_res)
14185 return strcmp (symbol_search_name, ada_lookup_name (lookup_name)) == 0;
14188 /* Build the Ada lookup name for LOOKUP_NAME. */
14190 ada_lookup_name_info::ada_lookup_name_info (const lookup_name_info &lookup_name)
14192 const std::string &user_name = lookup_name.name ();
14194 if (user_name[0] == '<')
14196 if (user_name.back () == '>')
14197 m_encoded_name = user_name.substr (1, user_name.size () - 2);
14199 m_encoded_name = user_name.substr (1, user_name.size () - 1);
14200 m_encoded_p = true;
14201 m_verbatim_p = true;
14202 m_wild_match_p = false;
14203 m_standard_p = false;
14207 m_verbatim_p = false;
14209 m_encoded_p = user_name.find ("__") != std::string::npos;
14213 const char *folded = ada_fold_name (user_name.c_str ());
14214 const char *encoded = ada_encode_1 (folded, false);
14215 if (encoded != NULL)
14216 m_encoded_name = encoded;
14218 m_encoded_name = user_name;
14221 m_encoded_name = user_name;
14223 /* Handle the 'package Standard' special case. See description
14224 of m_standard_p. */
14225 if (startswith (m_encoded_name.c_str (), "standard__"))
14227 m_encoded_name = m_encoded_name.substr (sizeof ("standard__") - 1);
14228 m_standard_p = true;
14231 m_standard_p = false;
14233 /* If the name contains a ".", then the user is entering a fully
14234 qualified entity name, and the match must not be done in wild
14235 mode. Similarly, if the user wants to complete what looks
14236 like an encoded name, the match must not be done in wild
14237 mode. Also, in the standard__ special case always do
14238 non-wild matching. */
14240 = (lookup_name.match_type () != symbol_name_match_type::FULL
14243 && user_name.find ('.') == std::string::npos);
14247 /* symbol_name_matcher_ftype method for Ada. This only handles
14248 completion mode. */
14251 ada_symbol_name_matches (const char *symbol_search_name,
14252 const lookup_name_info &lookup_name,
14253 completion_match_result *comp_match_res)
14255 return lookup_name.ada ().matches (symbol_search_name,
14256 lookup_name.match_type (),
14260 /* A name matcher that matches the symbol name exactly, with
14264 literal_symbol_name_matcher (const char *symbol_search_name,
14265 const lookup_name_info &lookup_name,
14266 completion_match_result *comp_match_res)
14268 const std::string &name = lookup_name.name ();
14270 int cmp = (lookup_name.completion_mode ()
14271 ? strncmp (symbol_search_name, name.c_str (), name.size ())
14272 : strcmp (symbol_search_name, name.c_str ()));
14275 if (comp_match_res != NULL)
14276 comp_match_res->set_match (symbol_search_name);
14283 /* Implement the "la_get_symbol_name_matcher" language_defn method for
14286 static symbol_name_matcher_ftype *
14287 ada_get_symbol_name_matcher (const lookup_name_info &lookup_name)
14289 if (lookup_name.match_type () == symbol_name_match_type::SEARCH_NAME)
14290 return literal_symbol_name_matcher;
14292 if (lookup_name.completion_mode ())
14293 return ada_symbol_name_matches;
14296 if (lookup_name.ada ().wild_match_p ())
14297 return do_wild_match;
14298 else if (lookup_name.ada ().verbatim_p ())
14299 return do_exact_match;
14301 return do_full_match;
14305 /* Implement the "la_read_var_value" language_defn method for Ada. */
14307 static struct value *
14308 ada_read_var_value (struct symbol *var, const struct block *var_block,
14309 struct frame_info *frame)
14311 const struct block *frame_block = NULL;
14312 struct symbol *renaming_sym = NULL;
14314 /* The only case where default_read_var_value is not sufficient
14315 is when VAR is a renaming... */
14317 frame_block = get_frame_block (frame, NULL);
14319 renaming_sym = ada_find_renaming_symbol (var, frame_block);
14320 if (renaming_sym != NULL)
14321 return ada_read_renaming_var_value (renaming_sym, frame_block);
14323 /* This is a typical case where we expect the default_read_var_value
14324 function to work. */
14325 return default_read_var_value (var, var_block, frame);
14328 static const char *ada_extensions[] =
14330 ".adb", ".ads", ".a", ".ada", ".dg", NULL
14333 extern const struct language_defn ada_language_defn = {
14334 "ada", /* Language name */
14338 case_sensitive_on, /* Yes, Ada is case-insensitive, but
14339 that's not quite what this means. */
14341 macro_expansion_no,
14343 &ada_exp_descriptor,
14346 ada_printchar, /* Print a character constant */
14347 ada_printstr, /* Function to print string constant */
14348 emit_char, /* Function to print single char (not used) */
14349 ada_print_type, /* Print a type using appropriate syntax */
14350 ada_print_typedef, /* Print a typedef using appropriate syntax */
14351 ada_val_print, /* Print a value using appropriate syntax */
14352 ada_value_print, /* Print a top-level value */
14353 ada_read_var_value, /* la_read_var_value */
14354 NULL, /* Language specific skip_trampoline */
14355 NULL, /* name_of_this */
14356 true, /* la_store_sym_names_in_linkage_form_p */
14357 ada_lookup_symbol_nonlocal, /* Looking up non-local symbols. */
14358 basic_lookup_transparent_type, /* lookup_transparent_type */
14359 ada_la_decode, /* Language specific symbol demangler */
14360 ada_sniff_from_mangled_name,
14361 NULL, /* Language specific
14362 class_name_from_physname */
14363 ada_op_print_tab, /* expression operators for printing */
14364 0, /* c-style arrays */
14365 1, /* String lower bound */
14366 ada_get_gdb_completer_word_break_characters,
14367 ada_collect_symbol_completion_matches,
14368 ada_language_arch_info,
14369 ada_print_array_index,
14370 default_pass_by_reference,
14372 ada_watch_location_expression,
14373 ada_get_symbol_name_matcher, /* la_get_symbol_name_matcher */
14374 ada_iterate_over_symbols,
14375 default_search_name_hash,
14382 /* Command-list for the "set/show ada" prefix command. */
14383 static struct cmd_list_element *set_ada_list;
14384 static struct cmd_list_element *show_ada_list;
14386 /* Implement the "set ada" prefix command. */
14389 set_ada_command (const char *arg, int from_tty)
14391 printf_unfiltered (_(\
14392 "\"set ada\" must be followed by the name of a setting.\n"));
14393 help_list (set_ada_list, "set ada ", all_commands, gdb_stdout);
14396 /* Implement the "show ada" prefix command. */
14399 show_ada_command (const char *args, int from_tty)
14401 cmd_show_list (show_ada_list, from_tty, "");
14405 initialize_ada_catchpoint_ops (void)
14407 struct breakpoint_ops *ops;
14409 initialize_breakpoint_ops ();
14411 ops = &catch_exception_breakpoint_ops;
14412 *ops = bkpt_breakpoint_ops;
14413 ops->allocate_location = allocate_location_catch_exception;
14414 ops->re_set = re_set_catch_exception;
14415 ops->check_status = check_status_catch_exception;
14416 ops->print_it = print_it_catch_exception;
14417 ops->print_one = print_one_catch_exception;
14418 ops->print_mention = print_mention_catch_exception;
14419 ops->print_recreate = print_recreate_catch_exception;
14421 ops = &catch_exception_unhandled_breakpoint_ops;
14422 *ops = bkpt_breakpoint_ops;
14423 ops->allocate_location = allocate_location_catch_exception_unhandled;
14424 ops->re_set = re_set_catch_exception_unhandled;
14425 ops->check_status = check_status_catch_exception_unhandled;
14426 ops->print_it = print_it_catch_exception_unhandled;
14427 ops->print_one = print_one_catch_exception_unhandled;
14428 ops->print_mention = print_mention_catch_exception_unhandled;
14429 ops->print_recreate = print_recreate_catch_exception_unhandled;
14431 ops = &catch_assert_breakpoint_ops;
14432 *ops = bkpt_breakpoint_ops;
14433 ops->allocate_location = allocate_location_catch_assert;
14434 ops->re_set = re_set_catch_assert;
14435 ops->check_status = check_status_catch_assert;
14436 ops->print_it = print_it_catch_assert;
14437 ops->print_one = print_one_catch_assert;
14438 ops->print_mention = print_mention_catch_assert;
14439 ops->print_recreate = print_recreate_catch_assert;
14441 ops = &catch_handlers_breakpoint_ops;
14442 *ops = bkpt_breakpoint_ops;
14443 ops->allocate_location = allocate_location_catch_handlers;
14444 ops->re_set = re_set_catch_handlers;
14445 ops->check_status = check_status_catch_handlers;
14446 ops->print_it = print_it_catch_handlers;
14447 ops->print_one = print_one_catch_handlers;
14448 ops->print_mention = print_mention_catch_handlers;
14449 ops->print_recreate = print_recreate_catch_handlers;
14452 /* This module's 'new_objfile' observer. */
14455 ada_new_objfile_observer (struct objfile *objfile)
14457 ada_clear_symbol_cache ();
14460 /* This module's 'free_objfile' observer. */
14463 ada_free_objfile_observer (struct objfile *objfile)
14465 ada_clear_symbol_cache ();
14469 _initialize_ada_language (void)
14471 initialize_ada_catchpoint_ops ();
14473 add_prefix_cmd ("ada", no_class, set_ada_command,
14474 _("Prefix command for changing Ada-specific settings"),
14475 &set_ada_list, "set ada ", 0, &setlist);
14477 add_prefix_cmd ("ada", no_class, show_ada_command,
14478 _("Generic command for showing Ada-specific settings."),
14479 &show_ada_list, "show ada ", 0, &showlist);
14481 add_setshow_boolean_cmd ("trust-PAD-over-XVS", class_obscure,
14482 &trust_pad_over_xvs, _("\
14483 Enable or disable an optimization trusting PAD types over XVS types"), _("\
14484 Show whether an optimization trusting PAD types over XVS types is activated"),
14486 This is related to the encoding used by the GNAT compiler. The debugger\n\
14487 should normally trust the contents of PAD types, but certain older versions\n\
14488 of GNAT have a bug that sometimes causes the information in the PAD type\n\
14489 to be incorrect. Turning this setting \"off\" allows the debugger to\n\
14490 work around this bug. It is always safe to turn this option \"off\", but\n\
14491 this incurs a slight performance penalty, so it is recommended to NOT change\n\
14492 this option to \"off\" unless necessary."),
14493 NULL, NULL, &set_ada_list, &show_ada_list);
14495 add_setshow_boolean_cmd ("print-signatures", class_vars,
14496 &print_signatures, _("\
14497 Enable or disable the output of formal and return types for functions in the \
14498 overloads selection menu"), _("\
14499 Show whether the output of formal and return types for functions in the \
14500 overloads selection menu is activated"),
14501 NULL, NULL, NULL, &set_ada_list, &show_ada_list);
14503 add_catch_command ("exception", _("\
14504 Catch Ada exceptions, when raised.\n\
14505 Usage: catch exception [ ARG ]\n\
14507 Without any argument, stop when any Ada exception is raised.\n\
14508 If ARG is \"unhandled\" (without the quotes), only stop when the exception\n\
14509 being raised does not have a handler (and will therefore lead to the task's\n\
14511 Otherwise, the catchpoint only stops when the name of the exception being\n\
14512 raised is the same as ARG."),
14513 catch_ada_exception_command,
14518 add_catch_command ("handlers", _("\
14519 Catch Ada exceptions, when handled.\n\
14520 With an argument, catch only exceptions with the given name."),
14521 catch_ada_handlers_command,
14525 add_catch_command ("assert", _("\
14526 Catch failed Ada assertions, when raised.\n\
14527 With an argument, catch only exceptions with the given name."),
14528 catch_assert_command,
14533 varsize_limit = 65536;
14534 add_setshow_uinteger_cmd ("varsize-limit", class_support,
14535 &varsize_limit, _("\
14536 Set the maximum number of bytes allowed in a variable-size object."), _("\
14537 Show the maximum number of bytes allowed in a variable-size object."), _("\
14538 Attempts to access an object whose size is not a compile-time constant\n\
14539 and exceeds this limit will cause an error."),
14540 NULL, NULL, &setlist, &showlist);
14542 add_info ("exceptions", info_exceptions_command,
14544 List all Ada exception names.\n\
14545 If a regular expression is passed as an argument, only those matching\n\
14546 the regular expression are listed."));
14548 add_prefix_cmd ("ada", class_maintenance, maint_set_ada_cmd,
14549 _("Set Ada maintenance-related variables."),
14550 &maint_set_ada_cmdlist, "maintenance set ada ",
14551 0/*allow-unknown*/, &maintenance_set_cmdlist);
14553 add_prefix_cmd ("ada", class_maintenance, maint_show_ada_cmd,
14554 _("Show Ada maintenance-related variables"),
14555 &maint_show_ada_cmdlist, "maintenance show ada ",
14556 0/*allow-unknown*/, &maintenance_show_cmdlist);
14558 add_setshow_boolean_cmd
14559 ("ignore-descriptive-types", class_maintenance,
14560 &ada_ignore_descriptive_types_p,
14561 _("Set whether descriptive types generated by GNAT should be ignored."),
14562 _("Show whether descriptive types generated by GNAT should be ignored."),
14564 When enabled, the debugger will stop using the DW_AT_GNAT_descriptive_type\n\
14565 DWARF attribute."),
14566 NULL, NULL, &maint_set_ada_cmdlist, &maint_show_ada_cmdlist);
14568 decoded_names_store = htab_create_alloc (256, htab_hash_string, streq_hash,
14569 NULL, xcalloc, xfree);
14571 /* The ada-lang observers. */
14572 gdb::observers::new_objfile.attach (ada_new_objfile_observer);
14573 gdb::observers::free_objfile.attach (ada_free_objfile_observer);
14574 gdb::observers::inferior_exit.attach (ada_inferior_exit);
14576 /* Setup various context-specific data. */
14578 = register_inferior_data_with_cleanup (NULL, ada_inferior_data_cleanup);
14579 ada_pspace_data_handle
14580 = register_program_space_data_with_cleanup (NULL, ada_pspace_data_cleanup);