// Copyright (c) 2010 Google Inc. // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // Original author: Jim Blandy // language.cc: Subclasses and singletons for google_breakpad::Language. // See language.h for details. #include "common/language.h" #include #if !defined(__ANDROID__) #include #endif #if defined(HAVE_RUST_DEMANGLE) #include #endif #include namespace { string MakeQualifiedNameWithSeparator(const string& parent_name, const char* separator, const string& name) { if (parent_name.empty()) { return name; } return parent_name + separator + name; } } // namespace namespace google_breakpad { // C++ language-specific operations. class CPPLanguage: public Language { public: CPPLanguage() {} string MakeQualifiedName(const string& parent_name, const string& name) const { return MakeQualifiedNameWithSeparator(parent_name, "::", name); } virtual DemangleResult DemangleName(const string& mangled, string* demangled) const { #if defined(__ANDROID__) // Android NDK doesn't provide abi::__cxa_demangle. demangled->clear(); return kDontDemangle; #else // Attempting to demangle non-C++ symbols with the C++ demangler would print // warnings and fail, so return kDontDemangle for these. if (!IsMangledName(mangled)) { demangled->clear(); return kDontDemangle; } int status; char* demangled_c = abi::__cxa_demangle(mangled.c_str(), NULL, NULL, &status); DemangleResult result; if (status == 0) { result = kDemangleSuccess; demangled->assign(demangled_c); } else { result = kDemangleFailure; demangled->clear(); } if (demangled_c) { free(reinterpret_cast(demangled_c)); } return result; #endif } private: static bool IsMangledName(const string& name) { // NOTE: For proper cross-compilation support, this should depend on target // binary's platform, not current build platform. #if defined(__APPLE__) // Mac C++ symbols can have up to 4 underscores, followed by a "Z". // Non-C++ symbols are not coded that way, but may have leading underscores. size_t i = name.find_first_not_of('_'); return i > 0 && i != string::npos && i <= 4 && name[i] == 'Z'; #else // Linux C++ symbols always start with "_Z". return name.size() > 2 && name[0] == '_' && name[1] == 'Z'; #endif } }; CPPLanguage CPPLanguageSingleton; // Java language-specific operations. class JavaLanguage: public Language { public: JavaLanguage() {} string MakeQualifiedName(const string& parent_name, const string& name) const { return MakeQualifiedNameWithSeparator(parent_name, ".", name); } }; JavaLanguage JavaLanguageSingleton; // Swift language-specific operations. class SwiftLanguage: public Language { public: SwiftLanguage() {} string MakeQualifiedName(const string& parent_name, const string& name) const { return MakeQualifiedNameWithSeparator(parent_name, ".", name); } virtual DemangleResult DemangleName(const string& mangled, string* demangled) const { // There is no programmatic interface to a Swift demangler. Pass through the // mangled form because it encodes more information than the qualified name // that would have been built by MakeQualifiedName(). The output can be // post-processed by xcrun swift-demangle to transform mangled Swift names // into something more readable. demangled->assign(mangled); return kDemangleSuccess; } }; SwiftLanguage SwiftLanguageSingleton; // Rust language-specific operations. class RustLanguage: public Language { public: RustLanguage() {} string MakeQualifiedName(const string& parent_name, const string& name) const { return MakeQualifiedNameWithSeparator(parent_name, ".", name); } virtual DemangleResult DemangleName(const string& mangled, string* demangled) const { // Rust names use GCC C++ name mangling, but demangling them with // abi_demangle doesn't produce stellar results due to them having // another layer of encoding. // If callers provide rustc-demangle, use that. #if defined(HAVE_RUST_DEMANGLE) char* rust_demangled = rust_demangle(mangled.c_str()); if (rust_demangled == nullptr) { return kDemangleFailure; } demangled->assign(rust_demangled); free_rust_demangled_name(rust_demangled); #else // Otherwise, pass through the mangled name so callers can demangle // after the fact. demangled->assign(mangled); #endif return kDemangleSuccess; } }; RustLanguage RustLanguageSingleton; // Assembler language-specific operations. class AssemblerLanguage: public Language { public: AssemblerLanguage() {} bool HasFunctions() const { return false; } string MakeQualifiedName(const string& parent_name, const string& name) const { return name; } }; AssemblerLanguage AssemblerLanguageSingleton; const Language * const Language::CPlusPlus = &CPPLanguageSingleton; const Language * const Language::Java = &JavaLanguageSingleton; const Language * const Language::Swift = &SwiftLanguageSingleton; const Language * const Language::Rust = &RustLanguageSingleton; const Language * const Language::Assembler = &AssemblerLanguageSingleton; } // namespace google_breakpad