1 //===- NativeSession.cpp - Native implementation of IPDBSession -*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #include "llvm/DebugInfo/PDB/Native/NativeSession.h"
12 #include "llvm/ADT/STLExtras.h"
13 #include "llvm/DebugInfo/CodeView/TypeIndex.h"
14 #include "llvm/DebugInfo/PDB/GenericError.h"
15 #include "llvm/DebugInfo/PDB/IPDBEnumChildren.h"
16 #include "llvm/DebugInfo/PDB/IPDBSourceFile.h"
17 #include "llvm/DebugInfo/PDB/Native/NativeBuiltinSymbol.h"
18 #include "llvm/DebugInfo/PDB/Native/NativeCompilandSymbol.h"
19 #include "llvm/DebugInfo/PDB/Native/NativeEnumSymbol.h"
20 #include "llvm/DebugInfo/PDB/Native/NativeEnumTypes.h"
21 #include "llvm/DebugInfo/PDB/Native/NativeExeSymbol.h"
22 #include "llvm/DebugInfo/PDB/Native/PDBFile.h"
23 #include "llvm/DebugInfo/PDB/Native/RawError.h"
24 #include "llvm/DebugInfo/PDB/Native/TpiStream.h"
25 #include "llvm/DebugInfo/PDB/PDBSymbolCompiland.h"
26 #include "llvm/DebugInfo/PDB/PDBSymbolExe.h"
27 #include "llvm/DebugInfo/PDB/PDBSymbolTypeEnum.h"
28 #include "llvm/Support/Allocator.h"
29 #include "llvm/Support/BinaryByteStream.h"
30 #include "llvm/Support/Error.h"
31 #include "llvm/Support/ErrorOr.h"
32 #include "llvm/Support/MemoryBuffer.h"
40 using namespace llvm::msf;
41 using namespace llvm::pdb;
44 // Maps codeview::SimpleTypeKind of a built-in type to the parameters necessary
45 // to instantiate a NativeBuiltinSymbol for that type.
46 static const struct BuiltinTypeEntry {
47 codeview::SimpleTypeKind Kind;
51 {codeview::SimpleTypeKind::Int32, PDB_BuiltinType::Int, 4},
52 {codeview::SimpleTypeKind::UInt32, PDB_BuiltinType::UInt, 4},
53 {codeview::SimpleTypeKind::UInt32Long, PDB_BuiltinType::UInt, 4},
54 {codeview::SimpleTypeKind::UInt64Quad, PDB_BuiltinType::UInt, 8},
55 {codeview::SimpleTypeKind::NarrowCharacter, PDB_BuiltinType::Char, 1},
56 {codeview::SimpleTypeKind::SignedCharacter, PDB_BuiltinType::Char, 1},
57 {codeview::SimpleTypeKind::UnsignedCharacter, PDB_BuiltinType::UInt, 1},
58 {codeview::SimpleTypeKind::UInt16Short, PDB_BuiltinType::UInt, 2},
59 {codeview::SimpleTypeKind::Boolean8, PDB_BuiltinType::Bool, 1}
60 // This table can be grown as necessary, but these are the only types we've
65 NativeSession::NativeSession(std::unique_ptr<PDBFile> PdbFile,
66 std::unique_ptr<BumpPtrAllocator> Allocator)
67 : Pdb(std::move(PdbFile)), Allocator(std::move(Allocator)) {}
69 NativeSession::~NativeSession() = default;
71 Error NativeSession::createFromPdb(std::unique_ptr<MemoryBuffer> Buffer,
72 std::unique_ptr<IPDBSession> &Session) {
73 StringRef Path = Buffer->getBufferIdentifier();
74 auto Stream = llvm::make_unique<MemoryBufferByteStream>(
75 std::move(Buffer), llvm::support::little);
77 auto Allocator = llvm::make_unique<BumpPtrAllocator>();
78 auto File = llvm::make_unique<PDBFile>(Path, std::move(Stream), *Allocator);
79 if (auto EC = File->parseFileHeaders())
81 if (auto EC = File->parseStreamData())
85 llvm::make_unique<NativeSession>(std::move(File), std::move(Allocator));
87 return Error::success();
90 Error NativeSession::createFromExe(StringRef Path,
91 std::unique_ptr<IPDBSession> &Session) {
92 return make_error<RawError>(raw_error_code::feature_unsupported);
95 std::unique_ptr<PDBSymbolCompiland>
96 NativeSession::createCompilandSymbol(DbiModuleDescriptor MI) {
97 const auto Id = static_cast<SymIndexId>(SymbolCache.size());
98 SymbolCache.push_back(
99 llvm::make_unique<NativeCompilandSymbol>(*this, Id, MI));
100 return llvm::make_unique<PDBSymbolCompiland>(
101 *this, std::unique_ptr<IPDBRawSymbol>(SymbolCache[Id]->clone()));
104 std::unique_ptr<PDBSymbolTypeEnum>
105 NativeSession::createEnumSymbol(codeview::TypeIndex Index) {
106 const auto Id = findSymbolByTypeIndex(Index);
107 return llvm::make_unique<PDBSymbolTypeEnum>(
108 *this, std::unique_ptr<IPDBRawSymbol>(SymbolCache[Id]->clone()));
111 std::unique_ptr<IPDBEnumSymbols>
112 NativeSession::createTypeEnumerator(codeview::TypeLeafKind Kind) {
113 auto Tpi = Pdb->getPDBTpiStream();
115 consumeError(Tpi.takeError());
118 auto &Types = Tpi->typeCollection();
119 return std::unique_ptr<IPDBEnumSymbols>(
120 new NativeEnumTypes(*this, Types, codeview::LF_ENUM));
123 SymIndexId NativeSession::findSymbolByTypeIndex(codeview::TypeIndex Index) {
124 // First see if it's already in our cache.
125 const auto Entry = TypeIndexToSymbolId.find(Index);
126 if (Entry != TypeIndexToSymbolId.end())
127 return Entry->second;
129 // Symbols for built-in types are created on the fly.
130 if (Index.isSimple()) {
131 // FIXME: We will eventually need to handle pointers to other simple types,
132 // which are still simple types in the world of CodeView TypeIndexes.
133 if (Index.getSimpleMode() != codeview::SimpleTypeMode::Direct)
135 const auto Kind = Index.getSimpleKind();
137 std::find_if(std::begin(BuiltinTypes), std::end(BuiltinTypes),
138 [Kind](const BuiltinTypeEntry &Builtin) {
139 return Builtin.Kind == Kind;
141 if (It == std::end(BuiltinTypes))
143 SymIndexId Id = SymbolCache.size();
144 SymbolCache.emplace_back(
145 llvm::make_unique<NativeBuiltinSymbol>(*this, Id, It->Type, It->Size));
146 TypeIndexToSymbolId[Index] = Id;
150 // We need to instantiate and cache the desired type symbol.
151 auto Tpi = Pdb->getPDBTpiStream();
153 consumeError(Tpi.takeError());
156 auto &Types = Tpi->typeCollection();
157 const auto &I = Types.getType(Index);
158 const auto Id = static_cast<SymIndexId>(SymbolCache.size());
159 // TODO(amccarth): Make this handle all types, not just LF_ENUMs.
160 assert(I.kind() == codeview::LF_ENUM);
161 SymbolCache.emplace_back(llvm::make_unique<NativeEnumSymbol>(*this, Id, I));
162 TypeIndexToSymbolId[Index] = Id;
166 uint64_t NativeSession::getLoadAddress() const { return 0; }
168 void NativeSession::setLoadAddress(uint64_t Address) {}
170 std::unique_ptr<PDBSymbolExe> NativeSession::getGlobalScope() {
171 const auto Id = static_cast<SymIndexId>(SymbolCache.size());
172 SymbolCache.push_back(llvm::make_unique<NativeExeSymbol>(*this, Id));
173 auto RawSymbol = SymbolCache[Id]->clone();
174 auto PdbSymbol(PDBSymbol::create(*this, std::move(RawSymbol)));
175 std::unique_ptr<PDBSymbolExe> ExeSymbol(
176 static_cast<PDBSymbolExe *>(PdbSymbol.release()));
180 std::unique_ptr<PDBSymbol>
181 NativeSession::getSymbolById(uint32_t SymbolId) const {
182 // If the caller has a SymbolId, it'd better be in our SymbolCache.
183 return SymbolId < SymbolCache.size()
184 ? PDBSymbol::create(*this, SymbolCache[SymbolId]->clone())
188 std::unique_ptr<PDBSymbol>
189 NativeSession::findSymbolByAddress(uint64_t Address, PDB_SymType Type) const {
193 std::unique_ptr<IPDBEnumLineNumbers>
194 NativeSession::findLineNumbers(const PDBSymbolCompiland &Compiland,
195 const IPDBSourceFile &File) const {
199 std::unique_ptr<IPDBEnumLineNumbers>
200 NativeSession::findLineNumbersByAddress(uint64_t Address,
201 uint32_t Length) const {
205 std::unique_ptr<IPDBEnumSourceFiles>
206 NativeSession::findSourceFiles(const PDBSymbolCompiland *Compiland,
208 PDB_NameSearchFlags Flags) const {
212 std::unique_ptr<IPDBSourceFile>
213 NativeSession::findOneSourceFile(const PDBSymbolCompiland *Compiland,
215 PDB_NameSearchFlags Flags) const {
219 std::unique_ptr<IPDBEnumChildren<PDBSymbolCompiland>>
220 NativeSession::findCompilandsForSourceFile(StringRef Pattern,
221 PDB_NameSearchFlags Flags) const {
225 std::unique_ptr<PDBSymbolCompiland>
226 NativeSession::findOneCompilandForSourceFile(StringRef Pattern,
227 PDB_NameSearchFlags Flags) const {
231 std::unique_ptr<IPDBEnumSourceFiles> NativeSession::getAllSourceFiles() const {
235 std::unique_ptr<IPDBEnumSourceFiles> NativeSession::getSourceFilesForCompiland(
236 const PDBSymbolCompiland &Compiland) const {
240 std::unique_ptr<IPDBSourceFile>
241 NativeSession::getSourceFileById(uint32_t FileId) const {
245 std::unique_ptr<IPDBEnumDataStreams> NativeSession::getDebugStreams() const {
249 std::unique_ptr<IPDBEnumTables> NativeSession::getEnumTables() const {