/* Basic C++ demangling support for GDB.
|
/* Basic C++ demangling support for GDB.
|
Copyright 1991, 1992, 1996, 1999 Free Software Foundation, Inc.
|
Copyright 1991, 1992, 1996, 1999 Free Software Foundation, Inc.
|
Written by Fred Fish at Cygnus Support.
|
Written by Fred Fish at Cygnus Support.
|
|
|
This file is part of GDB.
|
This file is part of GDB.
|
|
|
This program is free software; you can redistribute it and/or modify
|
This program is free software; you can redistribute it and/or modify
|
it under the terms of the GNU General Public License as published by
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 2 of the License, or
|
the Free Software Foundation; either version 2 of the License, or
|
(at your option) any later version.
|
(at your option) any later version.
|
|
|
This program is distributed in the hope that it will be useful,
|
This program is distributed in the hope that it will be useful,
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
GNU General Public License for more details.
|
GNU General Public License for more details.
|
|
|
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
along with this program; if not, write to the Free Software
|
along with this program; if not, write to the Free Software
|
Foundation, Inc., 59 Temple Place - Suite 330,
|
Foundation, Inc., 59 Temple Place - Suite 330,
|
Boston, MA 02111-1307, USA. */
|
Boston, MA 02111-1307, USA. */
|
|
|
|
|
/* This file contains support code for C++ demangling that is common
|
/* This file contains support code for C++ demangling that is common
|
to a styles of demangling, and GDB specific. */
|
to a styles of demangling, and GDB specific. */
|
|
|
#include "defs.h"
|
#include "defs.h"
|
#include "command.h"
|
#include "command.h"
|
#include "gdbcmd.h"
|
#include "gdbcmd.h"
|
#include "demangle.h"
|
#include "demangle.h"
|
#include "gdb_string.h"
|
#include "gdb_string.h"
|
|
|
/* Select the default C++ demangling style to use. The default is "auto",
|
/* Select the default C++ demangling style to use. The default is "auto",
|
which allows gdb to attempt to pick an appropriate demangling style for
|
which allows gdb to attempt to pick an appropriate demangling style for
|
the executable it has loaded. It can be set to a specific style ("gnu",
|
the executable it has loaded. It can be set to a specific style ("gnu",
|
"lucid", "arm", "hp", etc.) in which case gdb will never attempt to do auto
|
"lucid", "arm", "hp", etc.) in which case gdb will never attempt to do auto
|
selection of the style unless you do an explicit "set demangle auto".
|
selection of the style unless you do an explicit "set demangle auto".
|
To select one of these as the default, set DEFAULT_DEMANGLING_STYLE in
|
To select one of these as the default, set DEFAULT_DEMANGLING_STYLE in
|
the appropriate target configuration file. */
|
the appropriate target configuration file. */
|
|
|
#ifndef DEFAULT_DEMANGLING_STYLE
|
#ifndef DEFAULT_DEMANGLING_STYLE
|
#define DEFAULT_DEMANGLING_STYLE AUTO_DEMANGLING_STYLE_STRING
|
#define DEFAULT_DEMANGLING_STYLE AUTO_DEMANGLING_STYLE_STRING
|
#endif
|
#endif
|
|
|
extern void _initialize_demangler PARAMS ((void));
|
extern void _initialize_demangler PARAMS ((void));
|
|
|
/* String name for the current demangling style. Set by the
|
/* String name for the current demangling style. Set by the
|
"set demangle-style" command, printed as part of the output by the
|
"set demangle-style" command, printed as part of the output by the
|
"show demangle-style" command. */
|
"show demangle-style" command. */
|
|
|
static char *current_demangling_style_string;
|
static char *current_demangling_style_string;
|
|
|
/* List of supported demangling styles. Contains the name of the style as
|
/* List of supported demangling styles. Contains the name of the style as
|
seen by the user, and the enum value that corresponds to that style. */
|
seen by the user, and the enum value that corresponds to that style. */
|
|
|
static const struct demangler
|
static const struct demangler
|
{
|
{
|
char *demangling_style_name;
|
char *demangling_style_name;
|
enum demangling_styles demangling_style;
|
enum demangling_styles demangling_style;
|
char *demangling_style_doc;
|
char *demangling_style_doc;
|
}
|
}
|
demanglers[] =
|
demanglers[] =
|
{
|
{
|
{
|
{
|
AUTO_DEMANGLING_STYLE_STRING,
|
AUTO_DEMANGLING_STYLE_STRING,
|
auto_demangling,
|
auto_demangling,
|
"Automatic selection based on executable"
|
"Automatic selection based on executable"
|
}
|
}
|
,
|
,
|
{
|
{
|
GNU_DEMANGLING_STYLE_STRING,
|
GNU_DEMANGLING_STYLE_STRING,
|
gnu_demangling,
|
gnu_demangling,
|
"GNU (g++) style demangling"
|
"GNU (g++) style demangling"
|
}
|
}
|
,
|
,
|
{
|
{
|
LUCID_DEMANGLING_STYLE_STRING,
|
LUCID_DEMANGLING_STYLE_STRING,
|
lucid_demangling,
|
lucid_demangling,
|
"Lucid (lcc) style demangling"
|
"Lucid (lcc) style demangling"
|
}
|
}
|
,
|
,
|
{
|
{
|
ARM_DEMANGLING_STYLE_STRING,
|
ARM_DEMANGLING_STYLE_STRING,
|
arm_demangling,
|
arm_demangling,
|
"ARM style demangling"
|
"ARM style demangling"
|
}
|
}
|
,
|
,
|
{
|
{
|
HP_DEMANGLING_STYLE_STRING,
|
HP_DEMANGLING_STYLE_STRING,
|
hp_demangling,
|
hp_demangling,
|
"HP (aCC) style demangling"
|
"HP (aCC) style demangling"
|
}
|
}
|
,
|
,
|
{
|
{
|
EDG_DEMANGLING_STYLE_STRING,
|
EDG_DEMANGLING_STYLE_STRING,
|
edg_demangling,
|
edg_demangling,
|
"EDG style demangling"
|
"EDG style demangling"
|
}
|
}
|
,
|
,
|
{
|
{
|
NULL, unknown_demangling, NULL
|
NULL, unknown_demangling, NULL
|
}
|
}
|
};
|
};
|
|
|
static void
|
static void
|
set_demangling_command PARAMS ((char *, int, struct cmd_list_element *));
|
set_demangling_command PARAMS ((char *, int, struct cmd_list_element *));
|
|
|
/* Set current demangling style. Called by the "set demangle-style"
|
/* Set current demangling style. Called by the "set demangle-style"
|
command after it has updated the current_demangling_style_string to
|
command after it has updated the current_demangling_style_string to
|
match what the user has entered.
|
match what the user has entered.
|
|
|
If the user has entered a string that matches a known demangling style
|
If the user has entered a string that matches a known demangling style
|
name in the demanglers[] array then just leave the string alone and update
|
name in the demanglers[] array then just leave the string alone and update
|
the current_demangling_style enum value to match.
|
the current_demangling_style enum value to match.
|
|
|
If the user has entered a string that doesn't match, including an empty
|
If the user has entered a string that doesn't match, including an empty
|
string, then print a list of the currently known styles and restore
|
string, then print a list of the currently known styles and restore
|
the current_demangling_style_string to match the current_demangling_style
|
the current_demangling_style_string to match the current_demangling_style
|
enum value.
|
enum value.
|
|
|
Note: Assumes that current_demangling_style_string always points to
|
Note: Assumes that current_demangling_style_string always points to
|
a malloc'd string, even if it is a null-string. */
|
a malloc'd string, even if it is a null-string. */
|
|
|
static void
|
static void
|
set_demangling_command (ignore, from_tty, c)
|
set_demangling_command (ignore, from_tty, c)
|
char *ignore;
|
char *ignore;
|
int from_tty;
|
int from_tty;
|
struct cmd_list_element *c;
|
struct cmd_list_element *c;
|
{
|
{
|
const struct demangler *dem;
|
const struct demangler *dem;
|
|
|
/* First just try to match whatever style name the user supplied with
|
/* First just try to match whatever style name the user supplied with
|
one of the known ones. Don't bother special casing for an empty
|
one of the known ones. Don't bother special casing for an empty
|
name, we just treat it as any other style name that doesn't match.
|
name, we just treat it as any other style name that doesn't match.
|
If we match, update the current demangling style enum. */
|
If we match, update the current demangling style enum. */
|
|
|
for (dem = demanglers; dem->demangling_style_name != NULL; dem++)
|
for (dem = demanglers; dem->demangling_style_name != NULL; dem++)
|
{
|
{
|
if (STREQ (current_demangling_style_string,
|
if (STREQ (current_demangling_style_string,
|
dem->demangling_style_name))
|
dem->demangling_style_name))
|
{
|
{
|
current_demangling_style = dem->demangling_style;
|
current_demangling_style = dem->demangling_style;
|
break;
|
break;
|
}
|
}
|
}
|
}
|
|
|
/* Check to see if we found a match. If not, gripe about any non-empty
|
/* Check to see if we found a match. If not, gripe about any non-empty
|
style name and supply a list of valid ones. FIXME: This should
|
style name and supply a list of valid ones. FIXME: This should
|
probably be done with some sort of completion and with help. */
|
probably be done with some sort of completion and with help. */
|
|
|
if (dem->demangling_style_name == NULL)
|
if (dem->demangling_style_name == NULL)
|
{
|
{
|
if (*current_demangling_style_string != '\0')
|
if (*current_demangling_style_string != '\0')
|
{
|
{
|
printf_unfiltered ("Unknown demangling style `%s'.\n",
|
printf_unfiltered ("Unknown demangling style `%s'.\n",
|
current_demangling_style_string);
|
current_demangling_style_string);
|
}
|
}
|
printf_unfiltered ("The currently understood settings are:\n\n");
|
printf_unfiltered ("The currently understood settings are:\n\n");
|
for (dem = demanglers; dem->demangling_style_name != NULL; dem++)
|
for (dem = demanglers; dem->demangling_style_name != NULL; dem++)
|
{
|
{
|
printf_unfiltered ("%-10s %s\n", dem->demangling_style_name,
|
printf_unfiltered ("%-10s %s\n", dem->demangling_style_name,
|
dem->demangling_style_doc);
|
dem->demangling_style_doc);
|
if (dem->demangling_style == current_demangling_style)
|
if (dem->demangling_style == current_demangling_style)
|
{
|
{
|
free (current_demangling_style_string);
|
free (current_demangling_style_string);
|
current_demangling_style_string =
|
current_demangling_style_string =
|
savestring (dem->demangling_style_name,
|
savestring (dem->demangling_style_name,
|
strlen (dem->demangling_style_name));
|
strlen (dem->demangling_style_name));
|
}
|
}
|
}
|
}
|
if (current_demangling_style == unknown_demangling)
|
if (current_demangling_style == unknown_demangling)
|
{
|
{
|
/* This can happen during initialization if gdb is compiled with
|
/* This can happen during initialization if gdb is compiled with
|
a DEMANGLING_STYLE value that is unknown, so pick the first
|
a DEMANGLING_STYLE value that is unknown, so pick the first
|
one as the default. */
|
one as the default. */
|
current_demangling_style = demanglers[0].demangling_style;
|
current_demangling_style = demanglers[0].demangling_style;
|
current_demangling_style_string =
|
current_demangling_style_string =
|
savestring (demanglers[0].demangling_style_name,
|
savestring (demanglers[0].demangling_style_name,
|
strlen (demanglers[0].demangling_style_name));
|
strlen (demanglers[0].demangling_style_name));
|
warning ("`%s' style demangling chosen as the default.\n",
|
warning ("`%s' style demangling chosen as the default.\n",
|
current_demangling_style_string);
|
current_demangling_style_string);
|
}
|
}
|
}
|
}
|
}
|
}
|
|
|
/* Fake a "set demangle-style" command. */
|
/* Fake a "set demangle-style" command. */
|
|
|
void
|
void
|
set_demangling_style (style)
|
set_demangling_style (style)
|
char *style;
|
char *style;
|
{
|
{
|
if (current_demangling_style_string != NULL)
|
if (current_demangling_style_string != NULL)
|
{
|
{
|
free (current_demangling_style_string);
|
free (current_demangling_style_string);
|
}
|
}
|
current_demangling_style_string = savestring (style, strlen (style));
|
current_demangling_style_string = savestring (style, strlen (style));
|
set_demangling_command ((char *) NULL, 0, (struct cmd_list_element *) NULL);
|
set_demangling_command ((char *) NULL, 0, (struct cmd_list_element *) NULL);
|
}
|
}
|
|
|
/* In order to allow a single demangler executable to demangle strings
|
/* In order to allow a single demangler executable to demangle strings
|
using various common values of CPLUS_MARKER, as well as any specific
|
using various common values of CPLUS_MARKER, as well as any specific
|
one set at compile time, we maintain a string containing all the
|
one set at compile time, we maintain a string containing all the
|
commonly used ones, and check to see if the marker we are looking for
|
commonly used ones, and check to see if the marker we are looking for
|
is in that string. CPLUS_MARKER is usually '$' on systems where the
|
is in that string. CPLUS_MARKER is usually '$' on systems where the
|
assembler can deal with that. Where the assembler can't, it's usually
|
assembler can deal with that. Where the assembler can't, it's usually
|
'.' (but on many systems '.' is used for other things). We put the
|
'.' (but on many systems '.' is used for other things). We put the
|
current defined CPLUS_MARKER first (which defaults to '$'), followed
|
current defined CPLUS_MARKER first (which defaults to '$'), followed
|
by the next most common value, followed by an explicit '$' in case
|
by the next most common value, followed by an explicit '$' in case
|
the value of CPLUS_MARKER is not '$'.
|
the value of CPLUS_MARKER is not '$'.
|
|
|
We could avoid this if we could just get g++ to tell us what the actual
|
We could avoid this if we could just get g++ to tell us what the actual
|
cplus marker character is as part of the debug information, perhaps by
|
cplus marker character is as part of the debug information, perhaps by
|
ensuring that it is the character that terminates the gcc<n>_compiled
|
ensuring that it is the character that terminates the gcc<n>_compiled
|
marker symbol (FIXME). */
|
marker symbol (FIXME). */
|
|
|
static char cplus_markers[] =
|
static char cplus_markers[] =
|
{CPLUS_MARKER, '.', '$', '\0'};
|
{CPLUS_MARKER, '.', '$', '\0'};
|
|
|
int
|
int
|
is_cplus_marker (c)
|
is_cplus_marker (c)
|
int c;
|
int c;
|
{
|
{
|
return c && strchr (cplus_markers, c) != NULL;
|
return c && strchr (cplus_markers, c) != NULL;
|
}
|
}
|
|
|
void
|
void
|
_initialize_demangler ()
|
_initialize_demangler ()
|
{
|
{
|
struct cmd_list_element *set, *show;
|
struct cmd_list_element *set, *show;
|
|
|
set = add_set_cmd ("demangle-style", class_support, var_string_noescape,
|
set = add_set_cmd ("demangle-style", class_support, var_string_noescape,
|
(char *) ¤t_demangling_style_string,
|
(char *) ¤t_demangling_style_string,
|
"Set the current C++ demangling style.\n\
|
"Set the current C++ demangling style.\n\
|
Use `set demangle-style' without arguments for a list of demangling styles.",
|
Use `set demangle-style' without arguments for a list of demangling styles.",
|
&setlist);
|
&setlist);
|
show = add_show_from_set (set, &showlist);
|
show = add_show_from_set (set, &showlist);
|
set->function.sfunc = set_demangling_command;
|
set->function.sfunc = set_demangling_command;
|
|
|
/* Set the default demangling style chosen at compilation time. */
|
/* Set the default demangling style chosen at compilation time. */
|
set_demangling_style (DEFAULT_DEMANGLING_STYLE);
|
set_demangling_style (DEFAULT_DEMANGLING_STYLE);
|
set_cplus_marker_for_demangling (CPLUS_MARKER);
|
set_cplus_marker_for_demangling (CPLUS_MARKER);
|
}
|
}
|
|
|
