124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//===-- SymbolFile.h --------------------------------------------*- C++ -*-===// 224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// The LLVM Compiler Infrastructure 424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// This file is distributed under the University of Illinois Open Source 624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// License. See LICENSE.TXT for details. 724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//===----------------------------------------------------------------------===// 924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#ifndef liblldb_SymbolFile_h_ 1124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#define liblldb_SymbolFile_h_ 1224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/lldb-private.h" 1424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Core/PluginInterface.h" 156916e358c9725b75ed91f31236c147f26c9af10eGreg Clayton#include "lldb/Symbol/ClangASTType.h" 166916e358c9725b75ed91f31236c147f26c9af10eGreg Clayton#include "lldb/Symbol/ClangNamespaceDecl.h" 1724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Symbol/Type.h" 1824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnernamespace lldb_private { 2024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerclass SymbolFile : 2224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner public PluginInterface 2324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 2424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerpublic: 259e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton //------------------------------------------------------------------ 269e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton // Symbol file ability bits. 279e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton // 289e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton // Each symbol file can claim to support one or more symbol file 299e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton // abilities. These get returned from SymbolFile::GetAbilities(). 309e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton // These help us to determine which plug-in will be best to load 319e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton // the debug information found in files. 329e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton //------------------------------------------------------------------ 3324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner enum Abilities 3424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 359e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton CompileUnits = (1u << 0), 369e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton LineTables = (1u << 1), 379e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton Functions = (1u << 2), 389e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton Blocks = (1u << 3), 399e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton GlobalVariables = (1u << 4), 409e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton LocalVariables = (1u << 5), 419e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton VariableTypes = (1u << 6), 429e8865ee73f1c3decad554809368e8779b8c3e98Greg Clayton kAllAbilities =((1u << 7) - 1u) 4324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner }; 4424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner static SymbolFile * 4624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner FindPlugin (ObjectFile* obj_file); 4724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 4824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 4924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Constructors and Destructors 5024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 5124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner SymbolFile(ObjectFile* obj_file) : 52d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan m_obj_file(obj_file), 53d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan m_abilities(0), 54d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan m_calculated_abilities(false) 5524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 5624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 5724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 5824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual 5924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner ~SymbolFile() 6024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 6124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 6224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 63b01000fd063629facd45044f137446fb748ee179Greg Clayton //------------------------------------------------------------------ 64b01000fd063629facd45044f137446fb748ee179Greg Clayton /// Get a mask of what this symbol file supports for the object file 65b01000fd063629facd45044f137446fb748ee179Greg Clayton /// that it was constructed with. 66b01000fd063629facd45044f137446fb748ee179Greg Clayton /// 67b01000fd063629facd45044f137446fb748ee179Greg Clayton /// Each symbol file gets to respond with a mask of abilities that 68b01000fd063629facd45044f137446fb748ee179Greg Clayton /// it supports for each object file. This happens when we are 69b01000fd063629facd45044f137446fb748ee179Greg Clayton /// trying to figure out which symbol file plug-in will get used 70b01000fd063629facd45044f137446fb748ee179Greg Clayton /// for a given object file. The plug-in that resoonds with the 71b01000fd063629facd45044f137446fb748ee179Greg Clayton /// best mix of "SymbolFile::Abilities" bits set, will get chosen to 72b01000fd063629facd45044f137446fb748ee179Greg Clayton /// be the symbol file parser. This allows each plug-in to check for 73b01000fd063629facd45044f137446fb748ee179Greg Clayton /// sections that contain data a symbol file plug-in would need. For 74b01000fd063629facd45044f137446fb748ee179Greg Clayton /// example the DWARF plug-in requires DWARF sections in a file that 75b01000fd063629facd45044f137446fb748ee179Greg Clayton /// contain debug information. If the DWARF plug-in doesn't find 76b01000fd063629facd45044f137446fb748ee179Greg Clayton /// these sections, it won't respond with many ability bits set, and 77b01000fd063629facd45044f137446fb748ee179Greg Clayton /// we will probably fall back to the symbol table SymbolFile plug-in 78b01000fd063629facd45044f137446fb748ee179Greg Clayton /// which uses any information in the symbol table. Also, plug-ins 79b01000fd063629facd45044f137446fb748ee179Greg Clayton /// might check for some specific symbols in a symbol table in the 80b01000fd063629facd45044f137446fb748ee179Greg Clayton /// case where the symbol table contains debug information (STABS 81b01000fd063629facd45044f137446fb748ee179Greg Clayton /// and COFF). Not a lot of work should happen in these functions 82b01000fd063629facd45044f137446fb748ee179Greg Clayton /// as the plug-in might not get selected due to another plug-in 83b01000fd063629facd45044f137446fb748ee179Greg Clayton /// having more abilities. Any initialization work should be saved 84b01000fd063629facd45044f137446fb748ee179Greg Clayton /// for "void SymbolFile::InitializeObject()" which will get called 85b01000fd063629facd45044f137446fb748ee179Greg Clayton /// on the SymbolFile object with the best set of abilities. 86b01000fd063629facd45044f137446fb748ee179Greg Clayton /// 87b01000fd063629facd45044f137446fb748ee179Greg Clayton /// @return 88b01000fd063629facd45044f137446fb748ee179Greg Clayton /// A uint32_t mask containing bits from the SymbolFile::Abilities 89b01000fd063629facd45044f137446fb748ee179Greg Clayton /// enumeration. Any bits that are set represent an ability that 90b01000fd063629facd45044f137446fb748ee179Greg Clayton /// this symbol plug-in can parse from the object file. 91b01000fd063629facd45044f137446fb748ee179Greg Clayton ///------------------------------------------------------------------ 92d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan uint32_t GetAbilities () 93d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan { 94d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan if (!m_calculated_abilities) 95d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan { 96d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan m_abilities = CalculateAbilities(); 97d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan m_calculated_abilities = true; 98d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan } 99d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan 100d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan return m_abilities; 101d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan } 102d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan 103d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan virtual uint32_t CalculateAbilities() = 0; 104b01000fd063629facd45044f137446fb748ee179Greg Clayton 105b01000fd063629facd45044f137446fb748ee179Greg Clayton //------------------------------------------------------------------ 106b01000fd063629facd45044f137446fb748ee179Greg Clayton /// Initialize the SymbolFile object. 107b01000fd063629facd45044f137446fb748ee179Greg Clayton /// 108b01000fd063629facd45044f137446fb748ee179Greg Clayton /// The SymbolFile object with the best set of abilities (detected 109b01000fd063629facd45044f137446fb748ee179Greg Clayton /// in "uint32_t SymbolFile::GetAbilities()) will have this function 110b01000fd063629facd45044f137446fb748ee179Greg Clayton /// called if it is chosen to parse an object file. More complete 111b01000fd063629facd45044f137446fb748ee179Greg Clayton /// initialization can happen in this function which will get called 112b01000fd063629facd45044f137446fb748ee179Greg Clayton /// prior to any other functions in the SymbolFile protocol. 113b01000fd063629facd45044f137446fb748ee179Greg Clayton //------------------------------------------------------------------ 114b01000fd063629facd45044f137446fb748ee179Greg Clayton virtual void InitializeObject() {} 11524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 11624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 11724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Compile Unit function calls 11824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner //------------------------------------------------------------------ 11924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // Approach 1 - iterator 12024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t GetNumCompileUnits() = 0; 12124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual lldb::CompUnitSP ParseCompileUnitAtIndex(uint32_t index) = 0; 12224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 12349ce8969d3154e1560106cfe530444c09410f217Greg Clayton virtual lldb::LanguageType ParseCompileUnitLanguage (const SymbolContext& sc) = 0; 12424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t ParseCompileUnitFunctions (const SymbolContext& sc) = 0; 12524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool ParseCompileUnitLineTable (const SymbolContext& sc) = 0; 12624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual bool ParseCompileUnitSupportFiles (const SymbolContext& sc, FileSpecList& support_files) = 0; 12724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t ParseFunctionBlocks (const SymbolContext& sc) = 0; 12824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t ParseTypes (const SymbolContext& sc) = 0; 12924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual size_t ParseVariablesForContext (const SymbolContext& sc) = 0; 13024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual Type* ResolveTypeUID (lldb::user_id_t type_uid) = 0; 13152f792329be5db8e38961350589e97e8f2823acdGreg Clayton virtual bool ResolveClangOpaqueTypeDefinition (ClangASTType &clang_type) = 0; 132c617a4cb4a451be9d7e97d7af6e165d282b5390fSean Callanan virtual clang::DeclContext* GetClangDeclContextForTypeUID (const lldb_private::SymbolContext &sc, lldb::user_id_t type_uid) { return NULL; } 133c617a4cb4a451be9d7e97d7af6e165d282b5390fSean Callanan virtual clang::DeclContext* GetClangDeclContextContainingTypeUID (lldb::user_id_t type_uid) { return NULL; } 13424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t ResolveSymbolContext (const Address& so_addr, uint32_t resolve_scope, SymbolContext& sc) = 0; 13524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t ResolveSymbolContext (const FileSpec& file_spec, uint32_t line, bool check_inlines, uint32_t resolve_scope, SymbolContextList& sc_list) = 0; 1360fcec13c6639ab49216fa9447b25888b7bc9ff59Sean Callanan virtual uint32_t FindGlobalVariables (const ConstString &name, const ClangNamespaceDecl *namespace_decl, bool append, uint32_t max_matches, VariableList& variables) = 0; 13724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner virtual uint32_t FindGlobalVariables (const RegularExpression& regex, bool append, uint32_t max_matches, VariableList& variables) = 0; 138302d78c71902398ce1f422bd09216dd53a6abb88Sean Callanan virtual uint32_t FindFunctions (const ConstString &name, const ClangNamespaceDecl *namespace_decl, uint32_t name_type_mask, bool include_inlines, bool append, SymbolContextList& sc_list) = 0; 139302d78c71902398ce1f422bd09216dd53a6abb88Sean Callanan virtual uint32_t FindFunctions (const RegularExpression& regex, bool include_inlines, bool append, SymbolContextList& sc_list) = 0; 1400fcec13c6639ab49216fa9447b25888b7bc9ff59Sean Callanan virtual uint32_t FindTypes (const SymbolContext& sc, const ConstString &name, const ClangNamespaceDecl *namespace_decl, bool append, uint32_t max_matches, TypeList& types) = 0; 141960d6a40711f05effe6fcc5b66f0952450f79ea2Greg Clayton// virtual uint32_t FindTypes (const SymbolContext& sc, const RegularExpression& regex, bool append, uint32_t max_matches, TypeList& types) = 0; 142e98ac25604b3d967158917f6fdd5289b3096fd80Greg Clayton virtual TypeList * GetTypeList (); 143a8b56238ce138e70433a0ce0b4218c9257beae38Greg Clayton virtual size_t GetTypes (lldb_private::SymbolContextScope *sc_scope, 144a8b56238ce138e70433a0ce0b4218c9257beae38Greg Clayton uint32_t type_mask, 145a8b56238ce138e70433a0ce0b4218c9257beae38Greg Clayton lldb_private::TypeList &type_list) = 0; 146b01000fd063629facd45044f137446fb748ee179Greg Clayton virtual ClangASTContext & 147b01000fd063629facd45044f137446fb748ee179Greg Clayton GetClangASTContext (); 1486916e358c9725b75ed91f31236c147f26c9af10eGreg Clayton virtual ClangNamespaceDecl 149d7cb26e87841731c6452a9f2e997ed0f9c92625cGreg Clayton FindNamespace (const SymbolContext& sc, 1500fcec13c6639ab49216fa9447b25888b7bc9ff59Sean Callanan const ConstString &name, 1510fcec13c6639ab49216fa9447b25888b7bc9ff59Sean Callanan const ClangNamespaceDecl *parent_namespace_decl) = 0; 15224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 153960d6a40711f05effe6fcc5b66f0952450f79ea2Greg Clayton ObjectFile* GetObjectFile() { return m_obj_file; } 15424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner const ObjectFile* GetObjectFile() const { return m_obj_file; } 15575d8c2591f6c56a09338bf4967a41510165a907eGreg Clayton 15624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprotected: 157b01000fd063629facd45044f137446fb748ee179Greg Clayton ObjectFile* m_obj_file; // The object file that symbols can be extracted from. 158d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan uint32_t m_abilities; 159d0b7cfa22722fdaf4111a61d6eeb02a587710e16Sean Callanan bool m_calculated_abilities; 16024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerprivate: 16124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner DISALLOW_COPY_AND_ASSIGN (SymbolFile); 16224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner}; 16324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 16424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 16524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} // namespace lldb_private 16624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 16724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#endif // liblldb_SymbolFile_h_ 168