1 //===-- DWARFASTParserClang.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 <stdlib.h>
11 
12 #include "DWARFASTParserClang.h"
13 #include "DWARFCompileUnit.h"
14 #include "DWARFDIE.h"
15 #include "DWARFDIECollection.h"
16 #include "DWARFDebugInfo.h"
17 #include "DWARFDeclContext.h"
18 #include "DWARFDefines.h"
19 #include "SymbolFileDWARF.h"
20 #include "SymbolFileDWARFDebugMap.h"
21 #include "UniqueDWARFASTType.h"
22 
23 #include "Plugins/Language/ObjC/ObjCLanguage.h"
24 #include "lldb/Core/Log.h"
25 #include "lldb/Core/Module.h"
26 #include "lldb/Core/StreamString.h"
27 #include "lldb/Core/Value.h"
28 #include "lldb/Host/Host.h"
29 #include "lldb/Interpreter/Args.h"
30 #include "lldb/Symbol/ClangASTImporter.h"
31 #include "lldb/Symbol/ClangExternalASTSourceCommon.h"
32 #include "lldb/Symbol/ClangUtil.h"
33 #include "lldb/Symbol/CompileUnit.h"
34 #include "lldb/Symbol/Function.h"
35 #include "lldb/Symbol/ObjectFile.h"
36 #include "lldb/Symbol/SymbolVendor.h"
37 #include "lldb/Symbol/TypeList.h"
38 #include "lldb/Symbol/TypeMap.h"
39 #include "lldb/Target/Language.h"
40 #include "lldb/Utility/LLDBAssert.h"
41 
42 #include "clang/AST/DeclCXX.h"
43 #include "clang/AST/DeclObjC.h"
44 
45 #include <map>
46 #include <vector>
47 
48 //#define ENABLE_DEBUG_PRINTF // COMMENT OUT THIS LINE PRIOR TO CHECKIN
49 
50 #ifdef ENABLE_DEBUG_PRINTF
51 #include <stdio.h>
52 #define DEBUG_PRINTF(fmt, ...) printf(fmt, __VA_ARGS__)
53 #else
54 #define DEBUG_PRINTF(fmt, ...)
55 #endif
56 
57 using namespace lldb;
58 using namespace lldb_private;
59 DWARFASTParserClang::DWARFASTParserClang(ClangASTContext &ast)
60     : m_ast(ast), m_die_to_decl_ctx(), m_decl_ctx_to_die() {}
61 
62 DWARFASTParserClang::~DWARFASTParserClang() {}
63 
64 static AccessType DW_ACCESS_to_AccessType(uint32_t dwarf_accessibility) {
65   switch (dwarf_accessibility) {
66   case DW_ACCESS_public:
67     return eAccessPublic;
68   case DW_ACCESS_private:
69     return eAccessPrivate;
70   case DW_ACCESS_protected:
71     return eAccessProtected;
72   default:
73     break;
74   }
75   return eAccessNone;
76 }
77 
78 static bool DeclKindIsCXXClass(clang::Decl::Kind decl_kind) {
79   switch (decl_kind) {
80   case clang::Decl::CXXRecord:
81   case clang::Decl::ClassTemplateSpecialization:
82     return true;
83   default:
84     break;
85   }
86   return false;
87 }
88 
89 struct BitfieldInfo {
90   uint64_t bit_size;
91   uint64_t bit_offset;
92 
93   BitfieldInfo()
94       : bit_size(LLDB_INVALID_ADDRESS), bit_offset(LLDB_INVALID_ADDRESS) {}
95 
96   void Clear() {
97     bit_size = LLDB_INVALID_ADDRESS;
98     bit_offset = LLDB_INVALID_ADDRESS;
99   }
100 
101   bool IsValid() const {
102     return (bit_size != LLDB_INVALID_ADDRESS) &&
103            (bit_offset != LLDB_INVALID_ADDRESS);
104   }
105 
106   bool NextBitfieldOffsetIsValid(const uint64_t next_bit_offset) const {
107     if (IsValid()) {
108       // This bitfield info is valid, so any subsequent bitfields
109       // must not overlap and must be at a higher bit offset than
110       // any previous bitfield + size.
111       return (bit_size + bit_offset) <= next_bit_offset;
112     } else {
113       // If the this BitfieldInfo is not valid, then any offset isOK
114       return true;
115     }
116   }
117 };
118 
119 ClangASTImporter &DWARFASTParserClang::GetClangASTImporter() {
120   if (!m_clang_ast_importer_ap) {
121     m_clang_ast_importer_ap.reset(new ClangASTImporter);
122   }
123   return *m_clang_ast_importer_ap;
124 }
125 
126 TypeSP DWARFASTParserClang::ParseTypeFromDWO(const DWARFDIE &die, Log *log) {
127   ModuleSP dwo_module_sp = die.GetContainingDWOModule();
128   if (dwo_module_sp) {
129     // This type comes from an external DWO module
130     std::vector<CompilerContext> dwo_context;
131     die.GetDWOContext(dwo_context);
132     TypeMap dwo_types;
133     if (dwo_module_sp->GetSymbolVendor()->FindTypes(dwo_context, true,
134                                                     dwo_types)) {
135       const size_t num_dwo_types = dwo_types.GetSize();
136       if (num_dwo_types == 1) {
137         // We found a real definition for this type elsewhere
138         // so lets use it and cache the fact that we found
139         // a complete type for this die
140         TypeSP dwo_type_sp = dwo_types.GetTypeAtIndex(0);
141         if (dwo_type_sp) {
142           lldb_private::CompilerType dwo_type =
143               dwo_type_sp->GetForwardCompilerType();
144 
145           lldb_private::CompilerType type =
146               GetClangASTImporter().CopyType(m_ast, dwo_type);
147 
148           // printf ("copied_qual_type: ast = %p, clang_type = %p, name =
149           // '%s'\n", m_ast, copied_qual_type.getAsOpaquePtr(),
150           // external_type->GetName().GetCString());
151           if (type) {
152             SymbolFileDWARF *dwarf = die.GetDWARF();
153             TypeSP type_sp(new Type(die.GetID(), dwarf, dwo_type_sp->GetName(),
154                                     dwo_type_sp->GetByteSize(), NULL,
155                                     LLDB_INVALID_UID, Type::eEncodingInvalid,
156                                     &dwo_type_sp->GetDeclaration(), type,
157                                     Type::eResolveStateForward));
158 
159             dwarf->GetTypeList()->Insert(type_sp);
160             dwarf->GetDIEToType()[die.GetDIE()] = type_sp.get();
161             clang::TagDecl *tag_decl = ClangASTContext::GetAsTagDecl(type);
162             if (tag_decl)
163               LinkDeclContextToDIE(tag_decl, die);
164             else {
165               clang::DeclContext *defn_decl_ctx =
166                   GetCachedClangDeclContextForDIE(die);
167               if (defn_decl_ctx)
168                 LinkDeclContextToDIE(defn_decl_ctx, die);
169             }
170             return type_sp;
171           }
172         }
173       }
174     }
175   }
176   return TypeSP();
177 }
178 
179 TypeSP DWARFASTParserClang::ParseTypeFromDWARF(const SymbolContext &sc,
180                                                const DWARFDIE &die, Log *log,
181                                                bool *type_is_new_ptr) {
182   TypeSP type_sp;
183 
184   if (type_is_new_ptr)
185     *type_is_new_ptr = false;
186 
187   AccessType accessibility = eAccessNone;
188   if (die) {
189     SymbolFileDWARF *dwarf = die.GetDWARF();
190     if (log) {
191       DWARFDIE context_die;
192       clang::DeclContext *context =
193           GetClangDeclContextContainingDIE(die, &context_die);
194 
195       dwarf->GetObjectFile()->GetModule()->LogMessage(
196           log, "SymbolFileDWARF::ParseType (die = 0x%8.8x, decl_ctx = %p (die "
197                "0x%8.8x)) %s name = '%s')",
198           die.GetOffset(), static_cast<void *>(context),
199           context_die.GetOffset(), die.GetTagAsCString(), die.GetName());
200     }
201     //
202     //        Log *log (LogChannelDWARF::GetLogIfAll(DWARF_LOG_DEBUG_INFO));
203     //        if (log && dwarf_cu)
204     //        {
205     //            StreamString s;
206     //            die->DumpLocation (this, dwarf_cu, s);
207     //            dwarf->GetObjectFile()->GetModule()->LogMessage (log,
208     //            "SymbolFileDwarf::%s %s", __FUNCTION__, s.GetData());
209     //
210     //        }
211 
212     Type *type_ptr = dwarf->GetDIEToType().lookup(die.GetDIE());
213     TypeList *type_list = dwarf->GetTypeList();
214     if (type_ptr == NULL) {
215       if (type_is_new_ptr)
216         *type_is_new_ptr = true;
217 
218       const dw_tag_t tag = die.Tag();
219 
220       bool is_forward_declaration = false;
221       DWARFAttributes attributes;
222       const char *type_name_cstr = NULL;
223       ConstString type_name_const_str;
224       Type::ResolveState resolve_state = Type::eResolveStateUnresolved;
225       uint64_t byte_size = 0;
226       Declaration decl;
227 
228       Type::EncodingDataType encoding_data_type = Type::eEncodingIsUID;
229       CompilerType clang_type;
230       DWARFFormValue form_value;
231 
232       dw_attr_t attr;
233 
234       switch (tag) {
235       case DW_TAG_typedef:
236       case DW_TAG_base_type:
237       case DW_TAG_pointer_type:
238       case DW_TAG_reference_type:
239       case DW_TAG_rvalue_reference_type:
240       case DW_TAG_const_type:
241       case DW_TAG_restrict_type:
242       case DW_TAG_volatile_type:
243       case DW_TAG_unspecified_type: {
244         // Set a bit that lets us know that we are currently parsing this
245         dwarf->GetDIEToType()[die.GetDIE()] = DIE_IS_BEING_PARSED;
246 
247         const size_t num_attributes = die.GetAttributes(attributes);
248         uint32_t encoding = 0;
249         DWARFFormValue encoding_uid;
250 
251         if (num_attributes > 0) {
252           uint32_t i;
253           for (i = 0; i < num_attributes; ++i) {
254             attr = attributes.AttributeAtIndex(i);
255             if (attributes.ExtractFormValueAtIndex(i, form_value)) {
256               switch (attr) {
257               case DW_AT_decl_file:
258                 decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
259                     form_value.Unsigned()));
260                 break;
261               case DW_AT_decl_line:
262                 decl.SetLine(form_value.Unsigned());
263                 break;
264               case DW_AT_decl_column:
265                 decl.SetColumn(form_value.Unsigned());
266                 break;
267               case DW_AT_name:
268 
269                 type_name_cstr = form_value.AsCString();
270                 // Work around a bug in llvm-gcc where they give a name to a
271                 // reference type which doesn't
272                 // include the "&"...
273                 if (tag == DW_TAG_reference_type) {
274                   if (strchr(type_name_cstr, '&') == NULL)
275                     type_name_cstr = NULL;
276                 }
277                 if (type_name_cstr)
278                   type_name_const_str.SetCString(type_name_cstr);
279                 break;
280               case DW_AT_byte_size:
281                 byte_size = form_value.Unsigned();
282                 break;
283               case DW_AT_encoding:
284                 encoding = form_value.Unsigned();
285                 break;
286               case DW_AT_type:
287                 encoding_uid = form_value;
288                 break;
289               default:
290               case DW_AT_sibling:
291                 break;
292               }
293             }
294           }
295         }
296 
297         if (tag == DW_TAG_typedef && encoding_uid.IsValid()) {
298           // Try to parse a typedef from the DWO file first as modules
299           // can contain typedef'ed structures that have no names like:
300           //
301           //  typedef struct { int a; } Foo;
302           //
303           // In this case we will have a structure with no name and a
304           // typedef named "Foo" that points to this unnamed structure.
305           // The name in the typedef is the only identifier for the struct,
306           // so always try to get typedefs from DWO files if possible.
307           //
308           // The type_sp returned will be empty if the typedef doesn't exist
309           // in a DWO file, so it is cheap to call this function just to check.
310           //
311           // If we don't do this we end up creating a TypeSP that says this
312           // is a typedef to type 0x123 (the DW_AT_type value would be 0x123
313           // in the DW_TAG_typedef), and this is the unnamed structure type.
314           // We will have a hard time tracking down an unnammed structure
315           // type in the module DWO file, so we make sure we don't get into
316           // this situation by always resolving typedefs from the DWO file.
317           const DWARFDIE encoding_die = dwarf->GetDIE(DIERef(encoding_uid));
318 
319           // First make sure that the die that this is typedef'ed to _is_
320           // just a declaration (DW_AT_declaration == 1), not a full definition
321           // since template types can't be represented in modules since only
322           // concrete instances of templates are ever emitted and modules
323           // won't contain those
324           if (encoding_die &&
325               encoding_die.GetAttributeValueAsUnsigned(DW_AT_declaration, 0) ==
326                   1) {
327             type_sp = ParseTypeFromDWO(die, log);
328             if (type_sp)
329               return type_sp;
330           }
331         }
332 
333         DEBUG_PRINTF("0x%8.8" PRIx64 ": %s (\"%s\") type => 0x%8.8lx\n",
334                      die.GetID(), DW_TAG_value_to_name(tag), type_name_cstr,
335                      encoding_uid.Reference());
336 
337         switch (tag) {
338         default:
339           break;
340 
341         case DW_TAG_unspecified_type:
342           if (strcmp(type_name_cstr, "nullptr_t") == 0 ||
343               strcmp(type_name_cstr, "decltype(nullptr)") == 0) {
344             resolve_state = Type::eResolveStateFull;
345             clang_type = m_ast.GetBasicType(eBasicTypeNullPtr);
346             break;
347           }
348           // Fall through to base type below in case we can handle the type
349           // there...
350           LLVM_FALLTHROUGH;
351 
352         case DW_TAG_base_type:
353           resolve_state = Type::eResolveStateFull;
354           clang_type = m_ast.GetBuiltinTypeForDWARFEncodingAndBitSize(
355               type_name_cstr, encoding, byte_size * 8);
356           break;
357 
358         case DW_TAG_pointer_type:
359           encoding_data_type = Type::eEncodingIsPointerUID;
360           break;
361         case DW_TAG_reference_type:
362           encoding_data_type = Type::eEncodingIsLValueReferenceUID;
363           break;
364         case DW_TAG_rvalue_reference_type:
365           encoding_data_type = Type::eEncodingIsRValueReferenceUID;
366           break;
367         case DW_TAG_typedef:
368           encoding_data_type = Type::eEncodingIsTypedefUID;
369           break;
370         case DW_TAG_const_type:
371           encoding_data_type = Type::eEncodingIsConstUID;
372           break;
373         case DW_TAG_restrict_type:
374           encoding_data_type = Type::eEncodingIsRestrictUID;
375           break;
376         case DW_TAG_volatile_type:
377           encoding_data_type = Type::eEncodingIsVolatileUID;
378           break;
379         }
380 
381         if (!clang_type &&
382             (encoding_data_type == Type::eEncodingIsPointerUID ||
383              encoding_data_type == Type::eEncodingIsTypedefUID) &&
384             sc.comp_unit != NULL) {
385           if (tag == DW_TAG_pointer_type) {
386             DWARFDIE target_die = die.GetReferencedDIE(DW_AT_type);
387 
388             if (target_die.GetAttributeValueAsUnsigned(DW_AT_APPLE_block, 0)) {
389               // Blocks have a __FuncPtr inside them which is a pointer to a
390               // function of the proper type.
391 
392               for (DWARFDIE child_die = target_die.GetFirstChild();
393                    child_die.IsValid(); child_die = child_die.GetSibling()) {
394                 if (!strcmp(child_die.GetAttributeValueAsString(DW_AT_name, ""),
395                             "__FuncPtr")) {
396                   DWARFDIE function_pointer_type =
397                       child_die.GetReferencedDIE(DW_AT_type);
398 
399                   if (function_pointer_type) {
400                     DWARFDIE function_type =
401                         function_pointer_type.GetReferencedDIE(DW_AT_type);
402 
403                     bool function_type_is_new_pointer;
404                     TypeSP lldb_function_type_sp = ParseTypeFromDWARF(
405                         sc, function_type, log, &function_type_is_new_pointer);
406 
407                     if (lldb_function_type_sp) {
408                       clang_type = m_ast.CreateBlockPointerType(
409                           lldb_function_type_sp->GetForwardCompilerType());
410                       encoding_data_type = Type::eEncodingIsUID;
411                       encoding_uid.Clear();
412                       resolve_state = Type::eResolveStateFull;
413                     }
414                   }
415 
416                   break;
417                 }
418               }
419             }
420           }
421 
422           bool translation_unit_is_objc =
423               (sc.comp_unit->GetLanguage() == eLanguageTypeObjC ||
424                sc.comp_unit->GetLanguage() == eLanguageTypeObjC_plus_plus);
425 
426           if (translation_unit_is_objc) {
427             if (type_name_cstr != NULL) {
428               static ConstString g_objc_type_name_id("id");
429               static ConstString g_objc_type_name_Class("Class");
430               static ConstString g_objc_type_name_selector("SEL");
431 
432               if (type_name_const_str == g_objc_type_name_id) {
433                 if (log)
434                   dwarf->GetObjectFile()->GetModule()->LogMessage(
435                       log, "SymbolFileDWARF::ParseType (die = 0x%8.8x) %s '%s' "
436                            "is Objective C 'id' built-in type.",
437                       die.GetOffset(), die.GetTagAsCString(), die.GetName());
438                 clang_type = m_ast.GetBasicType(eBasicTypeObjCID);
439                 encoding_data_type = Type::eEncodingIsUID;
440                 encoding_uid.Clear();
441                 resolve_state = Type::eResolveStateFull;
442 
443               } else if (type_name_const_str == g_objc_type_name_Class) {
444                 if (log)
445                   dwarf->GetObjectFile()->GetModule()->LogMessage(
446                       log, "SymbolFileDWARF::ParseType (die = 0x%8.8x) %s '%s' "
447                            "is Objective C 'Class' built-in type.",
448                       die.GetOffset(), die.GetTagAsCString(), die.GetName());
449                 clang_type = m_ast.GetBasicType(eBasicTypeObjCClass);
450                 encoding_data_type = Type::eEncodingIsUID;
451                 encoding_uid.Clear();
452                 resolve_state = Type::eResolveStateFull;
453               } else if (type_name_const_str == g_objc_type_name_selector) {
454                 if (log)
455                   dwarf->GetObjectFile()->GetModule()->LogMessage(
456                       log, "SymbolFileDWARF::ParseType (die = 0x%8.8x) %s '%s' "
457                            "is Objective C 'selector' built-in type.",
458                       die.GetOffset(), die.GetTagAsCString(), die.GetName());
459                 clang_type = m_ast.GetBasicType(eBasicTypeObjCSel);
460                 encoding_data_type = Type::eEncodingIsUID;
461                 encoding_uid.Clear();
462                 resolve_state = Type::eResolveStateFull;
463               }
464             } else if (encoding_data_type == Type::eEncodingIsPointerUID &&
465                        encoding_uid.IsValid()) {
466               // Clang sometimes erroneously emits id as objc_object*.  In that
467               // case we fix up the type to "id".
468 
469               const DWARFDIE encoding_die = dwarf->GetDIE(DIERef(encoding_uid));
470 
471               if (encoding_die && encoding_die.Tag() == DW_TAG_structure_type) {
472                 if (const char *struct_name = encoding_die.GetName()) {
473                   if (!strcmp(struct_name, "objc_object")) {
474                     if (log)
475                       dwarf->GetObjectFile()->GetModule()->LogMessage(
476                           log, "SymbolFileDWARF::ParseType (die = 0x%8.8x) %s "
477                                "'%s' is 'objc_object*', which we overrode to "
478                                "'id'.",
479                           die.GetOffset(), die.GetTagAsCString(),
480                           die.GetName());
481                     clang_type = m_ast.GetBasicType(eBasicTypeObjCID);
482                     encoding_data_type = Type::eEncodingIsUID;
483                     encoding_uid.Clear();
484                     resolve_state = Type::eResolveStateFull;
485                   }
486                 }
487               }
488             }
489           }
490         }
491 
492         type_sp.reset(
493             new Type(die.GetID(), dwarf, type_name_const_str, byte_size, NULL,
494                      DIERef(encoding_uid).GetUID(dwarf), encoding_data_type,
495                      &decl, clang_type, resolve_state));
496 
497         dwarf->GetDIEToType()[die.GetDIE()] = type_sp.get();
498 
499         //                  Type* encoding_type =
500         //                  GetUniquedTypeForDIEOffset(encoding_uid, type_sp,
501         //                  NULL, 0, 0, false);
502         //                  if (encoding_type != NULL)
503         //                  {
504         //                      if (encoding_type != DIE_IS_BEING_PARSED)
505         //                          type_sp->SetEncodingType(encoding_type);
506         //                      else
507         //                          m_indirect_fixups.push_back(type_sp.get());
508         //                  }
509       } break;
510 
511       case DW_TAG_structure_type:
512       case DW_TAG_union_type:
513       case DW_TAG_class_type: {
514         // Set a bit that lets us know that we are currently parsing this
515         dwarf->GetDIEToType()[die.GetDIE()] = DIE_IS_BEING_PARSED;
516         bool byte_size_valid = false;
517 
518         LanguageType class_language = eLanguageTypeUnknown;
519         bool is_complete_objc_class = false;
520         // bool struct_is_class = false;
521         const size_t num_attributes = die.GetAttributes(attributes);
522         if (num_attributes > 0) {
523           uint32_t i;
524           for (i = 0; i < num_attributes; ++i) {
525             attr = attributes.AttributeAtIndex(i);
526             if (attributes.ExtractFormValueAtIndex(i, form_value)) {
527               switch (attr) {
528               case DW_AT_decl_file:
529                 if (die.GetCU()->DW_AT_decl_file_attributes_are_invalid()) {
530                   // llvm-gcc outputs invalid DW_AT_decl_file attributes that
531                   // always
532                   // point to the compile unit file, so we clear this invalid
533                   // value
534                   // so that we can still unique types efficiently.
535                   decl.SetFile(FileSpec("<invalid>", false));
536                 } else
537                   decl.SetFile(
538                       sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
539                           form_value.Unsigned()));
540                 break;
541 
542               case DW_AT_decl_line:
543                 decl.SetLine(form_value.Unsigned());
544                 break;
545 
546               case DW_AT_decl_column:
547                 decl.SetColumn(form_value.Unsigned());
548                 break;
549 
550               case DW_AT_name:
551                 type_name_cstr = form_value.AsCString();
552                 type_name_const_str.SetCString(type_name_cstr);
553                 break;
554 
555               case DW_AT_byte_size:
556                 byte_size = form_value.Unsigned();
557                 byte_size_valid = true;
558                 break;
559 
560               case DW_AT_accessibility:
561                 accessibility = DW_ACCESS_to_AccessType(form_value.Unsigned());
562                 break;
563 
564               case DW_AT_declaration:
565                 is_forward_declaration = form_value.Boolean();
566                 break;
567 
568               case DW_AT_APPLE_runtime_class:
569                 class_language = (LanguageType)form_value.Signed();
570                 break;
571 
572               case DW_AT_APPLE_objc_complete_type:
573                 is_complete_objc_class = form_value.Signed();
574                 break;
575 
576               case DW_AT_allocated:
577               case DW_AT_associated:
578               case DW_AT_data_location:
579               case DW_AT_description:
580               case DW_AT_start_scope:
581               case DW_AT_visibility:
582               default:
583               case DW_AT_sibling:
584                 break;
585               }
586             }
587           }
588         }
589 
590         // UniqueDWARFASTType is large, so don't create a local variables on the
591         // stack, put it on the heap. This function is often called recursively
592         // and clang isn't good and sharing the stack space for variables in
593         // different blocks.
594         std::unique_ptr<UniqueDWARFASTType> unique_ast_entry_ap(
595             new UniqueDWARFASTType());
596 
597         ConstString unique_typename(type_name_const_str);
598         Declaration unique_decl(decl);
599 
600         if (type_name_const_str) {
601           LanguageType die_language = die.GetLanguage();
602           if (Language::LanguageIsCPlusPlus(die_language)) {
603             // For C++, we rely solely upon the one definition rule that says
604             // only
605             // one thing can exist at a given decl context. We ignore the file
606             // and
607             // line that things are declared on.
608             std::string qualified_name;
609             if (die.GetQualifiedName(qualified_name))
610               unique_typename = ConstString(qualified_name);
611             unique_decl.Clear();
612           }
613 
614           if (dwarf->GetUniqueDWARFASTTypeMap().Find(
615                   unique_typename, die, unique_decl,
616                   byte_size_valid ? byte_size : -1, *unique_ast_entry_ap)) {
617             type_sp = unique_ast_entry_ap->m_type_sp;
618             if (type_sp) {
619               dwarf->GetDIEToType()[die.GetDIE()] = type_sp.get();
620               return type_sp;
621             }
622           }
623         }
624 
625         DEBUG_PRINTF("0x%8.8" PRIx64 ": %s (\"%s\")\n", die.GetID(),
626                      DW_TAG_value_to_name(tag), type_name_cstr);
627 
628         int tag_decl_kind = -1;
629         AccessType default_accessibility = eAccessNone;
630         if (tag == DW_TAG_structure_type) {
631           tag_decl_kind = clang::TTK_Struct;
632           default_accessibility = eAccessPublic;
633         } else if (tag == DW_TAG_union_type) {
634           tag_decl_kind = clang::TTK_Union;
635           default_accessibility = eAccessPublic;
636         } else if (tag == DW_TAG_class_type) {
637           tag_decl_kind = clang::TTK_Class;
638           default_accessibility = eAccessPrivate;
639         }
640 
641         if (byte_size_valid && byte_size == 0 && type_name_cstr &&
642             die.HasChildren() == false &&
643             sc.comp_unit->GetLanguage() == eLanguageTypeObjC) {
644           // Work around an issue with clang at the moment where
645           // forward declarations for objective C classes are emitted
646           // as:
647           //  DW_TAG_structure_type [2]
648           //  DW_AT_name( "ForwardObjcClass" )
649           //  DW_AT_byte_size( 0x00 )
650           //  DW_AT_decl_file( "..." )
651           //  DW_AT_decl_line( 1 )
652           //
653           // Note that there is no DW_AT_declaration and there are
654           // no children, and the byte size is zero.
655           is_forward_declaration = true;
656         }
657 
658         if (class_language == eLanguageTypeObjC ||
659             class_language == eLanguageTypeObjC_plus_plus) {
660           if (!is_complete_objc_class &&
661               die.Supports_DW_AT_APPLE_objc_complete_type()) {
662             // We have a valid eSymbolTypeObjCClass class symbol whose
663             // name matches the current objective C class that we
664             // are trying to find and this DIE isn't the complete
665             // definition (we checked is_complete_objc_class above and
666             // know it is false), so the real definition is in here somewhere
667             type_sp = dwarf->FindCompleteObjCDefinitionTypeForDIE(
668                 die, type_name_const_str, true);
669 
670             if (!type_sp) {
671               SymbolFileDWARFDebugMap *debug_map_symfile =
672                   dwarf->GetDebugMapSymfile();
673               if (debug_map_symfile) {
674                 // We weren't able to find a full declaration in
675                 // this DWARF, see if we have a declaration anywhere
676                 // else...
677                 type_sp =
678                     debug_map_symfile->FindCompleteObjCDefinitionTypeForDIE(
679                         die, type_name_const_str, true);
680               }
681             }
682 
683             if (type_sp) {
684               if (log) {
685                 dwarf->GetObjectFile()->GetModule()->LogMessage(
686                     log, "SymbolFileDWARF(%p) - 0x%8.8x: %s type \"%s\" is an "
687                          "incomplete objc type, complete type is 0x%8.8" PRIx64,
688                     static_cast<void *>(this), die.GetOffset(),
689                     DW_TAG_value_to_name(tag), type_name_cstr,
690                     type_sp->GetID());
691               }
692 
693               // We found a real definition for this type elsewhere
694               // so lets use it and cache the fact that we found
695               // a complete type for this die
696               dwarf->GetDIEToType()[die.GetDIE()] = type_sp.get();
697               return type_sp;
698             }
699           }
700         }
701 
702         if (is_forward_declaration) {
703           // We have a forward declaration to a type and we need
704           // to try and find a full declaration. We look in the
705           // current type index just in case we have a forward
706           // declaration followed by an actual declarations in the
707           // DWARF. If this fails, we need to look elsewhere...
708           if (log) {
709             dwarf->GetObjectFile()->GetModule()->LogMessage(
710                 log, "SymbolFileDWARF(%p) - 0x%8.8x: %s type \"%s\" is a "
711                      "forward declaration, trying to find complete type",
712                 static_cast<void *>(this), die.GetOffset(),
713                 DW_TAG_value_to_name(tag), type_name_cstr);
714           }
715 
716           // See if the type comes from a DWO module and if so, track down that
717           // type.
718           type_sp = ParseTypeFromDWO(die, log);
719           if (type_sp)
720             return type_sp;
721 
722           DWARFDeclContext die_decl_ctx;
723           die.GetDWARFDeclContext(die_decl_ctx);
724 
725           // type_sp = FindDefinitionTypeForDIE (dwarf_cu, die,
726           // type_name_const_str);
727           type_sp = dwarf->FindDefinitionTypeForDWARFDeclContext(die_decl_ctx);
728 
729           if (!type_sp) {
730             SymbolFileDWARFDebugMap *debug_map_symfile =
731                 dwarf->GetDebugMapSymfile();
732             if (debug_map_symfile) {
733               // We weren't able to find a full declaration in
734               // this DWARF, see if we have a declaration anywhere
735               // else...
736               type_sp =
737                   debug_map_symfile->FindDefinitionTypeForDWARFDeclContext(
738                       die_decl_ctx);
739             }
740           }
741 
742           if (type_sp) {
743             if (log) {
744               dwarf->GetObjectFile()->GetModule()->LogMessage(
745                   log, "SymbolFileDWARF(%p) - 0x%8.8x: %s type \"%s\" is a "
746                        "forward declaration, complete type is 0x%8.8" PRIx64,
747                   static_cast<void *>(this), die.GetOffset(),
748                   DW_TAG_value_to_name(tag), type_name_cstr, type_sp->GetID());
749             }
750 
751             // We found a real definition for this type elsewhere
752             // so lets use it and cache the fact that we found
753             // a complete type for this die
754             dwarf->GetDIEToType()[die.GetDIE()] = type_sp.get();
755             clang::DeclContext *defn_decl_ctx = GetCachedClangDeclContextForDIE(
756                 dwarf->DebugInfo()->GetDIE(DIERef(type_sp->GetID(), dwarf)));
757             if (defn_decl_ctx)
758               LinkDeclContextToDIE(defn_decl_ctx, die);
759             return type_sp;
760           }
761         }
762         assert(tag_decl_kind != -1);
763         bool clang_type_was_created = false;
764         clang_type.SetCompilerType(
765             &m_ast, dwarf->GetForwardDeclDieToClangType().lookup(die.GetDIE()));
766         if (!clang_type) {
767           clang::DeclContext *decl_ctx =
768               GetClangDeclContextContainingDIE(die, nullptr);
769           if (accessibility == eAccessNone && decl_ctx) {
770             // Check the decl context that contains this class/struct/union.
771             // If it is a class we must give it an accessibility.
772             const clang::Decl::Kind containing_decl_kind =
773                 decl_ctx->getDeclKind();
774             if (DeclKindIsCXXClass(containing_decl_kind))
775               accessibility = default_accessibility;
776           }
777 
778           ClangASTMetadata metadata;
779           metadata.SetUserID(die.GetID());
780           metadata.SetIsDynamicCXXType(dwarf->ClassOrStructIsVirtual(die));
781 
782           if (type_name_cstr && strchr(type_name_cstr, '<')) {
783             ClangASTContext::TemplateParameterInfos template_param_infos;
784             if (ParseTemplateParameterInfos(die, template_param_infos)) {
785               clang::ClassTemplateDecl *class_template_decl =
786                   m_ast.ParseClassTemplateDecl(decl_ctx, accessibility,
787                                                type_name_cstr, tag_decl_kind,
788                                                template_param_infos);
789 
790               clang::ClassTemplateSpecializationDecl
791                   *class_specialization_decl =
792                       m_ast.CreateClassTemplateSpecializationDecl(
793                           decl_ctx, class_template_decl, tag_decl_kind,
794                           template_param_infos);
795               clang_type = m_ast.CreateClassTemplateSpecializationType(
796                   class_specialization_decl);
797               clang_type_was_created = true;
798 
799               m_ast.SetMetadata(class_template_decl, metadata);
800               m_ast.SetMetadata(class_specialization_decl, metadata);
801             }
802           }
803 
804           if (!clang_type_was_created) {
805             clang_type_was_created = true;
806             clang_type = m_ast.CreateRecordType(decl_ctx, accessibility,
807                                                 type_name_cstr, tag_decl_kind,
808                                                 class_language, &metadata);
809           }
810         }
811 
812         // Store a forward declaration to this class type in case any
813         // parameters in any class methods need it for the clang
814         // types for function prototypes.
815         LinkDeclContextToDIE(m_ast.GetDeclContextForType(clang_type), die);
816         type_sp.reset(new Type(die.GetID(), dwarf, type_name_const_str,
817                                byte_size, NULL, LLDB_INVALID_UID,
818                                Type::eEncodingIsUID, &decl, clang_type,
819                                Type::eResolveStateForward));
820 
821         type_sp->SetIsCompleteObjCClass(is_complete_objc_class);
822 
823         // Add our type to the unique type map so we don't
824         // end up creating many copies of the same type over
825         // and over in the ASTContext for our module
826         unique_ast_entry_ap->m_type_sp = type_sp;
827         unique_ast_entry_ap->m_die = die;
828         unique_ast_entry_ap->m_declaration = unique_decl;
829         unique_ast_entry_ap->m_byte_size = byte_size;
830         dwarf->GetUniqueDWARFASTTypeMap().Insert(unique_typename,
831                                                  *unique_ast_entry_ap);
832 
833         if (is_forward_declaration && die.HasChildren()) {
834           // Check to see if the DIE actually has a definition, some version of
835           // GCC will
836           // emit DIEs with DW_AT_declaration set to true, but yet still have
837           // subprogram,
838           // members, or inheritance, so we can't trust it
839           DWARFDIE child_die = die.GetFirstChild();
840           while (child_die) {
841             switch (child_die.Tag()) {
842             case DW_TAG_inheritance:
843             case DW_TAG_subprogram:
844             case DW_TAG_member:
845             case DW_TAG_APPLE_property:
846             case DW_TAG_class_type:
847             case DW_TAG_structure_type:
848             case DW_TAG_enumeration_type:
849             case DW_TAG_typedef:
850             case DW_TAG_union_type:
851               child_die.Clear();
852               is_forward_declaration = false;
853               break;
854             default:
855               child_die = child_die.GetSibling();
856               break;
857             }
858           }
859         }
860 
861         if (!is_forward_declaration) {
862           // Always start the definition for a class type so that
863           // if the class has child classes or types that require
864           // the class to be created for use as their decl contexts
865           // the class will be ready to accept these child definitions.
866           if (die.HasChildren() == false) {
867             // No children for this struct/union/class, lets finish it
868             if (ClangASTContext::StartTagDeclarationDefinition(clang_type)) {
869               ClangASTContext::CompleteTagDeclarationDefinition(clang_type);
870             } else {
871               dwarf->GetObjectFile()->GetModule()->ReportError(
872                   "DWARF DIE at 0x%8.8x named \"%s\" was not able to start its "
873                   "definition.\nPlease file a bug and attach the file at the "
874                   "start of this error message",
875                   die.GetOffset(), type_name_cstr);
876             }
877 
878             if (tag == DW_TAG_structure_type) // this only applies in C
879             {
880               clang::RecordDecl *record_decl =
881                   ClangASTContext::GetAsRecordDecl(clang_type);
882 
883               if (record_decl) {
884                 GetClangASTImporter().InsertRecordDecl(
885                     record_decl, ClangASTImporter::LayoutInfo());
886               }
887             }
888           } else if (clang_type_was_created) {
889             // Start the definition if the class is not objective C since
890             // the underlying decls respond to isCompleteDefinition(). Objective
891             // C decls don't respond to isCompleteDefinition() so we can't
892             // start the declaration definition right away. For C++
893             // class/union/structs
894             // we want to start the definition in case the class is needed as
895             // the
896             // declaration context for a contained class or type without the
897             // need
898             // to complete that type..
899 
900             if (class_language != eLanguageTypeObjC &&
901                 class_language != eLanguageTypeObjC_plus_plus)
902               ClangASTContext::StartTagDeclarationDefinition(clang_type);
903 
904             // Leave this as a forward declaration until we need
905             // to know the details of the type. lldb_private::Type
906             // will automatically call the SymbolFile virtual function
907             // "SymbolFileDWARF::CompleteType(Type *)"
908             // When the definition needs to be defined.
909             assert(!dwarf->GetForwardDeclClangTypeToDie().count(
910                        ClangUtil::RemoveFastQualifiers(clang_type)
911                            .GetOpaqueQualType()) &&
912                    "Type already in the forward declaration map!");
913             // Can't assume m_ast.GetSymbolFile() is actually a SymbolFileDWARF,
914             // it can be a
915             // SymbolFileDWARFDebugMap for Apple binaries.
916             dwarf->GetForwardDeclDieToClangType()[die.GetDIE()] =
917                 clang_type.GetOpaqueQualType();
918             dwarf->GetForwardDeclClangTypeToDie()
919                 [ClangUtil::RemoveFastQualifiers(clang_type)
920                      .GetOpaqueQualType()] = die.GetDIERef();
921             m_ast.SetHasExternalStorage(clang_type.GetOpaqueQualType(), true);
922           }
923         }
924       } break;
925 
926       case DW_TAG_enumeration_type: {
927         // Set a bit that lets us know that we are currently parsing this
928         dwarf->GetDIEToType()[die.GetDIE()] = DIE_IS_BEING_PARSED;
929 
930         DWARFFormValue encoding_form;
931 
932         const size_t num_attributes = die.GetAttributes(attributes);
933         if (num_attributes > 0) {
934           uint32_t i;
935 
936           for (i = 0; i < num_attributes; ++i) {
937             attr = attributes.AttributeAtIndex(i);
938             if (attributes.ExtractFormValueAtIndex(i, form_value)) {
939               switch (attr) {
940               case DW_AT_decl_file:
941                 decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
942                     form_value.Unsigned()));
943                 break;
944               case DW_AT_decl_line:
945                 decl.SetLine(form_value.Unsigned());
946                 break;
947               case DW_AT_decl_column:
948                 decl.SetColumn(form_value.Unsigned());
949                 break;
950               case DW_AT_name:
951                 type_name_cstr = form_value.AsCString();
952                 type_name_const_str.SetCString(type_name_cstr);
953                 break;
954               case DW_AT_type:
955                 encoding_form = form_value;
956                 break;
957               case DW_AT_byte_size:
958                 byte_size = form_value.Unsigned();
959                 break;
960               case DW_AT_accessibility:
961                 break; // accessibility =
962                        // DW_ACCESS_to_AccessType(form_value.Unsigned()); break;
963               case DW_AT_declaration:
964                 is_forward_declaration = form_value.Boolean();
965                 break;
966               case DW_AT_allocated:
967               case DW_AT_associated:
968               case DW_AT_bit_stride:
969               case DW_AT_byte_stride:
970               case DW_AT_data_location:
971               case DW_AT_description:
972               case DW_AT_start_scope:
973               case DW_AT_visibility:
974               case DW_AT_specification:
975               case DW_AT_abstract_origin:
976               case DW_AT_sibling:
977                 break;
978               }
979             }
980           }
981 
982           if (is_forward_declaration) {
983             type_sp = ParseTypeFromDWO(die, log);
984             if (type_sp)
985               return type_sp;
986 
987             DWARFDeclContext die_decl_ctx;
988             die.GetDWARFDeclContext(die_decl_ctx);
989 
990             type_sp =
991                 dwarf->FindDefinitionTypeForDWARFDeclContext(die_decl_ctx);
992 
993             if (!type_sp) {
994               SymbolFileDWARFDebugMap *debug_map_symfile =
995                   dwarf->GetDebugMapSymfile();
996               if (debug_map_symfile) {
997                 // We weren't able to find a full declaration in
998                 // this DWARF, see if we have a declaration anywhere
999                 // else...
1000                 type_sp =
1001                     debug_map_symfile->FindDefinitionTypeForDWARFDeclContext(
1002                         die_decl_ctx);
1003               }
1004             }
1005 
1006             if (type_sp) {
1007               if (log) {
1008                 dwarf->GetObjectFile()->GetModule()->LogMessage(
1009                     log, "SymbolFileDWARF(%p) - 0x%8.8x: %s type \"%s\" is a "
1010                          "forward declaration, complete type is 0x%8.8" PRIx64,
1011                     static_cast<void *>(this), die.GetOffset(),
1012                     DW_TAG_value_to_name(tag), type_name_cstr,
1013                     type_sp->GetID());
1014               }
1015 
1016               // We found a real definition for this type elsewhere
1017               // so lets use it and cache the fact that we found
1018               // a complete type for this die
1019               dwarf->GetDIEToType()[die.GetDIE()] = type_sp.get();
1020               clang::DeclContext *defn_decl_ctx =
1021                   GetCachedClangDeclContextForDIE(dwarf->DebugInfo()->GetDIE(
1022                       DIERef(type_sp->GetID(), dwarf)));
1023               if (defn_decl_ctx)
1024                 LinkDeclContextToDIE(defn_decl_ctx, die);
1025               return type_sp;
1026             }
1027           }
1028           DEBUG_PRINTF("0x%8.8" PRIx64 ": %s (\"%s\")\n", die.GetID(),
1029                        DW_TAG_value_to_name(tag), type_name_cstr);
1030 
1031           CompilerType enumerator_clang_type;
1032           clang_type.SetCompilerType(
1033               &m_ast,
1034               dwarf->GetForwardDeclDieToClangType().lookup(die.GetDIE()));
1035           if (!clang_type) {
1036             if (encoding_form.IsValid()) {
1037               Type *enumerator_type =
1038                   dwarf->ResolveTypeUID(DIERef(encoding_form));
1039               if (enumerator_type)
1040                 enumerator_clang_type = enumerator_type->GetFullCompilerType();
1041             }
1042 
1043             if (!enumerator_clang_type) {
1044               if (byte_size > 0) {
1045                 enumerator_clang_type =
1046                     m_ast.GetBuiltinTypeForDWARFEncodingAndBitSize(
1047                         NULL, DW_ATE_signed, byte_size * 8);
1048               } else {
1049                 enumerator_clang_type = m_ast.GetBasicType(eBasicTypeInt);
1050               }
1051             }
1052 
1053             clang_type = m_ast.CreateEnumerationType(
1054                 type_name_cstr, GetClangDeclContextContainingDIE(die, nullptr),
1055                 decl, enumerator_clang_type);
1056           } else {
1057             enumerator_clang_type =
1058                 m_ast.GetEnumerationIntegerType(clang_type.GetOpaqueQualType());
1059           }
1060 
1061           LinkDeclContextToDIE(
1062               ClangASTContext::GetDeclContextForType(clang_type), die);
1063 
1064           type_sp.reset(new Type(
1065               die.GetID(), dwarf, type_name_const_str, byte_size, NULL,
1066               DIERef(encoding_form).GetUID(dwarf), Type::eEncodingIsUID, &decl,
1067               clang_type, Type::eResolveStateForward));
1068 
1069           if (ClangASTContext::StartTagDeclarationDefinition(clang_type)) {
1070             if (die.HasChildren()) {
1071               SymbolContext cu_sc(die.GetLLDBCompileUnit());
1072               bool is_signed = false;
1073               enumerator_clang_type.IsIntegerType(is_signed);
1074               ParseChildEnumerators(cu_sc, clang_type, is_signed,
1075                                     type_sp->GetByteSize(), die);
1076             }
1077             ClangASTContext::CompleteTagDeclarationDefinition(clang_type);
1078           } else {
1079             dwarf->GetObjectFile()->GetModule()->ReportError(
1080                 "DWARF DIE at 0x%8.8x named \"%s\" was not able to start its "
1081                 "definition.\nPlease file a bug and attach the file at the "
1082                 "start of this error message",
1083                 die.GetOffset(), type_name_cstr);
1084           }
1085         }
1086       } break;
1087 
1088       case DW_TAG_inlined_subroutine:
1089       case DW_TAG_subprogram:
1090       case DW_TAG_subroutine_type: {
1091         // Set a bit that lets us know that we are currently parsing this
1092         dwarf->GetDIEToType()[die.GetDIE()] = DIE_IS_BEING_PARSED;
1093 
1094         DWARFFormValue type_die_form;
1095         bool is_variadic = false;
1096         bool is_inline = false;
1097         bool is_static = false;
1098         bool is_virtual = false;
1099         bool is_explicit = false;
1100         bool is_artificial = false;
1101         bool has_template_params = false;
1102         DWARFFormValue specification_die_form;
1103         DWARFFormValue abstract_origin_die_form;
1104         dw_offset_t object_pointer_die_offset = DW_INVALID_OFFSET;
1105 
1106         unsigned type_quals = 0;
1107         clang::StorageClass storage =
1108             clang::SC_None; //, Extern, Static, PrivateExtern
1109 
1110         const size_t num_attributes = die.GetAttributes(attributes);
1111         if (num_attributes > 0) {
1112           uint32_t i;
1113           for (i = 0; i < num_attributes; ++i) {
1114             attr = attributes.AttributeAtIndex(i);
1115             if (attributes.ExtractFormValueAtIndex(i, form_value)) {
1116               switch (attr) {
1117               case DW_AT_decl_file:
1118                 decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
1119                     form_value.Unsigned()));
1120                 break;
1121               case DW_AT_decl_line:
1122                 decl.SetLine(form_value.Unsigned());
1123                 break;
1124               case DW_AT_decl_column:
1125                 decl.SetColumn(form_value.Unsigned());
1126                 break;
1127               case DW_AT_name:
1128                 type_name_cstr = form_value.AsCString();
1129                 type_name_const_str.SetCString(type_name_cstr);
1130                 break;
1131 
1132               case DW_AT_linkage_name:
1133               case DW_AT_MIPS_linkage_name:
1134                 break; // mangled =
1135                        // form_value.AsCString(&dwarf->get_debug_str_data());
1136                        // break;
1137               case DW_AT_type:
1138                 type_die_form = form_value;
1139                 break;
1140               case DW_AT_accessibility:
1141                 accessibility = DW_ACCESS_to_AccessType(form_value.Unsigned());
1142                 break;
1143               case DW_AT_declaration:
1144                 break; // is_forward_declaration = form_value.Boolean(); break;
1145               case DW_AT_inline:
1146                 is_inline = form_value.Boolean();
1147                 break;
1148               case DW_AT_virtuality:
1149                 is_virtual = form_value.Boolean();
1150                 break;
1151               case DW_AT_explicit:
1152                 is_explicit = form_value.Boolean();
1153                 break;
1154               case DW_AT_artificial:
1155                 is_artificial = form_value.Boolean();
1156                 break;
1157 
1158               case DW_AT_external:
1159                 if (form_value.Unsigned()) {
1160                   if (storage == clang::SC_None)
1161                     storage = clang::SC_Extern;
1162                   else
1163                     storage = clang::SC_PrivateExtern;
1164                 }
1165                 break;
1166 
1167               case DW_AT_specification:
1168                 specification_die_form = form_value;
1169                 break;
1170 
1171               case DW_AT_abstract_origin:
1172                 abstract_origin_die_form = form_value;
1173                 break;
1174 
1175               case DW_AT_object_pointer:
1176                 object_pointer_die_offset = form_value.Reference();
1177                 break;
1178 
1179               case DW_AT_allocated:
1180               case DW_AT_associated:
1181               case DW_AT_address_class:
1182               case DW_AT_calling_convention:
1183               case DW_AT_data_location:
1184               case DW_AT_elemental:
1185               case DW_AT_entry_pc:
1186               case DW_AT_frame_base:
1187               case DW_AT_high_pc:
1188               case DW_AT_low_pc:
1189               case DW_AT_prototyped:
1190               case DW_AT_pure:
1191               case DW_AT_ranges:
1192               case DW_AT_recursive:
1193               case DW_AT_return_addr:
1194               case DW_AT_segment:
1195               case DW_AT_start_scope:
1196               case DW_AT_static_link:
1197               case DW_AT_trampoline:
1198               case DW_AT_visibility:
1199               case DW_AT_vtable_elem_location:
1200               case DW_AT_description:
1201               case DW_AT_sibling:
1202                 break;
1203               }
1204             }
1205           }
1206         }
1207 
1208         std::string object_pointer_name;
1209         if (object_pointer_die_offset != DW_INVALID_OFFSET) {
1210           DWARFDIE object_pointer_die = die.GetDIE(object_pointer_die_offset);
1211           if (object_pointer_die) {
1212             const char *object_pointer_name_cstr = object_pointer_die.GetName();
1213             if (object_pointer_name_cstr)
1214               object_pointer_name = object_pointer_name_cstr;
1215           }
1216         }
1217 
1218         DEBUG_PRINTF("0x%8.8" PRIx64 ": %s (\"%s\")\n", die.GetID(),
1219                      DW_TAG_value_to_name(tag), type_name_cstr);
1220 
1221         CompilerType return_clang_type;
1222         Type *func_type = NULL;
1223 
1224         if (type_die_form.IsValid())
1225           func_type = dwarf->ResolveTypeUID(DIERef(type_die_form));
1226 
1227         if (func_type)
1228           return_clang_type = func_type->GetForwardCompilerType();
1229         else
1230           return_clang_type = m_ast.GetBasicType(eBasicTypeVoid);
1231 
1232         std::vector<CompilerType> function_param_types;
1233         std::vector<clang::ParmVarDecl *> function_param_decls;
1234 
1235         // Parse the function children for the parameters
1236 
1237         DWARFDIE decl_ctx_die;
1238         clang::DeclContext *containing_decl_ctx =
1239             GetClangDeclContextContainingDIE(die, &decl_ctx_die);
1240         const clang::Decl::Kind containing_decl_kind =
1241             containing_decl_ctx->getDeclKind();
1242 
1243         bool is_cxx_method = DeclKindIsCXXClass(containing_decl_kind);
1244         // Start off static. This will be set to false in
1245         // ParseChildParameters(...)
1246         // if we find a "this" parameters as the first parameter
1247         if (is_cxx_method) {
1248           is_static = true;
1249         }
1250 
1251         if (die.HasChildren()) {
1252           bool skip_artificial = true;
1253           ParseChildParameters(sc, containing_decl_ctx, die, skip_artificial,
1254                                is_static, is_variadic, has_template_params,
1255                                function_param_types, function_param_decls,
1256                                type_quals);
1257         }
1258 
1259         bool ignore_containing_context = false;
1260         // Check for templatized class member functions. If we had any
1261         // DW_TAG_template_type_parameter
1262         // or DW_TAG_template_value_parameter the DW_TAG_subprogram DIE, then we
1263         // can't let this become
1264         // a method in a class. Why? Because templatized functions are only
1265         // emitted if one of the
1266         // templatized methods is used in the current compile unit and we will
1267         // end up with classes
1268         // that may or may not include these member functions and this means one
1269         // class won't match another
1270         // class definition and it affects our ability to use a class in the
1271         // clang expression parser. So
1272         // for the greater good, we currently must not allow any template member
1273         // functions in a class definition.
1274         if (is_cxx_method && has_template_params) {
1275           ignore_containing_context = true;
1276           is_cxx_method = false;
1277         }
1278 
1279         // clang_type will get the function prototype clang type after this call
1280         clang_type = m_ast.CreateFunctionType(
1281             return_clang_type, function_param_types.data(),
1282             function_param_types.size(), is_variadic, type_quals);
1283 
1284         if (type_name_cstr) {
1285           bool type_handled = false;
1286           if (tag == DW_TAG_subprogram || tag == DW_TAG_inlined_subroutine) {
1287             ObjCLanguage::MethodName objc_method(type_name_cstr, true);
1288             if (objc_method.IsValid(true)) {
1289               CompilerType class_opaque_type;
1290               ConstString class_name(objc_method.GetClassName());
1291               if (class_name) {
1292                 TypeSP complete_objc_class_type_sp(
1293                     dwarf->FindCompleteObjCDefinitionTypeForDIE(
1294                         DWARFDIE(), class_name, false));
1295 
1296                 if (complete_objc_class_type_sp) {
1297                   CompilerType type_clang_forward_type =
1298                       complete_objc_class_type_sp->GetForwardCompilerType();
1299                   if (ClangASTContext::IsObjCObjectOrInterfaceType(
1300                           type_clang_forward_type))
1301                     class_opaque_type = type_clang_forward_type;
1302                 }
1303               }
1304 
1305               if (class_opaque_type) {
1306                 // If accessibility isn't set to anything valid, assume public
1307                 // for
1308                 // now...
1309                 if (accessibility == eAccessNone)
1310                   accessibility = eAccessPublic;
1311 
1312                 clang::ObjCMethodDecl *objc_method_decl =
1313                     m_ast.AddMethodToObjCObjectType(
1314                         class_opaque_type, type_name_cstr, clang_type,
1315                         accessibility, is_artificial, is_variadic);
1316                 type_handled = objc_method_decl != NULL;
1317                 if (type_handled) {
1318                   LinkDeclContextToDIE(
1319                       ClangASTContext::GetAsDeclContext(objc_method_decl), die);
1320                   m_ast.SetMetadataAsUserID(objc_method_decl, die.GetID());
1321                 } else {
1322                   dwarf->GetObjectFile()->GetModule()->ReportError(
1323                       "{0x%8.8x}: invalid Objective-C method 0x%4.4x (%s), "
1324                       "please file a bug and attach the file at the start of "
1325                       "this error message",
1326                       die.GetOffset(), tag, DW_TAG_value_to_name(tag));
1327                 }
1328               }
1329             } else if (is_cxx_method) {
1330               // Look at the parent of this DIE and see if is is
1331               // a class or struct and see if this is actually a
1332               // C++ method
1333               Type *class_type = dwarf->ResolveType(decl_ctx_die);
1334               if (class_type) {
1335                 bool alternate_defn = false;
1336                 if (class_type->GetID() != decl_ctx_die.GetID() ||
1337                     decl_ctx_die.GetContainingDWOModuleDIE()) {
1338                   alternate_defn = true;
1339 
1340                   // We uniqued the parent class of this function to another
1341                   // class
1342                   // so we now need to associate all dies under "decl_ctx_die"
1343                   // to
1344                   // DIEs in the DIE for "class_type"...
1345                   SymbolFileDWARF *class_symfile = NULL;
1346                   DWARFDIE class_type_die;
1347 
1348                   SymbolFileDWARFDebugMap *debug_map_symfile =
1349                       dwarf->GetDebugMapSymfile();
1350                   if (debug_map_symfile) {
1351                     class_symfile = debug_map_symfile->GetSymbolFileByOSOIndex(
1352                         SymbolFileDWARFDebugMap::GetOSOIndexFromUserID(
1353                             class_type->GetID()));
1354                     class_type_die = class_symfile->DebugInfo()->GetDIE(
1355                         DIERef(class_type->GetID(), dwarf));
1356                   } else {
1357                     class_symfile = dwarf;
1358                     class_type_die = dwarf->DebugInfo()->GetDIE(
1359                         DIERef(class_type->GetID(), dwarf));
1360                   }
1361                   if (class_type_die) {
1362                     DWARFDIECollection failures;
1363 
1364                     CopyUniqueClassMethodTypes(decl_ctx_die, class_type_die,
1365                                                class_type, failures);
1366 
1367                     // FIXME do something with these failures that's smarter
1368                     // than
1369                     // just dropping them on the ground.  Unfortunately classes
1370                     // don't
1371                     // like having stuff added to them after their definitions
1372                     // are
1373                     // complete...
1374 
1375                     type_ptr = dwarf->GetDIEToType()[die.GetDIE()];
1376                     if (type_ptr && type_ptr != DIE_IS_BEING_PARSED) {
1377                       type_sp = type_ptr->shared_from_this();
1378                       break;
1379                     }
1380                   }
1381                 }
1382 
1383                 if (specification_die_form.IsValid()) {
1384                   // We have a specification which we are going to base our
1385                   // function
1386                   // prototype off of, so we need this type to be completed so
1387                   // that the
1388                   // m_die_to_decl_ctx for the method in the specification has a
1389                   // valid
1390                   // clang decl context.
1391                   class_type->GetForwardCompilerType();
1392                   // If we have a specification, then the function type should
1393                   // have been
1394                   // made with the specification and not with this die.
1395                   DWARFDIE spec_die = dwarf->DebugInfo()->GetDIE(
1396                       DIERef(specification_die_form));
1397                   clang::DeclContext *spec_clang_decl_ctx =
1398                       GetClangDeclContextForDIE(spec_die);
1399                   if (spec_clang_decl_ctx) {
1400                     LinkDeclContextToDIE(spec_clang_decl_ctx, die);
1401                   } else {
1402                     dwarf->GetObjectFile()->GetModule()->ReportWarning(
1403                         "0x%8.8" PRIx64 ": DW_AT_specification(0x%8.8" PRIx64
1404                         ") has no decl\n",
1405                         die.GetID(), specification_die_form.Reference());
1406                   }
1407                   type_handled = true;
1408                 } else if (abstract_origin_die_form.IsValid()) {
1409                   // We have a specification which we are going to base our
1410                   // function
1411                   // prototype off of, so we need this type to be completed so
1412                   // that the
1413                   // m_die_to_decl_ctx for the method in the abstract origin has
1414                   // a valid
1415                   // clang decl context.
1416                   class_type->GetForwardCompilerType();
1417 
1418                   DWARFDIE abs_die = dwarf->DebugInfo()->GetDIE(
1419                       DIERef(abstract_origin_die_form));
1420                   clang::DeclContext *abs_clang_decl_ctx =
1421                       GetClangDeclContextForDIE(abs_die);
1422                   if (abs_clang_decl_ctx) {
1423                     LinkDeclContextToDIE(abs_clang_decl_ctx, die);
1424                   } else {
1425                     dwarf->GetObjectFile()->GetModule()->ReportWarning(
1426                         "0x%8.8" PRIx64 ": DW_AT_abstract_origin(0x%8.8" PRIx64
1427                         ") has no decl\n",
1428                         die.GetID(), abstract_origin_die_form.Reference());
1429                   }
1430                   type_handled = true;
1431                 } else {
1432                   CompilerType class_opaque_type =
1433                       class_type->GetForwardCompilerType();
1434                   if (ClangASTContext::IsCXXClassType(class_opaque_type)) {
1435                     if (class_opaque_type.IsBeingDefined() || alternate_defn) {
1436                       if (!is_static && !die.HasChildren()) {
1437                         // We have a C++ member function with no children (this
1438                         // pointer!)
1439                         // and clang will get mad if we try and make a function
1440                         // that isn't
1441                         // well formed in the DWARF, so we will just skip it...
1442                         type_handled = true;
1443                       } else {
1444                         bool add_method = true;
1445                         if (alternate_defn) {
1446                           // If an alternate definition for the class exists,
1447                           // then add the method only if an
1448                           // equivalent is not already present.
1449                           clang::CXXRecordDecl *record_decl =
1450                               m_ast.GetAsCXXRecordDecl(
1451                                   class_opaque_type.GetOpaqueQualType());
1452                           if (record_decl) {
1453                             for (auto method_iter = record_decl->method_begin();
1454                                  method_iter != record_decl->method_end();
1455                                  method_iter++) {
1456                               clang::CXXMethodDecl *method_decl = *method_iter;
1457                               if (method_decl->getNameInfo().getAsString() ==
1458                                   std::string(type_name_cstr)) {
1459                                 if (method_decl->getType() ==
1460                                     ClangUtil::GetQualType(clang_type)) {
1461                                   add_method = false;
1462                                   LinkDeclContextToDIE(
1463                                       ClangASTContext::GetAsDeclContext(
1464                                           method_decl),
1465                                       die);
1466                                   type_handled = true;
1467 
1468                                   break;
1469                                 }
1470                               }
1471                             }
1472                           }
1473                         }
1474 
1475                         if (add_method) {
1476                           // REMOVE THE CRASH DESCRIPTION BELOW
1477                           Host::SetCrashDescriptionWithFormat(
1478                               "SymbolFileDWARF::ParseType() is adding a method "
1479                               "%s to class %s in DIE 0x%8.8" PRIx64 " from %s",
1480                               type_name_cstr,
1481                               class_type->GetName().GetCString(), die.GetID(),
1482                               dwarf->GetObjectFile()
1483                                   ->GetFileSpec()
1484                                   .GetPath()
1485                                   .c_str());
1486 
1487                           const bool is_attr_used = false;
1488                           // Neither GCC 4.2 nor clang++ currently set a valid
1489                           // accessibility
1490                           // in the DWARF for C++ methods... Default to public
1491                           // for now...
1492                           if (accessibility == eAccessNone)
1493                             accessibility = eAccessPublic;
1494 
1495                           clang::CXXMethodDecl *cxx_method_decl;
1496                           cxx_method_decl = m_ast.AddMethodToCXXRecordType(
1497                               class_opaque_type.GetOpaqueQualType(),
1498                               type_name_cstr, clang_type, accessibility,
1499                               is_virtual, is_static, is_inline, is_explicit,
1500                               is_attr_used, is_artificial);
1501 
1502                           type_handled = cxx_method_decl != NULL;
1503 
1504                           if (type_handled) {
1505                             LinkDeclContextToDIE(
1506                                 ClangASTContext::GetAsDeclContext(
1507                                     cxx_method_decl),
1508                                 die);
1509 
1510                             Host::SetCrashDescription(NULL);
1511 
1512                             ClangASTMetadata metadata;
1513                             metadata.SetUserID(die.GetID());
1514 
1515                             if (!object_pointer_name.empty()) {
1516                               metadata.SetObjectPtrName(
1517                                   object_pointer_name.c_str());
1518                               if (log)
1519                                 log->Printf(
1520                                     "Setting object pointer name: %s on method "
1521                                     "object %p.\n",
1522                                     object_pointer_name.c_str(),
1523                                     static_cast<void *>(cxx_method_decl));
1524                             }
1525                             m_ast.SetMetadata(cxx_method_decl, metadata);
1526                           } else {
1527                             ignore_containing_context = true;
1528                           }
1529                         }
1530                       }
1531                     } else {
1532                       // We were asked to parse the type for a method in a
1533                       // class, yet the
1534                       // class hasn't been asked to complete itself through the
1535                       // clang::ExternalASTSource protocol, so we need to just
1536                       // have the
1537                       // class complete itself and do things the right way, then
1538                       // our
1539                       // DIE should then have an entry in the
1540                       // dwarf->GetDIEToType() map. First
1541                       // we need to modify the dwarf->GetDIEToType() so it
1542                       // doesn't think we are
1543                       // trying to parse this DIE anymore...
1544                       dwarf->GetDIEToType()[die.GetDIE()] = NULL;
1545 
1546                       // Now we get the full type to force our class type to
1547                       // complete itself
1548                       // using the clang::ExternalASTSource protocol which will
1549                       // parse all
1550                       // base classes and all methods (including the method for
1551                       // this DIE).
1552                       class_type->GetFullCompilerType();
1553 
1554                       // The type for this DIE should have been filled in the
1555                       // function call above
1556                       type_ptr = dwarf->GetDIEToType()[die.GetDIE()];
1557                       if (type_ptr && type_ptr != DIE_IS_BEING_PARSED) {
1558                         type_sp = type_ptr->shared_from_this();
1559                         break;
1560                       }
1561 
1562                       // FIXME This is fixing some even uglier behavior but we
1563                       // really need to
1564                       // uniq the methods of each class as well as the class
1565                       // itself.
1566                       // <rdar://problem/11240464>
1567                       type_handled = true;
1568                     }
1569                   }
1570                 }
1571               }
1572             }
1573           }
1574 
1575           if (!type_handled) {
1576             clang::FunctionDecl *function_decl = nullptr;
1577 
1578             if (abstract_origin_die_form.IsValid()) {
1579               DWARFDIE abs_die =
1580                   dwarf->DebugInfo()->GetDIE(DIERef(abstract_origin_die_form));
1581 
1582               SymbolContext sc;
1583 
1584               if (dwarf->ResolveType(abs_die)) {
1585                 function_decl = llvm::dyn_cast_or_null<clang::FunctionDecl>(
1586                     GetCachedClangDeclContextForDIE(abs_die));
1587 
1588                 if (function_decl) {
1589                   LinkDeclContextToDIE(function_decl, die);
1590                 }
1591               }
1592             }
1593 
1594             if (!function_decl) {
1595               // We just have a function that isn't part of a class
1596               function_decl = m_ast.CreateFunctionDeclaration(
1597                   ignore_containing_context ? m_ast.GetTranslationUnitDecl()
1598                                             : containing_decl_ctx,
1599                   type_name_cstr, clang_type, storage, is_inline);
1600 
1601               //                            if (template_param_infos.GetSize() >
1602               //                            0)
1603               //                            {
1604               //                                clang::FunctionTemplateDecl
1605               //                                *func_template_decl =
1606               //                                CreateFunctionTemplateDecl
1607               //                                (containing_decl_ctx,
1608               //                                                                                                              function_decl,
1609               //                                                                                                              type_name_cstr,
1610               //                                                                                                              template_param_infos);
1611               //
1612               //                                CreateFunctionTemplateSpecializationInfo
1613               //                                (function_decl,
1614               //                                                                          func_template_decl,
1615               //                                                                          template_param_infos);
1616               //                            }
1617               // Add the decl to our DIE to decl context map
1618 
1619               lldbassert(function_decl);
1620 
1621               if (function_decl) {
1622                 LinkDeclContextToDIE(function_decl, die);
1623 
1624                 if (!function_param_decls.empty())
1625                   m_ast.SetFunctionParameters(function_decl,
1626                                               &function_param_decls.front(),
1627                                               function_param_decls.size());
1628 
1629                 ClangASTMetadata metadata;
1630                 metadata.SetUserID(die.GetID());
1631 
1632                 if (!object_pointer_name.empty()) {
1633                   metadata.SetObjectPtrName(object_pointer_name.c_str());
1634                   if (log)
1635                     log->Printf("Setting object pointer name: %s on function "
1636                                 "object %p.",
1637                                 object_pointer_name.c_str(),
1638                                 static_cast<void *>(function_decl));
1639                 }
1640                 m_ast.SetMetadata(function_decl, metadata);
1641               }
1642             }
1643           }
1644         }
1645         type_sp.reset(new Type(die.GetID(), dwarf, type_name_const_str, 0, NULL,
1646                                LLDB_INVALID_UID, Type::eEncodingIsUID, &decl,
1647                                clang_type, Type::eResolveStateFull));
1648         assert(type_sp.get());
1649       } break;
1650 
1651       case DW_TAG_array_type: {
1652         // Set a bit that lets us know that we are currently parsing this
1653         dwarf->GetDIEToType()[die.GetDIE()] = DIE_IS_BEING_PARSED;
1654 
1655         DWARFFormValue type_die_form;
1656         int64_t first_index = 0;
1657         uint32_t byte_stride = 0;
1658         uint32_t bit_stride = 0;
1659         bool is_vector = false;
1660         const size_t num_attributes = die.GetAttributes(attributes);
1661 
1662         if (num_attributes > 0) {
1663           uint32_t i;
1664           for (i = 0; i < num_attributes; ++i) {
1665             attr = attributes.AttributeAtIndex(i);
1666             if (attributes.ExtractFormValueAtIndex(i, form_value)) {
1667               switch (attr) {
1668               case DW_AT_decl_file:
1669                 decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
1670                     form_value.Unsigned()));
1671                 break;
1672               case DW_AT_decl_line:
1673                 decl.SetLine(form_value.Unsigned());
1674                 break;
1675               case DW_AT_decl_column:
1676                 decl.SetColumn(form_value.Unsigned());
1677                 break;
1678               case DW_AT_name:
1679                 type_name_cstr = form_value.AsCString();
1680                 type_name_const_str.SetCString(type_name_cstr);
1681                 break;
1682 
1683               case DW_AT_type:
1684                 type_die_form = form_value;
1685                 break;
1686               case DW_AT_byte_size:
1687                 break; // byte_size = form_value.Unsigned(); break;
1688               case DW_AT_byte_stride:
1689                 byte_stride = form_value.Unsigned();
1690                 break;
1691               case DW_AT_bit_stride:
1692                 bit_stride = form_value.Unsigned();
1693                 break;
1694               case DW_AT_GNU_vector:
1695                 is_vector = form_value.Boolean();
1696                 break;
1697               case DW_AT_accessibility:
1698                 break; // accessibility =
1699                        // DW_ACCESS_to_AccessType(form_value.Unsigned()); break;
1700               case DW_AT_declaration:
1701                 break; // is_forward_declaration = form_value.Boolean(); break;
1702               case DW_AT_allocated:
1703               case DW_AT_associated:
1704               case DW_AT_data_location:
1705               case DW_AT_description:
1706               case DW_AT_ordering:
1707               case DW_AT_start_scope:
1708               case DW_AT_visibility:
1709               case DW_AT_specification:
1710               case DW_AT_abstract_origin:
1711               case DW_AT_sibling:
1712                 break;
1713               }
1714             }
1715           }
1716 
1717           DEBUG_PRINTF("0x%8.8" PRIx64 ": %s (\"%s\")\n", die.GetID(),
1718                        DW_TAG_value_to_name(tag), type_name_cstr);
1719 
1720           DIERef type_die_ref(type_die_form);
1721           Type *element_type = dwarf->ResolveTypeUID(type_die_ref);
1722 
1723           if (element_type) {
1724             std::vector<uint64_t> element_orders;
1725             ParseChildArrayInfo(sc, die, first_index, element_orders,
1726                                 byte_stride, bit_stride);
1727             if (byte_stride == 0 && bit_stride == 0)
1728               byte_stride = element_type->GetByteSize();
1729             CompilerType array_element_type =
1730                 element_type->GetForwardCompilerType();
1731 
1732             if (ClangASTContext::IsCXXClassType(array_element_type) &&
1733                 array_element_type.GetCompleteType() == false) {
1734               ModuleSP module_sp = die.GetModule();
1735               if (module_sp) {
1736                 if (die.GetCU()->GetProducer() ==
1737                     DWARFCompileUnit::eProducerClang)
1738                   module_sp->ReportError(
1739                       "DWARF DW_TAG_array_type DIE at 0x%8.8x has a "
1740                       "class/union/struct element type DIE 0x%8.8x that is a "
1741                       "forward declaration, not a complete definition.\nTry "
1742                       "compiling the source file with -fno-limit-debug-info or "
1743                       "disable -gmodule",
1744                       die.GetOffset(), type_die_ref.die_offset);
1745                 else
1746                   module_sp->ReportError(
1747                       "DWARF DW_TAG_array_type DIE at 0x%8.8x has a "
1748                       "class/union/struct element type DIE 0x%8.8x that is a "
1749                       "forward declaration, not a complete definition.\nPlease "
1750                       "file a bug against the compiler and include the "
1751                       "preprocessed output for %s",
1752                       die.GetOffset(), type_die_ref.die_offset,
1753                       die.GetLLDBCompileUnit()
1754                           ? die.GetLLDBCompileUnit()->GetPath().c_str()
1755                           : "the source file");
1756               }
1757 
1758               // We have no choice other than to pretend that the element class
1759               // type
1760               // is complete. If we don't do this, clang will crash when trying
1761               // to layout the class. Since we provide layout assistance, all
1762               // ivars in this class and other classes will be fine, this is
1763               // the best we can do short of crashing.
1764               if (ClangASTContext::StartTagDeclarationDefinition(
1765                       array_element_type)) {
1766                 ClangASTContext::CompleteTagDeclarationDefinition(
1767                     array_element_type);
1768               } else {
1769                 module_sp->ReportError("DWARF DIE at 0x%8.8x was not able to "
1770                                        "start its definition.\nPlease file a "
1771                                        "bug and attach the file at the start "
1772                                        "of this error message",
1773                                        type_die_ref.die_offset);
1774               }
1775             }
1776 
1777             uint64_t array_element_bit_stride = byte_stride * 8 + bit_stride;
1778             if (element_orders.size() > 0) {
1779               uint64_t num_elements = 0;
1780               std::vector<uint64_t>::const_reverse_iterator pos;
1781               std::vector<uint64_t>::const_reverse_iterator end =
1782                   element_orders.rend();
1783               for (pos = element_orders.rbegin(); pos != end; ++pos) {
1784                 num_elements = *pos;
1785                 clang_type = m_ast.CreateArrayType(array_element_type,
1786                                                    num_elements, is_vector);
1787                 array_element_type = clang_type;
1788                 array_element_bit_stride =
1789                     num_elements ? array_element_bit_stride * num_elements
1790                                  : array_element_bit_stride;
1791               }
1792             } else {
1793               clang_type =
1794                   m_ast.CreateArrayType(array_element_type, 0, is_vector);
1795             }
1796             ConstString empty_name;
1797             type_sp.reset(new Type(
1798                 die.GetID(), dwarf, empty_name, array_element_bit_stride / 8,
1799                 NULL, DIERef(type_die_form).GetUID(dwarf), Type::eEncodingIsUID,
1800                 &decl, clang_type, Type::eResolveStateFull));
1801             type_sp->SetEncodingType(element_type);
1802           }
1803         }
1804       } break;
1805 
1806       case DW_TAG_ptr_to_member_type: {
1807         DWARFFormValue type_die_form;
1808         DWARFFormValue containing_type_die_form;
1809 
1810         const size_t num_attributes = die.GetAttributes(attributes);
1811 
1812         if (num_attributes > 0) {
1813           uint32_t i;
1814           for (i = 0; i < num_attributes; ++i) {
1815             attr = attributes.AttributeAtIndex(i);
1816             if (attributes.ExtractFormValueAtIndex(i, form_value)) {
1817               switch (attr) {
1818               case DW_AT_type:
1819                 type_die_form = form_value;
1820                 break;
1821               case DW_AT_containing_type:
1822                 containing_type_die_form = form_value;
1823                 break;
1824               }
1825             }
1826           }
1827 
1828           Type *pointee_type = dwarf->ResolveTypeUID(DIERef(type_die_form));
1829           Type *class_type =
1830               dwarf->ResolveTypeUID(DIERef(containing_type_die_form));
1831 
1832           CompilerType pointee_clang_type =
1833               pointee_type->GetForwardCompilerType();
1834           CompilerType class_clang_type = class_type->GetLayoutCompilerType();
1835 
1836           clang_type = ClangASTContext::CreateMemberPointerType(
1837               class_clang_type, pointee_clang_type);
1838 
1839           byte_size = clang_type.GetByteSize(nullptr);
1840 
1841           type_sp.reset(new Type(die.GetID(), dwarf, type_name_const_str,
1842                                  byte_size, NULL, LLDB_INVALID_UID,
1843                                  Type::eEncodingIsUID, NULL, clang_type,
1844                                  Type::eResolveStateForward));
1845         }
1846 
1847         break;
1848       }
1849       default:
1850         dwarf->GetObjectFile()->GetModule()->ReportError(
1851             "{0x%8.8x}: unhandled type tag 0x%4.4x (%s), please file a bug and "
1852             "attach the file at the start of this error message",
1853             die.GetOffset(), tag, DW_TAG_value_to_name(tag));
1854         break;
1855       }
1856 
1857       if (type_sp.get()) {
1858         DWARFDIE sc_parent_die =
1859             SymbolFileDWARF::GetParentSymbolContextDIE(die);
1860         dw_tag_t sc_parent_tag = sc_parent_die.Tag();
1861 
1862         SymbolContextScope *symbol_context_scope = NULL;
1863         if (sc_parent_tag == DW_TAG_compile_unit) {
1864           symbol_context_scope = sc.comp_unit;
1865         } else if (sc.function != NULL && sc_parent_die) {
1866           symbol_context_scope =
1867               sc.function->GetBlock(true).FindBlockByID(sc_parent_die.GetID());
1868           if (symbol_context_scope == NULL)
1869             symbol_context_scope = sc.function;
1870         }
1871 
1872         if (symbol_context_scope != NULL) {
1873           type_sp->SetSymbolContextScope(symbol_context_scope);
1874         }
1875 
1876         // We are ready to put this type into the uniqued list up at the module
1877         // level
1878         type_list->Insert(type_sp);
1879 
1880         dwarf->GetDIEToType()[die.GetDIE()] = type_sp.get();
1881       }
1882     } else if (type_ptr != DIE_IS_BEING_PARSED) {
1883       type_sp = type_ptr->shared_from_this();
1884     }
1885   }
1886   return type_sp;
1887 }
1888 
1889 // DWARF parsing functions
1890 
1891 class DWARFASTParserClang::DelayedAddObjCClassProperty {
1892 public:
1893   DelayedAddObjCClassProperty(
1894       const CompilerType &class_opaque_type, const char *property_name,
1895       const CompilerType &property_opaque_type, // The property type is only
1896                                                 // required if you don't have an
1897                                                 // ivar decl
1898       clang::ObjCIvarDecl *ivar_decl, const char *property_setter_name,
1899       const char *property_getter_name, uint32_t property_attributes,
1900       const ClangASTMetadata *metadata)
1901       : m_class_opaque_type(class_opaque_type), m_property_name(property_name),
1902         m_property_opaque_type(property_opaque_type), m_ivar_decl(ivar_decl),
1903         m_property_setter_name(property_setter_name),
1904         m_property_getter_name(property_getter_name),
1905         m_property_attributes(property_attributes) {
1906     if (metadata != NULL) {
1907       m_metadata_ap.reset(new ClangASTMetadata());
1908       *m_metadata_ap = *metadata;
1909     }
1910   }
1911 
1912   DelayedAddObjCClassProperty(const DelayedAddObjCClassProperty &rhs) {
1913     *this = rhs;
1914   }
1915 
1916   DelayedAddObjCClassProperty &
1917   operator=(const DelayedAddObjCClassProperty &rhs) {
1918     m_class_opaque_type = rhs.m_class_opaque_type;
1919     m_property_name = rhs.m_property_name;
1920     m_property_opaque_type = rhs.m_property_opaque_type;
1921     m_ivar_decl = rhs.m_ivar_decl;
1922     m_property_setter_name = rhs.m_property_setter_name;
1923     m_property_getter_name = rhs.m_property_getter_name;
1924     m_property_attributes = rhs.m_property_attributes;
1925 
1926     if (rhs.m_metadata_ap.get()) {
1927       m_metadata_ap.reset(new ClangASTMetadata());
1928       *m_metadata_ap = *rhs.m_metadata_ap;
1929     }
1930     return *this;
1931   }
1932 
1933   bool Finalize() {
1934     return ClangASTContext::AddObjCClassProperty(
1935         m_class_opaque_type, m_property_name, m_property_opaque_type,
1936         m_ivar_decl, m_property_setter_name, m_property_getter_name,
1937         m_property_attributes, m_metadata_ap.get());
1938   }
1939 
1940 private:
1941   CompilerType m_class_opaque_type;
1942   const char *m_property_name;
1943   CompilerType m_property_opaque_type;
1944   clang::ObjCIvarDecl *m_ivar_decl;
1945   const char *m_property_setter_name;
1946   const char *m_property_getter_name;
1947   uint32_t m_property_attributes;
1948   std::unique_ptr<ClangASTMetadata> m_metadata_ap;
1949 };
1950 
1951 bool DWARFASTParserClang::ParseTemplateDIE(
1952     const DWARFDIE &die,
1953     ClangASTContext::TemplateParameterInfos &template_param_infos) {
1954   const dw_tag_t tag = die.Tag();
1955 
1956   switch (tag) {
1957   case DW_TAG_template_type_parameter:
1958   case DW_TAG_template_value_parameter: {
1959     DWARFAttributes attributes;
1960     const size_t num_attributes = die.GetAttributes(attributes);
1961     const char *name = nullptr;
1962     CompilerType clang_type;
1963     uint64_t uval64 = 0;
1964     bool uval64_valid = false;
1965     if (num_attributes > 0) {
1966       DWARFFormValue form_value;
1967       for (size_t i = 0; i < num_attributes; ++i) {
1968         const dw_attr_t attr = attributes.AttributeAtIndex(i);
1969 
1970         switch (attr) {
1971         case DW_AT_name:
1972           if (attributes.ExtractFormValueAtIndex(i, form_value))
1973             name = form_value.AsCString();
1974           break;
1975 
1976         case DW_AT_type:
1977           if (attributes.ExtractFormValueAtIndex(i, form_value)) {
1978             Type *lldb_type = die.ResolveTypeUID(DIERef(form_value));
1979             if (lldb_type)
1980               clang_type = lldb_type->GetForwardCompilerType();
1981           }
1982           break;
1983 
1984         case DW_AT_const_value:
1985           if (attributes.ExtractFormValueAtIndex(i, form_value)) {
1986             uval64_valid = true;
1987             uval64 = form_value.Unsigned();
1988           }
1989           break;
1990         default:
1991           break;
1992         }
1993       }
1994 
1995       clang::ASTContext *ast = m_ast.getASTContext();
1996       if (!clang_type)
1997         clang_type = m_ast.GetBasicType(eBasicTypeVoid);
1998 
1999       if (clang_type) {
2000         bool is_signed = false;
2001         if (name && name[0])
2002           template_param_infos.names.push_back(name);
2003         else
2004           template_param_infos.names.push_back(NULL);
2005 
2006         // Get the signed value for any integer or enumeration if available
2007         clang_type.IsIntegerOrEnumerationType(is_signed);
2008 
2009         if (tag == DW_TAG_template_value_parameter && uval64_valid) {
2010           llvm::APInt apint(clang_type.GetBitSize(nullptr), uval64, is_signed);
2011           template_param_infos.args.push_back(
2012               clang::TemplateArgument(*ast, llvm::APSInt(apint, !is_signed),
2013                                       ClangUtil::GetQualType(clang_type)));
2014         } else {
2015           template_param_infos.args.push_back(
2016               clang::TemplateArgument(ClangUtil::GetQualType(clang_type)));
2017         }
2018       } else {
2019         return false;
2020       }
2021     }
2022   }
2023     return true;
2024 
2025   default:
2026     break;
2027   }
2028   return false;
2029 }
2030 
2031 bool DWARFASTParserClang::ParseTemplateParameterInfos(
2032     const DWARFDIE &parent_die,
2033     ClangASTContext::TemplateParameterInfos &template_param_infos) {
2034 
2035   if (!parent_die)
2036     return false;
2037 
2038   Args template_parameter_names;
2039   for (DWARFDIE die = parent_die.GetFirstChild(); die.IsValid();
2040        die = die.GetSibling()) {
2041     const dw_tag_t tag = die.Tag();
2042 
2043     switch (tag) {
2044     case DW_TAG_template_type_parameter:
2045     case DW_TAG_template_value_parameter:
2046       ParseTemplateDIE(die, template_param_infos);
2047       break;
2048 
2049     default:
2050       break;
2051     }
2052   }
2053   if (template_param_infos.args.empty())
2054     return false;
2055   return template_param_infos.args.size() == template_param_infos.names.size();
2056 }
2057 
2058 bool DWARFASTParserClang::CompleteTypeFromDWARF(const DWARFDIE &die,
2059                                                 lldb_private::Type *type,
2060                                                 CompilerType &clang_type) {
2061   SymbolFileDWARF *dwarf = die.GetDWARF();
2062 
2063   std::lock_guard<std::recursive_mutex> guard(
2064       dwarf->GetObjectFile()->GetModule()->GetMutex());
2065 
2066   // Disable external storage for this type so we don't get anymore
2067   // clang::ExternalASTSource queries for this type.
2068   m_ast.SetHasExternalStorage(clang_type.GetOpaqueQualType(), false);
2069 
2070   if (!die)
2071     return false;
2072 
2073 #if defined LLDB_CONFIGURATION_DEBUG
2074   //----------------------------------------------------------------------
2075   // For debugging purposes, the LLDB_DWARF_DONT_COMPLETE_TYPENAMES
2076   // environment variable can be set with one or more typenames separated
2077   // by ';' characters. This will cause this function to not complete any
2078   // types whose names match.
2079   //
2080   // Examples of setting this environment variable:
2081   //
2082   // LLDB_DWARF_DONT_COMPLETE_TYPENAMES=Foo
2083   // LLDB_DWARF_DONT_COMPLETE_TYPENAMES=Foo;Bar;Baz
2084   //----------------------------------------------------------------------
2085   const char *dont_complete_typenames_cstr =
2086       getenv("LLDB_DWARF_DONT_COMPLETE_TYPENAMES");
2087   if (dont_complete_typenames_cstr && dont_complete_typenames_cstr[0]) {
2088     const char *die_name = die.GetName();
2089     if (die_name && die_name[0]) {
2090       const char *match = strstr(dont_complete_typenames_cstr, die_name);
2091       if (match) {
2092         size_t die_name_length = strlen(die_name);
2093         while (match) {
2094           const char separator_char = ';';
2095           const char next_char = match[die_name_length];
2096           if (next_char == '\0' || next_char == separator_char) {
2097             if (match == dont_complete_typenames_cstr ||
2098                 match[-1] == separator_char)
2099               return false;
2100           }
2101           match = strstr(match + 1, die_name);
2102         }
2103       }
2104     }
2105   }
2106 #endif
2107 
2108   const dw_tag_t tag = die.Tag();
2109 
2110   Log *log =
2111       nullptr; // (LogChannelDWARF::GetLogIfAny(DWARF_LOG_DEBUG_INFO|DWARF_LOG_TYPE_COMPLETION));
2112   if (log)
2113     dwarf->GetObjectFile()->GetModule()->LogMessageVerboseBacktrace(
2114         log, "0x%8.8" PRIx64 ": %s '%s' resolving forward declaration...",
2115         die.GetID(), die.GetTagAsCString(), type->GetName().AsCString());
2116   assert(clang_type);
2117   DWARFAttributes attributes;
2118   switch (tag) {
2119   case DW_TAG_structure_type:
2120   case DW_TAG_union_type:
2121   case DW_TAG_class_type: {
2122     ClangASTImporter::LayoutInfo layout_info;
2123 
2124     {
2125       if (die.HasChildren()) {
2126         LanguageType class_language = eLanguageTypeUnknown;
2127         if (ClangASTContext::IsObjCObjectOrInterfaceType(clang_type)) {
2128           class_language = eLanguageTypeObjC;
2129           // For objective C we don't start the definition when
2130           // the class is created.
2131           ClangASTContext::StartTagDeclarationDefinition(clang_type);
2132         }
2133 
2134         int tag_decl_kind = -1;
2135         AccessType default_accessibility = eAccessNone;
2136         if (tag == DW_TAG_structure_type) {
2137           tag_decl_kind = clang::TTK_Struct;
2138           default_accessibility = eAccessPublic;
2139         } else if (tag == DW_TAG_union_type) {
2140           tag_decl_kind = clang::TTK_Union;
2141           default_accessibility = eAccessPublic;
2142         } else if (tag == DW_TAG_class_type) {
2143           tag_decl_kind = clang::TTK_Class;
2144           default_accessibility = eAccessPrivate;
2145         }
2146 
2147         SymbolContext sc(die.GetLLDBCompileUnit());
2148         std::vector<clang::CXXBaseSpecifier *> base_classes;
2149         std::vector<int> member_accessibilities;
2150         bool is_a_class = false;
2151         // Parse members and base classes first
2152         DWARFDIECollection member_function_dies;
2153 
2154         DelayedPropertyList delayed_properties;
2155         ParseChildMembers(sc, die, clang_type, class_language, base_classes,
2156                           member_accessibilities, member_function_dies,
2157                           delayed_properties, default_accessibility, is_a_class,
2158                           layout_info);
2159 
2160         // Now parse any methods if there were any...
2161         size_t num_functions = member_function_dies.Size();
2162         if (num_functions > 0) {
2163           for (size_t i = 0; i < num_functions; ++i) {
2164             dwarf->ResolveType(member_function_dies.GetDIEAtIndex(i));
2165           }
2166         }
2167 
2168         if (class_language == eLanguageTypeObjC) {
2169           ConstString class_name(clang_type.GetTypeName());
2170           if (class_name) {
2171             DIEArray method_die_offsets;
2172             dwarf->GetObjCMethodDIEOffsets(class_name, method_die_offsets);
2173 
2174             if (!method_die_offsets.empty()) {
2175               DWARFDebugInfo *debug_info = dwarf->DebugInfo();
2176 
2177               const size_t num_matches = method_die_offsets.size();
2178               for (size_t i = 0; i < num_matches; ++i) {
2179                 const DIERef &die_ref = method_die_offsets[i];
2180                 DWARFDIE method_die = debug_info->GetDIE(die_ref);
2181 
2182                 if (method_die)
2183                   method_die.ResolveType();
2184               }
2185             }
2186 
2187             for (DelayedPropertyList::iterator pi = delayed_properties.begin(),
2188                                                pe = delayed_properties.end();
2189                  pi != pe; ++pi)
2190               pi->Finalize();
2191           }
2192         }
2193 
2194         // If we have a DW_TAG_structure_type instead of a DW_TAG_class_type we
2195         // need to tell the clang type it is actually a class.
2196         if (class_language != eLanguageTypeObjC) {
2197           if (is_a_class && tag_decl_kind != clang::TTK_Class)
2198             m_ast.SetTagTypeKind(ClangUtil::GetQualType(clang_type),
2199                                  clang::TTK_Class);
2200         }
2201 
2202         // Since DW_TAG_structure_type gets used for both classes
2203         // and structures, we may need to set any DW_TAG_member
2204         // fields to have a "private" access if none was specified.
2205         // When we parsed the child members we tracked that actual
2206         // accessibility value for each DW_TAG_member in the
2207         // "member_accessibilities" array. If the value for the
2208         // member is zero, then it was set to the "default_accessibility"
2209         // which for structs was "public". Below we correct this
2210         // by setting any fields to "private" that weren't correctly
2211         // set.
2212         if (is_a_class && !member_accessibilities.empty()) {
2213           // This is a class and all members that didn't have
2214           // their access specified are private.
2215           m_ast.SetDefaultAccessForRecordFields(
2216               m_ast.GetAsRecordDecl(clang_type), eAccessPrivate,
2217               &member_accessibilities.front(), member_accessibilities.size());
2218         }
2219 
2220         if (!base_classes.empty()) {
2221           // Make sure all base classes refer to complete types and not
2222           // forward declarations. If we don't do this, clang will crash
2223           // with an assertion in the call to
2224           // clang_type.SetBaseClassesForClassType()
2225           for (auto &base_class : base_classes) {
2226             clang::TypeSourceInfo *type_source_info =
2227                 base_class->getTypeSourceInfo();
2228             if (type_source_info) {
2229               CompilerType base_class_type(
2230                   &m_ast, type_source_info->getType().getAsOpaquePtr());
2231               if (base_class_type.GetCompleteType() == false) {
2232                 auto module = dwarf->GetObjectFile()->GetModule();
2233                 module->ReportError(":: Class '%s' has a base class '%s' which "
2234                                     "does not have a complete definition.",
2235                                     die.GetName(),
2236                                     base_class_type.GetTypeName().GetCString());
2237                 if (die.GetCU()->GetProducer() ==
2238                     DWARFCompileUnit::eProducerClang)
2239                   module->ReportError(":: Try compiling the source file with "
2240                                       "-fno-limit-debug-info.");
2241 
2242                 // We have no choice other than to pretend that the base class
2243                 // is complete. If we don't do this, clang will crash when we
2244                 // call setBases() inside of
2245                 // "clang_type.SetBaseClassesForClassType()"
2246                 // below. Since we provide layout assistance, all ivars in this
2247                 // class and other classes will be fine, this is the best we can
2248                 // do
2249                 // short of crashing.
2250                 if (ClangASTContext::StartTagDeclarationDefinition(
2251                         base_class_type)) {
2252                   ClangASTContext::CompleteTagDeclarationDefinition(
2253                       base_class_type);
2254                 }
2255               }
2256             }
2257           }
2258           m_ast.SetBaseClassesForClassType(clang_type.GetOpaqueQualType(),
2259                                            &base_classes.front(),
2260                                            base_classes.size());
2261 
2262           // Clang will copy each CXXBaseSpecifier in "base_classes"
2263           // so we have to free them all.
2264           ClangASTContext::DeleteBaseClassSpecifiers(&base_classes.front(),
2265                                                      base_classes.size());
2266         }
2267       }
2268     }
2269 
2270     ClangASTContext::BuildIndirectFields(clang_type);
2271     ClangASTContext::CompleteTagDeclarationDefinition(clang_type);
2272 
2273     if (!layout_info.field_offsets.empty() ||
2274         !layout_info.base_offsets.empty() ||
2275         !layout_info.vbase_offsets.empty()) {
2276       if (type)
2277         layout_info.bit_size = type->GetByteSize() * 8;
2278       if (layout_info.bit_size == 0)
2279         layout_info.bit_size =
2280             die.GetAttributeValueAsUnsigned(DW_AT_byte_size, 0) * 8;
2281 
2282       clang::CXXRecordDecl *record_decl =
2283           m_ast.GetAsCXXRecordDecl(clang_type.GetOpaqueQualType());
2284       if (record_decl) {
2285         if (log) {
2286           ModuleSP module_sp = dwarf->GetObjectFile()->GetModule();
2287 
2288           if (module_sp) {
2289             module_sp->LogMessage(
2290                 log,
2291                 "ClangASTContext::CompleteTypeFromDWARF (clang_type = %p) "
2292                 "caching layout info for record_decl = %p, bit_size = %" PRIu64
2293                 ", alignment = %" PRIu64
2294                 ", field_offsets[%u], base_offsets[%u], vbase_offsets[%u])",
2295                 static_cast<void *>(clang_type.GetOpaqueQualType()),
2296                 static_cast<void *>(record_decl), layout_info.bit_size,
2297                 layout_info.alignment,
2298                 static_cast<uint32_t>(layout_info.field_offsets.size()),
2299                 static_cast<uint32_t>(layout_info.base_offsets.size()),
2300                 static_cast<uint32_t>(layout_info.vbase_offsets.size()));
2301 
2302             uint32_t idx;
2303             {
2304               llvm::DenseMap<const clang::FieldDecl *, uint64_t>::const_iterator
2305                   pos,
2306                   end = layout_info.field_offsets.end();
2307               for (idx = 0, pos = layout_info.field_offsets.begin(); pos != end;
2308                    ++pos, ++idx) {
2309                 module_sp->LogMessage(
2310                     log, "ClangASTContext::CompleteTypeFromDWARF (clang_type = "
2311                          "%p) field[%u] = { bit_offset=%u, name='%s' }",
2312                     static_cast<void *>(clang_type.GetOpaqueQualType()), idx,
2313                     static_cast<uint32_t>(pos->second),
2314                     pos->first->getNameAsString().c_str());
2315               }
2316             }
2317 
2318             {
2319               llvm::DenseMap<const clang::CXXRecordDecl *,
2320                              clang::CharUnits>::const_iterator base_pos,
2321                   base_end = layout_info.base_offsets.end();
2322               for (idx = 0, base_pos = layout_info.base_offsets.begin();
2323                    base_pos != base_end; ++base_pos, ++idx) {
2324                 module_sp->LogMessage(
2325                     log, "ClangASTContext::CompleteTypeFromDWARF (clang_type = "
2326                          "%p) base[%u] = { byte_offset=%u, name='%s' }",
2327                     clang_type.GetOpaqueQualType(), idx,
2328                     (uint32_t)base_pos->second.getQuantity(),
2329                     base_pos->first->getNameAsString().c_str());
2330               }
2331             }
2332             {
2333               llvm::DenseMap<const clang::CXXRecordDecl *,
2334                              clang::CharUnits>::const_iterator vbase_pos,
2335                   vbase_end = layout_info.vbase_offsets.end();
2336               for (idx = 0, vbase_pos = layout_info.vbase_offsets.begin();
2337                    vbase_pos != vbase_end; ++vbase_pos, ++idx) {
2338                 module_sp->LogMessage(
2339                     log, "ClangASTContext::CompleteTypeFromDWARF (clang_type = "
2340                          "%p) vbase[%u] = { byte_offset=%u, name='%s' }",
2341                     static_cast<void *>(clang_type.GetOpaqueQualType()), idx,
2342                     static_cast<uint32_t>(vbase_pos->second.getQuantity()),
2343                     vbase_pos->first->getNameAsString().c_str());
2344               }
2345             }
2346           }
2347         }
2348         GetClangASTImporter().InsertRecordDecl(record_decl, layout_info);
2349       }
2350     }
2351   }
2352 
2353     return (bool)clang_type;
2354 
2355   case DW_TAG_enumeration_type:
2356     if (ClangASTContext::StartTagDeclarationDefinition(clang_type)) {
2357       if (die.HasChildren()) {
2358         SymbolContext sc(die.GetLLDBCompileUnit());
2359         bool is_signed = false;
2360         clang_type.IsIntegerType(is_signed);
2361         ParseChildEnumerators(sc, clang_type, is_signed, type->GetByteSize(),
2362                               die);
2363       }
2364       ClangASTContext::CompleteTagDeclarationDefinition(clang_type);
2365     }
2366     return (bool)clang_type;
2367 
2368   default:
2369     assert(false && "not a forward clang type decl!");
2370     break;
2371   }
2372 
2373   return false;
2374 }
2375 
2376 std::vector<DWARFDIE> DWARFASTParserClang::GetDIEForDeclContext(
2377     lldb_private::CompilerDeclContext decl_context) {
2378   std::vector<DWARFDIE> result;
2379   for (auto it = m_decl_ctx_to_die.find(
2380            (clang::DeclContext *)decl_context.GetOpaqueDeclContext());
2381        it != m_decl_ctx_to_die.end(); it++)
2382     result.push_back(it->second);
2383   return result;
2384 }
2385 
2386 CompilerDecl DWARFASTParserClang::GetDeclForUIDFromDWARF(const DWARFDIE &die) {
2387   clang::Decl *clang_decl = GetClangDeclForDIE(die);
2388   if (clang_decl != nullptr)
2389     return CompilerDecl(&m_ast, clang_decl);
2390   return CompilerDecl();
2391 }
2392 
2393 CompilerDeclContext
2394 DWARFASTParserClang::GetDeclContextForUIDFromDWARF(const DWARFDIE &die) {
2395   clang::DeclContext *clang_decl_ctx = GetClangDeclContextForDIE(die);
2396   if (clang_decl_ctx)
2397     return CompilerDeclContext(&m_ast, clang_decl_ctx);
2398   return CompilerDeclContext();
2399 }
2400 
2401 CompilerDeclContext
2402 DWARFASTParserClang::GetDeclContextContainingUIDFromDWARF(const DWARFDIE &die) {
2403   clang::DeclContext *clang_decl_ctx =
2404       GetClangDeclContextContainingDIE(die, nullptr);
2405   if (clang_decl_ctx)
2406     return CompilerDeclContext(&m_ast, clang_decl_ctx);
2407   return CompilerDeclContext();
2408 }
2409 
2410 size_t DWARFASTParserClang::ParseChildEnumerators(
2411     const SymbolContext &sc, lldb_private::CompilerType &clang_type,
2412     bool is_signed, uint32_t enumerator_byte_size, const DWARFDIE &parent_die) {
2413   if (!parent_die)
2414     return 0;
2415 
2416   size_t enumerators_added = 0;
2417 
2418   for (DWARFDIE die = parent_die.GetFirstChild(); die.IsValid();
2419        die = die.GetSibling()) {
2420     const dw_tag_t tag = die.Tag();
2421     if (tag == DW_TAG_enumerator) {
2422       DWARFAttributes attributes;
2423       const size_t num_child_attributes = die.GetAttributes(attributes);
2424       if (num_child_attributes > 0) {
2425         const char *name = NULL;
2426         bool got_value = false;
2427         int64_t enum_value = 0;
2428         Declaration decl;
2429 
2430         uint32_t i;
2431         for (i = 0; i < num_child_attributes; ++i) {
2432           const dw_attr_t attr = attributes.AttributeAtIndex(i);
2433           DWARFFormValue form_value;
2434           if (attributes.ExtractFormValueAtIndex(i, form_value)) {
2435             switch (attr) {
2436             case DW_AT_const_value:
2437               got_value = true;
2438               if (is_signed)
2439                 enum_value = form_value.Signed();
2440               else
2441                 enum_value = form_value.Unsigned();
2442               break;
2443 
2444             case DW_AT_name:
2445               name = form_value.AsCString();
2446               break;
2447 
2448             case DW_AT_description:
2449             default:
2450             case DW_AT_decl_file:
2451               decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
2452                   form_value.Unsigned()));
2453               break;
2454             case DW_AT_decl_line:
2455               decl.SetLine(form_value.Unsigned());
2456               break;
2457             case DW_AT_decl_column:
2458               decl.SetColumn(form_value.Unsigned());
2459               break;
2460             case DW_AT_sibling:
2461               break;
2462             }
2463           }
2464         }
2465 
2466         if (name && name[0] && got_value) {
2467           m_ast.AddEnumerationValueToEnumerationType(
2468               clang_type.GetOpaqueQualType(),
2469               m_ast.GetEnumerationIntegerType(clang_type.GetOpaqueQualType()),
2470               decl, name, enum_value, enumerator_byte_size * 8);
2471           ++enumerators_added;
2472         }
2473       }
2474     }
2475   }
2476   return enumerators_added;
2477 }
2478 
2479 #if defined(LLDB_CONFIGURATION_DEBUG) || defined(LLDB_CONFIGURATION_RELEASE)
2480 
2481 class DIEStack {
2482 public:
2483   void Push(const DWARFDIE &die) { m_dies.push_back(die); }
2484 
2485   void LogDIEs(Log *log) {
2486     StreamString log_strm;
2487     const size_t n = m_dies.size();
2488     log_strm.Printf("DIEStack[%" PRIu64 "]:\n", (uint64_t)n);
2489     for (size_t i = 0; i < n; i++) {
2490       std::string qualified_name;
2491       const DWARFDIE &die = m_dies[i];
2492       die.GetQualifiedName(qualified_name);
2493       log_strm.Printf("[%" PRIu64 "] 0x%8.8x: %s name='%s'\n", (uint64_t)i,
2494                       die.GetOffset(), die.GetTagAsCString(),
2495                       qualified_name.c_str());
2496     }
2497     log->PutCString(log_strm.GetData());
2498   }
2499   void Pop() { m_dies.pop_back(); }
2500 
2501   class ScopedPopper {
2502   public:
2503     ScopedPopper(DIEStack &die_stack)
2504         : m_die_stack(die_stack), m_valid(false) {}
2505 
2506     void Push(const DWARFDIE &die) {
2507       m_valid = true;
2508       m_die_stack.Push(die);
2509     }
2510 
2511     ~ScopedPopper() {
2512       if (m_valid)
2513         m_die_stack.Pop();
2514     }
2515 
2516   protected:
2517     DIEStack &m_die_stack;
2518     bool m_valid;
2519   };
2520 
2521 protected:
2522   typedef std::vector<DWARFDIE> Stack;
2523   Stack m_dies;
2524 };
2525 #endif
2526 
2527 Function *DWARFASTParserClang::ParseFunctionFromDWARF(const SymbolContext &sc,
2528                                                       const DWARFDIE &die) {
2529   DWARFRangeList func_ranges;
2530   const char *name = NULL;
2531   const char *mangled = NULL;
2532   int decl_file = 0;
2533   int decl_line = 0;
2534   int decl_column = 0;
2535   int call_file = 0;
2536   int call_line = 0;
2537   int call_column = 0;
2538   DWARFExpression frame_base(die.GetCU());
2539 
2540   const dw_tag_t tag = die.Tag();
2541 
2542   if (tag != DW_TAG_subprogram)
2543     return NULL;
2544 
2545   if (die.GetDIENamesAndRanges(name, mangled, func_ranges, decl_file, decl_line,
2546                                decl_column, call_file, call_line, call_column,
2547                                &frame_base)) {
2548 
2549     // Union of all ranges in the function DIE (if the function is
2550     // discontiguous)
2551     AddressRange func_range;
2552     lldb::addr_t lowest_func_addr = func_ranges.GetMinRangeBase(0);
2553     lldb::addr_t highest_func_addr = func_ranges.GetMaxRangeEnd(0);
2554     if (lowest_func_addr != LLDB_INVALID_ADDRESS &&
2555         lowest_func_addr <= highest_func_addr) {
2556       ModuleSP module_sp(die.GetModule());
2557       func_range.GetBaseAddress().ResolveAddressUsingFileSections(
2558           lowest_func_addr, module_sp->GetSectionList());
2559       if (func_range.GetBaseAddress().IsValid())
2560         func_range.SetByteSize(highest_func_addr - lowest_func_addr);
2561     }
2562 
2563     if (func_range.GetBaseAddress().IsValid()) {
2564       Mangled func_name;
2565       if (mangled)
2566         func_name.SetValue(ConstString(mangled), true);
2567       else if (die.GetParent().Tag() == DW_TAG_compile_unit &&
2568                Language::LanguageIsCPlusPlus(die.GetLanguage()) && name &&
2569                strcmp(name, "main") != 0) {
2570         // If the mangled name is not present in the DWARF, generate the
2571         // demangled name
2572         // using the decl context. We skip if the function is "main" as its name
2573         // is
2574         // never mangled.
2575         bool is_static = false;
2576         bool is_variadic = false;
2577         bool has_template_params = false;
2578         unsigned type_quals = 0;
2579         std::vector<CompilerType> param_types;
2580         std::vector<clang::ParmVarDecl *> param_decls;
2581         DWARFDeclContext decl_ctx;
2582         StreamString sstr;
2583 
2584         die.GetDWARFDeclContext(decl_ctx);
2585         sstr << decl_ctx.GetQualifiedName();
2586 
2587         clang::DeclContext *containing_decl_ctx =
2588             GetClangDeclContextContainingDIE(die, nullptr);
2589         ParseChildParameters(sc, containing_decl_ctx, die, true, is_static,
2590                              is_variadic, has_template_params, param_types,
2591                              param_decls, type_quals);
2592         sstr << "(";
2593         for (size_t i = 0; i < param_types.size(); i++) {
2594           if (i > 0)
2595             sstr << ", ";
2596           sstr << param_types[i].GetTypeName();
2597         }
2598         if (is_variadic)
2599           sstr << ", ...";
2600         sstr << ")";
2601         if (type_quals & clang::Qualifiers::Const)
2602           sstr << " const";
2603 
2604         func_name.SetValue(ConstString(sstr.GetData()), false);
2605       } else
2606         func_name.SetValue(ConstString(name), false);
2607 
2608       FunctionSP func_sp;
2609       std::unique_ptr<Declaration> decl_ap;
2610       if (decl_file != 0 || decl_line != 0 || decl_column != 0)
2611         decl_ap.reset(new Declaration(
2612             sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(decl_file),
2613             decl_line, decl_column));
2614 
2615       SymbolFileDWARF *dwarf = die.GetDWARF();
2616       // Supply the type _only_ if it has already been parsed
2617       Type *func_type = dwarf->GetDIEToType().lookup(die.GetDIE());
2618 
2619       assert(func_type == NULL || func_type != DIE_IS_BEING_PARSED);
2620 
2621       if (dwarf->FixupAddress(func_range.GetBaseAddress())) {
2622         const user_id_t func_user_id = die.GetID();
2623         func_sp.reset(new Function(sc.comp_unit,
2624                                    func_user_id, // UserID is the DIE offset
2625                                    func_user_id, func_name, func_type,
2626                                    func_range)); // first address range
2627 
2628         if (func_sp.get() != NULL) {
2629           if (frame_base.IsValid())
2630             func_sp->GetFrameBaseExpression() = frame_base;
2631           sc.comp_unit->AddFunction(func_sp);
2632           return func_sp.get();
2633         }
2634       }
2635     }
2636   }
2637   return NULL;
2638 }
2639 
2640 bool DWARFASTParserClang::ParseChildMembers(
2641     const SymbolContext &sc, const DWARFDIE &parent_die,
2642     CompilerType &class_clang_type, const LanguageType class_language,
2643     std::vector<clang::CXXBaseSpecifier *> &base_classes,
2644     std::vector<int> &member_accessibilities,
2645     DWARFDIECollection &member_function_dies,
2646     DelayedPropertyList &delayed_properties, AccessType &default_accessibility,
2647     bool &is_a_class, ClangASTImporter::LayoutInfo &layout_info) {
2648   if (!parent_die)
2649     return 0;
2650 
2651   // Get the parent byte size so we can verify any members will fit
2652   const uint64_t parent_byte_size =
2653       parent_die.GetAttributeValueAsUnsigned(DW_AT_byte_size, UINT64_MAX) * 8;
2654   const uint64_t parent_bit_size =
2655       parent_byte_size == UINT64_MAX ? UINT64_MAX : parent_byte_size * 8;
2656 
2657   uint32_t member_idx = 0;
2658   BitfieldInfo last_field_info;
2659 
2660   ModuleSP module_sp = parent_die.GetDWARF()->GetObjectFile()->GetModule();
2661   ClangASTContext *ast =
2662       llvm::dyn_cast_or_null<ClangASTContext>(class_clang_type.GetTypeSystem());
2663   if (ast == nullptr)
2664     return 0;
2665 
2666   for (DWARFDIE die = parent_die.GetFirstChild(); die.IsValid();
2667        die = die.GetSibling()) {
2668     dw_tag_t tag = die.Tag();
2669 
2670     switch (tag) {
2671     case DW_TAG_member:
2672     case DW_TAG_APPLE_property: {
2673       DWARFAttributes attributes;
2674       const size_t num_attributes = die.GetAttributes(attributes);
2675       if (num_attributes > 0) {
2676         Declaration decl;
2677         // DWARFExpression location;
2678         const char *name = NULL;
2679         const char *prop_name = NULL;
2680         const char *prop_getter_name = NULL;
2681         const char *prop_setter_name = NULL;
2682         uint32_t prop_attributes = 0;
2683 
2684         bool is_artificial = false;
2685         DWARFFormValue encoding_form;
2686         AccessType accessibility = eAccessNone;
2687         uint32_t member_byte_offset =
2688             (parent_die.Tag() == DW_TAG_union_type) ? 0 : UINT32_MAX;
2689         size_t byte_size = 0;
2690         int64_t bit_offset = 0;
2691         uint64_t data_bit_offset = UINT64_MAX;
2692         size_t bit_size = 0;
2693         bool is_external =
2694             false; // On DW_TAG_members, this means the member is static
2695         uint32_t i;
2696         for (i = 0; i < num_attributes && !is_artificial; ++i) {
2697           const dw_attr_t attr = attributes.AttributeAtIndex(i);
2698           DWARFFormValue form_value;
2699           if (attributes.ExtractFormValueAtIndex(i, form_value)) {
2700             switch (attr) {
2701             case DW_AT_decl_file:
2702               decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
2703                   form_value.Unsigned()));
2704               break;
2705             case DW_AT_decl_line:
2706               decl.SetLine(form_value.Unsigned());
2707               break;
2708             case DW_AT_decl_column:
2709               decl.SetColumn(form_value.Unsigned());
2710               break;
2711             case DW_AT_name:
2712               name = form_value.AsCString();
2713               break;
2714             case DW_AT_type:
2715               encoding_form = form_value;
2716               break;
2717             case DW_AT_bit_offset:
2718               bit_offset = form_value.Signed();
2719               break;
2720             case DW_AT_bit_size:
2721               bit_size = form_value.Unsigned();
2722               break;
2723             case DW_AT_byte_size:
2724               byte_size = form_value.Unsigned();
2725               break;
2726             case DW_AT_data_bit_offset:
2727               data_bit_offset = form_value.Unsigned();
2728               break;
2729             case DW_AT_data_member_location:
2730               if (form_value.BlockData()) {
2731                 Value initialValue(0);
2732                 Value memberOffset(0);
2733                 const DWARFDataExtractor &debug_info_data =
2734                     die.GetDWARF()->get_debug_info_data();
2735                 uint32_t block_length = form_value.Unsigned();
2736                 uint32_t block_offset =
2737                     form_value.BlockData() - debug_info_data.GetDataStart();
2738                 if (DWARFExpression::Evaluate(
2739                         nullptr, // ExecutionContext *
2740                         nullptr, // ClangExpressionVariableList *
2741                         nullptr, // ClangExpressionDeclMap *
2742                         nullptr, // RegisterContext *
2743                         module_sp, debug_info_data, die.GetCU(), block_offset,
2744                         block_length, eRegisterKindDWARF, &initialValue,
2745                         nullptr, memberOffset, nullptr)) {
2746                   member_byte_offset = memberOffset.ResolveValue(NULL).UInt();
2747                 }
2748               } else {
2749                 // With DWARF 3 and later, if the value is an integer constant,
2750                 // this form value is the offset in bytes from the beginning
2751                 // of the containing entity.
2752                 member_byte_offset = form_value.Unsigned();
2753               }
2754               break;
2755 
2756             case DW_AT_accessibility:
2757               accessibility = DW_ACCESS_to_AccessType(form_value.Unsigned());
2758               break;
2759             case DW_AT_artificial:
2760               is_artificial = form_value.Boolean();
2761               break;
2762             case DW_AT_APPLE_property_name:
2763               prop_name = form_value.AsCString();
2764               break;
2765             case DW_AT_APPLE_property_getter:
2766               prop_getter_name = form_value.AsCString();
2767               break;
2768             case DW_AT_APPLE_property_setter:
2769               prop_setter_name = form_value.AsCString();
2770               break;
2771             case DW_AT_APPLE_property_attribute:
2772               prop_attributes = form_value.Unsigned();
2773               break;
2774             case DW_AT_external:
2775               is_external = form_value.Boolean();
2776               break;
2777 
2778             default:
2779             case DW_AT_declaration:
2780             case DW_AT_description:
2781             case DW_AT_mutable:
2782             case DW_AT_visibility:
2783             case DW_AT_sibling:
2784               break;
2785             }
2786           }
2787         }
2788 
2789         if (prop_name) {
2790           ConstString fixed_getter;
2791           ConstString fixed_setter;
2792 
2793           // Check if the property getter/setter were provided as full
2794           // names.  We want basenames, so we extract them.
2795 
2796           if (prop_getter_name && prop_getter_name[0] == '-') {
2797             ObjCLanguage::MethodName prop_getter_method(prop_getter_name, true);
2798             prop_getter_name = prop_getter_method.GetSelector().GetCString();
2799           }
2800 
2801           if (prop_setter_name && prop_setter_name[0] == '-') {
2802             ObjCLanguage::MethodName prop_setter_method(prop_setter_name, true);
2803             prop_setter_name = prop_setter_method.GetSelector().GetCString();
2804           }
2805 
2806           // If the names haven't been provided, they need to be
2807           // filled in.
2808 
2809           if (!prop_getter_name) {
2810             prop_getter_name = prop_name;
2811           }
2812           if (!prop_setter_name && prop_name[0] &&
2813               !(prop_attributes & DW_APPLE_PROPERTY_readonly)) {
2814             StreamString ss;
2815 
2816             ss.Printf("set%c%s:", toupper(prop_name[0]), &prop_name[1]);
2817 
2818             fixed_setter.SetCString(ss.GetData());
2819             prop_setter_name = fixed_setter.GetCString();
2820           }
2821         }
2822 
2823         // Clang has a DWARF generation bug where sometimes it
2824         // represents fields that are references with bad byte size
2825         // and bit size/offset information such as:
2826         //
2827         //  DW_AT_byte_size( 0x00 )
2828         //  DW_AT_bit_size( 0x40 )
2829         //  DW_AT_bit_offset( 0xffffffffffffffc0 )
2830         //
2831         // So check the bit offset to make sure it is sane, and if
2832         // the values are not sane, remove them. If we don't do this
2833         // then we will end up with a crash if we try to use this
2834         // type in an expression when clang becomes unhappy with its
2835         // recycled debug info.
2836 
2837         if (byte_size == 0 && bit_offset < 0) {
2838           bit_size = 0;
2839           bit_offset = 0;
2840         }
2841 
2842         // FIXME: Make Clang ignore Objective-C accessibility for expressions
2843         if (class_language == eLanguageTypeObjC ||
2844             class_language == eLanguageTypeObjC_plus_plus)
2845           accessibility = eAccessNone;
2846 
2847         if (member_idx == 0 && !is_artificial && name &&
2848             (strstr(name, "_vptr$") == name)) {
2849           // Not all compilers will mark the vtable pointer
2850           // member as artificial (llvm-gcc). We can't have
2851           // the virtual members in our classes otherwise it
2852           // throws off all child offsets since we end up
2853           // having and extra pointer sized member in our
2854           // class layouts.
2855           is_artificial = true;
2856         }
2857 
2858         // Handle static members
2859         if (is_external && member_byte_offset == UINT32_MAX) {
2860           Type *var_type = die.ResolveTypeUID(DIERef(encoding_form));
2861 
2862           if (var_type) {
2863             if (accessibility == eAccessNone)
2864               accessibility = eAccessPublic;
2865             ClangASTContext::AddVariableToRecordType(
2866                 class_clang_type, name, var_type->GetLayoutCompilerType(),
2867                 accessibility);
2868           }
2869           break;
2870         }
2871 
2872         if (is_artificial == false) {
2873           Type *member_type = die.ResolveTypeUID(DIERef(encoding_form));
2874 
2875           clang::FieldDecl *field_decl = NULL;
2876           if (tag == DW_TAG_member) {
2877             if (member_type) {
2878               if (accessibility == eAccessNone)
2879                 accessibility = default_accessibility;
2880               member_accessibilities.push_back(accessibility);
2881 
2882               uint64_t field_bit_offset =
2883                   (member_byte_offset == UINT32_MAX ? 0
2884                                                     : (member_byte_offset * 8));
2885               if (bit_size > 0) {
2886 
2887                 BitfieldInfo this_field_info;
2888                 this_field_info.bit_offset = field_bit_offset;
2889                 this_field_info.bit_size = bit_size;
2890 
2891                 /////////////////////////////////////////////////////////////
2892                 // How to locate a field given the DWARF debug information
2893                 //
2894                 // AT_byte_size indicates the size of the word in which the
2895                 // bit offset must be interpreted.
2896                 //
2897                 // AT_data_member_location indicates the byte offset of the
2898                 // word from the base address of the structure.
2899                 //
2900                 // AT_bit_offset indicates how many bits into the word
2901                 // (according to the host endianness) the low-order bit of
2902                 // the field starts.  AT_bit_offset can be negative.
2903                 //
2904                 // AT_bit_size indicates the size of the field in bits.
2905                 /////////////////////////////////////////////////////////////
2906 
2907                 if (data_bit_offset != UINT64_MAX) {
2908                   this_field_info.bit_offset = data_bit_offset;
2909                 } else {
2910                   if (byte_size == 0)
2911                     byte_size = member_type->GetByteSize();
2912 
2913                   ObjectFile *objfile = die.GetDWARF()->GetObjectFile();
2914                   if (objfile->GetByteOrder() == eByteOrderLittle) {
2915                     this_field_info.bit_offset += byte_size * 8;
2916                     this_field_info.bit_offset -= (bit_offset + bit_size);
2917                   } else {
2918                     this_field_info.bit_offset += bit_offset;
2919                   }
2920                 }
2921 
2922                 if ((this_field_info.bit_offset >= parent_bit_size) ||
2923                     !last_field_info.NextBitfieldOffsetIsValid(
2924                         this_field_info.bit_offset)) {
2925                   ObjectFile *objfile = die.GetDWARF()->GetObjectFile();
2926                   objfile->GetModule()->ReportWarning(
2927                       "0x%8.8" PRIx64 ": %s bitfield named \"%s\" has invalid "
2928                                       "bit offset (0x%8.8" PRIx64
2929                       ") member will be ignored. Please file a bug against the "
2930                       "compiler and include the preprocessed output for %s\n",
2931                       die.GetID(), DW_TAG_value_to_name(tag), name,
2932                       this_field_info.bit_offset,
2933                       sc.comp_unit ? sc.comp_unit->GetPath().c_str()
2934                                    : "the source file");
2935                   this_field_info.Clear();
2936                   continue;
2937                 }
2938 
2939                 // Update the field bit offset we will report for layout
2940                 field_bit_offset = this_field_info.bit_offset;
2941 
2942                 // If the member to be emitted did not start on a character
2943                 // boundary and there is
2944                 // empty space between the last field and this one, then we need
2945                 // to emit an
2946                 // anonymous member filling up the space up to its start.  There
2947                 // are three cases
2948                 // here:
2949                 //
2950                 // 1 If the previous member ended on a character boundary, then
2951                 // we can emit an
2952                 //   anonymous member starting at the most recent character
2953                 //   boundary.
2954                 //
2955                 // 2 If the previous member did not end on a character boundary
2956                 // and the distance
2957                 //   from the end of the previous member to the current member
2958                 //   is less than a
2959                 //   word width, then we can emit an anonymous member starting
2960                 //   right after the
2961                 //   previous member and right before this member.
2962                 //
2963                 // 3 If the previous member did not end on a character boundary
2964                 // and the distance
2965                 //   from the end of the previous member to the current member
2966                 //   is greater than
2967                 //   or equal a word width, then we act as in Case 1.
2968 
2969                 const uint64_t character_width = 8;
2970                 const uint64_t word_width = 32;
2971 
2972                 // Objective-C has invalid DW_AT_bit_offset values in older
2973                 // versions
2974                 // of clang, so we have to be careful and only insert unnamed
2975                 // bitfields
2976                 // if we have a new enough clang.
2977                 bool detect_unnamed_bitfields = true;
2978 
2979                 if (class_language == eLanguageTypeObjC ||
2980                     class_language == eLanguageTypeObjC_plus_plus)
2981                   detect_unnamed_bitfields =
2982                       die.GetCU()->Supports_unnamed_objc_bitfields();
2983 
2984                 if (detect_unnamed_bitfields) {
2985                   BitfieldInfo anon_field_info;
2986 
2987                   if ((this_field_info.bit_offset % character_width) !=
2988                       0) // not char aligned
2989                   {
2990                     uint64_t last_field_end = 0;
2991 
2992                     if (last_field_info.IsValid())
2993                       last_field_end =
2994                           last_field_info.bit_offset + last_field_info.bit_size;
2995 
2996                     if (this_field_info.bit_offset != last_field_end) {
2997                       if (((last_field_end % character_width) == 0) || // case 1
2998                           (this_field_info.bit_offset - last_field_end >=
2999                            word_width)) // case 3
3000                       {
3001                         anon_field_info.bit_size =
3002                             this_field_info.bit_offset % character_width;
3003                         anon_field_info.bit_offset =
3004                             this_field_info.bit_offset -
3005                             anon_field_info.bit_size;
3006                       } else // case 2
3007                       {
3008                         anon_field_info.bit_size =
3009                             this_field_info.bit_offset - last_field_end;
3010                         anon_field_info.bit_offset = last_field_end;
3011                       }
3012                     }
3013                   }
3014 
3015                   if (anon_field_info.IsValid()) {
3016                     clang::FieldDecl *unnamed_bitfield_decl =
3017                         ClangASTContext::AddFieldToRecordType(
3018                             class_clang_type, NULL,
3019                             m_ast.GetBuiltinTypeForEncodingAndBitSize(
3020                                 eEncodingSint, word_width),
3021                             accessibility, anon_field_info.bit_size);
3022 
3023                     layout_info.field_offsets.insert(std::make_pair(
3024                         unnamed_bitfield_decl, anon_field_info.bit_offset));
3025                   }
3026                 }
3027                 last_field_info = this_field_info;
3028               } else {
3029                 last_field_info.Clear();
3030               }
3031 
3032               CompilerType member_clang_type =
3033                   member_type->GetLayoutCompilerType();
3034               if (!member_clang_type.IsCompleteType())
3035                 member_clang_type.GetCompleteType();
3036 
3037               {
3038                 // Older versions of clang emit array[0] and array[1] in the
3039                 // same way (<rdar://problem/12566646>).
3040                 // If the current field is at the end of the structure, then
3041                 // there is definitely no room for extra
3042                 // elements and we override the type to array[0].
3043 
3044                 CompilerType member_array_element_type;
3045                 uint64_t member_array_size;
3046                 bool member_array_is_incomplete;
3047 
3048                 if (member_clang_type.IsArrayType(
3049                         &member_array_element_type, &member_array_size,
3050                         &member_array_is_incomplete) &&
3051                     !member_array_is_incomplete) {
3052                   uint64_t parent_byte_size =
3053                       parent_die.GetAttributeValueAsUnsigned(DW_AT_byte_size,
3054                                                              UINT64_MAX);
3055 
3056                   if (member_byte_offset >= parent_byte_size) {
3057                     if (member_array_size != 1 &&
3058                         (member_array_size != 0 ||
3059                          member_byte_offset > parent_byte_size)) {
3060                       module_sp->ReportError(
3061                           "0x%8.8" PRIx64
3062                           ": DW_TAG_member '%s' refers to type 0x%8.8" PRIx64
3063                           " which extends beyond the bounds of 0x%8.8" PRIx64,
3064                           die.GetID(), name, encoding_form.Reference(),
3065                           parent_die.GetID());
3066                     }
3067 
3068                     member_clang_type = m_ast.CreateArrayType(
3069                         member_array_element_type, 0, false);
3070                   }
3071                 }
3072               }
3073 
3074               if (ClangASTContext::IsCXXClassType(member_clang_type) &&
3075                   member_clang_type.GetCompleteType() == false) {
3076                 if (die.GetCU()->GetProducer() ==
3077                     DWARFCompileUnit::eProducerClang)
3078                   module_sp->ReportError(
3079                       "DWARF DIE at 0x%8.8x (class %s) has a member variable "
3080                       "0x%8.8x (%s) whose type is a forward declaration, not a "
3081                       "complete definition.\nTry compiling the source file "
3082                       "with -fno-limit-debug-info",
3083                       parent_die.GetOffset(), parent_die.GetName(),
3084                       die.GetOffset(), name);
3085                 else
3086                   module_sp->ReportError(
3087                       "DWARF DIE at 0x%8.8x (class %s) has a member variable "
3088                       "0x%8.8x (%s) whose type is a forward declaration, not a "
3089                       "complete definition.\nPlease file a bug against the "
3090                       "compiler and include the preprocessed output for %s",
3091                       parent_die.GetOffset(), parent_die.GetName(),
3092                       die.GetOffset(), name,
3093                       sc.comp_unit ? sc.comp_unit->GetPath().c_str()
3094                                    : "the source file");
3095                 // We have no choice other than to pretend that the member class
3096                 // is complete. If we don't do this, clang will crash when
3097                 // trying
3098                 // to layout the class. Since we provide layout assistance, all
3099                 // ivars in this class and other classes will be fine, this is
3100                 // the best we can do short of crashing.
3101                 if (ClangASTContext::StartTagDeclarationDefinition(
3102                         member_clang_type)) {
3103                   ClangASTContext::CompleteTagDeclarationDefinition(
3104                       member_clang_type);
3105                 } else {
3106                   module_sp->ReportError(
3107                       "DWARF DIE at 0x%8.8x (class %s) has a member variable "
3108                       "0x%8.8x (%s) whose type claims to be a C++ class but we "
3109                       "were not able to start its definition.\nPlease file a "
3110                       "bug and attach the file at the start of this error "
3111                       "message",
3112                       parent_die.GetOffset(), parent_die.GetName(),
3113                       die.GetOffset(), name);
3114                 }
3115               }
3116 
3117               field_decl = ClangASTContext::AddFieldToRecordType(
3118                   class_clang_type, name, member_clang_type, accessibility,
3119                   bit_size);
3120 
3121               m_ast.SetMetadataAsUserID(field_decl, die.GetID());
3122 
3123               layout_info.field_offsets.insert(
3124                   std::make_pair(field_decl, field_bit_offset));
3125             } else {
3126               if (name)
3127                 module_sp->ReportError(
3128                     "0x%8.8" PRIx64
3129                     ": DW_TAG_member '%s' refers to type 0x%8.8" PRIx64
3130                     " which was unable to be parsed",
3131                     die.GetID(), name, encoding_form.Reference());
3132               else
3133                 module_sp->ReportError(
3134                     "0x%8.8" PRIx64
3135                     ": DW_TAG_member refers to type 0x%8.8" PRIx64
3136                     " which was unable to be parsed",
3137                     die.GetID(), encoding_form.Reference());
3138             }
3139           }
3140 
3141           if (prop_name != NULL && member_type) {
3142             clang::ObjCIvarDecl *ivar_decl = NULL;
3143 
3144             if (field_decl) {
3145               ivar_decl = clang::dyn_cast<clang::ObjCIvarDecl>(field_decl);
3146               assert(ivar_decl != NULL);
3147             }
3148 
3149             ClangASTMetadata metadata;
3150             metadata.SetUserID(die.GetID());
3151             delayed_properties.push_back(DelayedAddObjCClassProperty(
3152                 class_clang_type, prop_name,
3153                 member_type->GetLayoutCompilerType(), ivar_decl,
3154                 prop_setter_name, prop_getter_name, prop_attributes,
3155                 &metadata));
3156 
3157             if (ivar_decl)
3158               m_ast.SetMetadataAsUserID(ivar_decl, die.GetID());
3159           }
3160         }
3161       }
3162       ++member_idx;
3163     } break;
3164 
3165     case DW_TAG_subprogram:
3166       // Let the type parsing code handle this one for us.
3167       member_function_dies.Append(die);
3168       break;
3169 
3170     case DW_TAG_inheritance: {
3171       is_a_class = true;
3172       if (default_accessibility == eAccessNone)
3173         default_accessibility = eAccessPrivate;
3174       // TODO: implement DW_TAG_inheritance type parsing
3175       DWARFAttributes attributes;
3176       const size_t num_attributes = die.GetAttributes(attributes);
3177       if (num_attributes > 0) {
3178         Declaration decl;
3179         DWARFExpression location(die.GetCU());
3180         DWARFFormValue encoding_form;
3181         AccessType accessibility = default_accessibility;
3182         bool is_virtual = false;
3183         bool is_base_of_class = true;
3184         off_t member_byte_offset = 0;
3185         uint32_t i;
3186         for (i = 0; i < num_attributes; ++i) {
3187           const dw_attr_t attr = attributes.AttributeAtIndex(i);
3188           DWARFFormValue form_value;
3189           if (attributes.ExtractFormValueAtIndex(i, form_value)) {
3190             switch (attr) {
3191             case DW_AT_decl_file:
3192               decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
3193                   form_value.Unsigned()));
3194               break;
3195             case DW_AT_decl_line:
3196               decl.SetLine(form_value.Unsigned());
3197               break;
3198             case DW_AT_decl_column:
3199               decl.SetColumn(form_value.Unsigned());
3200               break;
3201             case DW_AT_type:
3202               encoding_form = form_value;
3203               break;
3204             case DW_AT_data_member_location:
3205               if (form_value.BlockData()) {
3206                 Value initialValue(0);
3207                 Value memberOffset(0);
3208                 const DWARFDataExtractor &debug_info_data =
3209                     die.GetDWARF()->get_debug_info_data();
3210                 uint32_t block_length = form_value.Unsigned();
3211                 uint32_t block_offset =
3212                     form_value.BlockData() - debug_info_data.GetDataStart();
3213                 if (DWARFExpression::Evaluate(
3214                         nullptr, nullptr, nullptr, nullptr, module_sp,
3215                         debug_info_data, die.GetCU(), block_offset,
3216                         block_length, eRegisterKindDWARF, &initialValue,
3217                         nullptr, memberOffset, nullptr)) {
3218                   member_byte_offset = memberOffset.ResolveValue(NULL).UInt();
3219                 }
3220               } else {
3221                 // With DWARF 3 and later, if the value is an integer constant,
3222                 // this form value is the offset in bytes from the beginning
3223                 // of the containing entity.
3224                 member_byte_offset = form_value.Unsigned();
3225               }
3226               break;
3227 
3228             case DW_AT_accessibility:
3229               accessibility = DW_ACCESS_to_AccessType(form_value.Unsigned());
3230               break;
3231 
3232             case DW_AT_virtuality:
3233               is_virtual = form_value.Boolean();
3234               break;
3235 
3236             case DW_AT_sibling:
3237               break;
3238 
3239             default:
3240               break;
3241             }
3242           }
3243         }
3244 
3245         Type *base_class_type = die.ResolveTypeUID(DIERef(encoding_form));
3246         if (base_class_type == NULL) {
3247           module_sp->ReportError("0x%8.8x: DW_TAG_inheritance failed to "
3248                                  "resolve the base class at 0x%8.8" PRIx64
3249                                  " from enclosing type 0x%8.8x. \nPlease file "
3250                                  "a bug and attach the file at the start of "
3251                                  "this error message",
3252                                  die.GetOffset(), encoding_form.Reference(),
3253                                  parent_die.GetOffset());
3254           break;
3255         }
3256 
3257         CompilerType base_class_clang_type =
3258             base_class_type->GetFullCompilerType();
3259         assert(base_class_clang_type);
3260         if (class_language == eLanguageTypeObjC) {
3261           ast->SetObjCSuperClass(class_clang_type, base_class_clang_type);
3262         } else {
3263           base_classes.push_back(ast->CreateBaseClassSpecifier(
3264               base_class_clang_type.GetOpaqueQualType(), accessibility,
3265               is_virtual, is_base_of_class));
3266 
3267           if (is_virtual) {
3268             // Do not specify any offset for virtual inheritance. The DWARF
3269             // produced by clang doesn't
3270             // give us a constant offset, but gives us a DWARF expressions that
3271             // requires an actual object
3272             // in memory. the DW_AT_data_member_location for a virtual base
3273             // class looks like:
3274             //      DW_AT_data_member_location( DW_OP_dup, DW_OP_deref,
3275             //      DW_OP_constu(0x00000018), DW_OP_minus, DW_OP_deref,
3276             //      DW_OP_plus )
3277             // Given this, there is really no valid response we can give to
3278             // clang for virtual base
3279             // class offsets, and this should eventually be removed from
3280             // LayoutRecordType() in the external
3281             // AST source in clang.
3282           } else {
3283             layout_info.base_offsets.insert(std::make_pair(
3284                 ast->GetAsCXXRecordDecl(
3285                     base_class_clang_type.GetOpaqueQualType()),
3286                 clang::CharUnits::fromQuantity(member_byte_offset)));
3287           }
3288         }
3289       }
3290     } break;
3291 
3292     default:
3293       break;
3294     }
3295   }
3296 
3297   return true;
3298 }
3299 
3300 size_t DWARFASTParserClang::ParseChildParameters(
3301     const SymbolContext &sc, clang::DeclContext *containing_decl_ctx,
3302     const DWARFDIE &parent_die, bool skip_artificial, bool &is_static,
3303     bool &is_variadic, bool &has_template_params,
3304     std::vector<CompilerType> &function_param_types,
3305     std::vector<clang::ParmVarDecl *> &function_param_decls,
3306     unsigned &type_quals) {
3307   if (!parent_die)
3308     return 0;
3309 
3310   size_t arg_idx = 0;
3311   for (DWARFDIE die = parent_die.GetFirstChild(); die.IsValid();
3312        die = die.GetSibling()) {
3313     const dw_tag_t tag = die.Tag();
3314     switch (tag) {
3315     case DW_TAG_formal_parameter: {
3316       DWARFAttributes attributes;
3317       const size_t num_attributes = die.GetAttributes(attributes);
3318       if (num_attributes > 0) {
3319         const char *name = NULL;
3320         Declaration decl;
3321         DWARFFormValue param_type_die_form;
3322         bool is_artificial = false;
3323         // one of None, Auto, Register, Extern, Static, PrivateExtern
3324 
3325         clang::StorageClass storage = clang::SC_None;
3326         uint32_t i;
3327         for (i = 0; i < num_attributes; ++i) {
3328           const dw_attr_t attr = attributes.AttributeAtIndex(i);
3329           DWARFFormValue form_value;
3330           if (attributes.ExtractFormValueAtIndex(i, form_value)) {
3331             switch (attr) {
3332             case DW_AT_decl_file:
3333               decl.SetFile(sc.comp_unit->GetSupportFiles().GetFileSpecAtIndex(
3334                   form_value.Unsigned()));
3335               break;
3336             case DW_AT_decl_line:
3337               decl.SetLine(form_value.Unsigned());
3338               break;
3339             case DW_AT_decl_column:
3340               decl.SetColumn(form_value.Unsigned());
3341               break;
3342             case DW_AT_name:
3343               name = form_value.AsCString();
3344               break;
3345             case DW_AT_type:
3346               param_type_die_form = form_value;
3347               break;
3348             case DW_AT_artificial:
3349               is_artificial = form_value.Boolean();
3350               break;
3351             case DW_AT_location:
3352             //                          if (form_value.BlockData())
3353             //                          {
3354             //                              const DWARFDataExtractor&
3355             //                              debug_info_data = debug_info();
3356             //                              uint32_t block_length =
3357             //                              form_value.Unsigned();
3358             //                              DWARFDataExtractor
3359             //                              location(debug_info_data,
3360             //                              form_value.BlockData() -
3361             //                              debug_info_data.GetDataStart(),
3362             //                              block_length);
3363             //                          }
3364             //                          else
3365             //                          {
3366             //                          }
3367             //                          break;
3368             case DW_AT_const_value:
3369             case DW_AT_default_value:
3370             case DW_AT_description:
3371             case DW_AT_endianity:
3372             case DW_AT_is_optional:
3373             case DW_AT_segment:
3374             case DW_AT_variable_parameter:
3375             default:
3376             case DW_AT_abstract_origin:
3377             case DW_AT_sibling:
3378               break;
3379             }
3380           }
3381         }
3382 
3383         bool skip = false;
3384         if (skip_artificial) {
3385           if (is_artificial) {
3386             // In order to determine if a C++ member function is
3387             // "const" we have to look at the const-ness of "this"...
3388             // Ugly, but that
3389             if (arg_idx == 0) {
3390               if (DeclKindIsCXXClass(containing_decl_ctx->getDeclKind())) {
3391                 // Often times compilers omit the "this" name for the
3392                 // specification DIEs, so we can't rely upon the name
3393                 // being in the formal parameter DIE...
3394                 if (name == NULL || ::strcmp(name, "this") == 0) {
3395                   Type *this_type =
3396                       die.ResolveTypeUID(DIERef(param_type_die_form));
3397                   if (this_type) {
3398                     uint32_t encoding_mask = this_type->GetEncodingMask();
3399                     if (encoding_mask & Type::eEncodingIsPointerUID) {
3400                       is_static = false;
3401 
3402                       if (encoding_mask & (1u << Type::eEncodingIsConstUID))
3403                         type_quals |= clang::Qualifiers::Const;
3404                       if (encoding_mask & (1u << Type::eEncodingIsVolatileUID))
3405                         type_quals |= clang::Qualifiers::Volatile;
3406                     }
3407                   }
3408                 }
3409               }
3410             }
3411             skip = true;
3412           } else {
3413 
3414             // HACK: Objective C formal parameters "self" and "_cmd"
3415             // are not marked as artificial in the DWARF...
3416             CompileUnit *comp_unit = die.GetLLDBCompileUnit();
3417             if (comp_unit) {
3418               switch (comp_unit->GetLanguage()) {
3419               case eLanguageTypeObjC:
3420               case eLanguageTypeObjC_plus_plus:
3421                 if (name && name[0] &&
3422                     (strcmp(name, "self") == 0 || strcmp(name, "_cmd") == 0))
3423                   skip = true;
3424                 break;
3425               default:
3426                 break;
3427               }
3428             }
3429           }
3430         }
3431 
3432         if (!skip) {
3433           Type *type = die.ResolveTypeUID(DIERef(param_type_die_form));
3434           if (type) {
3435             function_param_types.push_back(type->GetForwardCompilerType());
3436 
3437             clang::ParmVarDecl *param_var_decl =
3438                 m_ast.CreateParameterDeclaration(
3439                     name, type->GetForwardCompilerType(), storage);
3440             assert(param_var_decl);
3441             function_param_decls.push_back(param_var_decl);
3442 
3443             m_ast.SetMetadataAsUserID(param_var_decl, die.GetID());
3444           }
3445         }
3446       }
3447       arg_idx++;
3448     } break;
3449 
3450     case DW_TAG_unspecified_parameters:
3451       is_variadic = true;
3452       break;
3453 
3454     case DW_TAG_template_type_parameter:
3455     case DW_TAG_template_value_parameter:
3456       // The one caller of this was never using the template_param_infos,
3457       // and the local variable was taking up a large amount of stack space
3458       // in SymbolFileDWARF::ParseType() so this was removed. If we ever need
3459       // the template params back, we can add them back.
3460       // ParseTemplateDIE (dwarf_cu, die, template_param_infos);
3461       has_template_params = true;
3462       break;
3463 
3464     default:
3465       break;
3466     }
3467   }
3468   return arg_idx;
3469 }
3470 
3471 void DWARFASTParserClang::ParseChildArrayInfo(
3472     const SymbolContext &sc, const DWARFDIE &parent_die, int64_t &first_index,
3473     std::vector<uint64_t> &element_orders, uint32_t &byte_stride,
3474     uint32_t &bit_stride) {
3475   if (!parent_die)
3476     return;
3477 
3478   for (DWARFDIE die = parent_die.GetFirstChild(); die.IsValid();
3479        die = die.GetSibling()) {
3480     const dw_tag_t tag = die.Tag();
3481     switch (tag) {
3482     case DW_TAG_subrange_type: {
3483       DWARFAttributes attributes;
3484       const size_t num_child_attributes = die.GetAttributes(attributes);
3485       if (num_child_attributes > 0) {
3486         uint64_t num_elements = 0;
3487         uint64_t lower_bound = 0;
3488         uint64_t upper_bound = 0;
3489         bool upper_bound_valid = false;
3490         uint32_t i;
3491         for (i = 0; i < num_child_attributes; ++i) {
3492           const dw_attr_t attr = attributes.AttributeAtIndex(i);
3493           DWARFFormValue form_value;
3494           if (attributes.ExtractFormValueAtIndex(i, form_value)) {
3495             switch (attr) {
3496             case DW_AT_name:
3497               break;
3498 
3499             case DW_AT_count:
3500               num_elements = form_value.Unsigned();
3501               break;
3502 
3503             case DW_AT_bit_stride:
3504               bit_stride = form_value.Unsigned();
3505               break;
3506 
3507             case DW_AT_byte_stride:
3508               byte_stride = form_value.Unsigned();
3509               break;
3510 
3511             case DW_AT_lower_bound:
3512               lower_bound = form_value.Unsigned();
3513               break;
3514 
3515             case DW_AT_upper_bound:
3516               upper_bound_valid = true;
3517               upper_bound = form_value.Unsigned();
3518               break;
3519 
3520             default:
3521             case DW_AT_abstract_origin:
3522             case DW_AT_accessibility:
3523             case DW_AT_allocated:
3524             case DW_AT_associated:
3525             case DW_AT_data_location:
3526             case DW_AT_declaration:
3527             case DW_AT_description:
3528             case DW_AT_sibling:
3529             case DW_AT_threads_scaled:
3530             case DW_AT_type:
3531             case DW_AT_visibility:
3532               break;
3533             }
3534           }
3535         }
3536 
3537         if (num_elements == 0) {
3538           if (upper_bound_valid && upper_bound >= lower_bound)
3539             num_elements = upper_bound - lower_bound + 1;
3540         }
3541 
3542         element_orders.push_back(num_elements);
3543       }
3544     } break;
3545     }
3546   }
3547 }
3548 
3549 Type *DWARFASTParserClang::GetTypeForDIE(const DWARFDIE &die) {
3550   if (die) {
3551     SymbolFileDWARF *dwarf = die.GetDWARF();
3552     DWARFAttributes attributes;
3553     const size_t num_attributes = die.GetAttributes(attributes);
3554     if (num_attributes > 0) {
3555       DWARFFormValue type_die_form;
3556       for (size_t i = 0; i < num_attributes; ++i) {
3557         dw_attr_t attr = attributes.AttributeAtIndex(i);
3558         DWARFFormValue form_value;
3559 
3560         if (attr == DW_AT_type &&
3561             attributes.ExtractFormValueAtIndex(i, form_value))
3562           return dwarf->ResolveTypeUID(dwarf->GetDIE(DIERef(form_value)), true);
3563       }
3564     }
3565   }
3566 
3567   return nullptr;
3568 }
3569 
3570 clang::Decl *DWARFASTParserClang::GetClangDeclForDIE(const DWARFDIE &die) {
3571   if (!die)
3572     return nullptr;
3573 
3574   switch (die.Tag()) {
3575   case DW_TAG_variable:
3576   case DW_TAG_constant:
3577   case DW_TAG_formal_parameter:
3578   case DW_TAG_imported_declaration:
3579   case DW_TAG_imported_module:
3580     break;
3581   default:
3582     return nullptr;
3583   }
3584 
3585   DIEToDeclMap::iterator cache_pos = m_die_to_decl.find(die.GetDIE());
3586   if (cache_pos != m_die_to_decl.end())
3587     return cache_pos->second;
3588 
3589   if (DWARFDIE spec_die = die.GetReferencedDIE(DW_AT_specification)) {
3590     clang::Decl *decl = GetClangDeclForDIE(spec_die);
3591     m_die_to_decl[die.GetDIE()] = decl;
3592     m_decl_to_die[decl].insert(die.GetDIE());
3593     return decl;
3594   }
3595 
3596   if (DWARFDIE abstract_origin_die =
3597           die.GetReferencedDIE(DW_AT_abstract_origin)) {
3598     clang::Decl *decl = GetClangDeclForDIE(abstract_origin_die);
3599     m_die_to_decl[die.GetDIE()] = decl;
3600     m_decl_to_die[decl].insert(die.GetDIE());
3601     return decl;
3602   }
3603 
3604   clang::Decl *decl = nullptr;
3605   switch (die.Tag()) {
3606   case DW_TAG_variable:
3607   case DW_TAG_constant:
3608   case DW_TAG_formal_parameter: {
3609     SymbolFileDWARF *dwarf = die.GetDWARF();
3610     Type *type = GetTypeForDIE(die);
3611     if (dwarf && type) {
3612       const char *name = die.GetName();
3613       clang::DeclContext *decl_context =
3614           ClangASTContext::DeclContextGetAsDeclContext(
3615               dwarf->GetDeclContextContainingUID(die.GetID()));
3616       decl = m_ast.CreateVariableDeclaration(
3617           decl_context, name,
3618           ClangUtil::GetQualType(type->GetForwardCompilerType()));
3619     }
3620     break;
3621   }
3622   case DW_TAG_imported_declaration: {
3623     SymbolFileDWARF *dwarf = die.GetDWARF();
3624     DWARFDIE imported_uid = die.GetAttributeValueAsReferenceDIE(DW_AT_import);
3625     if (imported_uid) {
3626       CompilerDecl imported_decl = imported_uid.GetDecl();
3627       if (imported_decl) {
3628         clang::DeclContext *decl_context =
3629             ClangASTContext::DeclContextGetAsDeclContext(
3630                 dwarf->GetDeclContextContainingUID(die.GetID()));
3631         if (clang::NamedDecl *clang_imported_decl =
3632                 llvm::dyn_cast<clang::NamedDecl>(
3633                     (clang::Decl *)imported_decl.GetOpaqueDecl()))
3634           decl =
3635               m_ast.CreateUsingDeclaration(decl_context, clang_imported_decl);
3636       }
3637     }
3638     break;
3639   }
3640   case DW_TAG_imported_module: {
3641     SymbolFileDWARF *dwarf = die.GetDWARF();
3642     DWARFDIE imported_uid = die.GetAttributeValueAsReferenceDIE(DW_AT_import);
3643 
3644     if (imported_uid) {
3645       CompilerDeclContext imported_decl_ctx = imported_uid.GetDeclContext();
3646       if (imported_decl_ctx) {
3647         clang::DeclContext *decl_context =
3648             ClangASTContext::DeclContextGetAsDeclContext(
3649                 dwarf->GetDeclContextContainingUID(die.GetID()));
3650         if (clang::NamespaceDecl *ns_decl =
3651                 ClangASTContext::DeclContextGetAsNamespaceDecl(
3652                     imported_decl_ctx))
3653           decl = m_ast.CreateUsingDirectiveDeclaration(decl_context, ns_decl);
3654       }
3655     }
3656     break;
3657   }
3658   default:
3659     break;
3660   }
3661 
3662   m_die_to_decl[die.GetDIE()] = decl;
3663   m_decl_to_die[decl].insert(die.GetDIE());
3664 
3665   return decl;
3666 }
3667 
3668 clang::DeclContext *
3669 DWARFASTParserClang::GetClangDeclContextForDIE(const DWARFDIE &die) {
3670   if (die) {
3671     clang::DeclContext *decl_ctx = GetCachedClangDeclContextForDIE(die);
3672     if (decl_ctx)
3673       return decl_ctx;
3674 
3675     bool try_parsing_type = true;
3676     switch (die.Tag()) {
3677     case DW_TAG_compile_unit:
3678       decl_ctx = m_ast.GetTranslationUnitDecl();
3679       try_parsing_type = false;
3680       break;
3681 
3682     case DW_TAG_namespace:
3683       decl_ctx = ResolveNamespaceDIE(die);
3684       try_parsing_type = false;
3685       break;
3686 
3687     case DW_TAG_lexical_block:
3688       decl_ctx = (clang::DeclContext *)ResolveBlockDIE(die);
3689       try_parsing_type = false;
3690       break;
3691 
3692     default:
3693       break;
3694     }
3695 
3696     if (decl_ctx == nullptr && try_parsing_type) {
3697       Type *type = die.GetDWARF()->ResolveType(die);
3698       if (type)
3699         decl_ctx = GetCachedClangDeclContextForDIE(die);
3700     }
3701 
3702     if (decl_ctx) {
3703       LinkDeclContextToDIE(decl_ctx, die);
3704       return decl_ctx;
3705     }
3706   }
3707   return nullptr;
3708 }
3709 
3710 clang::BlockDecl *DWARFASTParserClang::ResolveBlockDIE(const DWARFDIE &die) {
3711   if (die && die.Tag() == DW_TAG_lexical_block) {
3712     clang::BlockDecl *decl =
3713         llvm::cast_or_null<clang::BlockDecl>(m_die_to_decl_ctx[die.GetDIE()]);
3714 
3715     if (!decl) {
3716       DWARFDIE decl_context_die;
3717       clang::DeclContext *decl_context =
3718           GetClangDeclContextContainingDIE(die, &decl_context_die);
3719       decl = m_ast.CreateBlockDeclaration(decl_context);
3720 
3721       if (decl)
3722         LinkDeclContextToDIE((clang::DeclContext *)decl, die);
3723     }
3724 
3725     return decl;
3726   }
3727   return nullptr;
3728 }
3729 
3730 clang::NamespaceDecl *
3731 DWARFASTParserClang::ResolveNamespaceDIE(const DWARFDIE &die) {
3732   if (die && die.Tag() == DW_TAG_namespace) {
3733     // See if we already parsed this namespace DIE and associated it with a
3734     // uniqued namespace declaration
3735     clang::NamespaceDecl *namespace_decl =
3736         static_cast<clang::NamespaceDecl *>(m_die_to_decl_ctx[die.GetDIE()]);
3737     if (namespace_decl)
3738       return namespace_decl;
3739     else {
3740       const char *namespace_name = die.GetName();
3741       clang::DeclContext *containing_decl_ctx =
3742           GetClangDeclContextContainingDIE(die, nullptr);
3743       namespace_decl = m_ast.GetUniqueNamespaceDeclaration(namespace_name,
3744                                                            containing_decl_ctx);
3745       Log *log =
3746           nullptr; // (LogChannelDWARF::GetLogIfAll(DWARF_LOG_DEBUG_INFO));
3747       if (log) {
3748         SymbolFileDWARF *dwarf = die.GetDWARF();
3749         if (namespace_name) {
3750           dwarf->GetObjectFile()->GetModule()->LogMessage(
3751               log, "ASTContext => %p: 0x%8.8" PRIx64
3752                    ": DW_TAG_namespace with DW_AT_name(\"%s\") => "
3753                    "clang::NamespaceDecl *%p (original = %p)",
3754               static_cast<void *>(m_ast.getASTContext()), die.GetID(),
3755               namespace_name, static_cast<void *>(namespace_decl),
3756               static_cast<void *>(namespace_decl->getOriginalNamespace()));
3757         } else {
3758           dwarf->GetObjectFile()->GetModule()->LogMessage(
3759               log, "ASTContext => %p: 0x%8.8" PRIx64
3760                    ": DW_TAG_namespace (anonymous) => clang::NamespaceDecl *%p "
3761                    "(original = %p)",
3762               static_cast<void *>(m_ast.getASTContext()), die.GetID(),
3763               static_cast<void *>(namespace_decl),
3764               static_cast<void *>(namespace_decl->getOriginalNamespace()));
3765         }
3766       }
3767 
3768       if (namespace_decl)
3769         LinkDeclContextToDIE((clang::DeclContext *)namespace_decl, die);
3770       return namespace_decl;
3771     }
3772   }
3773   return nullptr;
3774 }
3775 
3776 clang::DeclContext *DWARFASTParserClang::GetClangDeclContextContainingDIE(
3777     const DWARFDIE &die, DWARFDIE *decl_ctx_die_copy) {
3778   SymbolFileDWARF *dwarf = die.GetDWARF();
3779 
3780   DWARFDIE decl_ctx_die = dwarf->GetDeclContextDIEContainingDIE(die);
3781 
3782   if (decl_ctx_die_copy)
3783     *decl_ctx_die_copy = decl_ctx_die;
3784 
3785   if (decl_ctx_die) {
3786     clang::DeclContext *clang_decl_ctx =
3787         GetClangDeclContextForDIE(decl_ctx_die);
3788     if (clang_decl_ctx)
3789       return clang_decl_ctx;
3790   }
3791   return m_ast.GetTranslationUnitDecl();
3792 }
3793 
3794 clang::DeclContext *
3795 DWARFASTParserClang::GetCachedClangDeclContextForDIE(const DWARFDIE &die) {
3796   if (die) {
3797     DIEToDeclContextMap::iterator pos = m_die_to_decl_ctx.find(die.GetDIE());
3798     if (pos != m_die_to_decl_ctx.end())
3799       return pos->second;
3800   }
3801   return nullptr;
3802 }
3803 
3804 void DWARFASTParserClang::LinkDeclContextToDIE(clang::DeclContext *decl_ctx,
3805                                                const DWARFDIE &die) {
3806   m_die_to_decl_ctx[die.GetDIE()] = decl_ctx;
3807   // There can be many DIEs for a single decl context
3808   // m_decl_ctx_to_die[decl_ctx].insert(die.GetDIE());
3809   m_decl_ctx_to_die.insert(std::make_pair(decl_ctx, die));
3810 }
3811 
3812 bool DWARFASTParserClang::CopyUniqueClassMethodTypes(
3813     const DWARFDIE &src_class_die, const DWARFDIE &dst_class_die,
3814     lldb_private::Type *class_type, DWARFDIECollection &failures) {
3815   if (!class_type || !src_class_die || !dst_class_die)
3816     return false;
3817   if (src_class_die.Tag() != dst_class_die.Tag())
3818     return false;
3819 
3820   // We need to complete the class type so we can get all of the method types
3821   // parsed so we can then unique those types to their equivalent counterparts
3822   // in "dst_cu" and "dst_class_die"
3823   class_type->GetFullCompilerType();
3824 
3825   DWARFDIE src_die;
3826   DWARFDIE dst_die;
3827   UniqueCStringMap<DWARFDIE> src_name_to_die;
3828   UniqueCStringMap<DWARFDIE> dst_name_to_die;
3829   UniqueCStringMap<DWARFDIE> src_name_to_die_artificial;
3830   UniqueCStringMap<DWARFDIE> dst_name_to_die_artificial;
3831   for (src_die = src_class_die.GetFirstChild(); src_die.IsValid();
3832        src_die = src_die.GetSibling()) {
3833     if (src_die.Tag() == DW_TAG_subprogram) {
3834       // Make sure this is a declaration and not a concrete instance by looking
3835       // for DW_AT_declaration set to 1. Sometimes concrete function instances
3836       // are placed inside the class definitions and shouldn't be included in
3837       // the list of things are are tracking here.
3838       if (src_die.GetAttributeValueAsUnsigned(DW_AT_declaration, 0) == 1) {
3839         const char *src_name = src_die.GetMangledName();
3840         if (src_name) {
3841           ConstString src_const_name(src_name);
3842           if (src_die.GetAttributeValueAsUnsigned(DW_AT_artificial, 0))
3843             src_name_to_die_artificial.Append(src_const_name.GetStringRef(),
3844                                               src_die);
3845           else
3846             src_name_to_die.Append(src_const_name.GetStringRef(), src_die);
3847         }
3848       }
3849     }
3850   }
3851   for (dst_die = dst_class_die.GetFirstChild(); dst_die.IsValid();
3852        dst_die = dst_die.GetSibling()) {
3853     if (dst_die.Tag() == DW_TAG_subprogram) {
3854       // Make sure this is a declaration and not a concrete instance by looking
3855       // for DW_AT_declaration set to 1. Sometimes concrete function instances
3856       // are placed inside the class definitions and shouldn't be included in
3857       // the list of things are are tracking here.
3858       if (dst_die.GetAttributeValueAsUnsigned(DW_AT_declaration, 0) == 1) {
3859         const char *dst_name = dst_die.GetMangledName();
3860         if (dst_name) {
3861           ConstString dst_const_name(dst_name);
3862           if (dst_die.GetAttributeValueAsUnsigned(DW_AT_artificial, 0))
3863             dst_name_to_die_artificial.Append(dst_const_name.GetStringRef(),
3864                                               dst_die);
3865           else
3866             dst_name_to_die.Append(dst_const_name.GetStringRef(), dst_die);
3867         }
3868       }
3869     }
3870   }
3871   const uint32_t src_size = src_name_to_die.GetSize();
3872   const uint32_t dst_size = dst_name_to_die.GetSize();
3873   Log *log = nullptr; // (LogChannelDWARF::GetLogIfAny(DWARF_LOG_DEBUG_INFO |
3874                       // DWARF_LOG_TYPE_COMPLETION));
3875 
3876   // Is everything kosher so we can go through the members at top speed?
3877   bool fast_path = true;
3878 
3879   if (src_size != dst_size) {
3880     if (src_size != 0 && dst_size != 0) {
3881       if (log)
3882         log->Printf("warning: trying to unique class DIE 0x%8.8x to 0x%8.8x, "
3883                     "but they didn't have the same size (src=%d, dst=%d)",
3884                     src_class_die.GetOffset(), dst_class_die.GetOffset(),
3885                     src_size, dst_size);
3886     }
3887 
3888     fast_path = false;
3889   }
3890 
3891   uint32_t idx;
3892 
3893   if (fast_path) {
3894     for (idx = 0; idx < src_size; ++idx) {
3895       src_die = src_name_to_die.GetValueAtIndexUnchecked(idx);
3896       dst_die = dst_name_to_die.GetValueAtIndexUnchecked(idx);
3897 
3898       if (src_die.Tag() != dst_die.Tag()) {
3899         if (log)
3900           log->Printf("warning: tried to unique class DIE 0x%8.8x to 0x%8.8x, "
3901                       "but 0x%8.8x (%s) tags didn't match 0x%8.8x (%s)",
3902                       src_class_die.GetOffset(), dst_class_die.GetOffset(),
3903                       src_die.GetOffset(), src_die.GetTagAsCString(),
3904                       dst_die.GetOffset(), dst_die.GetTagAsCString());
3905         fast_path = false;
3906       }
3907 
3908       const char *src_name = src_die.GetMangledName();
3909       const char *dst_name = dst_die.GetMangledName();
3910 
3911       // Make sure the names match
3912       if (src_name == dst_name || (strcmp(src_name, dst_name) == 0))
3913         continue;
3914 
3915       if (log)
3916         log->Printf("warning: tried to unique class DIE 0x%8.8x to 0x%8.8x, "
3917                     "but 0x%8.8x (%s) names didn't match 0x%8.8x (%s)",
3918                     src_class_die.GetOffset(), dst_class_die.GetOffset(),
3919                     src_die.GetOffset(), src_name, dst_die.GetOffset(),
3920                     dst_name);
3921 
3922       fast_path = false;
3923     }
3924   }
3925 
3926   DWARFASTParserClang *src_dwarf_ast_parser =
3927       (DWARFASTParserClang *)src_die.GetDWARFParser();
3928   DWARFASTParserClang *dst_dwarf_ast_parser =
3929       (DWARFASTParserClang *)dst_die.GetDWARFParser();
3930 
3931   // Now do the work of linking the DeclContexts and Types.
3932   if (fast_path) {
3933     // We can do this quickly.  Just run across the tables index-for-index since
3934     // we know each node has matching names and tags.
3935     for (idx = 0; idx < src_size; ++idx) {
3936       src_die = src_name_to_die.GetValueAtIndexUnchecked(idx);
3937       dst_die = dst_name_to_die.GetValueAtIndexUnchecked(idx);
3938 
3939       clang::DeclContext *src_decl_ctx =
3940           src_dwarf_ast_parser->m_die_to_decl_ctx[src_die.GetDIE()];
3941       if (src_decl_ctx) {
3942         if (log)
3943           log->Printf("uniquing decl context %p from 0x%8.8x for 0x%8.8x",
3944                       static_cast<void *>(src_decl_ctx), src_die.GetOffset(),
3945                       dst_die.GetOffset());
3946         dst_dwarf_ast_parser->LinkDeclContextToDIE(src_decl_ctx, dst_die);
3947       } else {
3948         if (log)
3949           log->Printf("warning: tried to unique decl context from 0x%8.8x for "
3950                       "0x%8.8x, but none was found",
3951                       src_die.GetOffset(), dst_die.GetOffset());
3952       }
3953 
3954       Type *src_child_type =
3955           dst_die.GetDWARF()->GetDIEToType()[src_die.GetDIE()];
3956       if (src_child_type) {
3957         if (log)
3958           log->Printf(
3959               "uniquing type %p (uid=0x%" PRIx64 ") from 0x%8.8x for 0x%8.8x",
3960               static_cast<void *>(src_child_type), src_child_type->GetID(),
3961               src_die.GetOffset(), dst_die.GetOffset());
3962         dst_die.GetDWARF()->GetDIEToType()[dst_die.GetDIE()] = src_child_type;
3963       } else {
3964         if (log)
3965           log->Printf("warning: tried to unique lldb_private::Type from "
3966                       "0x%8.8x for 0x%8.8x, but none was found",
3967                       src_die.GetOffset(), dst_die.GetOffset());
3968       }
3969     }
3970   } else {
3971     // We must do this slowly.  For each member of the destination, look
3972     // up a member in the source with the same name, check its tag, and
3973     // unique them if everything matches up.  Report failures.
3974 
3975     if (!src_name_to_die.IsEmpty() && !dst_name_to_die.IsEmpty()) {
3976       src_name_to_die.Sort();
3977 
3978       for (idx = 0; idx < dst_size; ++idx) {
3979         llvm::StringRef dst_name = dst_name_to_die.GetCStringAtIndex(idx);
3980         dst_die = dst_name_to_die.GetValueAtIndexUnchecked(idx);
3981         src_die = src_name_to_die.Find(dst_name, DWARFDIE());
3982 
3983         if (src_die && (src_die.Tag() == dst_die.Tag())) {
3984           clang::DeclContext *src_decl_ctx =
3985               src_dwarf_ast_parser->m_die_to_decl_ctx[src_die.GetDIE()];
3986           if (src_decl_ctx) {
3987             if (log)
3988               log->Printf("uniquing decl context %p from 0x%8.8x for 0x%8.8x",
3989                           static_cast<void *>(src_decl_ctx),
3990                           src_die.GetOffset(), dst_die.GetOffset());
3991             dst_dwarf_ast_parser->LinkDeclContextToDIE(src_decl_ctx, dst_die);
3992           } else {
3993             if (log)
3994               log->Printf("warning: tried to unique decl context from 0x%8.8x "
3995                           "for 0x%8.8x, but none was found",
3996                           src_die.GetOffset(), dst_die.GetOffset());
3997           }
3998 
3999           Type *src_child_type =
4000               dst_die.GetDWARF()->GetDIEToType()[src_die.GetDIE()];
4001           if (src_child_type) {
4002             if (log)
4003               log->Printf("uniquing type %p (uid=0x%" PRIx64
4004                           ") from 0x%8.8x for 0x%8.8x",
4005                           static_cast<void *>(src_child_type),
4006                           src_child_type->GetID(), src_die.GetOffset(),
4007                           dst_die.GetOffset());
4008             dst_die.GetDWARF()->GetDIEToType()[dst_die.GetDIE()] =
4009                 src_child_type;
4010           } else {
4011             if (log)
4012               log->Printf("warning: tried to unique lldb_private::Type from "
4013                           "0x%8.8x for 0x%8.8x, but none was found",
4014                           src_die.GetOffset(), dst_die.GetOffset());
4015           }
4016         } else {
4017           if (log)
4018             log->Printf("warning: couldn't find a match for 0x%8.8x",
4019                         dst_die.GetOffset());
4020 
4021           failures.Append(dst_die);
4022         }
4023       }
4024     }
4025   }
4026 
4027   const uint32_t src_size_artificial = src_name_to_die_artificial.GetSize();
4028   const uint32_t dst_size_artificial = dst_name_to_die_artificial.GetSize();
4029 
4030   if (src_size_artificial && dst_size_artificial) {
4031     dst_name_to_die_artificial.Sort();
4032 
4033     for (idx = 0; idx < src_size_artificial; ++idx) {
4034       llvm::StringRef src_name_artificial =
4035           src_name_to_die_artificial.GetCStringAtIndex(idx);
4036       src_die = src_name_to_die_artificial.GetValueAtIndexUnchecked(idx);
4037       dst_die =
4038           dst_name_to_die_artificial.Find(src_name_artificial, DWARFDIE());
4039 
4040       if (dst_die) {
4041         // Both classes have the artificial types, link them
4042         clang::DeclContext *src_decl_ctx =
4043             src_dwarf_ast_parser->m_die_to_decl_ctx[src_die.GetDIE()];
4044         if (src_decl_ctx) {
4045           if (log)
4046             log->Printf("uniquing decl context %p from 0x%8.8x for 0x%8.8x",
4047                         static_cast<void *>(src_decl_ctx), src_die.GetOffset(),
4048                         dst_die.GetOffset());
4049           dst_dwarf_ast_parser->LinkDeclContextToDIE(src_decl_ctx, dst_die);
4050         } else {
4051           if (log)
4052             log->Printf("warning: tried to unique decl context from 0x%8.8x "
4053                         "for 0x%8.8x, but none was found",
4054                         src_die.GetOffset(), dst_die.GetOffset());
4055         }
4056 
4057         Type *src_child_type =
4058             dst_die.GetDWARF()->GetDIEToType()[src_die.GetDIE()];
4059         if (src_child_type) {
4060           if (log)
4061             log->Printf(
4062                 "uniquing type %p (uid=0x%" PRIx64 ") from 0x%8.8x for 0x%8.8x",
4063                 static_cast<void *>(src_child_type), src_child_type->GetID(),
4064                 src_die.GetOffset(), dst_die.GetOffset());
4065           dst_die.GetDWARF()->GetDIEToType()[dst_die.GetDIE()] = src_child_type;
4066         } else {
4067           if (log)
4068             log->Printf("warning: tried to unique lldb_private::Type from "
4069                         "0x%8.8x for 0x%8.8x, but none was found",
4070                         src_die.GetOffset(), dst_die.GetOffset());
4071         }
4072       }
4073     }
4074   }
4075 
4076   if (dst_size_artificial) {
4077     for (idx = 0; idx < dst_size_artificial; ++idx) {
4078       llvm::StringRef dst_name_artificial =
4079           dst_name_to_die_artificial.GetCStringAtIndex(idx);
4080       dst_die = dst_name_to_die_artificial.GetValueAtIndexUnchecked(idx);
4081       if (log)
4082         log->Printf("warning: need to create artificial method for 0x%8.8x for "
4083                     "method '%s'",
4084                     dst_die.GetOffset(), dst_name_artificial.str().c_str());
4085 
4086       failures.Append(dst_die);
4087     }
4088   }
4089 
4090   return (failures.Size() != 0);
4091 }
4092