gdb/demangle.c

   1 /* Basic C++ demangling support for GDB.
   2    Copyright 1991, 1992, 1996, 1999 Free Software Foundation, Inc.
   3    Written by Fred Fish at Cygnus Support.
   4
   5    This file is part of GDB.
   6
   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 2 of the License, or
  10    (at your option) any later version.
  11
  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.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program; if not, write to the Free Software
  19    Foundation, Inc., 59 Temple Place - Suite 330,
  20    Boston, MA 02111-1307, USA.  */
  21
  22
  23 /*  This file contains support code for C++ demangling that is common
  24    to a styles of demangling, and GDB specific. */
  25
  26 #include "defs.h"
  27 #include "command.h"
  28 #include "gdbcmd.h"
  29 #include "demangle.h"
  30 #include "gdb_string.h"
  31
  32 /* Select the default C++ demangling style to use.  The default is "auto",
  33    which allows gdb to attempt to pick an appropriate demangling style for
  34    the executable it has loaded.  It can be set to a specific style ("gnu",
  35    "lucid", "arm", "hp", etc.) in which case gdb will never attempt to do auto
  36    selection of the style unless you do an explicit "set demangle auto".
  37    To select one of these as the default, set DEFAULT_DEMANGLING_STYLE in
  38    the appropriate target configuration file. */
  39
  40 #ifndef DEFAULT_DEMANGLING_STYLE
  41 #define DEFAULT_DEMANGLING_STYLE AUTO_DEMANGLING_STYLE_STRING
  42 #endif
  43
  44 extern void _initialize_demangler (void);
  45
  46 /* String name for the current demangling style.  Set by the
  47    "set demangle-style" command, printed as part of the output by the
  48    "show demangle-style" command. */
  49
  50 static char *current_demangling_style_string;
  51
  52 /* List of supported demangling styles.  Contains the name of the style as
  53    seen by the user, and the enum value that corresponds to that style. */
  54
  55 static const struct demangler
  56   {
  57     char *demangling_style_name;
  58     enum demangling_styles demangling_style;
  59     char *demangling_style_doc;
  60   }
  61 demanglers[] =
  62 {
  63   {
  64     AUTO_DEMANGLING_STYLE_STRING,
  65       auto_demangling,
  66       "Automatic selection based on executable"
  67   }
  68   ,
  69   {
  70     GNU_DEMANGLING_STYLE_STRING,
  71       gnu_demangling,
  72       "GNU (g++) style demangling"
  73   }
  74   ,
  75   {
  76     LUCID_DEMANGLING_STYLE_STRING,
  77       lucid_demangling,
  78       "Lucid (lcc) style demangling"
  79   }
  80   ,
  81   {
  82     ARM_DEMANGLING_STYLE_STRING,
  83       arm_demangling,
  84       "ARM style demangling"
  85   }
  86   ,
  87   {
  88     HP_DEMANGLING_STYLE_STRING,
  89       hp_demangling,
  90       "HP (aCC) style demangling"
  91   }
  92   ,
  93   {
  94     EDG_DEMANGLING_STYLE_STRING,
  95       edg_demangling,
  96       "EDG style demangling"
  97   }
  98   ,
  99   {
 100     NULL, unknown_demangling, NULL
 101   }
 102 };
 103
 104 static void set_demangling_command (char *, int, struct cmd_list_element *);
 105
 106 /* Set current demangling style.  Called by the "set demangle-style"
 107    command after it has updated the current_demangling_style_string to
 108    match what the user has entered.
 109
 110    If the user has entered a string that matches a known demangling style
 111    name in the demanglers[] array then just leave the string alone and update
 112    the current_demangling_style enum value to match.
 113
 114    If the user has entered a string that doesn't match, including an empty
 115    string, then print a list of the currently known styles and restore
 116    the current_demangling_style_string to match the current_demangling_style
 117    enum value.
 118
 119    Note:  Assumes that current_demangling_style_string always points to
 120    a malloc'd string, even if it is a null-string. */
 121
 122 static void
 123 set_demangling_command (ignore, from_tty, c)
 124      char *ignore;
 125      int from_tty;
 126      struct cmd_list_element *c;
 127 {
 128   const struct demangler *dem;
 129
 130   /*  First just try to match whatever style name the user supplied with
 131      one of the known ones.  Don't bother special casing for an empty
 132      name, we just treat it as any other style name that doesn't match.
 133      If we match, update the current demangling style enum. */
 134
 135   for (dem = demanglers; dem->demangling_style_name != NULL; dem++)
 136     {
 137       if (STREQ (current_demangling_style_string,
 138                  dem->demangling_style_name))
 139         {
 140           current_demangling_style = dem->demangling_style;
 141           break;
 142         }
 143     }
 144
 145   /* Check to see if we found a match.  If not, gripe about any non-empty
 146      style name and supply a list of valid ones.  FIXME:  This should
 147      probably be done with some sort of completion and with help. */
 148
 149   if (dem->demangling_style_name == NULL)
 150     {
 151       if (*current_demangling_style_string != '\0')
 152         {
 153           printf_unfiltered ("Unknown demangling style `%s'.\n",
 154                              current_demangling_style_string);
 155         }
 156       printf_unfiltered ("The currently understood settings are:\n\n");
 157       for (dem = demanglers; dem->demangling_style_name != NULL; dem++)
 158         {
 159           printf_unfiltered ("%-10s %s\n", dem->demangling_style_name,
 160                              dem->demangling_style_doc);
 161           if (dem->demangling_style == current_demangling_style)
 162             {
 163               free (current_demangling_style_string);
 164               current_demangling_style_string =
 165                 savestring (dem->demangling_style_name,
 166                             strlen (dem->demangling_style_name));
 167             }
 168         }
 169       if (current_demangling_style == unknown_demangling)
 170         {
 171           /* This can happen during initialization if gdb is compiled with
 172              a DEMANGLING_STYLE value that is unknown, so pick the first
 173              one as the default. */
 174           current_demangling_style = demanglers[0].demangling_style;
 175           current_demangling_style_string =
 176             savestring (demanglers[0].demangling_style_name,
 177                         strlen (demanglers[0].demangling_style_name));
 178           warning ("`%s' style demangling chosen as the default.\n",
 179                    current_demangling_style_string);
 180         }
 181     }
 182 }
 183
 184 /* Fake a "set demangle-style" command. */
 185
 186 void
 187 set_demangling_style (style)
 188      char *style;
 189 {
 190   if (current_demangling_style_string != NULL)
 191     {
 192       free (current_demangling_style_string);
 193     }
 194   current_demangling_style_string = savestring (style, strlen (style));
 195   set_demangling_command ((char *) NULL, 0, (struct cmd_list_element *) NULL);
 196 }
 197
 198 /* In order to allow a single demangler executable to demangle strings
 199    using various common values of CPLUS_MARKER, as well as any specific
 200    one set at compile time, we maintain a string containing all the
 201    commonly used ones, and check to see if the marker we are looking for
 202    is in that string.  CPLUS_MARKER is usually '$' on systems where the
 203    assembler can deal with that.  Where the assembler can't, it's usually
 204    '.' (but on many systems '.' is used for other things).  We put the
 205    current defined CPLUS_MARKER first (which defaults to '$'), followed
 206    by the next most common value, followed by an explicit '$' in case
 207    the value of CPLUS_MARKER is not '$'.
 208
 209    We could avoid this if we could just get g++ to tell us what the actual
 210    cplus marker character is as part of the debug information, perhaps by
 211    ensuring that it is the character that terminates the gcc<n>_compiled
 212    marker symbol (FIXME). */
 213
 214 static char cplus_markers[] =
 215 {CPLUS_MARKER, '.', '$', '\0'};
 216
 217 int
 218 is_cplus_marker (c)
 219      int c;
 220 {
 221   return c && strchr (cplus_markers, c) != NULL;
 222 }
 223
 224 void
 225 _initialize_demangler ()
 226 {
 227   struct cmd_list_element *set, *show;
 228
 229   set = add_set_cmd ("demangle-style", class_support, var_string_noescape,
 230                      (char *) &current_demangling_style_string,
 231                      "Set the current C++ demangling style.\n\
 232 Use `set demangle-style' without arguments for a list of demangling styles.",
 233                      &setlist);
 234   show = add_show_from_set (set, &showlist);
 235   set->function.sfunc = set_demangling_command;
 236
 237   /* Set the default demangling style chosen at compilation time. */
 238   set_demangling_style (DEFAULT_DEMANGLING_STYLE);
 239   set_cplus_marker_for_demangling (CPLUS_MARKER);
 240 }