1 //===--- CGDebugInfo.cpp - Emit Debug Information for a Module ------------===// 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 // This coordinates the debug information generation while generating code. 11 // 12 //===----------------------------------------------------------------------===// 13 14 #include "CGDebugInfo.h" 15 #include "CGBlocks.h" 16 #include "CGCXXABI.h" 17 #include "CGObjCRuntime.h" 18 #include "CGRecordLayout.h" 19 #include "CodeGenFunction.h" 20 #include "CodeGenModule.h" 21 #include "ConstantEmitter.h" 22 #include "clang/AST/ASTContext.h" 23 #include "clang/AST/DeclFriend.h" 24 #include "clang/AST/DeclObjC.h" 25 #include "clang/AST/DeclTemplate.h" 26 #include "clang/AST/Expr.h" 27 #include "clang/AST/RecordLayout.h" 28 #include "clang/Basic/FileManager.h" 29 #include "clang/Basic/SourceManager.h" 30 #include "clang/Basic/Version.h" 31 #include "clang/Frontend/CodeGenOptions.h" 32 #include "clang/Frontend/FrontendOptions.h" 33 #include "clang/Lex/HeaderSearchOptions.h" 34 #include "clang/Lex/ModuleMap.h" 35 #include "clang/Lex/PreprocessorOptions.h" 36 #include "llvm/ADT/DenseSet.h" 37 #include "llvm/ADT/SmallVector.h" 38 #include "llvm/ADT/StringExtras.h" 39 #include "llvm/IR/Constants.h" 40 #include "llvm/IR/DataLayout.h" 41 #include "llvm/IR/DerivedTypes.h" 42 #include "llvm/IR/Instructions.h" 43 #include "llvm/IR/Intrinsics.h" 44 #include "llvm/IR/Metadata.h" 45 #include "llvm/IR/Module.h" 46 #include "llvm/Support/FileSystem.h" 47 #include "llvm/Support/MD5.h" 48 #include "llvm/Support/Path.h" 49 using namespace clang; 50 using namespace clang::CodeGen; 51 52 static uint32_t getTypeAlignIfRequired(const Type *Ty, const ASTContext &Ctx) { 53 auto TI = Ctx.getTypeInfo(Ty); 54 return TI.AlignIsRequired ? TI.Align : 0; 55 } 56 57 static uint32_t getTypeAlignIfRequired(QualType Ty, const ASTContext &Ctx) { 58 return getTypeAlignIfRequired(Ty.getTypePtr(), Ctx); 59 } 60 61 static uint32_t getDeclAlignIfRequired(const Decl *D, const ASTContext &Ctx) { 62 return D->hasAttr<AlignedAttr>() ? D->getMaxAlignment() : 0; 63 } 64 65 CGDebugInfo::CGDebugInfo(CodeGenModule &CGM) 66 : CGM(CGM), DebugKind(CGM.getCodeGenOpts().getDebugInfo()), 67 DebugTypeExtRefs(CGM.getCodeGenOpts().DebugTypeExtRefs), 68 DBuilder(CGM.getModule()) { 69 for (const auto &KV : CGM.getCodeGenOpts().DebugPrefixMap) 70 DebugPrefixMap[KV.first] = KV.second; 71 CreateCompileUnit(); 72 } 73 74 CGDebugInfo::~CGDebugInfo() { 75 assert(LexicalBlockStack.empty() && 76 "Region stack mismatch, stack not empty!"); 77 } 78 79 ApplyDebugLocation::ApplyDebugLocation(CodeGenFunction &CGF, 80 SourceLocation TemporaryLocation) 81 : CGF(&CGF) { 82 init(TemporaryLocation); 83 } 84 85 ApplyDebugLocation::ApplyDebugLocation(CodeGenFunction &CGF, 86 bool DefaultToEmpty, 87 SourceLocation TemporaryLocation) 88 : CGF(&CGF) { 89 init(TemporaryLocation, DefaultToEmpty); 90 } 91 92 void ApplyDebugLocation::init(SourceLocation TemporaryLocation, 93 bool DefaultToEmpty) { 94 auto *DI = CGF->getDebugInfo(); 95 if (!DI) { 96 CGF = nullptr; 97 return; 98 } 99 100 OriginalLocation = CGF->Builder.getCurrentDebugLocation(); 101 102 if (OriginalLocation && !DI->CGM.getExpressionLocationsEnabled()) 103 return; 104 105 if (TemporaryLocation.isValid()) { 106 DI->EmitLocation(CGF->Builder, TemporaryLocation); 107 return; 108 } 109 110 if (DefaultToEmpty) { 111 CGF->Builder.SetCurrentDebugLocation(llvm::DebugLoc()); 112 return; 113 } 114 115 // Construct a location that has a valid scope, but no line info. 116 assert(!DI->LexicalBlockStack.empty()); 117 CGF->Builder.SetCurrentDebugLocation(llvm::DebugLoc::get( 118 0, 0, DI->LexicalBlockStack.back(), DI->getInlinedAt())); 119 } 120 121 ApplyDebugLocation::ApplyDebugLocation(CodeGenFunction &CGF, const Expr *E) 122 : CGF(&CGF) { 123 init(E->getExprLoc()); 124 } 125 126 ApplyDebugLocation::ApplyDebugLocation(CodeGenFunction &CGF, llvm::DebugLoc Loc) 127 : CGF(&CGF) { 128 if (!CGF.getDebugInfo()) { 129 this->CGF = nullptr; 130 return; 131 } 132 OriginalLocation = CGF.Builder.getCurrentDebugLocation(); 133 if (Loc) 134 CGF.Builder.SetCurrentDebugLocation(std::move(Loc)); 135 } 136 137 ApplyDebugLocation::~ApplyDebugLocation() { 138 // Query CGF so the location isn't overwritten when location updates are 139 // temporarily disabled (for C++ default function arguments) 140 if (CGF) 141 CGF->Builder.SetCurrentDebugLocation(std::move(OriginalLocation)); 142 } 143 144 ApplyInlineDebugLocation::ApplyInlineDebugLocation(CodeGenFunction &CGF, 145 GlobalDecl InlinedFn) 146 : CGF(&CGF) { 147 if (!CGF.getDebugInfo()) { 148 this->CGF = nullptr; 149 return; 150 } 151 auto &DI = *CGF.getDebugInfo(); 152 SavedLocation = DI.getLocation(); 153 assert((DI.getInlinedAt() == 154 CGF.Builder.getCurrentDebugLocation()->getInlinedAt()) && 155 "CGDebugInfo and IRBuilder are out of sync"); 156 157 DI.EmitInlineFunctionStart(CGF.Builder, InlinedFn); 158 } 159 160 ApplyInlineDebugLocation::~ApplyInlineDebugLocation() { 161 if (!CGF) 162 return; 163 auto &DI = *CGF->getDebugInfo(); 164 DI.EmitInlineFunctionEnd(CGF->Builder); 165 DI.EmitLocation(CGF->Builder, SavedLocation); 166 } 167 168 void CGDebugInfo::setLocation(SourceLocation Loc) { 169 // If the new location isn't valid return. 170 if (Loc.isInvalid()) 171 return; 172 173 CurLoc = CGM.getContext().getSourceManager().getExpansionLoc(Loc); 174 175 // If we've changed files in the middle of a lexical scope go ahead 176 // and create a new lexical scope with file node if it's different 177 // from the one in the scope. 178 if (LexicalBlockStack.empty()) 179 return; 180 181 SourceManager &SM = CGM.getContext().getSourceManager(); 182 auto *Scope = cast<llvm::DIScope>(LexicalBlockStack.back()); 183 PresumedLoc PCLoc = SM.getPresumedLoc(CurLoc); 184 185 if (PCLoc.isInvalid() || Scope->getFilename() == PCLoc.getFilename()) 186 return; 187 188 if (auto *LBF = dyn_cast<llvm::DILexicalBlockFile>(Scope)) { 189 LexicalBlockStack.pop_back(); 190 LexicalBlockStack.emplace_back(DBuilder.createLexicalBlockFile( 191 LBF->getScope(), getOrCreateFile(CurLoc))); 192 } else if (isa<llvm::DILexicalBlock>(Scope) || 193 isa<llvm::DISubprogram>(Scope)) { 194 LexicalBlockStack.pop_back(); 195 LexicalBlockStack.emplace_back( 196 DBuilder.createLexicalBlockFile(Scope, getOrCreateFile(CurLoc))); 197 } 198 } 199 200 llvm::DIScope *CGDebugInfo::getDeclContextDescriptor(const Decl *D) { 201 llvm::DIScope *Mod = getParentModuleOrNull(D); 202 return getContextDescriptor(cast<Decl>(D->getDeclContext()), 203 Mod ? Mod : TheCU); 204 } 205 206 llvm::DIScope *CGDebugInfo::getContextDescriptor(const Decl *Context, 207 llvm::DIScope *Default) { 208 if (!Context) 209 return Default; 210 211 auto I = RegionMap.find(Context); 212 if (I != RegionMap.end()) { 213 llvm::Metadata *V = I->second; 214 return dyn_cast_or_null<llvm::DIScope>(V); 215 } 216 217 // Check namespace. 218 if (const auto *NSDecl = dyn_cast<NamespaceDecl>(Context)) 219 return getOrCreateNamespace(NSDecl); 220 221 if (const auto *RDecl = dyn_cast<RecordDecl>(Context)) 222 if (!RDecl->isDependentType()) 223 return getOrCreateType(CGM.getContext().getTypeDeclType(RDecl), 224 getOrCreateMainFile()); 225 return Default; 226 } 227 228 PrintingPolicy CGDebugInfo::getPrintingPolicy() const { 229 PrintingPolicy PP = CGM.getContext().getPrintingPolicy(); 230 231 // If we're emitting codeview, it's important to try to match MSVC's naming so 232 // that visualizers written for MSVC will trigger for our class names. In 233 // particular, we can't have spaces between arguments of standard templates 234 // like basic_string and vector. 235 if (CGM.getCodeGenOpts().EmitCodeView) 236 PP.MSVCFormatting = true; 237 238 return PP; 239 } 240 241 StringRef CGDebugInfo::getFunctionName(const FunctionDecl *FD) { 242 assert(FD && "Invalid FunctionDecl!"); 243 IdentifierInfo *FII = FD->getIdentifier(); 244 FunctionTemplateSpecializationInfo *Info = 245 FD->getTemplateSpecializationInfo(); 246 247 // Emit the unqualified name in normal operation. LLVM and the debugger can 248 // compute the fully qualified name from the scope chain. If we're only 249 // emitting line table info, there won't be any scope chains, so emit the 250 // fully qualified name here so that stack traces are more accurate. 251 // FIXME: Do this when emitting DWARF as well as when emitting CodeView after 252 // evaluating the size impact. 253 bool UseQualifiedName = DebugKind == codegenoptions::DebugLineTablesOnly && 254 CGM.getCodeGenOpts().EmitCodeView; 255 256 if (!Info && FII && !UseQualifiedName) 257 return FII->getName(); 258 259 SmallString<128> NS; 260 llvm::raw_svector_ostream OS(NS); 261 if (!UseQualifiedName) 262 FD->printName(OS); 263 else 264 FD->printQualifiedName(OS, getPrintingPolicy()); 265 266 // Add any template specialization args. 267 if (Info) { 268 const TemplateArgumentList *TArgs = Info->TemplateArguments; 269 printTemplateArgumentList(OS, TArgs->asArray(), getPrintingPolicy()); 270 } 271 272 // Copy this name on the side and use its reference. 273 return internString(OS.str()); 274 } 275 276 StringRef CGDebugInfo::getObjCMethodName(const ObjCMethodDecl *OMD) { 277 SmallString<256> MethodName; 278 llvm::raw_svector_ostream OS(MethodName); 279 OS << (OMD->isInstanceMethod() ? '-' : '+') << '['; 280 const DeclContext *DC = OMD->getDeclContext(); 281 if (const auto *OID = dyn_cast<ObjCImplementationDecl>(DC)) { 282 OS << OID->getName(); 283 } else if (const auto *OID = dyn_cast<ObjCInterfaceDecl>(DC)) { 284 OS << OID->getName(); 285 } else if (const auto *OC = dyn_cast<ObjCCategoryDecl>(DC)) { 286 if (OC->IsClassExtension()) { 287 OS << OC->getClassInterface()->getName(); 288 } else { 289 OS << OC->getIdentifier()->getNameStart() << '(' 290 << OC->getIdentifier()->getNameStart() << ')'; 291 } 292 } else if (const auto *OCD = dyn_cast<ObjCCategoryImplDecl>(DC)) { 293 OS << OCD->getClassInterface()->getName() << '(' << OCD->getName() << ')'; 294 } else if (isa<ObjCProtocolDecl>(DC)) { 295 // We can extract the type of the class from the self pointer. 296 if (ImplicitParamDecl *SelfDecl = OMD->getSelfDecl()) { 297 QualType ClassTy = 298 cast<ObjCObjectPointerType>(SelfDecl->getType())->getPointeeType(); 299 ClassTy.print(OS, PrintingPolicy(LangOptions())); 300 } 301 } 302 OS << ' ' << OMD->getSelector().getAsString() << ']'; 303 304 return internString(OS.str()); 305 } 306 307 StringRef CGDebugInfo::getSelectorName(Selector S) { 308 return internString(S.getAsString()); 309 } 310 311 StringRef CGDebugInfo::getClassName(const RecordDecl *RD) { 312 if (isa<ClassTemplateSpecializationDecl>(RD)) { 313 SmallString<128> Name; 314 llvm::raw_svector_ostream OS(Name); 315 RD->getNameForDiagnostic(OS, getPrintingPolicy(), 316 /*Qualified*/ false); 317 318 // Copy this name on the side and use its reference. 319 return internString(Name); 320 } 321 322 // quick optimization to avoid having to intern strings that are already 323 // stored reliably elsewhere 324 if (const IdentifierInfo *II = RD->getIdentifier()) 325 return II->getName(); 326 327 // The CodeView printer in LLVM wants to see the names of unnamed types: it is 328 // used to reconstruct the fully qualified type names. 329 if (CGM.getCodeGenOpts().EmitCodeView) { 330 if (const TypedefNameDecl *D = RD->getTypedefNameForAnonDecl()) { 331 assert(RD->getDeclContext() == D->getDeclContext() && 332 "Typedef should not be in another decl context!"); 333 assert(D->getDeclName().getAsIdentifierInfo() && 334 "Typedef was not named!"); 335 return D->getDeclName().getAsIdentifierInfo()->getName(); 336 } 337 338 if (CGM.getLangOpts().CPlusPlus) { 339 StringRef Name; 340 341 ASTContext &Context = CGM.getContext(); 342 if (const DeclaratorDecl *DD = Context.getDeclaratorForUnnamedTagDecl(RD)) 343 // Anonymous types without a name for linkage purposes have their 344 // declarator mangled in if they have one. 345 Name = DD->getName(); 346 else if (const TypedefNameDecl *TND = 347 Context.getTypedefNameForUnnamedTagDecl(RD)) 348 // Anonymous types without a name for linkage purposes have their 349 // associate typedef mangled in if they have one. 350 Name = TND->getName(); 351 352 if (!Name.empty()) { 353 SmallString<256> UnnamedType("<unnamed-type-"); 354 UnnamedType += Name; 355 UnnamedType += '>'; 356 return internString(UnnamedType); 357 } 358 } 359 } 360 361 return StringRef(); 362 } 363 364 Optional<llvm::DIFile::ChecksumKind> 365 CGDebugInfo::computeChecksum(FileID FID, SmallString<32> &Checksum) const { 366 Checksum.clear(); 367 368 if (!CGM.getCodeGenOpts().EmitCodeView && 369 CGM.getCodeGenOpts().DwarfVersion < 5) 370 return None; 371 372 SourceManager &SM = CGM.getContext().getSourceManager(); 373 bool Invalid; 374 llvm::MemoryBuffer *MemBuffer = SM.getBuffer(FID, &Invalid); 375 if (Invalid) 376 return None; 377 378 llvm::MD5 Hash; 379 llvm::MD5::MD5Result Result; 380 381 Hash.update(MemBuffer->getBuffer()); 382 Hash.final(Result); 383 384 Hash.stringifyResult(Result, Checksum); 385 return llvm::DIFile::CSK_MD5; 386 } 387 388 Optional<StringRef> CGDebugInfo::getSource(const SourceManager &SM, 389 FileID FID) { 390 if (!CGM.getCodeGenOpts().EmbedSource) 391 return None; 392 393 bool SourceInvalid = false; 394 StringRef Source = SM.getBufferData(FID, &SourceInvalid); 395 396 if (SourceInvalid) 397 return None; 398 399 return Source; 400 } 401 402 llvm::DIFile *CGDebugInfo::getOrCreateFile(SourceLocation Loc) { 403 if (!Loc.isValid()) 404 // If Location is not valid then use main input file. 405 return getOrCreateMainFile(); 406 407 SourceManager &SM = CGM.getContext().getSourceManager(); 408 PresumedLoc PLoc = SM.getPresumedLoc(Loc); 409 410 if (PLoc.isInvalid() || StringRef(PLoc.getFilename()).empty()) 411 // If the location is not valid then use main input file. 412 return getOrCreateMainFile(); 413 414 // Cache the results. 415 const char *fname = PLoc.getFilename(); 416 auto It = DIFileCache.find(fname); 417 418 if (It != DIFileCache.end()) { 419 // Verify that the information still exists. 420 if (llvm::Metadata *V = It->second) 421 return cast<llvm::DIFile>(V); 422 } 423 424 SmallString<32> Checksum; 425 Optional<llvm::DIFile::ChecksumKind> CSKind = 426 computeChecksum(SM.getFileID(Loc), Checksum); 427 Optional<llvm::DIFile::ChecksumInfo<StringRef>> CSInfo; 428 if (CSKind) 429 CSInfo.emplace(*CSKind, Checksum); 430 431 llvm::DIFile *F = DBuilder.createFile( 432 remapDIPath(PLoc.getFilename()), remapDIPath(getCurrentDirname()), CSInfo, 433 getSource(SM, SM.getFileID(Loc))); 434 435 DIFileCache[fname].reset(F); 436 return F; 437 } 438 439 llvm::DIFile *CGDebugInfo::getOrCreateMainFile() { 440 return DBuilder.createFile( 441 remapDIPath(TheCU->getFilename()), remapDIPath(TheCU->getDirectory()), 442 TheCU->getFile()->getChecksum(), 443 CGM.getCodeGenOpts().EmbedSource ? TheCU->getSource() : None); 444 } 445 446 std::string CGDebugInfo::remapDIPath(StringRef Path) const { 447 for (const auto &Entry : DebugPrefixMap) 448 if (Path.startswith(Entry.first)) 449 return (Twine(Entry.second) + Path.substr(Entry.first.size())).str(); 450 return Path.str(); 451 } 452 453 unsigned CGDebugInfo::getLineNumber(SourceLocation Loc) { 454 if (Loc.isInvalid() && CurLoc.isInvalid()) 455 return 0; 456 SourceManager &SM = CGM.getContext().getSourceManager(); 457 PresumedLoc PLoc = SM.getPresumedLoc(Loc.isValid() ? Loc : CurLoc); 458 return PLoc.isValid() ? PLoc.getLine() : 0; 459 } 460 461 unsigned CGDebugInfo::getColumnNumber(SourceLocation Loc, bool Force) { 462 // We may not want column information at all. 463 if (!Force && !CGM.getCodeGenOpts().DebugColumnInfo) 464 return 0; 465 466 // If the location is invalid then use the current column. 467 if (Loc.isInvalid() && CurLoc.isInvalid()) 468 return 0; 469 SourceManager &SM = CGM.getContext().getSourceManager(); 470 PresumedLoc PLoc = SM.getPresumedLoc(Loc.isValid() ? Loc : CurLoc); 471 return PLoc.isValid() ? PLoc.getColumn() : 0; 472 } 473 474 StringRef CGDebugInfo::getCurrentDirname() { 475 if (!CGM.getCodeGenOpts().DebugCompilationDir.empty()) 476 return CGM.getCodeGenOpts().DebugCompilationDir; 477 478 if (!CWDName.empty()) 479 return CWDName; 480 SmallString<256> CWD; 481 llvm::sys::fs::current_path(CWD); 482 return CWDName = internString(CWD); 483 } 484 485 void CGDebugInfo::CreateCompileUnit() { 486 SmallString<32> Checksum; 487 Optional<llvm::DIFile::ChecksumKind> CSKind; 488 Optional<llvm::DIFile::ChecksumInfo<StringRef>> CSInfo; 489 490 // Should we be asking the SourceManager for the main file name, instead of 491 // accepting it as an argument? This just causes the main file name to 492 // mismatch with source locations and create extra lexical scopes or 493 // mismatched debug info (a CU with a DW_AT_file of "-", because that's what 494 // the driver passed, but functions/other things have DW_AT_file of "<stdin>" 495 // because that's what the SourceManager says) 496 497 // Get absolute path name. 498 SourceManager &SM = CGM.getContext().getSourceManager(); 499 std::string MainFileName = CGM.getCodeGenOpts().MainFileName; 500 if (MainFileName.empty()) 501 MainFileName = "<stdin>"; 502 503 // The main file name provided via the "-main-file-name" option contains just 504 // the file name itself with no path information. This file name may have had 505 // a relative path, so we look into the actual file entry for the main 506 // file to determine the real absolute path for the file. 507 std::string MainFileDir; 508 if (const FileEntry *MainFile = SM.getFileEntryForID(SM.getMainFileID())) { 509 MainFileDir = remapDIPath(MainFile->getDir()->getName()); 510 if (MainFileDir != ".") { 511 llvm::SmallString<1024> MainFileDirSS(MainFileDir); 512 llvm::sys::path::append(MainFileDirSS, MainFileName); 513 MainFileName = MainFileDirSS.str(); 514 } 515 // If the main file name provided is identical to the input file name, and 516 // if the input file is a preprocessed source, use the module name for 517 // debug info. The module name comes from the name specified in the first 518 // linemarker if the input is a preprocessed source. 519 if (MainFile->getName() == MainFileName && 520 FrontendOptions::getInputKindForExtension( 521 MainFile->getName().rsplit('.').second) 522 .isPreprocessed()) 523 MainFileName = CGM.getModule().getName().str(); 524 525 CSKind = computeChecksum(SM.getMainFileID(), Checksum); 526 } 527 528 llvm::dwarf::SourceLanguage LangTag; 529 const LangOptions &LO = CGM.getLangOpts(); 530 if (LO.CPlusPlus) { 531 if (LO.ObjC) 532 LangTag = llvm::dwarf::DW_LANG_ObjC_plus_plus; 533 else 534 LangTag = llvm::dwarf::DW_LANG_C_plus_plus; 535 } else if (LO.ObjC) { 536 LangTag = llvm::dwarf::DW_LANG_ObjC; 537 } else if (LO.RenderScript) { 538 LangTag = llvm::dwarf::DW_LANG_GOOGLE_RenderScript; 539 } else if (LO.C99) { 540 LangTag = llvm::dwarf::DW_LANG_C99; 541 } else { 542 LangTag = llvm::dwarf::DW_LANG_C89; 543 } 544 545 std::string Producer = getClangFullVersion(); 546 547 // Figure out which version of the ObjC runtime we have. 548 unsigned RuntimeVers = 0; 549 if (LO.ObjC) 550 RuntimeVers = LO.ObjCRuntime.isNonFragile() ? 2 : 1; 551 552 llvm::DICompileUnit::DebugEmissionKind EmissionKind; 553 switch (DebugKind) { 554 case codegenoptions::NoDebugInfo: 555 case codegenoptions::LocTrackingOnly: 556 EmissionKind = llvm::DICompileUnit::NoDebug; 557 break; 558 case codegenoptions::DebugLineTablesOnly: 559 EmissionKind = llvm::DICompileUnit::LineTablesOnly; 560 break; 561 case codegenoptions::DebugDirectivesOnly: 562 EmissionKind = llvm::DICompileUnit::DebugDirectivesOnly; 563 break; 564 case codegenoptions::LimitedDebugInfo: 565 case codegenoptions::FullDebugInfo: 566 EmissionKind = llvm::DICompileUnit::FullDebug; 567 break; 568 } 569 570 if (CSKind) 571 CSInfo.emplace(*CSKind, Checksum); 572 573 // Create new compile unit. 574 // FIXME - Eliminate TheCU. 575 auto &CGOpts = CGM.getCodeGenOpts(); 576 TheCU = DBuilder.createCompileUnit( 577 LangTag, 578 DBuilder.createFile(remapDIPath(MainFileName), 579 remapDIPath(getCurrentDirname()), CSInfo, 580 getSource(SM, SM.getMainFileID())), 581 CGOpts.EmitVersionIdentMetadata ? Producer : "", 582 LO.Optimize || CGOpts.PrepareForLTO || CGOpts.PrepareForThinLTO, 583 CGOpts.DwarfDebugFlags, RuntimeVers, 584 (CGOpts.getSplitDwarfMode() != CodeGenOptions::NoFission) 585 ? "" 586 : CGOpts.SplitDwarfFile, 587 EmissionKind, 0 /* DWOid */, CGOpts.SplitDwarfInlining, 588 CGOpts.DebugInfoForProfiling, 589 CGM.getTarget().getTriple().isNVPTX() 590 ? llvm::DICompileUnit::DebugNameTableKind::None 591 : static_cast<llvm::DICompileUnit::DebugNameTableKind>( 592 CGOpts.DebugNameTable), 593 CGOpts.DebugRangesBaseAddress); 594 } 595 596 llvm::DIType *CGDebugInfo::CreateType(const BuiltinType *BT) { 597 llvm::dwarf::TypeKind Encoding; 598 StringRef BTName; 599 switch (BT->getKind()) { 600 #define BUILTIN_TYPE(Id, SingletonId) 601 #define PLACEHOLDER_TYPE(Id, SingletonId) case BuiltinType::Id: 602 #include "clang/AST/BuiltinTypes.def" 603 case BuiltinType::Dependent: 604 llvm_unreachable("Unexpected builtin type"); 605 case BuiltinType::NullPtr: 606 return DBuilder.createNullPtrType(); 607 case BuiltinType::Void: 608 return nullptr; 609 case BuiltinType::ObjCClass: 610 if (!ClassTy) 611 ClassTy = DBuilder.createForwardDecl(llvm::dwarf::DW_TAG_structure_type, 612 "objc_class", TheCU, 613 getOrCreateMainFile(), 0); 614 return ClassTy; 615 case BuiltinType::ObjCId: { 616 // typedef struct objc_class *Class; 617 // typedef struct objc_object { 618 // Class isa; 619 // } *id; 620 621 if (ObjTy) 622 return ObjTy; 623 624 if (!ClassTy) 625 ClassTy = DBuilder.createForwardDecl(llvm::dwarf::DW_TAG_structure_type, 626 "objc_class", TheCU, 627 getOrCreateMainFile(), 0); 628 629 unsigned Size = CGM.getContext().getTypeSize(CGM.getContext().VoidPtrTy); 630 631 auto *ISATy = DBuilder.createPointerType(ClassTy, Size); 632 633 ObjTy = DBuilder.createStructType( 634 TheCU, "objc_object", getOrCreateMainFile(), 0, 0, 0, 635 llvm::DINode::FlagZero, nullptr, llvm::DINodeArray()); 636 637 DBuilder.replaceArrays( 638 ObjTy, DBuilder.getOrCreateArray(&*DBuilder.createMemberType( 639 ObjTy, "isa", getOrCreateMainFile(), 0, Size, 0, 0, 640 llvm::DINode::FlagZero, ISATy))); 641 return ObjTy; 642 } 643 case BuiltinType::ObjCSel: { 644 if (!SelTy) 645 SelTy = DBuilder.createForwardDecl(llvm::dwarf::DW_TAG_structure_type, 646 "objc_selector", TheCU, 647 getOrCreateMainFile(), 0); 648 return SelTy; 649 } 650 651 #define IMAGE_TYPE(ImgType, Id, SingletonId, Access, Suffix) \ 652 case BuiltinType::Id: \ 653 return getOrCreateStructPtrType("opencl_" #ImgType "_" #Suffix "_t", \ 654 SingletonId); 655 #include "clang/Basic/OpenCLImageTypes.def" 656 case BuiltinType::OCLSampler: 657 return getOrCreateStructPtrType("opencl_sampler_t", OCLSamplerDITy); 658 case BuiltinType::OCLEvent: 659 return getOrCreateStructPtrType("opencl_event_t", OCLEventDITy); 660 case BuiltinType::OCLClkEvent: 661 return getOrCreateStructPtrType("opencl_clk_event_t", OCLClkEventDITy); 662 case BuiltinType::OCLQueue: 663 return getOrCreateStructPtrType("opencl_queue_t", OCLQueueDITy); 664 case BuiltinType::OCLReserveID: 665 return getOrCreateStructPtrType("opencl_reserve_id_t", OCLReserveIDDITy); 666 #define EXT_OPAQUE_TYPE(ExtType, Id, Ext) \ 667 case BuiltinType::Id: \ 668 return getOrCreateStructPtrType("opencl_" #ExtType, Id##Ty); 669 #include "clang/Basic/OpenCLExtensionTypes.def" 670 671 case BuiltinType::UChar: 672 case BuiltinType::Char_U: 673 Encoding = llvm::dwarf::DW_ATE_unsigned_char; 674 break; 675 case BuiltinType::Char_S: 676 case BuiltinType::SChar: 677 Encoding = llvm::dwarf::DW_ATE_signed_char; 678 break; 679 case BuiltinType::Char8: 680 case BuiltinType::Char16: 681 case BuiltinType::Char32: 682 Encoding = llvm::dwarf::DW_ATE_UTF; 683 break; 684 case BuiltinType::UShort: 685 case BuiltinType::UInt: 686 case BuiltinType::UInt128: 687 case BuiltinType::ULong: 688 case BuiltinType::WChar_U: 689 case BuiltinType::ULongLong: 690 Encoding = llvm::dwarf::DW_ATE_unsigned; 691 break; 692 case BuiltinType::Short: 693 case BuiltinType::Int: 694 case BuiltinType::Int128: 695 case BuiltinType::Long: 696 case BuiltinType::WChar_S: 697 case BuiltinType::LongLong: 698 Encoding = llvm::dwarf::DW_ATE_signed; 699 break; 700 case BuiltinType::Bool: 701 Encoding = llvm::dwarf::DW_ATE_boolean; 702 break; 703 case BuiltinType::Half: 704 case BuiltinType::Float: 705 case BuiltinType::LongDouble: 706 case BuiltinType::Float16: 707 case BuiltinType::Float128: 708 case BuiltinType::Double: 709 // FIXME: For targets where long double and __float128 have the same size, 710 // they are currently indistinguishable in the debugger without some 711 // special treatment. However, there is currently no consensus on encoding 712 // and this should be updated once a DWARF encoding exists for distinct 713 // floating point types of the same size. 714 Encoding = llvm::dwarf::DW_ATE_float; 715 break; 716 case BuiltinType::ShortAccum: 717 case BuiltinType::Accum: 718 case BuiltinType::LongAccum: 719 case BuiltinType::ShortFract: 720 case BuiltinType::Fract: 721 case BuiltinType::LongFract: 722 case BuiltinType::SatShortFract: 723 case BuiltinType::SatFract: 724 case BuiltinType::SatLongFract: 725 case BuiltinType::SatShortAccum: 726 case BuiltinType::SatAccum: 727 case BuiltinType::SatLongAccum: 728 Encoding = llvm::dwarf::DW_ATE_signed_fixed; 729 break; 730 case BuiltinType::UShortAccum: 731 case BuiltinType::UAccum: 732 case BuiltinType::ULongAccum: 733 case BuiltinType::UShortFract: 734 case BuiltinType::UFract: 735 case BuiltinType::ULongFract: 736 case BuiltinType::SatUShortAccum: 737 case BuiltinType::SatUAccum: 738 case BuiltinType::SatULongAccum: 739 case BuiltinType::SatUShortFract: 740 case BuiltinType::SatUFract: 741 case BuiltinType::SatULongFract: 742 Encoding = llvm::dwarf::DW_ATE_unsigned_fixed; 743 break; 744 } 745 746 switch (BT->getKind()) { 747 case BuiltinType::Long: 748 BTName = "long int"; 749 break; 750 case BuiltinType::LongLong: 751 BTName = "long long int"; 752 break; 753 case BuiltinType::ULong: 754 BTName = "long unsigned int"; 755 break; 756 case BuiltinType::ULongLong: 757 BTName = "long long unsigned int"; 758 break; 759 default: 760 BTName = BT->getName(CGM.getLangOpts()); 761 break; 762 } 763 // Bit size and offset of the type. 764 uint64_t Size = CGM.getContext().getTypeSize(BT); 765 return DBuilder.createBasicType(BTName, Size, Encoding); 766 } 767 768 llvm::DIType *CGDebugInfo::CreateType(const ComplexType *Ty) { 769 // Bit size and offset of the type. 770 llvm::dwarf::TypeKind Encoding = llvm::dwarf::DW_ATE_complex_float; 771 if (Ty->isComplexIntegerType()) 772 Encoding = llvm::dwarf::DW_ATE_lo_user; 773 774 uint64_t Size = CGM.getContext().getTypeSize(Ty); 775 return DBuilder.createBasicType("complex", Size, Encoding); 776 } 777 778 llvm::DIType *CGDebugInfo::CreateQualifiedType(QualType Ty, 779 llvm::DIFile *Unit) { 780 QualifierCollector Qc; 781 const Type *T = Qc.strip(Ty); 782 783 // Ignore these qualifiers for now. 784 Qc.removeObjCGCAttr(); 785 Qc.removeAddressSpace(); 786 Qc.removeObjCLifetime(); 787 788 // We will create one Derived type for one qualifier and recurse to handle any 789 // additional ones. 790 llvm::dwarf::Tag Tag; 791 if (Qc.hasConst()) { 792 Tag = llvm::dwarf::DW_TAG_const_type; 793 Qc.removeConst(); 794 } else if (Qc.hasVolatile()) { 795 Tag = llvm::dwarf::DW_TAG_volatile_type; 796 Qc.removeVolatile(); 797 } else if (Qc.hasRestrict()) { 798 Tag = llvm::dwarf::DW_TAG_restrict_type; 799 Qc.removeRestrict(); 800 } else { 801 assert(Qc.empty() && "Unknown type qualifier for debug info"); 802 return getOrCreateType(QualType(T, 0), Unit); 803 } 804 805 auto *FromTy = getOrCreateType(Qc.apply(CGM.getContext(), T), Unit); 806 807 // No need to fill in the Name, Line, Size, Alignment, Offset in case of 808 // CVR derived types. 809 return DBuilder.createQualifiedType(Tag, FromTy); 810 } 811 812 llvm::DIType *CGDebugInfo::CreateType(const ObjCObjectPointerType *Ty, 813 llvm::DIFile *Unit) { 814 815 // The frontend treats 'id' as a typedef to an ObjCObjectType, 816 // whereas 'id<protocol>' is treated as an ObjCPointerType. For the 817 // debug info, we want to emit 'id' in both cases. 818 if (Ty->isObjCQualifiedIdType()) 819 return getOrCreateType(CGM.getContext().getObjCIdType(), Unit); 820 821 return CreatePointerLikeType(llvm::dwarf::DW_TAG_pointer_type, Ty, 822 Ty->getPointeeType(), Unit); 823 } 824 825 llvm::DIType *CGDebugInfo::CreateType(const PointerType *Ty, 826 llvm::DIFile *Unit) { 827 return CreatePointerLikeType(llvm::dwarf::DW_TAG_pointer_type, Ty, 828 Ty->getPointeeType(), Unit); 829 } 830 831 /// \return whether a C++ mangling exists for the type defined by TD. 832 static bool hasCXXMangling(const TagDecl *TD, llvm::DICompileUnit *TheCU) { 833 switch (TheCU->getSourceLanguage()) { 834 case llvm::dwarf::DW_LANG_C_plus_plus: 835 return true; 836 case llvm::dwarf::DW_LANG_ObjC_plus_plus: 837 return isa<CXXRecordDecl>(TD) || isa<EnumDecl>(TD); 838 default: 839 return false; 840 } 841 } 842 843 // Determines if the debug info for this tag declaration needs a type 844 // identifier. The purpose of the unique identifier is to deduplicate type 845 // information for identical types across TUs. Because of the C++ one definition 846 // rule (ODR), it is valid to assume that the type is defined the same way in 847 // every TU and its debug info is equivalent. 848 // 849 // C does not have the ODR, and it is common for codebases to contain multiple 850 // different definitions of a struct with the same name in different TUs. 851 // Therefore, if the type doesn't have a C++ mangling, don't give it an 852 // identifer. Type information in C is smaller and simpler than C++ type 853 // information, so the increase in debug info size is negligible. 854 // 855 // If the type is not externally visible, it should be unique to the current TU, 856 // and should not need an identifier to participate in type deduplication. 857 // However, when emitting CodeView, the format internally uses these 858 // unique type name identifers for references between debug info. For example, 859 // the method of a class in an anonymous namespace uses the identifer to refer 860 // to its parent class. The Microsoft C++ ABI attempts to provide unique names 861 // for such types, so when emitting CodeView, always use identifiers for C++ 862 // types. This may create problems when attempting to emit CodeView when the MS 863 // C++ ABI is not in use. 864 static bool needsTypeIdentifier(const TagDecl *TD, CodeGenModule &CGM, 865 llvm::DICompileUnit *TheCU) { 866 // We only add a type identifier for types with C++ name mangling. 867 if (!hasCXXMangling(TD, TheCU)) 868 return false; 869 870 // Externally visible types with C++ mangling need a type identifier. 871 if (TD->isExternallyVisible()) 872 return true; 873 874 // CodeView types with C++ mangling need a type identifier. 875 if (CGM.getCodeGenOpts().EmitCodeView) 876 return true; 877 878 return false; 879 } 880 881 // Returns a unique type identifier string if one exists, or an empty string. 882 static SmallString<256> getTypeIdentifier(const TagType *Ty, CodeGenModule &CGM, 883 llvm::DICompileUnit *TheCU) { 884 SmallString<256> Identifier; 885 const TagDecl *TD = Ty->getDecl(); 886 887 if (!needsTypeIdentifier(TD, CGM, TheCU)) 888 return Identifier; 889 890 // TODO: This is using the RTTI name. Is there a better way to get 891 // a unique string for a type? 892 llvm::raw_svector_ostream Out(Identifier); 893 CGM.getCXXABI().getMangleContext().mangleCXXRTTIName(QualType(Ty, 0), Out); 894 return Identifier; 895 } 896 897 /// \return the appropriate DWARF tag for a composite type. 898 static llvm::dwarf::Tag getTagForRecord(const RecordDecl *RD) { 899 llvm::dwarf::Tag Tag; 900 if (RD->isStruct() || RD->isInterface()) 901 Tag = llvm::dwarf::DW_TAG_structure_type; 902 else if (RD->isUnion()) 903 Tag = llvm::dwarf::DW_TAG_union_type; 904 else { 905 // FIXME: This could be a struct type giving a default visibility different 906 // than C++ class type, but needs llvm metadata changes first. 907 assert(RD->isClass()); 908 Tag = llvm::dwarf::DW_TAG_class_type; 909 } 910 return Tag; 911 } 912 913 llvm::DICompositeType * 914 CGDebugInfo::getOrCreateRecordFwdDecl(const RecordType *Ty, 915 llvm::DIScope *Ctx) { 916 const RecordDecl *RD = Ty->getDecl(); 917 if (llvm::DIType *T = getTypeOrNull(CGM.getContext().getRecordType(RD))) 918 return cast<llvm::DICompositeType>(T); 919 llvm::DIFile *DefUnit = getOrCreateFile(RD->getLocation()); 920 unsigned Line = getLineNumber(RD->getLocation()); 921 StringRef RDName = getClassName(RD); 922 923 uint64_t Size = 0; 924 uint32_t Align = 0; 925 926 // Create the type. 927 SmallString<256> Identifier = getTypeIdentifier(Ty, CGM, TheCU); 928 llvm::DICompositeType *RetTy = DBuilder.createReplaceableCompositeType( 929 getTagForRecord(RD), RDName, Ctx, DefUnit, Line, 0, Size, Align, 930 llvm::DINode::FlagFwdDecl, Identifier); 931 if (CGM.getCodeGenOpts().DebugFwdTemplateParams) 932 if (auto *TSpecial = dyn_cast<ClassTemplateSpecializationDecl>(RD)) 933 DBuilder.replaceArrays(RetTy, llvm::DINodeArray(), 934 CollectCXXTemplateParams(TSpecial, DefUnit)); 935 ReplaceMap.emplace_back( 936 std::piecewise_construct, std::make_tuple(Ty), 937 std::make_tuple(static_cast<llvm::Metadata *>(RetTy))); 938 return RetTy; 939 } 940 941 llvm::DIType *CGDebugInfo::CreatePointerLikeType(llvm::dwarf::Tag Tag, 942 const Type *Ty, 943 QualType PointeeTy, 944 llvm::DIFile *Unit) { 945 // Bit size, align and offset of the type. 946 // Size is always the size of a pointer. We can't use getTypeSize here 947 // because that does not return the correct value for references. 948 unsigned AddressSpace = CGM.getContext().getTargetAddressSpace(PointeeTy); 949 uint64_t Size = CGM.getTarget().getPointerWidth(AddressSpace); 950 auto Align = getTypeAlignIfRequired(Ty, CGM.getContext()); 951 Optional<unsigned> DWARFAddressSpace = 952 CGM.getTarget().getDWARFAddressSpace(AddressSpace); 953 954 if (Tag == llvm::dwarf::DW_TAG_reference_type || 955 Tag == llvm::dwarf::DW_TAG_rvalue_reference_type) 956 return DBuilder.createReferenceType(Tag, getOrCreateType(PointeeTy, Unit), 957 Size, Align, DWARFAddressSpace); 958 else 959 return DBuilder.createPointerType(getOrCreateType(PointeeTy, Unit), Size, 960 Align, DWARFAddressSpace); 961 } 962 963 llvm::DIType *CGDebugInfo::getOrCreateStructPtrType(StringRef Name, 964 llvm::DIType *&Cache) { 965 if (Cache) 966 return Cache; 967 Cache = DBuilder.createForwardDecl(llvm::dwarf::DW_TAG_structure_type, Name, 968 TheCU, getOrCreateMainFile(), 0); 969 unsigned Size = CGM.getContext().getTypeSize(CGM.getContext().VoidPtrTy); 970 Cache = DBuilder.createPointerType(Cache, Size); 971 return Cache; 972 } 973 974 uint64_t CGDebugInfo::collectDefaultElementTypesForBlockPointer( 975 const BlockPointerType *Ty, llvm::DIFile *Unit, llvm::DIDerivedType *DescTy, 976 unsigned LineNo, SmallVectorImpl<llvm::Metadata *> &EltTys) { 977 QualType FType; 978 979 // Advanced by calls to CreateMemberType in increments of FType, then 980 // returned as the overall size of the default elements. 981 uint64_t FieldOffset = 0; 982 983 // Blocks in OpenCL have unique constraints which make the standard fields 984 // redundant while requiring size and align fields for enqueue_kernel. See 985 // initializeForBlockHeader in CGBlocks.cpp 986 if (CGM.getLangOpts().OpenCL) { 987 FType = CGM.getContext().IntTy; 988 EltTys.push_back(CreateMemberType(Unit, FType, "__size", &FieldOffset)); 989 EltTys.push_back(CreateMemberType(Unit, FType, "__align", &FieldOffset)); 990 } else { 991 FType = CGM.getContext().getPointerType(CGM.getContext().VoidTy); 992 EltTys.push_back(CreateMemberType(Unit, FType, "__isa", &FieldOffset)); 993 FType = CGM.getContext().IntTy; 994 EltTys.push_back(CreateMemberType(Unit, FType, "__flags", &FieldOffset)); 995 EltTys.push_back(CreateMemberType(Unit, FType, "__reserved", &FieldOffset)); 996 FType = CGM.getContext().getPointerType(Ty->getPointeeType()); 997 EltTys.push_back(CreateMemberType(Unit, FType, "__FuncPtr", &FieldOffset)); 998 FType = CGM.getContext().getPointerType(CGM.getContext().VoidTy); 999 uint64_t FieldSize = CGM.getContext().getTypeSize(Ty); 1000 uint32_t FieldAlign = CGM.getContext().getTypeAlign(Ty); 1001 EltTys.push_back(DBuilder.createMemberType( 1002 Unit, "__descriptor", nullptr, LineNo, FieldSize, FieldAlign, 1003 FieldOffset, llvm::DINode::FlagZero, DescTy)); 1004 FieldOffset += FieldSize; 1005 } 1006 1007 return FieldOffset; 1008 } 1009 1010 llvm::DIType *CGDebugInfo::CreateType(const BlockPointerType *Ty, 1011 llvm::DIFile *Unit) { 1012 SmallVector<llvm::Metadata *, 8> EltTys; 1013 QualType FType; 1014 uint64_t FieldOffset; 1015 llvm::DINodeArray Elements; 1016 1017 FieldOffset = 0; 1018 FType = CGM.getContext().UnsignedLongTy; 1019 EltTys.push_back(CreateMemberType(Unit, FType, "reserved", &FieldOffset)); 1020 EltTys.push_back(CreateMemberType(Unit, FType, "Size", &FieldOffset)); 1021 1022 Elements = DBuilder.getOrCreateArray(EltTys); 1023 EltTys.clear(); 1024 1025 llvm::DINode::DIFlags Flags = llvm::DINode::FlagAppleBlock; 1026 1027 auto *EltTy = 1028 DBuilder.createStructType(Unit, "__block_descriptor", nullptr, 0, 1029 FieldOffset, 0, Flags, nullptr, Elements); 1030 1031 // Bit size, align and offset of the type. 1032 uint64_t Size = CGM.getContext().getTypeSize(Ty); 1033 1034 auto *DescTy = DBuilder.createPointerType(EltTy, Size); 1035 1036 FieldOffset = collectDefaultElementTypesForBlockPointer(Ty, Unit, DescTy, 1037 0, EltTys); 1038 1039 Elements = DBuilder.getOrCreateArray(EltTys); 1040 1041 // The __block_literal_generic structs are marked with a special 1042 // DW_AT_APPLE_BLOCK attribute and are an implementation detail only 1043 // the debugger needs to know about. To allow type uniquing, emit 1044 // them without a name or a location. 1045 EltTy = DBuilder.createStructType(Unit, "", nullptr, 0, FieldOffset, 0, 1046 Flags, nullptr, Elements); 1047 1048 return DBuilder.createPointerType(EltTy, Size); 1049 } 1050 1051 llvm::DIType *CGDebugInfo::CreateType(const TemplateSpecializationType *Ty, 1052 llvm::DIFile *Unit) { 1053 assert(Ty->isTypeAlias()); 1054 llvm::DIType *Src = getOrCreateType(Ty->getAliasedType(), Unit); 1055 1056 SmallString<128> NS; 1057 llvm::raw_svector_ostream OS(NS); 1058 Ty->getTemplateName().print(OS, getPrintingPolicy(), /*qualified*/ false); 1059 printTemplateArgumentList(OS, Ty->template_arguments(), getPrintingPolicy()); 1060 1061 auto *AliasDecl = 1062 cast<TypeAliasTemplateDecl>(Ty->getTemplateName().getAsTemplateDecl()) 1063 ->getTemplatedDecl(); 1064 1065 SourceLocation Loc = AliasDecl->getLocation(); 1066 return DBuilder.createTypedef(Src, OS.str(), getOrCreateFile(Loc), 1067 getLineNumber(Loc), 1068 getDeclContextDescriptor(AliasDecl)); 1069 } 1070 1071 llvm::DIType *CGDebugInfo::CreateType(const TypedefType *Ty, 1072 llvm::DIFile *Unit) { 1073 // We don't set size information, but do specify where the typedef was 1074 // declared. 1075 SourceLocation Loc = Ty->getDecl()->getLocation(); 1076 1077 // Typedefs are derived from some other type. 1078 return DBuilder.createTypedef( 1079 getOrCreateType(Ty->getDecl()->getUnderlyingType(), Unit), 1080 Ty->getDecl()->getName(), getOrCreateFile(Loc), getLineNumber(Loc), 1081 getDeclContextDescriptor(Ty->getDecl())); 1082 } 1083 1084 static unsigned getDwarfCC(CallingConv CC) { 1085 switch (CC) { 1086 case CC_C: 1087 // Avoid emitting DW_AT_calling_convention if the C convention was used. 1088 return 0; 1089 1090 case CC_X86StdCall: 1091 return llvm::dwarf::DW_CC_BORLAND_stdcall; 1092 case CC_X86FastCall: 1093 return llvm::dwarf::DW_CC_BORLAND_msfastcall; 1094 case CC_X86ThisCall: 1095 return llvm::dwarf::DW_CC_BORLAND_thiscall; 1096 case CC_X86VectorCall: 1097 return llvm::dwarf::DW_CC_LLVM_vectorcall; 1098 case CC_X86Pascal: 1099 return llvm::dwarf::DW_CC_BORLAND_pascal; 1100 case CC_Win64: 1101 return llvm::dwarf::DW_CC_LLVM_Win64; 1102 case CC_X86_64SysV: 1103 return llvm::dwarf::DW_CC_LLVM_X86_64SysV; 1104 case CC_AAPCS: 1105 case CC_AArch64VectorCall: 1106 return llvm::dwarf::DW_CC_LLVM_AAPCS; 1107 case CC_AAPCS_VFP: 1108 return llvm::dwarf::DW_CC_LLVM_AAPCS_VFP; 1109 case CC_IntelOclBicc: 1110 return llvm::dwarf::DW_CC_LLVM_IntelOclBicc; 1111 case CC_SpirFunction: 1112 return llvm::dwarf::DW_CC_LLVM_SpirFunction; 1113 case CC_OpenCLKernel: 1114 return llvm::dwarf::DW_CC_LLVM_OpenCLKernel; 1115 case CC_Swift: 1116 return llvm::dwarf::DW_CC_LLVM_Swift; 1117 case CC_PreserveMost: 1118 return llvm::dwarf::DW_CC_LLVM_PreserveMost; 1119 case CC_PreserveAll: 1120 return llvm::dwarf::DW_CC_LLVM_PreserveAll; 1121 case CC_X86RegCall: 1122 return llvm::dwarf::DW_CC_LLVM_X86RegCall; 1123 } 1124 return 0; 1125 } 1126 1127 llvm::DIType *CGDebugInfo::CreateType(const FunctionType *Ty, 1128 llvm::DIFile *Unit) { 1129 SmallVector<llvm::Metadata *, 16> EltTys; 1130 1131 // Add the result type at least. 1132 EltTys.push_back(getOrCreateType(Ty->getReturnType(), Unit)); 1133 1134 // Set up remainder of arguments if there is a prototype. 1135 // otherwise emit it as a variadic function. 1136 if (isa<FunctionNoProtoType>(Ty)) 1137 EltTys.push_back(DBuilder.createUnspecifiedParameter()); 1138 else if (const auto *FPT = dyn_cast<FunctionProtoType>(Ty)) { 1139 for (const QualType &ParamType : FPT->param_types()) 1140 EltTys.push_back(getOrCreateType(ParamType, Unit)); 1141 if (FPT->isVariadic()) 1142 EltTys.push_back(DBuilder.createUnspecifiedParameter()); 1143 } 1144 1145 llvm::DITypeRefArray EltTypeArray = DBuilder.getOrCreateTypeArray(EltTys); 1146 return DBuilder.createSubroutineType(EltTypeArray, llvm::DINode::FlagZero, 1147 getDwarfCC(Ty->getCallConv())); 1148 } 1149 1150 /// Convert an AccessSpecifier into the corresponding DINode flag. 1151 /// As an optimization, return 0 if the access specifier equals the 1152 /// default for the containing type. 1153 static llvm::DINode::DIFlags getAccessFlag(AccessSpecifier Access, 1154 const RecordDecl *RD) { 1155 AccessSpecifier Default = clang::AS_none; 1156 if (RD && RD->isClass()) 1157 Default = clang::AS_private; 1158 else if (RD && (RD->isStruct() || RD->isUnion())) 1159 Default = clang::AS_public; 1160 1161 if (Access == Default) 1162 return llvm::DINode::FlagZero; 1163 1164 switch (Access) { 1165 case clang::AS_private: 1166 return llvm::DINode::FlagPrivate; 1167 case clang::AS_protected: 1168 return llvm::DINode::FlagProtected; 1169 case clang::AS_public: 1170 return llvm::DINode::FlagPublic; 1171 case clang::AS_none: 1172 return llvm::DINode::FlagZero; 1173 } 1174 llvm_unreachable("unexpected access enumerator"); 1175 } 1176 1177 llvm::DIType *CGDebugInfo::createBitFieldType(const FieldDecl *BitFieldDecl, 1178 llvm::DIScope *RecordTy, 1179 const RecordDecl *RD) { 1180 StringRef Name = BitFieldDecl->getName(); 1181 QualType Ty = BitFieldDecl->getType(); 1182 SourceLocation Loc = BitFieldDecl->getLocation(); 1183 llvm::DIFile *VUnit = getOrCreateFile(Loc); 1184 llvm::DIType *DebugType = getOrCreateType(Ty, VUnit); 1185 1186 // Get the location for the field. 1187 llvm::DIFile *File = getOrCreateFile(Loc); 1188 unsigned Line = getLineNumber(Loc); 1189 1190 const CGBitFieldInfo &BitFieldInfo = 1191 CGM.getTypes().getCGRecordLayout(RD).getBitFieldInfo(BitFieldDecl); 1192 uint64_t SizeInBits = BitFieldInfo.Size; 1193 assert(SizeInBits > 0 && "found named 0-width bitfield"); 1194 uint64_t StorageOffsetInBits = 1195 CGM.getContext().toBits(BitFieldInfo.StorageOffset); 1196 uint64_t Offset = BitFieldInfo.Offset; 1197 // The bit offsets for big endian machines are reversed for big 1198 // endian target, compensate for that as the DIDerivedType requires 1199 // un-reversed offsets. 1200 if (CGM.getDataLayout().isBigEndian()) 1201 Offset = BitFieldInfo.StorageSize - BitFieldInfo.Size - Offset; 1202 uint64_t OffsetInBits = StorageOffsetInBits + Offset; 1203 llvm::DINode::DIFlags Flags = getAccessFlag(BitFieldDecl->getAccess(), RD); 1204 return DBuilder.createBitFieldMemberType( 1205 RecordTy, Name, File, Line, SizeInBits, OffsetInBits, StorageOffsetInBits, 1206 Flags, DebugType); 1207 } 1208 1209 llvm::DIType * 1210 CGDebugInfo::createFieldType(StringRef name, QualType type, SourceLocation loc, 1211 AccessSpecifier AS, uint64_t offsetInBits, 1212 uint32_t AlignInBits, llvm::DIFile *tunit, 1213 llvm::DIScope *scope, const RecordDecl *RD) { 1214 llvm::DIType *debugType = getOrCreateType(type, tunit); 1215 1216 // Get the location for the field. 1217 llvm::DIFile *file = getOrCreateFile(loc); 1218 unsigned line = getLineNumber(loc); 1219 1220 uint64_t SizeInBits = 0; 1221 auto Align = AlignInBits; 1222 if (!type->isIncompleteArrayType()) { 1223 TypeInfo TI = CGM.getContext().getTypeInfo(type); 1224 SizeInBits = TI.Width; 1225 if (!Align) 1226 Align = getTypeAlignIfRequired(type, CGM.getContext()); 1227 } 1228 1229 llvm::DINode::DIFlags flags = getAccessFlag(AS, RD); 1230 return DBuilder.createMemberType(scope, name, file, line, SizeInBits, Align, 1231 offsetInBits, flags, debugType); 1232 } 1233 1234 void CGDebugInfo::CollectRecordLambdaFields( 1235 const CXXRecordDecl *CXXDecl, SmallVectorImpl<llvm::Metadata *> &elements, 1236 llvm::DIType *RecordTy) { 1237 // For C++11 Lambdas a Field will be the same as a Capture, but the Capture 1238 // has the name and the location of the variable so we should iterate over 1239 // both concurrently. 1240 const ASTRecordLayout &layout = CGM.getContext().getASTRecordLayout(CXXDecl); 1241 RecordDecl::field_iterator Field = CXXDecl->field_begin(); 1242 unsigned fieldno = 0; 1243 for (CXXRecordDecl::capture_const_iterator I = CXXDecl->captures_begin(), 1244 E = CXXDecl->captures_end(); 1245 I != E; ++I, ++Field, ++fieldno) { 1246 const LambdaCapture &C = *I; 1247 if (C.capturesVariable()) { 1248 SourceLocation Loc = C.getLocation(); 1249 assert(!Field->isBitField() && "lambdas don't have bitfield members!"); 1250 VarDecl *V = C.getCapturedVar(); 1251 StringRef VName = V->getName(); 1252 llvm::DIFile *VUnit = getOrCreateFile(Loc); 1253 auto Align = getDeclAlignIfRequired(V, CGM.getContext()); 1254 llvm::DIType *FieldType = createFieldType( 1255 VName, Field->getType(), Loc, Field->getAccess(), 1256 layout.getFieldOffset(fieldno), Align, VUnit, RecordTy, CXXDecl); 1257 elements.push_back(FieldType); 1258 } else if (C.capturesThis()) { 1259 // TODO: Need to handle 'this' in some way by probably renaming the 1260 // this of the lambda class and having a field member of 'this' or 1261 // by using AT_object_pointer for the function and having that be 1262 // used as 'this' for semantic references. 1263 FieldDecl *f = *Field; 1264 llvm::DIFile *VUnit = getOrCreateFile(f->getLocation()); 1265 QualType type = f->getType(); 1266 llvm::DIType *fieldType = createFieldType( 1267 "this", type, f->getLocation(), f->getAccess(), 1268 layout.getFieldOffset(fieldno), VUnit, RecordTy, CXXDecl); 1269 1270 elements.push_back(fieldType); 1271 } 1272 } 1273 } 1274 1275 llvm::DIDerivedType * 1276 CGDebugInfo::CreateRecordStaticField(const VarDecl *Var, llvm::DIType *RecordTy, 1277 const RecordDecl *RD) { 1278 // Create the descriptor for the static variable, with or without 1279 // constant initializers. 1280 Var = Var->getCanonicalDecl(); 1281 llvm::DIFile *VUnit = getOrCreateFile(Var->getLocation()); 1282 llvm::DIType *VTy = getOrCreateType(Var->getType(), VUnit); 1283 1284 unsigned LineNumber = getLineNumber(Var->getLocation()); 1285 StringRef VName = Var->getName(); 1286 llvm::Constant *C = nullptr; 1287 if (Var->getInit()) { 1288 const APValue *Value = Var->evaluateValue(); 1289 if (Value) { 1290 if (Value->isInt()) 1291 C = llvm::ConstantInt::get(CGM.getLLVMContext(), Value->getInt()); 1292 if (Value->isFloat()) 1293 C = llvm::ConstantFP::get(CGM.getLLVMContext(), Value->getFloat()); 1294 } 1295 } 1296 1297 llvm::DINode::DIFlags Flags = getAccessFlag(Var->getAccess(), RD); 1298 auto Align = getDeclAlignIfRequired(Var, CGM.getContext()); 1299 llvm::DIDerivedType *GV = DBuilder.createStaticMemberType( 1300 RecordTy, VName, VUnit, LineNumber, VTy, Flags, C, Align); 1301 StaticDataMemberCache[Var->getCanonicalDecl()].reset(GV); 1302 return GV; 1303 } 1304 1305 void CGDebugInfo::CollectRecordNormalField( 1306 const FieldDecl *field, uint64_t OffsetInBits, llvm::DIFile *tunit, 1307 SmallVectorImpl<llvm::Metadata *> &elements, llvm::DIType *RecordTy, 1308 const RecordDecl *RD) { 1309 StringRef name = field->getName(); 1310 QualType type = field->getType(); 1311 1312 // Ignore unnamed fields unless they're anonymous structs/unions. 1313 if (name.empty() && !type->isRecordType()) 1314 return; 1315 1316 llvm::DIType *FieldType; 1317 if (field->isBitField()) { 1318 FieldType = createBitFieldType(field, RecordTy, RD); 1319 } else { 1320 auto Align = getDeclAlignIfRequired(field, CGM.getContext()); 1321 FieldType = 1322 createFieldType(name, type, field->getLocation(), field->getAccess(), 1323 OffsetInBits, Align, tunit, RecordTy, RD); 1324 } 1325 1326 elements.push_back(FieldType); 1327 } 1328 1329 void CGDebugInfo::CollectRecordNestedType( 1330 const TypeDecl *TD, SmallVectorImpl<llvm::Metadata *> &elements) { 1331 QualType Ty = CGM.getContext().getTypeDeclType(TD); 1332 // Injected class names are not considered nested records. 1333 if (isa<InjectedClassNameType>(Ty)) 1334 return; 1335 SourceLocation Loc = TD->getLocation(); 1336 llvm::DIType *nestedType = getOrCreateType(Ty, getOrCreateFile(Loc)); 1337 elements.push_back(nestedType); 1338 } 1339 1340 void CGDebugInfo::CollectRecordFields( 1341 const RecordDecl *record, llvm::DIFile *tunit, 1342 SmallVectorImpl<llvm::Metadata *> &elements, 1343 llvm::DICompositeType *RecordTy) { 1344 const auto *CXXDecl = dyn_cast<CXXRecordDecl>(record); 1345 1346 if (CXXDecl && CXXDecl->isLambda()) 1347 CollectRecordLambdaFields(CXXDecl, elements, RecordTy); 1348 else { 1349 const ASTRecordLayout &layout = CGM.getContext().getASTRecordLayout(record); 1350 1351 // Field number for non-static fields. 1352 unsigned fieldNo = 0; 1353 1354 // Static and non-static members should appear in the same order as 1355 // the corresponding declarations in the source program. 1356 for (const auto *I : record->decls()) 1357 if (const auto *V = dyn_cast<VarDecl>(I)) { 1358 if (V->hasAttr<NoDebugAttr>()) 1359 continue; 1360 1361 // Skip variable template specializations when emitting CodeView. MSVC 1362 // doesn't emit them. 1363 if (CGM.getCodeGenOpts().EmitCodeView && 1364 isa<VarTemplateSpecializationDecl>(V)) 1365 continue; 1366 1367 // Reuse the existing static member declaration if one exists 1368 auto MI = StaticDataMemberCache.find(V->getCanonicalDecl()); 1369 if (MI != StaticDataMemberCache.end()) { 1370 assert(MI->second && 1371 "Static data member declaration should still exist"); 1372 elements.push_back(MI->second); 1373 } else { 1374 auto Field = CreateRecordStaticField(V, RecordTy, record); 1375 elements.push_back(Field); 1376 } 1377 } else if (const auto *field = dyn_cast<FieldDecl>(I)) { 1378 CollectRecordNormalField(field, layout.getFieldOffset(fieldNo), tunit, 1379 elements, RecordTy, record); 1380 1381 // Bump field number for next field. 1382 ++fieldNo; 1383 } else if (CGM.getCodeGenOpts().EmitCodeView) { 1384 // Debug info for nested types is included in the member list only for 1385 // CodeView. 1386 if (const auto *nestedType = dyn_cast<TypeDecl>(I)) 1387 if (!nestedType->isImplicit() && 1388 nestedType->getDeclContext() == record) 1389 CollectRecordNestedType(nestedType, elements); 1390 } 1391 } 1392 } 1393 1394 llvm::DISubroutineType * 1395 CGDebugInfo::getOrCreateMethodType(const CXXMethodDecl *Method, 1396 llvm::DIFile *Unit) { 1397 const FunctionProtoType *Func = Method->getType()->getAs<FunctionProtoType>(); 1398 if (Method->isStatic()) 1399 return cast_or_null<llvm::DISubroutineType>( 1400 getOrCreateType(QualType(Func, 0), Unit)); 1401 return getOrCreateInstanceMethodType(Method->getThisType(CGM.getContext()), 1402 Func, Unit); 1403 } 1404 1405 llvm::DISubroutineType *CGDebugInfo::getOrCreateInstanceMethodType( 1406 QualType ThisPtr, const FunctionProtoType *Func, llvm::DIFile *Unit) { 1407 // Add "this" pointer. 1408 llvm::DITypeRefArray Args( 1409 cast<llvm::DISubroutineType>(getOrCreateType(QualType(Func, 0), Unit)) 1410 ->getTypeArray()); 1411 assert(Args.size() && "Invalid number of arguments!"); 1412 1413 SmallVector<llvm::Metadata *, 16> Elts; 1414 1415 // First element is always return type. For 'void' functions it is NULL. 1416 Elts.push_back(Args[0]); 1417 1418 // "this" pointer is always first argument. 1419 const CXXRecordDecl *RD = ThisPtr->getPointeeCXXRecordDecl(); 1420 if (isa<ClassTemplateSpecializationDecl>(RD)) { 1421 // Create pointer type directly in this case. 1422 const PointerType *ThisPtrTy = cast<PointerType>(ThisPtr); 1423 QualType PointeeTy = ThisPtrTy->getPointeeType(); 1424 unsigned AS = CGM.getContext().getTargetAddressSpace(PointeeTy); 1425 uint64_t Size = CGM.getTarget().getPointerWidth(AS); 1426 auto Align = getTypeAlignIfRequired(ThisPtrTy, CGM.getContext()); 1427 llvm::DIType *PointeeType = getOrCreateType(PointeeTy, Unit); 1428 llvm::DIType *ThisPtrType = 1429 DBuilder.createPointerType(PointeeType, Size, Align); 1430 TypeCache[ThisPtr.getAsOpaquePtr()].reset(ThisPtrType); 1431 // TODO: This and the artificial type below are misleading, the 1432 // types aren't artificial the argument is, but the current 1433 // metadata doesn't represent that. 1434 ThisPtrType = DBuilder.createObjectPointerType(ThisPtrType); 1435 Elts.push_back(ThisPtrType); 1436 } else { 1437 llvm::DIType *ThisPtrType = getOrCreateType(ThisPtr, Unit); 1438 TypeCache[ThisPtr.getAsOpaquePtr()].reset(ThisPtrType); 1439 ThisPtrType = DBuilder.createObjectPointerType(ThisPtrType); 1440 Elts.push_back(ThisPtrType); 1441 } 1442 1443 // Copy rest of the arguments. 1444 for (unsigned i = 1, e = Args.size(); i != e; ++i) 1445 Elts.push_back(Args[i]); 1446 1447 llvm::DITypeRefArray EltTypeArray = DBuilder.getOrCreateTypeArray(Elts); 1448 1449 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 1450 if (Func->getExtProtoInfo().RefQualifier == RQ_LValue) 1451 Flags |= llvm::DINode::FlagLValueReference; 1452 if (Func->getExtProtoInfo().RefQualifier == RQ_RValue) 1453 Flags |= llvm::DINode::FlagRValueReference; 1454 1455 return DBuilder.createSubroutineType(EltTypeArray, Flags, 1456 getDwarfCC(Func->getCallConv())); 1457 } 1458 1459 /// isFunctionLocalClass - Return true if CXXRecordDecl is defined 1460 /// inside a function. 1461 static bool isFunctionLocalClass(const CXXRecordDecl *RD) { 1462 if (const auto *NRD = dyn_cast<CXXRecordDecl>(RD->getDeclContext())) 1463 return isFunctionLocalClass(NRD); 1464 if (isa<FunctionDecl>(RD->getDeclContext())) 1465 return true; 1466 return false; 1467 } 1468 1469 llvm::DISubprogram *CGDebugInfo::CreateCXXMemberFunction( 1470 const CXXMethodDecl *Method, llvm::DIFile *Unit, llvm::DIType *RecordTy) { 1471 bool IsCtorOrDtor = 1472 isa<CXXConstructorDecl>(Method) || isa<CXXDestructorDecl>(Method); 1473 1474 StringRef MethodName = getFunctionName(Method); 1475 llvm::DISubroutineType *MethodTy = getOrCreateMethodType(Method, Unit); 1476 1477 // Since a single ctor/dtor corresponds to multiple functions, it doesn't 1478 // make sense to give a single ctor/dtor a linkage name. 1479 StringRef MethodLinkageName; 1480 // FIXME: 'isFunctionLocalClass' seems like an arbitrary/unintentional 1481 // property to use here. It may've been intended to model "is non-external 1482 // type" but misses cases of non-function-local but non-external classes such 1483 // as those in anonymous namespaces as well as the reverse - external types 1484 // that are function local, such as those in (non-local) inline functions. 1485 if (!IsCtorOrDtor && !isFunctionLocalClass(Method->getParent())) 1486 MethodLinkageName = CGM.getMangledName(Method); 1487 1488 // Get the location for the method. 1489 llvm::DIFile *MethodDefUnit = nullptr; 1490 unsigned MethodLine = 0; 1491 if (!Method->isImplicit()) { 1492 MethodDefUnit = getOrCreateFile(Method->getLocation()); 1493 MethodLine = getLineNumber(Method->getLocation()); 1494 } 1495 1496 // Collect virtual method info. 1497 llvm::DIType *ContainingType = nullptr; 1498 unsigned VIndex = 0; 1499 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 1500 llvm::DISubprogram::DISPFlags SPFlags = llvm::DISubprogram::SPFlagZero; 1501 int ThisAdjustment = 0; 1502 1503 if (Method->isVirtual()) { 1504 if (Method->isPure()) 1505 SPFlags |= llvm::DISubprogram::SPFlagPureVirtual; 1506 else 1507 SPFlags |= llvm::DISubprogram::SPFlagVirtual; 1508 1509 if (CGM.getTarget().getCXXABI().isItaniumFamily()) { 1510 // It doesn't make sense to give a virtual destructor a vtable index, 1511 // since a single destructor has two entries in the vtable. 1512 if (!isa<CXXDestructorDecl>(Method)) 1513 VIndex = CGM.getItaniumVTableContext().getMethodVTableIndex(Method); 1514 } else { 1515 // Emit MS ABI vftable information. There is only one entry for the 1516 // deleting dtor. 1517 const auto *DD = dyn_cast<CXXDestructorDecl>(Method); 1518 GlobalDecl GD = DD ? GlobalDecl(DD, Dtor_Deleting) : GlobalDecl(Method); 1519 MethodVFTableLocation ML = 1520 CGM.getMicrosoftVTableContext().getMethodVFTableLocation(GD); 1521 VIndex = ML.Index; 1522 1523 // CodeView only records the vftable offset in the class that introduces 1524 // the virtual method. This is possible because, unlike Itanium, the MS 1525 // C++ ABI does not include all virtual methods from non-primary bases in 1526 // the vtable for the most derived class. For example, if C inherits from 1527 // A and B, C's primary vftable will not include B's virtual methods. 1528 if (Method->size_overridden_methods() == 0) 1529 Flags |= llvm::DINode::FlagIntroducedVirtual; 1530 1531 // The 'this' adjustment accounts for both the virtual and non-virtual 1532 // portions of the adjustment. Presumably the debugger only uses it when 1533 // it knows the dynamic type of an object. 1534 ThisAdjustment = CGM.getCXXABI() 1535 .getVirtualFunctionPrologueThisAdjustment(GD) 1536 .getQuantity(); 1537 } 1538 ContainingType = RecordTy; 1539 } 1540 1541 if (Method->isStatic()) 1542 Flags |= llvm::DINode::FlagStaticMember; 1543 if (Method->isImplicit()) 1544 Flags |= llvm::DINode::FlagArtificial; 1545 Flags |= getAccessFlag(Method->getAccess(), Method->getParent()); 1546 if (const auto *CXXC = dyn_cast<CXXConstructorDecl>(Method)) { 1547 if (CXXC->isExplicit()) 1548 Flags |= llvm::DINode::FlagExplicit; 1549 } else if (const auto *CXXC = dyn_cast<CXXConversionDecl>(Method)) { 1550 if (CXXC->isExplicit()) 1551 Flags |= llvm::DINode::FlagExplicit; 1552 } 1553 if (Method->hasPrototype()) 1554 Flags |= llvm::DINode::FlagPrototyped; 1555 if (Method->getRefQualifier() == RQ_LValue) 1556 Flags |= llvm::DINode::FlagLValueReference; 1557 if (Method->getRefQualifier() == RQ_RValue) 1558 Flags |= llvm::DINode::FlagRValueReference; 1559 if (CGM.getLangOpts().Optimize) 1560 SPFlags |= llvm::DISubprogram::SPFlagOptimized; 1561 1562 llvm::DINodeArray TParamsArray = CollectFunctionTemplateParams(Method, Unit); 1563 llvm::DISubprogram *SP = DBuilder.createMethod( 1564 RecordTy, MethodName, MethodLinkageName, MethodDefUnit, MethodLine, 1565 MethodTy, VIndex, ThisAdjustment, ContainingType, Flags, SPFlags, 1566 TParamsArray.get()); 1567 1568 SPCache[Method->getCanonicalDecl()].reset(SP); 1569 1570 return SP; 1571 } 1572 1573 void CGDebugInfo::CollectCXXMemberFunctions( 1574 const CXXRecordDecl *RD, llvm::DIFile *Unit, 1575 SmallVectorImpl<llvm::Metadata *> &EltTys, llvm::DIType *RecordTy) { 1576 1577 // Since we want more than just the individual member decls if we 1578 // have templated functions iterate over every declaration to gather 1579 // the functions. 1580 for (const auto *I : RD->decls()) { 1581 const auto *Method = dyn_cast<CXXMethodDecl>(I); 1582 // If the member is implicit, don't add it to the member list. This avoids 1583 // the member being added to type units by LLVM, while still allowing it 1584 // to be emitted into the type declaration/reference inside the compile 1585 // unit. 1586 // Ditto 'nodebug' methods, for consistency with CodeGenFunction.cpp. 1587 // FIXME: Handle Using(Shadow?)Decls here to create 1588 // DW_TAG_imported_declarations inside the class for base decls brought into 1589 // derived classes. GDB doesn't seem to notice/leverage these when I tried 1590 // it, so I'm not rushing to fix this. (GCC seems to produce them, if 1591 // referenced) 1592 if (!Method || Method->isImplicit() || Method->hasAttr<NoDebugAttr>()) 1593 continue; 1594 1595 if (Method->getType()->getAs<FunctionProtoType>()->getContainedAutoType()) 1596 continue; 1597 1598 // Reuse the existing member function declaration if it exists. 1599 // It may be associated with the declaration of the type & should be 1600 // reused as we're building the definition. 1601 // 1602 // This situation can arise in the vtable-based debug info reduction where 1603 // implicit members are emitted in a non-vtable TU. 1604 auto MI = SPCache.find(Method->getCanonicalDecl()); 1605 EltTys.push_back(MI == SPCache.end() 1606 ? CreateCXXMemberFunction(Method, Unit, RecordTy) 1607 : static_cast<llvm::Metadata *>(MI->second)); 1608 } 1609 } 1610 1611 void CGDebugInfo::CollectCXXBases(const CXXRecordDecl *RD, llvm::DIFile *Unit, 1612 SmallVectorImpl<llvm::Metadata *> &EltTys, 1613 llvm::DIType *RecordTy) { 1614 llvm::DenseSet<CanonicalDeclPtr<const CXXRecordDecl>> SeenTypes; 1615 CollectCXXBasesAux(RD, Unit, EltTys, RecordTy, RD->bases(), SeenTypes, 1616 llvm::DINode::FlagZero); 1617 1618 // If we are generating CodeView debug info, we also need to emit records for 1619 // indirect virtual base classes. 1620 if (CGM.getCodeGenOpts().EmitCodeView) { 1621 CollectCXXBasesAux(RD, Unit, EltTys, RecordTy, RD->vbases(), SeenTypes, 1622 llvm::DINode::FlagIndirectVirtualBase); 1623 } 1624 } 1625 1626 void CGDebugInfo::CollectCXXBasesAux( 1627 const CXXRecordDecl *RD, llvm::DIFile *Unit, 1628 SmallVectorImpl<llvm::Metadata *> &EltTys, llvm::DIType *RecordTy, 1629 const CXXRecordDecl::base_class_const_range &Bases, 1630 llvm::DenseSet<CanonicalDeclPtr<const CXXRecordDecl>> &SeenTypes, 1631 llvm::DINode::DIFlags StartingFlags) { 1632 const ASTRecordLayout &RL = CGM.getContext().getASTRecordLayout(RD); 1633 for (const auto &BI : Bases) { 1634 const auto *Base = 1635 cast<CXXRecordDecl>(BI.getType()->getAs<RecordType>()->getDecl()); 1636 if (!SeenTypes.insert(Base).second) 1637 continue; 1638 auto *BaseTy = getOrCreateType(BI.getType(), Unit); 1639 llvm::DINode::DIFlags BFlags = StartingFlags; 1640 uint64_t BaseOffset; 1641 uint32_t VBPtrOffset = 0; 1642 1643 if (BI.isVirtual()) { 1644 if (CGM.getTarget().getCXXABI().isItaniumFamily()) { 1645 // virtual base offset offset is -ve. The code generator emits dwarf 1646 // expression where it expects +ve number. 1647 BaseOffset = 0 - CGM.getItaniumVTableContext() 1648 .getVirtualBaseOffsetOffset(RD, Base) 1649 .getQuantity(); 1650 } else { 1651 // In the MS ABI, store the vbtable offset, which is analogous to the 1652 // vbase offset offset in Itanium. 1653 BaseOffset = 1654 4 * CGM.getMicrosoftVTableContext().getVBTableIndex(RD, Base); 1655 VBPtrOffset = CGM.getContext() 1656 .getASTRecordLayout(RD) 1657 .getVBPtrOffset() 1658 .getQuantity(); 1659 } 1660 BFlags |= llvm::DINode::FlagVirtual; 1661 } else 1662 BaseOffset = CGM.getContext().toBits(RL.getBaseClassOffset(Base)); 1663 // FIXME: Inconsistent units for BaseOffset. It is in bytes when 1664 // BI->isVirtual() and bits when not. 1665 1666 BFlags |= getAccessFlag(BI.getAccessSpecifier(), RD); 1667 llvm::DIType *DTy = DBuilder.createInheritance(RecordTy, BaseTy, BaseOffset, 1668 VBPtrOffset, BFlags); 1669 EltTys.push_back(DTy); 1670 } 1671 } 1672 1673 llvm::DINodeArray 1674 CGDebugInfo::CollectTemplateParams(const TemplateParameterList *TPList, 1675 ArrayRef<TemplateArgument> TAList, 1676 llvm::DIFile *Unit) { 1677 SmallVector<llvm::Metadata *, 16> TemplateParams; 1678 for (unsigned i = 0, e = TAList.size(); i != e; ++i) { 1679 const TemplateArgument &TA = TAList[i]; 1680 StringRef Name; 1681 if (TPList) 1682 Name = TPList->getParam(i)->getName(); 1683 switch (TA.getKind()) { 1684 case TemplateArgument::Type: { 1685 llvm::DIType *TTy = getOrCreateType(TA.getAsType(), Unit); 1686 TemplateParams.push_back( 1687 DBuilder.createTemplateTypeParameter(TheCU, Name, TTy)); 1688 } break; 1689 case TemplateArgument::Integral: { 1690 llvm::DIType *TTy = getOrCreateType(TA.getIntegralType(), Unit); 1691 TemplateParams.push_back(DBuilder.createTemplateValueParameter( 1692 TheCU, Name, TTy, 1693 llvm::ConstantInt::get(CGM.getLLVMContext(), TA.getAsIntegral()))); 1694 } break; 1695 case TemplateArgument::Declaration: { 1696 const ValueDecl *D = TA.getAsDecl(); 1697 QualType T = TA.getParamTypeForDecl().getDesugaredType(CGM.getContext()); 1698 llvm::DIType *TTy = getOrCreateType(T, Unit); 1699 llvm::Constant *V = nullptr; 1700 const CXXMethodDecl *MD; 1701 // Variable pointer template parameters have a value that is the address 1702 // of the variable. 1703 if (const auto *VD = dyn_cast<VarDecl>(D)) 1704 V = CGM.GetAddrOfGlobalVar(VD); 1705 // Member function pointers have special support for building them, though 1706 // this is currently unsupported in LLVM CodeGen. 1707 else if ((MD = dyn_cast<CXXMethodDecl>(D)) && MD->isInstance()) 1708 V = CGM.getCXXABI().EmitMemberFunctionPointer(MD); 1709 else if (const auto *FD = dyn_cast<FunctionDecl>(D)) 1710 V = CGM.GetAddrOfFunction(FD); 1711 // Member data pointers have special handling too to compute the fixed 1712 // offset within the object. 1713 else if (const auto *MPT = dyn_cast<MemberPointerType>(T.getTypePtr())) { 1714 // These five lines (& possibly the above member function pointer 1715 // handling) might be able to be refactored to use similar code in 1716 // CodeGenModule::getMemberPointerConstant 1717 uint64_t fieldOffset = CGM.getContext().getFieldOffset(D); 1718 CharUnits chars = 1719 CGM.getContext().toCharUnitsFromBits((int64_t)fieldOffset); 1720 V = CGM.getCXXABI().EmitMemberDataPointer(MPT, chars); 1721 } 1722 TemplateParams.push_back(DBuilder.createTemplateValueParameter( 1723 TheCU, Name, TTy, 1724 cast_or_null<llvm::Constant>(V->stripPointerCasts()))); 1725 } break; 1726 case TemplateArgument::NullPtr: { 1727 QualType T = TA.getNullPtrType(); 1728 llvm::DIType *TTy = getOrCreateType(T, Unit); 1729 llvm::Constant *V = nullptr; 1730 // Special case member data pointer null values since they're actually -1 1731 // instead of zero. 1732 if (const auto *MPT = dyn_cast<MemberPointerType>(T.getTypePtr())) 1733 // But treat member function pointers as simple zero integers because 1734 // it's easier than having a special case in LLVM's CodeGen. If LLVM 1735 // CodeGen grows handling for values of non-null member function 1736 // pointers then perhaps we could remove this special case and rely on 1737 // EmitNullMemberPointer for member function pointers. 1738 if (MPT->isMemberDataPointer()) 1739 V = CGM.getCXXABI().EmitNullMemberPointer(MPT); 1740 if (!V) 1741 V = llvm::ConstantInt::get(CGM.Int8Ty, 0); 1742 TemplateParams.push_back( 1743 DBuilder.createTemplateValueParameter(TheCU, Name, TTy, V)); 1744 } break; 1745 case TemplateArgument::Template: 1746 TemplateParams.push_back(DBuilder.createTemplateTemplateParameter( 1747 TheCU, Name, nullptr, 1748 TA.getAsTemplate().getAsTemplateDecl()->getQualifiedNameAsString())); 1749 break; 1750 case TemplateArgument::Pack: 1751 TemplateParams.push_back(DBuilder.createTemplateParameterPack( 1752 TheCU, Name, nullptr, 1753 CollectTemplateParams(nullptr, TA.getPackAsArray(), Unit))); 1754 break; 1755 case TemplateArgument::Expression: { 1756 const Expr *E = TA.getAsExpr(); 1757 QualType T = E->getType(); 1758 if (E->isGLValue()) 1759 T = CGM.getContext().getLValueReferenceType(T); 1760 llvm::Constant *V = ConstantEmitter(CGM).emitAbstract(E, T); 1761 assert(V && "Expression in template argument isn't constant"); 1762 llvm::DIType *TTy = getOrCreateType(T, Unit); 1763 TemplateParams.push_back(DBuilder.createTemplateValueParameter( 1764 TheCU, Name, TTy, V->stripPointerCasts())); 1765 } break; 1766 // And the following should never occur: 1767 case TemplateArgument::TemplateExpansion: 1768 case TemplateArgument::Null: 1769 llvm_unreachable( 1770 "These argument types shouldn't exist in concrete types"); 1771 } 1772 } 1773 return DBuilder.getOrCreateArray(TemplateParams); 1774 } 1775 1776 llvm::DINodeArray 1777 CGDebugInfo::CollectFunctionTemplateParams(const FunctionDecl *FD, 1778 llvm::DIFile *Unit) { 1779 if (FD->getTemplatedKind() == 1780 FunctionDecl::TK_FunctionTemplateSpecialization) { 1781 const TemplateParameterList *TList = FD->getTemplateSpecializationInfo() 1782 ->getTemplate() 1783 ->getTemplateParameters(); 1784 return CollectTemplateParams( 1785 TList, FD->getTemplateSpecializationArgs()->asArray(), Unit); 1786 } 1787 return llvm::DINodeArray(); 1788 } 1789 1790 llvm::DINodeArray CGDebugInfo::CollectVarTemplateParams(const VarDecl *VL, 1791 llvm::DIFile *Unit) { 1792 if (auto *TS = dyn_cast<VarTemplateSpecializationDecl>(VL)) { 1793 auto T = TS->getSpecializedTemplateOrPartial(); 1794 auto TA = TS->getTemplateArgs().asArray(); 1795 // Collect parameters for a partial specialization 1796 if (T.is<VarTemplatePartialSpecializationDecl *>()) { 1797 const TemplateParameterList *TList = 1798 T.get<VarTemplatePartialSpecializationDecl *>() 1799 ->getTemplateParameters(); 1800 return CollectTemplateParams(TList, TA, Unit); 1801 } 1802 1803 // Collect parameters for an explicit specialization 1804 if (T.is<VarTemplateDecl *>()) { 1805 const TemplateParameterList *TList = T.get<VarTemplateDecl *>() 1806 ->getTemplateParameters(); 1807 return CollectTemplateParams(TList, TA, Unit); 1808 } 1809 } 1810 return llvm::DINodeArray(); 1811 } 1812 1813 llvm::DINodeArray CGDebugInfo::CollectCXXTemplateParams( 1814 const ClassTemplateSpecializationDecl *TSpecial, llvm::DIFile *Unit) { 1815 // Always get the full list of parameters, not just the ones from 1816 // the specialization. 1817 TemplateParameterList *TPList = 1818 TSpecial->getSpecializedTemplate()->getTemplateParameters(); 1819 const TemplateArgumentList &TAList = TSpecial->getTemplateArgs(); 1820 return CollectTemplateParams(TPList, TAList.asArray(), Unit); 1821 } 1822 1823 llvm::DIType *CGDebugInfo::getOrCreateVTablePtrType(llvm::DIFile *Unit) { 1824 if (VTablePtrType) 1825 return VTablePtrType; 1826 1827 ASTContext &Context = CGM.getContext(); 1828 1829 /* Function type */ 1830 llvm::Metadata *STy = getOrCreateType(Context.IntTy, Unit); 1831 llvm::DITypeRefArray SElements = DBuilder.getOrCreateTypeArray(STy); 1832 llvm::DIType *SubTy = DBuilder.createSubroutineType(SElements); 1833 unsigned Size = Context.getTypeSize(Context.VoidPtrTy); 1834 unsigned VtblPtrAddressSpace = CGM.getTarget().getVtblPtrAddressSpace(); 1835 Optional<unsigned> DWARFAddressSpace = 1836 CGM.getTarget().getDWARFAddressSpace(VtblPtrAddressSpace); 1837 1838 llvm::DIType *vtbl_ptr_type = DBuilder.createPointerType( 1839 SubTy, Size, 0, DWARFAddressSpace, "__vtbl_ptr_type"); 1840 VTablePtrType = DBuilder.createPointerType(vtbl_ptr_type, Size); 1841 return VTablePtrType; 1842 } 1843 1844 StringRef CGDebugInfo::getVTableName(const CXXRecordDecl *RD) { 1845 // Copy the gdb compatible name on the side and use its reference. 1846 return internString("_vptr$", RD->getNameAsString()); 1847 } 1848 1849 void CGDebugInfo::CollectVTableInfo(const CXXRecordDecl *RD, llvm::DIFile *Unit, 1850 SmallVectorImpl<llvm::Metadata *> &EltTys, 1851 llvm::DICompositeType *RecordTy) { 1852 // If this class is not dynamic then there is not any vtable info to collect. 1853 if (!RD->isDynamicClass()) 1854 return; 1855 1856 // Don't emit any vtable shape or vptr info if this class doesn't have an 1857 // extendable vfptr. This can happen if the class doesn't have virtual 1858 // methods, or in the MS ABI if those virtual methods only come from virtually 1859 // inherited bases. 1860 const ASTRecordLayout &RL = CGM.getContext().getASTRecordLayout(RD); 1861 if (!RL.hasExtendableVFPtr()) 1862 return; 1863 1864 // CodeView needs to know how large the vtable of every dynamic class is, so 1865 // emit a special named pointer type into the element list. The vptr type 1866 // points to this type as well. 1867 llvm::DIType *VPtrTy = nullptr; 1868 bool NeedVTableShape = CGM.getCodeGenOpts().EmitCodeView && 1869 CGM.getTarget().getCXXABI().isMicrosoft(); 1870 if (NeedVTableShape) { 1871 uint64_t PtrWidth = 1872 CGM.getContext().getTypeSize(CGM.getContext().VoidPtrTy); 1873 const VTableLayout &VFTLayout = 1874 CGM.getMicrosoftVTableContext().getVFTableLayout(RD, CharUnits::Zero()); 1875 unsigned VSlotCount = 1876 VFTLayout.vtable_components().size() - CGM.getLangOpts().RTTIData; 1877 unsigned VTableWidth = PtrWidth * VSlotCount; 1878 unsigned VtblPtrAddressSpace = CGM.getTarget().getVtblPtrAddressSpace(); 1879 Optional<unsigned> DWARFAddressSpace = 1880 CGM.getTarget().getDWARFAddressSpace(VtblPtrAddressSpace); 1881 1882 // Create a very wide void* type and insert it directly in the element list. 1883 llvm::DIType *VTableType = DBuilder.createPointerType( 1884 nullptr, VTableWidth, 0, DWARFAddressSpace, "__vtbl_ptr_type"); 1885 EltTys.push_back(VTableType); 1886 1887 // The vptr is a pointer to this special vtable type. 1888 VPtrTy = DBuilder.createPointerType(VTableType, PtrWidth); 1889 } 1890 1891 // If there is a primary base then the artificial vptr member lives there. 1892 if (RL.getPrimaryBase()) 1893 return; 1894 1895 if (!VPtrTy) 1896 VPtrTy = getOrCreateVTablePtrType(Unit); 1897 1898 unsigned Size = CGM.getContext().getTypeSize(CGM.getContext().VoidPtrTy); 1899 llvm::DIType *VPtrMember = 1900 DBuilder.createMemberType(Unit, getVTableName(RD), Unit, 0, Size, 0, 0, 1901 llvm::DINode::FlagArtificial, VPtrTy); 1902 EltTys.push_back(VPtrMember); 1903 } 1904 1905 llvm::DIType *CGDebugInfo::getOrCreateRecordType(QualType RTy, 1906 SourceLocation Loc) { 1907 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 1908 llvm::DIType *T = getOrCreateType(RTy, getOrCreateFile(Loc)); 1909 return T; 1910 } 1911 1912 llvm::DIType *CGDebugInfo::getOrCreateInterfaceType(QualType D, 1913 SourceLocation Loc) { 1914 return getOrCreateStandaloneType(D, Loc); 1915 } 1916 1917 llvm::DIType *CGDebugInfo::getOrCreateStandaloneType(QualType D, 1918 SourceLocation Loc) { 1919 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 1920 assert(!D.isNull() && "null type"); 1921 llvm::DIType *T = getOrCreateType(D, getOrCreateFile(Loc)); 1922 assert(T && "could not create debug info for type"); 1923 1924 RetainedTypes.push_back(D.getAsOpaquePtr()); 1925 return T; 1926 } 1927 1928 void CGDebugInfo::completeType(const EnumDecl *ED) { 1929 if (DebugKind <= codegenoptions::DebugLineTablesOnly) 1930 return; 1931 QualType Ty = CGM.getContext().getEnumType(ED); 1932 void *TyPtr = Ty.getAsOpaquePtr(); 1933 auto I = TypeCache.find(TyPtr); 1934 if (I == TypeCache.end() || !cast<llvm::DIType>(I->second)->isForwardDecl()) 1935 return; 1936 llvm::DIType *Res = CreateTypeDefinition(Ty->castAs<EnumType>()); 1937 assert(!Res->isForwardDecl()); 1938 TypeCache[TyPtr].reset(Res); 1939 } 1940 1941 void CGDebugInfo::completeType(const RecordDecl *RD) { 1942 if (DebugKind > codegenoptions::LimitedDebugInfo || 1943 !CGM.getLangOpts().CPlusPlus) 1944 completeRequiredType(RD); 1945 } 1946 1947 /// Return true if the class or any of its methods are marked dllimport. 1948 static bool isClassOrMethodDLLImport(const CXXRecordDecl *RD) { 1949 if (RD->hasAttr<DLLImportAttr>()) 1950 return true; 1951 for (const CXXMethodDecl *MD : RD->methods()) 1952 if (MD->hasAttr<DLLImportAttr>()) 1953 return true; 1954 return false; 1955 } 1956 1957 /// Does a type definition exist in an imported clang module? 1958 static bool isDefinedInClangModule(const RecordDecl *RD) { 1959 // Only definitions that where imported from an AST file come from a module. 1960 if (!RD || !RD->isFromASTFile()) 1961 return false; 1962 // Anonymous entities cannot be addressed. Treat them as not from module. 1963 if (!RD->isExternallyVisible() && RD->getName().empty()) 1964 return false; 1965 if (auto *CXXDecl = dyn_cast<CXXRecordDecl>(RD)) { 1966 if (!CXXDecl->isCompleteDefinition()) 1967 return false; 1968 // Check wether RD is a template. 1969 auto TemplateKind = CXXDecl->getTemplateSpecializationKind(); 1970 if (TemplateKind != TSK_Undeclared) { 1971 // Unfortunately getOwningModule() isn't accurate enough to find the 1972 // owning module of a ClassTemplateSpecializationDecl that is inside a 1973 // namespace spanning multiple modules. 1974 bool Explicit = false; 1975 if (auto *TD = dyn_cast<ClassTemplateSpecializationDecl>(CXXDecl)) 1976 Explicit = TD->isExplicitInstantiationOrSpecialization(); 1977 if (!Explicit && CXXDecl->getEnclosingNamespaceContext()) 1978 return false; 1979 // This is a template, check the origin of the first member. 1980 if (CXXDecl->field_begin() == CXXDecl->field_end()) 1981 return TemplateKind == TSK_ExplicitInstantiationDeclaration; 1982 if (!CXXDecl->field_begin()->isFromASTFile()) 1983 return false; 1984 } 1985 } 1986 return true; 1987 } 1988 1989 void CGDebugInfo::completeClassData(const RecordDecl *RD) { 1990 if (auto *CXXRD = dyn_cast<CXXRecordDecl>(RD)) 1991 if (CXXRD->isDynamicClass() && 1992 CGM.getVTableLinkage(CXXRD) == 1993 llvm::GlobalValue::AvailableExternallyLinkage && 1994 !isClassOrMethodDLLImport(CXXRD)) 1995 return; 1996 1997 if (DebugTypeExtRefs && isDefinedInClangModule(RD->getDefinition())) 1998 return; 1999 2000 completeClass(RD); 2001 } 2002 2003 void CGDebugInfo::completeClass(const RecordDecl *RD) { 2004 if (DebugKind <= codegenoptions::DebugLineTablesOnly) 2005 return; 2006 QualType Ty = CGM.getContext().getRecordType(RD); 2007 void *TyPtr = Ty.getAsOpaquePtr(); 2008 auto I = TypeCache.find(TyPtr); 2009 if (I != TypeCache.end() && !cast<llvm::DIType>(I->second)->isForwardDecl()) 2010 return; 2011 llvm::DIType *Res = CreateTypeDefinition(Ty->castAs<RecordType>()); 2012 assert(!Res->isForwardDecl()); 2013 TypeCache[TyPtr].reset(Res); 2014 } 2015 2016 static bool hasExplicitMemberDefinition(CXXRecordDecl::method_iterator I, 2017 CXXRecordDecl::method_iterator End) { 2018 for (CXXMethodDecl *MD : llvm::make_range(I, End)) 2019 if (FunctionDecl *Tmpl = MD->getInstantiatedFromMemberFunction()) 2020 if (!Tmpl->isImplicit() && Tmpl->isThisDeclarationADefinition() && 2021 !MD->getMemberSpecializationInfo()->isExplicitSpecialization()) 2022 return true; 2023 return false; 2024 } 2025 2026 static bool shouldOmitDefinition(codegenoptions::DebugInfoKind DebugKind, 2027 bool DebugTypeExtRefs, const RecordDecl *RD, 2028 const LangOptions &LangOpts) { 2029 if (DebugTypeExtRefs && isDefinedInClangModule(RD->getDefinition())) 2030 return true; 2031 2032 if (auto *ES = RD->getASTContext().getExternalSource()) 2033 if (ES->hasExternalDefinitions(RD) == ExternalASTSource::EK_Always) 2034 return true; 2035 2036 if (DebugKind > codegenoptions::LimitedDebugInfo) 2037 return false; 2038 2039 if (!LangOpts.CPlusPlus) 2040 return false; 2041 2042 if (!RD->isCompleteDefinitionRequired()) 2043 return true; 2044 2045 const auto *CXXDecl = dyn_cast<CXXRecordDecl>(RD); 2046 2047 if (!CXXDecl) 2048 return false; 2049 2050 // Only emit complete debug info for a dynamic class when its vtable is 2051 // emitted. However, Microsoft debuggers don't resolve type information 2052 // across DLL boundaries, so skip this optimization if the class or any of its 2053 // methods are marked dllimport. This isn't a complete solution, since objects 2054 // without any dllimport methods can be used in one DLL and constructed in 2055 // another, but it is the current behavior of LimitedDebugInfo. 2056 if (CXXDecl->hasDefinition() && CXXDecl->isDynamicClass() && 2057 !isClassOrMethodDLLImport(CXXDecl)) 2058 return true; 2059 2060 TemplateSpecializationKind Spec = TSK_Undeclared; 2061 if (const auto *SD = dyn_cast<ClassTemplateSpecializationDecl>(RD)) 2062 Spec = SD->getSpecializationKind(); 2063 2064 if (Spec == TSK_ExplicitInstantiationDeclaration && 2065 hasExplicitMemberDefinition(CXXDecl->method_begin(), 2066 CXXDecl->method_end())) 2067 return true; 2068 2069 return false; 2070 } 2071 2072 void CGDebugInfo::completeRequiredType(const RecordDecl *RD) { 2073 if (shouldOmitDefinition(DebugKind, DebugTypeExtRefs, RD, CGM.getLangOpts())) 2074 return; 2075 2076 QualType Ty = CGM.getContext().getRecordType(RD); 2077 llvm::DIType *T = getTypeOrNull(Ty); 2078 if (T && T->isForwardDecl()) 2079 completeClassData(RD); 2080 } 2081 2082 llvm::DIType *CGDebugInfo::CreateType(const RecordType *Ty) { 2083 RecordDecl *RD = Ty->getDecl(); 2084 llvm::DIType *T = cast_or_null<llvm::DIType>(getTypeOrNull(QualType(Ty, 0))); 2085 if (T || shouldOmitDefinition(DebugKind, DebugTypeExtRefs, RD, 2086 CGM.getLangOpts())) { 2087 if (!T) 2088 T = getOrCreateRecordFwdDecl(Ty, getDeclContextDescriptor(RD)); 2089 return T; 2090 } 2091 2092 return CreateTypeDefinition(Ty); 2093 } 2094 2095 llvm::DIType *CGDebugInfo::CreateTypeDefinition(const RecordType *Ty) { 2096 RecordDecl *RD = Ty->getDecl(); 2097 2098 // Get overall information about the record type for the debug info. 2099 llvm::DIFile *DefUnit = getOrCreateFile(RD->getLocation()); 2100 2101 // Records and classes and unions can all be recursive. To handle them, we 2102 // first generate a debug descriptor for the struct as a forward declaration. 2103 // Then (if it is a definition) we go through and get debug info for all of 2104 // its members. Finally, we create a descriptor for the complete type (which 2105 // may refer to the forward decl if the struct is recursive) and replace all 2106 // uses of the forward declaration with the final definition. 2107 llvm::DICompositeType *FwdDecl = getOrCreateLimitedType(Ty, DefUnit); 2108 2109 const RecordDecl *D = RD->getDefinition(); 2110 if (!D || !D->isCompleteDefinition()) 2111 return FwdDecl; 2112 2113 if (const auto *CXXDecl = dyn_cast<CXXRecordDecl>(RD)) 2114 CollectContainingType(CXXDecl, FwdDecl); 2115 2116 // Push the struct on region stack. 2117 LexicalBlockStack.emplace_back(&*FwdDecl); 2118 RegionMap[Ty->getDecl()].reset(FwdDecl); 2119 2120 // Convert all the elements. 2121 SmallVector<llvm::Metadata *, 16> EltTys; 2122 // what about nested types? 2123 2124 // Note: The split of CXXDecl information here is intentional, the 2125 // gdb tests will depend on a certain ordering at printout. The debug 2126 // information offsets are still correct if we merge them all together 2127 // though. 2128 const auto *CXXDecl = dyn_cast<CXXRecordDecl>(RD); 2129 if (CXXDecl) { 2130 CollectCXXBases(CXXDecl, DefUnit, EltTys, FwdDecl); 2131 CollectVTableInfo(CXXDecl, DefUnit, EltTys, FwdDecl); 2132 } 2133 2134 // Collect data fields (including static variables and any initializers). 2135 CollectRecordFields(RD, DefUnit, EltTys, FwdDecl); 2136 if (CXXDecl) 2137 CollectCXXMemberFunctions(CXXDecl, DefUnit, EltTys, FwdDecl); 2138 2139 LexicalBlockStack.pop_back(); 2140 RegionMap.erase(Ty->getDecl()); 2141 2142 llvm::DINodeArray Elements = DBuilder.getOrCreateArray(EltTys); 2143 DBuilder.replaceArrays(FwdDecl, Elements); 2144 2145 if (FwdDecl->isTemporary()) 2146 FwdDecl = 2147 llvm::MDNode::replaceWithPermanent(llvm::TempDICompositeType(FwdDecl)); 2148 2149 RegionMap[Ty->getDecl()].reset(FwdDecl); 2150 return FwdDecl; 2151 } 2152 2153 llvm::DIType *CGDebugInfo::CreateType(const ObjCObjectType *Ty, 2154 llvm::DIFile *Unit) { 2155 // Ignore protocols. 2156 return getOrCreateType(Ty->getBaseType(), Unit); 2157 } 2158 2159 llvm::DIType *CGDebugInfo::CreateType(const ObjCTypeParamType *Ty, 2160 llvm::DIFile *Unit) { 2161 // Ignore protocols. 2162 SourceLocation Loc = Ty->getDecl()->getLocation(); 2163 2164 // Use Typedefs to represent ObjCTypeParamType. 2165 return DBuilder.createTypedef( 2166 getOrCreateType(Ty->getDecl()->getUnderlyingType(), Unit), 2167 Ty->getDecl()->getName(), getOrCreateFile(Loc), getLineNumber(Loc), 2168 getDeclContextDescriptor(Ty->getDecl())); 2169 } 2170 2171 /// \return true if Getter has the default name for the property PD. 2172 static bool hasDefaultGetterName(const ObjCPropertyDecl *PD, 2173 const ObjCMethodDecl *Getter) { 2174 assert(PD); 2175 if (!Getter) 2176 return true; 2177 2178 assert(Getter->getDeclName().isObjCZeroArgSelector()); 2179 return PD->getName() == 2180 Getter->getDeclName().getObjCSelector().getNameForSlot(0); 2181 } 2182 2183 /// \return true if Setter has the default name for the property PD. 2184 static bool hasDefaultSetterName(const ObjCPropertyDecl *PD, 2185 const ObjCMethodDecl *Setter) { 2186 assert(PD); 2187 if (!Setter) 2188 return true; 2189 2190 assert(Setter->getDeclName().isObjCOneArgSelector()); 2191 return SelectorTable::constructSetterName(PD->getName()) == 2192 Setter->getDeclName().getObjCSelector().getNameForSlot(0); 2193 } 2194 2195 llvm::DIType *CGDebugInfo::CreateType(const ObjCInterfaceType *Ty, 2196 llvm::DIFile *Unit) { 2197 ObjCInterfaceDecl *ID = Ty->getDecl(); 2198 if (!ID) 2199 return nullptr; 2200 2201 // Return a forward declaration if this type was imported from a clang module, 2202 // and this is not the compile unit with the implementation of the type (which 2203 // may contain hidden ivars). 2204 if (DebugTypeExtRefs && ID->isFromASTFile() && ID->getDefinition() && 2205 !ID->getImplementation()) 2206 return DBuilder.createForwardDecl(llvm::dwarf::DW_TAG_structure_type, 2207 ID->getName(), 2208 getDeclContextDescriptor(ID), Unit, 0); 2209 2210 // Get overall information about the record type for the debug info. 2211 llvm::DIFile *DefUnit = getOrCreateFile(ID->getLocation()); 2212 unsigned Line = getLineNumber(ID->getLocation()); 2213 auto RuntimeLang = 2214 static_cast<llvm::dwarf::SourceLanguage>(TheCU->getSourceLanguage()); 2215 2216 // If this is just a forward declaration return a special forward-declaration 2217 // debug type since we won't be able to lay out the entire type. 2218 ObjCInterfaceDecl *Def = ID->getDefinition(); 2219 if (!Def || !Def->getImplementation()) { 2220 llvm::DIScope *Mod = getParentModuleOrNull(ID); 2221 llvm::DIType *FwdDecl = DBuilder.createReplaceableCompositeType( 2222 llvm::dwarf::DW_TAG_structure_type, ID->getName(), Mod ? Mod : TheCU, 2223 DefUnit, Line, RuntimeLang); 2224 ObjCInterfaceCache.push_back(ObjCInterfaceCacheEntry(Ty, FwdDecl, Unit)); 2225 return FwdDecl; 2226 } 2227 2228 return CreateTypeDefinition(Ty, Unit); 2229 } 2230 2231 llvm::DIModule * 2232 CGDebugInfo::getOrCreateModuleRef(ExternalASTSource::ASTSourceDescriptor Mod, 2233 bool CreateSkeletonCU) { 2234 // Use the Module pointer as the key into the cache. This is a 2235 // nullptr if the "Module" is a PCH, which is safe because we don't 2236 // support chained PCH debug info, so there can only be a single PCH. 2237 const Module *M = Mod.getModuleOrNull(); 2238 auto ModRef = ModuleCache.find(M); 2239 if (ModRef != ModuleCache.end()) 2240 return cast<llvm::DIModule>(ModRef->second); 2241 2242 // Macro definitions that were defined with "-D" on the command line. 2243 SmallString<128> ConfigMacros; 2244 { 2245 llvm::raw_svector_ostream OS(ConfigMacros); 2246 const auto &PPOpts = CGM.getPreprocessorOpts(); 2247 unsigned I = 0; 2248 // Translate the macro definitions back into a command line. 2249 for (auto &M : PPOpts.Macros) { 2250 if (++I > 1) 2251 OS << " "; 2252 const std::string &Macro = M.first; 2253 bool Undef = M.second; 2254 OS << "\"-" << (Undef ? 'U' : 'D'); 2255 for (char c : Macro) 2256 switch (c) { 2257 case '\\': 2258 OS << "\\\\"; 2259 break; 2260 case '"': 2261 OS << "\\\""; 2262 break; 2263 default: 2264 OS << c; 2265 } 2266 OS << '\"'; 2267 } 2268 } 2269 2270 bool IsRootModule = M ? !M->Parent : true; 2271 if (CreateSkeletonCU && IsRootModule) { 2272 // PCH files don't have a signature field in the control block, 2273 // but LLVM detects skeleton CUs by looking for a non-zero DWO id. 2274 // We use the lower 64 bits for debug info. 2275 uint64_t Signature = 2276 Mod.getSignature() 2277 ? (uint64_t)Mod.getSignature()[1] << 32 | Mod.getSignature()[0] 2278 : ~1ULL; 2279 llvm::DIBuilder DIB(CGM.getModule()); 2280 DIB.createCompileUnit(TheCU->getSourceLanguage(), 2281 // TODO: Support "Source" from external AST providers? 2282 DIB.createFile(Mod.getModuleName(), Mod.getPath()), 2283 TheCU->getProducer(), true, StringRef(), 0, 2284 Mod.getASTFile(), llvm::DICompileUnit::FullDebug, 2285 Signature); 2286 DIB.finalize(); 2287 } 2288 llvm::DIModule *Parent = 2289 IsRootModule ? nullptr 2290 : getOrCreateModuleRef( 2291 ExternalASTSource::ASTSourceDescriptor(*M->Parent), 2292 CreateSkeletonCU); 2293 llvm::DIModule *DIMod = 2294 DBuilder.createModule(Parent, Mod.getModuleName(), ConfigMacros, 2295 Mod.getPath(), CGM.getHeaderSearchOpts().Sysroot); 2296 ModuleCache[M].reset(DIMod); 2297 return DIMod; 2298 } 2299 2300 llvm::DIType *CGDebugInfo::CreateTypeDefinition(const ObjCInterfaceType *Ty, 2301 llvm::DIFile *Unit) { 2302 ObjCInterfaceDecl *ID = Ty->getDecl(); 2303 llvm::DIFile *DefUnit = getOrCreateFile(ID->getLocation()); 2304 unsigned Line = getLineNumber(ID->getLocation()); 2305 unsigned RuntimeLang = TheCU->getSourceLanguage(); 2306 2307 // Bit size, align and offset of the type. 2308 uint64_t Size = CGM.getContext().getTypeSize(Ty); 2309 auto Align = getTypeAlignIfRequired(Ty, CGM.getContext()); 2310 2311 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 2312 if (ID->getImplementation()) 2313 Flags |= llvm::DINode::FlagObjcClassComplete; 2314 2315 llvm::DIScope *Mod = getParentModuleOrNull(ID); 2316 llvm::DICompositeType *RealDecl = DBuilder.createStructType( 2317 Mod ? Mod : Unit, ID->getName(), DefUnit, Line, Size, Align, Flags, 2318 nullptr, llvm::DINodeArray(), RuntimeLang); 2319 2320 QualType QTy(Ty, 0); 2321 TypeCache[QTy.getAsOpaquePtr()].reset(RealDecl); 2322 2323 // Push the struct on region stack. 2324 LexicalBlockStack.emplace_back(RealDecl); 2325 RegionMap[Ty->getDecl()].reset(RealDecl); 2326 2327 // Convert all the elements. 2328 SmallVector<llvm::Metadata *, 16> EltTys; 2329 2330 ObjCInterfaceDecl *SClass = ID->getSuperClass(); 2331 if (SClass) { 2332 llvm::DIType *SClassTy = 2333 getOrCreateType(CGM.getContext().getObjCInterfaceType(SClass), Unit); 2334 if (!SClassTy) 2335 return nullptr; 2336 2337 llvm::DIType *InhTag = DBuilder.createInheritance(RealDecl, SClassTy, 0, 0, 2338 llvm::DINode::FlagZero); 2339 EltTys.push_back(InhTag); 2340 } 2341 2342 // Create entries for all of the properties. 2343 auto AddProperty = [&](const ObjCPropertyDecl *PD) { 2344 SourceLocation Loc = PD->getLocation(); 2345 llvm::DIFile *PUnit = getOrCreateFile(Loc); 2346 unsigned PLine = getLineNumber(Loc); 2347 ObjCMethodDecl *Getter = PD->getGetterMethodDecl(); 2348 ObjCMethodDecl *Setter = PD->getSetterMethodDecl(); 2349 llvm::MDNode *PropertyNode = DBuilder.createObjCProperty( 2350 PD->getName(), PUnit, PLine, 2351 hasDefaultGetterName(PD, Getter) ? "" 2352 : getSelectorName(PD->getGetterName()), 2353 hasDefaultSetterName(PD, Setter) ? "" 2354 : getSelectorName(PD->getSetterName()), 2355 PD->getPropertyAttributes(), getOrCreateType(PD->getType(), PUnit)); 2356 EltTys.push_back(PropertyNode); 2357 }; 2358 { 2359 llvm::SmallPtrSet<const IdentifierInfo *, 16> PropertySet; 2360 for (const ObjCCategoryDecl *ClassExt : ID->known_extensions()) 2361 for (auto *PD : ClassExt->properties()) { 2362 PropertySet.insert(PD->getIdentifier()); 2363 AddProperty(PD); 2364 } 2365 for (const auto *PD : ID->properties()) { 2366 // Don't emit duplicate metadata for properties that were already in a 2367 // class extension. 2368 if (!PropertySet.insert(PD->getIdentifier()).second) 2369 continue; 2370 AddProperty(PD); 2371 } 2372 } 2373 2374 const ASTRecordLayout &RL = CGM.getContext().getASTObjCInterfaceLayout(ID); 2375 unsigned FieldNo = 0; 2376 for (ObjCIvarDecl *Field = ID->all_declared_ivar_begin(); Field; 2377 Field = Field->getNextIvar(), ++FieldNo) { 2378 llvm::DIType *FieldTy = getOrCreateType(Field->getType(), Unit); 2379 if (!FieldTy) 2380 return nullptr; 2381 2382 StringRef FieldName = Field->getName(); 2383 2384 // Ignore unnamed fields. 2385 if (FieldName.empty()) 2386 continue; 2387 2388 // Get the location for the field. 2389 llvm::DIFile *FieldDefUnit = getOrCreateFile(Field->getLocation()); 2390 unsigned FieldLine = getLineNumber(Field->getLocation()); 2391 QualType FType = Field->getType(); 2392 uint64_t FieldSize = 0; 2393 uint32_t FieldAlign = 0; 2394 2395 if (!FType->isIncompleteArrayType()) { 2396 2397 // Bit size, align and offset of the type. 2398 FieldSize = Field->isBitField() 2399 ? Field->getBitWidthValue(CGM.getContext()) 2400 : CGM.getContext().getTypeSize(FType); 2401 FieldAlign = getTypeAlignIfRequired(FType, CGM.getContext()); 2402 } 2403 2404 uint64_t FieldOffset; 2405 if (CGM.getLangOpts().ObjCRuntime.isNonFragile()) { 2406 // We don't know the runtime offset of an ivar if we're using the 2407 // non-fragile ABI. For bitfields, use the bit offset into the first 2408 // byte of storage of the bitfield. For other fields, use zero. 2409 if (Field->isBitField()) { 2410 FieldOffset = 2411 CGM.getObjCRuntime().ComputeBitfieldBitOffset(CGM, ID, Field); 2412 FieldOffset %= CGM.getContext().getCharWidth(); 2413 } else { 2414 FieldOffset = 0; 2415 } 2416 } else { 2417 FieldOffset = RL.getFieldOffset(FieldNo); 2418 } 2419 2420 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 2421 if (Field->getAccessControl() == ObjCIvarDecl::Protected) 2422 Flags = llvm::DINode::FlagProtected; 2423 else if (Field->getAccessControl() == ObjCIvarDecl::Private) 2424 Flags = llvm::DINode::FlagPrivate; 2425 else if (Field->getAccessControl() == ObjCIvarDecl::Public) 2426 Flags = llvm::DINode::FlagPublic; 2427 2428 llvm::MDNode *PropertyNode = nullptr; 2429 if (ObjCImplementationDecl *ImpD = ID->getImplementation()) { 2430 if (ObjCPropertyImplDecl *PImpD = 2431 ImpD->FindPropertyImplIvarDecl(Field->getIdentifier())) { 2432 if (ObjCPropertyDecl *PD = PImpD->getPropertyDecl()) { 2433 SourceLocation Loc = PD->getLocation(); 2434 llvm::DIFile *PUnit = getOrCreateFile(Loc); 2435 unsigned PLine = getLineNumber(Loc); 2436 ObjCMethodDecl *Getter = PD->getGetterMethodDecl(); 2437 ObjCMethodDecl *Setter = PD->getSetterMethodDecl(); 2438 PropertyNode = DBuilder.createObjCProperty( 2439 PD->getName(), PUnit, PLine, 2440 hasDefaultGetterName(PD, Getter) 2441 ? "" 2442 : getSelectorName(PD->getGetterName()), 2443 hasDefaultSetterName(PD, Setter) 2444 ? "" 2445 : getSelectorName(PD->getSetterName()), 2446 PD->getPropertyAttributes(), 2447 getOrCreateType(PD->getType(), PUnit)); 2448 } 2449 } 2450 } 2451 FieldTy = DBuilder.createObjCIVar(FieldName, FieldDefUnit, FieldLine, 2452 FieldSize, FieldAlign, FieldOffset, Flags, 2453 FieldTy, PropertyNode); 2454 EltTys.push_back(FieldTy); 2455 } 2456 2457 llvm::DINodeArray Elements = DBuilder.getOrCreateArray(EltTys); 2458 DBuilder.replaceArrays(RealDecl, Elements); 2459 2460 LexicalBlockStack.pop_back(); 2461 return RealDecl; 2462 } 2463 2464 llvm::DIType *CGDebugInfo::CreateType(const VectorType *Ty, 2465 llvm::DIFile *Unit) { 2466 llvm::DIType *ElementTy = getOrCreateType(Ty->getElementType(), Unit); 2467 int64_t Count = Ty->getNumElements(); 2468 2469 llvm::Metadata *Subscript; 2470 QualType QTy(Ty, 0); 2471 auto SizeExpr = SizeExprCache.find(QTy); 2472 if (SizeExpr != SizeExprCache.end()) 2473 Subscript = DBuilder.getOrCreateSubrange(0, SizeExpr->getSecond()); 2474 else 2475 Subscript = DBuilder.getOrCreateSubrange(0, Count ? Count : -1); 2476 llvm::DINodeArray SubscriptArray = DBuilder.getOrCreateArray(Subscript); 2477 2478 uint64_t Size = CGM.getContext().getTypeSize(Ty); 2479 auto Align = getTypeAlignIfRequired(Ty, CGM.getContext()); 2480 2481 return DBuilder.createVectorType(Size, Align, ElementTy, SubscriptArray); 2482 } 2483 2484 llvm::DIType *CGDebugInfo::CreateType(const ArrayType *Ty, llvm::DIFile *Unit) { 2485 uint64_t Size; 2486 uint32_t Align; 2487 2488 // FIXME: make getTypeAlign() aware of VLAs and incomplete array types 2489 if (const auto *VAT = dyn_cast<VariableArrayType>(Ty)) { 2490 Size = 0; 2491 Align = getTypeAlignIfRequired(CGM.getContext().getBaseElementType(VAT), 2492 CGM.getContext()); 2493 } else if (Ty->isIncompleteArrayType()) { 2494 Size = 0; 2495 if (Ty->getElementType()->isIncompleteType()) 2496 Align = 0; 2497 else 2498 Align = getTypeAlignIfRequired(Ty->getElementType(), CGM.getContext()); 2499 } else if (Ty->isIncompleteType()) { 2500 Size = 0; 2501 Align = 0; 2502 } else { 2503 // Size and align of the whole array, not the element type. 2504 Size = CGM.getContext().getTypeSize(Ty); 2505 Align = getTypeAlignIfRequired(Ty, CGM.getContext()); 2506 } 2507 2508 // Add the dimensions of the array. FIXME: This loses CV qualifiers from 2509 // interior arrays, do we care? Why aren't nested arrays represented the 2510 // obvious/recursive way? 2511 SmallVector<llvm::Metadata *, 8> Subscripts; 2512 QualType EltTy(Ty, 0); 2513 while ((Ty = dyn_cast<ArrayType>(EltTy))) { 2514 // If the number of elements is known, then count is that number. Otherwise, 2515 // it's -1. This allows us to represent a subrange with an array of 0 2516 // elements, like this: 2517 // 2518 // struct foo { 2519 // int x[0]; 2520 // }; 2521 int64_t Count = -1; // Count == -1 is an unbounded array. 2522 if (const auto *CAT = dyn_cast<ConstantArrayType>(Ty)) 2523 Count = CAT->getSize().getZExtValue(); 2524 else if (const auto *VAT = dyn_cast<VariableArrayType>(Ty)) { 2525 if (Expr *Size = VAT->getSizeExpr()) { 2526 Expr::EvalResult Result; 2527 if (Size->EvaluateAsInt(Result, CGM.getContext())) 2528 Count = Result.Val.getInt().getExtValue(); 2529 } 2530 } 2531 2532 auto SizeNode = SizeExprCache.find(EltTy); 2533 if (SizeNode != SizeExprCache.end()) 2534 Subscripts.push_back( 2535 DBuilder.getOrCreateSubrange(0, SizeNode->getSecond())); 2536 else 2537 Subscripts.push_back(DBuilder.getOrCreateSubrange(0, Count)); 2538 EltTy = Ty->getElementType(); 2539 } 2540 2541 llvm::DINodeArray SubscriptArray = DBuilder.getOrCreateArray(Subscripts); 2542 2543 return DBuilder.createArrayType(Size, Align, getOrCreateType(EltTy, Unit), 2544 SubscriptArray); 2545 } 2546 2547 llvm::DIType *CGDebugInfo::CreateType(const LValueReferenceType *Ty, 2548 llvm::DIFile *Unit) { 2549 return CreatePointerLikeType(llvm::dwarf::DW_TAG_reference_type, Ty, 2550 Ty->getPointeeType(), Unit); 2551 } 2552 2553 llvm::DIType *CGDebugInfo::CreateType(const RValueReferenceType *Ty, 2554 llvm::DIFile *Unit) { 2555 return CreatePointerLikeType(llvm::dwarf::DW_TAG_rvalue_reference_type, Ty, 2556 Ty->getPointeeType(), Unit); 2557 } 2558 2559 llvm::DIType *CGDebugInfo::CreateType(const MemberPointerType *Ty, 2560 llvm::DIFile *U) { 2561 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 2562 uint64_t Size = 0; 2563 2564 if (!Ty->isIncompleteType()) { 2565 Size = CGM.getContext().getTypeSize(Ty); 2566 2567 // Set the MS inheritance model. There is no flag for the unspecified model. 2568 if (CGM.getTarget().getCXXABI().isMicrosoft()) { 2569 switch (Ty->getMostRecentCXXRecordDecl()->getMSInheritanceModel()) { 2570 case MSInheritanceAttr::Keyword_single_inheritance: 2571 Flags |= llvm::DINode::FlagSingleInheritance; 2572 break; 2573 case MSInheritanceAttr::Keyword_multiple_inheritance: 2574 Flags |= llvm::DINode::FlagMultipleInheritance; 2575 break; 2576 case MSInheritanceAttr::Keyword_virtual_inheritance: 2577 Flags |= llvm::DINode::FlagVirtualInheritance; 2578 break; 2579 case MSInheritanceAttr::Keyword_unspecified_inheritance: 2580 break; 2581 } 2582 } 2583 } 2584 2585 llvm::DIType *ClassType = getOrCreateType(QualType(Ty->getClass(), 0), U); 2586 if (Ty->isMemberDataPointerType()) 2587 return DBuilder.createMemberPointerType( 2588 getOrCreateType(Ty->getPointeeType(), U), ClassType, Size, /*Align=*/0, 2589 Flags); 2590 2591 const FunctionProtoType *FPT = 2592 Ty->getPointeeType()->getAs<FunctionProtoType>(); 2593 return DBuilder.createMemberPointerType( 2594 getOrCreateInstanceMethodType(CGM.getContext().getPointerType(QualType( 2595 Ty->getClass(), FPT->getTypeQuals())), 2596 FPT, U), 2597 ClassType, Size, /*Align=*/0, Flags); 2598 } 2599 2600 llvm::DIType *CGDebugInfo::CreateType(const AtomicType *Ty, llvm::DIFile *U) { 2601 auto *FromTy = getOrCreateType(Ty->getValueType(), U); 2602 return DBuilder.createQualifiedType(llvm::dwarf::DW_TAG_atomic_type, FromTy); 2603 } 2604 2605 llvm::DIType *CGDebugInfo::CreateType(const PipeType *Ty, llvm::DIFile *U) { 2606 return getOrCreateType(Ty->getElementType(), U); 2607 } 2608 2609 llvm::DIType *CGDebugInfo::CreateEnumType(const EnumType *Ty) { 2610 const EnumDecl *ED = Ty->getDecl(); 2611 2612 uint64_t Size = 0; 2613 uint32_t Align = 0; 2614 if (!ED->getTypeForDecl()->isIncompleteType()) { 2615 Size = CGM.getContext().getTypeSize(ED->getTypeForDecl()); 2616 Align = getDeclAlignIfRequired(ED, CGM.getContext()); 2617 } 2618 2619 SmallString<256> Identifier = getTypeIdentifier(Ty, CGM, TheCU); 2620 2621 bool isImportedFromModule = 2622 DebugTypeExtRefs && ED->isFromASTFile() && ED->getDefinition(); 2623 2624 // If this is just a forward declaration, construct an appropriately 2625 // marked node and just return it. 2626 if (isImportedFromModule || !ED->getDefinition()) { 2627 // Note that it is possible for enums to be created as part of 2628 // their own declcontext. In this case a FwdDecl will be created 2629 // twice. This doesn't cause a problem because both FwdDecls are 2630 // entered into the ReplaceMap: finalize() will replace the first 2631 // FwdDecl with the second and then replace the second with 2632 // complete type. 2633 llvm::DIScope *EDContext = getDeclContextDescriptor(ED); 2634 llvm::DIFile *DefUnit = getOrCreateFile(ED->getLocation()); 2635 llvm::TempDIScope TmpContext(DBuilder.createReplaceableCompositeType( 2636 llvm::dwarf::DW_TAG_enumeration_type, "", TheCU, DefUnit, 0)); 2637 2638 unsigned Line = getLineNumber(ED->getLocation()); 2639 StringRef EDName = ED->getName(); 2640 llvm::DIType *RetTy = DBuilder.createReplaceableCompositeType( 2641 llvm::dwarf::DW_TAG_enumeration_type, EDName, EDContext, DefUnit, Line, 2642 0, Size, Align, llvm::DINode::FlagFwdDecl, Identifier); 2643 2644 ReplaceMap.emplace_back( 2645 std::piecewise_construct, std::make_tuple(Ty), 2646 std::make_tuple(static_cast<llvm::Metadata *>(RetTy))); 2647 return RetTy; 2648 } 2649 2650 return CreateTypeDefinition(Ty); 2651 } 2652 2653 llvm::DIType *CGDebugInfo::CreateTypeDefinition(const EnumType *Ty) { 2654 const EnumDecl *ED = Ty->getDecl(); 2655 uint64_t Size = 0; 2656 uint32_t Align = 0; 2657 if (!ED->getTypeForDecl()->isIncompleteType()) { 2658 Size = CGM.getContext().getTypeSize(ED->getTypeForDecl()); 2659 Align = getDeclAlignIfRequired(ED, CGM.getContext()); 2660 } 2661 2662 SmallString<256> Identifier = getTypeIdentifier(Ty, CGM, TheCU); 2663 2664 // Create elements for each enumerator. 2665 SmallVector<llvm::Metadata *, 16> Enumerators; 2666 ED = ED->getDefinition(); 2667 bool IsSigned = ED->getIntegerType()->isSignedIntegerType(); 2668 for (const auto *Enum : ED->enumerators()) { 2669 const auto &InitVal = Enum->getInitVal(); 2670 auto Value = IsSigned ? InitVal.getSExtValue() : InitVal.getZExtValue(); 2671 Enumerators.push_back( 2672 DBuilder.createEnumerator(Enum->getName(), Value, !IsSigned)); 2673 } 2674 2675 // Return a CompositeType for the enum itself. 2676 llvm::DINodeArray EltArray = DBuilder.getOrCreateArray(Enumerators); 2677 2678 llvm::DIFile *DefUnit = getOrCreateFile(ED->getLocation()); 2679 unsigned Line = getLineNumber(ED->getLocation()); 2680 llvm::DIScope *EnumContext = getDeclContextDescriptor(ED); 2681 llvm::DIType *ClassTy = getOrCreateType(ED->getIntegerType(), DefUnit); 2682 return DBuilder.createEnumerationType(EnumContext, ED->getName(), DefUnit, 2683 Line, Size, Align, EltArray, ClassTy, 2684 Identifier, ED->isFixed()); 2685 } 2686 2687 llvm::DIMacro *CGDebugInfo::CreateMacro(llvm::DIMacroFile *Parent, 2688 unsigned MType, SourceLocation LineLoc, 2689 StringRef Name, StringRef Value) { 2690 unsigned Line = LineLoc.isInvalid() ? 0 : getLineNumber(LineLoc); 2691 return DBuilder.createMacro(Parent, Line, MType, Name, Value); 2692 } 2693 2694 llvm::DIMacroFile *CGDebugInfo::CreateTempMacroFile(llvm::DIMacroFile *Parent, 2695 SourceLocation LineLoc, 2696 SourceLocation FileLoc) { 2697 llvm::DIFile *FName = getOrCreateFile(FileLoc); 2698 unsigned Line = LineLoc.isInvalid() ? 0 : getLineNumber(LineLoc); 2699 return DBuilder.createTempMacroFile(Parent, Line, FName); 2700 } 2701 2702 static QualType UnwrapTypeForDebugInfo(QualType T, const ASTContext &C) { 2703 Qualifiers Quals; 2704 do { 2705 Qualifiers InnerQuals = T.getLocalQualifiers(); 2706 // Qualifiers::operator+() doesn't like it if you add a Qualifier 2707 // that is already there. 2708 Quals += Qualifiers::removeCommonQualifiers(Quals, InnerQuals); 2709 Quals += InnerQuals; 2710 QualType LastT = T; 2711 switch (T->getTypeClass()) { 2712 default: 2713 return C.getQualifiedType(T.getTypePtr(), Quals); 2714 case Type::TemplateSpecialization: { 2715 const auto *Spec = cast<TemplateSpecializationType>(T); 2716 if (Spec->isTypeAlias()) 2717 return C.getQualifiedType(T.getTypePtr(), Quals); 2718 T = Spec->desugar(); 2719 break; 2720 } 2721 case Type::TypeOfExpr: 2722 T = cast<TypeOfExprType>(T)->getUnderlyingExpr()->getType(); 2723 break; 2724 case Type::TypeOf: 2725 T = cast<TypeOfType>(T)->getUnderlyingType(); 2726 break; 2727 case Type::Decltype: 2728 T = cast<DecltypeType>(T)->getUnderlyingType(); 2729 break; 2730 case Type::UnaryTransform: 2731 T = cast<UnaryTransformType>(T)->getUnderlyingType(); 2732 break; 2733 case Type::Attributed: 2734 T = cast<AttributedType>(T)->getEquivalentType(); 2735 break; 2736 case Type::Elaborated: 2737 T = cast<ElaboratedType>(T)->getNamedType(); 2738 break; 2739 case Type::Paren: 2740 T = cast<ParenType>(T)->getInnerType(); 2741 break; 2742 case Type::SubstTemplateTypeParm: 2743 T = cast<SubstTemplateTypeParmType>(T)->getReplacementType(); 2744 break; 2745 case Type::Auto: 2746 case Type::DeducedTemplateSpecialization: { 2747 QualType DT = cast<DeducedType>(T)->getDeducedType(); 2748 assert(!DT.isNull() && "Undeduced types shouldn't reach here."); 2749 T = DT; 2750 break; 2751 } 2752 case Type::Adjusted: 2753 case Type::Decayed: 2754 // Decayed and adjusted types use the adjusted type in LLVM and DWARF. 2755 T = cast<AdjustedType>(T)->getAdjustedType(); 2756 break; 2757 } 2758 2759 assert(T != LastT && "Type unwrapping failed to unwrap!"); 2760 (void)LastT; 2761 } while (true); 2762 } 2763 2764 llvm::DIType *CGDebugInfo::getTypeOrNull(QualType Ty) { 2765 2766 // Unwrap the type as needed for debug information. 2767 Ty = UnwrapTypeForDebugInfo(Ty, CGM.getContext()); 2768 2769 auto It = TypeCache.find(Ty.getAsOpaquePtr()); 2770 if (It != TypeCache.end()) { 2771 // Verify that the debug info still exists. 2772 if (llvm::Metadata *V = It->second) 2773 return cast<llvm::DIType>(V); 2774 } 2775 2776 return nullptr; 2777 } 2778 2779 void CGDebugInfo::completeTemplateDefinition( 2780 const ClassTemplateSpecializationDecl &SD) { 2781 if (DebugKind <= codegenoptions::DebugLineTablesOnly) 2782 return; 2783 completeUnusedClass(SD); 2784 } 2785 2786 void CGDebugInfo::completeUnusedClass(const CXXRecordDecl &D) { 2787 if (DebugKind <= codegenoptions::DebugLineTablesOnly) 2788 return; 2789 2790 completeClassData(&D); 2791 // In case this type has no member function definitions being emitted, ensure 2792 // it is retained 2793 RetainedTypes.push_back(CGM.getContext().getRecordType(&D).getAsOpaquePtr()); 2794 } 2795 2796 llvm::DIType *CGDebugInfo::getOrCreateType(QualType Ty, llvm::DIFile *Unit) { 2797 if (Ty.isNull()) 2798 return nullptr; 2799 2800 // Unwrap the type as needed for debug information. 2801 Ty = UnwrapTypeForDebugInfo(Ty, CGM.getContext()); 2802 2803 if (auto *T = getTypeOrNull(Ty)) 2804 return T; 2805 2806 llvm::DIType *Res = CreateTypeNode(Ty, Unit); 2807 void *TyPtr = Ty.getAsOpaquePtr(); 2808 2809 // And update the type cache. 2810 TypeCache[TyPtr].reset(Res); 2811 2812 return Res; 2813 } 2814 2815 llvm::DIModule *CGDebugInfo::getParentModuleOrNull(const Decl *D) { 2816 // A forward declaration inside a module header does not belong to the module. 2817 if (isa<RecordDecl>(D) && !cast<RecordDecl>(D)->getDefinition()) 2818 return nullptr; 2819 if (DebugTypeExtRefs && D->isFromASTFile()) { 2820 // Record a reference to an imported clang module or precompiled header. 2821 auto *Reader = CGM.getContext().getExternalSource(); 2822 auto Idx = D->getOwningModuleID(); 2823 auto Info = Reader->getSourceDescriptor(Idx); 2824 if (Info) 2825 return getOrCreateModuleRef(*Info, /*SkeletonCU=*/true); 2826 } else if (ClangModuleMap) { 2827 // We are building a clang module or a precompiled header. 2828 // 2829 // TODO: When D is a CXXRecordDecl or a C++ Enum, the ODR applies 2830 // and it wouldn't be necessary to specify the parent scope 2831 // because the type is already unique by definition (it would look 2832 // like the output of -fno-standalone-debug). On the other hand, 2833 // the parent scope helps a consumer to quickly locate the object 2834 // file where the type's definition is located, so it might be 2835 // best to make this behavior a command line or debugger tuning 2836 // option. 2837 if (Module *M = D->getOwningModule()) { 2838 // This is a (sub-)module. 2839 auto Info = ExternalASTSource::ASTSourceDescriptor(*M); 2840 return getOrCreateModuleRef(Info, /*SkeletonCU=*/false); 2841 } else { 2842 // This the precompiled header being built. 2843 return getOrCreateModuleRef(PCHDescriptor, /*SkeletonCU=*/false); 2844 } 2845 } 2846 2847 return nullptr; 2848 } 2849 2850 llvm::DIType *CGDebugInfo::CreateTypeNode(QualType Ty, llvm::DIFile *Unit) { 2851 // Handle qualifiers, which recursively handles what they refer to. 2852 if (Ty.hasLocalQualifiers()) 2853 return CreateQualifiedType(Ty, Unit); 2854 2855 // Work out details of type. 2856 switch (Ty->getTypeClass()) { 2857 #define TYPE(Class, Base) 2858 #define ABSTRACT_TYPE(Class, Base) 2859 #define NON_CANONICAL_TYPE(Class, Base) 2860 #define DEPENDENT_TYPE(Class, Base) case Type::Class: 2861 #include "clang/AST/TypeNodes.def" 2862 llvm_unreachable("Dependent types cannot show up in debug information"); 2863 2864 case Type::ExtVector: 2865 case Type::Vector: 2866 return CreateType(cast<VectorType>(Ty), Unit); 2867 case Type::ObjCObjectPointer: 2868 return CreateType(cast<ObjCObjectPointerType>(Ty), Unit); 2869 case Type::ObjCObject: 2870 return CreateType(cast<ObjCObjectType>(Ty), Unit); 2871 case Type::ObjCTypeParam: 2872 return CreateType(cast<ObjCTypeParamType>(Ty), Unit); 2873 case Type::ObjCInterface: 2874 return CreateType(cast<ObjCInterfaceType>(Ty), Unit); 2875 case Type::Builtin: 2876 return CreateType(cast<BuiltinType>(Ty)); 2877 case Type::Complex: 2878 return CreateType(cast<ComplexType>(Ty)); 2879 case Type::Pointer: 2880 return CreateType(cast<PointerType>(Ty), Unit); 2881 case Type::BlockPointer: 2882 return CreateType(cast<BlockPointerType>(Ty), Unit); 2883 case Type::Typedef: 2884 return CreateType(cast<TypedefType>(Ty), Unit); 2885 case Type::Record: 2886 return CreateType(cast<RecordType>(Ty)); 2887 case Type::Enum: 2888 return CreateEnumType(cast<EnumType>(Ty)); 2889 case Type::FunctionProto: 2890 case Type::FunctionNoProto: 2891 return CreateType(cast<FunctionType>(Ty), Unit); 2892 case Type::ConstantArray: 2893 case Type::VariableArray: 2894 case Type::IncompleteArray: 2895 return CreateType(cast<ArrayType>(Ty), Unit); 2896 2897 case Type::LValueReference: 2898 return CreateType(cast<LValueReferenceType>(Ty), Unit); 2899 case Type::RValueReference: 2900 return CreateType(cast<RValueReferenceType>(Ty), Unit); 2901 2902 case Type::MemberPointer: 2903 return CreateType(cast<MemberPointerType>(Ty), Unit); 2904 2905 case Type::Atomic: 2906 return CreateType(cast<AtomicType>(Ty), Unit); 2907 2908 case Type::Pipe: 2909 return CreateType(cast<PipeType>(Ty), Unit); 2910 2911 case Type::TemplateSpecialization: 2912 return CreateType(cast<TemplateSpecializationType>(Ty), Unit); 2913 2914 case Type::Auto: 2915 case Type::Attributed: 2916 case Type::Adjusted: 2917 case Type::Decayed: 2918 case Type::DeducedTemplateSpecialization: 2919 case Type::Elaborated: 2920 case Type::Paren: 2921 case Type::SubstTemplateTypeParm: 2922 case Type::TypeOfExpr: 2923 case Type::TypeOf: 2924 case Type::Decltype: 2925 case Type::UnaryTransform: 2926 case Type::PackExpansion: 2927 break; 2928 } 2929 2930 llvm_unreachable("type should have been unwrapped!"); 2931 } 2932 2933 llvm::DICompositeType *CGDebugInfo::getOrCreateLimitedType(const RecordType *Ty, 2934 llvm::DIFile *Unit) { 2935 QualType QTy(Ty, 0); 2936 2937 auto *T = cast_or_null<llvm::DICompositeType>(getTypeOrNull(QTy)); 2938 2939 // We may have cached a forward decl when we could have created 2940 // a non-forward decl. Go ahead and create a non-forward decl 2941 // now. 2942 if (T && !T->isForwardDecl()) 2943 return T; 2944 2945 // Otherwise create the type. 2946 llvm::DICompositeType *Res = CreateLimitedType(Ty); 2947 2948 // Propagate members from the declaration to the definition 2949 // CreateType(const RecordType*) will overwrite this with the members in the 2950 // correct order if the full type is needed. 2951 DBuilder.replaceArrays(Res, T ? T->getElements() : llvm::DINodeArray()); 2952 2953 // And update the type cache. 2954 TypeCache[QTy.getAsOpaquePtr()].reset(Res); 2955 return Res; 2956 } 2957 2958 // TODO: Currently used for context chains when limiting debug info. 2959 llvm::DICompositeType *CGDebugInfo::CreateLimitedType(const RecordType *Ty) { 2960 RecordDecl *RD = Ty->getDecl(); 2961 2962 // Get overall information about the record type for the debug info. 2963 llvm::DIFile *DefUnit = getOrCreateFile(RD->getLocation()); 2964 unsigned Line = getLineNumber(RD->getLocation()); 2965 StringRef RDName = getClassName(RD); 2966 2967 llvm::DIScope *RDContext = getDeclContextDescriptor(RD); 2968 2969 // If we ended up creating the type during the context chain construction, 2970 // just return that. 2971 auto *T = cast_or_null<llvm::DICompositeType>( 2972 getTypeOrNull(CGM.getContext().getRecordType(RD))); 2973 if (T && (!T->isForwardDecl() || !RD->getDefinition())) 2974 return T; 2975 2976 // If this is just a forward or incomplete declaration, construct an 2977 // appropriately marked node and just return it. 2978 const RecordDecl *D = RD->getDefinition(); 2979 if (!D || !D->isCompleteDefinition()) 2980 return getOrCreateRecordFwdDecl(Ty, RDContext); 2981 2982 uint64_t Size = CGM.getContext().getTypeSize(Ty); 2983 auto Align = getDeclAlignIfRequired(D, CGM.getContext()); 2984 2985 SmallString<256> Identifier = getTypeIdentifier(Ty, CGM, TheCU); 2986 2987 // Explicitly record the calling convention for C++ records. 2988 auto Flags = llvm::DINode::FlagZero; 2989 if (auto CXXRD = dyn_cast<CXXRecordDecl>(RD)) { 2990 if (CGM.getCXXABI().getRecordArgABI(CXXRD) == CGCXXABI::RAA_Indirect) 2991 Flags |= llvm::DINode::FlagTypePassByReference; 2992 else 2993 Flags |= llvm::DINode::FlagTypePassByValue; 2994 2995 // Record if a C++ record is trivial type. 2996 if (CXXRD->isTrivial()) 2997 Flags |= llvm::DINode::FlagTrivial; 2998 } 2999 3000 llvm::DICompositeType *RealDecl = DBuilder.createReplaceableCompositeType( 3001 getTagForRecord(RD), RDName, RDContext, DefUnit, Line, 0, Size, Align, 3002 Flags, Identifier); 3003 3004 // Elements of composite types usually have back to the type, creating 3005 // uniquing cycles. Distinct nodes are more efficient. 3006 switch (RealDecl->getTag()) { 3007 default: 3008 llvm_unreachable("invalid composite type tag"); 3009 3010 case llvm::dwarf::DW_TAG_array_type: 3011 case llvm::dwarf::DW_TAG_enumeration_type: 3012 // Array elements and most enumeration elements don't have back references, 3013 // so they don't tend to be involved in uniquing cycles and there is some 3014 // chance of merging them when linking together two modules. Only make 3015 // them distinct if they are ODR-uniqued. 3016 if (Identifier.empty()) 3017 break; 3018 LLVM_FALLTHROUGH; 3019 3020 case llvm::dwarf::DW_TAG_structure_type: 3021 case llvm::dwarf::DW_TAG_union_type: 3022 case llvm::dwarf::DW_TAG_class_type: 3023 // Immediately resolve to a distinct node. 3024 RealDecl = 3025 llvm::MDNode::replaceWithDistinct(llvm::TempDICompositeType(RealDecl)); 3026 break; 3027 } 3028 3029 RegionMap[Ty->getDecl()].reset(RealDecl); 3030 TypeCache[QualType(Ty, 0).getAsOpaquePtr()].reset(RealDecl); 3031 3032 if (const auto *TSpecial = dyn_cast<ClassTemplateSpecializationDecl>(RD)) 3033 DBuilder.replaceArrays(RealDecl, llvm::DINodeArray(), 3034 CollectCXXTemplateParams(TSpecial, DefUnit)); 3035 return RealDecl; 3036 } 3037 3038 void CGDebugInfo::CollectContainingType(const CXXRecordDecl *RD, 3039 llvm::DICompositeType *RealDecl) { 3040 // A class's primary base or the class itself contains the vtable. 3041 llvm::DICompositeType *ContainingType = nullptr; 3042 const ASTRecordLayout &RL = CGM.getContext().getASTRecordLayout(RD); 3043 if (const CXXRecordDecl *PBase = RL.getPrimaryBase()) { 3044 // Seek non-virtual primary base root. 3045 while (1) { 3046 const ASTRecordLayout &BRL = CGM.getContext().getASTRecordLayout(PBase); 3047 const CXXRecordDecl *PBT = BRL.getPrimaryBase(); 3048 if (PBT && !BRL.isPrimaryBaseVirtual()) 3049 PBase = PBT; 3050 else 3051 break; 3052 } 3053 ContainingType = cast<llvm::DICompositeType>( 3054 getOrCreateType(QualType(PBase->getTypeForDecl(), 0), 3055 getOrCreateFile(RD->getLocation()))); 3056 } else if (RD->isDynamicClass()) 3057 ContainingType = RealDecl; 3058 3059 DBuilder.replaceVTableHolder(RealDecl, ContainingType); 3060 } 3061 3062 llvm::DIType *CGDebugInfo::CreateMemberType(llvm::DIFile *Unit, QualType FType, 3063 StringRef Name, uint64_t *Offset) { 3064 llvm::DIType *FieldTy = CGDebugInfo::getOrCreateType(FType, Unit); 3065 uint64_t FieldSize = CGM.getContext().getTypeSize(FType); 3066 auto FieldAlign = getTypeAlignIfRequired(FType, CGM.getContext()); 3067 llvm::DIType *Ty = 3068 DBuilder.createMemberType(Unit, Name, Unit, 0, FieldSize, FieldAlign, 3069 *Offset, llvm::DINode::FlagZero, FieldTy); 3070 *Offset += FieldSize; 3071 return Ty; 3072 } 3073 3074 void CGDebugInfo::collectFunctionDeclProps(GlobalDecl GD, llvm::DIFile *Unit, 3075 StringRef &Name, 3076 StringRef &LinkageName, 3077 llvm::DIScope *&FDContext, 3078 llvm::DINodeArray &TParamsArray, 3079 llvm::DINode::DIFlags &Flags) { 3080 const auto *FD = cast<FunctionDecl>(GD.getDecl()); 3081 Name = getFunctionName(FD); 3082 // Use mangled name as linkage name for C/C++ functions. 3083 if (FD->hasPrototype()) { 3084 LinkageName = CGM.getMangledName(GD); 3085 Flags |= llvm::DINode::FlagPrototyped; 3086 } 3087 // No need to replicate the linkage name if it isn't different from the 3088 // subprogram name, no need to have it at all unless coverage is enabled or 3089 // debug is set to more than just line tables or extra debug info is needed. 3090 if (LinkageName == Name || (!CGM.getCodeGenOpts().EmitGcovArcs && 3091 !CGM.getCodeGenOpts().EmitGcovNotes && 3092 !CGM.getCodeGenOpts().DebugInfoForProfiling && 3093 DebugKind <= codegenoptions::DebugLineTablesOnly)) 3094 LinkageName = StringRef(); 3095 3096 if (DebugKind >= codegenoptions::LimitedDebugInfo) { 3097 if (const NamespaceDecl *NSDecl = 3098 dyn_cast_or_null<NamespaceDecl>(FD->getDeclContext())) 3099 FDContext = getOrCreateNamespace(NSDecl); 3100 else if (const RecordDecl *RDecl = 3101 dyn_cast_or_null<RecordDecl>(FD->getDeclContext())) { 3102 llvm::DIScope *Mod = getParentModuleOrNull(RDecl); 3103 FDContext = getContextDescriptor(RDecl, Mod ? Mod : TheCU); 3104 } 3105 // Check if it is a noreturn-marked function 3106 if (FD->isNoReturn()) 3107 Flags |= llvm::DINode::FlagNoReturn; 3108 // Collect template parameters. 3109 TParamsArray = CollectFunctionTemplateParams(FD, Unit); 3110 } 3111 } 3112 3113 void CGDebugInfo::collectVarDeclProps(const VarDecl *VD, llvm::DIFile *&Unit, 3114 unsigned &LineNo, QualType &T, 3115 StringRef &Name, StringRef &LinkageName, 3116 llvm::MDTuple *&TemplateParameters, 3117 llvm::DIScope *&VDContext) { 3118 Unit = getOrCreateFile(VD->getLocation()); 3119 LineNo = getLineNumber(VD->getLocation()); 3120 3121 setLocation(VD->getLocation()); 3122 3123 T = VD->getType(); 3124 if (T->isIncompleteArrayType()) { 3125 // CodeGen turns int[] into int[1] so we'll do the same here. 3126 llvm::APInt ConstVal(32, 1); 3127 QualType ET = CGM.getContext().getAsArrayType(T)->getElementType(); 3128 3129 T = CGM.getContext().getConstantArrayType(ET, ConstVal, ArrayType::Normal, 3130 0); 3131 } 3132 3133 Name = VD->getName(); 3134 if (VD->getDeclContext() && !isa<FunctionDecl>(VD->getDeclContext()) && 3135 !isa<ObjCMethodDecl>(VD->getDeclContext())) 3136 LinkageName = CGM.getMangledName(VD); 3137 if (LinkageName == Name) 3138 LinkageName = StringRef(); 3139 3140 if (isa<VarTemplateSpecializationDecl>(VD)) { 3141 llvm::DINodeArray parameterNodes = CollectVarTemplateParams(VD, &*Unit); 3142 TemplateParameters = parameterNodes.get(); 3143 } else { 3144 TemplateParameters = nullptr; 3145 } 3146 3147 // Since we emit declarations (DW_AT_members) for static members, place the 3148 // definition of those static members in the namespace they were declared in 3149 // in the source code (the lexical decl context). 3150 // FIXME: Generalize this for even non-member global variables where the 3151 // declaration and definition may have different lexical decl contexts, once 3152 // we have support for emitting declarations of (non-member) global variables. 3153 const DeclContext *DC = VD->isStaticDataMember() ? VD->getLexicalDeclContext() 3154 : VD->getDeclContext(); 3155 // When a record type contains an in-line initialization of a static data 3156 // member, and the record type is marked as __declspec(dllexport), an implicit 3157 // definition of the member will be created in the record context. DWARF 3158 // doesn't seem to have a nice way to describe this in a form that consumers 3159 // are likely to understand, so fake the "normal" situation of a definition 3160 // outside the class by putting it in the global scope. 3161 if (DC->isRecord()) 3162 DC = CGM.getContext().getTranslationUnitDecl(); 3163 3164 llvm::DIScope *Mod = getParentModuleOrNull(VD); 3165 VDContext = getContextDescriptor(cast<Decl>(DC), Mod ? Mod : TheCU); 3166 } 3167 3168 llvm::DISubprogram *CGDebugInfo::getFunctionFwdDeclOrStub(GlobalDecl GD, 3169 bool Stub) { 3170 llvm::DINodeArray TParamsArray; 3171 StringRef Name, LinkageName; 3172 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 3173 llvm::DISubprogram::DISPFlags SPFlags = llvm::DISubprogram::SPFlagZero; 3174 SourceLocation Loc = GD.getDecl()->getLocation(); 3175 llvm::DIFile *Unit = getOrCreateFile(Loc); 3176 llvm::DIScope *DContext = Unit; 3177 unsigned Line = getLineNumber(Loc); 3178 collectFunctionDeclProps(GD, Unit, Name, LinkageName, DContext, TParamsArray, 3179 Flags); 3180 auto *FD = dyn_cast<FunctionDecl>(GD.getDecl()); 3181 3182 // Build function type. 3183 SmallVector<QualType, 16> ArgTypes; 3184 if (FD) 3185 for (const ParmVarDecl *Parm : FD->parameters()) 3186 ArgTypes.push_back(Parm->getType()); 3187 CallingConv CC = FD->getType()->castAs<FunctionType>()->getCallConv(); 3188 QualType FnType = CGM.getContext().getFunctionType( 3189 FD->getReturnType(), ArgTypes, FunctionProtoType::ExtProtoInfo(CC)); 3190 if (!FD->isExternallyVisible()) 3191 SPFlags |= llvm::DISubprogram::SPFlagLocalToUnit; 3192 if (CGM.getLangOpts().Optimize) 3193 SPFlags |= llvm::DISubprogram::SPFlagOptimized; 3194 3195 if (Stub) { 3196 Flags |= getCallSiteRelatedAttrs(); 3197 SPFlags |= llvm::DISubprogram::SPFlagDefinition; 3198 return DBuilder.createFunction( 3199 DContext, Name, LinkageName, Unit, Line, 3200 getOrCreateFunctionType(GD.getDecl(), FnType, Unit), 0, Flags, SPFlags, 3201 TParamsArray.get(), getFunctionDeclaration(FD)); 3202 } 3203 3204 llvm::DISubprogram *SP = DBuilder.createTempFunctionFwdDecl( 3205 DContext, Name, LinkageName, Unit, Line, 3206 getOrCreateFunctionType(GD.getDecl(), FnType, Unit), 0, Flags, SPFlags, 3207 TParamsArray.get(), getFunctionDeclaration(FD)); 3208 const FunctionDecl *CanonDecl = FD->getCanonicalDecl(); 3209 FwdDeclReplaceMap.emplace_back(std::piecewise_construct, 3210 std::make_tuple(CanonDecl), 3211 std::make_tuple(SP)); 3212 return SP; 3213 } 3214 3215 llvm::DISubprogram *CGDebugInfo::getFunctionForwardDeclaration(GlobalDecl GD) { 3216 return getFunctionFwdDeclOrStub(GD, /* Stub = */ false); 3217 } 3218 3219 llvm::DISubprogram *CGDebugInfo::getFunctionStub(GlobalDecl GD) { 3220 return getFunctionFwdDeclOrStub(GD, /* Stub = */ true); 3221 } 3222 3223 llvm::DIGlobalVariable * 3224 CGDebugInfo::getGlobalVariableForwardDeclaration(const VarDecl *VD) { 3225 QualType T; 3226 StringRef Name, LinkageName; 3227 SourceLocation Loc = VD->getLocation(); 3228 llvm::DIFile *Unit = getOrCreateFile(Loc); 3229 llvm::DIScope *DContext = Unit; 3230 unsigned Line = getLineNumber(Loc); 3231 llvm::MDTuple *TemplateParameters = nullptr; 3232 3233 collectVarDeclProps(VD, Unit, Line, T, Name, LinkageName, TemplateParameters, 3234 DContext); 3235 auto Align = getDeclAlignIfRequired(VD, CGM.getContext()); 3236 auto *GV = DBuilder.createTempGlobalVariableFwdDecl( 3237 DContext, Name, LinkageName, Unit, Line, getOrCreateType(T, Unit), 3238 !VD->isExternallyVisible(), nullptr, TemplateParameters, Align); 3239 FwdDeclReplaceMap.emplace_back( 3240 std::piecewise_construct, 3241 std::make_tuple(cast<VarDecl>(VD->getCanonicalDecl())), 3242 std::make_tuple(static_cast<llvm::Metadata *>(GV))); 3243 return GV; 3244 } 3245 3246 llvm::DINode *CGDebugInfo::getDeclarationOrDefinition(const Decl *D) { 3247 // We only need a declaration (not a definition) of the type - so use whatever 3248 // we would otherwise do to get a type for a pointee. (forward declarations in 3249 // limited debug info, full definitions (if the type definition is available) 3250 // in unlimited debug info) 3251 if (const auto *TD = dyn_cast<TypeDecl>(D)) 3252 return getOrCreateType(CGM.getContext().getTypeDeclType(TD), 3253 getOrCreateFile(TD->getLocation())); 3254 auto I = DeclCache.find(D->getCanonicalDecl()); 3255 3256 if (I != DeclCache.end()) { 3257 auto N = I->second; 3258 if (auto *GVE = dyn_cast_or_null<llvm::DIGlobalVariableExpression>(N)) 3259 return GVE->getVariable(); 3260 return dyn_cast_or_null<llvm::DINode>(N); 3261 } 3262 3263 // No definition for now. Emit a forward definition that might be 3264 // merged with a potential upcoming definition. 3265 if (const auto *FD = dyn_cast<FunctionDecl>(D)) 3266 return getFunctionForwardDeclaration(FD); 3267 else if (const auto *VD = dyn_cast<VarDecl>(D)) 3268 return getGlobalVariableForwardDeclaration(VD); 3269 3270 return nullptr; 3271 } 3272 3273 llvm::DISubprogram *CGDebugInfo::getFunctionDeclaration(const Decl *D) { 3274 if (!D || DebugKind <= codegenoptions::DebugLineTablesOnly) 3275 return nullptr; 3276 3277 const auto *FD = dyn_cast<FunctionDecl>(D); 3278 if (!FD) 3279 return nullptr; 3280 3281 // Setup context. 3282 auto *S = getDeclContextDescriptor(D); 3283 3284 auto MI = SPCache.find(FD->getCanonicalDecl()); 3285 if (MI == SPCache.end()) { 3286 if (const auto *MD = dyn_cast<CXXMethodDecl>(FD->getCanonicalDecl())) { 3287 return CreateCXXMemberFunction(MD, getOrCreateFile(MD->getLocation()), 3288 cast<llvm::DICompositeType>(S)); 3289 } 3290 } 3291 if (MI != SPCache.end()) { 3292 auto *SP = dyn_cast_or_null<llvm::DISubprogram>(MI->second); 3293 if (SP && !SP->isDefinition()) 3294 return SP; 3295 } 3296 3297 for (auto NextFD : FD->redecls()) { 3298 auto MI = SPCache.find(NextFD->getCanonicalDecl()); 3299 if (MI != SPCache.end()) { 3300 auto *SP = dyn_cast_or_null<llvm::DISubprogram>(MI->second); 3301 if (SP && !SP->isDefinition()) 3302 return SP; 3303 } 3304 } 3305 return nullptr; 3306 } 3307 3308 // getOrCreateFunctionType - Construct type. If it is a c++ method, include 3309 // implicit parameter "this". 3310 llvm::DISubroutineType *CGDebugInfo::getOrCreateFunctionType(const Decl *D, 3311 QualType FnType, 3312 llvm::DIFile *F) { 3313 if (!D || DebugKind <= codegenoptions::DebugLineTablesOnly) 3314 // Create fake but valid subroutine type. Otherwise -verify would fail, and 3315 // subprogram DIE will miss DW_AT_decl_file and DW_AT_decl_line fields. 3316 return DBuilder.createSubroutineType(DBuilder.getOrCreateTypeArray(None)); 3317 3318 if (const auto *Method = dyn_cast<CXXMethodDecl>(D)) 3319 return getOrCreateMethodType(Method, F); 3320 3321 const auto *FTy = FnType->getAs<FunctionType>(); 3322 CallingConv CC = FTy ? FTy->getCallConv() : CallingConv::CC_C; 3323 3324 if (const auto *OMethod = dyn_cast<ObjCMethodDecl>(D)) { 3325 // Add "self" and "_cmd" 3326 SmallVector<llvm::Metadata *, 16> Elts; 3327 3328 // First element is always return type. For 'void' functions it is NULL. 3329 QualType ResultTy = OMethod->getReturnType(); 3330 3331 // Replace the instancetype keyword with the actual type. 3332 if (ResultTy == CGM.getContext().getObjCInstanceType()) 3333 ResultTy = CGM.getContext().getPointerType( 3334 QualType(OMethod->getClassInterface()->getTypeForDecl(), 0)); 3335 3336 Elts.push_back(getOrCreateType(ResultTy, F)); 3337 // "self" pointer is always first argument. 3338 QualType SelfDeclTy; 3339 if (auto *SelfDecl = OMethod->getSelfDecl()) 3340 SelfDeclTy = SelfDecl->getType(); 3341 else if (auto *FPT = dyn_cast<FunctionProtoType>(FnType)) 3342 if (FPT->getNumParams() > 1) 3343 SelfDeclTy = FPT->getParamType(0); 3344 if (!SelfDeclTy.isNull()) 3345 Elts.push_back( 3346 CreateSelfType(SelfDeclTy, getOrCreateType(SelfDeclTy, F))); 3347 // "_cmd" pointer is always second argument. 3348 Elts.push_back(DBuilder.createArtificialType( 3349 getOrCreateType(CGM.getContext().getObjCSelType(), F))); 3350 // Get rest of the arguments. 3351 for (const auto *PI : OMethod->parameters()) 3352 Elts.push_back(getOrCreateType(PI->getType(), F)); 3353 // Variadic methods need a special marker at the end of the type list. 3354 if (OMethod->isVariadic()) 3355 Elts.push_back(DBuilder.createUnspecifiedParameter()); 3356 3357 llvm::DITypeRefArray EltTypeArray = DBuilder.getOrCreateTypeArray(Elts); 3358 return DBuilder.createSubroutineType(EltTypeArray, llvm::DINode::FlagZero, 3359 getDwarfCC(CC)); 3360 } 3361 3362 // Handle variadic function types; they need an additional 3363 // unspecified parameter. 3364 if (const auto *FD = dyn_cast<FunctionDecl>(D)) 3365 if (FD->isVariadic()) { 3366 SmallVector<llvm::Metadata *, 16> EltTys; 3367 EltTys.push_back(getOrCreateType(FD->getReturnType(), F)); 3368 if (const auto *FPT = dyn_cast<FunctionProtoType>(FnType)) 3369 for (QualType ParamType : FPT->param_types()) 3370 EltTys.push_back(getOrCreateType(ParamType, F)); 3371 EltTys.push_back(DBuilder.createUnspecifiedParameter()); 3372 llvm::DITypeRefArray EltTypeArray = DBuilder.getOrCreateTypeArray(EltTys); 3373 return DBuilder.createSubroutineType(EltTypeArray, llvm::DINode::FlagZero, 3374 getDwarfCC(CC)); 3375 } 3376 3377 return cast<llvm::DISubroutineType>(getOrCreateType(FnType, F)); 3378 } 3379 3380 void CGDebugInfo::EmitFunctionStart(GlobalDecl GD, SourceLocation Loc, 3381 SourceLocation ScopeLoc, QualType FnType, 3382 llvm::Function *Fn, bool CurFuncIsThunk, 3383 CGBuilderTy &Builder) { 3384 3385 StringRef Name; 3386 StringRef LinkageName; 3387 3388 FnBeginRegionCount.push_back(LexicalBlockStack.size()); 3389 3390 const Decl *D = GD.getDecl(); 3391 bool HasDecl = (D != nullptr); 3392 3393 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 3394 llvm::DISubprogram::DISPFlags SPFlags = llvm::DISubprogram::SPFlagZero; 3395 llvm::DIFile *Unit = getOrCreateFile(Loc); 3396 llvm::DIScope *FDContext = Unit; 3397 llvm::DINodeArray TParamsArray; 3398 if (!HasDecl) { 3399 // Use llvm function name. 3400 LinkageName = Fn->getName(); 3401 } else if (const auto *FD = dyn_cast<FunctionDecl>(D)) { 3402 // If there is a subprogram for this function available then use it. 3403 auto FI = SPCache.find(FD->getCanonicalDecl()); 3404 if (FI != SPCache.end()) { 3405 auto *SP = dyn_cast_or_null<llvm::DISubprogram>(FI->second); 3406 if (SP && SP->isDefinition()) { 3407 LexicalBlockStack.emplace_back(SP); 3408 RegionMap[D].reset(SP); 3409 return; 3410 } 3411 } 3412 collectFunctionDeclProps(GD, Unit, Name, LinkageName, FDContext, 3413 TParamsArray, Flags); 3414 } else if (const auto *OMD = dyn_cast<ObjCMethodDecl>(D)) { 3415 Name = getObjCMethodName(OMD); 3416 Flags |= llvm::DINode::FlagPrototyped; 3417 } else { 3418 // Use llvm function name. 3419 Name = Fn->getName(); 3420 Flags |= llvm::DINode::FlagPrototyped; 3421 } 3422 if (Name.startswith("\01")) 3423 Name = Name.substr(1); 3424 3425 if (!HasDecl || D->isImplicit() || D->hasAttr<ArtificialAttr>()) { 3426 Flags |= llvm::DINode::FlagArtificial; 3427 // Artificial functions should not silently reuse CurLoc. 3428 CurLoc = SourceLocation(); 3429 } 3430 3431 if (CurFuncIsThunk) 3432 Flags |= llvm::DINode::FlagThunk; 3433 3434 if (Fn->hasLocalLinkage()) 3435 SPFlags |= llvm::DISubprogram::SPFlagLocalToUnit; 3436 if (CGM.getLangOpts().Optimize) 3437 SPFlags |= llvm::DISubprogram::SPFlagOptimized; 3438 3439 llvm::DINode::DIFlags FlagsForDef = Flags | getCallSiteRelatedAttrs(); 3440 llvm::DISubprogram::DISPFlags SPFlagsForDef = 3441 SPFlags | llvm::DISubprogram::SPFlagDefinition; 3442 3443 unsigned LineNo = getLineNumber(Loc); 3444 unsigned ScopeLine = getLineNumber(ScopeLoc); 3445 3446 // FIXME: The function declaration we're constructing here is mostly reusing 3447 // declarations from CXXMethodDecl and not constructing new ones for arbitrary 3448 // FunctionDecls. When/if we fix this we can have FDContext be TheCU/null for 3449 // all subprograms instead of the actual context since subprogram definitions 3450 // are emitted as CU level entities by the backend. 3451 llvm::DISubprogram *SP = DBuilder.createFunction( 3452 FDContext, Name, LinkageName, Unit, LineNo, 3453 getOrCreateFunctionType(D, FnType, Unit), ScopeLine, FlagsForDef, 3454 SPFlagsForDef, TParamsArray.get(), getFunctionDeclaration(D)); 3455 Fn->setSubprogram(SP); 3456 // We might get here with a VarDecl in the case we're generating 3457 // code for the initialization of globals. Do not record these decls 3458 // as they will overwrite the actual VarDecl Decl in the cache. 3459 if (HasDecl && isa<FunctionDecl>(D)) 3460 DeclCache[D->getCanonicalDecl()].reset(SP); 3461 3462 if (CGM.getCodeGenOpts().DwarfVersion >= 5) { 3463 // Starting with DWARF V5 method declarations are emitted as children of 3464 // the interface type. 3465 if (const auto *OMD = dyn_cast_or_null<ObjCMethodDecl>(D)) { 3466 const ObjCInterfaceDecl *ID = OMD->getClassInterface(); 3467 QualType QTy(ID->getTypeForDecl(), 0); 3468 auto It = TypeCache.find(QTy.getAsOpaquePtr()); 3469 if (It != TypeCache.end()) { 3470 llvm::DICompositeType *InterfaceDecl = 3471 cast<llvm::DICompositeType>(It->second); 3472 llvm::DISubprogram *FD = DBuilder.createFunction( 3473 InterfaceDecl, Name, LinkageName, Unit, LineNo, 3474 getOrCreateFunctionType(D, FnType, Unit), ScopeLine, Flags, SPFlags, 3475 TParamsArray.get()); 3476 DBuilder.finalizeSubprogram(FD); 3477 ObjCMethodCache[ID].push_back(FD); 3478 } 3479 } 3480 } 3481 3482 // Push the function onto the lexical block stack. 3483 LexicalBlockStack.emplace_back(SP); 3484 3485 if (HasDecl) 3486 RegionMap[D].reset(SP); 3487 } 3488 3489 void CGDebugInfo::EmitFunctionDecl(GlobalDecl GD, SourceLocation Loc, 3490 QualType FnType) { 3491 StringRef Name; 3492 StringRef LinkageName; 3493 3494 const Decl *D = GD.getDecl(); 3495 if (!D) 3496 return; 3497 3498 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 3499 llvm::DIFile *Unit = getOrCreateFile(Loc); 3500 llvm::DIScope *FDContext = getDeclContextDescriptor(D); 3501 llvm::DINodeArray TParamsArray; 3502 if (isa<FunctionDecl>(D)) { 3503 // If there is a DISubprogram for this function available then use it. 3504 collectFunctionDeclProps(GD, Unit, Name, LinkageName, FDContext, 3505 TParamsArray, Flags); 3506 } else if (const auto *OMD = dyn_cast<ObjCMethodDecl>(D)) { 3507 Name = getObjCMethodName(OMD); 3508 Flags |= llvm::DINode::FlagPrototyped; 3509 } else { 3510 llvm_unreachable("not a function or ObjC method"); 3511 } 3512 if (!Name.empty() && Name[0] == '\01') 3513 Name = Name.substr(1); 3514 3515 if (D->isImplicit()) { 3516 Flags |= llvm::DINode::FlagArtificial; 3517 // Artificial functions without a location should not silently reuse CurLoc. 3518 if (Loc.isInvalid()) 3519 CurLoc = SourceLocation(); 3520 } 3521 unsigned LineNo = getLineNumber(Loc); 3522 unsigned ScopeLine = 0; 3523 llvm::DISubprogram::DISPFlags SPFlags = llvm::DISubprogram::SPFlagZero; 3524 if (CGM.getLangOpts().Optimize) 3525 SPFlags |= llvm::DISubprogram::SPFlagOptimized; 3526 3527 DBuilder.retainType(DBuilder.createFunction( 3528 FDContext, Name, LinkageName, Unit, LineNo, 3529 getOrCreateFunctionType(D, FnType, Unit), ScopeLine, Flags, SPFlags, 3530 TParamsArray.get(), getFunctionDeclaration(D))); 3531 } 3532 3533 void CGDebugInfo::EmitInlineFunctionStart(CGBuilderTy &Builder, GlobalDecl GD) { 3534 const auto *FD = cast<FunctionDecl>(GD.getDecl()); 3535 // If there is a subprogram for this function available then use it. 3536 auto FI = SPCache.find(FD->getCanonicalDecl()); 3537 llvm::DISubprogram *SP = nullptr; 3538 if (FI != SPCache.end()) 3539 SP = dyn_cast_or_null<llvm::DISubprogram>(FI->second); 3540 if (!SP || !SP->isDefinition()) 3541 SP = getFunctionStub(GD); 3542 FnBeginRegionCount.push_back(LexicalBlockStack.size()); 3543 LexicalBlockStack.emplace_back(SP); 3544 setInlinedAt(Builder.getCurrentDebugLocation()); 3545 EmitLocation(Builder, FD->getLocation()); 3546 } 3547 3548 void CGDebugInfo::EmitInlineFunctionEnd(CGBuilderTy &Builder) { 3549 assert(CurInlinedAt && "unbalanced inline scope stack"); 3550 EmitFunctionEnd(Builder, nullptr); 3551 setInlinedAt(llvm::DebugLoc(CurInlinedAt).getInlinedAt()); 3552 } 3553 3554 void CGDebugInfo::EmitLocation(CGBuilderTy &Builder, SourceLocation Loc) { 3555 // Update our current location 3556 setLocation(Loc); 3557 3558 if (CurLoc.isInvalid() || CurLoc.isMacroID() || LexicalBlockStack.empty()) 3559 return; 3560 3561 llvm::MDNode *Scope = LexicalBlockStack.back(); 3562 Builder.SetCurrentDebugLocation(llvm::DebugLoc::get( 3563 getLineNumber(CurLoc), getColumnNumber(CurLoc), Scope, CurInlinedAt)); 3564 } 3565 3566 void CGDebugInfo::CreateLexicalBlock(SourceLocation Loc) { 3567 llvm::MDNode *Back = nullptr; 3568 if (!LexicalBlockStack.empty()) 3569 Back = LexicalBlockStack.back().get(); 3570 LexicalBlockStack.emplace_back(DBuilder.createLexicalBlock( 3571 cast<llvm::DIScope>(Back), getOrCreateFile(CurLoc), getLineNumber(CurLoc), 3572 getColumnNumber(CurLoc))); 3573 } 3574 3575 void CGDebugInfo::AppendAddressSpaceXDeref( 3576 unsigned AddressSpace, SmallVectorImpl<int64_t> &Expr) const { 3577 Optional<unsigned> DWARFAddressSpace = 3578 CGM.getTarget().getDWARFAddressSpace(AddressSpace); 3579 if (!DWARFAddressSpace) 3580 return; 3581 3582 Expr.push_back(llvm::dwarf::DW_OP_constu); 3583 Expr.push_back(DWARFAddressSpace.getValue()); 3584 Expr.push_back(llvm::dwarf::DW_OP_swap); 3585 Expr.push_back(llvm::dwarf::DW_OP_xderef); 3586 } 3587 3588 void CGDebugInfo::EmitLexicalBlockStart(CGBuilderTy &Builder, 3589 SourceLocation Loc) { 3590 // Set our current location. 3591 setLocation(Loc); 3592 3593 // Emit a line table change for the current location inside the new scope. 3594 Builder.SetCurrentDebugLocation( 3595 llvm::DebugLoc::get(getLineNumber(Loc), getColumnNumber(Loc), 3596 LexicalBlockStack.back(), CurInlinedAt)); 3597 3598 if (DebugKind <= codegenoptions::DebugLineTablesOnly) 3599 return; 3600 3601 // Create a new lexical block and push it on the stack. 3602 CreateLexicalBlock(Loc); 3603 } 3604 3605 void CGDebugInfo::EmitLexicalBlockEnd(CGBuilderTy &Builder, 3606 SourceLocation Loc) { 3607 assert(!LexicalBlockStack.empty() && "Region stack mismatch, stack empty!"); 3608 3609 // Provide an entry in the line table for the end of the block. 3610 EmitLocation(Builder, Loc); 3611 3612 if (DebugKind <= codegenoptions::DebugLineTablesOnly) 3613 return; 3614 3615 LexicalBlockStack.pop_back(); 3616 } 3617 3618 void CGDebugInfo::EmitFunctionEnd(CGBuilderTy &Builder, llvm::Function *Fn) { 3619 assert(!LexicalBlockStack.empty() && "Region stack mismatch, stack empty!"); 3620 unsigned RCount = FnBeginRegionCount.back(); 3621 assert(RCount <= LexicalBlockStack.size() && "Region stack mismatch"); 3622 3623 // Pop all regions for this function. 3624 while (LexicalBlockStack.size() != RCount) { 3625 // Provide an entry in the line table for the end of the block. 3626 EmitLocation(Builder, CurLoc); 3627 LexicalBlockStack.pop_back(); 3628 } 3629 FnBeginRegionCount.pop_back(); 3630 3631 if (Fn && Fn->getSubprogram()) 3632 DBuilder.finalizeSubprogram(Fn->getSubprogram()); 3633 } 3634 3635 CGDebugInfo::BlockByRefType 3636 CGDebugInfo::EmitTypeForVarWithBlocksAttr(const VarDecl *VD, 3637 uint64_t *XOffset) { 3638 SmallVector<llvm::Metadata *, 5> EltTys; 3639 QualType FType; 3640 uint64_t FieldSize, FieldOffset; 3641 uint32_t FieldAlign; 3642 3643 llvm::DIFile *Unit = getOrCreateFile(VD->getLocation()); 3644 QualType Type = VD->getType(); 3645 3646 FieldOffset = 0; 3647 FType = CGM.getContext().getPointerType(CGM.getContext().VoidTy); 3648 EltTys.push_back(CreateMemberType(Unit, FType, "__isa", &FieldOffset)); 3649 EltTys.push_back(CreateMemberType(Unit, FType, "__forwarding", &FieldOffset)); 3650 FType = CGM.getContext().IntTy; 3651 EltTys.push_back(CreateMemberType(Unit, FType, "__flags", &FieldOffset)); 3652 EltTys.push_back(CreateMemberType(Unit, FType, "__size", &FieldOffset)); 3653 3654 bool HasCopyAndDispose = CGM.getContext().BlockRequiresCopying(Type, VD); 3655 if (HasCopyAndDispose) { 3656 FType = CGM.getContext().getPointerType(CGM.getContext().VoidTy); 3657 EltTys.push_back( 3658 CreateMemberType(Unit, FType, "__copy_helper", &FieldOffset)); 3659 EltTys.push_back( 3660 CreateMemberType(Unit, FType, "__destroy_helper", &FieldOffset)); 3661 } 3662 bool HasByrefExtendedLayout; 3663 Qualifiers::ObjCLifetime Lifetime; 3664 if (CGM.getContext().getByrefLifetime(Type, Lifetime, 3665 HasByrefExtendedLayout) && 3666 HasByrefExtendedLayout) { 3667 FType = CGM.getContext().getPointerType(CGM.getContext().VoidTy); 3668 EltTys.push_back( 3669 CreateMemberType(Unit, FType, "__byref_variable_layout", &FieldOffset)); 3670 } 3671 3672 CharUnits Align = CGM.getContext().getDeclAlign(VD); 3673 if (Align > CGM.getContext().toCharUnitsFromBits( 3674 CGM.getTarget().getPointerAlign(0))) { 3675 CharUnits FieldOffsetInBytes = 3676 CGM.getContext().toCharUnitsFromBits(FieldOffset); 3677 CharUnits AlignedOffsetInBytes = FieldOffsetInBytes.alignTo(Align); 3678 CharUnits NumPaddingBytes = AlignedOffsetInBytes - FieldOffsetInBytes; 3679 3680 if (NumPaddingBytes.isPositive()) { 3681 llvm::APInt pad(32, NumPaddingBytes.getQuantity()); 3682 FType = CGM.getContext().getConstantArrayType(CGM.getContext().CharTy, 3683 pad, ArrayType::Normal, 0); 3684 EltTys.push_back(CreateMemberType(Unit, FType, "", &FieldOffset)); 3685 } 3686 } 3687 3688 FType = Type; 3689 llvm::DIType *WrappedTy = getOrCreateType(FType, Unit); 3690 FieldSize = CGM.getContext().getTypeSize(FType); 3691 FieldAlign = CGM.getContext().toBits(Align); 3692 3693 *XOffset = FieldOffset; 3694 llvm::DIType *FieldTy = DBuilder.createMemberType( 3695 Unit, VD->getName(), Unit, 0, FieldSize, FieldAlign, FieldOffset, 3696 llvm::DINode::FlagZero, WrappedTy); 3697 EltTys.push_back(FieldTy); 3698 FieldOffset += FieldSize; 3699 3700 llvm::DINodeArray Elements = DBuilder.getOrCreateArray(EltTys); 3701 return {DBuilder.createStructType(Unit, "", Unit, 0, FieldOffset, 0, 3702 llvm::DINode::FlagZero, nullptr, Elements), 3703 WrappedTy}; 3704 } 3705 3706 llvm::DILocalVariable *CGDebugInfo::EmitDeclare(const VarDecl *VD, 3707 llvm::Value *Storage, 3708 llvm::Optional<unsigned> ArgNo, 3709 CGBuilderTy &Builder) { 3710 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 3711 assert(!LexicalBlockStack.empty() && "Region stack mismatch, stack empty!"); 3712 if (VD->hasAttr<NoDebugAttr>()) 3713 return nullptr; 3714 3715 bool Unwritten = 3716 VD->isImplicit() || (isa<Decl>(VD->getDeclContext()) && 3717 cast<Decl>(VD->getDeclContext())->isImplicit()); 3718 llvm::DIFile *Unit = nullptr; 3719 if (!Unwritten) 3720 Unit = getOrCreateFile(VD->getLocation()); 3721 llvm::DIType *Ty; 3722 uint64_t XOffset = 0; 3723 if (VD->hasAttr<BlocksAttr>()) 3724 Ty = EmitTypeForVarWithBlocksAttr(VD, &XOffset).WrappedType; 3725 else 3726 Ty = getOrCreateType(VD->getType(), Unit); 3727 3728 // If there is no debug info for this type then do not emit debug info 3729 // for this variable. 3730 if (!Ty) 3731 return nullptr; 3732 3733 // Get location information. 3734 unsigned Line = 0; 3735 unsigned Column = 0; 3736 if (!Unwritten) { 3737 Line = getLineNumber(VD->getLocation()); 3738 Column = getColumnNumber(VD->getLocation()); 3739 } 3740 SmallVector<int64_t, 13> Expr; 3741 llvm::DINode::DIFlags Flags = llvm::DINode::FlagZero; 3742 if (VD->isImplicit()) 3743 Flags |= llvm::DINode::FlagArtificial; 3744 3745 auto Align = getDeclAlignIfRequired(VD, CGM.getContext()); 3746 3747 unsigned AddressSpace = CGM.getContext().getTargetAddressSpace(VD->getType()); 3748 AppendAddressSpaceXDeref(AddressSpace, Expr); 3749 3750 // If this is implicit parameter of CXXThis or ObjCSelf kind, then give it an 3751 // object pointer flag. 3752 if (const auto *IPD = dyn_cast<ImplicitParamDecl>(VD)) { 3753 if (IPD->getParameterKind() == ImplicitParamDecl::CXXThis || 3754 IPD->getParameterKind() == ImplicitParamDecl::ObjCSelf) 3755 Flags |= llvm::DINode::FlagObjectPointer; 3756 } 3757 3758 // Note: Older versions of clang used to emit byval references with an extra 3759 // DW_OP_deref, because they referenced the IR arg directly instead of 3760 // referencing an alloca. Newer versions of LLVM don't treat allocas 3761 // differently from other function arguments when used in a dbg.declare. 3762 auto *Scope = cast<llvm::DIScope>(LexicalBlockStack.back()); 3763 StringRef Name = VD->getName(); 3764 if (!Name.empty()) { 3765 if (VD->hasAttr<BlocksAttr>()) { 3766 // Here, we need an offset *into* the alloca. 3767 CharUnits offset = CharUnits::fromQuantity(32); 3768 Expr.push_back(llvm::dwarf::DW_OP_plus_uconst); 3769 // offset of __forwarding field 3770 offset = CGM.getContext().toCharUnitsFromBits( 3771 CGM.getTarget().getPointerWidth(0)); 3772 Expr.push_back(offset.getQuantity()); 3773 Expr.push_back(llvm::dwarf::DW_OP_deref); 3774 Expr.push_back(llvm::dwarf::DW_OP_plus_uconst); 3775 // offset of x field 3776 offset = CGM.getContext().toCharUnitsFromBits(XOffset); 3777 Expr.push_back(offset.getQuantity()); 3778 } 3779 } else if (const auto *RT = dyn_cast<RecordType>(VD->getType())) { 3780 // If VD is an anonymous union then Storage represents value for 3781 // all union fields. 3782 const RecordDecl *RD = RT->getDecl(); 3783 if (RD->isUnion() && RD->isAnonymousStructOrUnion()) { 3784 // GDB has trouble finding local variables in anonymous unions, so we emit 3785 // artificial local variables for each of the members. 3786 // 3787 // FIXME: Remove this code as soon as GDB supports this. 3788 // The debug info verifier in LLVM operates based on the assumption that a 3789 // variable has the same size as its storage and we had to disable the 3790 // check for artificial variables. 3791 for (const auto *Field : RD->fields()) { 3792 llvm::DIType *FieldTy = getOrCreateType(Field->getType(), Unit); 3793 StringRef FieldName = Field->getName(); 3794 3795 // Ignore unnamed fields. Do not ignore unnamed records. 3796 if (FieldName.empty() && !isa<RecordType>(Field->getType())) 3797 continue; 3798 3799 // Use VarDecl's Tag, Scope and Line number. 3800 auto FieldAlign = getDeclAlignIfRequired(Field, CGM.getContext()); 3801 auto *D = DBuilder.createAutoVariable( 3802 Scope, FieldName, Unit, Line, FieldTy, CGM.getLangOpts().Optimize, 3803 Flags | llvm::DINode::FlagArtificial, FieldAlign); 3804 3805 // Insert an llvm.dbg.declare into the current block. 3806 DBuilder.insertDeclare( 3807 Storage, D, DBuilder.createExpression(Expr), 3808 llvm::DebugLoc::get(Line, Column, Scope, CurInlinedAt), 3809 Builder.GetInsertBlock()); 3810 } 3811 } 3812 } 3813 3814 // Create the descriptor for the variable. 3815 auto *D = ArgNo ? DBuilder.createParameterVariable( 3816 Scope, Name, *ArgNo, Unit, Line, Ty, 3817 CGM.getLangOpts().Optimize, Flags) 3818 : DBuilder.createAutoVariable(Scope, Name, Unit, Line, Ty, 3819 CGM.getLangOpts().Optimize, 3820 Flags, Align); 3821 3822 // Insert an llvm.dbg.declare into the current block. 3823 DBuilder.insertDeclare(Storage, D, DBuilder.createExpression(Expr), 3824 llvm::DebugLoc::get(Line, Column, Scope, CurInlinedAt), 3825 Builder.GetInsertBlock()); 3826 3827 return D; 3828 } 3829 3830 llvm::DILocalVariable * 3831 CGDebugInfo::EmitDeclareOfAutoVariable(const VarDecl *VD, llvm::Value *Storage, 3832 CGBuilderTy &Builder) { 3833 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 3834 return EmitDeclare(VD, Storage, llvm::None, Builder); 3835 } 3836 3837 llvm::DIType *CGDebugInfo::CreateSelfType(const QualType &QualTy, 3838 llvm::DIType *Ty) { 3839 llvm::DIType *CachedTy = getTypeOrNull(QualTy); 3840 if (CachedTy) 3841 Ty = CachedTy; 3842 return DBuilder.createObjectPointerType(Ty); 3843 } 3844 3845 void CGDebugInfo::EmitDeclareOfBlockDeclRefVariable( 3846 const VarDecl *VD, llvm::Value *Storage, CGBuilderTy &Builder, 3847 const CGBlockInfo &blockInfo, llvm::Instruction *InsertPoint) { 3848 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 3849 assert(!LexicalBlockStack.empty() && "Region stack mismatch, stack empty!"); 3850 3851 if (Builder.GetInsertBlock() == nullptr) 3852 return; 3853 if (VD->hasAttr<NoDebugAttr>()) 3854 return; 3855 3856 bool isByRef = VD->hasAttr<BlocksAttr>(); 3857 3858 uint64_t XOffset = 0; 3859 llvm::DIFile *Unit = getOrCreateFile(VD->getLocation()); 3860 llvm::DIType *Ty; 3861 if (isByRef) 3862 Ty = EmitTypeForVarWithBlocksAttr(VD, &XOffset).WrappedType; 3863 else 3864 Ty = getOrCreateType(VD->getType(), Unit); 3865 3866 // Self is passed along as an implicit non-arg variable in a 3867 // block. Mark it as the object pointer. 3868 if (const auto *IPD = dyn_cast<ImplicitParamDecl>(VD)) 3869 if (IPD->getParameterKind() == ImplicitParamDecl::ObjCSelf) 3870 Ty = CreateSelfType(VD->getType(), Ty); 3871 3872 // Get location information. 3873 unsigned Line = getLineNumber(VD->getLocation()); 3874 unsigned Column = getColumnNumber(VD->getLocation()); 3875 3876 const llvm::DataLayout &target = CGM.getDataLayout(); 3877 3878 CharUnits offset = CharUnits::fromQuantity( 3879 target.getStructLayout(blockInfo.StructureType) 3880 ->getElementOffset(blockInfo.getCapture(VD).getIndex())); 3881 3882 SmallVector<int64_t, 9> addr; 3883 addr.push_back(llvm::dwarf::DW_OP_deref); 3884 addr.push_back(llvm::dwarf::DW_OP_plus_uconst); 3885 addr.push_back(offset.getQuantity()); 3886 if (isByRef) { 3887 addr.push_back(llvm::dwarf::DW_OP_deref); 3888 addr.push_back(llvm::dwarf::DW_OP_plus_uconst); 3889 // offset of __forwarding field 3890 offset = 3891 CGM.getContext().toCharUnitsFromBits(target.getPointerSizeInBits(0)); 3892 addr.push_back(offset.getQuantity()); 3893 addr.push_back(llvm::dwarf::DW_OP_deref); 3894 addr.push_back(llvm::dwarf::DW_OP_plus_uconst); 3895 // offset of x field 3896 offset = CGM.getContext().toCharUnitsFromBits(XOffset); 3897 addr.push_back(offset.getQuantity()); 3898 } 3899 3900 // Create the descriptor for the variable. 3901 auto Align = getDeclAlignIfRequired(VD, CGM.getContext()); 3902 auto *D = DBuilder.createAutoVariable( 3903 cast<llvm::DILocalScope>(LexicalBlockStack.back()), VD->getName(), Unit, 3904 Line, Ty, false, llvm::DINode::FlagZero, Align); 3905 3906 // Insert an llvm.dbg.declare into the current block. 3907 auto DL = 3908 llvm::DebugLoc::get(Line, Column, LexicalBlockStack.back(), CurInlinedAt); 3909 auto *Expr = DBuilder.createExpression(addr); 3910 if (InsertPoint) 3911 DBuilder.insertDeclare(Storage, D, Expr, DL, InsertPoint); 3912 else 3913 DBuilder.insertDeclare(Storage, D, Expr, DL, Builder.GetInsertBlock()); 3914 } 3915 3916 void CGDebugInfo::EmitDeclareOfArgVariable(const VarDecl *VD, llvm::Value *AI, 3917 unsigned ArgNo, 3918 CGBuilderTy &Builder) { 3919 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 3920 EmitDeclare(VD, AI, ArgNo, Builder); 3921 } 3922 3923 namespace { 3924 struct BlockLayoutChunk { 3925 uint64_t OffsetInBits; 3926 const BlockDecl::Capture *Capture; 3927 }; 3928 bool operator<(const BlockLayoutChunk &l, const BlockLayoutChunk &r) { 3929 return l.OffsetInBits < r.OffsetInBits; 3930 } 3931 } // namespace 3932 3933 void CGDebugInfo::collectDefaultFieldsForBlockLiteralDeclare( 3934 const CGBlockInfo &Block, const ASTContext &Context, SourceLocation Loc, 3935 const llvm::StructLayout &BlockLayout, llvm::DIFile *Unit, 3936 SmallVectorImpl<llvm::Metadata *> &Fields) { 3937 // Blocks in OpenCL have unique constraints which make the standard fields 3938 // redundant while requiring size and align fields for enqueue_kernel. See 3939 // initializeForBlockHeader in CGBlocks.cpp 3940 if (CGM.getLangOpts().OpenCL) { 3941 Fields.push_back(createFieldType("__size", Context.IntTy, Loc, AS_public, 3942 BlockLayout.getElementOffsetInBits(0), 3943 Unit, Unit)); 3944 Fields.push_back(createFieldType("__align", Context.IntTy, Loc, AS_public, 3945 BlockLayout.getElementOffsetInBits(1), 3946 Unit, Unit)); 3947 } else { 3948 Fields.push_back(createFieldType("__isa", Context.VoidPtrTy, Loc, AS_public, 3949 BlockLayout.getElementOffsetInBits(0), 3950 Unit, Unit)); 3951 Fields.push_back(createFieldType("__flags", Context.IntTy, Loc, AS_public, 3952 BlockLayout.getElementOffsetInBits(1), 3953 Unit, Unit)); 3954 Fields.push_back( 3955 createFieldType("__reserved", Context.IntTy, Loc, AS_public, 3956 BlockLayout.getElementOffsetInBits(2), Unit, Unit)); 3957 auto *FnTy = Block.getBlockExpr()->getFunctionType(); 3958 auto FnPtrType = CGM.getContext().getPointerType(FnTy->desugar()); 3959 Fields.push_back(createFieldType("__FuncPtr", FnPtrType, Loc, AS_public, 3960 BlockLayout.getElementOffsetInBits(3), 3961 Unit, Unit)); 3962 Fields.push_back(createFieldType( 3963 "__descriptor", 3964 Context.getPointerType(Block.NeedsCopyDispose 3965 ? Context.getBlockDescriptorExtendedType() 3966 : Context.getBlockDescriptorType()), 3967 Loc, AS_public, BlockLayout.getElementOffsetInBits(4), Unit, Unit)); 3968 } 3969 } 3970 3971 void CGDebugInfo::EmitDeclareOfBlockLiteralArgVariable(const CGBlockInfo &block, 3972 StringRef Name, 3973 unsigned ArgNo, 3974 llvm::AllocaInst *Alloca, 3975 CGBuilderTy &Builder) { 3976 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 3977 ASTContext &C = CGM.getContext(); 3978 const BlockDecl *blockDecl = block.getBlockDecl(); 3979 3980 // Collect some general information about the block's location. 3981 SourceLocation loc = blockDecl->getCaretLocation(); 3982 llvm::DIFile *tunit = getOrCreateFile(loc); 3983 unsigned line = getLineNumber(loc); 3984 unsigned column = getColumnNumber(loc); 3985 3986 // Build the debug-info type for the block literal. 3987 getDeclContextDescriptor(blockDecl); 3988 3989 const llvm::StructLayout *blockLayout = 3990 CGM.getDataLayout().getStructLayout(block.StructureType); 3991 3992 SmallVector<llvm::Metadata *, 16> fields; 3993 collectDefaultFieldsForBlockLiteralDeclare(block, C, loc, *blockLayout, tunit, 3994 fields); 3995 3996 // We want to sort the captures by offset, not because DWARF 3997 // requires this, but because we're paranoid about debuggers. 3998 SmallVector<BlockLayoutChunk, 8> chunks; 3999 4000 // 'this' capture. 4001 if (blockDecl->capturesCXXThis()) { 4002 BlockLayoutChunk chunk; 4003 chunk.OffsetInBits = 4004 blockLayout->getElementOffsetInBits(block.CXXThisIndex); 4005 chunk.Capture = nullptr; 4006 chunks.push_back(chunk); 4007 } 4008 4009 // Variable captures. 4010 for (const auto &capture : blockDecl->captures()) { 4011 const VarDecl *variable = capture.getVariable(); 4012 const CGBlockInfo::Capture &captureInfo = block.getCapture(variable); 4013 4014 // Ignore constant captures. 4015 if (captureInfo.isConstant()) 4016 continue; 4017 4018 BlockLayoutChunk chunk; 4019 chunk.OffsetInBits = 4020 blockLayout->getElementOffsetInBits(captureInfo.getIndex()); 4021 chunk.Capture = &capture; 4022 chunks.push_back(chunk); 4023 } 4024 4025 // Sort by offset. 4026 llvm::array_pod_sort(chunks.begin(), chunks.end()); 4027 4028 for (const BlockLayoutChunk &Chunk : chunks) { 4029 uint64_t offsetInBits = Chunk.OffsetInBits; 4030 const BlockDecl::Capture *capture = Chunk.Capture; 4031 4032 // If we have a null capture, this must be the C++ 'this' capture. 4033 if (!capture) { 4034 QualType type; 4035 if (auto *Method = 4036 cast_or_null<CXXMethodDecl>(blockDecl->getNonClosureContext())) 4037 type = Method->getThisType(C); 4038 else if (auto *RDecl = dyn_cast<CXXRecordDecl>(blockDecl->getParent())) 4039 type = QualType(RDecl->getTypeForDecl(), 0); 4040 else 4041 llvm_unreachable("unexpected block declcontext"); 4042 4043 fields.push_back(createFieldType("this", type, loc, AS_public, 4044 offsetInBits, tunit, tunit)); 4045 continue; 4046 } 4047 4048 const VarDecl *variable = capture->getVariable(); 4049 StringRef name = variable->getName(); 4050 4051 llvm::DIType *fieldType; 4052 if (capture->isByRef()) { 4053 TypeInfo PtrInfo = C.getTypeInfo(C.VoidPtrTy); 4054 auto Align = PtrInfo.AlignIsRequired ? PtrInfo.Align : 0; 4055 // FIXME: This recomputes the layout of the BlockByRefWrapper. 4056 uint64_t xoffset; 4057 fieldType = 4058 EmitTypeForVarWithBlocksAttr(variable, &xoffset).BlockByRefWrapper; 4059 fieldType = DBuilder.createPointerType(fieldType, PtrInfo.Width); 4060 fieldType = DBuilder.createMemberType(tunit, name, tunit, line, 4061 PtrInfo.Width, Align, offsetInBits, 4062 llvm::DINode::FlagZero, fieldType); 4063 } else { 4064 auto Align = getDeclAlignIfRequired(variable, CGM.getContext()); 4065 fieldType = createFieldType(name, variable->getType(), loc, AS_public, 4066 offsetInBits, Align, tunit, tunit); 4067 } 4068 fields.push_back(fieldType); 4069 } 4070 4071 SmallString<36> typeName; 4072 llvm::raw_svector_ostream(typeName) 4073 << "__block_literal_" << CGM.getUniqueBlockCount(); 4074 4075 llvm::DINodeArray fieldsArray = DBuilder.getOrCreateArray(fields); 4076 4077 llvm::DIType *type = 4078 DBuilder.createStructType(tunit, typeName.str(), tunit, line, 4079 CGM.getContext().toBits(block.BlockSize), 0, 4080 llvm::DINode::FlagZero, nullptr, fieldsArray); 4081 type = DBuilder.createPointerType(type, CGM.PointerWidthInBits); 4082 4083 // Get overall information about the block. 4084 llvm::DINode::DIFlags flags = llvm::DINode::FlagArtificial; 4085 auto *scope = cast<llvm::DILocalScope>(LexicalBlockStack.back()); 4086 4087 // Create the descriptor for the parameter. 4088 auto *debugVar = DBuilder.createParameterVariable( 4089 scope, Name, ArgNo, tunit, line, type, CGM.getLangOpts().Optimize, flags); 4090 4091 // Insert an llvm.dbg.declare into the current block. 4092 DBuilder.insertDeclare(Alloca, debugVar, DBuilder.createExpression(), 4093 llvm::DebugLoc::get(line, column, scope, CurInlinedAt), 4094 Builder.GetInsertBlock()); 4095 } 4096 4097 llvm::DIDerivedType * 4098 CGDebugInfo::getOrCreateStaticDataMemberDeclarationOrNull(const VarDecl *D) { 4099 if (!D->isStaticDataMember()) 4100 return nullptr; 4101 4102 auto MI = StaticDataMemberCache.find(D->getCanonicalDecl()); 4103 if (MI != StaticDataMemberCache.end()) { 4104 assert(MI->second && "Static data member declaration should still exist"); 4105 return MI->second; 4106 } 4107 4108 // If the member wasn't found in the cache, lazily construct and add it to the 4109 // type (used when a limited form of the type is emitted). 4110 auto DC = D->getDeclContext(); 4111 auto *Ctxt = cast<llvm::DICompositeType>(getDeclContextDescriptor(D)); 4112 return CreateRecordStaticField(D, Ctxt, cast<RecordDecl>(DC)); 4113 } 4114 4115 llvm::DIGlobalVariableExpression *CGDebugInfo::CollectAnonRecordDecls( 4116 const RecordDecl *RD, llvm::DIFile *Unit, unsigned LineNo, 4117 StringRef LinkageName, llvm::GlobalVariable *Var, llvm::DIScope *DContext) { 4118 llvm::DIGlobalVariableExpression *GVE = nullptr; 4119 4120 for (const auto *Field : RD->fields()) { 4121 llvm::DIType *FieldTy = getOrCreateType(Field->getType(), Unit); 4122 StringRef FieldName = Field->getName(); 4123 4124 // Ignore unnamed fields, but recurse into anonymous records. 4125 if (FieldName.empty()) { 4126 if (const auto *RT = dyn_cast<RecordType>(Field->getType())) 4127 GVE = CollectAnonRecordDecls(RT->getDecl(), Unit, LineNo, LinkageName, 4128 Var, DContext); 4129 continue; 4130 } 4131 // Use VarDecl's Tag, Scope and Line number. 4132 GVE = DBuilder.createGlobalVariableExpression( 4133 DContext, FieldName, LinkageName, Unit, LineNo, FieldTy, 4134 Var->hasLocalLinkage()); 4135 Var->addDebugInfo(GVE); 4136 } 4137 return GVE; 4138 } 4139 4140 void CGDebugInfo::EmitGlobalVariable(llvm::GlobalVariable *Var, 4141 const VarDecl *D) { 4142 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 4143 if (D->hasAttr<NoDebugAttr>()) 4144 return; 4145 4146 // If we already created a DIGlobalVariable for this declaration, just attach 4147 // it to the llvm::GlobalVariable. 4148 auto Cached = DeclCache.find(D->getCanonicalDecl()); 4149 if (Cached != DeclCache.end()) 4150 return Var->addDebugInfo( 4151 cast<llvm::DIGlobalVariableExpression>(Cached->second)); 4152 4153 // Create global variable debug descriptor. 4154 llvm::DIFile *Unit = nullptr; 4155 llvm::DIScope *DContext = nullptr; 4156 unsigned LineNo; 4157 StringRef DeclName, LinkageName; 4158 QualType T; 4159 llvm::MDTuple *TemplateParameters = nullptr; 4160 collectVarDeclProps(D, Unit, LineNo, T, DeclName, LinkageName, 4161 TemplateParameters, DContext); 4162 4163 // Attempt to store one global variable for the declaration - even if we 4164 // emit a lot of fields. 4165 llvm::DIGlobalVariableExpression *GVE = nullptr; 4166 4167 // If this is an anonymous union then we'll want to emit a global 4168 // variable for each member of the anonymous union so that it's possible 4169 // to find the name of any field in the union. 4170 if (T->isUnionType() && DeclName.empty()) { 4171 const RecordDecl *RD = T->castAs<RecordType>()->getDecl(); 4172 assert(RD->isAnonymousStructOrUnion() && 4173 "unnamed non-anonymous struct or union?"); 4174 GVE = CollectAnonRecordDecls(RD, Unit, LineNo, LinkageName, Var, DContext); 4175 } else { 4176 auto Align = getDeclAlignIfRequired(D, CGM.getContext()); 4177 4178 SmallVector<int64_t, 4> Expr; 4179 unsigned AddressSpace = 4180 CGM.getContext().getTargetAddressSpace(D->getType()); 4181 AppendAddressSpaceXDeref(AddressSpace, Expr); 4182 4183 GVE = DBuilder.createGlobalVariableExpression( 4184 DContext, DeclName, LinkageName, Unit, LineNo, getOrCreateType(T, Unit), 4185 Var->hasLocalLinkage(), 4186 Expr.empty() ? nullptr : DBuilder.createExpression(Expr), 4187 getOrCreateStaticDataMemberDeclarationOrNull(D), TemplateParameters, 4188 Align); 4189 Var->addDebugInfo(GVE); 4190 } 4191 DeclCache[D->getCanonicalDecl()].reset(GVE); 4192 } 4193 4194 void CGDebugInfo::EmitGlobalVariable(const ValueDecl *VD, const APValue &Init) { 4195 assert(DebugKind >= codegenoptions::LimitedDebugInfo); 4196 if (VD->hasAttr<NoDebugAttr>()) 4197 return; 4198 auto Align = getDeclAlignIfRequired(VD, CGM.getContext()); 4199 // Create the descriptor for the variable. 4200 llvm::DIFile *Unit = getOrCreateFile(VD->getLocation()); 4201 StringRef Name = VD->getName(); 4202 llvm::DIType *Ty = getOrCreateType(VD->getType(), Unit); 4203 if (const auto *ECD = dyn_cast<EnumConstantDecl>(VD)) { 4204 const auto *ED = cast<EnumDecl>(ECD->getDeclContext()); 4205 assert(isa<EnumType>(ED->getTypeForDecl()) && "Enum without EnumType?"); 4206 Ty = getOrCreateType(QualType(ED->getTypeForDecl(), 0), Unit); 4207 } 4208 // Do not use global variables for enums. 4209 // 4210 // FIXME: why not? 4211 if (Ty->getTag() == llvm::dwarf::DW_TAG_enumeration_type) 4212 return; 4213 // Do not emit separate definitions for function local const/statics. 4214 if (isa<FunctionDecl>(VD->getDeclContext())) 4215 return; 4216 VD = cast<ValueDecl>(VD->getCanonicalDecl()); 4217 auto *VarD = cast<VarDecl>(VD); 4218 if (VarD->isStaticDataMember()) { 4219 auto *RD = cast<RecordDecl>(VarD->getDeclContext()); 4220 getDeclContextDescriptor(VarD); 4221 // Ensure that the type is retained even though it's otherwise unreferenced. 4222 // 4223 // FIXME: This is probably unnecessary, since Ty should reference RD 4224 // through its scope. 4225 RetainedTypes.push_back( 4226 CGM.getContext().getRecordType(RD).getAsOpaquePtr()); 4227 return; 4228 } 4229 4230 llvm::DIScope *DContext = getDeclContextDescriptor(VD); 4231 4232 auto &GV = DeclCache[VD]; 4233 if (GV) 4234 return; 4235 llvm::DIExpression *InitExpr = nullptr; 4236 if (CGM.getContext().getTypeSize(VD->getType()) <= 64) { 4237 // FIXME: Add a representation for integer constants wider than 64 bits. 4238 if (Init.isInt()) 4239 InitExpr = 4240 DBuilder.createConstantValueExpression(Init.getInt().getExtValue()); 4241 else if (Init.isFloat()) 4242 InitExpr = DBuilder.createConstantValueExpression( 4243 Init.getFloat().bitcastToAPInt().getZExtValue()); 4244 } 4245 4246 llvm::MDTuple *TemplateParameters = nullptr; 4247 4248 if (isa<VarTemplateSpecializationDecl>(VD)) 4249 if (VarD) { 4250 llvm::DINodeArray parameterNodes = CollectVarTemplateParams(VarD, &*Unit); 4251 TemplateParameters = parameterNodes.get(); 4252 } 4253 4254 GV.reset(DBuilder.createGlobalVariableExpression( 4255 DContext, Name, StringRef(), Unit, getLineNumber(VD->getLocation()), Ty, 4256 true, InitExpr, getOrCreateStaticDataMemberDeclarationOrNull(VarD), 4257 TemplateParameters, Align)); 4258 } 4259 4260 llvm::DIScope *CGDebugInfo::getCurrentContextDescriptor(const Decl *D) { 4261 if (!LexicalBlockStack.empty()) 4262 return LexicalBlockStack.back(); 4263 llvm::DIScope *Mod = getParentModuleOrNull(D); 4264 return getContextDescriptor(D, Mod ? Mod : TheCU); 4265 } 4266 4267 void CGDebugInfo::EmitUsingDirective(const UsingDirectiveDecl &UD) { 4268 if (CGM.getCodeGenOpts().getDebugInfo() < codegenoptions::LimitedDebugInfo) 4269 return; 4270 const NamespaceDecl *NSDecl = UD.getNominatedNamespace(); 4271 if (!NSDecl->isAnonymousNamespace() || 4272 CGM.getCodeGenOpts().DebugExplicitImport) { 4273 auto Loc = UD.getLocation(); 4274 DBuilder.createImportedModule( 4275 getCurrentContextDescriptor(cast<Decl>(UD.getDeclContext())), 4276 getOrCreateNamespace(NSDecl), getOrCreateFile(Loc), getLineNumber(Loc)); 4277 } 4278 } 4279 4280 void CGDebugInfo::EmitUsingDecl(const UsingDecl &UD) { 4281 if (CGM.getCodeGenOpts().getDebugInfo() < codegenoptions::LimitedDebugInfo) 4282 return; 4283 assert(UD.shadow_size() && 4284 "We shouldn't be codegening an invalid UsingDecl containing no decls"); 4285 // Emitting one decl is sufficient - debuggers can detect that this is an 4286 // overloaded name & provide lookup for all the overloads. 4287 const UsingShadowDecl &USD = **UD.shadow_begin(); 4288 4289 // FIXME: Skip functions with undeduced auto return type for now since we 4290 // don't currently have the plumbing for separate declarations & definitions 4291 // of free functions and mismatched types (auto in the declaration, concrete 4292 // return type in the definition) 4293 if (const auto *FD = dyn_cast<FunctionDecl>(USD.getUnderlyingDecl())) 4294 if (const auto *AT = 4295 FD->getType()->getAs<FunctionProtoType>()->getContainedAutoType()) 4296 if (AT->getDeducedType().isNull()) 4297 return; 4298 if (llvm::DINode *Target = 4299 getDeclarationOrDefinition(USD.getUnderlyingDecl())) { 4300 auto Loc = USD.getLocation(); 4301 DBuilder.createImportedDeclaration( 4302 getCurrentContextDescriptor(cast<Decl>(USD.getDeclContext())), Target, 4303 getOrCreateFile(Loc), getLineNumber(Loc)); 4304 } 4305 } 4306 4307 void CGDebugInfo::EmitImportDecl(const ImportDecl &ID) { 4308 if (CGM.getCodeGenOpts().getDebuggerTuning() != llvm::DebuggerKind::LLDB) 4309 return; 4310 if (Module *M = ID.getImportedModule()) { 4311 auto Info = ExternalASTSource::ASTSourceDescriptor(*M); 4312 auto Loc = ID.getLocation(); 4313 DBuilder.createImportedDeclaration( 4314 getCurrentContextDescriptor(cast<Decl>(ID.getDeclContext())), 4315 getOrCreateModuleRef(Info, DebugTypeExtRefs), getOrCreateFile(Loc), 4316 getLineNumber(Loc)); 4317 } 4318 } 4319 4320 llvm::DIImportedEntity * 4321 CGDebugInfo::EmitNamespaceAlias(const NamespaceAliasDecl &NA) { 4322 if (CGM.getCodeGenOpts().getDebugInfo() < codegenoptions::LimitedDebugInfo) 4323 return nullptr; 4324 auto &VH = NamespaceAliasCache[&NA]; 4325 if (VH) 4326 return cast<llvm::DIImportedEntity>(VH); 4327 llvm::DIImportedEntity *R; 4328 auto Loc = NA.getLocation(); 4329 if (const auto *Underlying = 4330 dyn_cast<NamespaceAliasDecl>(NA.getAliasedNamespace())) 4331 // This could cache & dedup here rather than relying on metadata deduping. 4332 R = DBuilder.createImportedDeclaration( 4333 getCurrentContextDescriptor(cast<Decl>(NA.getDeclContext())), 4334 EmitNamespaceAlias(*Underlying), getOrCreateFile(Loc), 4335 getLineNumber(Loc), NA.getName()); 4336 else 4337 R = DBuilder.createImportedDeclaration( 4338 getCurrentContextDescriptor(cast<Decl>(NA.getDeclContext())), 4339 getOrCreateNamespace(cast<NamespaceDecl>(NA.getAliasedNamespace())), 4340 getOrCreateFile(Loc), getLineNumber(Loc), NA.getName()); 4341 VH.reset(R); 4342 return R; 4343 } 4344 4345 llvm::DINamespace * 4346 CGDebugInfo::getOrCreateNamespace(const NamespaceDecl *NSDecl) { 4347 // Don't canonicalize the NamespaceDecl here: The DINamespace will be uniqued 4348 // if necessary, and this way multiple declarations of the same namespace in 4349 // different parent modules stay distinct. 4350 auto I = NamespaceCache.find(NSDecl); 4351 if (I != NamespaceCache.end()) 4352 return cast<llvm::DINamespace>(I->second); 4353 4354 llvm::DIScope *Context = getDeclContextDescriptor(NSDecl); 4355 // Don't trust the context if it is a DIModule (see comment above). 4356 llvm::DINamespace *NS = 4357 DBuilder.createNameSpace(Context, NSDecl->getName(), NSDecl->isInline()); 4358 NamespaceCache[NSDecl].reset(NS); 4359 return NS; 4360 } 4361 4362 void CGDebugInfo::setDwoId(uint64_t Signature) { 4363 assert(TheCU && "no main compile unit"); 4364 TheCU->setDWOId(Signature); 4365 } 4366 4367 void CGDebugInfo::finalize() { 4368 // Creating types might create further types - invalidating the current 4369 // element and the size(), so don't cache/reference them. 4370 for (size_t i = 0; i != ObjCInterfaceCache.size(); ++i) { 4371 ObjCInterfaceCacheEntry E = ObjCInterfaceCache[i]; 4372 llvm::DIType *Ty = E.Type->getDecl()->getDefinition() 4373 ? CreateTypeDefinition(E.Type, E.Unit) 4374 : E.Decl; 4375 DBuilder.replaceTemporary(llvm::TempDIType(E.Decl), Ty); 4376 } 4377 4378 if (CGM.getCodeGenOpts().DwarfVersion >= 5) { 4379 // Add methods to interface. 4380 for (const auto &P : ObjCMethodCache) { 4381 if (P.second.empty()) 4382 continue; 4383 4384 QualType QTy(P.first->getTypeForDecl(), 0); 4385 auto It = TypeCache.find(QTy.getAsOpaquePtr()); 4386 assert(It != TypeCache.end()); 4387 4388 llvm::DICompositeType *InterfaceDecl = 4389 cast<llvm::DICompositeType>(It->second); 4390 4391 SmallVector<llvm::Metadata *, 16> EltTys; 4392 auto CurrenetElts = InterfaceDecl->getElements(); 4393 EltTys.append(CurrenetElts.begin(), CurrenetElts.end()); 4394 for (auto &MD : P.second) 4395 EltTys.push_back(MD); 4396 llvm::DINodeArray Elements = DBuilder.getOrCreateArray(EltTys); 4397 DBuilder.replaceArrays(InterfaceDecl, Elements); 4398 } 4399 } 4400 4401 for (const auto &P : ReplaceMap) { 4402 assert(P.second); 4403 auto *Ty = cast<llvm::DIType>(P.second); 4404 assert(Ty->isForwardDecl()); 4405 4406 auto It = TypeCache.find(P.first); 4407 assert(It != TypeCache.end()); 4408 assert(It->second); 4409 4410 DBuilder.replaceTemporary(llvm::TempDIType(Ty), 4411 cast<llvm::DIType>(It->second)); 4412 } 4413 4414 for (const auto &P : FwdDeclReplaceMap) { 4415 assert(P.second); 4416 llvm::TempMDNode FwdDecl(cast<llvm::MDNode>(P.second)); 4417 llvm::Metadata *Repl; 4418 4419 auto It = DeclCache.find(P.first); 4420 // If there has been no definition for the declaration, call RAUW 4421 // with ourselves, that will destroy the temporary MDNode and 4422 // replace it with a standard one, avoiding leaking memory. 4423 if (It == DeclCache.end()) 4424 Repl = P.second; 4425 else 4426 Repl = It->second; 4427 4428 if (auto *GVE = dyn_cast_or_null<llvm::DIGlobalVariableExpression>(Repl)) 4429 Repl = GVE->getVariable(); 4430 DBuilder.replaceTemporary(std::move(FwdDecl), cast<llvm::MDNode>(Repl)); 4431 } 4432 4433 // We keep our own list of retained types, because we need to look 4434 // up the final type in the type cache. 4435 for (auto &RT : RetainedTypes) 4436 if (auto MD = TypeCache[RT]) 4437 DBuilder.retainType(cast<llvm::DIType>(MD)); 4438 4439 DBuilder.finalize(); 4440 } 4441 4442 void CGDebugInfo::EmitExplicitCastType(QualType Ty) { 4443 if (CGM.getCodeGenOpts().getDebugInfo() < codegenoptions::LimitedDebugInfo) 4444 return; 4445 4446 if (auto *DieTy = getOrCreateType(Ty, getOrCreateMainFile())) 4447 // Don't ignore in case of explicit cast where it is referenced indirectly. 4448 DBuilder.retainType(DieTy); 4449 } 4450 4451 llvm::DebugLoc CGDebugInfo::SourceLocToDebugLoc(SourceLocation Loc) { 4452 if (LexicalBlockStack.empty()) 4453 return llvm::DebugLoc(); 4454 4455 llvm::MDNode *Scope = LexicalBlockStack.back(); 4456 return llvm::DebugLoc::get(getLineNumber(Loc), getColumnNumber(Loc), Scope); 4457 } 4458 4459 llvm::DINode::DIFlags CGDebugInfo::getCallSiteRelatedAttrs() const { 4460 // Call site-related attributes are only useful in optimized programs, and 4461 // when there's a possibility of debugging backtraces. 4462 if (!CGM.getLangOpts().Optimize || DebugKind == codegenoptions::NoDebugInfo || 4463 DebugKind == codegenoptions::LocTrackingOnly) 4464 return llvm::DINode::FlagZero; 4465 4466 // Call site-related attributes are available in DWARF v5. Some debuggers, 4467 // while not fully DWARF v5-compliant, may accept these attributes as if they 4468 // were part of DWARF v4. 4469 bool SupportsDWARFv4Ext = 4470 CGM.getCodeGenOpts().DwarfVersion == 4 && 4471 CGM.getCodeGenOpts().getDebuggerTuning() == llvm::DebuggerKind::LLDB; 4472 if (!SupportsDWARFv4Ext && CGM.getCodeGenOpts().DwarfVersion < 5) 4473 return llvm::DINode::FlagZero; 4474 4475 return llvm::DINode::FlagAllCallsDescribed; 4476 } 4477