gdb/language.c

   1 /* Multiple source language support for GDB.
   2
   3    Copyright (C) 1991-2017 Free Software Foundation, Inc.
   4
   5    Contributed by the Department of Computer Science at the State University
   6    of New York at Buffalo.
   7
   8    This file is part of GDB.
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 3 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  22
  23 /* This file contains functions that return things that are specific
  24    to languages.  Each function should examine current_language if necessary,
  25    and return the appropriate result.  */
  26
  27 /* FIXME:  Most of these would be better organized as macros which
  28    return data out of a "language-specific" struct pointer that is set
  29    whenever the working language changes.  That would be a lot faster.  */
  30
  31 #include "defs.h"
  32 #include <ctype.h>
  33 #include "symtab.h"
  34 #include "gdbtypes.h"
  35 #include "value.h"
  36 #include "gdbcmd.h"
  37 #include "expression.h"
  38 #include "language.h"
  39 #include "varobj.h"
  40 #include "target.h"
  41 #include "parser-defs.h"
  42 #include "demangle.h"
  43 #include "symfile.h"
  44 #include "cp-support.h"
  45 #include "frame.h"
  46 #include "c-lang.h"
  47 #include <algorithm>
  48
  49 static void unk_lang_error (const char *);
  50
  51 static int unk_lang_parser (struct parser_state *);
  52
  53 static void set_range_case (void);
  54
  55 static void unk_lang_emit_char (int c, struct type *type,
  56                                 struct ui_file *stream, int quoter);
  57
  58 static void unk_lang_printchar (int c, struct type *type,
  59                                 struct ui_file *stream);
  60
  61 static void unk_lang_value_print (struct value *, struct ui_file *,
  62                                   const struct value_print_options *);
  63
  64 static CORE_ADDR unk_lang_trampoline (struct frame_info *, CORE_ADDR pc);
  65
  66 /* Forward declaration */
  67 extern const struct language_defn unknown_language_defn;
  68
  69 /* The current (default at startup) state of type and range checking.
  70    (If the modes are set to "auto", though, these are changed based
  71    on the default language at startup, and then again based on the
  72    language of the first source file.  */
  73
  74 enum range_mode range_mode = range_mode_auto;
  75 enum range_check range_check = range_check_off;
  76 enum case_mode case_mode = case_mode_auto;
  77 enum case_sensitivity case_sensitivity = case_sensitive_on;
  78
  79 /* The current language and language_mode (see language.h).  */
  80
  81 const struct language_defn *current_language = &unknown_language_defn;
  82 enum language_mode language_mode = language_mode_auto;
  83
  84 /* The language that the user expects to be typing in (the language
  85    of main(), or the last language we notified them about, or C).  */
  86
  87 const struct language_defn *expected_language;
  88
  89 /* The list of supported languages.  Keep this in the same order as
  90    the 'enum language' values.  */
  91
  92 static const struct language_defn *languages[] = {
  93   &unknown_language_defn,
  94   &auto_language_defn,
  95   &c_language_defn,
  96   &objc_language_defn,
  97   &cplus_language_defn,
  98   &d_language_defn,
  99   &go_language_defn,
 100   &f_language_defn,
 101   &m2_language_defn,
 102   &asm_language_defn,
 103   &pascal_language_defn,
 104   &opencl_language_defn,
 105   &rust_language_defn,
 106   &minimal_language_defn,
 107   &ada_language_defn,
 108 };
 109
 110 /* The current values of the "set language/type/range" enum
 111    commands.  */
 112 static const char *language;
 113 static const char *type;
 114 static const char *range;
 115 static const char *case_sensitive;
 116
 117 /* Warning issued when current_language and the language of the current
 118    frame do not match.  */
 119 char lang_frame_mismatch_warn[] =
 120 "Warning: the current language does not match this frame.";
 121 \f
 122 /* This page contains the functions corresponding to GDB commands
 123    and their helpers.  */
 124
 125 /* Show command.  Display a warning if the language set
 126    does not match the frame.  */
 127 static void
 128 show_language_command (struct ui_file *file, int from_tty,
 129                        struct cmd_list_element *c, const char *value)
 130 {
 131   enum language flang;          /* The language of the frame.  */
 132
 133   if (language_mode == language_mode_auto)
 134     fprintf_filtered (gdb_stdout,
 135                       _("The current source language is "
 136                         "\"auto; currently %s\".\n"),
 137                       current_language->la_name);
 138   else
 139     fprintf_filtered (gdb_stdout,
 140                       _("The current source language is \"%s\".\n"),
 141                       current_language->la_name);
 142
 143   if (has_stack_frames ())
 144     {
 145       struct frame_info *frame;
 146
 147       frame = get_selected_frame (NULL);
 148       flang = get_frame_language (frame);
 149       if (flang != language_unknown
 150           && language_mode == language_mode_manual
 151           && current_language->la_language != flang)
 152         printf_filtered ("%s\n", lang_frame_mismatch_warn);
 153     }
 154 }
 155
 156 /* Set command.  Change the current working language.  */
 157 static void
 158 set_language_command (const char *ignore,
 159                       int from_tty, struct cmd_list_element *c)
 160 {
 161   enum language flang = language_unknown;
 162
 163   /* "local" is a synonym of "auto".  */
 164   if (strcmp (language, "local") == 0)
 165     language = "auto";
 166
 167   /* Search the list of languages for a match.  */
 168   for (const auto &lang : languages)
 169     {
 170       if (strcmp (lang->la_name, language) == 0)
 171         {
 172           /* Found it!  Go into manual mode, and use this language.  */
 173           if (lang->la_language == language_auto)
 174             {
 175               /* Enter auto mode.  Set to the current frame's language, if
 176                  known, or fallback to the initial language.  */
 177               language_mode = language_mode_auto;
 178               TRY
 179                 {
 180                   struct frame_info *frame;
 181
 182                   frame = get_selected_frame (NULL);
 183                   flang = get_frame_language (frame);
 184                 }
 185               CATCH (ex, RETURN_MASK_ERROR)
 186                 {
 187                   flang = language_unknown;
 188                 }
 189               END_CATCH
 190
 191               if (flang != language_unknown)
 192                 set_language (flang);
 193               else
 194                 set_initial_language ();
 195               expected_language = current_language;
 196               return;
 197             }
 198           else
 199             {
 200               /* Enter manual mode.  Set the specified language.  */
 201               language_mode = language_mode_manual;
 202               current_language = lang;
 203               set_range_case ();
 204               expected_language = current_language;
 205               return;
 206             }
 207         }
 208     }
 209
 210   internal_error (__FILE__, __LINE__,
 211                   "Couldn't find language `%s' in known languages list.",
 212                   language);
 213 }
 214
 215 /* Show command.  Display a warning if the range setting does
 216    not match the current language.  */
 217 static void
 218 show_range_command (struct ui_file *file, int from_tty,
 219                     struct cmd_list_element *c, const char *value)
 220 {
 221   if (range_mode == range_mode_auto)
 222     {
 223       const char *tmp;
 224
 225       switch (range_check)
 226         {
 227         case range_check_on:
 228           tmp = "on";
 229           break;
 230         case range_check_off:
 231           tmp = "off";
 232           break;
 233         case range_check_warn:
 234           tmp = "warn";
 235           break;
 236         default:
 237           internal_error (__FILE__, __LINE__,
 238                           "Unrecognized range check setting.");
 239         }
 240
 241       fprintf_filtered (gdb_stdout,
 242                         _("Range checking is \"auto; currently %s\".\n"),
 243                         tmp);
 244     }
 245   else
 246     fprintf_filtered (gdb_stdout, _("Range checking is \"%s\".\n"),
 247                       value);
 248
 249   if (range_check != current_language->la_range_check)
 250     warning (_("the current range check setting "
 251                "does not match the language.\n"));
 252 }
 253
 254 /* Set command.  Change the setting for range checking.  */
 255 static void
 256 set_range_command (const char *ignore,
 257                    int from_tty, struct cmd_list_element *c)
 258 {
 259   if (strcmp (range, "on") == 0)
 260     {
 261       range_check = range_check_on;
 262       range_mode = range_mode_manual;
 263     }
 264   else if (strcmp (range, "warn") == 0)
 265     {
 266       range_check = range_check_warn;
 267       range_mode = range_mode_manual;
 268     }
 269   else if (strcmp (range, "off") == 0)
 270     {
 271       range_check = range_check_off;
 272       range_mode = range_mode_manual;
 273     }
 274   else if (strcmp (range, "auto") == 0)
 275     {
 276       range_mode = range_mode_auto;
 277       set_range_case ();
 278       return;
 279     }
 280   else
 281     {
 282       internal_error (__FILE__, __LINE__,
 283                       _("Unrecognized range check setting: \"%s\""), range);
 284     }
 285   if (range_check != current_language->la_range_check)
 286     warning (_("the current range check setting "
 287                "does not match the language.\n"));
 288 }
 289
 290 /* Show command.  Display a warning if the case sensitivity setting does
 291    not match the current language.  */
 292 static void
 293 show_case_command (struct ui_file *file, int from_tty,
 294                    struct cmd_list_element *c, const char *value)
 295 {
 296   if (case_mode == case_mode_auto)
 297     {
 298       const char *tmp = NULL;
 299
 300       switch (case_sensitivity)
 301         {
 302         case case_sensitive_on:
 303           tmp = "on";
 304           break;
 305         case case_sensitive_off:
 306           tmp = "off";
 307           break;
 308         default:
 309           internal_error (__FILE__, __LINE__,
 310                           "Unrecognized case-sensitive setting.");
 311         }
 312
 313       fprintf_filtered (gdb_stdout,
 314                         _("Case sensitivity in "
 315                           "name search is \"auto; currently %s\".\n"),
 316                         tmp);
 317     }
 318   else
 319     fprintf_filtered (gdb_stdout,
 320                       _("Case sensitivity in name search is \"%s\".\n"),
 321                       value);
 322
 323   if (case_sensitivity != current_language->la_case_sensitivity)
 324     warning (_("the current case sensitivity setting does not match "
 325                "the language.\n"));
 326 }
 327
 328 /* Set command.  Change the setting for case sensitivity.  */
 329
 330 static void
 331 set_case_command (const char *ignore, int from_tty, struct cmd_list_element *c)
 332 {
 333    if (strcmp (case_sensitive, "on") == 0)
 334      {
 335        case_sensitivity = case_sensitive_on;
 336        case_mode = case_mode_manual;
 337      }
 338    else if (strcmp (case_sensitive, "off") == 0)
 339      {
 340        case_sensitivity = case_sensitive_off;
 341        case_mode = case_mode_manual;
 342      }
 343    else if (strcmp (case_sensitive, "auto") == 0)
 344      {
 345        case_mode = case_mode_auto;
 346        set_range_case ();
 347        return;
 348      }
 349    else
 350      {
 351        internal_error (__FILE__, __LINE__,
 352                        "Unrecognized case-sensitive setting: \"%s\"",
 353                        case_sensitive);
 354      }
 355
 356    if (case_sensitivity != current_language->la_case_sensitivity)
 357      warning (_("the current case sensitivity setting does not match "
 358                 "the language.\n"));
 359 }
 360
 361 /* Set the status of range and type checking and case sensitivity based on
 362    the current modes and the current language.
 363    If SHOW is non-zero, then print out the current language,
 364    type and range checking status.  */
 365 static void
 366 set_range_case (void)
 367 {
 368   if (range_mode == range_mode_auto)
 369     range_check = current_language->la_range_check;
 370
 371   if (case_mode == case_mode_auto)
 372     case_sensitivity = current_language->la_case_sensitivity;
 373 }
 374
 375 /* Set current language to (enum language) LANG.  Returns previous
 376    language.  */
 377
 378 enum language
 379 set_language (enum language lang)
 380 {
 381   enum language prev_language;
 382
 383   prev_language = current_language->la_language;
 384   current_language = languages[lang];
 385   set_range_case ();
 386   return prev_language;
 387 }
 388 \f
 389
 390 /* Print out the current language settings: language, range and
 391    type checking.  If QUIETLY, print only what has changed.  */
 392
 393 void
 394 language_info (int quietly)
 395 {
 396   if (quietly && expected_language == current_language)
 397     return;
 398
 399   expected_language = current_language;
 400   printf_unfiltered (_("Current language:  %s\n"), language);
 401   show_language_command (NULL, 1, NULL, NULL);
 402
 403   if (!quietly)
 404     {
 405       printf_unfiltered (_("Range checking:    %s\n"), range);
 406       show_range_command (NULL, 1, NULL, NULL);
 407       printf_unfiltered (_("Case sensitivity:  %s\n"), case_sensitive);
 408       show_case_command (NULL, 1, NULL, NULL);
 409     }
 410 }
 411 \f
 412
 413 /* Returns non-zero if the value is a pointer type.  */
 414 int
 415 pointer_type (struct type *type)
 416 {
 417   return TYPE_CODE (type) == TYPE_CODE_PTR || TYPE_IS_REFERENCE (type);
 418 }
 419
 420 \f
 421 /* This page contains functions that return info about
 422    (struct value) values used in GDB.  */
 423
 424 /* Returns non-zero if the value VAL represents a true value.  */
 425 int
 426 value_true (struct value *val)
 427 {
 428   /* It is possible that we should have some sort of error if a non-boolean
 429      value is used in this context.  Possibly dependent on some kind of
 430      "boolean-checking" option like range checking.  But it should probably
 431      not depend on the language except insofar as is necessary to identify
 432      a "boolean" value (i.e. in C using a float, pointer, etc., as a boolean
 433      should be an error, probably).  */
 434   return !value_logical_not (val);
 435 }
 436 \f
 437 /* This page contains functions for the printing out of
 438    error messages that occur during type- and range-
 439    checking.  */
 440
 441 /* This is called when a language fails a range-check.  The
 442    first argument should be a printf()-style format string, and the
 443    rest of the arguments should be its arguments.  If range_check is
 444    range_check_on, an error is printed;  if range_check_warn, a warning;
 445    otherwise just the message.  */
 446
 447 void
 448 range_error (const char *string,...)
 449 {
 450   va_list args;
 451
 452   va_start (args, string);
 453   switch (range_check)
 454     {
 455     case range_check_warn:
 456       vwarning (string, args);
 457       break;
 458     case range_check_on:
 459       verror (string, args);
 460       break;
 461     case range_check_off:
 462       /* FIXME: cagney/2002-01-30: Should this function print anything
 463          when range error is off?  */
 464       vfprintf_filtered (gdb_stderr, string, args);
 465       fprintf_filtered (gdb_stderr, "\n");
 466       break;
 467     default:
 468       internal_error (__FILE__, __LINE__, _("bad switch"));
 469     }
 470   va_end (args);
 471 }
 472 \f
 473
 474 /* This page contains miscellaneous functions.  */
 475
 476 /* Return the language enum for a given language string.  */
 477
 478 enum language
 479 language_enum (const char *str)
 480 {
 481   for (const auto &lang : languages)
 482     if (strcmp (lang->la_name, str) == 0)
 483       return lang->la_language;
 484
 485   if (strcmp (str, "local") == 0)
 486     return language_auto;
 487
 488   return language_unknown;
 489 }
 490
 491 /* Return the language struct for a given language enum.  */
 492
 493 const struct language_defn *
 494 language_def (enum language lang)
 495 {
 496   return languages[lang];
 497 }
 498
 499 /* Return the language as a string.  */
 500
 501 const char *
 502 language_str (enum language lang)
 503 {
 504   return languages[lang]->la_name;
 505 }
 506
 507 static void
 508 set_check (const char *ignore, int from_tty)
 509 {
 510   printf_unfiltered (
 511      "\"set check\" must be followed by the name of a check subcommand.\n");
 512   help_list (setchecklist, "set check ", all_commands, gdb_stdout);
 513 }
 514
 515 static void
 516 show_check (const char *ignore, int from_tty)
 517 {
 518   cmd_show_list (showchecklist, from_tty, "");
 519 }
 520 \f
 521
 522 /* Build and install the "set language LANG" command.  */
 523
 524 static void
 525 add_set_language_command ()
 526 {
 527   static const char **language_names;
 528
 529   /* Build the language names array, to be used as enumeration in the
 530      "set language" enum command.  +1 for "local" and +1 for NULL
 531      termination.  */
 532   language_names = new const char *[ARRAY_SIZE (languages) + 2];
 533
 534   /* Display "auto", "local" and "unknown" first, and then the rest,
 535      alpha sorted.  */
 536   const char **language_names_p = language_names;
 537   *language_names_p++ = auto_language_defn.la_name;
 538   *language_names_p++ = "local";
 539   *language_names_p++ = unknown_language_defn.la_name;
 540   const char **sort_begin = language_names_p;
 541   for (const auto &lang : languages)
 542     {
 543       /* Already handled above.  */
 544       if (lang->la_language == language_auto
 545           || lang->la_language == language_unknown)
 546         continue;
 547       *language_names_p++ = lang->la_name;
 548     }
 549   *language_names_p = NULL;
 550   std::sort (sort_begin, language_names_p, compare_cstrings);
 551
 552   /* Add the filename extensions.  */
 553   for (const auto &lang : languages)
 554     if (lang->la_filename_extensions != NULL)
 555       {
 556         for (size_t i = 0; lang->la_filename_extensions[i] != NULL; ++i)
 557           add_filename_language (lang->la_filename_extensions[i],
 558                                  lang->la_language);
 559       }
 560
 561   /* Build the "help set language" docs.  */
 562   string_file doc;
 563
 564   doc.printf (_("Set the current source language.\n"
 565                 "The currently understood settings are:\n\nlocal or "
 566                 "auto    Automatic setting based on source file\n"));
 567
 568   for (const auto &lang : languages)
 569     {
 570       /* Already dealt with these above.  */
 571       if (lang->la_language == language_unknown
 572           || lang->la_language == language_auto)
 573         continue;
 574
 575       /* FIXME: i18n: for now assume that the human-readable name is
 576          just a capitalization of the internal name.  */
 577       doc.printf ("%-16s Use the %c%s language\n",
 578                   lang->la_name,
 579                   /* Capitalize first letter of language name.  */
 580                   toupper (lang->la_name[0]),
 581                   lang->la_name + 1);
 582     }
 583
 584   add_setshow_enum_cmd ("language", class_support,
 585                         language_names,
 586                         &language,
 587                         doc.c_str (),
 588                         _("Show the current source language."),
 589                         NULL, set_language_command,
 590                         show_language_command,
 591                         &setlist, &showlist);
 592 }
 593
 594 /* Iterate through all registered languages looking for and calling
 595    any non-NULL struct language_defn.skip_trampoline() functions.
 596    Return the result from the first that returns non-zero, or 0 if all
 597    `fail'.  */
 598 CORE_ADDR
 599 skip_language_trampoline (struct frame_info *frame, CORE_ADDR pc)
 600 {
 601   for (const auto &lang : languages)
 602     {
 603       if (lang->skip_trampoline != NULL)
 604         {
 605           CORE_ADDR real_pc = lang->skip_trampoline (frame, pc);
 606
 607           if (real_pc)
 608             return real_pc;
 609         }
 610     }
 611
 612   return 0;
 613 }
 614
 615 /* Return demangled language symbol, or NULL.
 616    FIXME: Options are only useful for certain languages and ignored
 617    by others, so it would be better to remove them here and have a
 618    more flexible demangler for the languages that need it.
 619    FIXME: Sometimes the demangler is invoked when we don't know the
 620    language, so we can't use this everywhere.  */
 621 char *
 622 language_demangle (const struct language_defn *current_language,
 623                                 const char *mangled, int options)
 624 {
 625   if (current_language != NULL && current_language->la_demangle)
 626     return current_language->la_demangle (mangled, options);
 627   return NULL;
 628 }
 629
 630 /* See langauge.h.  */
 631
 632 int
 633 language_sniff_from_mangled_name (const struct language_defn *lang,
 634                                   const char *mangled, char **demangled)
 635 {
 636   gdb_assert (lang != NULL);
 637
 638   if (lang->la_sniff_from_mangled_name == NULL)
 639     {
 640       *demangled = NULL;
 641       return 0;
 642     }
 643
 644   return lang->la_sniff_from_mangled_name (mangled, demangled);
 645 }
 646
 647 /* Return class name from physname or NULL.  */
 648 char *
 649 language_class_name_from_physname (const struct language_defn *lang,
 650                                    const char *physname)
 651 {
 652   if (lang != NULL && lang->la_class_name_from_physname)
 653     return lang->la_class_name_from_physname (physname);
 654   return NULL;
 655 }
 656
 657 /* Return non-zero if TYPE should be passed (and returned) by
 658    reference at the language level.  */
 659 int
 660 language_pass_by_reference (struct type *type)
 661 {
 662   return current_language->la_pass_by_reference (type);
 663 }
 664
 665 /* Return zero; by default, types are passed by value at the language
 666    level.  The target ABI may pass or return some structs by reference
 667    independent of this.  */
 668 int
 669 default_pass_by_reference (struct type *type)
 670 {
 671   return 0;
 672 }
 673
 674 /* Return the default string containing the list of characters
 675    delimiting words.  This is a reasonable default value that
 676    most languages should be able to use.  */
 677
 678 const char *
 679 default_word_break_characters (void)
 680 {
 681   return " \t\n!@#$%^&*()+=|~`}{[]\"';:?/>.<,-";
 682 }
 683
 684 /* Print the index of array elements using the C99 syntax.  */
 685
 686 void
 687 default_print_array_index (struct value *index_value, struct ui_file *stream,
 688                            const struct value_print_options *options)
 689 {
 690   fprintf_filtered (stream, "[");
 691   LA_VALUE_PRINT (index_value, stream, options);
 692   fprintf_filtered (stream, "] = ");
 693 }
 694
 695 void
 696 default_get_string (struct value *value, gdb_byte **buffer, int *length,
 697                     struct type **char_type, const char **charset)
 698 {
 699   error (_("Getting a string is unsupported in this language."));
 700 }
 701
 702 /* See language.h.  */
 703
 704 bool
 705 default_symbol_name_matcher (const char *symbol_search_name,
 706                              const lookup_name_info &lookup_name,
 707                              completion_match *match)
 708 {
 709   const std::string &name = lookup_name.name ();
 710
 711   strncmp_iw_mode mode = (lookup_name.completion_mode ()
 712                           ? strncmp_iw_mode::NORMAL
 713                           : strncmp_iw_mode::MATCH_PARAMS);
 714
 715   if (strncmp_iw_with_mode (symbol_search_name, name.c_str (), name.size (),
 716                             mode) == 0)
 717     {
 718       if (match != NULL)
 719         match->set_match (symbol_search_name);
 720       return true;
 721     }
 722   else
 723     return false;
 724 }
 725
 726 /* See language.h.  */
 727
 728 symbol_name_matcher_ftype *
 729 language_get_symbol_name_matcher (const language_defn *lang,
 730                                   const lookup_name_info &lookup_name)
 731 {
 732   if (lang->la_get_symbol_name_matcher != nullptr)
 733     return lang->la_get_symbol_name_matcher (lookup_name);
 734   return default_symbol_name_matcher;
 735 }
 736
 737 /* Define the language that is no language.  */
 738
 739 static int
 740 unk_lang_parser (struct parser_state *ps)
 741 {
 742   return 1;
 743 }
 744
 745 static void
 746 unk_lang_error (const char *msg)
 747 {
 748   error (_("Attempted to parse an expression with unknown language"));
 749 }
 750
 751 static void
 752 unk_lang_emit_char (int c, struct type *type, struct ui_file *stream,
 753                     int quoter)
 754 {
 755   error (_("internal error - unimplemented "
 756            "function unk_lang_emit_char called."));
 757 }
 758
 759 static void
 760 unk_lang_printchar (int c, struct type *type, struct ui_file *stream)
 761 {
 762   error (_("internal error - unimplemented "
 763            "function unk_lang_printchar called."));
 764 }
 765
 766 static void
 767 unk_lang_printstr (struct ui_file *stream, struct type *type,
 768                    const gdb_byte *string, unsigned int length,
 769                    const char *encoding, int force_ellipses,
 770                    const struct value_print_options *options)
 771 {
 772   error (_("internal error - unimplemented "
 773            "function unk_lang_printstr called."));
 774 }
 775
 776 static void
 777 unk_lang_print_type (struct type *type, const char *varstring,
 778                      struct ui_file *stream, int show, int level,
 779                      const struct type_print_options *flags)
 780 {
 781   error (_("internal error - unimplemented "
 782            "function unk_lang_print_type called."));
 783 }
 784
 785 static void
 786 unk_lang_val_print (struct type *type,
 787                     int embedded_offset, CORE_ADDR address,
 788                     struct ui_file *stream, int recurse,
 789                     struct value *val,
 790                     const struct value_print_options *options)
 791 {
 792   error (_("internal error - unimplemented "
 793            "function unk_lang_val_print called."));
 794 }
 795
 796 static void
 797 unk_lang_value_print (struct value *val, struct ui_file *stream,
 798                       const struct value_print_options *options)
 799 {
 800   error (_("internal error - unimplemented "
 801            "function unk_lang_value_print called."));
 802 }
 803
 804 static CORE_ADDR unk_lang_trampoline (struct frame_info *frame, CORE_ADDR pc)
 805 {
 806   return 0;
 807 }
 808
 809 /* Unknown languages just use the cplus demangler.  */
 810 static char *unk_lang_demangle (const char *mangled, int options)
 811 {
 812   return gdb_demangle (mangled, options);
 813 }
 814
 815 static char *unk_lang_class_name (const char *mangled)
 816 {
 817   return NULL;
 818 }
 819
 820 static const struct op_print unk_op_print_tab[] =
 821 {
 822   {NULL, OP_NULL, PREC_NULL, 0}
 823 };
 824
 825 static void
 826 unknown_language_arch_info (struct gdbarch *gdbarch,
 827                             struct language_arch_info *lai)
 828 {
 829   lai->string_char_type = builtin_type (gdbarch)->builtin_char;
 830   lai->bool_type_default = builtin_type (gdbarch)->builtin_int;
 831   lai->primitive_type_vector = GDBARCH_OBSTACK_CALLOC (gdbarch, 1,
 832                                                        struct type *);
 833 }
 834
 835 const struct language_defn unknown_language_defn =
 836 {
 837   "unknown",
 838   "Unknown",
 839   language_unknown,
 840   range_check_off,
 841   case_sensitive_on,
 842   array_row_major,
 843   macro_expansion_no,
 844   NULL,
 845   &exp_descriptor_standard,
 846   unk_lang_parser,
 847   unk_lang_error,
 848   null_post_parser,
 849   unk_lang_printchar,           /* Print character constant */
 850   unk_lang_printstr,
 851   unk_lang_emit_char,
 852   unk_lang_print_type,          /* Print a type using appropriate syntax */
 853   default_print_typedef,        /* Print a typedef using appropriate syntax */
 854   unk_lang_val_print,           /* Print a value using appropriate syntax */
 855   unk_lang_value_print,         /* Print a top-level value */
 856   default_read_var_value,       /* la_read_var_value */
 857   unk_lang_trampoline,          /* Language specific skip_trampoline */
 858   "this",                       /* name_of_this */
 859   basic_lookup_symbol_nonlocal, /* lookup_symbol_nonlocal */
 860   basic_lookup_transparent_type,/* lookup_transparent_type */
 861   unk_lang_demangle,            /* Language specific symbol demangler */
 862   NULL,
 863   unk_lang_class_name,          /* Language specific
 864                                    class_name_from_physname */
 865   unk_op_print_tab,             /* expression operators for printing */
 866   1,                            /* c-style arrays */
 867   0,                            /* String lower bound */
 868   default_word_break_characters,
 869   default_collect_symbol_completion_matches,
 870   unknown_language_arch_info,   /* la_language_arch_info.  */
 871   default_print_array_index,
 872   default_pass_by_reference,
 873   default_get_string,
 874   c_watch_location_expression,
 875   NULL,                         /* la_get_symbol_name_matcher */
 876   iterate_over_symbols,
 877   default_search_name_hash,
 878   &default_varobj_ops,
 879   NULL,
 880   NULL,
 881   LANG_MAGIC
 882 };
 883
 884 /* These two structs define fake entries for the "local" and "auto"
 885    options.  */
 886 const struct language_defn auto_language_defn =
 887 {
 888   "auto",
 889   "Auto",
 890   language_auto,
 891   range_check_off,
 892   case_sensitive_on,
 893   array_row_major,
 894   macro_expansion_no,
 895   NULL,
 896   &exp_descriptor_standard,
 897   unk_lang_parser,
 898   unk_lang_error,
 899   null_post_parser,
 900   unk_lang_printchar,           /* Print character constant */
 901   unk_lang_printstr,
 902   unk_lang_emit_char,
 903   unk_lang_print_type,          /* Print a type using appropriate syntax */
 904   default_print_typedef,        /* Print a typedef using appropriate syntax */
 905   unk_lang_val_print,           /* Print a value using appropriate syntax */
 906   unk_lang_value_print,         /* Print a top-level value */
 907   default_read_var_value,       /* la_read_var_value */
 908   unk_lang_trampoline,          /* Language specific skip_trampoline */
 909   "this",                       /* name_of_this */
 910   basic_lookup_symbol_nonlocal, /* lookup_symbol_nonlocal */
 911   basic_lookup_transparent_type,/* lookup_transparent_type */
 912   unk_lang_demangle,            /* Language specific symbol demangler */
 913   NULL,
 914   unk_lang_class_name,          /* Language specific
 915                                    class_name_from_physname */
 916   unk_op_print_tab,             /* expression operators for printing */
 917   1,                            /* c-style arrays */
 918   0,                            /* String lower bound */
 919   default_word_break_characters,
 920   default_collect_symbol_completion_matches,
 921   unknown_language_arch_info,   /* la_language_arch_info.  */
 922   default_print_array_index,
 923   default_pass_by_reference,
 924   default_get_string,
 925   c_watch_location_expression,
 926   NULL,                         /* la_get_symbol_name_matcher */
 927   iterate_over_symbols,
 928   default_search_name_hash,
 929   &default_varobj_ops,
 930   NULL,
 931   NULL,
 932   LANG_MAGIC
 933 };
 934
 935 \f
 936 /* Per-architecture language information.  */
 937
 938 static struct gdbarch_data *language_gdbarch_data;
 939
 940 struct language_gdbarch
 941 {
 942   /* A vector of per-language per-architecture info.  Indexed by "enum
 943      language".  */
 944   struct language_arch_info arch_info[nr_languages];
 945 };
 946
 947 static void *
 948 language_gdbarch_post_init (struct gdbarch *gdbarch)
 949 {
 950   struct language_gdbarch *l;
 951
 952   l = GDBARCH_OBSTACK_ZALLOC (gdbarch, struct language_gdbarch);
 953   for (const auto &lang : languages)
 954     if (lang != NULL && lang->la_language_arch_info != NULL)
 955       {
 956         lang->la_language_arch_info (gdbarch,
 957                                      l->arch_info + lang->la_language);
 958       }
 959
 960   return l;
 961 }
 962
 963 struct type *
 964 language_string_char_type (const struct language_defn *la,
 965                            struct gdbarch *gdbarch)
 966 {
 967   struct language_gdbarch *ld
 968     = (struct language_gdbarch *) gdbarch_data (gdbarch, language_gdbarch_data);
 969
 970   return ld->arch_info[la->la_language].string_char_type;
 971 }
 972
 973 struct type *
 974 language_bool_type (const struct language_defn *la,
 975                     struct gdbarch *gdbarch)
 976 {
 977   struct language_gdbarch *ld
 978     = (struct language_gdbarch *) gdbarch_data (gdbarch, language_gdbarch_data);
 979
 980   if (ld->arch_info[la->la_language].bool_type_symbol)
 981     {
 982       struct symbol *sym;
 983
 984       sym = lookup_symbol (ld->arch_info[la->la_language].bool_type_symbol,
 985                            NULL, VAR_DOMAIN, NULL).symbol;
 986       if (sym)
 987         {
 988           struct type *type = SYMBOL_TYPE (sym);
 989
 990           if (type && TYPE_CODE (type) == TYPE_CODE_BOOL)
 991             return type;
 992         }
 993     }
 994
 995   return ld->arch_info[la->la_language].bool_type_default;
 996 }
 997
 998 /* Helper function for primitive type lookup.  */
 999
1000 static struct type **
1001 language_lookup_primitive_type_1 (const struct language_arch_info *lai,
1002                                   const char *name)
1003 {
1004   struct type **p;
1005
1006   for (p = lai->primitive_type_vector; (*p) != NULL; p++)
1007     {
1008       if (strcmp (TYPE_NAME (*p), name) == 0)
1009         return p;
1010     }
1011   return NULL;
1012 }
1013
1014 /* See language.h.  */
1015
1016 struct type *
1017 language_lookup_primitive_type (const struct language_defn *la,
1018                                 struct gdbarch *gdbarch,
1019                                 const char *name)
1020 {
1021   struct language_gdbarch *ld =
1022     (struct language_gdbarch *) gdbarch_data (gdbarch, language_gdbarch_data);
1023   struct type **typep;
1024
1025   typep = language_lookup_primitive_type_1 (&ld->arch_info[la->la_language],
1026                                             name);
1027   if (typep == NULL)
1028     return NULL;
1029   return *typep;
1030 }
1031
1032 /* Helper function for type lookup as a symbol.
1033    Create the symbol corresponding to type TYPE in language LANG.  */
1034
1035 static struct symbol *
1036 language_alloc_type_symbol (enum language lang, struct type *type)
1037 {
1038   struct symbol *symbol;
1039   struct gdbarch *gdbarch;
1040
1041   gdb_assert (!TYPE_OBJFILE_OWNED (type));
1042
1043   gdbarch = TYPE_OWNER (type).gdbarch;
1044   symbol = GDBARCH_OBSTACK_ZALLOC (gdbarch, struct symbol);
1045
1046   symbol->ginfo.name = TYPE_NAME (type);
1047   symbol->ginfo.language = lang;
1048   symbol->owner.arch = gdbarch;
1049   SYMBOL_OBJFILE_OWNED (symbol) = 0;
1050   SYMBOL_TYPE (symbol) = type;
1051   SYMBOL_DOMAIN (symbol) = VAR_DOMAIN;
1052   SYMBOL_ACLASS_INDEX (symbol) = LOC_TYPEDEF;
1053
1054   return symbol;
1055 }
1056
1057 /* Initialize the primitive type symbols of language LD.
1058    The primitive type vector must have already been initialized.  */
1059
1060 static void
1061 language_init_primitive_type_symbols (struct language_arch_info *lai,
1062                                       const struct language_defn *la,
1063                                       struct gdbarch *gdbarch)
1064 {
1065   int n;
1066
1067   gdb_assert (lai->primitive_type_vector != NULL);
1068
1069   for (n = 0; lai->primitive_type_vector[n] != NULL; ++n)
1070     continue;
1071
1072   lai->primitive_type_symbols
1073     = GDBARCH_OBSTACK_CALLOC (gdbarch, n + 1, struct symbol *);
1074
1075   for (n = 0; lai->primitive_type_vector[n] != NULL; ++n)
1076     {
1077       lai->primitive_type_symbols[n]
1078         = language_alloc_type_symbol (la->la_language,
1079                                       lai->primitive_type_vector[n]);
1080     }
1081
1082   /* Note: The result of symbol lookup is normally a symbol *and* the block
1083      it was found in.  Builtin types don't live in blocks.  We *could* give
1084      them one, but there is no current need so to keep things simple symbol
1085      lookup is extended to allow for BLOCK_FOUND to be NULL.  */
1086 }
1087
1088 /* See language.h.  */
1089
1090 struct symbol *
1091 language_lookup_primitive_type_as_symbol (const struct language_defn *la,
1092                                           struct gdbarch *gdbarch,
1093                                           const char *name)
1094 {
1095   struct language_gdbarch *ld
1096     = (struct language_gdbarch *) gdbarch_data (gdbarch, language_gdbarch_data);
1097   struct language_arch_info *lai = &ld->arch_info[la->la_language];
1098   struct type **typep;
1099   struct symbol *sym;
1100
1101   if (symbol_lookup_debug)
1102     {
1103       fprintf_unfiltered (gdb_stdlog,
1104                           "language_lookup_primitive_type_as_symbol"
1105                           " (%s, %s, %s)",
1106                           la->la_name, host_address_to_string (gdbarch), name);
1107     }
1108
1109   typep = language_lookup_primitive_type_1 (lai, name);
1110   if (typep == NULL)
1111     {
1112       if (symbol_lookup_debug)
1113         fprintf_unfiltered (gdb_stdlog, " = NULL\n");
1114       return NULL;
1115     }
1116
1117   /* The set of symbols is lazily initialized.  */
1118   if (lai->primitive_type_symbols == NULL)
1119     language_init_primitive_type_symbols (lai, la, gdbarch);
1120
1121   sym = lai->primitive_type_symbols[typep - lai->primitive_type_vector];
1122
1123   if (symbol_lookup_debug)
1124     fprintf_unfiltered (gdb_stdlog, " = %s\n", host_address_to_string (sym));
1125   return sym;
1126 }
1127
1128 /* Initialize the language routines.  */
1129
1130 void
1131 _initialize_language (void)
1132 {
1133   static const char *const type_or_range_names[]
1134     = { "on", "off", "warn", "auto", NULL };
1135
1136   static const char *const case_sensitive_names[]
1137     = { "on", "off", "auto", NULL };
1138
1139   language_gdbarch_data
1140     = gdbarch_data_register_post_init (language_gdbarch_post_init);
1141
1142   /* GDB commands for language specific stuff.  */
1143
1144   add_prefix_cmd ("check", no_class, set_check,
1145                   _("Set the status of the type/range checker."),
1146                   &setchecklist, "set check ", 0, &setlist);
1147   add_alias_cmd ("c", "check", no_class, 1, &setlist);
1148   add_alias_cmd ("ch", "check", no_class, 1, &setlist);
1149
1150   add_prefix_cmd ("check", no_class, show_check,
1151                   _("Show the status of the type/range checker."),
1152                   &showchecklist, "show check ", 0, &showlist);
1153   add_alias_cmd ("c", "check", no_class, 1, &showlist);
1154   add_alias_cmd ("ch", "check", no_class, 1, &showlist);
1155
1156   add_setshow_enum_cmd ("range", class_support, type_or_range_names,
1157                         &range,
1158                         _("Set range checking.  (on/warn/off/auto)"),
1159                         _("Show range checking.  (on/warn/off/auto)"),
1160                         NULL, set_range_command,
1161                         show_range_command,
1162                         &setchecklist, &showchecklist);
1163
1164   add_setshow_enum_cmd ("case-sensitive", class_support, case_sensitive_names,
1165                         &case_sensitive, _("\
1166 Set case sensitivity in name search.  (on/off/auto)"), _("\
1167 Show case sensitivity in name search.  (on/off/auto)"), _("\
1168 For Fortran the default is off; for other languages the default is on."),
1169                         set_case_command,
1170                         show_case_command,
1171                         &setlist, &showlist);
1172
1173   add_set_language_command ();
1174
1175   language = xstrdup ("auto");
1176   type = xstrdup ("auto");
1177   range = xstrdup ("auto");
1178   case_sensitive = xstrdup ("auto");
1179
1180   /* Have the above take effect.  */
1181   set_language (language_auto);
1182 }