mirror of
https://github.com/hrydgard/ppsspp.git
synced 2026-11-04 13:23:49 +01:00
Henrik RydgårdandClaude Opus 5
27869abb6a
Older PSP binaries weren't built with GCC, so the Itanium demangler doesn't
help with them. Add two more, tried in turn by DemangleSymbolName():
- Metrowerks CodeWarrior, a descendant of the AT&T cfront scheme
("getDistance__6KzUtilFP7st_unitP7st_unit"). Handles Q<n> qualified names,
the cfront type codes including T/N back-references, cv-qualifiers, and the
operator/ctor/dtor name codes.
- SN Systems SNC/ProDG ("__0f5DstdIbad_castEwhatvK"), which encodes name
component lengths as letters. Reverse engineered from a small sample, so
the parts that are guesses are marked as such - they don't affect the name.
Both are rougher than the Itanium one: they aim for a correctly qualified name
plus a plausible parameter list, and print "..." for a parameter they can't
decode rather than throwing the name away. Results come back as a
DemangledSymbol with the name, parameters, return type and qualifiers kept
separate, in case a caller wants more than the printed string.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EFV5DUTc9ZYAKgsCMZGwX8
60 lines
2.8 KiB
C++
60 lines
2.8 KiB
C++
// Copyright (c) 2026- PPSSPP Project.
|
|
|
|
// 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
|
|
// the Free Software Foundation, version 2.0 or later versions.
|
|
|
|
// This program is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License 2.0 for more details.
|
|
|
|
// A copy of the GPL 2.0 should have been included with the program.
|
|
// If not, see http://www.gnu.org/licenses/
|
|
|
|
// Official git repository and contact information can be found at
|
|
// https://github.com/hrydgard/ppsspp and http://www.ppsspp.org/.
|
|
|
|
#pragma once
|
|
|
|
#include <string>
|
|
#include <string_view>
|
|
|
|
// Demangler for Itanium C++ ABI symbol names ("_Z..."), which is what GCC and Clang
|
|
// produce - and thus what the PSP toolchain produces. Handy for homebrew built from C++,
|
|
// where the ELF symbol table is otherwise unreadable.
|
|
//
|
|
// Handles the constructs that show up in practice, and simply fails on the rest (complex
|
|
// template expressions, mostly) rather than emitting something wrong.
|
|
|
|
// Returns false and leaves *out alone if this isn't a mangled name, or we can't parse it.
|
|
bool DemangleItanium(std::string_view mangled, std::string *out);
|
|
|
|
// The other two manglings that show up in PSP binaries, both from compilers older than the
|
|
// PSP SDK's GCC: Metrowerks CodeWarrior (a descendant of the AT&T cfront scheme) and SN
|
|
// Systems' SNC/ProDG. Both are much rougher than the Itanium demangler above - they aim to
|
|
// recover a readable, correctly qualified *name* and make a best effort at the parameter
|
|
// list, rather than to reproduce any particular tool's output byte for byte.
|
|
|
|
// A demangled symbol, kept split up so callers can use the parts. The Itanium demangler
|
|
// doesn't fill this in (it prints straight to a string); the two below do.
|
|
struct DemangledSymbol {
|
|
std::string name; // Qualified, no parameters: "ANIMEData::operator=".
|
|
std::string parameters; // What goes between the parens. Empty means "()".
|
|
std::string returnType; // Usually empty - neither format encodes it in most cases.
|
|
std::string qualifiers; // "const" and friends, printed after the parameter list.
|
|
bool isFunction = false; // False for data symbols, where there are no parens at all.
|
|
|
|
std::string ToString() const;
|
|
};
|
|
|
|
// Metrowerks CodeWarrior: "getDistance__6KzUtilFP7st_unitP7st_unit".
|
|
bool DemangleCodeWarrior(std::string_view mangled, DemangledSymbol *out);
|
|
|
|
// SN Systems (SNC/ProDG): "__0f5DstdIbad_castEwhatvK".
|
|
bool DemangleSNSystems(std::string_view mangled, DemangledSymbol *out);
|
|
|
|
// Convenience wrapper: tries all three manglings and returns the demangled name, or a
|
|
// copy of the input if it isn't something we can demangle.
|
|
std::string DemangleSymbolName(std::string_view name);
|