1 //===-- SymbolFilePDB.cpp ---------------------------------------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "SymbolFilePDB.h"
10 
11 #include "PDBASTParser.h"
12 #include "PDBLocationToDWARFExpression.h"
13 
14 #include "clang/Lex/Lexer.h"
15 
16 #include "lldb/Core/Module.h"
17 #include "lldb/Core/PluginManager.h"
18 #include "lldb/Symbol/ClangASTContext.h"
19 #include "lldb/Symbol/CompileUnit.h"
20 #include "lldb/Symbol/LineTable.h"
21 #include "lldb/Symbol/ObjectFile.h"
22 #include "lldb/Symbol/SymbolContext.h"
23 #include "lldb/Symbol/SymbolVendor.h"
24 #include "lldb/Symbol/TypeList.h"
25 #include "lldb/Symbol/TypeMap.h"
26 #include "lldb/Symbol/Variable.h"
27 #include "lldb/Utility/Log.h"
28 #include "lldb/Utility/RegularExpression.h"
29 
30 #include "llvm/DebugInfo/PDB/GenericError.h"
31 #include "llvm/DebugInfo/PDB/IPDBDataStream.h"
32 #include "llvm/DebugInfo/PDB/IPDBEnumChildren.h"
33 #include "llvm/DebugInfo/PDB/IPDBLineNumber.h"
34 #include "llvm/DebugInfo/PDB/IPDBSectionContrib.h"
35 #include "llvm/DebugInfo/PDB/IPDBSourceFile.h"
36 #include "llvm/DebugInfo/PDB/IPDBTable.h"
37 #include "llvm/DebugInfo/PDB/PDBSymbol.h"
38 #include "llvm/DebugInfo/PDB/PDBSymbolBlock.h"
39 #include "llvm/DebugInfo/PDB/PDBSymbolCompiland.h"
40 #include "llvm/DebugInfo/PDB/PDBSymbolCompilandDetails.h"
41 #include "llvm/DebugInfo/PDB/PDBSymbolData.h"
42 #include "llvm/DebugInfo/PDB/PDBSymbolExe.h"
43 #include "llvm/DebugInfo/PDB/PDBSymbolFunc.h"
44 #include "llvm/DebugInfo/PDB/PDBSymbolFuncDebugEnd.h"
45 #include "llvm/DebugInfo/PDB/PDBSymbolFuncDebugStart.h"
46 #include "llvm/DebugInfo/PDB/PDBSymbolPublicSymbol.h"
47 #include "llvm/DebugInfo/PDB/PDBSymbolTypeEnum.h"
48 #include "llvm/DebugInfo/PDB/PDBSymbolTypeTypedef.h"
49 #include "llvm/DebugInfo/PDB/PDBSymbolTypeUDT.h"
50 
51 #include "Plugins/Language/CPlusPlus/CPlusPlusLanguage.h"
52 #include "Plugins/Language/CPlusPlus/MSVCUndecoratedNameParser.h"
53 #include "Plugins/SymbolFile/NativePDB/SymbolFileNativePDB.h"
54 
55 #include <regex>
56 
57 using namespace lldb;
58 using namespace lldb_private;
59 using namespace llvm::pdb;
60 
61 namespace {
62 lldb::LanguageType TranslateLanguage(PDB_Lang lang) {
63   switch (lang) {
64   case PDB_Lang::Cpp:
65     return lldb::LanguageType::eLanguageTypeC_plus_plus;
66   case PDB_Lang::C:
67     return lldb::LanguageType::eLanguageTypeC;
68   case PDB_Lang::Swift:
69     return lldb::LanguageType::eLanguageTypeSwift;
70   default:
71     return lldb::LanguageType::eLanguageTypeUnknown;
72   }
73 }
74 
75 bool ShouldAddLine(uint32_t requested_line, uint32_t actual_line,
76                    uint32_t addr_length) {
77   return ((requested_line == 0 || actual_line == requested_line) &&
78           addr_length > 0);
79 }
80 } // namespace
81 
82 static bool ShouldUseNativeReader() {
83 #if defined(_WIN32)
84   llvm::StringRef use_native = ::getenv("LLDB_USE_NATIVE_PDB_READER");
85   return use_native.equals_lower("on") || use_native.equals_lower("yes") ||
86          use_native.equals_lower("1") || use_native.equals_lower("true");
87 #else
88   return true;
89 #endif
90 }
91 
92 void SymbolFilePDB::Initialize() {
93   if (ShouldUseNativeReader()) {
94     npdb::SymbolFileNativePDB::Initialize();
95   } else {
96     PluginManager::RegisterPlugin(GetPluginNameStatic(),
97                                   GetPluginDescriptionStatic(), CreateInstance,
98                                   DebuggerInitialize);
99   }
100 }
101 
102 void SymbolFilePDB::Terminate() {
103   if (ShouldUseNativeReader()) {
104     npdb::SymbolFileNativePDB::Terminate();
105   } else {
106     PluginManager::UnregisterPlugin(CreateInstance);
107   }
108 }
109 
110 void SymbolFilePDB::DebuggerInitialize(lldb_private::Debugger &debugger) {}
111 
112 lldb_private::ConstString SymbolFilePDB::GetPluginNameStatic() {
113   static ConstString g_name("pdb");
114   return g_name;
115 }
116 
117 const char *SymbolFilePDB::GetPluginDescriptionStatic() {
118   return "Microsoft PDB debug symbol file reader.";
119 }
120 
121 lldb_private::SymbolFile *
122 SymbolFilePDB::CreateInstance(ObjectFileSP objfile_sp) {
123   return new SymbolFilePDB(std::move(objfile_sp));
124 }
125 
126 SymbolFilePDB::SymbolFilePDB(lldb::ObjectFileSP objfile_sp)
127     : SymbolFile(std::move(objfile_sp)), m_session_up(), m_global_scope_up() {}
128 
129 SymbolFilePDB::~SymbolFilePDB() {}
130 
131 uint32_t SymbolFilePDB::CalculateAbilities() {
132   uint32_t abilities = 0;
133   if (!m_objfile_sp)
134     return 0;
135 
136   if (!m_session_up) {
137     // Lazily load and match the PDB file, but only do this once.
138     std::string exePath = m_objfile_sp->GetFileSpec().GetPath();
139     auto error = loadDataForEXE(PDB_ReaderType::DIA, llvm::StringRef(exePath),
140                                 m_session_up);
141     if (error) {
142       llvm::consumeError(std::move(error));
143       auto module_sp = m_objfile_sp->GetModule();
144       if (!module_sp)
145         return 0;
146       // See if any symbol file is specified through `--symfile` option.
147       FileSpec symfile = module_sp->GetSymbolFileFileSpec();
148       if (!symfile)
149         return 0;
150       error = loadDataForPDB(PDB_ReaderType::DIA,
151                              llvm::StringRef(symfile.GetPath()), m_session_up);
152       if (error) {
153         llvm::consumeError(std::move(error));
154         return 0;
155       }
156     }
157   }
158   if (!m_session_up)
159     return 0;
160 
161   auto enum_tables_up = m_session_up->getEnumTables();
162   if (!enum_tables_up)
163     return 0;
164   while (auto table_up = enum_tables_up->getNext()) {
165     if (table_up->getItemCount() == 0)
166       continue;
167     auto type = table_up->getTableType();
168     switch (type) {
169     case PDB_TableType::Symbols:
170       // This table represents a store of symbols with types listed in
171       // PDBSym_Type
172       abilities |= (CompileUnits | Functions | Blocks | GlobalVariables |
173                     LocalVariables | VariableTypes);
174       break;
175     case PDB_TableType::LineNumbers:
176       abilities |= LineTables;
177       break;
178     default:
179       break;
180     }
181   }
182   return abilities;
183 }
184 
185 void SymbolFilePDB::InitializeObject() {
186   lldb::addr_t obj_load_address =
187       m_objfile_sp->GetBaseAddress().GetFileAddress();
188   lldbassert(obj_load_address && obj_load_address != LLDB_INVALID_ADDRESS);
189   m_session_up->setLoadAddress(obj_load_address);
190   if (!m_global_scope_up)
191     m_global_scope_up = m_session_up->getGlobalScope();
192   lldbassert(m_global_scope_up.get());
193 }
194 
195 uint32_t SymbolFilePDB::CalculateNumCompileUnits() {
196   auto compilands = m_global_scope_up->findAllChildren<PDBSymbolCompiland>();
197   if (!compilands)
198     return 0;
199 
200   // The linker could link *.dll (compiland language = LINK), or import
201   // *.dll. For example, a compiland with name `Import:KERNEL32.dll` could be
202   // found as a child of the global scope (PDB executable). Usually, such
203   // compilands contain `thunk` symbols in which we are not interested for
204   // now. However we still count them in the compiland list. If we perform
205   // any compiland related activity, like finding symbols through
206   // llvm::pdb::IPDBSession methods, such compilands will all be searched
207   // automatically no matter whether we include them or not.
208   uint32_t compile_unit_count = compilands->getChildCount();
209 
210   // The linker can inject an additional "dummy" compilation unit into the
211   // PDB. Ignore this special compile unit for our purposes, if it is there.
212   // It is always the last one.
213   auto last_compiland_up = compilands->getChildAtIndex(compile_unit_count - 1);
214   lldbassert(last_compiland_up.get());
215   std::string name = last_compiland_up->getName();
216   if (name == "* Linker *")
217     --compile_unit_count;
218   return compile_unit_count;
219 }
220 
221 void SymbolFilePDB::GetCompileUnitIndex(
222     const llvm::pdb::PDBSymbolCompiland &pdb_compiland, uint32_t &index) {
223   auto results_up = m_global_scope_up->findAllChildren<PDBSymbolCompiland>();
224   if (!results_up)
225     return;
226   auto uid = pdb_compiland.getSymIndexId();
227   for (uint32_t cu_idx = 0; cu_idx < GetNumCompileUnits(); ++cu_idx) {
228     auto compiland_up = results_up->getChildAtIndex(cu_idx);
229     if (!compiland_up)
230       continue;
231     if (compiland_up->getSymIndexId() == uid) {
232       index = cu_idx;
233       return;
234     }
235   }
236   index = UINT32_MAX;
237   return;
238 }
239 
240 std::unique_ptr<llvm::pdb::PDBSymbolCompiland>
241 SymbolFilePDB::GetPDBCompilandByUID(uint32_t uid) {
242   return m_session_up->getConcreteSymbolById<PDBSymbolCompiland>(uid);
243 }
244 
245 lldb::CompUnitSP SymbolFilePDB::ParseCompileUnitAtIndex(uint32_t index) {
246   if (index >= GetNumCompileUnits())
247     return CompUnitSP();
248 
249   // Assuming we always retrieve same compilands listed in same order through
250   // `PDBSymbolExe::findAllChildren` method, otherwise using `index` to get a
251   // compile unit makes no sense.
252   auto results = m_global_scope_up->findAllChildren<PDBSymbolCompiland>();
253   if (!results)
254     return CompUnitSP();
255   auto compiland_up = results->getChildAtIndex(index);
256   if (!compiland_up)
257     return CompUnitSP();
258   return ParseCompileUnitForUID(compiland_up->getSymIndexId(), index);
259 }
260 
261 lldb::LanguageType SymbolFilePDB::ParseLanguage(CompileUnit &comp_unit) {
262   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
263   auto compiland_up = GetPDBCompilandByUID(comp_unit.GetID());
264   if (!compiland_up)
265     return lldb::eLanguageTypeUnknown;
266   auto details = compiland_up->findOneChild<PDBSymbolCompilandDetails>();
267   if (!details)
268     return lldb::eLanguageTypeUnknown;
269   return TranslateLanguage(details->getLanguage());
270 }
271 
272 lldb_private::Function *
273 SymbolFilePDB::ParseCompileUnitFunctionForPDBFunc(const PDBSymbolFunc &pdb_func,
274                                                   CompileUnit &comp_unit) {
275   if (FunctionSP result = comp_unit.FindFunctionByUID(pdb_func.getSymIndexId()))
276     return result.get();
277 
278   auto file_vm_addr = pdb_func.getVirtualAddress();
279   if (file_vm_addr == LLDB_INVALID_ADDRESS || file_vm_addr == 0)
280     return nullptr;
281 
282   auto func_length = pdb_func.getLength();
283   AddressRange func_range =
284       AddressRange(file_vm_addr, func_length,
285                    GetObjectFile()->GetModule()->GetSectionList());
286   if (!func_range.GetBaseAddress().IsValid())
287     return nullptr;
288 
289   lldb_private::Type *func_type = ResolveTypeUID(pdb_func.getSymIndexId());
290   if (!func_type)
291     return nullptr;
292 
293   user_id_t func_type_uid = pdb_func.getSignatureId();
294 
295   Mangled mangled = GetMangledForPDBFunc(pdb_func);
296 
297   FunctionSP func_sp =
298       std::make_shared<Function>(&comp_unit, pdb_func.getSymIndexId(),
299                                  func_type_uid, mangled, func_type, func_range);
300 
301   comp_unit.AddFunction(func_sp);
302 
303   LanguageType lang = ParseLanguage(comp_unit);
304   auto type_system_or_err = GetTypeSystemForLanguage(lang);
305   if (auto err = type_system_or_err.takeError()) {
306     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
307                    std::move(err), "Unable to parse PDBFunc");
308     return nullptr;
309   }
310 
311   ClangASTContext *clang_type_system =
312     llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
313   if (!clang_type_system)
314     return nullptr;
315   clang_type_system->GetPDBParser()->GetDeclForSymbol(pdb_func);
316 
317   return func_sp.get();
318 }
319 
320 size_t SymbolFilePDB::ParseFunctions(CompileUnit &comp_unit) {
321   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
322   size_t func_added = 0;
323   auto compiland_up = GetPDBCompilandByUID(comp_unit.GetID());
324   if (!compiland_up)
325     return 0;
326   auto results_up = compiland_up->findAllChildren<PDBSymbolFunc>();
327   if (!results_up)
328     return 0;
329   while (auto pdb_func_up = results_up->getNext()) {
330     auto func_sp = comp_unit.FindFunctionByUID(pdb_func_up->getSymIndexId());
331     if (!func_sp) {
332       if (ParseCompileUnitFunctionForPDBFunc(*pdb_func_up, comp_unit))
333         ++func_added;
334     }
335   }
336   return func_added;
337 }
338 
339 bool SymbolFilePDB::ParseLineTable(CompileUnit &comp_unit) {
340   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
341   if (comp_unit.GetLineTable())
342     return true;
343   return ParseCompileUnitLineTable(comp_unit, 0);
344 }
345 
346 bool SymbolFilePDB::ParseDebugMacros(CompileUnit &comp_unit) {
347   // PDB doesn't contain information about macros
348   return false;
349 }
350 
351 bool SymbolFilePDB::ParseSupportFiles(
352     CompileUnit &comp_unit, lldb_private::FileSpecList &support_files) {
353 
354   // In theory this is unnecessary work for us, because all of this information
355   // is easily (and quickly) accessible from DebugInfoPDB, so caching it a
356   // second time seems like a waste.  Unfortunately, there's no good way around
357   // this short of a moderate refactor since SymbolVendor depends on being able
358   // to cache this list.
359   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
360   auto compiland_up = GetPDBCompilandByUID(comp_unit.GetID());
361   if (!compiland_up)
362     return false;
363   auto files = m_session_up->getSourceFilesForCompiland(*compiland_up);
364   if (!files || files->getChildCount() == 0)
365     return false;
366 
367   while (auto file = files->getNext()) {
368     FileSpec spec(file->getFileName(), FileSpec::Style::windows);
369     support_files.AppendIfUnique(spec);
370   }
371 
372   // LLDB uses the DWARF-like file numeration (one based),
373   // the zeroth file is the compile unit itself
374   support_files.Insert(0, comp_unit);
375 
376   return true;
377 }
378 
379 bool SymbolFilePDB::ParseImportedModules(
380     const lldb_private::SymbolContext &sc,
381     std::vector<SourceModule> &imported_modules) {
382   // PDB does not yet support module debug info
383   return false;
384 }
385 
386 static size_t ParseFunctionBlocksForPDBSymbol(
387     uint64_t func_file_vm_addr, const llvm::pdb::PDBSymbol *pdb_symbol,
388     lldb_private::Block *parent_block, bool is_top_parent) {
389   assert(pdb_symbol && parent_block);
390 
391   size_t num_added = 0;
392   switch (pdb_symbol->getSymTag()) {
393   case PDB_SymType::Block:
394   case PDB_SymType::Function: {
395     Block *block = nullptr;
396     auto &raw_sym = pdb_symbol->getRawSymbol();
397     if (auto *pdb_func = llvm::dyn_cast<PDBSymbolFunc>(pdb_symbol)) {
398       if (pdb_func->hasNoInlineAttribute())
399         break;
400       if (is_top_parent)
401         block = parent_block;
402       else
403         break;
404     } else if (llvm::dyn_cast<PDBSymbolBlock>(pdb_symbol)) {
405       auto uid = pdb_symbol->getSymIndexId();
406       if (parent_block->FindBlockByID(uid))
407         break;
408       if (raw_sym.getVirtualAddress() < func_file_vm_addr)
409         break;
410 
411       auto block_sp = std::make_shared<Block>(pdb_symbol->getSymIndexId());
412       parent_block->AddChild(block_sp);
413       block = block_sp.get();
414     } else
415       llvm_unreachable("Unexpected PDB symbol!");
416 
417     block->AddRange(Block::Range(
418         raw_sym.getVirtualAddress() - func_file_vm_addr, raw_sym.getLength()));
419     block->FinalizeRanges();
420     ++num_added;
421 
422     auto results_up = pdb_symbol->findAllChildren();
423     if (!results_up)
424       break;
425     while (auto symbol_up = results_up->getNext()) {
426       num_added += ParseFunctionBlocksForPDBSymbol(
427           func_file_vm_addr, symbol_up.get(), block, false);
428     }
429   } break;
430   default:
431     break;
432   }
433   return num_added;
434 }
435 
436 size_t SymbolFilePDB::ParseBlocksRecursive(Function &func) {
437   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
438   size_t num_added = 0;
439   auto uid = func.GetID();
440   auto pdb_func_up = m_session_up->getConcreteSymbolById<PDBSymbolFunc>(uid);
441   if (!pdb_func_up)
442     return 0;
443   Block &parent_block = func.GetBlock(false);
444   num_added = ParseFunctionBlocksForPDBSymbol(
445       pdb_func_up->getVirtualAddress(), pdb_func_up.get(), &parent_block, true);
446   return num_added;
447 }
448 
449 size_t SymbolFilePDB::ParseTypes(CompileUnit &comp_unit) {
450   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
451 
452   size_t num_added = 0;
453   auto compiland = GetPDBCompilandByUID(comp_unit.GetID());
454   if (!compiland)
455     return 0;
456 
457   auto ParseTypesByTagFn = [&num_added, this](const PDBSymbol &raw_sym) {
458     std::unique_ptr<IPDBEnumSymbols> results;
459     PDB_SymType tags_to_search[] = {PDB_SymType::Enum, PDB_SymType::Typedef,
460                                     PDB_SymType::UDT};
461     for (auto tag : tags_to_search) {
462       results = raw_sym.findAllChildren(tag);
463       if (!results || results->getChildCount() == 0)
464         continue;
465       while (auto symbol = results->getNext()) {
466         switch (symbol->getSymTag()) {
467         case PDB_SymType::Enum:
468         case PDB_SymType::UDT:
469         case PDB_SymType::Typedef:
470           break;
471         default:
472           continue;
473         }
474 
475         // This should cause the type to get cached and stored in the `m_types`
476         // lookup.
477         if (auto type = ResolveTypeUID(symbol->getSymIndexId())) {
478           // Resolve the type completely to avoid a completion
479           // (and so a list change, which causes an iterators invalidation)
480           // during a TypeList dumping
481           type->GetFullCompilerType();
482           ++num_added;
483         }
484       }
485     }
486   };
487 
488   ParseTypesByTagFn(*compiland);
489 
490   // Also parse global types particularly coming from this compiland.
491   // Unfortunately, PDB has no compiland information for each global type. We
492   // have to parse them all. But ensure we only do this once.
493   static bool parse_all_global_types = false;
494   if (!parse_all_global_types) {
495     ParseTypesByTagFn(*m_global_scope_up);
496     parse_all_global_types = true;
497   }
498   return num_added;
499 }
500 
501 size_t
502 SymbolFilePDB::ParseVariablesForContext(const lldb_private::SymbolContext &sc) {
503   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
504   if (!sc.comp_unit)
505     return 0;
506 
507   size_t num_added = 0;
508   if (sc.function) {
509     auto pdb_func = m_session_up->getConcreteSymbolById<PDBSymbolFunc>(
510         sc.function->GetID());
511     if (!pdb_func)
512       return 0;
513 
514     num_added += ParseVariables(sc, *pdb_func);
515     sc.function->GetBlock(false).SetDidParseVariables(true, true);
516   } else if (sc.comp_unit) {
517     auto compiland = GetPDBCompilandByUID(sc.comp_unit->GetID());
518     if (!compiland)
519       return 0;
520 
521     if (sc.comp_unit->GetVariableList(false))
522       return 0;
523 
524     auto results = m_global_scope_up->findAllChildren<PDBSymbolData>();
525     if (results && results->getChildCount()) {
526       while (auto result = results->getNext()) {
527         auto cu_id = GetCompilandId(*result);
528         // FIXME: We are not able to determine variable's compile unit.
529         if (cu_id == 0)
530           continue;
531 
532         if (cu_id == sc.comp_unit->GetID())
533           num_added += ParseVariables(sc, *result);
534       }
535     }
536 
537     // FIXME: A `file static` or `global constant` variable appears both in
538     // compiland's children and global scope's children with unexpectedly
539     // different symbol's Id making it ambiguous.
540 
541     // FIXME: 'local constant', for example, const char var[] = "abc", declared
542     // in a function scope, can't be found in PDB.
543 
544     // Parse variables in this compiland.
545     num_added += ParseVariables(sc, *compiland);
546   }
547 
548   return num_added;
549 }
550 
551 lldb_private::Type *SymbolFilePDB::ResolveTypeUID(lldb::user_id_t type_uid) {
552   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
553   auto find_result = m_types.find(type_uid);
554   if (find_result != m_types.end())
555     return find_result->second.get();
556 
557   auto type_system_or_err =
558       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
559   if (auto err = type_system_or_err.takeError()) {
560     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
561                    std::move(err), "Unable to ResolveTypeUID");
562     return nullptr;
563   }
564 
565   ClangASTContext *clang_type_system =
566       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
567   if (!clang_type_system)
568     return nullptr;
569   PDBASTParser *pdb = clang_type_system->GetPDBParser();
570   if (!pdb)
571     return nullptr;
572 
573   auto pdb_type = m_session_up->getSymbolById(type_uid);
574   if (pdb_type == nullptr)
575     return nullptr;
576 
577   lldb::TypeSP result = pdb->CreateLLDBTypeFromPDBType(*pdb_type);
578   if (result) {
579     m_types.insert(std::make_pair(type_uid, result));
580     GetTypeList().Insert(result);
581   }
582   return result.get();
583 }
584 
585 llvm::Optional<SymbolFile::ArrayInfo> SymbolFilePDB::GetDynamicArrayInfoForUID(
586     lldb::user_id_t type_uid, const lldb_private::ExecutionContext *exe_ctx) {
587   return llvm::None;
588 }
589 
590 bool SymbolFilePDB::CompleteType(lldb_private::CompilerType &compiler_type) {
591   std::lock_guard<std::recursive_mutex> guard(
592       GetObjectFile()->GetModule()->GetMutex());
593 
594   auto type_system_or_err =
595       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
596   if (auto err = type_system_or_err.takeError()) {
597     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
598                    std::move(err), "Unable to get dynamic array info for UID");
599     return false;
600   }
601 
602   ClangASTContext *clang_ast_ctx =
603       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
604 
605   if (!clang_ast_ctx)
606     return false;
607 
608   PDBASTParser *pdb = clang_ast_ctx->GetPDBParser();
609   if (!pdb)
610     return false;
611 
612   return pdb->CompleteTypeFromPDB(compiler_type);
613 }
614 
615 lldb_private::CompilerDecl SymbolFilePDB::GetDeclForUID(lldb::user_id_t uid) {
616   auto type_system_or_err =
617       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
618   if (auto err = type_system_or_err.takeError()) {
619     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
620                    std::move(err), "Unable to get decl for UID");
621     return CompilerDecl();
622   }
623 
624   ClangASTContext *clang_ast_ctx =
625       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
626   if (!clang_ast_ctx)
627     return CompilerDecl();
628 
629   PDBASTParser *pdb = clang_ast_ctx->GetPDBParser();
630   if (!pdb)
631     return CompilerDecl();
632 
633   auto symbol = m_session_up->getSymbolById(uid);
634   if (!symbol)
635     return CompilerDecl();
636 
637   auto decl = pdb->GetDeclForSymbol(*symbol);
638   if (!decl)
639     return CompilerDecl();
640 
641   return CompilerDecl(clang_ast_ctx, decl);
642 }
643 
644 lldb_private::CompilerDeclContext
645 SymbolFilePDB::GetDeclContextForUID(lldb::user_id_t uid) {
646   auto type_system_or_err =
647       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
648   if (auto err = type_system_or_err.takeError()) {
649     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
650                    std::move(err), "Unable to get DeclContext for UID");
651     return CompilerDeclContext();
652   }
653 
654   ClangASTContext *clang_ast_ctx =
655       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
656   if (!clang_ast_ctx)
657     return CompilerDeclContext();
658 
659   PDBASTParser *pdb = clang_ast_ctx->GetPDBParser();
660   if (!pdb)
661     return CompilerDeclContext();
662 
663   auto symbol = m_session_up->getSymbolById(uid);
664   if (!symbol)
665     return CompilerDeclContext();
666 
667   auto decl_context = pdb->GetDeclContextForSymbol(*symbol);
668   if (!decl_context)
669     return GetDeclContextContainingUID(uid);
670 
671   return CompilerDeclContext(clang_ast_ctx, decl_context);
672 }
673 
674 lldb_private::CompilerDeclContext
675 SymbolFilePDB::GetDeclContextContainingUID(lldb::user_id_t uid) {
676   auto type_system_or_err =
677       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
678   if (auto err = type_system_or_err.takeError()) {
679     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
680                    std::move(err), "Unable to get DeclContext containing UID");
681     return CompilerDeclContext();
682   }
683 
684   ClangASTContext *clang_ast_ctx =
685       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
686   if (!clang_ast_ctx)
687     return CompilerDeclContext();
688 
689   PDBASTParser *pdb = clang_ast_ctx->GetPDBParser();
690   if (!pdb)
691     return CompilerDeclContext();
692 
693   auto symbol = m_session_up->getSymbolById(uid);
694   if (!symbol)
695     return CompilerDeclContext();
696 
697   auto decl_context = pdb->GetDeclContextContainingSymbol(*symbol);
698   assert(decl_context);
699 
700   return CompilerDeclContext(clang_ast_ctx, decl_context);
701 }
702 
703 void SymbolFilePDB::ParseDeclsForContext(
704     lldb_private::CompilerDeclContext decl_ctx) {
705   auto type_system_or_err =
706       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
707   if (auto err = type_system_or_err.takeError()) {
708     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
709                    std::move(err), "Unable to parse decls for context");
710     return;
711   }
712 
713   ClangASTContext *clang_ast_ctx =
714       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
715   if (!clang_ast_ctx)
716     return;
717 
718   PDBASTParser *pdb = clang_ast_ctx->GetPDBParser();
719   if (!pdb)
720     return;
721 
722   pdb->ParseDeclsForDeclContext(
723       static_cast<clang::DeclContext *>(decl_ctx.GetOpaqueDeclContext()));
724 }
725 
726 uint32_t
727 SymbolFilePDB::ResolveSymbolContext(const lldb_private::Address &so_addr,
728                                     SymbolContextItem resolve_scope,
729                                     lldb_private::SymbolContext &sc) {
730   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
731   uint32_t resolved_flags = 0;
732   if (resolve_scope & eSymbolContextCompUnit ||
733       resolve_scope & eSymbolContextVariable ||
734       resolve_scope & eSymbolContextFunction ||
735       resolve_scope & eSymbolContextBlock ||
736       resolve_scope & eSymbolContextLineEntry) {
737     auto cu_sp = GetCompileUnitContainsAddress(so_addr);
738     if (!cu_sp) {
739       if (resolved_flags & eSymbolContextVariable) {
740         // TODO: Resolve variables
741       }
742       return 0;
743     }
744     sc.comp_unit = cu_sp.get();
745     resolved_flags |= eSymbolContextCompUnit;
746     lldbassert(sc.module_sp == cu_sp->GetModule());
747   }
748 
749   if (resolve_scope & eSymbolContextFunction ||
750       resolve_scope & eSymbolContextBlock) {
751     addr_t file_vm_addr = so_addr.GetFileAddress();
752     auto symbol_up =
753         m_session_up->findSymbolByAddress(file_vm_addr, PDB_SymType::Function);
754     if (symbol_up) {
755       auto *pdb_func = llvm::dyn_cast<PDBSymbolFunc>(symbol_up.get());
756       assert(pdb_func);
757       auto func_uid = pdb_func->getSymIndexId();
758       sc.function = sc.comp_unit->FindFunctionByUID(func_uid).get();
759       if (sc.function == nullptr)
760         sc.function =
761             ParseCompileUnitFunctionForPDBFunc(*pdb_func, *sc.comp_unit);
762       if (sc.function) {
763         resolved_flags |= eSymbolContextFunction;
764         if (resolve_scope & eSymbolContextBlock) {
765           auto block_symbol = m_session_up->findSymbolByAddress(
766               file_vm_addr, PDB_SymType::Block);
767           auto block_id = block_symbol ? block_symbol->getSymIndexId()
768                                        : sc.function->GetID();
769           sc.block = sc.function->GetBlock(true).FindBlockByID(block_id);
770           if (sc.block)
771             resolved_flags |= eSymbolContextBlock;
772         }
773       }
774     }
775   }
776 
777   if (resolve_scope & eSymbolContextLineEntry) {
778     if (auto *line_table = sc.comp_unit->GetLineTable()) {
779       Address addr(so_addr);
780       if (line_table->FindLineEntryByAddress(addr, sc.line_entry))
781         resolved_flags |= eSymbolContextLineEntry;
782     }
783   }
784 
785   return resolved_flags;
786 }
787 
788 uint32_t SymbolFilePDB::ResolveSymbolContext(
789     const lldb_private::FileSpec &file_spec, uint32_t line, bool check_inlines,
790     SymbolContextItem resolve_scope, lldb_private::SymbolContextList &sc_list) {
791   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
792   const size_t old_size = sc_list.GetSize();
793   if (resolve_scope & lldb::eSymbolContextCompUnit) {
794     // Locate all compilation units with line numbers referencing the specified
795     // file.  For example, if `file_spec` is <vector>, then this should return
796     // all source files and header files that reference <vector>, either
797     // directly or indirectly.
798     auto compilands = m_session_up->findCompilandsForSourceFile(
799         file_spec.GetPath(), PDB_NameSearchFlags::NS_CaseInsensitive);
800 
801     if (!compilands)
802       return 0;
803 
804     // For each one, either find its previously parsed data or parse it afresh
805     // and add it to the symbol context list.
806     while (auto compiland = compilands->getNext()) {
807       // If we're not checking inlines, then don't add line information for
808       // this file unless the FileSpec matches. For inline functions, we don't
809       // have to match the FileSpec since they could be defined in headers
810       // other than file specified in FileSpec.
811       if (!check_inlines) {
812         std::string source_file = compiland->getSourceFileFullPath();
813         if (source_file.empty())
814           continue;
815         FileSpec this_spec(source_file, FileSpec::Style::windows);
816         bool need_full_match = !file_spec.GetDirectory().IsEmpty();
817         if (FileSpec::Compare(file_spec, this_spec, need_full_match) != 0)
818           continue;
819       }
820 
821       SymbolContext sc;
822       auto cu = ParseCompileUnitForUID(compiland->getSymIndexId());
823       if (!cu)
824         continue;
825       sc.comp_unit = cu.get();
826       sc.module_sp = cu->GetModule();
827 
828       // If we were asked to resolve line entries, add all entries to the line
829       // table that match the requested line (or all lines if `line` == 0).
830       if (resolve_scope & (eSymbolContextFunction | eSymbolContextBlock |
831                            eSymbolContextLineEntry)) {
832         bool has_line_table = ParseCompileUnitLineTable(*sc.comp_unit, line);
833 
834         if ((resolve_scope & eSymbolContextLineEntry) && !has_line_table) {
835           // The query asks for line entries, but we can't get them for the
836           // compile unit. This is not normal for `line` = 0. So just assert
837           // it.
838           assert(line && "Couldn't get all line entries!\n");
839 
840           // Current compiland does not have the requested line. Search next.
841           continue;
842         }
843 
844         if (resolve_scope & (eSymbolContextFunction | eSymbolContextBlock)) {
845           if (!has_line_table)
846             continue;
847 
848           auto *line_table = sc.comp_unit->GetLineTable();
849           lldbassert(line_table);
850 
851           uint32_t num_line_entries = line_table->GetSize();
852           // Skip the terminal line entry.
853           --num_line_entries;
854 
855           // If `line `!= 0, see if we can resolve function for each line entry
856           // in the line table.
857           for (uint32_t line_idx = 0; line && line_idx < num_line_entries;
858                ++line_idx) {
859             if (!line_table->GetLineEntryAtIndex(line_idx, sc.line_entry))
860               continue;
861 
862             auto file_vm_addr =
863                 sc.line_entry.range.GetBaseAddress().GetFileAddress();
864             if (file_vm_addr == LLDB_INVALID_ADDRESS || file_vm_addr == 0)
865               continue;
866 
867             auto symbol_up = m_session_up->findSymbolByAddress(
868                 file_vm_addr, PDB_SymType::Function);
869             if (symbol_up) {
870               auto func_uid = symbol_up->getSymIndexId();
871               sc.function = sc.comp_unit->FindFunctionByUID(func_uid).get();
872               if (sc.function == nullptr) {
873                 auto pdb_func = llvm::dyn_cast<PDBSymbolFunc>(symbol_up.get());
874                 assert(pdb_func);
875                 sc.function = ParseCompileUnitFunctionForPDBFunc(*pdb_func,
876                                                                  *sc.comp_unit);
877               }
878               if (sc.function && (resolve_scope & eSymbolContextBlock)) {
879                 Block &block = sc.function->GetBlock(true);
880                 sc.block = block.FindBlockByID(sc.function->GetID());
881               }
882             }
883             sc_list.Append(sc);
884           }
885         } else if (has_line_table) {
886           // We can parse line table for the compile unit. But no query to
887           // resolve function or block. We append `sc` to the list anyway.
888           sc_list.Append(sc);
889         }
890       } else {
891         // No query for line entry, function or block. But we have a valid
892         // compile unit, append `sc` to the list.
893         sc_list.Append(sc);
894       }
895     }
896   }
897   return sc_list.GetSize() - old_size;
898 }
899 
900 std::string SymbolFilePDB::GetMangledForPDBData(const PDBSymbolData &pdb_data) {
901   // Cache public names at first
902   if (m_public_names.empty())
903     if (auto result_up =
904             m_global_scope_up->findAllChildren(PDB_SymType::PublicSymbol))
905       while (auto symbol_up = result_up->getNext())
906         if (auto addr = symbol_up->getRawSymbol().getVirtualAddress())
907           m_public_names[addr] = symbol_up->getRawSymbol().getName();
908 
909   // Look up the name in the cache
910   return m_public_names.lookup(pdb_data.getVirtualAddress());
911 }
912 
913 VariableSP SymbolFilePDB::ParseVariableForPDBData(
914     const lldb_private::SymbolContext &sc,
915     const llvm::pdb::PDBSymbolData &pdb_data) {
916   VariableSP var_sp;
917   uint32_t var_uid = pdb_data.getSymIndexId();
918   auto result = m_variables.find(var_uid);
919   if (result != m_variables.end())
920     return result->second;
921 
922   ValueType scope = eValueTypeInvalid;
923   bool is_static_member = false;
924   bool is_external = false;
925   bool is_artificial = false;
926 
927   switch (pdb_data.getDataKind()) {
928   case PDB_DataKind::Global:
929     scope = eValueTypeVariableGlobal;
930     is_external = true;
931     break;
932   case PDB_DataKind::Local:
933     scope = eValueTypeVariableLocal;
934     break;
935   case PDB_DataKind::FileStatic:
936     scope = eValueTypeVariableStatic;
937     break;
938   case PDB_DataKind::StaticMember:
939     is_static_member = true;
940     scope = eValueTypeVariableStatic;
941     break;
942   case PDB_DataKind::Member:
943     scope = eValueTypeVariableStatic;
944     break;
945   case PDB_DataKind::Param:
946     scope = eValueTypeVariableArgument;
947     break;
948   case PDB_DataKind::Constant:
949     scope = eValueTypeConstResult;
950     break;
951   default:
952     break;
953   }
954 
955   switch (pdb_data.getLocationType()) {
956   case PDB_LocType::TLS:
957     scope = eValueTypeVariableThreadLocal;
958     break;
959   case PDB_LocType::RegRel: {
960     // It is a `this` pointer.
961     if (pdb_data.getDataKind() == PDB_DataKind::ObjectPtr) {
962       scope = eValueTypeVariableArgument;
963       is_artificial = true;
964     }
965   } break;
966   default:
967     break;
968   }
969 
970   Declaration decl;
971   if (!is_artificial && !pdb_data.isCompilerGenerated()) {
972     if (auto lines = pdb_data.getLineNumbers()) {
973       if (auto first_line = lines->getNext()) {
974         uint32_t src_file_id = first_line->getSourceFileId();
975         auto src_file = m_session_up->getSourceFileById(src_file_id);
976         if (src_file) {
977           FileSpec spec(src_file->getFileName());
978           decl.SetFile(spec);
979           decl.SetColumn(first_line->getColumnNumber());
980           decl.SetLine(first_line->getLineNumber());
981         }
982       }
983     }
984   }
985 
986   Variable::RangeList ranges;
987   SymbolContextScope *context_scope = sc.comp_unit;
988   if (scope == eValueTypeVariableLocal || scope == eValueTypeVariableArgument) {
989     if (sc.function) {
990       Block &function_block = sc.function->GetBlock(true);
991       Block *block =
992           function_block.FindBlockByID(pdb_data.getLexicalParentId());
993       if (!block)
994         block = &function_block;
995 
996       context_scope = block;
997 
998       for (size_t i = 0, num_ranges = block->GetNumRanges(); i < num_ranges;
999            ++i) {
1000         AddressRange range;
1001         if (!block->GetRangeAtIndex(i, range))
1002           continue;
1003 
1004         ranges.Append(range.GetBaseAddress().GetFileAddress(),
1005                       range.GetByteSize());
1006       }
1007     }
1008   }
1009 
1010   SymbolFileTypeSP type_sp =
1011       std::make_shared<SymbolFileType>(*this, pdb_data.getTypeId());
1012 
1013   auto var_name = pdb_data.getName();
1014   auto mangled = GetMangledForPDBData(pdb_data);
1015   auto mangled_cstr = mangled.empty() ? nullptr : mangled.c_str();
1016 
1017   bool is_constant;
1018   DWARFExpression location = ConvertPDBLocationToDWARFExpression(
1019       GetObjectFile()->GetModule(), pdb_data, ranges, is_constant);
1020 
1021   var_sp = std::make_shared<Variable>(
1022       var_uid, var_name.c_str(), mangled_cstr, type_sp, scope, context_scope,
1023       ranges, &decl, location, is_external, is_artificial, is_static_member);
1024   var_sp->SetLocationIsConstantValueData(is_constant);
1025 
1026   m_variables.insert(std::make_pair(var_uid, var_sp));
1027   return var_sp;
1028 }
1029 
1030 size_t
1031 SymbolFilePDB::ParseVariables(const lldb_private::SymbolContext &sc,
1032                               const llvm::pdb::PDBSymbol &pdb_symbol,
1033                               lldb_private::VariableList *variable_list) {
1034   size_t num_added = 0;
1035 
1036   if (auto pdb_data = llvm::dyn_cast<PDBSymbolData>(&pdb_symbol)) {
1037     VariableListSP local_variable_list_sp;
1038 
1039     auto result = m_variables.find(pdb_data->getSymIndexId());
1040     if (result != m_variables.end()) {
1041       if (variable_list)
1042         variable_list->AddVariableIfUnique(result->second);
1043     } else {
1044       // Prepare right VariableList for this variable.
1045       if (auto lexical_parent = pdb_data->getLexicalParent()) {
1046         switch (lexical_parent->getSymTag()) {
1047         case PDB_SymType::Exe:
1048           assert(sc.comp_unit);
1049           LLVM_FALLTHROUGH;
1050         case PDB_SymType::Compiland: {
1051           if (sc.comp_unit) {
1052             local_variable_list_sp = sc.comp_unit->GetVariableList(false);
1053             if (!local_variable_list_sp) {
1054               local_variable_list_sp = std::make_shared<VariableList>();
1055               sc.comp_unit->SetVariableList(local_variable_list_sp);
1056             }
1057           }
1058         } break;
1059         case PDB_SymType::Block:
1060         case PDB_SymType::Function: {
1061           if (sc.function) {
1062             Block *block = sc.function->GetBlock(true).FindBlockByID(
1063                 lexical_parent->getSymIndexId());
1064             if (block) {
1065               local_variable_list_sp = block->GetBlockVariableList(false);
1066               if (!local_variable_list_sp) {
1067                 local_variable_list_sp = std::make_shared<VariableList>();
1068                 block->SetVariableList(local_variable_list_sp);
1069               }
1070             }
1071           }
1072         } break;
1073         default:
1074           break;
1075         }
1076       }
1077 
1078       if (local_variable_list_sp) {
1079         if (auto var_sp = ParseVariableForPDBData(sc, *pdb_data)) {
1080           local_variable_list_sp->AddVariableIfUnique(var_sp);
1081           if (variable_list)
1082             variable_list->AddVariableIfUnique(var_sp);
1083           ++num_added;
1084           PDBASTParser *ast = GetPDBAstParser();
1085           if (ast)
1086             ast->GetDeclForSymbol(*pdb_data);
1087         }
1088       }
1089     }
1090   }
1091 
1092   if (auto results = pdb_symbol.findAllChildren()) {
1093     while (auto result = results->getNext())
1094       num_added += ParseVariables(sc, *result, variable_list);
1095   }
1096 
1097   return num_added;
1098 }
1099 
1100 uint32_t SymbolFilePDB::FindGlobalVariables(
1101     lldb_private::ConstString name,
1102     const lldb_private::CompilerDeclContext *parent_decl_ctx,
1103     uint32_t max_matches, lldb_private::VariableList &variables) {
1104   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1105   if (!DeclContextMatchesThisSymbolFile(parent_decl_ctx))
1106     return 0;
1107   if (name.IsEmpty())
1108     return 0;
1109 
1110   auto results = m_global_scope_up->findAllChildren<PDBSymbolData>();
1111   if (!results)
1112     return 0;
1113 
1114   uint32_t matches = 0;
1115   size_t old_size = variables.GetSize();
1116   while (auto result = results->getNext()) {
1117     auto pdb_data = llvm::dyn_cast<PDBSymbolData>(result.get());
1118     if (max_matches > 0 && matches >= max_matches)
1119       break;
1120 
1121     SymbolContext sc;
1122     sc.module_sp = m_objfile_sp->GetModule();
1123     lldbassert(sc.module_sp.get());
1124 
1125     if (!name.GetStringRef().equals(
1126             MSVCUndecoratedNameParser::DropScope(pdb_data->getName())))
1127       continue;
1128 
1129     sc.comp_unit = ParseCompileUnitForUID(GetCompilandId(*pdb_data)).get();
1130     // FIXME: We are not able to determine the compile unit.
1131     if (sc.comp_unit == nullptr)
1132       continue;
1133 
1134     if (parent_decl_ctx && GetDeclContextContainingUID(
1135                                result->getSymIndexId()) != *parent_decl_ctx)
1136       continue;
1137 
1138     ParseVariables(sc, *pdb_data, &variables);
1139     matches = variables.GetSize() - old_size;
1140   }
1141 
1142   return matches;
1143 }
1144 
1145 uint32_t
1146 SymbolFilePDB::FindGlobalVariables(const lldb_private::RegularExpression &regex,
1147                                    uint32_t max_matches,
1148                                    lldb_private::VariableList &variables) {
1149   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1150   if (!regex.IsValid())
1151     return 0;
1152   auto results = m_global_scope_up->findAllChildren<PDBSymbolData>();
1153   if (!results)
1154     return 0;
1155 
1156   uint32_t matches = 0;
1157   size_t old_size = variables.GetSize();
1158   while (auto pdb_data = results->getNext()) {
1159     if (max_matches > 0 && matches >= max_matches)
1160       break;
1161 
1162     auto var_name = pdb_data->getName();
1163     if (var_name.empty())
1164       continue;
1165     if (!regex.Execute(var_name))
1166       continue;
1167     SymbolContext sc;
1168     sc.module_sp = m_objfile_sp->GetModule();
1169     lldbassert(sc.module_sp.get());
1170 
1171     sc.comp_unit = ParseCompileUnitForUID(GetCompilandId(*pdb_data)).get();
1172     // FIXME: We are not able to determine the compile unit.
1173     if (sc.comp_unit == nullptr)
1174       continue;
1175 
1176     ParseVariables(sc, *pdb_data, &variables);
1177     matches = variables.GetSize() - old_size;
1178   }
1179 
1180   return matches;
1181 }
1182 
1183 bool SymbolFilePDB::ResolveFunction(const llvm::pdb::PDBSymbolFunc &pdb_func,
1184                                     bool include_inlines,
1185                                     lldb_private::SymbolContextList &sc_list) {
1186   lldb_private::SymbolContext sc;
1187   sc.comp_unit = ParseCompileUnitForUID(pdb_func.getCompilandId()).get();
1188   if (!sc.comp_unit)
1189     return false;
1190   sc.module_sp = sc.comp_unit->GetModule();
1191   sc.function = ParseCompileUnitFunctionForPDBFunc(pdb_func, *sc.comp_unit);
1192   if (!sc.function)
1193     return false;
1194 
1195   sc_list.Append(sc);
1196   return true;
1197 }
1198 
1199 bool SymbolFilePDB::ResolveFunction(uint32_t uid, bool include_inlines,
1200                                     lldb_private::SymbolContextList &sc_list) {
1201   auto pdb_func_up = m_session_up->getConcreteSymbolById<PDBSymbolFunc>(uid);
1202   if (!pdb_func_up && !(include_inlines && pdb_func_up->hasInlineAttribute()))
1203     return false;
1204   return ResolveFunction(*pdb_func_up, include_inlines, sc_list);
1205 }
1206 
1207 void SymbolFilePDB::CacheFunctionNames() {
1208   if (!m_func_full_names.IsEmpty())
1209     return;
1210 
1211   std::map<uint64_t, uint32_t> addr_ids;
1212 
1213   if (auto results_up = m_global_scope_up->findAllChildren<PDBSymbolFunc>()) {
1214     while (auto pdb_func_up = results_up->getNext()) {
1215       if (pdb_func_up->isCompilerGenerated())
1216         continue;
1217 
1218       auto name = pdb_func_up->getName();
1219       auto demangled_name = pdb_func_up->getUndecoratedName();
1220       if (name.empty() && demangled_name.empty())
1221         continue;
1222 
1223       auto uid = pdb_func_up->getSymIndexId();
1224       if (!demangled_name.empty() && pdb_func_up->getVirtualAddress())
1225         addr_ids.insert(std::make_pair(pdb_func_up->getVirtualAddress(), uid));
1226 
1227       if (auto parent = pdb_func_up->getClassParent()) {
1228 
1229         // PDB have symbols for class/struct methods or static methods in Enum
1230         // Class. We won't bother to check if the parent is UDT or Enum here.
1231         m_func_method_names.Append(ConstString(name), uid);
1232 
1233         // To search a method name, like NS::Class:MemberFunc, LLDB searches
1234         // its base name, i.e. MemberFunc by default. Since PDBSymbolFunc does
1235         // not have inforamtion of this, we extract base names and cache them
1236         // by our own effort.
1237         llvm::StringRef basename = MSVCUndecoratedNameParser::DropScope(name);
1238         if (!basename.empty())
1239           m_func_base_names.Append(ConstString(basename), uid);
1240         else {
1241           m_func_base_names.Append(ConstString(name), uid);
1242         }
1243 
1244         if (!demangled_name.empty())
1245           m_func_full_names.Append(ConstString(demangled_name), uid);
1246 
1247       } else {
1248         // Handle not-method symbols.
1249 
1250         // The function name might contain namespace, or its lexical scope.
1251         llvm::StringRef basename = MSVCUndecoratedNameParser::DropScope(name);
1252         if (!basename.empty())
1253           m_func_base_names.Append(ConstString(basename), uid);
1254         else
1255           m_func_base_names.Append(ConstString(name), uid);
1256 
1257         if (name == "main") {
1258           m_func_full_names.Append(ConstString(name), uid);
1259 
1260           if (!demangled_name.empty() && name != demangled_name) {
1261             m_func_full_names.Append(ConstString(demangled_name), uid);
1262             m_func_base_names.Append(ConstString(demangled_name), uid);
1263           }
1264         } else if (!demangled_name.empty()) {
1265           m_func_full_names.Append(ConstString(demangled_name), uid);
1266         } else {
1267           m_func_full_names.Append(ConstString(name), uid);
1268         }
1269       }
1270     }
1271   }
1272 
1273   if (auto results_up =
1274           m_global_scope_up->findAllChildren<PDBSymbolPublicSymbol>()) {
1275     while (auto pub_sym_up = results_up->getNext()) {
1276       if (!pub_sym_up->isFunction())
1277         continue;
1278       auto name = pub_sym_up->getName();
1279       if (name.empty())
1280         continue;
1281 
1282       if (CPlusPlusLanguage::IsCPPMangledName(name.c_str())) {
1283         auto vm_addr = pub_sym_up->getVirtualAddress();
1284 
1285         // PDB public symbol has mangled name for its associated function.
1286         if (vm_addr && addr_ids.find(vm_addr) != addr_ids.end()) {
1287           // Cache mangled name.
1288           m_func_full_names.Append(ConstString(name), addr_ids[vm_addr]);
1289         }
1290       }
1291     }
1292   }
1293   // Sort them before value searching is working properly
1294   m_func_full_names.Sort();
1295   m_func_full_names.SizeToFit();
1296   m_func_method_names.Sort();
1297   m_func_method_names.SizeToFit();
1298   m_func_base_names.Sort();
1299   m_func_base_names.SizeToFit();
1300 }
1301 
1302 uint32_t SymbolFilePDB::FindFunctions(
1303     lldb_private::ConstString name,
1304     const lldb_private::CompilerDeclContext *parent_decl_ctx,
1305     FunctionNameType name_type_mask, bool include_inlines, bool append,
1306     lldb_private::SymbolContextList &sc_list) {
1307   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1308   if (!append)
1309     sc_list.Clear();
1310   lldbassert((name_type_mask & eFunctionNameTypeAuto) == 0);
1311 
1312   if (name_type_mask == eFunctionNameTypeNone)
1313     return 0;
1314   if (!DeclContextMatchesThisSymbolFile(parent_decl_ctx))
1315     return 0;
1316   if (name.IsEmpty())
1317     return 0;
1318 
1319   auto old_size = sc_list.GetSize();
1320   if (name_type_mask & eFunctionNameTypeFull ||
1321       name_type_mask & eFunctionNameTypeBase ||
1322       name_type_mask & eFunctionNameTypeMethod) {
1323     CacheFunctionNames();
1324 
1325     std::set<uint32_t> resolved_ids;
1326     auto ResolveFn = [this, &name, parent_decl_ctx, include_inlines, &sc_list,
1327                       &resolved_ids](UniqueCStringMap<uint32_t> &Names) {
1328       std::vector<uint32_t> ids;
1329       if (!Names.GetValues(name, ids))
1330         return;
1331 
1332       for (uint32_t id : ids) {
1333         if (resolved_ids.find(id) != resolved_ids.end())
1334           continue;
1335 
1336         if (parent_decl_ctx &&
1337             GetDeclContextContainingUID(id) != *parent_decl_ctx)
1338           continue;
1339 
1340         if (ResolveFunction(id, include_inlines, sc_list))
1341           resolved_ids.insert(id);
1342       }
1343     };
1344     if (name_type_mask & eFunctionNameTypeFull) {
1345       ResolveFn(m_func_full_names);
1346       ResolveFn(m_func_base_names);
1347       ResolveFn(m_func_method_names);
1348     }
1349     if (name_type_mask & eFunctionNameTypeBase) {
1350       ResolveFn(m_func_base_names);
1351     }
1352     if (name_type_mask & eFunctionNameTypeMethod) {
1353       ResolveFn(m_func_method_names);
1354     }
1355   }
1356   return sc_list.GetSize() - old_size;
1357 }
1358 
1359 uint32_t
1360 SymbolFilePDB::FindFunctions(const lldb_private::RegularExpression &regex,
1361                              bool include_inlines, bool append,
1362                              lldb_private::SymbolContextList &sc_list) {
1363   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1364   if (!append)
1365     sc_list.Clear();
1366   if (!regex.IsValid())
1367     return 0;
1368 
1369   auto old_size = sc_list.GetSize();
1370   CacheFunctionNames();
1371 
1372   std::set<uint32_t> resolved_ids;
1373   auto ResolveFn = [&regex, include_inlines, &sc_list, &resolved_ids,
1374                     this](UniqueCStringMap<uint32_t> &Names) {
1375     std::vector<uint32_t> ids;
1376     if (Names.GetValues(regex, ids)) {
1377       for (auto id : ids) {
1378         if (resolved_ids.find(id) == resolved_ids.end())
1379           if (ResolveFunction(id, include_inlines, sc_list))
1380             resolved_ids.insert(id);
1381       }
1382     }
1383   };
1384   ResolveFn(m_func_full_names);
1385   ResolveFn(m_func_base_names);
1386 
1387   return sc_list.GetSize() - old_size;
1388 }
1389 
1390 void SymbolFilePDB::GetMangledNamesForFunction(
1391     const std::string &scope_qualified_name,
1392     std::vector<lldb_private::ConstString> &mangled_names) {}
1393 
1394 void SymbolFilePDB::AddSymbols(lldb_private::Symtab &symtab) {
1395   std::set<lldb::addr_t> sym_addresses;
1396   for (size_t i = 0; i < symtab.GetNumSymbols(); i++)
1397     sym_addresses.insert(symtab.SymbolAtIndex(i)->GetFileAddress());
1398 
1399   auto results = m_global_scope_up->findAllChildren<PDBSymbolPublicSymbol>();
1400   if (!results)
1401     return;
1402 
1403   auto section_list = m_objfile_sp->GetSectionList();
1404   if (!section_list)
1405     return;
1406 
1407   while (auto pub_symbol = results->getNext()) {
1408     auto section_id = pub_symbol->getAddressSection();
1409 
1410     auto section = section_list->FindSectionByID(section_id);
1411     if (!section)
1412       continue;
1413 
1414     auto offset = pub_symbol->getAddressOffset();
1415 
1416     auto file_addr = section->GetFileAddress() + offset;
1417     if (sym_addresses.find(file_addr) != sym_addresses.end())
1418       continue;
1419     sym_addresses.insert(file_addr);
1420 
1421     auto size = pub_symbol->getLength();
1422     symtab.AddSymbol(
1423         Symbol(pub_symbol->getSymIndexId(),   // symID
1424                pub_symbol->getName().c_str(), // name
1425                pub_symbol->isCode() ? eSymbolTypeCode : eSymbolTypeData, // type
1426                true,      // external
1427                false,     // is_debug
1428                false,     // is_trampoline
1429                false,     // is_artificial
1430                section,   // section_sp
1431                offset,    // value
1432                size,      // size
1433                size != 0, // size_is_valid
1434                false,     // contains_linker_annotations
1435                0          // flags
1436                ));
1437   }
1438 
1439   symtab.CalculateSymbolSizes();
1440   symtab.Finalize();
1441 }
1442 
1443 void SymbolFilePDB::FindTypes(
1444     lldb_private::ConstString name,
1445     const lldb_private::CompilerDeclContext *parent_decl_ctx,
1446     uint32_t max_matches,
1447     llvm::DenseSet<lldb_private::SymbolFile *> &searched_symbol_files,
1448     lldb_private::TypeMap &types) {
1449   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1450   if (!name)
1451     return;
1452   if (!DeclContextMatchesThisSymbolFile(parent_decl_ctx))
1453     return;
1454 
1455   searched_symbol_files.clear();
1456   searched_symbol_files.insert(this);
1457 
1458   // There is an assumption 'name' is not a regex
1459   FindTypesByName(name.GetStringRef(), parent_decl_ctx, max_matches, types);
1460 }
1461 
1462 void SymbolFilePDB::DumpClangAST(Stream &s) {
1463   auto type_system_or_err =
1464       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
1465   if (auto err = type_system_or_err.takeError()) {
1466     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
1467                    std::move(err), "Unable to dump ClangAST");
1468     return;
1469   }
1470 
1471   auto *clang_type_system =
1472       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
1473   if (!clang_type_system)
1474     return;
1475   clang_type_system->Dump(s);
1476 }
1477 
1478 void SymbolFilePDB::FindTypesByRegex(
1479     const lldb_private::RegularExpression &regex, uint32_t max_matches,
1480     lldb_private::TypeMap &types) {
1481   // When searching by regex, we need to go out of our way to limit the search
1482   // space as much as possible since this searches EVERYTHING in the PDB,
1483   // manually doing regex comparisons.  PDB library isn't optimized for regex
1484   // searches or searches across multiple symbol types at the same time, so the
1485   // best we can do is to search enums, then typedefs, then classes one by one,
1486   // and do a regex comparison against each of them.
1487   PDB_SymType tags_to_search[] = {PDB_SymType::Enum, PDB_SymType::Typedef,
1488                                   PDB_SymType::UDT};
1489   std::unique_ptr<IPDBEnumSymbols> results;
1490 
1491   uint32_t matches = 0;
1492 
1493   for (auto tag : tags_to_search) {
1494     results = m_global_scope_up->findAllChildren(tag);
1495     if (!results)
1496       continue;
1497 
1498     while (auto result = results->getNext()) {
1499       if (max_matches > 0 && matches >= max_matches)
1500         break;
1501 
1502       std::string type_name;
1503       if (auto enum_type = llvm::dyn_cast<PDBSymbolTypeEnum>(result.get()))
1504         type_name = enum_type->getName();
1505       else if (auto typedef_type =
1506                    llvm::dyn_cast<PDBSymbolTypeTypedef>(result.get()))
1507         type_name = typedef_type->getName();
1508       else if (auto class_type = llvm::dyn_cast<PDBSymbolTypeUDT>(result.get()))
1509         type_name = class_type->getName();
1510       else {
1511         // We're looking only for types that have names.  Skip symbols, as well
1512         // as unnamed types such as arrays, pointers, etc.
1513         continue;
1514       }
1515 
1516       if (!regex.Execute(type_name))
1517         continue;
1518 
1519       // This should cause the type to get cached and stored in the `m_types`
1520       // lookup.
1521       if (!ResolveTypeUID(result->getSymIndexId()))
1522         continue;
1523 
1524       auto iter = m_types.find(result->getSymIndexId());
1525       if (iter == m_types.end())
1526         continue;
1527       types.Insert(iter->second);
1528       ++matches;
1529     }
1530   }
1531 }
1532 
1533 void SymbolFilePDB::FindTypesByName(
1534     llvm::StringRef name,
1535     const lldb_private::CompilerDeclContext *parent_decl_ctx,
1536     uint32_t max_matches, lldb_private::TypeMap &types) {
1537   std::unique_ptr<IPDBEnumSymbols> results;
1538   if (name.empty())
1539     return;
1540   results = m_global_scope_up->findAllChildren(PDB_SymType::None);
1541   if (!results)
1542     return;
1543 
1544   uint32_t matches = 0;
1545 
1546   while (auto result = results->getNext()) {
1547     if (max_matches > 0 && matches >= max_matches)
1548       break;
1549 
1550     if (MSVCUndecoratedNameParser::DropScope(
1551             result->getRawSymbol().getName()) != name)
1552       continue;
1553 
1554     switch (result->getSymTag()) {
1555     case PDB_SymType::Enum:
1556     case PDB_SymType::UDT:
1557     case PDB_SymType::Typedef:
1558       break;
1559     default:
1560       // We're looking only for types that have names.  Skip symbols, as well
1561       // as unnamed types such as arrays, pointers, etc.
1562       continue;
1563     }
1564 
1565     // This should cause the type to get cached and stored in the `m_types`
1566     // lookup.
1567     if (!ResolveTypeUID(result->getSymIndexId()))
1568       continue;
1569 
1570     if (parent_decl_ctx && GetDeclContextContainingUID(
1571                                result->getSymIndexId()) != *parent_decl_ctx)
1572       continue;
1573 
1574     auto iter = m_types.find(result->getSymIndexId());
1575     if (iter == m_types.end())
1576       continue;
1577     types.Insert(iter->second);
1578     ++matches;
1579   }
1580 }
1581 
1582 void SymbolFilePDB::FindTypes(llvm::ArrayRef<CompilerContext> pattern,
1583                               LanguageSet languages,
1584                               lldb_private::TypeMap &types) {}
1585 
1586 void SymbolFilePDB::GetTypesForPDBSymbol(const llvm::pdb::PDBSymbol &pdb_symbol,
1587                                          uint32_t type_mask,
1588                                          TypeCollection &type_collection) {
1589   bool can_parse = false;
1590   switch (pdb_symbol.getSymTag()) {
1591   case PDB_SymType::ArrayType:
1592     can_parse = ((type_mask & eTypeClassArray) != 0);
1593     break;
1594   case PDB_SymType::BuiltinType:
1595     can_parse = ((type_mask & eTypeClassBuiltin) != 0);
1596     break;
1597   case PDB_SymType::Enum:
1598     can_parse = ((type_mask & eTypeClassEnumeration) != 0);
1599     break;
1600   case PDB_SymType::Function:
1601   case PDB_SymType::FunctionSig:
1602     can_parse = ((type_mask & eTypeClassFunction) != 0);
1603     break;
1604   case PDB_SymType::PointerType:
1605     can_parse = ((type_mask & (eTypeClassPointer | eTypeClassBlockPointer |
1606                                eTypeClassMemberPointer)) != 0);
1607     break;
1608   case PDB_SymType::Typedef:
1609     can_parse = ((type_mask & eTypeClassTypedef) != 0);
1610     break;
1611   case PDB_SymType::UDT: {
1612     auto *udt = llvm::dyn_cast<PDBSymbolTypeUDT>(&pdb_symbol);
1613     assert(udt);
1614     can_parse = (udt->getUdtKind() != PDB_UdtType::Interface &&
1615                  ((type_mask & (eTypeClassClass | eTypeClassStruct |
1616                                 eTypeClassUnion)) != 0));
1617   } break;
1618   default:
1619     break;
1620   }
1621 
1622   if (can_parse) {
1623     if (auto *type = ResolveTypeUID(pdb_symbol.getSymIndexId())) {
1624       auto result =
1625           std::find(type_collection.begin(), type_collection.end(), type);
1626       if (result == type_collection.end())
1627         type_collection.push_back(type);
1628     }
1629   }
1630 
1631   auto results_up = pdb_symbol.findAllChildren();
1632   while (auto symbol_up = results_up->getNext())
1633     GetTypesForPDBSymbol(*symbol_up, type_mask, type_collection);
1634 }
1635 
1636 void SymbolFilePDB::GetTypes(lldb_private::SymbolContextScope *sc_scope,
1637                              TypeClass type_mask,
1638                              lldb_private::TypeList &type_list) {
1639   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1640   TypeCollection type_collection;
1641   CompileUnit *cu =
1642       sc_scope ? sc_scope->CalculateSymbolContextCompileUnit() : nullptr;
1643   if (cu) {
1644     auto compiland_up = GetPDBCompilandByUID(cu->GetID());
1645     if (!compiland_up)
1646       return;
1647     GetTypesForPDBSymbol(*compiland_up, type_mask, type_collection);
1648   } else {
1649     for (uint32_t cu_idx = 0; cu_idx < GetNumCompileUnits(); ++cu_idx) {
1650       auto cu_sp = ParseCompileUnitAtIndex(cu_idx);
1651       if (cu_sp) {
1652         if (auto compiland_up = GetPDBCompilandByUID(cu_sp->GetID()))
1653           GetTypesForPDBSymbol(*compiland_up, type_mask, type_collection);
1654       }
1655     }
1656   }
1657 
1658   for (auto type : type_collection) {
1659     type->GetForwardCompilerType();
1660     type_list.Insert(type->shared_from_this());
1661   }
1662 }
1663 
1664 llvm::Expected<lldb_private::TypeSystem &>
1665 SymbolFilePDB::GetTypeSystemForLanguage(lldb::LanguageType language) {
1666   auto type_system_or_err =
1667       m_objfile_sp->GetModule()->GetTypeSystemForLanguage(language);
1668   if (type_system_or_err) {
1669     type_system_or_err->SetSymbolFile(this);
1670   }
1671   return type_system_or_err;
1672 }
1673 
1674 PDBASTParser *SymbolFilePDB::GetPDBAstParser() {
1675   auto type_system_or_err =
1676       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
1677   if (auto err = type_system_or_err.takeError()) {
1678     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
1679                    std::move(err), "Unable to get PDB AST parser");
1680     return nullptr;
1681   }
1682 
1683   auto *clang_type_system =
1684       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
1685   if (!clang_type_system)
1686     return nullptr;
1687 
1688   return clang_type_system->GetPDBParser();
1689 }
1690 
1691 
1692 lldb_private::CompilerDeclContext SymbolFilePDB::FindNamespace(
1693     lldb_private::ConstString name,
1694     const lldb_private::CompilerDeclContext *parent_decl_ctx) {
1695   std::lock_guard<std::recursive_mutex> guard(GetModuleMutex());
1696   auto type_system_or_err =
1697       GetTypeSystemForLanguage(lldb::eLanguageTypeC_plus_plus);
1698   if (auto err = type_system_or_err.takeError()) {
1699     LLDB_LOG_ERROR(lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
1700                    std::move(err), "Unable to find namespace {}",
1701                    name.AsCString());
1702     return CompilerDeclContext();
1703   }
1704 
1705   auto *clang_type_system =
1706       llvm::dyn_cast_or_null<ClangASTContext>(&type_system_or_err.get());
1707   if (!clang_type_system)
1708     return CompilerDeclContext();
1709 
1710   PDBASTParser *pdb = clang_type_system->GetPDBParser();
1711   if (!pdb)
1712     return CompilerDeclContext();
1713 
1714   clang::DeclContext *decl_context = nullptr;
1715   if (parent_decl_ctx)
1716     decl_context = static_cast<clang::DeclContext *>(
1717         parent_decl_ctx->GetOpaqueDeclContext());
1718 
1719   auto namespace_decl =
1720       pdb->FindNamespaceDecl(decl_context, name.GetStringRef());
1721   if (!namespace_decl)
1722     return CompilerDeclContext();
1723 
1724   return CompilerDeclContext(clang_type_system,
1725                              static_cast<clang::DeclContext *>(namespace_decl));
1726 }
1727 
1728 lldb_private::ConstString SymbolFilePDB::GetPluginName() {
1729   static ConstString g_name("pdb");
1730   return g_name;
1731 }
1732 
1733 uint32_t SymbolFilePDB::GetPluginVersion() { return 1; }
1734 
1735 IPDBSession &SymbolFilePDB::GetPDBSession() { return *m_session_up; }
1736 
1737 const IPDBSession &SymbolFilePDB::GetPDBSession() const {
1738   return *m_session_up;
1739 }
1740 
1741 lldb::CompUnitSP SymbolFilePDB::ParseCompileUnitForUID(uint32_t id,
1742                                                        uint32_t index) {
1743   auto found_cu = m_comp_units.find(id);
1744   if (found_cu != m_comp_units.end())
1745     return found_cu->second;
1746 
1747   auto compiland_up = GetPDBCompilandByUID(id);
1748   if (!compiland_up)
1749     return CompUnitSP();
1750 
1751   lldb::LanguageType lang;
1752   auto details = compiland_up->findOneChild<PDBSymbolCompilandDetails>();
1753   if (!details)
1754     lang = lldb::eLanguageTypeC_plus_plus;
1755   else
1756     lang = TranslateLanguage(details->getLanguage());
1757 
1758   if (lang == lldb::LanguageType::eLanguageTypeUnknown)
1759     return CompUnitSP();
1760 
1761   std::string path = compiland_up->getSourceFileFullPath();
1762   if (path.empty())
1763     return CompUnitSP();
1764 
1765   // Don't support optimized code for now, DebugInfoPDB does not return this
1766   // information.
1767   LazyBool optimized = eLazyBoolNo;
1768   auto cu_sp = std::make_shared<CompileUnit>(m_objfile_sp->GetModule(), nullptr,
1769                                              path.c_str(), id, lang, optimized);
1770 
1771   if (!cu_sp)
1772     return CompUnitSP();
1773 
1774   m_comp_units.insert(std::make_pair(id, cu_sp));
1775   if (index == UINT32_MAX)
1776     GetCompileUnitIndex(*compiland_up, index);
1777   lldbassert(index != UINT32_MAX);
1778   SetCompileUnitAtIndex(index, cu_sp);
1779   return cu_sp;
1780 }
1781 
1782 bool SymbolFilePDB::ParseCompileUnitLineTable(CompileUnit &comp_unit,
1783                                               uint32_t match_line) {
1784   auto compiland_up = GetPDBCompilandByUID(comp_unit.GetID());
1785   if (!compiland_up)
1786     return false;
1787 
1788   // LineEntry needs the *index* of the file into the list of support files
1789   // returned by ParseCompileUnitSupportFiles.  But the underlying SDK gives us
1790   // a globally unique idenfitifier in the namespace of the PDB.  So, we have
1791   // to do a mapping so that we can hand out indices.
1792   llvm::DenseMap<uint32_t, uint32_t> index_map;
1793   BuildSupportFileIdToSupportFileIndexMap(*compiland_up, index_map);
1794   auto line_table = std::make_unique<LineTable>(&comp_unit);
1795 
1796   // Find contributions to `compiland` from all source and header files.
1797   std::string path = comp_unit.GetPath();
1798   auto files = m_session_up->getSourceFilesForCompiland(*compiland_up);
1799   if (!files)
1800     return false;
1801 
1802   // For each source and header file, create a LineSequence for contributions
1803   // to the compiland from that file, and add the sequence.
1804   while (auto file = files->getNext()) {
1805     std::unique_ptr<LineSequence> sequence(
1806         line_table->CreateLineSequenceContainer());
1807     auto lines = m_session_up->findLineNumbers(*compiland_up, *file);
1808     if (!lines)
1809       continue;
1810     int entry_count = lines->getChildCount();
1811 
1812     uint64_t prev_addr;
1813     uint32_t prev_length;
1814     uint32_t prev_line;
1815     uint32_t prev_source_idx;
1816 
1817     for (int i = 0; i < entry_count; ++i) {
1818       auto line = lines->getChildAtIndex(i);
1819 
1820       uint64_t lno = line->getLineNumber();
1821       uint64_t addr = line->getVirtualAddress();
1822       uint32_t length = line->getLength();
1823       uint32_t source_id = line->getSourceFileId();
1824       uint32_t col = line->getColumnNumber();
1825       uint32_t source_idx = index_map[source_id];
1826 
1827       // There was a gap between the current entry and the previous entry if
1828       // the addresses don't perfectly line up.
1829       bool is_gap = (i > 0) && (prev_addr + prev_length < addr);
1830 
1831       // Before inserting the current entry, insert a terminal entry at the end
1832       // of the previous entry's address range if the current entry resulted in
1833       // a gap from the previous entry.
1834       if (is_gap && ShouldAddLine(match_line, prev_line, prev_length)) {
1835         line_table->AppendLineEntryToSequence(
1836             sequence.get(), prev_addr + prev_length, prev_line, 0,
1837             prev_source_idx, false, false, false, false, true);
1838 
1839         line_table->InsertSequence(sequence.release());
1840         sequence.reset(line_table->CreateLineSequenceContainer());
1841       }
1842 
1843       if (ShouldAddLine(match_line, lno, length)) {
1844         bool is_statement = line->isStatement();
1845         bool is_prologue = false;
1846         bool is_epilogue = false;
1847         auto func =
1848             m_session_up->findSymbolByAddress(addr, PDB_SymType::Function);
1849         if (func) {
1850           auto prologue = func->findOneChild<PDBSymbolFuncDebugStart>();
1851           if (prologue)
1852             is_prologue = (addr == prologue->getVirtualAddress());
1853 
1854           auto epilogue = func->findOneChild<PDBSymbolFuncDebugEnd>();
1855           if (epilogue)
1856             is_epilogue = (addr == epilogue->getVirtualAddress());
1857         }
1858 
1859         line_table->AppendLineEntryToSequence(sequence.get(), addr, lno, col,
1860                                               source_idx, is_statement, false,
1861                                               is_prologue, is_epilogue, false);
1862       }
1863 
1864       prev_addr = addr;
1865       prev_length = length;
1866       prev_line = lno;
1867       prev_source_idx = source_idx;
1868     }
1869 
1870     if (entry_count > 0 && ShouldAddLine(match_line, prev_line, prev_length)) {
1871       // The end is always a terminal entry, so insert it regardless.
1872       line_table->AppendLineEntryToSequence(
1873           sequence.get(), prev_addr + prev_length, prev_line, 0,
1874           prev_source_idx, false, false, false, false, true);
1875     }
1876 
1877     line_table->InsertSequence(sequence.release());
1878   }
1879 
1880   if (line_table->GetSize()) {
1881     comp_unit.SetLineTable(line_table.release());
1882     return true;
1883   }
1884   return false;
1885 }
1886 
1887 void SymbolFilePDB::BuildSupportFileIdToSupportFileIndexMap(
1888     const PDBSymbolCompiland &compiland,
1889     llvm::DenseMap<uint32_t, uint32_t> &index_map) const {
1890   // This is a hack, but we need to convert the source id into an index into
1891   // the support files array.  We don't want to do path comparisons to avoid
1892   // basename / full path issues that may or may not even be a problem, so we
1893   // use the globally unique source file identifiers.  Ideally we could use the
1894   // global identifiers everywhere, but LineEntry currently assumes indices.
1895   auto source_files = m_session_up->getSourceFilesForCompiland(compiland);
1896   if (!source_files)
1897     return;
1898 
1899   // LLDB uses the DWARF-like file numeration (one based)
1900   int index = 1;
1901 
1902   while (auto file = source_files->getNext()) {
1903     uint32_t source_id = file->getUniqueId();
1904     index_map[source_id] = index++;
1905   }
1906 }
1907 
1908 lldb::CompUnitSP SymbolFilePDB::GetCompileUnitContainsAddress(
1909     const lldb_private::Address &so_addr) {
1910   lldb::addr_t file_vm_addr = so_addr.GetFileAddress();
1911   if (file_vm_addr == LLDB_INVALID_ADDRESS || file_vm_addr == 0)
1912     return nullptr;
1913 
1914   // If it is a PDB function's vm addr, this is the first sure bet.
1915   if (auto lines =
1916           m_session_up->findLineNumbersByAddress(file_vm_addr, /*Length=*/1)) {
1917     if (auto first_line = lines->getNext())
1918       return ParseCompileUnitForUID(first_line->getCompilandId());
1919   }
1920 
1921   // Otherwise we resort to section contributions.
1922   if (auto sec_contribs = m_session_up->getSectionContribs()) {
1923     while (auto section = sec_contribs->getNext()) {
1924       auto va = section->getVirtualAddress();
1925       if (file_vm_addr >= va && file_vm_addr < va + section->getLength())
1926         return ParseCompileUnitForUID(section->getCompilandId());
1927     }
1928   }
1929   return nullptr;
1930 }
1931 
1932 Mangled
1933 SymbolFilePDB::GetMangledForPDBFunc(const llvm::pdb::PDBSymbolFunc &pdb_func) {
1934   Mangled mangled;
1935   auto func_name = pdb_func.getName();
1936   auto func_undecorated_name = pdb_func.getUndecoratedName();
1937   std::string func_decorated_name;
1938 
1939   // Seek from public symbols for non-static function's decorated name if any.
1940   // For static functions, they don't have undecorated names and aren't exposed
1941   // in Public Symbols either.
1942   if (!func_undecorated_name.empty()) {
1943     auto result_up = m_global_scope_up->findChildren(
1944         PDB_SymType::PublicSymbol, func_undecorated_name,
1945         PDB_NameSearchFlags::NS_UndecoratedName);
1946     if (result_up) {
1947       while (auto symbol_up = result_up->getNext()) {
1948         // For a public symbol, it is unique.
1949         lldbassert(result_up->getChildCount() == 1);
1950         if (auto *pdb_public_sym =
1951                 llvm::dyn_cast_or_null<PDBSymbolPublicSymbol>(
1952                     symbol_up.get())) {
1953           if (pdb_public_sym->isFunction()) {
1954             func_decorated_name = pdb_public_sym->getName();
1955             break;
1956           }
1957         }
1958       }
1959     }
1960   }
1961   if (!func_decorated_name.empty()) {
1962     mangled.SetMangledName(ConstString(func_decorated_name));
1963 
1964     // For MSVC, format of C funciton's decorated name depends on calling
1965     // conventon. Unfortunately none of the format is recognized by current
1966     // LLDB. For example, `_purecall` is a __cdecl C function. From PDB,
1967     // `__purecall` is retrieved as both its decorated and undecorated name
1968     // (using PDBSymbolFunc::getUndecoratedName method). However `__purecall`
1969     // string is not treated as mangled in LLDB (neither `?` nor `_Z` prefix).
1970     // Mangled::GetDemangledName method will fail internally and caches an
1971     // empty string as its undecorated name. So we will face a contradition
1972     // here for the same symbol:
1973     //   non-empty undecorated name from PDB
1974     //   empty undecorated name from LLDB
1975     if (!func_undecorated_name.empty() &&
1976         mangled.GetDemangledName(mangled.GuessLanguage()).IsEmpty())
1977       mangled.SetDemangledName(ConstString(func_undecorated_name));
1978 
1979     // LLDB uses several flags to control how a C++ decorated name is
1980     // undecorated for MSVC. See `safeUndecorateName` in Class Mangled. So the
1981     // yielded name could be different from what we retrieve from
1982     // PDB source unless we also apply same flags in getting undecorated
1983     // name through PDBSymbolFunc::getUndecoratedNameEx method.
1984     if (!func_undecorated_name.empty() &&
1985         mangled.GetDemangledName(mangled.GuessLanguage()) !=
1986             ConstString(func_undecorated_name))
1987       mangled.SetDemangledName(ConstString(func_undecorated_name));
1988   } else if (!func_undecorated_name.empty()) {
1989     mangled.SetDemangledName(ConstString(func_undecorated_name));
1990   } else if (!func_name.empty())
1991     mangled.SetValue(ConstString(func_name), false);
1992 
1993   return mangled;
1994 }
1995 
1996 bool SymbolFilePDB::DeclContextMatchesThisSymbolFile(
1997     const lldb_private::CompilerDeclContext *decl_ctx) {
1998   if (decl_ctx == nullptr || !decl_ctx->IsValid())
1999     return true;
2000 
2001   TypeSystem *decl_ctx_type_system = decl_ctx->GetTypeSystem();
2002   if (!decl_ctx_type_system)
2003     return false;
2004   auto type_system_or_err = GetTypeSystemForLanguage(
2005       decl_ctx_type_system->GetMinimumLanguage(nullptr));
2006   if (auto err = type_system_or_err.takeError()) {
2007     LLDB_LOG_ERROR(
2008         lldb_private::GetLogIfAnyCategoriesSet(LIBLLDB_LOG_SYMBOLS),
2009         std::move(err),
2010         "Unable to determine if DeclContext matches this symbol file");
2011     return false;
2012   }
2013 
2014   if (decl_ctx_type_system == &type_system_or_err.get())
2015     return true; // The type systems match, return true
2016 
2017   return false;
2018 }
2019 
2020 uint32_t SymbolFilePDB::GetCompilandId(const llvm::pdb::PDBSymbolData &data) {
2021   static const auto pred_upper = [](uint32_t lhs, SecContribInfo rhs) {
2022     return lhs < rhs.Offset;
2023   };
2024 
2025   // Cache section contributions
2026   if (m_sec_contribs.empty()) {
2027     if (auto SecContribs = m_session_up->getSectionContribs()) {
2028       while (auto SectionContrib = SecContribs->getNext()) {
2029         auto comp_id = SectionContrib->getCompilandId();
2030         if (!comp_id)
2031           continue;
2032 
2033         auto sec = SectionContrib->getAddressSection();
2034         auto &sec_cs = m_sec_contribs[sec];
2035 
2036         auto offset = SectionContrib->getAddressOffset();
2037         auto it =
2038             std::upper_bound(sec_cs.begin(), sec_cs.end(), offset, pred_upper);
2039 
2040         auto size = SectionContrib->getLength();
2041         sec_cs.insert(it, {offset, size, comp_id});
2042       }
2043     }
2044   }
2045 
2046   // Check by line number
2047   if (auto Lines = data.getLineNumbers()) {
2048     if (auto FirstLine = Lines->getNext())
2049       return FirstLine->getCompilandId();
2050   }
2051 
2052   // Retrieve section + offset
2053   uint32_t DataSection = data.getAddressSection();
2054   uint32_t DataOffset = data.getAddressOffset();
2055   if (DataSection == 0) {
2056     if (auto RVA = data.getRelativeVirtualAddress())
2057       m_session_up->addressForRVA(RVA, DataSection, DataOffset);
2058   }
2059 
2060   if (DataSection) {
2061     // Search by section contributions
2062     auto &sec_cs = m_sec_contribs[DataSection];
2063     auto it =
2064         std::upper_bound(sec_cs.begin(), sec_cs.end(), DataOffset, pred_upper);
2065     if (it != sec_cs.begin()) {
2066       --it;
2067       if (DataOffset < it->Offset + it->Size)
2068         return it->CompilandId;
2069     }
2070   } else {
2071     // Search in lexical tree
2072     auto LexParentId = data.getLexicalParentId();
2073     while (auto LexParent = m_session_up->getSymbolById(LexParentId)) {
2074       if (LexParent->getSymTag() == PDB_SymType::Exe)
2075         break;
2076       if (LexParent->getSymTag() == PDB_SymType::Compiland)
2077         return LexParentId;
2078       LexParentId = LexParent->getRawSymbol().getLexicalParentId();
2079     }
2080   }
2081 
2082   return 0;
2083 }
2084