1 //===-- SymbolFileDWARF.cpp ------------------------------------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "SymbolFileDWARF.h"
11 
12 // Other libraries and framework includes
13 #include "llvm/Support/Casting.h"
14 
15 #include "lldb/Core/ArchSpec.h"
16 #include "lldb/Core/Module.h"
17 #include "lldb/Core/ModuleList.h"
18 #include "lldb/Core/ModuleSpec.h"
19 #include "lldb/Core/PluginManager.h"
20 #include "lldb/Core/RegularExpression.h"
21 #include "lldb/Core/Scalar.h"
22 #include "lldb/Core/Section.h"
23 #include "lldb/Core/StreamFile.h"
24 #include "lldb/Core/StreamString.h"
25 #include "lldb/Core/Timer.h"
26 #include "lldb/Core/Value.h"
27 
28 #include "Plugins/ExpressionParser/Clang/ClangModulesDeclVendor.h"
29 
30 #include "lldb/Host/FileSystem.h"
31 #include "lldb/Host/Host.h"
32 
33 #include "lldb/Interpreter/OptionValueFileSpecList.h"
34 #include "lldb/Interpreter/OptionValueProperties.h"
35 
36 #include "lldb/Symbol/Block.h"
37 #include "lldb/Symbol/ClangASTContext.h"
38 #include "lldb/Symbol/CompilerDecl.h"
39 #include "lldb/Symbol/CompilerDeclContext.h"
40 #include "lldb/Symbol/CompileUnit.h"
41 #include "lldb/Symbol/LineTable.h"
42 #include "lldb/Symbol/DebugMacros.h"
43 #include "lldb/Symbol/ObjectFile.h"
44 #include "lldb/Symbol/SymbolVendor.h"
45 #include "lldb/Symbol/TypeSystem.h"
46 #include "lldb/Symbol/VariableList.h"
47 #include "lldb/Symbol/TypeMap.h"
48 
49 #include "Plugins/Language/CPlusPlus/CPlusPlusLanguage.h"
50 #include "Plugins/Language/ObjC/ObjCLanguage.h"
51 
52 #include "lldb/Target/Language.h"
53 
54 #include "lldb/Utility/TaskPool.h"
55 
56 #include "DWARFASTParser.h"
57 #include "DWARFCompileUnit.h"
58 #include "DWARFDebugAbbrev.h"
59 #include "DWARFDebugAranges.h"
60 #include "DWARFDebugInfo.h"
61 #include "DWARFDebugLine.h"
62 #include "DWARFDebugMacro.h"
63 #include "DWARFDebugPubnames.h"
64 #include "DWARFDebugRanges.h"
65 #include "DWARFDeclContext.h"
66 #include "DWARFDIECollection.h"
67 #include "DWARFFormValue.h"
68 #include "LogChannelDWARF.h"
69 #include "SymbolFileDWARFDwo.h"
70 #include "SymbolFileDWARFDebugMap.h"
71 
72 #include <map>
73 
74 #include <ctype.h>
75 #include <string.h>
76 
77 //#define ENABLE_DEBUG_PRINTF // COMMENT OUT THIS LINE PRIOR TO CHECKIN
78 
79 #ifdef ENABLE_DEBUG_PRINTF
80 #include <stdio.h>
81 #define DEBUG_PRINTF(fmt, ...) printf(fmt, __VA_ARGS__)
82 #else
83 #define DEBUG_PRINTF(fmt, ...)
84 #endif
85 
86 using namespace lldb;
87 using namespace lldb_private;
88 
89 //static inline bool
90 //child_requires_parent_class_union_or_struct_to_be_completed (dw_tag_t tag)
91 //{
92 //    switch (tag)
93 //    {
94 //    default:
95 //        break;
96 //    case DW_TAG_subprogram:
97 //    case DW_TAG_inlined_subroutine:
98 //    case DW_TAG_class_type:
99 //    case DW_TAG_structure_type:
100 //    case DW_TAG_union_type:
101 //        return true;
102 //    }
103 //    return false;
104 //}
105 //
106 
107 namespace {
108 
109     PropertyDefinition
110     g_properties[] =
111     {
112         { "comp-dir-symlink-paths" , OptionValue::eTypeFileSpecList, true,  0 ,   nullptr, nullptr, "If the DW_AT_comp_dir matches any of these paths the symbolic links will be resolved at DWARF parse time." },
113         {  nullptr                 , OptionValue::eTypeInvalid     , false, 0,    nullptr, nullptr, nullptr }
114     };
115 
116     enum
117     {
118         ePropertySymLinkPaths
119     };
120 
121 
122     class PluginProperties : public Properties
123     {
124     public:
125         static ConstString
126         GetSettingName()
127         {
128             return SymbolFileDWARF::GetPluginNameStatic();
129         }
130 
131         PluginProperties()
132         {
133             m_collection_sp.reset (new OptionValueProperties(GetSettingName()));
134             m_collection_sp->Initialize(g_properties);
135         }
136 
137         FileSpecList&
138         GetSymLinkPaths()
139         {
140             OptionValueFileSpecList *option_value = m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpecList(nullptr, true, ePropertySymLinkPaths);
141             assert(option_value);
142             return option_value->GetCurrentValue();
143         }
144 
145     };
146 
147     typedef std::shared_ptr<PluginProperties> SymbolFileDWARFPropertiesSP;
148 
149     static const SymbolFileDWARFPropertiesSP&
150     GetGlobalPluginProperties()
151     {
152         static const auto g_settings_sp(std::make_shared<PluginProperties>());
153         return g_settings_sp;
154     }
155 
156 }  // anonymous namespace end
157 
158 
159 static const char*
160 removeHostnameFromPathname(const char* path_from_dwarf)
161 {
162     if (!path_from_dwarf || !path_from_dwarf[0])
163     {
164         return path_from_dwarf;
165     }
166 
167     const char *colon_pos = strchr(path_from_dwarf, ':');
168     if (nullptr == colon_pos)
169     {
170         return path_from_dwarf;
171     }
172 
173     const char *slash_pos = strchr(path_from_dwarf, '/');
174     if (slash_pos && (slash_pos < colon_pos))
175     {
176         return path_from_dwarf;
177     }
178 
179     // check whether we have a windows path, and so the first character
180     // is a drive-letter not a hostname.
181     if (
182         colon_pos == path_from_dwarf + 1 &&
183         isalpha(*path_from_dwarf) &&
184         strlen(path_from_dwarf) > 2 &&
185         '\\' == path_from_dwarf[2])
186     {
187         return path_from_dwarf;
188     }
189 
190     return colon_pos + 1;
191 }
192 
193 static const char*
194 resolveCompDir(const char* path_from_dwarf)
195 {
196     if (!path_from_dwarf)
197         return nullptr;
198 
199     // DWARF2/3 suggests the form hostname:pathname for compilation directory.
200     // Remove the host part if present.
201     const char* local_path = removeHostnameFromPathname(path_from_dwarf);
202     if (!local_path)
203         return nullptr;
204 
205     bool is_symlink = false;
206     FileSpec local_path_spec(local_path, false);
207     const auto& file_specs = GetGlobalPluginProperties()->GetSymLinkPaths();
208     for (size_t i = 0; i < file_specs.GetSize() && !is_symlink; ++i)
209         is_symlink = FileSpec::Equal(file_specs.GetFileSpecAtIndex(i), local_path_spec, true);
210 
211     if (!is_symlink)
212         return local_path;
213 
214     if (!local_path_spec.IsSymbolicLink())
215         return local_path;
216 
217     FileSpec resolved_local_path_spec;
218     const auto error = FileSystem::Readlink(local_path_spec, resolved_local_path_spec);
219     if (error.Success())
220         return resolved_local_path_spec.GetCString();
221 
222     return nullptr;
223 }
224 
225 
226 void
227 SymbolFileDWARF::Initialize()
228 {
229     LogChannelDWARF::Initialize();
230     PluginManager::RegisterPlugin (GetPluginNameStatic(),
231                                    GetPluginDescriptionStatic(),
232                                    CreateInstance,
233                                    DebuggerInitialize);
234 }
235 
236 void
237 SymbolFileDWARF::DebuggerInitialize(Debugger &debugger)
238 {
239     if (!PluginManager::GetSettingForSymbolFilePlugin(debugger, PluginProperties::GetSettingName()))
240     {
241         const bool is_global_setting = true;
242         PluginManager::CreateSettingForSymbolFilePlugin(debugger,
243                                                         GetGlobalPluginProperties()->GetValueProperties(),
244                                                         ConstString ("Properties for the dwarf symbol-file plug-in."),
245                                                         is_global_setting);
246     }
247 }
248 
249 void
250 SymbolFileDWARF::Terminate()
251 {
252     PluginManager::UnregisterPlugin (CreateInstance);
253     LogChannelDWARF::Initialize();
254 }
255 
256 
257 lldb_private::ConstString
258 SymbolFileDWARF::GetPluginNameStatic()
259 {
260     static ConstString g_name("dwarf");
261     return g_name;
262 }
263 
264 const char *
265 SymbolFileDWARF::GetPluginDescriptionStatic()
266 {
267     return "DWARF and DWARF3 debug symbol file reader.";
268 }
269 
270 
271 SymbolFile*
272 SymbolFileDWARF::CreateInstance (ObjectFile* obj_file)
273 {
274     return new SymbolFileDWARF(obj_file);
275 }
276 
277 TypeList *
278 SymbolFileDWARF::GetTypeList ()
279 {
280     if (GetDebugMapSymfile ())
281         return m_debug_map_symfile->GetTypeList();
282     return m_obj_file->GetModule()->GetTypeList();
283 
284 }
285 void
286 SymbolFileDWARF::GetTypes (const DWARFDIE &die,
287                            dw_offset_t min_die_offset,
288                            dw_offset_t max_die_offset,
289                            uint32_t type_mask,
290                            TypeSet &type_set)
291 {
292     if (die)
293     {
294         const dw_offset_t die_offset = die.GetOffset();
295 
296         if (die_offset >= max_die_offset)
297             return;
298 
299         if (die_offset >= min_die_offset)
300         {
301             const dw_tag_t tag = die.Tag();
302 
303             bool add_type = false;
304 
305             switch (tag)
306             {
307                 case DW_TAG_array_type:         add_type = (type_mask & eTypeClassArray         ) != 0; break;
308                 case DW_TAG_unspecified_type:
309                 case DW_TAG_base_type:          add_type = (type_mask & eTypeClassBuiltin       ) != 0; break;
310                 case DW_TAG_class_type:         add_type = (type_mask & eTypeClassClass         ) != 0; break;
311                 case DW_TAG_structure_type:     add_type = (type_mask & eTypeClassStruct        ) != 0; break;
312                 case DW_TAG_union_type:         add_type = (type_mask & eTypeClassUnion         ) != 0; break;
313                 case DW_TAG_enumeration_type:   add_type = (type_mask & eTypeClassEnumeration   ) != 0; break;
314                 case DW_TAG_subroutine_type:
315                 case DW_TAG_subprogram:
316                 case DW_TAG_inlined_subroutine: add_type = (type_mask & eTypeClassFunction      ) != 0; break;
317                 case DW_TAG_pointer_type:       add_type = (type_mask & eTypeClassPointer       ) != 0; break;
318                 case DW_TAG_rvalue_reference_type:
319                 case DW_TAG_reference_type:     add_type = (type_mask & eTypeClassReference     ) != 0; break;
320                 case DW_TAG_typedef:            add_type = (type_mask & eTypeClassTypedef       ) != 0; break;
321                 case DW_TAG_ptr_to_member_type: add_type = (type_mask & eTypeClassMemberPointer ) != 0; break;
322             }
323 
324             if (add_type)
325             {
326                 const bool assert_not_being_parsed = true;
327                 Type *type = ResolveTypeUID (die, assert_not_being_parsed);
328                 if (type)
329                 {
330                     if (type_set.find(type) == type_set.end())
331                         type_set.insert(type);
332                 }
333             }
334         }
335 
336         for (DWARFDIE child_die = die.GetFirstChild();
337              child_die.IsValid();
338              child_die = child_die.GetSibling())
339         {
340             GetTypes (child_die, min_die_offset, max_die_offset, type_mask, type_set);
341         }
342     }
343 }
344 
345 size_t
346 SymbolFileDWARF::GetTypes (SymbolContextScope *sc_scope,
347                            uint32_t type_mask,
348                            TypeList &type_list)
349 
350 {
351     TypeSet type_set;
352 
353     CompileUnit *comp_unit = NULL;
354     DWARFCompileUnit* dwarf_cu = NULL;
355     if (sc_scope)
356         comp_unit = sc_scope->CalculateSymbolContextCompileUnit();
357 
358     if (comp_unit)
359     {
360         dwarf_cu = GetDWARFCompileUnit(comp_unit);
361         if (dwarf_cu == 0)
362             return 0;
363         GetTypes (dwarf_cu->DIE(),
364                   dwarf_cu->GetOffset(),
365                   dwarf_cu->GetNextCompileUnitOffset(),
366                   type_mask,
367                   type_set);
368     }
369     else
370     {
371         DWARFDebugInfo* info = DebugInfo();
372         if (info)
373         {
374             const size_t num_cus = info->GetNumCompileUnits();
375             for (size_t cu_idx=0; cu_idx<num_cus; ++cu_idx)
376             {
377                 dwarf_cu = info->GetCompileUnitAtIndex(cu_idx);
378                 if (dwarf_cu)
379                 {
380                     GetTypes (dwarf_cu->DIE(),
381                               0,
382                               UINT32_MAX,
383                               type_mask,
384                               type_set);
385                 }
386             }
387         }
388     }
389 
390     std::set<CompilerType> compiler_type_set;
391     size_t num_types_added = 0;
392     for (Type *type : type_set)
393     {
394         CompilerType compiler_type = type->GetForwardCompilerType ();
395         if (compiler_type_set.find(compiler_type) == compiler_type_set.end())
396         {
397             compiler_type_set.insert(compiler_type);
398             type_list.Insert (type->shared_from_this());
399             ++num_types_added;
400         }
401     }
402     return num_types_added;
403 }
404 
405 
406 //----------------------------------------------------------------------
407 // Gets the first parent that is a lexical block, function or inlined
408 // subroutine, or compile unit.
409 //----------------------------------------------------------------------
410 DWARFDIE
411 SymbolFileDWARF::GetParentSymbolContextDIE(const DWARFDIE &child_die)
412 {
413     DWARFDIE die;
414     for (die = child_die.GetParent(); die; die = die.GetParent())
415     {
416         dw_tag_t tag = die.Tag();
417 
418         switch (tag)
419         {
420         case DW_TAG_compile_unit:
421         case DW_TAG_subprogram:
422         case DW_TAG_inlined_subroutine:
423         case DW_TAG_lexical_block:
424             return die;
425         }
426     }
427     return DWARFDIE();
428 }
429 
430 
431 SymbolFileDWARF::SymbolFileDWARF(ObjectFile* objfile) :
432     SymbolFile (objfile),
433     UserID (0),  // Used by SymbolFileDWARFDebugMap to when this class parses .o files to contain the .o file index/ID
434     m_debug_map_module_wp (),
435     m_debug_map_symfile (NULL),
436     m_data_debug_abbrev (),
437     m_data_debug_aranges (),
438     m_data_debug_frame (),
439     m_data_debug_info (),
440     m_data_debug_line (),
441     m_data_debug_macro (),
442     m_data_debug_loc (),
443     m_data_debug_ranges (),
444     m_data_debug_str (),
445     m_data_apple_names (),
446     m_data_apple_types (),
447     m_data_apple_namespaces (),
448     m_abbr(),
449     m_info(),
450     m_line(),
451     m_apple_names_ap (),
452     m_apple_types_ap (),
453     m_apple_namespaces_ap (),
454     m_apple_objc_ap (),
455     m_function_basename_index(),
456     m_function_fullname_index(),
457     m_function_method_index(),
458     m_function_selector_index(),
459     m_objc_class_selectors_index(),
460     m_global_index(),
461     m_type_index(),
462     m_namespace_index(),
463     m_indexed (false),
464     m_using_apple_tables (false),
465     m_fetched_external_modules (false),
466     m_supports_DW_AT_APPLE_objc_complete_type (eLazyBoolCalculate),
467     m_ranges(),
468     m_unique_ast_type_map ()
469 {
470 }
471 
472 SymbolFileDWARF::~SymbolFileDWARF()
473 {
474 }
475 
476 static const ConstString &
477 GetDWARFMachOSegmentName ()
478 {
479     static ConstString g_dwarf_section_name ("__DWARF");
480     return g_dwarf_section_name;
481 }
482 
483 UniqueDWARFASTTypeMap &
484 SymbolFileDWARF::GetUniqueDWARFASTTypeMap ()
485 {
486     if (GetDebugMapSymfile ())
487         return m_debug_map_symfile->GetUniqueDWARFASTTypeMap ();
488     return m_unique_ast_type_map;
489 }
490 
491 TypeSystem *
492 SymbolFileDWARF::GetTypeSystemForLanguage (LanguageType language)
493 {
494     SymbolFileDWARFDebugMap * debug_map_symfile = GetDebugMapSymfile ();
495     TypeSystem *type_system;
496     if (debug_map_symfile)
497     {
498         type_system = debug_map_symfile->GetTypeSystemForLanguage(language);
499     }
500     else
501     {
502         type_system = m_obj_file->GetModule()->GetTypeSystemForLanguage(language);
503         if (type_system)
504             type_system->SetSymbolFile(this);
505     }
506     return type_system;
507 }
508 
509 void
510 SymbolFileDWARF::InitializeObject()
511 {
512     ModuleSP module_sp (m_obj_file->GetModule());
513     if (module_sp)
514     {
515         const SectionList *section_list = module_sp->GetSectionList();
516         const Section* section = section_list->FindSectionByName(GetDWARFMachOSegmentName ()).get();
517 
518         // Memory map the DWARF mach-o segment so we have everything mmap'ed
519         // to keep our heap memory usage down.
520         if (section)
521             m_obj_file->MemoryMapSectionData(section, m_dwarf_data);
522     }
523 
524     get_apple_names_data();
525     if (m_data_apple_names.m_data.GetByteSize() > 0)
526     {
527         m_apple_names_ap.reset (new DWARFMappedHash::MemoryTable (m_data_apple_names.m_data,
528                                                                   get_debug_str_data(),
529                                                                   ".apple_names"));
530         if (m_apple_names_ap->IsValid())
531             m_using_apple_tables = true;
532         else
533             m_apple_names_ap.reset();
534     }
535     get_apple_types_data();
536     if (m_data_apple_types.m_data.GetByteSize() > 0)
537     {
538         m_apple_types_ap.reset (new DWARFMappedHash::MemoryTable (m_data_apple_types.m_data,
539                                                                   get_debug_str_data(),
540                                                                   ".apple_types"));
541         if (m_apple_types_ap->IsValid())
542             m_using_apple_tables = true;
543         else
544             m_apple_types_ap.reset();
545     }
546 
547     get_apple_namespaces_data();
548     if (m_data_apple_namespaces.m_data.GetByteSize() > 0)
549     {
550         m_apple_namespaces_ap.reset (new DWARFMappedHash::MemoryTable (m_data_apple_namespaces.m_data,
551                                                                        get_debug_str_data(),
552                                                                        ".apple_namespaces"));
553         if (m_apple_namespaces_ap->IsValid())
554             m_using_apple_tables = true;
555         else
556             m_apple_namespaces_ap.reset();
557     }
558 
559     get_apple_objc_data();
560     if (m_data_apple_objc.m_data.GetByteSize() > 0)
561     {
562         m_apple_objc_ap.reset (new DWARFMappedHash::MemoryTable (m_data_apple_objc.m_data,
563                                                                  get_debug_str_data(),
564                                                                  ".apple_objc"));
565         if (m_apple_objc_ap->IsValid())
566             m_using_apple_tables = true;
567         else
568             m_apple_objc_ap.reset();
569     }
570 }
571 
572 bool
573 SymbolFileDWARF::SupportedVersion(uint16_t version)
574 {
575     return version == 2 || version == 3 || version == 4;
576 }
577 
578 uint32_t
579 SymbolFileDWARF::CalculateAbilities ()
580 {
581     uint32_t abilities = 0;
582     if (m_obj_file != NULL)
583     {
584         const Section* section = NULL;
585         const SectionList *section_list = m_obj_file->GetSectionList();
586         if (section_list == NULL)
587             return 0;
588 
589         uint64_t debug_abbrev_file_size = 0;
590         uint64_t debug_info_file_size = 0;
591         uint64_t debug_line_file_size = 0;
592 
593         section = section_list->FindSectionByName(GetDWARFMachOSegmentName ()).get();
594 
595         if (section)
596             section_list = &section->GetChildren ();
597 
598         section = section_list->FindSectionByType (eSectionTypeDWARFDebugInfo, true).get();
599         if (section != NULL)
600         {
601             debug_info_file_size = section->GetFileSize();
602 
603             section = section_list->FindSectionByType (eSectionTypeDWARFDebugAbbrev, true).get();
604             if (section)
605                 debug_abbrev_file_size = section->GetFileSize();
606 
607             section = section_list->FindSectionByType (eSectionTypeDWARFDebugLine, true).get();
608             if (section)
609                 debug_line_file_size = section->GetFileSize();
610         }
611         else
612         {
613             const char *symfile_dir_cstr = m_obj_file->GetFileSpec().GetDirectory().GetCString();
614             if (symfile_dir_cstr)
615             {
616                 if (strcasestr(symfile_dir_cstr, ".dsym"))
617                 {
618                     if (m_obj_file->GetType() == ObjectFile::eTypeDebugInfo)
619                     {
620                         // We have a dSYM file that didn't have a any debug info.
621                         // If the string table has a size of 1, then it was made from
622                         // an executable with no debug info, or from an executable that
623                         // was stripped.
624                         section = section_list->FindSectionByType (eSectionTypeDWARFDebugStr, true).get();
625                         if (section && section->GetFileSize() == 1)
626                         {
627                             m_obj_file->GetModule()->ReportWarning ("empty dSYM file detected, dSYM was created with an executable with no debug info.");
628                         }
629                     }
630                 }
631             }
632         }
633 
634         if (debug_abbrev_file_size > 0 && debug_info_file_size > 0)
635             abilities |= CompileUnits | Functions | Blocks | GlobalVariables | LocalVariables | VariableTypes;
636 
637         if (debug_line_file_size > 0)
638             abilities |= LineTables;
639     }
640     return abilities;
641 }
642 
643 const DWARFDataExtractor&
644 SymbolFileDWARF::GetCachedSectionData (lldb::SectionType sect_type, DWARFDataSegment& data_segment)
645 {
646     std::call_once(data_segment.m_flag,
647                    &SymbolFileDWARF::LoadSectionData,
648                    this,
649                    sect_type,
650                    std::ref(data_segment.m_data));
651     return data_segment.m_data;
652 }
653 
654 void
655 SymbolFileDWARF::LoadSectionData (lldb::SectionType sect_type, DWARFDataExtractor& data)
656 {
657     ModuleSP module_sp (m_obj_file->GetModule());
658     const SectionList *section_list = module_sp->GetSectionList();
659     if (section_list)
660     {
661         SectionSP section_sp (section_list->FindSectionByType(sect_type, true));
662         if (section_sp)
663         {
664             // See if we memory mapped the DWARF segment?
665             if (m_dwarf_data.GetByteSize())
666             {
667                 data.SetData(m_dwarf_data, section_sp->GetOffset(), section_sp->GetFileSize());
668             }
669             else
670             {
671                 if (m_obj_file->ReadSectionData(section_sp.get(), data) == 0)
672                     data.Clear();
673             }
674         }
675     }
676 }
677 
678 const DWARFDataExtractor&
679 SymbolFileDWARF::get_debug_abbrev_data()
680 {
681     return GetCachedSectionData (eSectionTypeDWARFDebugAbbrev, m_data_debug_abbrev);
682 }
683 
684 const DWARFDataExtractor&
685 SymbolFileDWARF::get_debug_addr_data()
686 {
687     return GetCachedSectionData (eSectionTypeDWARFDebugAddr, m_data_debug_addr);
688 }
689 
690 const DWARFDataExtractor&
691 SymbolFileDWARF::get_debug_aranges_data()
692 {
693     return GetCachedSectionData (eSectionTypeDWARFDebugAranges, m_data_debug_aranges);
694 }
695 
696 const DWARFDataExtractor&
697 SymbolFileDWARF::get_debug_frame_data()
698 {
699     return GetCachedSectionData (eSectionTypeDWARFDebugFrame, m_data_debug_frame);
700 }
701 
702 const DWARFDataExtractor&
703 SymbolFileDWARF::get_debug_info_data()
704 {
705     return GetCachedSectionData (eSectionTypeDWARFDebugInfo, m_data_debug_info);
706 }
707 
708 const DWARFDataExtractor&
709 SymbolFileDWARF::get_debug_line_data()
710 {
711     return GetCachedSectionData (eSectionTypeDWARFDebugLine, m_data_debug_line);
712 }
713 
714 const DWARFDataExtractor&
715 SymbolFileDWARF::get_debug_macro_data()
716 {
717     return GetCachedSectionData (eSectionTypeDWARFDebugMacro, m_data_debug_macro);
718 }
719 
720 const DWARFDataExtractor&
721 SymbolFileDWARF::get_debug_loc_data()
722 {
723     return GetCachedSectionData (eSectionTypeDWARFDebugLoc, m_data_debug_loc);
724 }
725 
726 const DWARFDataExtractor&
727 SymbolFileDWARF::get_debug_ranges_data()
728 {
729     return GetCachedSectionData (eSectionTypeDWARFDebugRanges, m_data_debug_ranges);
730 }
731 
732 const DWARFDataExtractor&
733 SymbolFileDWARF::get_debug_str_data()
734 {
735     return GetCachedSectionData (eSectionTypeDWARFDebugStr, m_data_debug_str);
736 }
737 
738 const DWARFDataExtractor&
739 SymbolFileDWARF::get_debug_str_offsets_data()
740 {
741     return GetCachedSectionData (eSectionTypeDWARFDebugStrOffsets, m_data_debug_str_offsets);
742 }
743 
744 const DWARFDataExtractor&
745 SymbolFileDWARF::get_apple_names_data()
746 {
747     return GetCachedSectionData (eSectionTypeDWARFAppleNames, m_data_apple_names);
748 }
749 
750 const DWARFDataExtractor&
751 SymbolFileDWARF::get_apple_types_data()
752 {
753     return GetCachedSectionData (eSectionTypeDWARFAppleTypes, m_data_apple_types);
754 }
755 
756 const DWARFDataExtractor&
757 SymbolFileDWARF::get_apple_namespaces_data()
758 {
759     return GetCachedSectionData (eSectionTypeDWARFAppleNamespaces, m_data_apple_namespaces);
760 }
761 
762 const DWARFDataExtractor&
763 SymbolFileDWARF::get_apple_objc_data()
764 {
765     return GetCachedSectionData (eSectionTypeDWARFAppleObjC, m_data_apple_objc);
766 }
767 
768 
769 DWARFDebugAbbrev*
770 SymbolFileDWARF::DebugAbbrev()
771 {
772     if (m_abbr.get() == NULL)
773     {
774         const DWARFDataExtractor &debug_abbrev_data = get_debug_abbrev_data();
775         if (debug_abbrev_data.GetByteSize() > 0)
776         {
777             m_abbr.reset(new DWARFDebugAbbrev());
778             if (m_abbr.get())
779                 m_abbr->Parse(debug_abbrev_data);
780         }
781     }
782     return m_abbr.get();
783 }
784 
785 const DWARFDebugAbbrev*
786 SymbolFileDWARF::DebugAbbrev() const
787 {
788     return m_abbr.get();
789 }
790 
791 
792 DWARFDebugInfo*
793 SymbolFileDWARF::DebugInfo()
794 {
795     if (m_info.get() == NULL)
796     {
797         Timer scoped_timer(__PRETTY_FUNCTION__, "%s this = %p",
798                            __PRETTY_FUNCTION__, static_cast<void*>(this));
799         if (get_debug_info_data().GetByteSize() > 0)
800         {
801             m_info.reset(new DWARFDebugInfo());
802             if (m_info.get())
803             {
804                 m_info->SetDwarfData(this);
805             }
806         }
807     }
808     return m_info.get();
809 }
810 
811 const DWARFDebugInfo*
812 SymbolFileDWARF::DebugInfo() const
813 {
814     return m_info.get();
815 }
816 
817 DWARFCompileUnit*
818 SymbolFileDWARF::GetDWARFCompileUnit(lldb_private::CompileUnit *comp_unit)
819 {
820     if (!comp_unit)
821         return nullptr;
822 
823     DWARFDebugInfo* info = DebugInfo();
824     if (info)
825     {
826         if (GetDebugMapSymfile ())
827         {
828             // The debug map symbol file made the compile units for this DWARF
829             // file which is .o file with DWARF in it, and we should have
830             // only 1 compile unit which is at offset zero in the DWARF.
831             // TODO: modify to support LTO .o files where each .o file might
832             // have multiple DW_TAG_compile_unit tags.
833 
834             DWARFCompileUnit *dwarf_cu = info->GetCompileUnit(0);
835             if (dwarf_cu && dwarf_cu->GetUserData() == NULL)
836                 dwarf_cu->SetUserData(comp_unit);
837             return dwarf_cu;
838         }
839         else
840         {
841             // Just a normal DWARF file whose user ID for the compile unit is
842             // the DWARF offset itself
843 
844             DWARFCompileUnit *dwarf_cu = info->GetCompileUnit((dw_offset_t)comp_unit->GetID());
845             if (dwarf_cu && dwarf_cu->GetUserData() == NULL)
846                 dwarf_cu->SetUserData(comp_unit);
847             return dwarf_cu;
848 
849         }
850     }
851     return NULL;
852 }
853 
854 
855 DWARFDebugRanges*
856 SymbolFileDWARF::DebugRanges()
857 {
858     if (m_ranges.get() == NULL)
859     {
860         Timer scoped_timer(__PRETTY_FUNCTION__, "%s this = %p",
861                            __PRETTY_FUNCTION__, static_cast<void*>(this));
862         if (get_debug_ranges_data().GetByteSize() > 0)
863         {
864             m_ranges.reset(new DWARFDebugRanges());
865             if (m_ranges.get())
866                 m_ranges->Extract(this);
867         }
868     }
869     return m_ranges.get();
870 }
871 
872 const DWARFDebugRanges*
873 SymbolFileDWARF::DebugRanges() const
874 {
875     return m_ranges.get();
876 }
877 
878 lldb::CompUnitSP
879 SymbolFileDWARF::ParseCompileUnit (DWARFCompileUnit* dwarf_cu, uint32_t cu_idx)
880 {
881     CompUnitSP cu_sp;
882     if (dwarf_cu)
883     {
884         CompileUnit *comp_unit = (CompileUnit*)dwarf_cu->GetUserData();
885         if (comp_unit)
886         {
887             // We already parsed this compile unit, had out a shared pointer to it
888             cu_sp = comp_unit->shared_from_this();
889         }
890         else
891         {
892             if (dwarf_cu->GetSymbolFileDWARF() != this)
893             {
894                 return dwarf_cu->GetSymbolFileDWARF()->ParseCompileUnit(dwarf_cu, cu_idx);
895             }
896             else if (GetDebugMapSymfile ())
897             {
898                 // Let the debug map create the compile unit
899                 cu_sp = m_debug_map_symfile->GetCompileUnit(this);
900                 dwarf_cu->SetUserData(cu_sp.get());
901             }
902             else
903             {
904                 ModuleSP module_sp (m_obj_file->GetModule());
905                 if (module_sp)
906                 {
907                     const DWARFDIE cu_die = dwarf_cu->GetCompileUnitDIEOnly ();
908                     if (cu_die)
909                     {
910                         FileSpec cu_file_spec{cu_die.GetName(), false};
911                         if (cu_file_spec)
912                         {
913                             // If we have a full path to the compile unit, we don't need to resolve
914                             // the file.  This can be expensive e.g. when the source files are NFS mounted.
915                             if (cu_file_spec.IsRelative())
916                             {
917                                 const char *cu_comp_dir{cu_die.GetAttributeValueAsString(DW_AT_comp_dir, nullptr)};
918                                 cu_file_spec.PrependPathComponent(resolveCompDir(cu_comp_dir));
919                             }
920 
921                             std::string remapped_file;
922                             if (module_sp->RemapSourceFile(cu_file_spec.GetCString(), remapped_file))
923                                 cu_file_spec.SetFile(remapped_file, false);
924                         }
925 
926                         LanguageType cu_language = DWARFCompileUnit::LanguageTypeFromDWARF(cu_die.GetAttributeValueAsUnsigned(DW_AT_language, 0));
927 
928                         bool is_optimized = dwarf_cu->GetIsOptimized ();
929                         cu_sp.reset(new CompileUnit (module_sp,
930                                                      dwarf_cu,
931                                                      cu_file_spec,
932                                                      dwarf_cu->GetID(),
933                                                      cu_language,
934                                                      is_optimized));
935                         if (cu_sp)
936                         {
937                             // If we just created a compile unit with an invalid file spec, try and get the
938                             // first entry in the supports files from the line table as that should be the
939                             // compile unit.
940                             if (!cu_file_spec)
941                             {
942                                 cu_file_spec = cu_sp->GetSupportFiles().GetFileSpecAtIndex(1);
943                                 if (cu_file_spec)
944                                 {
945                                     (FileSpec &)(*cu_sp) = cu_file_spec;
946                                     // Also fix the invalid file spec which was copied from the compile unit.
947                                     cu_sp->GetSupportFiles().Replace(0, cu_file_spec);
948                                 }
949                             }
950 
951                             dwarf_cu->SetUserData(cu_sp.get());
952 
953                             // Figure out the compile unit index if we weren't given one
954                             if (cu_idx == UINT32_MAX)
955                                 DebugInfo()->GetCompileUnit(dwarf_cu->GetOffset(), &cu_idx);
956 
957                             m_obj_file->GetModule()->GetSymbolVendor()->SetCompileUnitAtIndex(cu_idx, cu_sp);
958                         }
959                     }
960                 }
961             }
962         }
963     }
964     return cu_sp;
965 }
966 
967 uint32_t
968 SymbolFileDWARF::GetNumCompileUnits()
969 {
970     DWARFDebugInfo* info = DebugInfo();
971     if (info)
972         return info->GetNumCompileUnits();
973     return 0;
974 }
975 
976 CompUnitSP
977 SymbolFileDWARF::ParseCompileUnitAtIndex(uint32_t cu_idx)
978 {
979     CompUnitSP cu_sp;
980     DWARFDebugInfo* info = DebugInfo();
981     if (info)
982     {
983         DWARFCompileUnit* dwarf_cu = info->GetCompileUnitAtIndex(cu_idx);
984         if (dwarf_cu)
985             cu_sp = ParseCompileUnit(dwarf_cu, cu_idx);
986     }
987     return cu_sp;
988 }
989 
990 Function *
991 SymbolFileDWARF::ParseCompileUnitFunction (const SymbolContext& sc, const DWARFDIE &die)
992 {
993     if (die.IsValid())
994     {
995         TypeSystem *type_system = GetTypeSystemForLanguage(die.GetCU()->GetLanguageType());
996 
997         if (type_system)
998         {
999             DWARFASTParser *dwarf_ast = type_system->GetDWARFParser();
1000             if (dwarf_ast)
1001                 return dwarf_ast->ParseFunctionFromDWARF(sc, die);
1002         }
1003     }
1004     return nullptr;
1005 }
1006 
1007 bool
1008 SymbolFileDWARF::FixupAddress (Address &addr)
1009 {
1010     SymbolFileDWARFDebugMap * debug_map_symfile = GetDebugMapSymfile ();
1011     if (debug_map_symfile)
1012     {
1013         return debug_map_symfile->LinkOSOAddress(addr);
1014     }
1015     // This is a normal DWARF file, no address fixups need to happen
1016     return true;
1017 }
1018 lldb::LanguageType
1019 SymbolFileDWARF::ParseCompileUnitLanguage (const SymbolContext& sc)
1020 {
1021     assert (sc.comp_unit);
1022     DWARFCompileUnit* dwarf_cu = GetDWARFCompileUnit(sc.comp_unit);
1023     if (dwarf_cu)
1024         return dwarf_cu->GetLanguageType();
1025     else
1026         return eLanguageTypeUnknown;
1027 }
1028 
1029 size_t
1030 SymbolFileDWARF::ParseCompileUnitFunctions(const SymbolContext &sc)
1031 {
1032     assert (sc.comp_unit);
1033     size_t functions_added = 0;
1034     DWARFCompileUnit* dwarf_cu = GetDWARFCompileUnit(sc.comp_unit);
1035     if (dwarf_cu)
1036     {
1037         DWARFDIECollection function_dies;
1038         const size_t num_functions = dwarf_cu->AppendDIEsWithTag (DW_TAG_subprogram, function_dies);
1039         size_t func_idx;
1040         for (func_idx = 0; func_idx < num_functions; ++func_idx)
1041         {
1042             DWARFDIE die = function_dies.GetDIEAtIndex(func_idx);
1043             if (sc.comp_unit->FindFunctionByUID (die.GetID()).get() == NULL)
1044             {
1045                 if (ParseCompileUnitFunction(sc, die))
1046                     ++functions_added;
1047             }
1048         }
1049         //FixupTypes();
1050     }
1051     return functions_added;
1052 }
1053 
1054 bool
1055 SymbolFileDWARF::ParseCompileUnitSupportFiles (const SymbolContext& sc, FileSpecList& support_files)
1056 {
1057     assert (sc.comp_unit);
1058     DWARFCompileUnit* dwarf_cu = GetDWARFCompileUnit(sc.comp_unit);
1059     if (dwarf_cu)
1060     {
1061         const DWARFDIE cu_die = dwarf_cu->GetCompileUnitDIEOnly();
1062 
1063         if (cu_die)
1064         {
1065             const char * cu_comp_dir = resolveCompDir(cu_die.GetAttributeValueAsString(DW_AT_comp_dir, nullptr));
1066 
1067             const dw_offset_t stmt_list = cu_die.GetAttributeValueAsUnsigned(DW_AT_stmt_list, DW_INVALID_OFFSET);
1068             if (stmt_list != DW_INVALID_OFFSET)
1069             {
1070                 // All file indexes in DWARF are one based and a file of index zero is
1071                 // supposed to be the compile unit itself.
1072                 support_files.Append (*sc.comp_unit);
1073                 return DWARFDebugLine::ParseSupportFiles(sc.comp_unit->GetModule(),
1074                                                          get_debug_line_data(),
1075                                                          cu_comp_dir,
1076                                                          stmt_list,
1077                                                          support_files);
1078             }
1079         }
1080     }
1081     return false;
1082 }
1083 
1084 bool
1085 SymbolFileDWARF::ParseImportedModules (const lldb_private::SymbolContext &sc, std::vector<lldb_private::ConstString> &imported_modules)
1086 {
1087     assert (sc.comp_unit);
1088     DWARFCompileUnit* dwarf_cu = GetDWARFCompileUnit(sc.comp_unit);
1089     if (dwarf_cu)
1090     {
1091         if (ClangModulesDeclVendor::LanguageSupportsClangModules(sc.comp_unit->GetLanguage()))
1092         {
1093             UpdateExternalModuleListIfNeeded();
1094 
1095             if (sc.comp_unit)
1096             {
1097                 const DWARFDIE die = dwarf_cu->GetCompileUnitDIEOnly();
1098 
1099                 if (die)
1100                 {
1101                     for (DWARFDIE child_die = die.GetFirstChild();
1102                          child_die;
1103                          child_die = child_die.GetSibling())
1104                     {
1105                         if (child_die.Tag() == DW_TAG_imported_declaration)
1106                         {
1107                             if (DWARFDIE module_die = child_die.GetReferencedDIE(DW_AT_import))
1108                             {
1109                                 if (module_die.Tag() == DW_TAG_module)
1110                                 {
1111                                     if (const char *name = module_die.GetAttributeValueAsString(DW_AT_name, nullptr))
1112                                     {
1113                                         ConstString const_name(name);
1114                                         imported_modules.push_back(const_name);
1115                                     }
1116                                 }
1117                             }
1118                         }
1119                     }
1120                 }
1121             }
1122             else
1123             {
1124                 for (const auto &pair : m_external_type_modules)
1125                 {
1126                     imported_modules.push_back(pair.first);
1127                 }
1128             }
1129         }
1130     }
1131     return false;
1132 }
1133 
1134 struct ParseDWARFLineTableCallbackInfo
1135 {
1136     LineTable* line_table;
1137     std::unique_ptr<LineSequence> sequence_ap;
1138     lldb::addr_t addr_mask;
1139 };
1140 
1141 //----------------------------------------------------------------------
1142 // ParseStatementTableCallback
1143 //----------------------------------------------------------------------
1144 static void
1145 ParseDWARFLineTableCallback(dw_offset_t offset, const DWARFDebugLine::State& state, void* userData)
1146 {
1147     if (state.row == DWARFDebugLine::State::StartParsingLineTable)
1148     {
1149         // Just started parsing the line table
1150     }
1151     else if (state.row == DWARFDebugLine::State::DoneParsingLineTable)
1152     {
1153         // Done parsing line table, nothing to do for the cleanup
1154     }
1155     else
1156     {
1157         ParseDWARFLineTableCallbackInfo* info = (ParseDWARFLineTableCallbackInfo*)userData;
1158         LineTable* line_table = info->line_table;
1159 
1160         // If this is our first time here, we need to create a
1161         // sequence container.
1162         if (!info->sequence_ap.get())
1163         {
1164             info->sequence_ap.reset(line_table->CreateLineSequenceContainer());
1165             assert(info->sequence_ap.get());
1166         }
1167         line_table->AppendLineEntryToSequence (info->sequence_ap.get(),
1168                                                state.address & info->addr_mask,
1169                                                state.line,
1170                                                state.column,
1171                                                state.file,
1172                                                state.is_stmt,
1173                                                state.basic_block,
1174                                                state.prologue_end,
1175                                                state.epilogue_begin,
1176                                                state.end_sequence);
1177         if (state.end_sequence)
1178         {
1179             // First, put the current sequence into the line table.
1180             line_table->InsertSequence(info->sequence_ap.get());
1181             // Then, empty it to prepare for the next sequence.
1182             info->sequence_ap->Clear();
1183         }
1184     }
1185 }
1186 
1187 bool
1188 SymbolFileDWARF::ParseCompileUnitLineTable (const SymbolContext &sc)
1189 {
1190     assert (sc.comp_unit);
1191     if (sc.comp_unit->GetLineTable() != NULL)
1192         return true;
1193 
1194     DWARFCompileUnit* dwarf_cu = GetDWARFCompileUnit(sc.comp_unit);
1195     if (dwarf_cu)
1196     {
1197         const DWARFDIE dwarf_cu_die = dwarf_cu->GetCompileUnitDIEOnly();
1198         if (dwarf_cu_die)
1199         {
1200             const dw_offset_t cu_line_offset = dwarf_cu_die.GetAttributeValueAsUnsigned(DW_AT_stmt_list, DW_INVALID_OFFSET);
1201             if (cu_line_offset != DW_INVALID_OFFSET)
1202             {
1203                 std::unique_ptr<LineTable> line_table_ap(new LineTable(sc.comp_unit));
1204                 if (line_table_ap.get())
1205                 {
1206                     ParseDWARFLineTableCallbackInfo info;
1207                     info.line_table = line_table_ap.get();
1208 
1209                     /*
1210                      * MIPS:
1211                      * The SymbolContext may not have a valid target, thus we may not be able
1212                      * to call Address::GetOpcodeLoadAddress() which would clear the bit #0
1213                      * for MIPS. Use ArchSpec to clear the bit #0.
1214                     */
1215                     ArchSpec arch;
1216                     GetObjectFile()->GetArchitecture(arch);
1217                     switch (arch.GetMachine())
1218                     {
1219                     case llvm::Triple::mips:
1220                     case llvm::Triple::mipsel:
1221                     case llvm::Triple::mips64:
1222                     case llvm::Triple::mips64el:
1223                         info.addr_mask = ~((lldb::addr_t)1);
1224                         break;
1225                     default:
1226                         info.addr_mask = ~((lldb::addr_t)0);
1227                         break;
1228                     }
1229 
1230                     lldb::offset_t offset = cu_line_offset;
1231                     DWARFDebugLine::ParseStatementTable(get_debug_line_data(), &offset, ParseDWARFLineTableCallback, &info);
1232                     if (m_debug_map_symfile)
1233                     {
1234                         // We have an object file that has a line table with addresses
1235                         // that are not linked. We need to link the line table and convert
1236                         // the addresses that are relative to the .o file into addresses
1237                         // for the main executable.
1238                         sc.comp_unit->SetLineTable (m_debug_map_symfile->LinkOSOLineTable (this, line_table_ap.get()));
1239                     }
1240                     else
1241                     {
1242                         sc.comp_unit->SetLineTable(line_table_ap.release());
1243                         return true;
1244                     }
1245                 }
1246             }
1247         }
1248     }
1249     return false;
1250 }
1251 
1252 lldb_private::DebugMacrosSP
1253 SymbolFileDWARF::ParseDebugMacros(lldb::offset_t *offset)
1254 {
1255     auto iter = m_debug_macros_map.find(*offset);
1256     if (iter != m_debug_macros_map.end())
1257         return iter->second;
1258 
1259     const DWARFDataExtractor &debug_macro_data = get_debug_macro_data();
1260     if (debug_macro_data.GetByteSize() == 0)
1261         return DebugMacrosSP();
1262 
1263     lldb_private::DebugMacrosSP debug_macros_sp(new lldb_private::DebugMacros());
1264     m_debug_macros_map[*offset] = debug_macros_sp;
1265 
1266     const DWARFDebugMacroHeader &header = DWARFDebugMacroHeader::ParseHeader(debug_macro_data, offset);
1267     DWARFDebugMacroEntry::ReadMacroEntries(
1268         debug_macro_data, get_debug_str_data(), header.OffsetIs64Bit(), offset, this, debug_macros_sp);
1269 
1270     return debug_macros_sp;
1271 }
1272 
1273 bool
1274 SymbolFileDWARF::ParseCompileUnitDebugMacros(const SymbolContext& sc)
1275 {
1276     assert (sc.comp_unit);
1277 
1278     DWARFCompileUnit* dwarf_cu = GetDWARFCompileUnit(sc.comp_unit);
1279     if (dwarf_cu == nullptr)
1280         return false;
1281 
1282     const DWARFDIE dwarf_cu_die = dwarf_cu->GetCompileUnitDIEOnly();
1283     if (!dwarf_cu_die)
1284         return false;
1285 
1286     lldb::offset_t sect_offset = dwarf_cu_die.GetAttributeValueAsUnsigned(DW_AT_macros, DW_INVALID_OFFSET);
1287     if (sect_offset == DW_INVALID_OFFSET)
1288         sect_offset = dwarf_cu_die.GetAttributeValueAsUnsigned(DW_AT_GNU_macros, DW_INVALID_OFFSET);
1289     if (sect_offset == DW_INVALID_OFFSET)
1290         return false;
1291 
1292     sc.comp_unit->SetDebugMacros(ParseDebugMacros(&sect_offset));
1293 
1294     return true;
1295 }
1296 
1297 size_t
1298 SymbolFileDWARF::ParseFunctionBlocks (const SymbolContext& sc,
1299                                       Block *parent_block,
1300                                       const DWARFDIE &orig_die,
1301                                       addr_t subprogram_low_pc,
1302                                       uint32_t depth)
1303 {
1304     size_t blocks_added = 0;
1305     DWARFDIE die = orig_die;
1306     while (die)
1307     {
1308         dw_tag_t tag = die.Tag();
1309 
1310         switch (tag)
1311         {
1312         case DW_TAG_inlined_subroutine:
1313         case DW_TAG_subprogram:
1314         case DW_TAG_lexical_block:
1315             {
1316                 Block *block = NULL;
1317                 if (tag == DW_TAG_subprogram)
1318                 {
1319                     // Skip any DW_TAG_subprogram DIEs that are inside
1320                     // of a normal or inlined functions. These will be
1321                     // parsed on their own as separate entities.
1322 
1323                     if (depth > 0)
1324                         break;
1325 
1326                     block = parent_block;
1327                 }
1328                 else
1329                 {
1330                     BlockSP block_sp(new Block (die.GetID()));
1331                     parent_block->AddChild(block_sp);
1332                     block = block_sp.get();
1333                 }
1334                 DWARFRangeList ranges;
1335                 const char *name = NULL;
1336                 const char *mangled_name = NULL;
1337 
1338                 int decl_file = 0;
1339                 int decl_line = 0;
1340                 int decl_column = 0;
1341                 int call_file = 0;
1342                 int call_line = 0;
1343                 int call_column = 0;
1344                 if (die.GetDIENamesAndRanges (name,
1345                                               mangled_name,
1346                                               ranges,
1347                                               decl_file, decl_line, decl_column,
1348                                               call_file, call_line, call_column, nullptr))
1349                 {
1350                     if (tag == DW_TAG_subprogram)
1351                     {
1352                         assert (subprogram_low_pc == LLDB_INVALID_ADDRESS);
1353                         subprogram_low_pc = ranges.GetMinRangeBase(0);
1354                     }
1355                     else if (tag == DW_TAG_inlined_subroutine)
1356                     {
1357                         // We get called here for inlined subroutines in two ways.
1358                         // The first time is when we are making the Function object
1359                         // for this inlined concrete instance.  Since we're creating a top level block at
1360                         // here, the subprogram_low_pc will be LLDB_INVALID_ADDRESS.  So we need to
1361                         // adjust the containing address.
1362                         // The second time is when we are parsing the blocks inside the function that contains
1363                         // the inlined concrete instance.  Since these will be blocks inside the containing "real"
1364                         // function the offset will be for that function.
1365                         if (subprogram_low_pc == LLDB_INVALID_ADDRESS)
1366                         {
1367                             subprogram_low_pc = ranges.GetMinRangeBase(0);
1368                         }
1369                     }
1370 
1371                     const size_t num_ranges = ranges.GetSize();
1372                     for (size_t i = 0; i<num_ranges; ++i)
1373                     {
1374                         const DWARFRangeList::Entry &range = ranges.GetEntryRef (i);
1375                         const addr_t range_base = range.GetRangeBase();
1376                         if (range_base >= subprogram_low_pc)
1377                             block->AddRange(Block::Range (range_base - subprogram_low_pc, range.GetByteSize()));
1378                         else
1379                         {
1380                             GetObjectFile()->GetModule()->ReportError ("0x%8.8" PRIx64 ": adding range [0x%" PRIx64 "-0x%" PRIx64 ") which has a base that is less than the function's low PC 0x%" PRIx64 ". Please file a bug and attach the file at the start of this error message",
1381                                                                        block->GetID(),
1382                                                                        range_base,
1383                                                                        range.GetRangeEnd(),
1384                                                                        subprogram_low_pc);
1385                         }
1386                     }
1387                     block->FinalizeRanges ();
1388 
1389                     if (tag != DW_TAG_subprogram && (name != NULL || mangled_name != NULL))
1390                     {
1391                         std::unique_ptr<Declaration> decl_ap;
1392                         if (decl_file != 0 || decl_line != 0 || decl_column != 0)
1393                             decl_ap.reset(new Declaration(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(decl_file),
1394                                                           decl_line, decl_column));
1395 
1396                         std::unique_ptr<Declaration> call_ap;
1397                         if (call_file != 0 || call_line != 0 || call_column != 0)
1398                             call_ap.reset(new Declaration(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(call_file),
1399                                                           call_line, call_column));
1400 
1401                         block->SetInlinedFunctionInfo (name, mangled_name, decl_ap.get(), call_ap.get());
1402                     }
1403 
1404                     ++blocks_added;
1405 
1406                     if (die.HasChildren())
1407                     {
1408                         blocks_added += ParseFunctionBlocks (sc,
1409                                                              block,
1410                                                              die.GetFirstChild(),
1411                                                              subprogram_low_pc,
1412                                                              depth + 1);
1413                     }
1414                 }
1415             }
1416             break;
1417         default:
1418             break;
1419         }
1420 
1421         // Only parse siblings of the block if we are not at depth zero. A depth
1422         // of zero indicates we are currently parsing the top level
1423         // DW_TAG_subprogram DIE
1424 
1425         if (depth == 0)
1426             die.Clear();
1427         else
1428             die = die.GetSibling();
1429     }
1430     return blocks_added;
1431 }
1432 
1433 bool
1434 SymbolFileDWARF::ClassOrStructIsVirtual (const DWARFDIE &parent_die)
1435 {
1436     if (parent_die)
1437     {
1438         for (DWARFDIE die = parent_die.GetFirstChild(); die; die = die.GetSibling())
1439         {
1440             dw_tag_t tag = die.Tag();
1441             bool check_virtuality = false;
1442             switch (tag)
1443             {
1444                 case DW_TAG_inheritance:
1445                 case DW_TAG_subprogram:
1446                     check_virtuality = true;
1447                     break;
1448                 default:
1449                     break;
1450             }
1451             if (check_virtuality)
1452             {
1453                 if (die.GetAttributeValueAsUnsigned(DW_AT_virtuality, 0) != 0)
1454                     return true;
1455             }
1456         }
1457     }
1458     return false;
1459 }
1460 
1461 void
1462 SymbolFileDWARF::ParseDeclsForContext (CompilerDeclContext decl_ctx)
1463 {
1464     TypeSystem *type_system = decl_ctx.GetTypeSystem();
1465     DWARFASTParser *ast_parser = type_system->GetDWARFParser();
1466     std::vector<DWARFDIE> decl_ctx_die_list = ast_parser->GetDIEForDeclContext(decl_ctx);
1467 
1468     for (DWARFDIE decl_ctx_die : decl_ctx_die_list)
1469         for (DWARFDIE decl = decl_ctx_die.GetFirstChild(); decl; decl = decl.GetSibling())
1470             ast_parser->GetDeclForUIDFromDWARF(decl);
1471 }
1472 
1473 CompilerDecl
1474 SymbolFileDWARF::GetDeclForUID (lldb::user_id_t type_uid)
1475 {
1476     if (UserIDMatches(type_uid))
1477     {
1478         DWARFDebugInfo* debug_info = DebugInfo();
1479         if (debug_info)
1480         {
1481             DWARFDIE die = debug_info->GetDIE(DIERef(type_uid));
1482             if (die)
1483             {
1484                 DWARFASTParser *dwarf_ast = die.GetDWARFParser();
1485                 if (dwarf_ast)
1486                     return dwarf_ast->GetDeclForUIDFromDWARF(die);
1487             }
1488         }
1489     }
1490     return CompilerDecl();
1491 }
1492 
1493 CompilerDeclContext
1494 SymbolFileDWARF::GetDeclContextForUID (lldb::user_id_t type_uid)
1495 {
1496     if (UserIDMatches(type_uid))
1497     {
1498         DWARFDebugInfo* debug_info = DebugInfo();
1499         if (debug_info)
1500         {
1501             DWARFDIE die = debug_info->GetDIE(DIERef(type_uid));
1502             if (die)
1503             {
1504                 DWARFASTParser *dwarf_ast = die.GetDWARFParser();
1505                 if (dwarf_ast)
1506                     return dwarf_ast->GetDeclContextForUIDFromDWARF(die);
1507             }
1508         }
1509     }
1510     return CompilerDeclContext();
1511 }
1512 
1513 CompilerDeclContext
1514 SymbolFileDWARF::GetDeclContextContainingUID (lldb::user_id_t type_uid)
1515 {
1516     if (UserIDMatches(type_uid))
1517     {
1518         DWARFDebugInfo* debug_info = DebugInfo();
1519         if (debug_info)
1520         {
1521             DWARFDIE die = debug_info->GetDIE(DIERef(type_uid));
1522             if (die)
1523             {
1524                 DWARFASTParser *dwarf_ast = die.GetDWARFParser();
1525                 if (dwarf_ast)
1526                     return dwarf_ast->GetDeclContextContainingUIDFromDWARF(die);
1527             }
1528         }
1529     }
1530     return CompilerDeclContext();
1531 }
1532 
1533 
1534 Type*
1535 SymbolFileDWARF::ResolveTypeUID (lldb::user_id_t type_uid)
1536 {
1537     if (UserIDMatches(type_uid))
1538     {
1539         DWARFDebugInfo* debug_info = DebugInfo();
1540         if (debug_info)
1541         {
1542             DWARFDIE type_die = debug_info->GetDIE (DIERef(type_uid));
1543             if (type_die)
1544             {
1545                 const bool assert_not_being_parsed = true;
1546                 return ResolveTypeUID (type_die, assert_not_being_parsed);
1547             }
1548         }
1549     }
1550     return NULL;
1551 }
1552 
1553 Type*
1554 SymbolFileDWARF::ResolveTypeUID (const DWARFDIE &die, bool assert_not_being_parsed)
1555 {
1556     if (die)
1557     {
1558         Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_DEBUG_INFO));
1559         if (log)
1560             GetObjectFile()->GetModule()->LogMessage (log,
1561                                                       "SymbolFileDWARF::ResolveTypeUID (die = 0x%8.8x) %s '%s'",
1562                                                       die.GetOffset(),
1563                                                       die.GetTagAsCString(),
1564                                                       die.GetName());
1565 
1566         // We might be coming in in the middle of a type tree (a class
1567         // withing a class, an enum within a class), so parse any needed
1568         // parent DIEs before we get to this one...
1569         DWARFDIE decl_ctx_die = GetDeclContextDIEContainingDIE (die);
1570         if (decl_ctx_die)
1571         {
1572             if (log)
1573             {
1574                 switch (decl_ctx_die.Tag())
1575                 {
1576                     case DW_TAG_structure_type:
1577                     case DW_TAG_union_type:
1578                     case DW_TAG_class_type:
1579                     {
1580                         // Get the type, which could be a forward declaration
1581                         if (log)
1582                             GetObjectFile()->GetModule()->LogMessage (log,
1583                                                                       "SymbolFileDWARF::ResolveTypeUID (die = 0x%8.8x) %s '%s' resolve parent forward type for 0x%8.8x",
1584                                                                       die.GetOffset(),
1585                                                                       die.GetTagAsCString(),
1586                                                                       die.GetName(),
1587                                                                       decl_ctx_die.GetOffset());
1588                     }
1589                     break;
1590 
1591                     default:
1592                         break;
1593                 }
1594             }
1595         }
1596         return ResolveType (die);
1597     }
1598     return NULL;
1599 }
1600 
1601 // This function is used when SymbolFileDWARFDebugMap owns a bunch of
1602 // SymbolFileDWARF objects to detect if this DWARF file is the one that
1603 // can resolve a compiler_type.
1604 bool
1605 SymbolFileDWARF::HasForwardDeclForClangType (const CompilerType &compiler_type)
1606 {
1607     CompilerType compiler_type_no_qualifiers = ClangASTContext::RemoveFastQualifiers(compiler_type);
1608     if (GetForwardDeclClangTypeToDie().count (compiler_type_no_qualifiers.GetOpaqueQualType()))
1609     {
1610         return true;
1611     }
1612     TypeSystem *type_system = compiler_type.GetTypeSystem();
1613     if (type_system)
1614     {
1615         DWARFASTParser *dwarf_ast = type_system->GetDWARFParser();
1616         if (dwarf_ast)
1617             return dwarf_ast->CanCompleteType(compiler_type);
1618     }
1619     return false;
1620 }
1621 
1622 
1623 bool
1624 SymbolFileDWARF::CompleteType (CompilerType &compiler_type)
1625 {
1626     lldb_private::Mutex::Locker locker(GetObjectFile()->GetModule()->GetMutex());
1627 
1628     TypeSystem *type_system = compiler_type.GetTypeSystem();
1629     if (type_system)
1630     {
1631         DWARFASTParser *dwarf_ast = type_system->GetDWARFParser();
1632         if (dwarf_ast && dwarf_ast->CanCompleteType(compiler_type))
1633             return dwarf_ast->CompleteType(compiler_type);
1634     }
1635 
1636     // We have a struct/union/class/enum that needs to be fully resolved.
1637     CompilerType compiler_type_no_qualifiers = ClangASTContext::RemoveFastQualifiers(compiler_type);
1638     auto die_it = GetForwardDeclClangTypeToDie().find (compiler_type_no_qualifiers.GetOpaqueQualType());
1639     if (die_it == GetForwardDeclClangTypeToDie().end())
1640     {
1641         // We have already resolved this type...
1642         return true;
1643     }
1644 
1645     DWARFDebugInfo* debug_info = DebugInfo();
1646     DWARFDIE dwarf_die = debug_info->GetDIE(die_it->getSecond());
1647 
1648     assert(UserIDMatches(die_it->getSecond().GetUID()) && "CompleteType called on the wrong SymbolFile");
1649 
1650     // Once we start resolving this type, remove it from the forward declaration
1651     // map in case anyone child members or other types require this type to get resolved.
1652     // The type will get resolved when all of the calls to SymbolFileDWARF::ResolveClangOpaqueTypeDefinition
1653     // are done.
1654     GetForwardDeclClangTypeToDie().erase (die_it);
1655 
1656     Type *type = GetDIEToType().lookup (dwarf_die.GetDIE());
1657 
1658     Log *log (LogChannelDWARF::GetLogIfAny(DWARF_LOG_DEBUG_INFO|DWARF_LOG_TYPE_COMPLETION));
1659     if (log)
1660         GetObjectFile()->GetModule()->LogMessageVerboseBacktrace (log,
1661                                                                   "0x%8.8" PRIx64 ": %s '%s' resolving forward declaration...",
1662                                                                   dwarf_die.GetID(),
1663                                                                   dwarf_die.GetTagAsCString(),
1664                                                                   type->GetName().AsCString());
1665     assert (compiler_type);
1666     DWARFASTParser *dwarf_ast = dwarf_die.GetDWARFParser();
1667     if (dwarf_ast)
1668         return dwarf_ast->CompleteTypeFromDWARF (dwarf_die, type, compiler_type);
1669     return false;
1670 }
1671 
1672 Type*
1673 SymbolFileDWARF::ResolveType (const DWARFDIE &die, bool assert_not_being_parsed, bool resolve_function_context)
1674 {
1675     if (die)
1676     {
1677         Type *type = GetDIEToType().lookup (die.GetDIE());
1678 
1679         if (type == NULL)
1680             type = GetTypeForDIE (die, resolve_function_context).get();
1681 
1682         if (assert_not_being_parsed)
1683         {
1684             if (type != DIE_IS_BEING_PARSED)
1685                 return type;
1686 
1687             GetObjectFile()->GetModule()->ReportError ("Parsing a die that is being parsed die: 0x%8.8x: %s %s",
1688                                                        die.GetOffset(),
1689                                                        die.GetTagAsCString(),
1690                                                        die.GetName());
1691 
1692         }
1693         else
1694             return type;
1695     }
1696     return nullptr;
1697 }
1698 
1699 CompileUnit*
1700 SymbolFileDWARF::GetCompUnitForDWARFCompUnit (DWARFCompileUnit* dwarf_cu, uint32_t cu_idx)
1701 {
1702     // Check if the symbol vendor already knows about this compile unit?
1703     if (dwarf_cu->GetUserData() == NULL)
1704     {
1705         // The symbol vendor doesn't know about this compile unit, we
1706         // need to parse and add it to the symbol vendor object.
1707         return ParseCompileUnit(dwarf_cu, cu_idx).get();
1708     }
1709     return (CompileUnit*)dwarf_cu->GetUserData();
1710 }
1711 
1712 size_t
1713 SymbolFileDWARF::GetObjCMethodDIEOffsets (ConstString class_name, DIEArray &method_die_offsets)
1714 {
1715     method_die_offsets.clear();
1716     if (m_using_apple_tables)
1717     {
1718         if (m_apple_objc_ap.get())
1719             m_apple_objc_ap->FindByName(class_name.GetCString(), method_die_offsets);
1720     }
1721     else
1722     {
1723         if (!m_indexed)
1724             Index ();
1725 
1726         m_objc_class_selectors_index.Find (class_name, method_die_offsets);
1727     }
1728     return method_die_offsets.size();
1729 }
1730 
1731 bool
1732 SymbolFileDWARF::GetFunction (const DWARFDIE &die, SymbolContext& sc)
1733 {
1734     sc.Clear(false);
1735 
1736     if (die)
1737     {
1738         // Check if the symbol vendor already knows about this compile unit?
1739         sc.comp_unit = GetCompUnitForDWARFCompUnit(die.GetCU(), UINT32_MAX);
1740 
1741         sc.function = sc.comp_unit->FindFunctionByUID (die.GetID()).get();
1742         if (sc.function == NULL)
1743             sc.function = ParseCompileUnitFunction(sc, die);
1744 
1745         if (sc.function)
1746         {
1747             sc.module_sp = sc.function->CalculateSymbolContextModule();
1748             return true;
1749         }
1750     }
1751 
1752     return false;
1753 }
1754 
1755 lldb::ModuleSP
1756 SymbolFileDWARF::GetDWOModule (ConstString name)
1757 {
1758     UpdateExternalModuleListIfNeeded();
1759     const auto &pos = m_external_type_modules.find(name);
1760     if (pos != m_external_type_modules.end())
1761         return pos->second;
1762     else
1763         return lldb::ModuleSP();
1764 }
1765 
1766 void
1767 SymbolFileDWARF::UpdateExternalModuleListIfNeeded()
1768 {
1769     if (m_fetched_external_modules)
1770         return;
1771     m_fetched_external_modules = true;
1772 
1773     DWARFDebugInfo * debug_info = DebugInfo();
1774 
1775     const uint32_t num_compile_units = GetNumCompileUnits();
1776     for (uint32_t cu_idx = 0; cu_idx < num_compile_units; ++cu_idx)
1777     {
1778         DWARFCompileUnit* dwarf_cu = debug_info->GetCompileUnitAtIndex(cu_idx);
1779 
1780         const DWARFDIE die = dwarf_cu->GetCompileUnitDIEOnly();
1781         if (die && die.HasChildren() == false)
1782         {
1783             const char *name = die.GetAttributeValueAsString(DW_AT_name, nullptr);
1784 
1785             if (name)
1786             {
1787                 ConstString const_name(name);
1788                 if (m_external_type_modules.find(const_name) == m_external_type_modules.end())
1789                 {
1790                     ModuleSP module_sp;
1791                     const char *dwo_path = die.GetAttributeValueAsString(DW_AT_GNU_dwo_name, nullptr);
1792                     if (dwo_path)
1793                     {
1794                         ModuleSpec dwo_module_spec;
1795                         dwo_module_spec.GetFileSpec().SetFile(dwo_path, false);
1796                         dwo_module_spec.GetArchitecture() = m_obj_file->GetModule()->GetArchitecture();
1797                         //printf ("Loading dwo = '%s'\n", dwo_path);
1798                         Error error = ModuleList::GetSharedModule (dwo_module_spec, module_sp, NULL, NULL, NULL);
1799                     }
1800                     m_external_type_modules[const_name] = module_sp;
1801                 }
1802             }
1803         }
1804     }
1805 }
1806 
1807 SymbolFileDWARF::GlobalVariableMap &
1808 SymbolFileDWARF::GetGlobalAranges()
1809 {
1810     if (!m_global_aranges_ap)
1811     {
1812         m_global_aranges_ap.reset (new GlobalVariableMap());
1813 
1814         ModuleSP module_sp = GetObjectFile()->GetModule();
1815         if (module_sp)
1816         {
1817             const size_t num_cus = module_sp->GetNumCompileUnits();
1818             for (size_t i = 0; i < num_cus; ++i)
1819             {
1820                 CompUnitSP cu_sp = module_sp->GetCompileUnitAtIndex(i);
1821                 if (cu_sp)
1822                 {
1823                     VariableListSP globals_sp = cu_sp->GetVariableList(true);
1824                     if (globals_sp)
1825                     {
1826                         const size_t num_globals = globals_sp->GetSize();
1827                         for (size_t g = 0; g < num_globals; ++g)
1828                         {
1829                             VariableSP var_sp = globals_sp->GetVariableAtIndex(g);
1830                             if (var_sp && !var_sp->GetLocationIsConstantValueData())
1831                             {
1832                                 const DWARFExpression &location = var_sp->LocationExpression();
1833                                 Value location_result;
1834                                 Error error;
1835                                 if (location.Evaluate(NULL, NULL, NULL, LLDB_INVALID_ADDRESS, NULL, location_result, &error))
1836                                 {
1837                                     if (location_result.GetValueType() == Value::eValueTypeFileAddress)
1838                                     {
1839                                         lldb::addr_t file_addr = location_result.GetScalar().ULongLong();
1840                                         lldb::addr_t byte_size = 1;
1841                                         if (var_sp->GetType())
1842                                             byte_size = var_sp->GetType()->GetByteSize();
1843                                         m_global_aranges_ap->Append(GlobalVariableMap::Entry(file_addr, byte_size, var_sp.get()));
1844                                     }
1845                                 }
1846                             }
1847                         }
1848                     }
1849                 }
1850             }
1851         }
1852         m_global_aranges_ap->Sort();
1853     }
1854     return *m_global_aranges_ap;
1855 }
1856 
1857 
1858 uint32_t
1859 SymbolFileDWARF::ResolveSymbolContext (const Address& so_addr, uint32_t resolve_scope, SymbolContext& sc)
1860 {
1861     Timer scoped_timer(__PRETTY_FUNCTION__,
1862                        "SymbolFileDWARF::ResolveSymbolContext (so_addr = { section = %p, offset = 0x%" PRIx64 " }, resolve_scope = 0x%8.8x)",
1863                        static_cast<void*>(so_addr.GetSection().get()),
1864                        so_addr.GetOffset(), resolve_scope);
1865     uint32_t resolved = 0;
1866     if (resolve_scope & (   eSymbolContextCompUnit  |
1867                             eSymbolContextFunction  |
1868                             eSymbolContextBlock     |
1869                             eSymbolContextLineEntry |
1870                             eSymbolContextVariable  ))
1871     {
1872         lldb::addr_t file_vm_addr = so_addr.GetFileAddress();
1873 
1874         DWARFDebugInfo* debug_info = DebugInfo();
1875         if (debug_info)
1876         {
1877             const dw_offset_t cu_offset = debug_info->GetCompileUnitAranges().FindAddress(file_vm_addr);
1878             if (cu_offset == DW_INVALID_OFFSET)
1879             {
1880                 // Global variables are not in the compile unit address ranges. The only way to
1881                 // currently find global variables is to iterate over the .debug_pubnames or the
1882                 // __apple_names table and find all items in there that point to DW_TAG_variable
1883                 // DIEs and then find the address that matches.
1884                 if (resolve_scope & eSymbolContextVariable)
1885                 {
1886                     GlobalVariableMap &map = GetGlobalAranges();
1887                     const GlobalVariableMap::Entry *entry = map.FindEntryThatContains(file_vm_addr);
1888                     if (entry && entry->data)
1889                     {
1890                         Variable *variable = entry->data;
1891                         SymbolContextScope *scc = variable->GetSymbolContextScope();
1892                         if (scc)
1893                         {
1894                             scc->CalculateSymbolContext(&sc);
1895                             sc.variable = variable;
1896                         }
1897                         return sc.GetResolvedMask();
1898                     }
1899                 }
1900             }
1901             else
1902             {
1903                 uint32_t cu_idx = DW_INVALID_INDEX;
1904                 DWARFCompileUnit* dwarf_cu = debug_info->GetCompileUnit(cu_offset, &cu_idx);
1905                 if (dwarf_cu)
1906                 {
1907                     sc.comp_unit = GetCompUnitForDWARFCompUnit(dwarf_cu, cu_idx);
1908                     if (sc.comp_unit)
1909                     {
1910                         resolved |= eSymbolContextCompUnit;
1911 
1912                         bool force_check_line_table = false;
1913                         if (resolve_scope & (eSymbolContextFunction | eSymbolContextBlock))
1914                         {
1915                             DWARFDIE function_die = dwarf_cu->LookupAddress(file_vm_addr);
1916                             DWARFDIE block_die;
1917                             if (function_die)
1918                             {
1919                                 sc.function = sc.comp_unit->FindFunctionByUID (function_die.GetID()).get();
1920                                 if (sc.function == NULL)
1921                                     sc.function = ParseCompileUnitFunction(sc, function_die);
1922 
1923                                 if (sc.function && (resolve_scope & eSymbolContextBlock))
1924                                     block_die = function_die.LookupDeepestBlock(file_vm_addr);
1925                             }
1926                             else
1927                             {
1928                                 // We might have had a compile unit that had discontiguous
1929                                 // address ranges where the gaps are symbols that don't have
1930                                 // any debug info. Discontiguous compile unit address ranges
1931                                 // should only happen when there aren't other functions from
1932                                 // other compile units in these gaps. This helps keep the size
1933                                 // of the aranges down.
1934                                 force_check_line_table = true;
1935                             }
1936 
1937                             if (sc.function != NULL)
1938                             {
1939                                 resolved |= eSymbolContextFunction;
1940 
1941                                 if (resolve_scope & eSymbolContextBlock)
1942                                 {
1943                                     Block& block = sc.function->GetBlock (true);
1944 
1945                                     if (block_die)
1946                                         sc.block = block.FindBlockByID (block_die.GetID());
1947                                     else
1948                                         sc.block = block.FindBlockByID (function_die.GetID());
1949                                     if (sc.block)
1950                                         resolved |= eSymbolContextBlock;
1951                                 }
1952                             }
1953                         }
1954 
1955                         if ((resolve_scope & eSymbolContextLineEntry) || force_check_line_table)
1956                         {
1957                             LineTable *line_table = sc.comp_unit->GetLineTable();
1958                             if (line_table != NULL)
1959                             {
1960                                 // And address that makes it into this function should be in terms
1961                                 // of this debug file if there is no debug map, or it will be an
1962                                 // address in the .o file which needs to be fixed up to be in terms
1963                                 // of the debug map executable. Either way, calling FixupAddress()
1964                                 // will work for us.
1965                                 Address exe_so_addr (so_addr);
1966                                 if (FixupAddress(exe_so_addr))
1967                                 {
1968                                     if (line_table->FindLineEntryByAddress (exe_so_addr, sc.line_entry))
1969                                     {
1970                                         resolved |= eSymbolContextLineEntry;
1971                                     }
1972                                 }
1973                             }
1974                         }
1975 
1976                         if (force_check_line_table && !(resolved & eSymbolContextLineEntry))
1977                         {
1978                             // We might have had a compile unit that had discontiguous
1979                             // address ranges where the gaps are symbols that don't have
1980                             // any debug info. Discontiguous compile unit address ranges
1981                             // should only happen when there aren't other functions from
1982                             // other compile units in these gaps. This helps keep the size
1983                             // of the aranges down.
1984                             sc.comp_unit = NULL;
1985                             resolved &= ~eSymbolContextCompUnit;
1986                         }
1987                     }
1988                     else
1989                     {
1990                         GetObjectFile()->GetModule()->ReportWarning ("0x%8.8x: compile unit %u failed to create a valid lldb_private::CompileUnit class.",
1991                                                                      cu_offset,
1992                                                                      cu_idx);
1993                     }
1994                 }
1995             }
1996         }
1997     }
1998     return resolved;
1999 }
2000 
2001 
2002 
2003 uint32_t
2004 SymbolFileDWARF::ResolveSymbolContext(const FileSpec& file_spec, uint32_t line, bool check_inlines, uint32_t resolve_scope, SymbolContextList& sc_list)
2005 {
2006     const uint32_t prev_size = sc_list.GetSize();
2007     if (resolve_scope & eSymbolContextCompUnit)
2008     {
2009         DWARFDebugInfo* debug_info = DebugInfo();
2010         if (debug_info)
2011         {
2012             uint32_t cu_idx;
2013             DWARFCompileUnit* dwarf_cu = NULL;
2014 
2015             for (cu_idx = 0; (dwarf_cu = debug_info->GetCompileUnitAtIndex(cu_idx)) != NULL; ++cu_idx)
2016             {
2017                 CompileUnit *dc_cu = GetCompUnitForDWARFCompUnit(dwarf_cu, cu_idx);
2018                 const bool full_match = (bool)file_spec.GetDirectory();
2019                 bool file_spec_matches_cu_file_spec = dc_cu != NULL && FileSpec::Equal(file_spec, *dc_cu, full_match);
2020                 if (check_inlines || file_spec_matches_cu_file_spec)
2021                 {
2022                     SymbolContext sc (m_obj_file->GetModule());
2023                     sc.comp_unit = GetCompUnitForDWARFCompUnit(dwarf_cu, cu_idx);
2024                     if (sc.comp_unit)
2025                     {
2026                         uint32_t file_idx = UINT32_MAX;
2027 
2028                         // If we are looking for inline functions only and we don't
2029                         // find it in the support files, we are done.
2030                         if (check_inlines)
2031                         {
2032                             file_idx = sc.comp_unit->GetSupportFiles().FindFileIndex (1, file_spec, true);
2033                             if (file_idx == UINT32_MAX)
2034                                 continue;
2035                         }
2036 
2037                         if (line != 0)
2038                         {
2039                             LineTable *line_table = sc.comp_unit->GetLineTable();
2040 
2041                             if (line_table != NULL && line != 0)
2042                             {
2043                                 // We will have already looked up the file index if
2044                                 // we are searching for inline entries.
2045                                 if (!check_inlines)
2046                                     file_idx = sc.comp_unit->GetSupportFiles().FindFileIndex (1, file_spec, true);
2047 
2048                                 if (file_idx != UINT32_MAX)
2049                                 {
2050                                     uint32_t found_line;
2051                                     uint32_t line_idx = line_table->FindLineEntryIndexByFileIndex (0, file_idx, line, false, &sc.line_entry);
2052                                     found_line = sc.line_entry.line;
2053 
2054                                     while (line_idx != UINT32_MAX)
2055                                     {
2056                                         sc.function = NULL;
2057                                         sc.block = NULL;
2058                                         if (resolve_scope & (eSymbolContextFunction | eSymbolContextBlock))
2059                                         {
2060                                             const lldb::addr_t file_vm_addr = sc.line_entry.range.GetBaseAddress().GetFileAddress();
2061                                             if (file_vm_addr != LLDB_INVALID_ADDRESS)
2062                                             {
2063                                                 DWARFDIE function_die = dwarf_cu->LookupAddress(file_vm_addr);
2064                                                 DWARFDIE block_die;
2065                                                 if (function_die)
2066                                                 {
2067                                                     sc.function = sc.comp_unit->FindFunctionByUID (function_die.GetID()).get();
2068                                                     if (sc.function == NULL)
2069                                                         sc.function = ParseCompileUnitFunction(sc, function_die);
2070 
2071                                                     if (sc.function && (resolve_scope & eSymbolContextBlock))
2072                                                         block_die = function_die.LookupDeepestBlock(file_vm_addr);
2073                                                 }
2074 
2075                                                 if (sc.function != NULL)
2076                                                 {
2077                                                     Block& block = sc.function->GetBlock (true);
2078 
2079                                                     if (block_die)
2080                                                         sc.block = block.FindBlockByID (block_die.GetID());
2081                                                     else if (function_die)
2082                                                         sc.block = block.FindBlockByID (function_die.GetID());
2083                                                 }
2084                                             }
2085                                         }
2086 
2087                                         sc_list.Append(sc);
2088                                         line_idx = line_table->FindLineEntryIndexByFileIndex (line_idx + 1, file_idx, found_line, true, &sc.line_entry);
2089                                     }
2090                                 }
2091                             }
2092                             else if (file_spec_matches_cu_file_spec && !check_inlines)
2093                             {
2094                                 // only append the context if we aren't looking for inline call sites
2095                                 // by file and line and if the file spec matches that of the compile unit
2096                                 sc_list.Append(sc);
2097                             }
2098                         }
2099                         else if (file_spec_matches_cu_file_spec && !check_inlines)
2100                         {
2101                             // only append the context if we aren't looking for inline call sites
2102                             // by file and line and if the file spec matches that of the compile unit
2103                             sc_list.Append(sc);
2104                         }
2105 
2106                         if (!check_inlines)
2107                             break;
2108                     }
2109                 }
2110             }
2111         }
2112     }
2113     return sc_list.GetSize() - prev_size;
2114 }
2115 
2116 void
2117 SymbolFileDWARF::Index ()
2118 {
2119     if (m_indexed)
2120         return;
2121     m_indexed = true;
2122     Timer scoped_timer (__PRETTY_FUNCTION__,
2123                         "SymbolFileDWARF::Index (%s)",
2124                         GetObjectFile()->GetFileSpec().GetFilename().AsCString("<Unknown>"));
2125 
2126     DWARFDebugInfo* debug_info = DebugInfo();
2127     if (debug_info)
2128     {
2129         const uint32_t num_compile_units = GetNumCompileUnits();
2130         std::vector<NameToDIE> function_basename_index(num_compile_units);
2131         std::vector<NameToDIE> function_fullname_index(num_compile_units);
2132         std::vector<NameToDIE> function_method_index(num_compile_units);
2133         std::vector<NameToDIE> function_selector_index(num_compile_units);
2134         std::vector<NameToDIE> objc_class_selectors_index(num_compile_units);
2135         std::vector<NameToDIE> global_index(num_compile_units);
2136         std::vector<NameToDIE> type_index(num_compile_units);
2137         std::vector<NameToDIE> namespace_index(num_compile_units);
2138 
2139         auto parser_fn = [this,
2140                           debug_info,
2141                           &function_basename_index,
2142                           &function_fullname_index,
2143                           &function_method_index,
2144                           &function_selector_index,
2145                           &objc_class_selectors_index,
2146                           &global_index,
2147                           &type_index,
2148                           &namespace_index](uint32_t cu_idx)
2149         {
2150             DWARFCompileUnit* dwarf_cu = debug_info->GetCompileUnitAtIndex(cu_idx);
2151             bool clear_dies = dwarf_cu->ExtractDIEsIfNeeded(false) > 1;
2152 
2153             dwarf_cu->Index(function_basename_index[cu_idx],
2154                             function_fullname_index[cu_idx],
2155                             function_method_index[cu_idx],
2156                             function_selector_index[cu_idx],
2157                             objc_class_selectors_index[cu_idx],
2158                             global_index[cu_idx],
2159                             type_index[cu_idx],
2160                             namespace_index[cu_idx]);
2161 
2162             // Keep memory down by clearing DIEs if this generate function
2163             // caused them to be parsed
2164             if (clear_dies)
2165                 dwarf_cu->ClearDIEs(true);
2166 
2167             return cu_idx;
2168         };
2169 
2170         TaskRunner<uint32_t> task_runner;
2171         for (uint32_t cu_idx = 0; cu_idx < num_compile_units; ++cu_idx)
2172             task_runner.AddTask(parser_fn, cu_idx);
2173 
2174         while (true)
2175         {
2176             std::future<uint32_t> f = task_runner.WaitForNextCompletedTask();
2177             if (!f.valid())
2178                 break;
2179             uint32_t cu_idx = f.get();
2180 
2181             m_function_basename_index.Append(function_basename_index[cu_idx]);
2182             m_function_fullname_index.Append(function_fullname_index[cu_idx]);
2183             m_function_method_index.Append(function_method_index[cu_idx]);
2184             m_function_selector_index.Append(function_selector_index[cu_idx]);
2185             m_objc_class_selectors_index.Append(objc_class_selectors_index[cu_idx]);
2186             m_global_index.Append(global_index[cu_idx]);
2187             m_type_index.Append(type_index[cu_idx]);
2188             m_namespace_index.Append(namespace_index[cu_idx]);
2189         }
2190 
2191         TaskPool::RunTasks(
2192             [&]() { m_function_basename_index.Finalize(); },
2193             [&]() { m_function_fullname_index.Finalize(); },
2194             [&]() { m_function_method_index.Finalize(); },
2195             [&]() { m_function_selector_index.Finalize(); },
2196             [&]() { m_objc_class_selectors_index.Finalize(); },
2197             [&]() { m_global_index.Finalize(); },
2198             [&]() { m_type_index.Finalize(); },
2199             [&]() { m_namespace_index.Finalize(); });
2200 
2201 #if defined (ENABLE_DEBUG_PRINTF)
2202         StreamFile s(stdout, false);
2203         s.Printf ("DWARF index for '%s':",
2204                   GetObjectFile()->GetFileSpec().GetPath().c_str());
2205         s.Printf("\nFunction basenames:\n");    m_function_basename_index.Dump (&s);
2206         s.Printf("\nFunction fullnames:\n");    m_function_fullname_index.Dump (&s);
2207         s.Printf("\nFunction methods:\n");      m_function_method_index.Dump (&s);
2208         s.Printf("\nFunction selectors:\n");    m_function_selector_index.Dump (&s);
2209         s.Printf("\nObjective C class selectors:\n");    m_objc_class_selectors_index.Dump (&s);
2210         s.Printf("\nGlobals and statics:\n");   m_global_index.Dump (&s);
2211         s.Printf("\nTypes:\n");                 m_type_index.Dump (&s);
2212         s.Printf("\nNamespaces:\n")             m_namespace_index.Dump (&s);
2213 #endif
2214     }
2215 }
2216 
2217 bool
2218 SymbolFileDWARF::DeclContextMatchesThisSymbolFile (const lldb_private::CompilerDeclContext *decl_ctx)
2219 {
2220     if (decl_ctx == nullptr || !decl_ctx->IsValid())
2221     {
2222         // Invalid namespace decl which means we aren't matching only things
2223         // in this symbol file, so return true to indicate it matches this
2224         // symbol file.
2225         return true;
2226     }
2227 
2228     TypeSystem *decl_ctx_type_system = decl_ctx->GetTypeSystem();
2229     TypeSystem *type_system = GetTypeSystemForLanguage(decl_ctx_type_system->GetMinimumLanguage(nullptr));
2230     if (decl_ctx_type_system == type_system)
2231         return true;    // The type systems match, return true
2232 
2233     // The namespace AST was valid, and it does not match...
2234     Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_LOOKUPS));
2235 
2236     if (log)
2237         GetObjectFile()->GetModule()->LogMessage(log, "Valid namespace does not match symbol file");
2238 
2239     return false;
2240 }
2241 
2242 uint32_t
2243 SymbolFileDWARF::FindGlobalVariables (const ConstString &name, const CompilerDeclContext *parent_decl_ctx, bool append, uint32_t max_matches, VariableList& variables)
2244 {
2245     Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_LOOKUPS));
2246 
2247     if (log)
2248         GetObjectFile()->GetModule()->LogMessage (log,
2249                                                   "SymbolFileDWARF::FindGlobalVariables (name=\"%s\", parent_decl_ctx=%p, append=%u, max_matches=%u, variables)",
2250                                                   name.GetCString(),
2251                                                   static_cast<const void*>(parent_decl_ctx),
2252                                                   append, max_matches);
2253 
2254     if (!DeclContextMatchesThisSymbolFile(parent_decl_ctx))
2255         return 0;
2256 
2257     DWARFDebugInfo* info = DebugInfo();
2258     if (info == NULL)
2259         return 0;
2260 
2261     // If we aren't appending the results to this list, then clear the list
2262     if (!append)
2263         variables.Clear();
2264 
2265     // Remember how many variables are in the list before we search in case
2266     // we are appending the results to a variable list.
2267     const uint32_t original_size = variables.GetSize();
2268 
2269     DIEArray die_offsets;
2270 
2271     if (m_using_apple_tables)
2272     {
2273         if (m_apple_names_ap.get())
2274         {
2275             const char *name_cstr = name.GetCString();
2276             llvm::StringRef basename;
2277             llvm::StringRef context;
2278 
2279             if (!CPlusPlusLanguage::ExtractContextAndIdentifier(name_cstr, context, basename))
2280                 basename = name_cstr;
2281 
2282             m_apple_names_ap->FindByName (basename.data(), die_offsets);
2283         }
2284     }
2285     else
2286     {
2287         // Index the DWARF if we haven't already
2288         if (!m_indexed)
2289             Index ();
2290 
2291         m_global_index.Find (name, die_offsets);
2292     }
2293 
2294     const size_t num_die_matches = die_offsets.size();
2295     if (num_die_matches)
2296     {
2297         SymbolContext sc;
2298         sc.module_sp = m_obj_file->GetModule();
2299         assert (sc.module_sp);
2300 
2301         DWARFDebugInfo* debug_info = DebugInfo();
2302         bool done = false;
2303         for (size_t i=0; i<num_die_matches && !done; ++i)
2304         {
2305             const DIERef& die_ref = die_offsets[i];
2306             DWARFDIE die = debug_info->GetDIE (die_ref);
2307 
2308             if (die)
2309             {
2310                 switch (die.Tag())
2311                 {
2312                     default:
2313                     case DW_TAG_subprogram:
2314                     case DW_TAG_inlined_subroutine:
2315                     case DW_TAG_try_block:
2316                     case DW_TAG_catch_block:
2317                         break;
2318 
2319                     case DW_TAG_variable:
2320                         {
2321                             sc.comp_unit = GetCompUnitForDWARFCompUnit(die.GetCU(), UINT32_MAX);
2322 
2323                             if (parent_decl_ctx)
2324                             {
2325                                 DWARFASTParser *dwarf_ast = die.GetDWARFParser();
2326                                 if (dwarf_ast)
2327                                 {
2328                                     CompilerDeclContext actual_parent_decl_ctx = dwarf_ast->GetDeclContextContainingUIDFromDWARF (die);
2329                                     if (!actual_parent_decl_ctx || actual_parent_decl_ctx != *parent_decl_ctx)
2330                                         continue;
2331                                 }
2332                             }
2333 
2334                             ParseVariables(sc, die, LLDB_INVALID_ADDRESS, false, false, &variables);
2335 
2336                             if (variables.GetSize() - original_size >= max_matches)
2337                                 done = true;
2338                         }
2339                         break;
2340                 }
2341             }
2342             else
2343             {
2344                 if (m_using_apple_tables)
2345                 {
2346                     GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_names accelerator table had bad die 0x%8.8x for '%s')\n",
2347                                                                                die_ref.die_offset, name.GetCString());
2348                 }
2349             }
2350         }
2351     }
2352 
2353     // Return the number of variable that were appended to the list
2354     const uint32_t num_matches = variables.GetSize() - original_size;
2355     if (log && num_matches > 0)
2356     {
2357         GetObjectFile()->GetModule()->LogMessage (log,
2358                                                   "SymbolFileDWARF::FindGlobalVariables (name=\"%s\", parent_decl_ctx=%p, append=%u, max_matches=%u, variables) => %u",
2359                                                   name.GetCString(),
2360                                                   static_cast<const void*>(parent_decl_ctx),
2361                                                   append, max_matches,
2362                                                   num_matches);
2363     }
2364     return num_matches;
2365 }
2366 
2367 uint32_t
2368 SymbolFileDWARF::FindGlobalVariables(const RegularExpression& regex, bool append, uint32_t max_matches, VariableList& variables)
2369 {
2370     Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_LOOKUPS));
2371 
2372     if (log)
2373     {
2374         GetObjectFile()->GetModule()->LogMessage (log,
2375                                                   "SymbolFileDWARF::FindGlobalVariables (regex=\"%s\", append=%u, max_matches=%u, variables)",
2376                                                   regex.GetText(), append,
2377                                                   max_matches);
2378     }
2379 
2380     DWARFDebugInfo* info = DebugInfo();
2381     if (info == NULL)
2382         return 0;
2383 
2384     // If we aren't appending the results to this list, then clear the list
2385     if (!append)
2386         variables.Clear();
2387 
2388     // Remember how many variables are in the list before we search in case
2389     // we are appending the results to a variable list.
2390     const uint32_t original_size = variables.GetSize();
2391 
2392     DIEArray die_offsets;
2393 
2394     if (m_using_apple_tables)
2395     {
2396         if (m_apple_names_ap.get())
2397         {
2398             DWARFMappedHash::DIEInfoArray hash_data_array;
2399             if (m_apple_names_ap->AppendAllDIEsThatMatchingRegex (regex, hash_data_array))
2400                 DWARFMappedHash::ExtractDIEArray (hash_data_array, die_offsets);
2401         }
2402     }
2403     else
2404     {
2405         // Index the DWARF if we haven't already
2406         if (!m_indexed)
2407             Index ();
2408 
2409         m_global_index.Find (regex, die_offsets);
2410     }
2411 
2412     SymbolContext sc;
2413     sc.module_sp = m_obj_file->GetModule();
2414     assert (sc.module_sp);
2415 
2416     const size_t num_matches = die_offsets.size();
2417     if (num_matches)
2418     {
2419         DWARFDebugInfo* debug_info = DebugInfo();
2420         for (size_t i=0; i<num_matches; ++i)
2421         {
2422             const DIERef& die_ref = die_offsets[i];
2423             DWARFDIE die = debug_info->GetDIE (die_ref);
2424 
2425             if (die)
2426             {
2427                 sc.comp_unit = GetCompUnitForDWARFCompUnit(die.GetCU(), UINT32_MAX);
2428 
2429                 ParseVariables(sc, die, LLDB_INVALID_ADDRESS, false, false, &variables);
2430 
2431                 if (variables.GetSize() - original_size >= max_matches)
2432                     break;
2433             }
2434             else
2435             {
2436                 if (m_using_apple_tables)
2437                 {
2438                     GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_names accelerator table had bad die 0x%8.8x for regex '%s')\n",
2439                                                                                die_ref.die_offset, regex.GetText());
2440                 }
2441             }
2442         }
2443     }
2444 
2445     // Return the number of variable that were appended to the list
2446     return variables.GetSize() - original_size;
2447 }
2448 
2449 
2450 bool
2451 SymbolFileDWARF::ResolveFunction (const DIERef& die_ref,
2452                                   bool include_inlines,
2453                                   SymbolContextList& sc_list)
2454 {
2455     DWARFDIE die = DebugInfo()->GetDIE (die_ref);
2456     return ResolveFunction (die, include_inlines, sc_list);
2457 }
2458 
2459 
2460 bool
2461 SymbolFileDWARF::ResolveFunction (const DWARFDIE &orig_die,
2462                                   bool include_inlines,
2463                                   SymbolContextList& sc_list)
2464 {
2465     SymbolContext sc;
2466 
2467     if (!orig_die)
2468         return false;
2469 
2470     // If we were passed a die that is not a function, just return false...
2471     if (!(orig_die.Tag() == DW_TAG_subprogram || (include_inlines && orig_die.Tag() == DW_TAG_inlined_subroutine)))
2472         return false;
2473 
2474     DWARFDIE die = orig_die;
2475     DWARFDIE inlined_die;
2476     if (die.Tag() == DW_TAG_inlined_subroutine)
2477     {
2478         inlined_die = die;
2479 
2480         while (1)
2481         {
2482             die = die.GetParent();
2483 
2484             if (die)
2485             {
2486                 if (die.Tag() == DW_TAG_subprogram)
2487                     break;
2488             }
2489             else
2490                 break;
2491         }
2492     }
2493     assert (die && die.Tag() == DW_TAG_subprogram);
2494     if (GetFunction (die, sc))
2495     {
2496         Address addr;
2497         // Parse all blocks if needed
2498         if (inlined_die)
2499         {
2500             Block &function_block = sc.function->GetBlock (true);
2501             sc.block = function_block.FindBlockByID (inlined_die.GetID());
2502             if (sc.block == NULL)
2503                 sc.block = function_block.FindBlockByID (inlined_die.GetOffset());
2504             if (sc.block == NULL || sc.block->GetStartAddress (addr) == false)
2505                 addr.Clear();
2506         }
2507         else
2508         {
2509             sc.block = NULL;
2510             addr = sc.function->GetAddressRange().GetBaseAddress();
2511         }
2512 
2513         if (addr.IsValid())
2514         {
2515             sc_list.Append(sc);
2516             return true;
2517         }
2518     }
2519 
2520     return false;
2521 }
2522 
2523 void
2524 SymbolFileDWARF::FindFunctions (const ConstString &name,
2525                                 const NameToDIE &name_to_die,
2526                                 bool include_inlines,
2527                                 SymbolContextList& sc_list)
2528 {
2529     DIEArray die_offsets;
2530     if (name_to_die.Find (name, die_offsets))
2531     {
2532         ParseFunctions (die_offsets, include_inlines, sc_list);
2533     }
2534 }
2535 
2536 
2537 void
2538 SymbolFileDWARF::FindFunctions (const RegularExpression &regex,
2539                                 const NameToDIE &name_to_die,
2540                                 bool include_inlines,
2541                                 SymbolContextList& sc_list)
2542 {
2543     DIEArray die_offsets;
2544     if (name_to_die.Find (regex, die_offsets))
2545     {
2546         ParseFunctions (die_offsets, include_inlines, sc_list);
2547     }
2548 }
2549 
2550 
2551 void
2552 SymbolFileDWARF::FindFunctions (const RegularExpression &regex,
2553                                 const DWARFMappedHash::MemoryTable &memory_table,
2554                                 bool include_inlines,
2555                                 SymbolContextList& sc_list)
2556 {
2557     DIEArray die_offsets;
2558     DWARFMappedHash::DIEInfoArray hash_data_array;
2559     if (memory_table.AppendAllDIEsThatMatchingRegex (regex, hash_data_array))
2560     {
2561         DWARFMappedHash::ExtractDIEArray (hash_data_array, die_offsets);
2562         ParseFunctions (die_offsets, include_inlines, sc_list);
2563     }
2564 }
2565 
2566 void
2567 SymbolFileDWARF::ParseFunctions (const DIEArray &die_offsets,
2568                                  bool include_inlines,
2569                                  SymbolContextList& sc_list)
2570 {
2571     const size_t num_matches = die_offsets.size();
2572     if (num_matches)
2573     {
2574         for (size_t i=0; i<num_matches; ++i)
2575             ResolveFunction (die_offsets[i], include_inlines, sc_list);
2576     }
2577 }
2578 
2579 bool
2580 SymbolFileDWARF::DIEInDeclContext (const CompilerDeclContext *decl_ctx,
2581                                    const DWARFDIE &die)
2582 {
2583     // If we have no parent decl context to match this DIE matches, and if the parent
2584     // decl context isn't valid, we aren't trying to look for any particular decl
2585     // context so any die matches.
2586     if (decl_ctx == nullptr || !decl_ctx->IsValid())
2587         return true;
2588 
2589     if (die)
2590     {
2591         DWARFASTParser *dwarf_ast = die.GetDWARFParser();
2592         if (dwarf_ast)
2593         {
2594             CompilerDeclContext actual_decl_ctx = dwarf_ast->GetDeclContextContainingUIDFromDWARF (die);
2595             if (actual_decl_ctx)
2596                 return actual_decl_ctx == *decl_ctx;
2597         }
2598     }
2599     return false;
2600 }
2601 
2602 uint32_t
2603 SymbolFileDWARF::FindFunctions (const ConstString &name,
2604                                 const CompilerDeclContext *parent_decl_ctx,
2605                                 uint32_t name_type_mask,
2606                                 bool include_inlines,
2607                                 bool append,
2608                                 SymbolContextList& sc_list)
2609 {
2610     Timer scoped_timer (__PRETTY_FUNCTION__,
2611                         "SymbolFileDWARF::FindFunctions (name = '%s')",
2612                         name.AsCString());
2613 
2614     // eFunctionNameTypeAuto should be pre-resolved by a call to Module::PrepareForFunctionNameLookup()
2615     assert ((name_type_mask & eFunctionNameTypeAuto) == 0);
2616 
2617     Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_LOOKUPS));
2618 
2619     if (log)
2620     {
2621         GetObjectFile()->GetModule()->LogMessage (log,
2622                                                   "SymbolFileDWARF::FindFunctions (name=\"%s\", name_type_mask=0x%x, append=%u, sc_list)",
2623                                                   name.GetCString(),
2624                                                   name_type_mask,
2625                                                   append);
2626     }
2627 
2628     // If we aren't appending the results to this list, then clear the list
2629     if (!append)
2630         sc_list.Clear();
2631 
2632     if (!DeclContextMatchesThisSymbolFile(parent_decl_ctx))
2633         return 0;
2634 
2635     // If name is empty then we won't find anything.
2636     if (name.IsEmpty())
2637         return 0;
2638 
2639     // Remember how many sc_list are in the list before we search in case
2640     // we are appending the results to a variable list.
2641 
2642     const char *name_cstr = name.GetCString();
2643 
2644     const uint32_t original_size = sc_list.GetSize();
2645 
2646     DWARFDebugInfo* info = DebugInfo();
2647     if (info == NULL)
2648         return 0;
2649 
2650     std::set<const DWARFDebugInfoEntry *> resolved_dies;
2651     if (m_using_apple_tables)
2652     {
2653         if (m_apple_names_ap.get())
2654         {
2655 
2656             DIEArray die_offsets;
2657 
2658             uint32_t num_matches = 0;
2659 
2660             if (name_type_mask & eFunctionNameTypeFull)
2661             {
2662                 // If they asked for the full name, match what they typed.  At some point we may
2663                 // want to canonicalize this (strip double spaces, etc.  For now, we just add all the
2664                 // dies that we find by exact match.
2665                 num_matches = m_apple_names_ap->FindByName (name_cstr, die_offsets);
2666                 for (uint32_t i = 0; i < num_matches; i++)
2667                 {
2668                     const DIERef& die_ref = die_offsets[i];
2669                     DWARFDIE die = info->GetDIE (die_ref);
2670                     if (die)
2671                     {
2672                         if (!DIEInDeclContext(parent_decl_ctx, die))
2673                             continue; // The containing decl contexts don't match
2674 
2675                         if (resolved_dies.find(die.GetDIE()) == resolved_dies.end())
2676                         {
2677                             if (ResolveFunction (die, include_inlines, sc_list))
2678                                 resolved_dies.insert(die.GetDIE());
2679                         }
2680                     }
2681                     else
2682                     {
2683                         GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_names accelerator table had bad die 0x%8.8x for '%s')",
2684                                                                                    die_ref.die_offset, name_cstr);
2685                     }
2686                 }
2687             }
2688 
2689             if (name_type_mask & eFunctionNameTypeSelector)
2690             {
2691                 if (parent_decl_ctx && parent_decl_ctx->IsValid())
2692                     return 0; // no selectors in namespaces
2693 
2694                 num_matches = m_apple_names_ap->FindByName (name_cstr, die_offsets);
2695                 // Now make sure these are actually ObjC methods.  In this case we can simply look up the name,
2696                 // and if it is an ObjC method name, we're good.
2697 
2698                 for (uint32_t i = 0; i < num_matches; i++)
2699                 {
2700                     const DIERef& die_ref = die_offsets[i];
2701                     DWARFDIE die = info->GetDIE (die_ref);
2702                     if (die)
2703                     {
2704                         const char *die_name = die.GetName();
2705                         if (ObjCLanguage::IsPossibleObjCMethodName(die_name))
2706                         {
2707                             if (resolved_dies.find(die.GetDIE()) == resolved_dies.end())
2708                             {
2709                                 if (ResolveFunction (die, include_inlines, sc_list))
2710                                     resolved_dies.insert(die.GetDIE());
2711                             }
2712                         }
2713                     }
2714                     else
2715                     {
2716                         GetObjectFile()->GetModule()->ReportError ("the DWARF debug information has been modified (.apple_names accelerator table had bad die 0x%8.8x for '%s')",
2717                                                                    die_ref.die_offset, name_cstr);
2718                     }
2719                 }
2720                 die_offsets.clear();
2721             }
2722 
2723             if (((name_type_mask & eFunctionNameTypeMethod) && !parent_decl_ctx) || name_type_mask & eFunctionNameTypeBase)
2724             {
2725                 // The apple_names table stores just the "base name" of C++ methods in the table.  So we have to
2726                 // extract the base name, look that up, and if there is any other information in the name we were
2727                 // passed in we have to post-filter based on that.
2728 
2729                 // FIXME: Arrange the logic above so that we don't calculate the base name twice:
2730                 num_matches = m_apple_names_ap->FindByName (name_cstr, die_offsets);
2731 
2732                 for (uint32_t i = 0; i < num_matches; i++)
2733                 {
2734                     const DIERef& die_ref = die_offsets[i];
2735                     DWARFDIE die = info->GetDIE (die_ref);
2736                     if (die)
2737                     {
2738                         if (!DIEInDeclContext(parent_decl_ctx, die))
2739                             continue; // The containing decl contexts don't match
2740 
2741 
2742                         // If we get to here, the die is good, and we should add it:
2743                         if (resolved_dies.find(die.GetDIE()) == resolved_dies.end() && ResolveFunction (die, include_inlines, sc_list))
2744                         {
2745                             bool keep_die = true;
2746                             if ((name_type_mask & (eFunctionNameTypeBase|eFunctionNameTypeMethod)) != (eFunctionNameTypeBase|eFunctionNameTypeMethod))
2747                             {
2748                                 // We are looking for either basenames or methods, so we need to
2749                                 // trim out the ones we won't want by looking at the type
2750                                 SymbolContext sc;
2751                                 if (sc_list.GetLastContext(sc))
2752                                 {
2753                                     if (sc.block)
2754                                     {
2755                                         // We have an inlined function
2756                                     }
2757                                     else if (sc.function)
2758                                     {
2759                                         Type *type = sc.function->GetType();
2760 
2761                                         if (type)
2762                                         {
2763                                             CompilerDeclContext decl_ctx = GetDeclContextContainingUID (type->GetID());
2764                                             if (decl_ctx.IsStructUnionOrClass())
2765                                             {
2766                                                 if (name_type_mask & eFunctionNameTypeBase)
2767                                                 {
2768                                                     sc_list.RemoveContextAtIndex(sc_list.GetSize()-1);
2769                                                     keep_die = false;
2770                                                 }
2771                                             }
2772                                             else
2773                                             {
2774                                                 if (name_type_mask & eFunctionNameTypeMethod)
2775                                                 {
2776                                                     sc_list.RemoveContextAtIndex(sc_list.GetSize()-1);
2777                                                     keep_die = false;
2778                                                 }
2779                                             }
2780                                         }
2781                                         else
2782                                         {
2783                                             GetObjectFile()->GetModule()->ReportWarning ("function at die offset 0x%8.8x had no function type",
2784                                                                                          die_ref.die_offset);
2785                                         }
2786                                     }
2787                                 }
2788                             }
2789                             if (keep_die)
2790                                 resolved_dies.insert(die.GetDIE());
2791                         }
2792                     }
2793                     else
2794                     {
2795                         GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_names accelerator table had bad die 0x%8.8x for '%s')",
2796                                                                                    die_ref.die_offset, name_cstr);
2797                     }
2798                 }
2799                 die_offsets.clear();
2800             }
2801         }
2802     }
2803     else
2804     {
2805 
2806         // Index the DWARF if we haven't already
2807         if (!m_indexed)
2808             Index ();
2809 
2810         if (name_type_mask & eFunctionNameTypeFull)
2811         {
2812             FindFunctions (name, m_function_fullname_index, include_inlines, sc_list);
2813 
2814             // FIXME Temporary workaround for global/anonymous namespace
2815             // functions debugging FreeBSD and Linux binaries.
2816             // If we didn't find any functions in the global namespace try
2817             // looking in the basename index but ignore any returned
2818             // functions that have a namespace but keep functions which
2819             // have an anonymous namespace
2820             // TODO: The arch in the object file isn't correct for MSVC
2821             // binaries on windows, we should find a way to make it
2822             // correct and handle those symbols as well.
2823             if (sc_list.GetSize() == original_size)
2824             {
2825                 ArchSpec arch;
2826                 if (!parent_decl_ctx &&
2827                     GetObjectFile()->GetArchitecture(arch) &&
2828                     (arch.GetTriple().isOSFreeBSD() || arch.GetTriple().isOSLinux() ||
2829                      arch.GetMachine() == llvm::Triple::hexagon))
2830                 {
2831                     SymbolContextList temp_sc_list;
2832                     FindFunctions (name, m_function_basename_index, include_inlines, temp_sc_list);
2833                     SymbolContext sc;
2834                     for (uint32_t i = 0; i < temp_sc_list.GetSize(); i++)
2835                     {
2836                         if (temp_sc_list.GetContextAtIndex(i, sc))
2837                         {
2838                             ConstString mangled_name = sc.GetFunctionName(Mangled::ePreferMangled);
2839                             ConstString demangled_name = sc.GetFunctionName(Mangled::ePreferDemangled);
2840                             // Mangled names on Linux and FreeBSD are of the form:
2841                             // _ZN18function_namespace13function_nameEv.
2842                             if (strncmp(mangled_name.GetCString(), "_ZN", 3) ||
2843                                 !strncmp(demangled_name.GetCString(), "(anonymous namespace)", 21))
2844                             {
2845                                 sc_list.Append(sc);
2846                             }
2847                         }
2848                     }
2849                 }
2850             }
2851         }
2852         DIEArray die_offsets;
2853         if (name_type_mask & eFunctionNameTypeBase)
2854         {
2855             uint32_t num_base = m_function_basename_index.Find(name, die_offsets);
2856             for (uint32_t i = 0; i < num_base; i++)
2857             {
2858                 DWARFDIE die = info->GetDIE (die_offsets[i]);
2859                 if (die)
2860                 {
2861                     if (!DIEInDeclContext(parent_decl_ctx, die))
2862                         continue; // The containing decl contexts don't match
2863 
2864                     // If we get to here, the die is good, and we should add it:
2865                     if (resolved_dies.find(die.GetDIE()) == resolved_dies.end())
2866                     {
2867                         if (ResolveFunction (die, include_inlines, sc_list))
2868                             resolved_dies.insert(die.GetDIE());
2869                     }
2870                 }
2871             }
2872             die_offsets.clear();
2873         }
2874 
2875         if (name_type_mask & eFunctionNameTypeMethod)
2876         {
2877             if (parent_decl_ctx && parent_decl_ctx->IsValid())
2878                 return 0; // no methods in namespaces
2879 
2880             uint32_t num_base = m_function_method_index.Find(name, die_offsets);
2881             {
2882                 for (uint32_t i = 0; i < num_base; i++)
2883                 {
2884                     DWARFDIE die = info->GetDIE (die_offsets[i]);
2885                     if (die)
2886                     {
2887                         // If we get to here, the die is good, and we should add it:
2888                         if (resolved_dies.find(die.GetDIE()) == resolved_dies.end())
2889                         {
2890                             if (ResolveFunction (die, include_inlines, sc_list))
2891                                 resolved_dies.insert(die.GetDIE());
2892                         }
2893                     }
2894                 }
2895             }
2896             die_offsets.clear();
2897         }
2898 
2899         if ((name_type_mask & eFunctionNameTypeSelector) && (!parent_decl_ctx || !parent_decl_ctx->IsValid()))
2900         {
2901             FindFunctions (name, m_function_selector_index, include_inlines, sc_list);
2902         }
2903 
2904     }
2905 
2906     // Return the number of variable that were appended to the list
2907     const uint32_t num_matches = sc_list.GetSize() - original_size;
2908 
2909     if (log && num_matches > 0)
2910     {
2911         GetObjectFile()->GetModule()->LogMessage (log,
2912                                                   "SymbolFileDWARF::FindFunctions (name=\"%s\", name_type_mask=0x%x, include_inlines=%d, append=%u, sc_list) => %u",
2913                                                   name.GetCString(),
2914                                                   name_type_mask,
2915                                                   include_inlines,
2916                                                   append,
2917                                                   num_matches);
2918     }
2919     return num_matches;
2920 }
2921 
2922 uint32_t
2923 SymbolFileDWARF::FindFunctions(const RegularExpression& regex, bool include_inlines, bool append, SymbolContextList& sc_list)
2924 {
2925     Timer scoped_timer (__PRETTY_FUNCTION__,
2926                         "SymbolFileDWARF::FindFunctions (regex = '%s')",
2927                         regex.GetText());
2928 
2929     Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_LOOKUPS));
2930 
2931     if (log)
2932     {
2933         GetObjectFile()->GetModule()->LogMessage (log,
2934                                                   "SymbolFileDWARF::FindFunctions (regex=\"%s\", append=%u, sc_list)",
2935                                                   regex.GetText(),
2936                                                   append);
2937     }
2938 
2939 
2940     // If we aren't appending the results to this list, then clear the list
2941     if (!append)
2942         sc_list.Clear();
2943 
2944     // Remember how many sc_list are in the list before we search in case
2945     // we are appending the results to a variable list.
2946     uint32_t original_size = sc_list.GetSize();
2947 
2948     if (m_using_apple_tables)
2949     {
2950         if (m_apple_names_ap.get())
2951             FindFunctions (regex, *m_apple_names_ap, include_inlines, sc_list);
2952     }
2953     else
2954     {
2955         // Index the DWARF if we haven't already
2956         if (!m_indexed)
2957             Index ();
2958 
2959         FindFunctions (regex, m_function_basename_index, include_inlines, sc_list);
2960 
2961         FindFunctions (regex, m_function_fullname_index, include_inlines, sc_list);
2962     }
2963 
2964     // Return the number of variable that were appended to the list
2965     return sc_list.GetSize() - original_size;
2966 }
2967 
2968 void
2969 SymbolFileDWARF::GetMangledNamesForFunction (const std::string &scope_qualified_name,
2970                                              std::vector<ConstString> &mangled_names)
2971 {
2972     DWARFDebugInfo* info = DebugInfo();
2973     uint32_t num_comp_units = 0;
2974     if (info)
2975         num_comp_units = info->GetNumCompileUnits();
2976 
2977     for (uint32_t i = 0; i < num_comp_units; i++)
2978     {
2979         DWARFCompileUnit *cu = info->GetCompileUnitAtIndex(i);
2980         if (cu == nullptr)
2981             continue;
2982 
2983         SymbolFileDWARFDwo *dwo = cu->GetDwoSymbolFile();
2984         if (dwo)
2985             dwo->GetMangledNamesForFunction(scope_qualified_name, mangled_names);
2986     }
2987 
2988     NameToOffsetMap::iterator iter = m_function_scope_qualified_name_map.find(scope_qualified_name);
2989     if (iter == m_function_scope_qualified_name_map.end())
2990         return;
2991 
2992     DIERefSetSP set_sp = (*iter).second;
2993     std::set<DIERef>::iterator set_iter;
2994     for (set_iter = set_sp->begin(); set_iter != set_sp->end(); set_iter++)
2995     {
2996         DWARFDIE die = DebugInfo()->GetDIE (*set_iter);
2997         mangled_names.push_back(ConstString(die.GetMangledName()));
2998     }
2999 }
3000 
3001 
3002 uint32_t
3003 SymbolFileDWARF::FindTypes (const SymbolContext& sc,
3004                             const ConstString &name,
3005                             const CompilerDeclContext *parent_decl_ctx,
3006                             bool append,
3007                             uint32_t max_matches,
3008                             llvm::DenseSet<lldb_private::SymbolFile *> &searched_symbol_files,
3009                             TypeMap& types)
3010 {
3011     // If we aren't appending the results to this list, then clear the list
3012     if (!append)
3013         types.Clear();
3014 
3015     // Make sure we haven't already searched this SymbolFile before...
3016     if (searched_symbol_files.count(this))
3017         return 0;
3018     else
3019         searched_symbol_files.insert(this);
3020 
3021     DWARFDebugInfo* info = DebugInfo();
3022     if (info == NULL)
3023         return 0;
3024 
3025     Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_LOOKUPS));
3026 
3027     if (log)
3028     {
3029         if (parent_decl_ctx)
3030             GetObjectFile()->GetModule()->LogMessage (log,
3031                                                       "SymbolFileDWARF::FindTypes (sc, name=\"%s\", parent_decl_ctx = %p (\"%s\"), append=%u, max_matches=%u, type_list)",
3032                                                       name.GetCString(),
3033                                                       static_cast<const void*>(parent_decl_ctx),
3034                                                       parent_decl_ctx->GetName().AsCString("<NULL>"),
3035                                                       append, max_matches);
3036         else
3037             GetObjectFile()->GetModule()->LogMessage (log,
3038                                                       "SymbolFileDWARF::FindTypes (sc, name=\"%s\", parent_decl_ctx = NULL, append=%u, max_matches=%u, type_list)",
3039                                                       name.GetCString(), append,
3040                                                       max_matches);
3041     }
3042 
3043     if (!DeclContextMatchesThisSymbolFile(parent_decl_ctx))
3044         return 0;
3045 
3046     DIEArray die_offsets;
3047 
3048     if (m_using_apple_tables)
3049     {
3050         if (m_apple_types_ap.get())
3051         {
3052             const char *name_cstr = name.GetCString();
3053             m_apple_types_ap->FindByName (name_cstr, die_offsets);
3054         }
3055     }
3056     else
3057     {
3058         if (!m_indexed)
3059             Index ();
3060 
3061         m_type_index.Find (name, die_offsets);
3062     }
3063 
3064     const size_t num_die_matches = die_offsets.size();
3065 
3066     if (num_die_matches)
3067     {
3068         const uint32_t initial_types_size = types.GetSize();
3069         DWARFDebugInfo* debug_info = DebugInfo();
3070         for (size_t i=0; i<num_die_matches; ++i)
3071         {
3072             const DIERef& die_ref = die_offsets[i];
3073             DWARFDIE die = debug_info->GetDIE (die_ref);
3074 
3075             if (die)
3076             {
3077                 if (!DIEInDeclContext(parent_decl_ctx, die))
3078                     continue; // The containing decl contexts don't match
3079 
3080                 Type *matching_type = ResolveType (die, true, true);
3081                 if (matching_type)
3082                 {
3083                     // We found a type pointer, now find the shared pointer form our type list
3084                     types.InsertUnique (matching_type->shared_from_this());
3085                     if (types.GetSize() >= max_matches)
3086                         break;
3087                 }
3088             }
3089             else
3090             {
3091                 if (m_using_apple_tables)
3092                 {
3093                     GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_types accelerator table had bad die 0x%8.8x for '%s')\n",
3094                                                                                die_ref.die_offset, name.GetCString());
3095                 }
3096             }
3097 
3098         }
3099         const uint32_t num_matches = types.GetSize() - initial_types_size;
3100         if (log && num_matches)
3101         {
3102             if (parent_decl_ctx)
3103             {
3104                 GetObjectFile()->GetModule()->LogMessage (log,
3105                                                           "SymbolFileDWARF::FindTypes (sc, name=\"%s\", parent_decl_ctx = %p (\"%s\"), append=%u, max_matches=%u, type_list) => %u",
3106                                                           name.GetCString(),
3107                                                           static_cast<const void*>(parent_decl_ctx),
3108                                                           parent_decl_ctx->GetName().AsCString("<NULL>"),
3109                                                           append, max_matches,
3110                                                           num_matches);
3111             }
3112             else
3113             {
3114                 GetObjectFile()->GetModule()->LogMessage (log,
3115                                                           "SymbolFileDWARF::FindTypes (sc, name=\"%s\", parent_decl_ctx = NULL, append=%u, max_matches=%u, type_list) => %u",
3116                                                           name.GetCString(),
3117                                                           append, max_matches,
3118                                                           num_matches);
3119             }
3120         }
3121         return num_matches;
3122     }
3123     else
3124     {
3125         UpdateExternalModuleListIfNeeded();
3126 
3127         for (const auto &pair : m_external_type_modules)
3128         {
3129             ModuleSP external_module_sp = pair.second;
3130             if (external_module_sp)
3131             {
3132                 SymbolVendor *sym_vendor = external_module_sp->GetSymbolVendor();
3133                 if (sym_vendor)
3134                 {
3135                     const uint32_t num_external_matches = sym_vendor->FindTypes (sc,
3136                                                                                  name,
3137                                                                                  parent_decl_ctx,
3138                                                                                  append,
3139                                                                                  max_matches,
3140                                                                                  searched_symbol_files,
3141                                                                                  types);
3142                     if (num_external_matches)
3143                         return num_external_matches;
3144                 }
3145             }
3146         }
3147     }
3148 
3149     return 0;
3150 }
3151 
3152 
3153 size_t
3154 SymbolFileDWARF::FindTypes (const std::vector<CompilerContext> &context,
3155                             bool append,
3156                             TypeMap& types)
3157 {
3158     if (!append)
3159         types.Clear();
3160 
3161     if (context.empty())
3162         return 0;
3163 
3164     DIEArray die_offsets;
3165 
3166     ConstString name = context.back().name;
3167 
3168     if (!name)
3169         return 0;
3170 
3171     if (m_using_apple_tables)
3172     {
3173         if (m_apple_types_ap.get())
3174         {
3175             const char *name_cstr = name.GetCString();
3176             m_apple_types_ap->FindByName (name_cstr, die_offsets);
3177         }
3178     }
3179     else
3180     {
3181         if (!m_indexed)
3182             Index ();
3183 
3184         m_type_index.Find (name, die_offsets);
3185     }
3186 
3187     const size_t num_die_matches = die_offsets.size();
3188 
3189     if (num_die_matches)
3190     {
3191         size_t num_matches = 0;
3192         DWARFDebugInfo* debug_info = DebugInfo();
3193         for (size_t i=0; i<num_die_matches; ++i)
3194         {
3195             const DIERef& die_ref = die_offsets[i];
3196             DWARFDIE die = debug_info->GetDIE (die_ref);
3197 
3198             if (die)
3199             {
3200                 std::vector<CompilerContext> die_context;
3201                 die.GetDWOContext(die_context);
3202                 if (die_context != context)
3203                     continue;
3204 
3205                 Type *matching_type = ResolveType (die, true, true);
3206                 if (matching_type)
3207                 {
3208                     // We found a type pointer, now find the shared pointer form our type list
3209                     types.InsertUnique (matching_type->shared_from_this());
3210                     ++num_matches;
3211                 }
3212             }
3213             else
3214             {
3215                 if (m_using_apple_tables)
3216                 {
3217                     GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_types accelerator table had bad die 0x%8.8x for '%s')\n",
3218                                                                                die_ref.die_offset, name.GetCString());
3219                 }
3220             }
3221 
3222         }
3223         return num_matches;
3224     }
3225     return 0;
3226 }
3227 
3228 
3229 CompilerDeclContext
3230 SymbolFileDWARF::FindNamespace (const SymbolContext& sc,
3231                                 const ConstString &name,
3232                                 const CompilerDeclContext *parent_decl_ctx)
3233 {
3234     Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_LOOKUPS));
3235 
3236     if (log)
3237     {
3238         GetObjectFile()->GetModule()->LogMessage (log,
3239                                                   "SymbolFileDWARF::FindNamespace (sc, name=\"%s\")",
3240                                                   name.GetCString());
3241     }
3242 
3243     CompilerDeclContext namespace_decl_ctx;
3244 
3245     if (!DeclContextMatchesThisSymbolFile(parent_decl_ctx))
3246         return namespace_decl_ctx;
3247 
3248 
3249     DWARFDebugInfo* info = DebugInfo();
3250     if (info)
3251     {
3252         DIEArray die_offsets;
3253 
3254         // Index if we already haven't to make sure the compile units
3255         // get indexed and make their global DIE index list
3256         if (m_using_apple_tables)
3257         {
3258             if (m_apple_namespaces_ap.get())
3259             {
3260                 const char *name_cstr = name.GetCString();
3261                 m_apple_namespaces_ap->FindByName (name_cstr, die_offsets);
3262             }
3263         }
3264         else
3265         {
3266             if (!m_indexed)
3267                 Index ();
3268 
3269             m_namespace_index.Find (name, die_offsets);
3270         }
3271 
3272         const size_t num_matches = die_offsets.size();
3273         if (num_matches)
3274         {
3275             DWARFDebugInfo* debug_info = DebugInfo();
3276             for (size_t i=0; i<num_matches; ++i)
3277             {
3278                 const DIERef& die_ref = die_offsets[i];
3279                 DWARFDIE die = debug_info->GetDIE (die_ref);
3280 
3281                 if (die)
3282                 {
3283                     if (!DIEInDeclContext (parent_decl_ctx, die))
3284                         continue; // The containing decl contexts don't match
3285 
3286                     DWARFASTParser *dwarf_ast = die.GetDWARFParser();
3287                     if (dwarf_ast)
3288                     {
3289                         namespace_decl_ctx = dwarf_ast->GetDeclContextForUIDFromDWARF (die);
3290                         if (namespace_decl_ctx)
3291                             break;
3292                     }
3293                 }
3294                 else
3295                 {
3296                     if (m_using_apple_tables)
3297                     {
3298                         GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_namespaces accelerator table had bad die 0x%8.8x for '%s')\n",
3299                                                                    die_ref.die_offset, name.GetCString());
3300                     }
3301                 }
3302 
3303             }
3304         }
3305     }
3306     if (log && namespace_decl_ctx)
3307     {
3308         GetObjectFile()->GetModule()->LogMessage (log,
3309                                                   "SymbolFileDWARF::FindNamespace (sc, name=\"%s\") => CompilerDeclContext(%p/%p) \"%s\"",
3310                                                   name.GetCString(),
3311                                                   static_cast<const void*>(namespace_decl_ctx.GetTypeSystem()),
3312                                                   static_cast<const void*>(namespace_decl_ctx.GetOpaqueDeclContext()),
3313                                                   namespace_decl_ctx.GetName().AsCString("<NULL>"));
3314     }
3315 
3316     return namespace_decl_ctx;
3317 }
3318 
3319 TypeSP
3320 SymbolFileDWARF::GetTypeForDIE (const DWARFDIE &die, bool resolve_function_context)
3321 {
3322     TypeSP type_sp;
3323     if (die)
3324     {
3325         Type *type_ptr = GetDIEToType().lookup (die.GetDIE());
3326         if (type_ptr == NULL)
3327         {
3328             CompileUnit* lldb_cu = GetCompUnitForDWARFCompUnit(die.GetCU());
3329             assert (lldb_cu);
3330             SymbolContext sc(lldb_cu);
3331             const DWARFDebugInfoEntry* parent_die = die.GetParent().GetDIE();
3332             while (parent_die != nullptr)
3333                 {
3334                     if (parent_die->Tag() == DW_TAG_subprogram)
3335                         break;
3336                     parent_die = parent_die->GetParent();
3337                 }
3338             SymbolContext sc_backup = sc;
3339             if (resolve_function_context && parent_die != nullptr && !GetFunction(DWARFDIE(die.GetCU(),parent_die), sc))
3340                 sc = sc_backup;
3341 
3342             type_sp = ParseType(sc, die, NULL);
3343         }
3344         else if (type_ptr != DIE_IS_BEING_PARSED)
3345         {
3346             // Grab the existing type from the master types lists
3347             type_sp = type_ptr->shared_from_this();
3348         }
3349 
3350     }
3351     return type_sp;
3352 }
3353 
3354 
3355 DWARFDIE
3356 SymbolFileDWARF::GetDeclContextDIEContainingDIE (const DWARFDIE &orig_die)
3357 {
3358     if (orig_die)
3359     {
3360         DWARFDIE die = orig_die;
3361 
3362         while (die)
3363         {
3364             // If this is the original DIE that we are searching for a declaration
3365             // for, then don't look in the cache as we don't want our own decl
3366             // context to be our decl context...
3367             if (orig_die != die)
3368             {
3369                 switch (die.Tag())
3370                 {
3371                     case DW_TAG_compile_unit:
3372                     case DW_TAG_namespace:
3373                     case DW_TAG_structure_type:
3374                     case DW_TAG_union_type:
3375                     case DW_TAG_class_type:
3376                     case DW_TAG_lexical_block:
3377                     case DW_TAG_subprogram:
3378                         return die;
3379 
3380                     default:
3381                         break;
3382                 }
3383             }
3384 
3385             DWARFDIE spec_die = die.GetReferencedDIE(DW_AT_specification);
3386             if (spec_die)
3387             {
3388                 DWARFDIE decl_ctx_die = GetDeclContextDIEContainingDIE(spec_die);
3389                 if (decl_ctx_die)
3390                     return decl_ctx_die;
3391             }
3392 
3393             DWARFDIE abs_die = die.GetReferencedDIE(DW_AT_abstract_origin);
3394             if (abs_die)
3395             {
3396                 DWARFDIE decl_ctx_die = GetDeclContextDIEContainingDIE(abs_die);
3397                 if (decl_ctx_die)
3398                     return decl_ctx_die;
3399             }
3400 
3401             die = die.GetParent();
3402         }
3403     }
3404     return DWARFDIE();
3405 }
3406 
3407 
3408 Symbol *
3409 SymbolFileDWARF::GetObjCClassSymbol (const ConstString &objc_class_name)
3410 {
3411     Symbol *objc_class_symbol = NULL;
3412     if (m_obj_file)
3413     {
3414         Symtab *symtab = m_obj_file->GetSymtab ();
3415         if (symtab)
3416         {
3417             objc_class_symbol = symtab->FindFirstSymbolWithNameAndType (objc_class_name,
3418                                                                         eSymbolTypeObjCClass,
3419                                                                         Symtab::eDebugNo,
3420                                                                         Symtab::eVisibilityAny);
3421         }
3422     }
3423     return objc_class_symbol;
3424 }
3425 
3426 // Some compilers don't emit the DW_AT_APPLE_objc_complete_type attribute. If they don't
3427 // then we can end up looking through all class types for a complete type and never find
3428 // the full definition. We need to know if this attribute is supported, so we determine
3429 // this here and cache th result. We also need to worry about the debug map DWARF file
3430 // if we are doing darwin DWARF in .o file debugging.
3431 bool
3432 SymbolFileDWARF::Supports_DW_AT_APPLE_objc_complete_type (DWARFCompileUnit *cu)
3433 {
3434     if (m_supports_DW_AT_APPLE_objc_complete_type == eLazyBoolCalculate)
3435     {
3436         m_supports_DW_AT_APPLE_objc_complete_type = eLazyBoolNo;
3437         if (cu && cu->Supports_DW_AT_APPLE_objc_complete_type())
3438             m_supports_DW_AT_APPLE_objc_complete_type = eLazyBoolYes;
3439         else
3440         {
3441             DWARFDebugInfo* debug_info = DebugInfo();
3442             const uint32_t num_compile_units = GetNumCompileUnits();
3443             for (uint32_t cu_idx = 0; cu_idx < num_compile_units; ++cu_idx)
3444             {
3445                 DWARFCompileUnit* dwarf_cu = debug_info->GetCompileUnitAtIndex(cu_idx);
3446                 if (dwarf_cu != cu && dwarf_cu->Supports_DW_AT_APPLE_objc_complete_type())
3447                 {
3448                     m_supports_DW_AT_APPLE_objc_complete_type = eLazyBoolYes;
3449                     break;
3450                 }
3451             }
3452         }
3453         if (m_supports_DW_AT_APPLE_objc_complete_type == eLazyBoolNo && GetDebugMapSymfile ())
3454             return m_debug_map_symfile->Supports_DW_AT_APPLE_objc_complete_type (this);
3455     }
3456     return m_supports_DW_AT_APPLE_objc_complete_type == eLazyBoolYes;
3457 }
3458 
3459 // This function can be used when a DIE is found that is a forward declaration
3460 // DIE and we want to try and find a type that has the complete definition.
3461 TypeSP
3462 SymbolFileDWARF::FindCompleteObjCDefinitionTypeForDIE (const DWARFDIE &die,
3463                                                        const ConstString &type_name,
3464                                                        bool must_be_implementation)
3465 {
3466 
3467     TypeSP type_sp;
3468 
3469     if (!type_name || (must_be_implementation && !GetObjCClassSymbol (type_name)))
3470         return type_sp;
3471 
3472     DIEArray die_offsets;
3473 
3474     if (m_using_apple_tables)
3475     {
3476         if (m_apple_types_ap.get())
3477         {
3478             const char *name_cstr = type_name.GetCString();
3479             m_apple_types_ap->FindCompleteObjCClassByName (name_cstr, die_offsets, must_be_implementation);
3480         }
3481     }
3482     else
3483     {
3484         if (!m_indexed)
3485             Index ();
3486 
3487         m_type_index.Find (type_name, die_offsets);
3488     }
3489 
3490     const size_t num_matches = die_offsets.size();
3491 
3492     if (num_matches)
3493     {
3494         DWARFDebugInfo* debug_info = DebugInfo();
3495         for (size_t i=0; i<num_matches; ++i)
3496         {
3497             const DIERef& die_ref = die_offsets[i];
3498             DWARFDIE type_die = debug_info->GetDIE (die_ref);
3499 
3500             if (type_die)
3501             {
3502                 bool try_resolving_type = false;
3503 
3504                 // Don't try and resolve the DIE we are looking for with the DIE itself!
3505                 if (type_die != die)
3506                 {
3507                     switch (type_die.Tag())
3508                     {
3509                         case DW_TAG_class_type:
3510                         case DW_TAG_structure_type:
3511                             try_resolving_type = true;
3512                             break;
3513                         default:
3514                             break;
3515                     }
3516                 }
3517 
3518                 if (try_resolving_type)
3519                 {
3520                     if (must_be_implementation && type_die.Supports_DW_AT_APPLE_objc_complete_type())
3521                         try_resolving_type = type_die.GetAttributeValueAsUnsigned (DW_AT_APPLE_objc_complete_type, 0);
3522 
3523                     if (try_resolving_type)
3524                     {
3525                         Type *resolved_type = ResolveType (type_die, false, true);
3526                         if (resolved_type && resolved_type != DIE_IS_BEING_PARSED)
3527                         {
3528                             DEBUG_PRINTF ("resolved 0x%8.8" PRIx64 " from %s to 0x%8.8" PRIx64 " (cu 0x%8.8" PRIx64 ")\n",
3529                                           die.GetID(),
3530                                           m_obj_file->GetFileSpec().GetFilename().AsCString("<Unknown>"),
3531                                           type_die.GetID(),
3532                                           type_cu->GetID());
3533 
3534                             if (die)
3535                                 GetDIEToType()[die.GetDIE()] = resolved_type;
3536                             type_sp = resolved_type->shared_from_this();
3537                             break;
3538                         }
3539                     }
3540                 }
3541             }
3542             else
3543             {
3544                 if (m_using_apple_tables)
3545                 {
3546                     GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_types accelerator table had bad die 0x%8.8x for '%s')\n",
3547                                                                die_ref.die_offset, type_name.GetCString());
3548                 }
3549             }
3550 
3551         }
3552     }
3553     return type_sp;
3554 }
3555 
3556 
3557 //----------------------------------------------------------------------
3558 // This function helps to ensure that the declaration contexts match for
3559 // two different DIEs. Often times debug information will refer to a
3560 // forward declaration of a type (the equivalent of "struct my_struct;".
3561 // There will often be a declaration of that type elsewhere that has the
3562 // full definition. When we go looking for the full type "my_struct", we
3563 // will find one or more matches in the accelerator tables and we will
3564 // then need to make sure the type was in the same declaration context
3565 // as the original DIE. This function can efficiently compare two DIEs
3566 // and will return true when the declaration context matches, and false
3567 // when they don't.
3568 //----------------------------------------------------------------------
3569 bool
3570 SymbolFileDWARF::DIEDeclContextsMatch (const DWARFDIE &die1,
3571                                        const DWARFDIE &die2)
3572 {
3573     if (die1 == die2)
3574         return true;
3575 
3576     DWARFDIECollection decl_ctx_1;
3577     DWARFDIECollection decl_ctx_2;
3578     //The declaration DIE stack is a stack of the declaration context
3579     // DIEs all the way back to the compile unit. If a type "T" is
3580     // declared inside a class "B", and class "B" is declared inside
3581     // a class "A" and class "A" is in a namespace "lldb", and the
3582     // namespace is in a compile unit, there will be a stack of DIEs:
3583     //
3584     //   [0] DW_TAG_class_type for "B"
3585     //   [1] DW_TAG_class_type for "A"
3586     //   [2] DW_TAG_namespace  for "lldb"
3587     //   [3] DW_TAG_compile_unit for the source file.
3588     //
3589     // We grab both contexts and make sure that everything matches
3590     // all the way back to the compiler unit.
3591 
3592     // First lets grab the decl contexts for both DIEs
3593     die1.GetDeclContextDIEs (decl_ctx_1);
3594     die2.GetDeclContextDIEs (decl_ctx_2);
3595     // Make sure the context arrays have the same size, otherwise
3596     // we are done
3597     const size_t count1 = decl_ctx_1.Size();
3598     const size_t count2 = decl_ctx_2.Size();
3599     if (count1 != count2)
3600         return false;
3601 
3602     // Make sure the DW_TAG values match all the way back up the
3603     // compile unit. If they don't, then we are done.
3604     DWARFDIE decl_ctx_die1;
3605     DWARFDIE decl_ctx_die2;
3606     size_t i;
3607     for (i=0; i<count1; i++)
3608     {
3609         decl_ctx_die1 = decl_ctx_1.GetDIEAtIndex (i);
3610         decl_ctx_die2 = decl_ctx_2.GetDIEAtIndex (i);
3611         if (decl_ctx_die1.Tag() != decl_ctx_die2.Tag())
3612             return false;
3613     }
3614 #if defined LLDB_CONFIGURATION_DEBUG
3615 
3616     // Make sure the top item in the decl context die array is always
3617     // DW_TAG_compile_unit. If it isn't then something went wrong in
3618     // the DWARFDIE::GetDeclContextDIEs() function...
3619     assert (decl_ctx_1.GetDIEAtIndex (count1 - 1).Tag() == DW_TAG_compile_unit);
3620 
3621 #endif
3622     // Always skip the compile unit when comparing by only iterating up to
3623     // "count - 1". Here we compare the names as we go.
3624     for (i=0; i<count1 - 1; i++)
3625     {
3626         decl_ctx_die1 = decl_ctx_1.GetDIEAtIndex (i);
3627         decl_ctx_die2 = decl_ctx_2.GetDIEAtIndex (i);
3628         const char *name1 = decl_ctx_die1.GetName();
3629         const char *name2 = decl_ctx_die2.GetName();
3630         // If the string was from a DW_FORM_strp, then the pointer will often
3631         // be the same!
3632         if (name1 == name2)
3633             continue;
3634 
3635         // Name pointers are not equal, so only compare the strings
3636         // if both are not NULL.
3637         if (name1 && name2)
3638         {
3639             // If the strings don't compare, we are done...
3640             if (strcmp(name1, name2) != 0)
3641                 return false;
3642         }
3643         else
3644         {
3645             // One name was NULL while the other wasn't
3646             return false;
3647         }
3648     }
3649     // We made it through all of the checks and the declaration contexts
3650     // are equal.
3651     return true;
3652 }
3653 
3654 
3655 TypeSP
3656 SymbolFileDWARF::FindDefinitionTypeForDWARFDeclContext (const DWARFDeclContext &dwarf_decl_ctx)
3657 {
3658     TypeSP type_sp;
3659 
3660     const uint32_t dwarf_decl_ctx_count = dwarf_decl_ctx.GetSize();
3661     if (dwarf_decl_ctx_count > 0)
3662     {
3663         const ConstString type_name(dwarf_decl_ctx[0].name);
3664         const dw_tag_t tag = dwarf_decl_ctx[0].tag;
3665 
3666         if (type_name)
3667         {
3668             Log *log (LogChannelDWARF::GetLogIfAny(DWARF_LOG_TYPE_COMPLETION|DWARF_LOG_LOOKUPS));
3669             if (log)
3670             {
3671                 GetObjectFile()->GetModule()->LogMessage (log,
3672                                                           "SymbolFileDWARF::FindDefinitionTypeForDWARFDeclContext(tag=%s, qualified-name='%s')",
3673                                                           DW_TAG_value_to_name(dwarf_decl_ctx[0].tag),
3674                                                           dwarf_decl_ctx.GetQualifiedName());
3675             }
3676 
3677             DIEArray die_offsets;
3678 
3679             if (m_using_apple_tables)
3680             {
3681                 if (m_apple_types_ap.get())
3682                 {
3683                     const bool has_tag = m_apple_types_ap->GetHeader().header_data.ContainsAtom (DWARFMappedHash::eAtomTypeTag);
3684                     const bool has_qualified_name_hash = m_apple_types_ap->GetHeader().header_data.ContainsAtom (DWARFMappedHash::eAtomTypeQualNameHash);
3685                     if (has_tag && has_qualified_name_hash)
3686                     {
3687                         const char *qualified_name = dwarf_decl_ctx.GetQualifiedName();
3688                         const uint32_t qualified_name_hash = MappedHash::HashStringUsingDJB (qualified_name);
3689                         if (log)
3690                             GetObjectFile()->GetModule()->LogMessage (log,"FindByNameAndTagAndQualifiedNameHash()");
3691                         m_apple_types_ap->FindByNameAndTagAndQualifiedNameHash (type_name.GetCString(), tag, qualified_name_hash, die_offsets);
3692                     }
3693                     else if (has_tag)
3694                     {
3695                         if (log)
3696                             GetObjectFile()->GetModule()->LogMessage (log,"FindByNameAndTag()");
3697                         m_apple_types_ap->FindByNameAndTag (type_name.GetCString(), tag, die_offsets);
3698                     }
3699                     else
3700                     {
3701                         m_apple_types_ap->FindByName (type_name.GetCString(), die_offsets);
3702                     }
3703                 }
3704             }
3705             else
3706             {
3707                 if (!m_indexed)
3708                     Index ();
3709 
3710                 m_type_index.Find (type_name, die_offsets);
3711             }
3712 
3713             const size_t num_matches = die_offsets.size();
3714 
3715 
3716             if (num_matches)
3717             {
3718                 DWARFDebugInfo* debug_info = DebugInfo();
3719                 for (size_t i=0; i<num_matches; ++i)
3720                 {
3721                     const DIERef& die_ref = die_offsets[i];
3722                     DWARFDIE type_die = debug_info->GetDIE (die_ref);
3723 
3724                     if (type_die)
3725                     {
3726                         bool try_resolving_type = false;
3727 
3728                         // Don't try and resolve the DIE we are looking for with the DIE itself!
3729                         const dw_tag_t type_tag = type_die.Tag();
3730                         // Make sure the tags match
3731                         if (type_tag == tag)
3732                         {
3733                             // The tags match, lets try resolving this type
3734                             try_resolving_type = true;
3735                         }
3736                         else
3737                         {
3738                             // The tags don't match, but we need to watch our for a
3739                             // forward declaration for a struct and ("struct foo")
3740                             // ends up being a class ("class foo { ... };") or
3741                             // vice versa.
3742                             switch (type_tag)
3743                             {
3744                                 case DW_TAG_class_type:
3745                                     // We had a "class foo", see if we ended up with a "struct foo { ... };"
3746                                     try_resolving_type = (tag == DW_TAG_structure_type);
3747                                     break;
3748                                 case DW_TAG_structure_type:
3749                                     // We had a "struct foo", see if we ended up with a "class foo { ... };"
3750                                     try_resolving_type = (tag == DW_TAG_class_type);
3751                                     break;
3752                                 default:
3753                                     // Tags don't match, don't event try to resolve
3754                                     // using this type whose name matches....
3755                                     break;
3756                             }
3757                         }
3758 
3759                         if (try_resolving_type)
3760                         {
3761                             DWARFDeclContext type_dwarf_decl_ctx;
3762                             type_die.GetDWARFDeclContext (type_dwarf_decl_ctx);
3763 
3764                             if (log)
3765                             {
3766                                 GetObjectFile()->GetModule()->LogMessage (log,
3767                                                                           "SymbolFileDWARF::FindDefinitionTypeForDWARFDeclContext(tag=%s, qualified-name='%s') trying die=0x%8.8x (%s)",
3768                                                                           DW_TAG_value_to_name(dwarf_decl_ctx[0].tag),
3769                                                                           dwarf_decl_ctx.GetQualifiedName(),
3770                                                                           type_die.GetOffset(),
3771                                                                           type_dwarf_decl_ctx.GetQualifiedName());
3772                             }
3773 
3774                             // Make sure the decl contexts match all the way up
3775                             if (dwarf_decl_ctx == type_dwarf_decl_ctx)
3776                             {
3777                                 Type *resolved_type = ResolveType (type_die, false);
3778                                 if (resolved_type && resolved_type != DIE_IS_BEING_PARSED)
3779                                 {
3780                                     type_sp = resolved_type->shared_from_this();
3781                                     break;
3782                                 }
3783                             }
3784                         }
3785                         else
3786                         {
3787                             if (log)
3788                             {
3789                                 std::string qualified_name;
3790                                 type_die.GetQualifiedName(qualified_name);
3791                                 GetObjectFile()->GetModule()->LogMessage (log,
3792                                                                           "SymbolFileDWARF::FindDefinitionTypeForDWARFDeclContext(tag=%s, qualified-name='%s') ignoring die=0x%8.8x (%s)",
3793                                                                           DW_TAG_value_to_name(dwarf_decl_ctx[0].tag),
3794                                                                           dwarf_decl_ctx.GetQualifiedName(),
3795                                                                           type_die.GetOffset(),
3796                                                                           qualified_name.c_str());
3797                             }
3798                         }
3799                     }
3800                     else
3801                     {
3802                         if (m_using_apple_tables)
3803                         {
3804                             GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_types accelerator table had bad die 0x%8.8x for '%s')\n",
3805                                                                                        die_ref.die_offset, type_name.GetCString());
3806                         }
3807                     }
3808 
3809                 }
3810             }
3811         }
3812     }
3813     return type_sp;
3814 }
3815 
3816 TypeSP
3817 SymbolFileDWARF::ParseType (const SymbolContext& sc, const DWARFDIE &die, bool *type_is_new_ptr)
3818 {
3819     TypeSP type_sp;
3820 
3821     if (die)
3822     {
3823         TypeSystem *type_system = GetTypeSystemForLanguage(die.GetCU()->GetLanguageType());
3824 
3825         if (type_system)
3826         {
3827             DWARFASTParser *dwarf_ast = type_system->GetDWARFParser();
3828             if (dwarf_ast)
3829             {
3830                 Log *log = LogChannelDWARF::GetLogIfAll(DWARF_LOG_DEBUG_INFO);
3831                 type_sp = dwarf_ast->ParseTypeFromDWARF (sc, die, log, type_is_new_ptr);
3832                 if (type_sp)
3833                 {
3834                     TypeList* type_list = GetTypeList();
3835                     if (type_list)
3836                         type_list->Insert(type_sp);
3837 
3838                     if (die.Tag() == DW_TAG_subprogram)
3839                     {
3840                         DIERef die_ref = die.GetDIERef();
3841                         std::string scope_qualified_name(GetDeclContextForUID(die.GetID()).GetScopeQualifiedName().AsCString(""));
3842                         if (scope_qualified_name.size())
3843                         {
3844                             NameToOffsetMap::iterator iter = m_function_scope_qualified_name_map.find(scope_qualified_name);
3845                             if (iter != m_function_scope_qualified_name_map.end())
3846                                 (*iter).second->insert(die_ref);
3847                             else
3848                             {
3849                                 DIERefSetSP new_set(new std::set<DIERef>);
3850                                 new_set->insert(die_ref);
3851                                 m_function_scope_qualified_name_map.emplace(std::make_pair(scope_qualified_name, new_set));
3852                             }
3853                         }
3854                     }
3855                 }
3856             }
3857         }
3858     }
3859 
3860     return type_sp;
3861 }
3862 
3863 size_t
3864 SymbolFileDWARF::ParseTypes
3865 (
3866     const SymbolContext& sc,
3867     const DWARFDIE &orig_die,
3868     bool parse_siblings,
3869     bool parse_children
3870 )
3871 {
3872     size_t types_added = 0;
3873     DWARFDIE die = orig_die;
3874     while (die)
3875     {
3876         bool type_is_new = false;
3877         if (ParseType(sc, die, &type_is_new).get())
3878         {
3879             if (type_is_new)
3880                 ++types_added;
3881         }
3882 
3883         if (parse_children && die.HasChildren())
3884         {
3885             if (die.Tag() == DW_TAG_subprogram)
3886             {
3887                 SymbolContext child_sc(sc);
3888                 child_sc.function = sc.comp_unit->FindFunctionByUID(die.GetID()).get();
3889                 types_added += ParseTypes(child_sc, die.GetFirstChild(), true, true);
3890             }
3891             else
3892                 types_added += ParseTypes(sc, die.GetFirstChild(), true, true);
3893         }
3894 
3895         if (parse_siblings)
3896             die = die.GetSibling();
3897         else
3898             die.Clear();
3899     }
3900     return types_added;
3901 }
3902 
3903 
3904 size_t
3905 SymbolFileDWARF::ParseFunctionBlocks (const SymbolContext &sc)
3906 {
3907     assert(sc.comp_unit && sc.function);
3908     size_t functions_added = 0;
3909     DWARFCompileUnit* dwarf_cu = GetDWARFCompileUnit(sc.comp_unit);
3910     if (dwarf_cu)
3911     {
3912         const dw_offset_t function_die_offset = sc.function->GetID();
3913         DWARFDIE function_die = dwarf_cu->GetDIE (function_die_offset);
3914         if (function_die)
3915         {
3916             ParseFunctionBlocks(sc, &sc.function->GetBlock (false), function_die, LLDB_INVALID_ADDRESS, 0);
3917         }
3918     }
3919 
3920     return functions_added;
3921 }
3922 
3923 
3924 size_t
3925 SymbolFileDWARF::ParseTypes (const SymbolContext &sc)
3926 {
3927     // At least a compile unit must be valid
3928     assert(sc.comp_unit);
3929     size_t types_added = 0;
3930     DWARFCompileUnit* dwarf_cu = GetDWARFCompileUnit(sc.comp_unit);
3931     if (dwarf_cu)
3932     {
3933         if (sc.function)
3934         {
3935             dw_offset_t function_die_offset = sc.function->GetID();
3936             DWARFDIE func_die = dwarf_cu->GetDIE(function_die_offset);
3937             if (func_die && func_die.HasChildren())
3938             {
3939                 types_added = ParseTypes(sc, func_die.GetFirstChild(), true, true);
3940             }
3941         }
3942         else
3943         {
3944             DWARFDIE dwarf_cu_die = dwarf_cu->DIE();
3945             if (dwarf_cu_die && dwarf_cu_die.HasChildren())
3946             {
3947                 types_added = ParseTypes(sc, dwarf_cu_die.GetFirstChild(), true, true);
3948             }
3949         }
3950     }
3951 
3952     return types_added;
3953 }
3954 
3955 size_t
3956 SymbolFileDWARF::ParseVariablesForContext (const SymbolContext& sc)
3957 {
3958     if (sc.comp_unit != NULL)
3959     {
3960         DWARFDebugInfo* info = DebugInfo();
3961         if (info == NULL)
3962             return 0;
3963 
3964         if (sc.function)
3965         {
3966             DWARFDIE function_die = info->GetDIE(DIERef(sc.function->GetID()));
3967 
3968             const dw_addr_t func_lo_pc = function_die.GetAttributeValueAsAddress (DW_AT_low_pc, LLDB_INVALID_ADDRESS);
3969             if (func_lo_pc != LLDB_INVALID_ADDRESS)
3970             {
3971                 const size_t num_variables = ParseVariables(sc, function_die.GetFirstChild(), func_lo_pc, true, true);
3972 
3973                 // Let all blocks know they have parse all their variables
3974                 sc.function->GetBlock (false).SetDidParseVariables (true, true);
3975                 return num_variables;
3976             }
3977         }
3978         else if (sc.comp_unit)
3979         {
3980             DWARFCompileUnit* dwarf_cu = info->GetCompileUnit(sc.comp_unit->GetID());
3981 
3982             if (dwarf_cu == NULL)
3983                 return 0;
3984 
3985             uint32_t vars_added = 0;
3986             VariableListSP variables (sc.comp_unit->GetVariableList(false));
3987 
3988             if (variables.get() == NULL)
3989             {
3990                 variables.reset(new VariableList());
3991                 sc.comp_unit->SetVariableList(variables);
3992 
3993                 DIEArray die_offsets;
3994                 if (m_using_apple_tables)
3995                 {
3996                     if (m_apple_names_ap.get())
3997                     {
3998                         DWARFMappedHash::DIEInfoArray hash_data_array;
3999                         if (m_apple_names_ap->AppendAllDIEsInRange (dwarf_cu->GetOffset(),
4000                                                                     dwarf_cu->GetNextCompileUnitOffset(),
4001                                                                     hash_data_array))
4002                         {
4003                             DWARFMappedHash::ExtractDIEArray (hash_data_array, die_offsets);
4004                         }
4005                     }
4006                 }
4007                 else
4008                 {
4009                     // Index if we already haven't to make sure the compile units
4010                     // get indexed and make their global DIE index list
4011                     if (!m_indexed)
4012                         Index ();
4013 
4014                     m_global_index.FindAllEntriesForCompileUnit (dwarf_cu->GetOffset(),
4015                                                                  die_offsets);
4016                 }
4017 
4018                 const size_t num_matches = die_offsets.size();
4019                 if (num_matches)
4020                 {
4021                     DWARFDebugInfo* debug_info = DebugInfo();
4022                     for (size_t i=0; i<num_matches; ++i)
4023                     {
4024                         const DIERef& die_ref = die_offsets[i];
4025                         DWARFDIE die = debug_info->GetDIE (die_ref);
4026                         if (die)
4027                         {
4028                             VariableSP var_sp (ParseVariableDIE(sc, die, LLDB_INVALID_ADDRESS));
4029                             if (var_sp)
4030                             {
4031                                 variables->AddVariableIfUnique (var_sp);
4032                                 ++vars_added;
4033                             }
4034                         }
4035                         else
4036                         {
4037                             if (m_using_apple_tables)
4038                             {
4039                                 GetObjectFile()->GetModule()->ReportErrorIfModifyDetected ("the DWARF debug information has been modified (.apple_names accelerator table had bad die 0x%8.8x)\n", die_ref.die_offset);
4040                             }
4041                         }
4042 
4043                     }
4044                 }
4045             }
4046             return vars_added;
4047         }
4048     }
4049     return 0;
4050 }
4051 
4052 VariableSP
4053 SymbolFileDWARF::ParseVariableDIE
4054 (
4055     const SymbolContext& sc,
4056     const DWARFDIE &die,
4057     const lldb::addr_t func_low_pc
4058 )
4059 {
4060     if (die.GetDWARF() != this)
4061         return die.GetDWARF()->ParseVariableDIE(sc, die, func_low_pc);
4062 
4063     VariableSP var_sp;
4064     if (!die)
4065         return var_sp;
4066 
4067     var_sp = GetDIEToVariable()[die.GetDIE()];
4068     if (var_sp)
4069         return var_sp;  // Already been parsed!
4070 
4071     const dw_tag_t tag = die.Tag();
4072     ModuleSP module = GetObjectFile()->GetModule();
4073 
4074     if ((tag == DW_TAG_variable) ||
4075         (tag == DW_TAG_constant) ||
4076         (tag == DW_TAG_formal_parameter && sc.function))
4077     {
4078         DWARFAttributes attributes;
4079         const size_t num_attributes = die.GetAttributes(attributes);
4080         DWARFDIE spec_die;
4081         if (num_attributes > 0)
4082         {
4083             const char *name = NULL;
4084             const char *mangled = NULL;
4085             Declaration decl;
4086             uint32_t i;
4087             DWARFFormValue type_die_form;
4088             DWARFExpression location(die.GetCU());
4089             bool is_external = false;
4090             bool is_artificial = false;
4091             bool location_is_const_value_data = false;
4092             bool has_explicit_location = false;
4093             DWARFFormValue const_value;
4094             //AccessType accessibility = eAccessNone;
4095 
4096             for (i=0; i<num_attributes; ++i)
4097             {
4098                 dw_attr_t attr = attributes.AttributeAtIndex(i);
4099                 DWARFFormValue form_value;
4100 
4101                 if (attributes.ExtractFormValueAtIndex(i, form_value))
4102                 {
4103                     switch (attr)
4104                     {
4105                     case DW_AT_decl_file:   decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(form_value.Unsigned())); break;
4106                     case DW_AT_decl_line:   decl.SetLine(form_value.Unsigned()); break;
4107                     case DW_AT_decl_column: decl.SetColumn(form_value.Unsigned()); break;
4108                     case DW_AT_name:        name = form_value.AsCString(); break;
4109                     case DW_AT_linkage_name:
4110                     case DW_AT_MIPS_linkage_name: mangled = form_value.AsCString(); break;
4111                     case DW_AT_type:        type_die_form = form_value; break;
4112                     case DW_AT_external:    is_external = form_value.Boolean(); break;
4113                     case DW_AT_const_value:
4114                         // If we have already found a DW_AT_location attribute, ignore this attribute.
4115                         if (!has_explicit_location)
4116                         {
4117                             location_is_const_value_data = true;
4118                             // The constant value will be either a block, a data value or a string.
4119                             const DWARFDataExtractor& debug_info_data = get_debug_info_data();
4120                             if (DWARFFormValue::IsBlockForm(form_value.Form()))
4121                             {
4122                                 // Retrieve the value as a block expression.
4123                                 uint32_t block_offset = form_value.BlockData() - debug_info_data.GetDataStart();
4124                                 uint32_t block_length = form_value.Unsigned();
4125                                 location.CopyOpcodeData(module, debug_info_data, block_offset, block_length);
4126                             }
4127                             else if (DWARFFormValue::IsDataForm(form_value.Form()))
4128                             {
4129                                 // Retrieve the value as a data expression.
4130                                 DWARFFormValue::FixedFormSizes fixed_form_sizes =
4131                                     DWARFFormValue::GetFixedFormSizesForAddressSize (
4132                                             attributes.CompileUnitAtIndex(i)->GetAddressByteSize(),
4133                                             attributes.CompileUnitAtIndex(i)->IsDWARF64());
4134                                 uint32_t data_offset = attributes.DIEOffsetAtIndex(i);
4135                                 uint32_t data_length = fixed_form_sizes.GetSize(form_value.Form());
4136                                 if (data_length == 0)
4137                                 {
4138                                     const uint8_t *data_pointer = form_value.BlockData();
4139                                     if (data_pointer)
4140                                     {
4141                                         form_value.Unsigned();
4142                                     }
4143                                     else if (DWARFFormValue::IsDataForm(form_value.Form()))
4144                                     {
4145                                         // we need to get the byte size of the type later after we create the variable
4146                                         const_value = form_value;
4147                                     }
4148                                 }
4149                                 else
4150                                     location.CopyOpcodeData(module, debug_info_data, data_offset, data_length);
4151                             }
4152                             else
4153                             {
4154                                 // Retrieve the value as a string expression.
4155                                 if (form_value.Form() == DW_FORM_strp)
4156                                 {
4157                                     DWARFFormValue::FixedFormSizes fixed_form_sizes =
4158                                         DWARFFormValue::GetFixedFormSizesForAddressSize (
4159                                                 attributes.CompileUnitAtIndex(i)->GetAddressByteSize(),
4160                                                 attributes.CompileUnitAtIndex(i)->IsDWARF64());
4161                                     uint32_t data_offset = attributes.DIEOffsetAtIndex(i);
4162                                     uint32_t data_length = fixed_form_sizes.GetSize(form_value.Form());
4163                                     location.CopyOpcodeData(module, debug_info_data, data_offset, data_length);
4164                                 }
4165                                 else
4166                                 {
4167                                     const char *str = form_value.AsCString();
4168                                     uint32_t string_offset = str - (const char *)debug_info_data.GetDataStart();
4169                                     uint32_t string_length = strlen(str) + 1;
4170                                     location.CopyOpcodeData(module, debug_info_data, string_offset, string_length);
4171                                 }
4172                             }
4173                         }
4174                         break;
4175                     case DW_AT_location:
4176                         {
4177                             location_is_const_value_data = false;
4178                             has_explicit_location = true;
4179                             if (form_value.BlockData())
4180                             {
4181                                 const DWARFDataExtractor& debug_info_data = get_debug_info_data();
4182 
4183                                 uint32_t block_offset = form_value.BlockData() - debug_info_data.GetDataStart();
4184                                 uint32_t block_length = form_value.Unsigned();
4185                                 location.CopyOpcodeData(module, get_debug_info_data(), block_offset, block_length);
4186                             }
4187                             else
4188                             {
4189                                 const DWARFDataExtractor& debug_loc_data = get_debug_loc_data();
4190                                 const dw_offset_t debug_loc_offset = form_value.Unsigned();
4191 
4192                                 size_t loc_list_length = DWARFExpression::LocationListSize(die.GetCU(), debug_loc_data, debug_loc_offset);
4193                                 if (loc_list_length > 0)
4194                                 {
4195                                     location.CopyOpcodeData(module, debug_loc_data, debug_loc_offset, loc_list_length);
4196                                     assert (func_low_pc != LLDB_INVALID_ADDRESS);
4197                                     location.SetLocationListSlide (func_low_pc - attributes.CompileUnitAtIndex(i)->GetBaseAddress());
4198                                 }
4199                             }
4200                         }
4201                         break;
4202                     case DW_AT_specification:
4203                     {
4204                         DWARFDebugInfo* debug_info = DebugInfo();
4205                         if (debug_info)
4206                             spec_die = debug_info->GetDIE(DIERef(form_value));
4207                         break;
4208                     }
4209                     case DW_AT_artificial:      is_artificial = form_value.Boolean(); break;
4210                     case DW_AT_accessibility:   break; //accessibility = DW_ACCESS_to_AccessType(form_value.Unsigned()); break;
4211                     case DW_AT_declaration:
4212                     case DW_AT_description:
4213                     case DW_AT_endianity:
4214                     case DW_AT_segment:
4215                     case DW_AT_start_scope:
4216                     case DW_AT_visibility:
4217                     default:
4218                     case DW_AT_abstract_origin:
4219                     case DW_AT_sibling:
4220                         break;
4221                     }
4222                 }
4223             }
4224 
4225             const DWARFDIE parent_context_die = GetDeclContextDIEContainingDIE(die);
4226             const dw_tag_t parent_tag = die.GetParent().Tag();
4227             bool is_static_member = parent_tag == DW_TAG_compile_unit && (parent_context_die.Tag() == DW_TAG_class_type || parent_context_die.Tag() == DW_TAG_structure_type);
4228 
4229             ValueType scope = eValueTypeInvalid;
4230 
4231             const DWARFDIE sc_parent_die = GetParentSymbolContextDIE(die);
4232             SymbolContextScope * symbol_context_scope = NULL;
4233 
4234             if (!mangled)
4235             {
4236                 // LLDB relies on the mangled name (DW_TAG_linkage_name or DW_AT_MIPS_linkage_name) to
4237                 // generate fully qualified names of global variables with commands like "frame var j".
4238                 // For example, if j were an int variable holding a value 4 and declared in a namespace
4239                 // B which in turn is contained in a namespace A, the command "frame var j" returns
4240                 // "(int) A::B::j = 4". If the compiler does not emit a linkage name, we should be able
4241                 // to generate a fully qualified name from the declaration context.
4242                 if (parent_tag == DW_TAG_compile_unit &&
4243                     Language::LanguageIsCPlusPlus(die.GetLanguage()))
4244                 {
4245                     DWARFDeclContext decl_ctx;
4246 
4247                     die.GetDWARFDeclContext(decl_ctx);
4248                     mangled = decl_ctx.GetQualifiedNameAsConstString().GetCString();
4249                 }
4250             }
4251 
4252             // DWARF doesn't specify if a DW_TAG_variable is a local, global
4253             // or static variable, so we have to do a little digging by
4254             // looking at the location of a variable to see if it contains
4255             // a DW_OP_addr opcode _somewhere_ in the definition. I say
4256             // somewhere because clang likes to combine small global variables
4257             // into the same symbol and have locations like:
4258             // DW_OP_addr(0x1000), DW_OP_constu(2), DW_OP_plus
4259             // So if we don't have a DW_TAG_formal_parameter, we can look at
4260             // the location to see if it contains a DW_OP_addr opcode, and
4261             // then we can correctly classify  our variables.
4262             if (tag == DW_TAG_formal_parameter)
4263                 scope = eValueTypeVariableArgument;
4264             else
4265             {
4266                 bool op_error = false;
4267                 // Check if the location has a DW_OP_addr with any address value...
4268                 lldb::addr_t location_DW_OP_addr = LLDB_INVALID_ADDRESS;
4269                 if (!location_is_const_value_data)
4270                 {
4271                     location_DW_OP_addr = location.GetLocation_DW_OP_addr (0, op_error);
4272                     if (op_error)
4273                     {
4274                         StreamString strm;
4275                         location.DumpLocationForAddress (&strm, eDescriptionLevelFull, 0, 0, NULL);
4276                         GetObjectFile()->GetModule()->ReportError ("0x%8.8x: %s has an invalid location: %s", die.GetOffset(), die.GetTagAsCString(), strm.GetString().c_str());
4277                     }
4278                 }
4279 
4280                 if (location_DW_OP_addr != LLDB_INVALID_ADDRESS)
4281                 {
4282                     if (is_external)
4283                         scope = eValueTypeVariableGlobal;
4284                     else
4285                         scope = eValueTypeVariableStatic;
4286 
4287 
4288                     SymbolFileDWARFDebugMap *debug_map_symfile = GetDebugMapSymfile ();
4289 
4290                     if (debug_map_symfile)
4291                     {
4292                         // When leaving the DWARF in the .o files on darwin,
4293                         // when we have a global variable that wasn't initialized,
4294                         // the .o file might not have allocated a virtual
4295                         // address for the global variable. In this case it will
4296                         // have created a symbol for the global variable
4297                         // that is undefined/data and external and the value will
4298                         // be the byte size of the variable. When we do the
4299                         // address map in SymbolFileDWARFDebugMap we rely on
4300                         // having an address, we need to do some magic here
4301                         // so we can get the correct address for our global
4302                         // variable. The address for all of these entries
4303                         // will be zero, and there will be an undefined symbol
4304                         // in this object file, and the executable will have
4305                         // a matching symbol with a good address. So here we
4306                         // dig up the correct address and replace it in the
4307                         // location for the variable, and set the variable's
4308                         // symbol context scope to be that of the main executable
4309                         // so the file address will resolve correctly.
4310                         bool linked_oso_file_addr = false;
4311                         if (is_external && location_DW_OP_addr == 0)
4312                         {
4313                             // we have a possible uninitialized extern global
4314                             ConstString const_name(mangled ? mangled : name);
4315                             ObjectFile *debug_map_objfile = debug_map_symfile->GetObjectFile();
4316                             if (debug_map_objfile)
4317                             {
4318                                 Symtab *debug_map_symtab = debug_map_objfile->GetSymtab();
4319                                 if (debug_map_symtab)
4320                                 {
4321                                     Symbol *exe_symbol = debug_map_symtab->FindFirstSymbolWithNameAndType (const_name,
4322                                                                                                            eSymbolTypeData,
4323                                                                                                            Symtab::eDebugYes,
4324                                                                                                            Symtab::eVisibilityExtern);
4325                                     if (exe_symbol)
4326                                     {
4327                                         if (exe_symbol->ValueIsAddress())
4328                                         {
4329                                             const addr_t exe_file_addr = exe_symbol->GetAddressRef().GetFileAddress();
4330                                             if (exe_file_addr != LLDB_INVALID_ADDRESS)
4331                                             {
4332                                                 if (location.Update_DW_OP_addr (exe_file_addr))
4333                                                 {
4334                                                     linked_oso_file_addr = true;
4335                                                     symbol_context_scope = exe_symbol;
4336                                                 }
4337                                             }
4338                                         }
4339                                     }
4340                                 }
4341                             }
4342                         }
4343 
4344                         if (!linked_oso_file_addr)
4345                         {
4346                             // The DW_OP_addr is not zero, but it contains a .o file address which
4347                             // needs to be linked up correctly.
4348                             const lldb::addr_t exe_file_addr = debug_map_symfile->LinkOSOFileAddress(this, location_DW_OP_addr);
4349                             if (exe_file_addr != LLDB_INVALID_ADDRESS)
4350                             {
4351                                 // Update the file address for this variable
4352                                 location.Update_DW_OP_addr (exe_file_addr);
4353                             }
4354                             else
4355                             {
4356                                 // Variable didn't make it into the final executable
4357                                 return var_sp;
4358                             }
4359                         }
4360                     }
4361                 }
4362                 else
4363                 {
4364                     if (location_is_const_value_data)
4365                         scope = eValueTypeVariableStatic;
4366                     else
4367                         scope = eValueTypeVariableLocal;
4368                 }
4369             }
4370 
4371             if (symbol_context_scope == NULL)
4372             {
4373                 switch (parent_tag)
4374                 {
4375                 case DW_TAG_subprogram:
4376                 case DW_TAG_inlined_subroutine:
4377                 case DW_TAG_lexical_block:
4378                     if (sc.function)
4379                     {
4380                         symbol_context_scope = sc.function->GetBlock(true).FindBlockByID(sc_parent_die.GetID());
4381                         if (symbol_context_scope == NULL)
4382                             symbol_context_scope = sc.function;
4383                     }
4384                     break;
4385 
4386                 default:
4387                     symbol_context_scope = sc.comp_unit;
4388                     break;
4389                 }
4390             }
4391 
4392             if (symbol_context_scope)
4393             {
4394                 SymbolFileTypeSP type_sp(new SymbolFileType(*this, DIERef(type_die_form).GetUID()));
4395 
4396                 if (const_value.Form() && type_sp && type_sp->GetType())
4397                     location.CopyOpcodeData(const_value.Unsigned(), type_sp->GetType()->GetByteSize(), die.GetCU()->GetAddressByteSize());
4398 
4399                 var_sp.reset (new Variable (die.GetID(),
4400                                             name,
4401                                             mangled,
4402                                             type_sp,
4403                                             scope,
4404                                             symbol_context_scope,
4405                                             &decl,
4406                                             location,
4407                                             is_external,
4408                                             is_artificial,
4409                                             is_static_member));
4410 
4411                 var_sp->SetLocationIsConstantValueData (location_is_const_value_data);
4412             }
4413             else
4414             {
4415                 // Not ready to parse this variable yet. It might be a global
4416                 // or static variable that is in a function scope and the function
4417                 // in the symbol context wasn't filled in yet
4418                 return var_sp;
4419             }
4420         }
4421         // Cache var_sp even if NULL (the variable was just a specification or
4422         // was missing vital information to be able to be displayed in the debugger
4423         // (missing location due to optimization, etc)) so we don't re-parse
4424         // this DIE over and over later...
4425         GetDIEToVariable()[die.GetDIE()] = var_sp;
4426         if (spec_die)
4427             GetDIEToVariable()[spec_die.GetDIE()] = var_sp;
4428     }
4429     return var_sp;
4430 }
4431 
4432 
4433 DWARFDIE
4434 SymbolFileDWARF::FindBlockContainingSpecification (const DIERef& func_die_ref,
4435                                                    dw_offset_t spec_block_die_offset)
4436 {
4437     // Give the concrete function die specified by "func_die_offset", find the
4438     // concrete block whose DW_AT_specification or DW_AT_abstract_origin points
4439     // to "spec_block_die_offset"
4440     return FindBlockContainingSpecification (DebugInfo()->GetDIE (func_die_ref), spec_block_die_offset);
4441 }
4442 
4443 
4444 DWARFDIE
4445 SymbolFileDWARF::FindBlockContainingSpecification(const DWARFDIE &die,
4446                                                   dw_offset_t spec_block_die_offset)
4447 {
4448     if (die)
4449     {
4450         switch (die.Tag())
4451         {
4452         case DW_TAG_subprogram:
4453         case DW_TAG_inlined_subroutine:
4454         case DW_TAG_lexical_block:
4455             {
4456                 if (die.GetAttributeValueAsReference (DW_AT_specification, DW_INVALID_OFFSET) == spec_block_die_offset)
4457                     return die;
4458 
4459                 if (die.GetAttributeValueAsReference (DW_AT_abstract_origin, DW_INVALID_OFFSET) == spec_block_die_offset)
4460                     return die;
4461             }
4462             break;
4463         }
4464 
4465         // Give the concrete function die specified by "func_die_offset", find the
4466         // concrete block whose DW_AT_specification or DW_AT_abstract_origin points
4467         // to "spec_block_die_offset"
4468         for (DWARFDIE child_die = die.GetFirstChild(); child_die; child_die = child_die.GetSibling())
4469         {
4470             DWARFDIE result_die = FindBlockContainingSpecification (child_die, spec_block_die_offset);
4471             if (result_die)
4472                 return result_die;
4473         }
4474     }
4475 
4476     return DWARFDIE();
4477 }
4478 
4479 size_t
4480 SymbolFileDWARF::ParseVariables (const SymbolContext& sc,
4481                                  const DWARFDIE &orig_die,
4482                                  const lldb::addr_t func_low_pc,
4483                                  bool parse_siblings,
4484                                  bool parse_children,
4485                                  VariableList* cc_variable_list)
4486 {
4487     if (!orig_die)
4488         return 0;
4489 
4490     VariableListSP variable_list_sp;
4491 
4492     size_t vars_added = 0;
4493     DWARFDIE die = orig_die;
4494     while (die)
4495     {
4496         dw_tag_t tag = die.Tag();
4497 
4498         // Check to see if we have already parsed this variable or constant?
4499         VariableSP var_sp = GetDIEToVariable()[die.GetDIE()];
4500         if (var_sp)
4501         {
4502             if (cc_variable_list)
4503                 cc_variable_list->AddVariableIfUnique (var_sp);
4504         }
4505         else
4506         {
4507             // We haven't already parsed it, lets do that now.
4508             if ((tag == DW_TAG_variable) ||
4509                 (tag == DW_TAG_constant) ||
4510                 (tag == DW_TAG_formal_parameter && sc.function))
4511             {
4512                 if (variable_list_sp.get() == NULL)
4513                 {
4514                     DWARFDIE sc_parent_die = GetParentSymbolContextDIE(orig_die);
4515                     dw_tag_t parent_tag = sc_parent_die.Tag();
4516                     switch (parent_tag)
4517                     {
4518                         case DW_TAG_compile_unit:
4519                             if (sc.comp_unit != NULL)
4520                             {
4521                                 variable_list_sp = sc.comp_unit->GetVariableList(false);
4522                                 if (variable_list_sp.get() == NULL)
4523                                 {
4524                                     variable_list_sp.reset(new VariableList());
4525                                     sc.comp_unit->SetVariableList(variable_list_sp);
4526                                 }
4527                             }
4528                             else
4529                             {
4530                                 GetObjectFile()->GetModule()->ReportError ("parent 0x%8.8" PRIx64 " %s with no valid compile unit in symbol context for 0x%8.8" PRIx64 " %s.\n",
4531                                                                            sc_parent_die.GetID(),
4532                                                                            sc_parent_die.GetTagAsCString(),
4533                                                                            orig_die.GetID(),
4534                                                                            orig_die.GetTagAsCString());
4535                             }
4536                             break;
4537 
4538                         case DW_TAG_subprogram:
4539                         case DW_TAG_inlined_subroutine:
4540                         case DW_TAG_lexical_block:
4541                             if (sc.function != NULL)
4542                             {
4543                                 // Check to see if we already have parsed the variables for the given scope
4544 
4545                                 Block *block = sc.function->GetBlock(true).FindBlockByID(sc_parent_die.GetID());
4546                                 if (block == NULL)
4547                                 {
4548                                     // This must be a specification or abstract origin with
4549                                     // a concrete block counterpart in the current function. We need
4550                                     // to find the concrete block so we can correctly add the
4551                                     // variable to it
4552                                     const DWARFDIE concrete_block_die = FindBlockContainingSpecification (DIERef(sc.function->GetID()),
4553                                                                                                           sc_parent_die.GetOffset());
4554                                     if (concrete_block_die)
4555                                         block = sc.function->GetBlock(true).FindBlockByID(concrete_block_die.GetID());
4556                                 }
4557 
4558                                 if (block != NULL)
4559                                 {
4560                                     const bool can_create = false;
4561                                     variable_list_sp = block->GetBlockVariableList (can_create);
4562                                     if (variable_list_sp.get() == NULL)
4563                                     {
4564                                         variable_list_sp.reset(new VariableList());
4565                                         block->SetVariableList(variable_list_sp);
4566                                     }
4567                                 }
4568                             }
4569                             break;
4570 
4571                         default:
4572                              GetObjectFile()->GetModule()->ReportError ("didn't find appropriate parent DIE for variable list for 0x%8.8" PRIx64 " %s.\n",
4573                                                                         orig_die.GetID(),
4574                                                                         orig_die.GetTagAsCString());
4575                             break;
4576                     }
4577                 }
4578 
4579                 if (variable_list_sp)
4580                 {
4581                     VariableSP var_sp (ParseVariableDIE(sc, die, func_low_pc));
4582                     if (var_sp)
4583                     {
4584                         variable_list_sp->AddVariableIfUnique (var_sp);
4585                         if (cc_variable_list)
4586                             cc_variable_list->AddVariableIfUnique (var_sp);
4587                         ++vars_added;
4588                     }
4589                 }
4590             }
4591         }
4592 
4593         bool skip_children = (sc.function == NULL && tag == DW_TAG_subprogram);
4594 
4595         if (!skip_children && parse_children && die.HasChildren())
4596         {
4597             vars_added += ParseVariables(sc, die.GetFirstChild(), func_low_pc, true, true, cc_variable_list);
4598         }
4599 
4600         if (parse_siblings)
4601             die = die.GetSibling();
4602         else
4603             die.Clear();
4604     }
4605     return vars_added;
4606 }
4607 
4608 //------------------------------------------------------------------
4609 // PluginInterface protocol
4610 //------------------------------------------------------------------
4611 ConstString
4612 SymbolFileDWARF::GetPluginName()
4613 {
4614     return GetPluginNameStatic();
4615 }
4616 
4617 uint32_t
4618 SymbolFileDWARF::GetPluginVersion()
4619 {
4620     return 1;
4621 }
4622 
4623 void
4624 SymbolFileDWARF::DumpIndexes ()
4625 {
4626     StreamFile s(stdout, false);
4627 
4628     s.Printf ("DWARF index for (%s) '%s':",
4629               GetObjectFile()->GetModule()->GetArchitecture().GetArchitectureName(),
4630               GetObjectFile()->GetFileSpec().GetPath().c_str());
4631     s.Printf("\nFunction basenames:\n");    m_function_basename_index.Dump (&s);
4632     s.Printf("\nFunction fullnames:\n");    m_function_fullname_index.Dump (&s);
4633     s.Printf("\nFunction methods:\n");      m_function_method_index.Dump (&s);
4634     s.Printf("\nFunction selectors:\n");    m_function_selector_index.Dump (&s);
4635     s.Printf("\nObjective C class selectors:\n");    m_objc_class_selectors_index.Dump (&s);
4636     s.Printf("\nGlobals and statics:\n");   m_global_index.Dump (&s);
4637     s.Printf("\nTypes:\n");                 m_type_index.Dump (&s);
4638     s.Printf("\nNamespaces:\n");            m_namespace_index.Dump (&s);
4639 }
4640 
4641 
4642 SymbolFileDWARFDebugMap *
4643 SymbolFileDWARF::GetDebugMapSymfile ()
4644 {
4645     if (m_debug_map_symfile == NULL && !m_debug_map_module_wp.expired())
4646     {
4647         lldb::ModuleSP module_sp (m_debug_map_module_wp.lock());
4648         if (module_sp)
4649         {
4650             SymbolVendor *sym_vendor = module_sp->GetSymbolVendor();
4651             if (sym_vendor)
4652                 m_debug_map_symfile = (SymbolFileDWARFDebugMap *)sym_vendor->GetSymbolFile();
4653         }
4654     }
4655     return m_debug_map_symfile;
4656 }
4657 
4658 DWARFExpression::LocationListFormat
4659 SymbolFileDWARF::GetLocationListFormat() const
4660 {
4661     return DWARFExpression::RegularLocationList;
4662 }
4663