1 //===--- CompilerInstance.cpp ---------------------------------------------===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 9 #include "clang/Frontend/CompilerInstance.h" 10 #include "clang/AST/ASTConsumer.h" 11 #include "clang/AST/ASTContext.h" 12 #include "clang/AST/Decl.h" 13 #include "clang/Basic/CharInfo.h" 14 #include "clang/Basic/Diagnostic.h" 15 #include "clang/Basic/FileManager.h" 16 #include "clang/Basic/LangStandard.h" 17 #include "clang/Basic/SourceManager.h" 18 #include "clang/Basic/Stack.h" 19 #include "clang/Basic/TargetInfo.h" 20 #include "clang/Basic/Version.h" 21 #include "clang/Config/config.h" 22 #include "clang/Frontend/ChainedDiagnosticConsumer.h" 23 #include "clang/Frontend/FrontendAction.h" 24 #include "clang/Frontend/FrontendActions.h" 25 #include "clang/Frontend/FrontendDiagnostic.h" 26 #include "clang/Frontend/LogDiagnosticPrinter.h" 27 #include "clang/Frontend/SerializedDiagnosticPrinter.h" 28 #include "clang/Frontend/TextDiagnosticPrinter.h" 29 #include "clang/Frontend/Utils.h" 30 #include "clang/Frontend/VerifyDiagnosticConsumer.h" 31 #include "clang/Lex/HeaderSearch.h" 32 #include "clang/Lex/Preprocessor.h" 33 #include "clang/Lex/PreprocessorOptions.h" 34 #include "clang/Sema/CodeCompleteConsumer.h" 35 #include "clang/Sema/Sema.h" 36 #include "clang/Serialization/ASTReader.h" 37 #include "clang/Serialization/GlobalModuleIndex.h" 38 #include "clang/Serialization/InMemoryModuleCache.h" 39 #include "llvm/ADT/Statistic.h" 40 #include "llvm/Support/BuryPointer.h" 41 #include "llvm/Support/CrashRecoveryContext.h" 42 #include "llvm/Support/Errc.h" 43 #include "llvm/Support/FileSystem.h" 44 #include "llvm/Support/Host.h" 45 #include "llvm/Support/LockFileManager.h" 46 #include "llvm/Support/MemoryBuffer.h" 47 #include "llvm/Support/Path.h" 48 #include "llvm/Support/Program.h" 49 #include "llvm/Support/Signals.h" 50 #include "llvm/Support/TimeProfiler.h" 51 #include "llvm/Support/Timer.h" 52 #include "llvm/Support/raw_ostream.h" 53 #include <time.h> 54 #include <utility> 55 56 using namespace clang; 57 58 CompilerInstance::CompilerInstance( 59 std::shared_ptr<PCHContainerOperations> PCHContainerOps, 60 InMemoryModuleCache *SharedModuleCache) 61 : ModuleLoader(/* BuildingModule = */ SharedModuleCache), 62 Invocation(new CompilerInvocation()), 63 ModuleCache(SharedModuleCache ? SharedModuleCache 64 : new InMemoryModuleCache), 65 ThePCHContainerOperations(std::move(PCHContainerOps)) {} 66 67 CompilerInstance::~CompilerInstance() { 68 assert(OutputFiles.empty() && "Still output files in flight?"); 69 } 70 71 void CompilerInstance::setInvocation( 72 std::shared_ptr<CompilerInvocation> Value) { 73 Invocation = std::move(Value); 74 } 75 76 bool CompilerInstance::shouldBuildGlobalModuleIndex() const { 77 return (BuildGlobalModuleIndex || 78 (TheASTReader && TheASTReader->isGlobalIndexUnavailable() && 79 getFrontendOpts().GenerateGlobalModuleIndex)) && 80 !ModuleBuildFailed; 81 } 82 83 void CompilerInstance::setDiagnostics(DiagnosticsEngine *Value) { 84 Diagnostics = Value; 85 } 86 87 void CompilerInstance::setVerboseOutputStream(raw_ostream &Value) { 88 OwnedVerboseOutputStream.release(); 89 VerboseOutputStream = &Value; 90 } 91 92 void CompilerInstance::setVerboseOutputStream(std::unique_ptr<raw_ostream> Value) { 93 OwnedVerboseOutputStream.swap(Value); 94 VerboseOutputStream = OwnedVerboseOutputStream.get(); 95 } 96 97 void CompilerInstance::setTarget(TargetInfo *Value) { Target = Value; } 98 void CompilerInstance::setAuxTarget(TargetInfo *Value) { AuxTarget = Value; } 99 100 void CompilerInstance::setFileManager(FileManager *Value) { 101 FileMgr = Value; 102 } 103 104 void CompilerInstance::setSourceManager(SourceManager *Value) { 105 SourceMgr = Value; 106 } 107 108 void CompilerInstance::setPreprocessor(std::shared_ptr<Preprocessor> Value) { 109 PP = std::move(Value); 110 } 111 112 void CompilerInstance::setASTContext(ASTContext *Value) { 113 Context = Value; 114 115 if (Context && Consumer) 116 getASTConsumer().Initialize(getASTContext()); 117 } 118 119 void CompilerInstance::setSema(Sema *S) { 120 TheSema.reset(S); 121 } 122 123 void CompilerInstance::setASTConsumer(std::unique_ptr<ASTConsumer> Value) { 124 Consumer = std::move(Value); 125 126 if (Context && Consumer) 127 getASTConsumer().Initialize(getASTContext()); 128 } 129 130 void CompilerInstance::setCodeCompletionConsumer(CodeCompleteConsumer *Value) { 131 CompletionConsumer.reset(Value); 132 } 133 134 std::unique_ptr<Sema> CompilerInstance::takeSema() { 135 return std::move(TheSema); 136 } 137 138 IntrusiveRefCntPtr<ASTReader> CompilerInstance::getASTReader() const { 139 return TheASTReader; 140 } 141 void CompilerInstance::setModuleManager(IntrusiveRefCntPtr<ASTReader> Reader) { 142 assert(ModuleCache.get() == &Reader->getModuleManager().getModuleCache() && 143 "Expected ASTReader to use the same PCM cache"); 144 TheASTReader = std::move(Reader); 145 } 146 147 std::shared_ptr<ModuleDependencyCollector> 148 CompilerInstance::getModuleDepCollector() const { 149 return ModuleDepCollector; 150 } 151 152 void CompilerInstance::setModuleDepCollector( 153 std::shared_ptr<ModuleDependencyCollector> Collector) { 154 ModuleDepCollector = std::move(Collector); 155 } 156 157 static void collectHeaderMaps(const HeaderSearch &HS, 158 std::shared_ptr<ModuleDependencyCollector> MDC) { 159 SmallVector<std::string, 4> HeaderMapFileNames; 160 HS.getHeaderMapFileNames(HeaderMapFileNames); 161 for (auto &Name : HeaderMapFileNames) 162 MDC->addFile(Name); 163 } 164 165 static void collectIncludePCH(CompilerInstance &CI, 166 std::shared_ptr<ModuleDependencyCollector> MDC) { 167 const PreprocessorOptions &PPOpts = CI.getPreprocessorOpts(); 168 if (PPOpts.ImplicitPCHInclude.empty()) 169 return; 170 171 StringRef PCHInclude = PPOpts.ImplicitPCHInclude; 172 FileManager &FileMgr = CI.getFileManager(); 173 auto PCHDir = FileMgr.getDirectory(PCHInclude); 174 if (!PCHDir) { 175 MDC->addFile(PCHInclude); 176 return; 177 } 178 179 std::error_code EC; 180 SmallString<128> DirNative; 181 llvm::sys::path::native((*PCHDir)->getName(), DirNative); 182 llvm::vfs::FileSystem &FS = FileMgr.getVirtualFileSystem(); 183 SimpleASTReaderListener Validator(CI.getPreprocessor()); 184 for (llvm::vfs::directory_iterator Dir = FS.dir_begin(DirNative, EC), DirEnd; 185 Dir != DirEnd && !EC; Dir.increment(EC)) { 186 // Check whether this is an AST file. ASTReader::isAcceptableASTFile is not 187 // used here since we're not interested in validating the PCH at this time, 188 // but only to check whether this is a file containing an AST. 189 if (!ASTReader::readASTFileControlBlock( 190 Dir->path(), FileMgr, CI.getPCHContainerReader(), 191 /*FindModuleFileExtensions=*/false, Validator, 192 /*ValidateDiagnosticOptions=*/false)) 193 MDC->addFile(Dir->path()); 194 } 195 } 196 197 static void collectVFSEntries(CompilerInstance &CI, 198 std::shared_ptr<ModuleDependencyCollector> MDC) { 199 if (CI.getHeaderSearchOpts().VFSOverlayFiles.empty()) 200 return; 201 202 // Collect all VFS found. 203 SmallVector<llvm::vfs::YAMLVFSEntry, 16> VFSEntries; 204 for (const std::string &VFSFile : CI.getHeaderSearchOpts().VFSOverlayFiles) { 205 llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> Buffer = 206 llvm::MemoryBuffer::getFile(VFSFile); 207 if (!Buffer) 208 return; 209 llvm::vfs::collectVFSFromYAML(std::move(Buffer.get()), 210 /*DiagHandler*/ nullptr, VFSFile, VFSEntries); 211 } 212 213 for (auto &E : VFSEntries) 214 MDC->addFile(E.VPath, E.RPath); 215 } 216 217 // Diagnostics 218 static void SetUpDiagnosticLog(DiagnosticOptions *DiagOpts, 219 const CodeGenOptions *CodeGenOpts, 220 DiagnosticsEngine &Diags) { 221 std::error_code EC; 222 std::unique_ptr<raw_ostream> StreamOwner; 223 raw_ostream *OS = &llvm::errs(); 224 if (DiagOpts->DiagnosticLogFile != "-") { 225 // Create the output stream. 226 auto FileOS = std::make_unique<llvm::raw_fd_ostream>( 227 DiagOpts->DiagnosticLogFile, EC, 228 llvm::sys::fs::OF_Append | llvm::sys::fs::OF_Text); 229 if (EC) { 230 Diags.Report(diag::warn_fe_cc_log_diagnostics_failure) 231 << DiagOpts->DiagnosticLogFile << EC.message(); 232 } else { 233 FileOS->SetUnbuffered(); 234 OS = FileOS.get(); 235 StreamOwner = std::move(FileOS); 236 } 237 } 238 239 // Chain in the diagnostic client which will log the diagnostics. 240 auto Logger = std::make_unique<LogDiagnosticPrinter>(*OS, DiagOpts, 241 std::move(StreamOwner)); 242 if (CodeGenOpts) 243 Logger->setDwarfDebugFlags(CodeGenOpts->DwarfDebugFlags); 244 if (Diags.ownsClient()) { 245 Diags.setClient( 246 new ChainedDiagnosticConsumer(Diags.takeClient(), std::move(Logger))); 247 } else { 248 Diags.setClient( 249 new ChainedDiagnosticConsumer(Diags.getClient(), std::move(Logger))); 250 } 251 } 252 253 static void SetupSerializedDiagnostics(DiagnosticOptions *DiagOpts, 254 DiagnosticsEngine &Diags, 255 StringRef OutputFile) { 256 auto SerializedConsumer = 257 clang::serialized_diags::create(OutputFile, DiagOpts); 258 259 if (Diags.ownsClient()) { 260 Diags.setClient(new ChainedDiagnosticConsumer( 261 Diags.takeClient(), std::move(SerializedConsumer))); 262 } else { 263 Diags.setClient(new ChainedDiagnosticConsumer( 264 Diags.getClient(), std::move(SerializedConsumer))); 265 } 266 } 267 268 void CompilerInstance::createDiagnostics(DiagnosticConsumer *Client, 269 bool ShouldOwnClient) { 270 Diagnostics = createDiagnostics(&getDiagnosticOpts(), Client, 271 ShouldOwnClient, &getCodeGenOpts()); 272 } 273 274 IntrusiveRefCntPtr<DiagnosticsEngine> 275 CompilerInstance::createDiagnostics(DiagnosticOptions *Opts, 276 DiagnosticConsumer *Client, 277 bool ShouldOwnClient, 278 const CodeGenOptions *CodeGenOpts) { 279 IntrusiveRefCntPtr<DiagnosticIDs> DiagID(new DiagnosticIDs()); 280 IntrusiveRefCntPtr<DiagnosticsEngine> 281 Diags(new DiagnosticsEngine(DiagID, Opts)); 282 283 // Create the diagnostic client for reporting errors or for 284 // implementing -verify. 285 if (Client) { 286 Diags->setClient(Client, ShouldOwnClient); 287 } else 288 Diags->setClient(new TextDiagnosticPrinter(llvm::errs(), Opts)); 289 290 // Chain in -verify checker, if requested. 291 if (Opts->VerifyDiagnostics) 292 Diags->setClient(new VerifyDiagnosticConsumer(*Diags)); 293 294 // Chain in -diagnostic-log-file dumper, if requested. 295 if (!Opts->DiagnosticLogFile.empty()) 296 SetUpDiagnosticLog(Opts, CodeGenOpts, *Diags); 297 298 if (!Opts->DiagnosticSerializationFile.empty()) 299 SetupSerializedDiagnostics(Opts, *Diags, 300 Opts->DiagnosticSerializationFile); 301 302 // Configure our handling of diagnostics. 303 ProcessWarningOptions(*Diags, *Opts); 304 305 return Diags; 306 } 307 308 // File Manager 309 310 FileManager *CompilerInstance::createFileManager( 311 IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS) { 312 if (!VFS) 313 VFS = FileMgr ? &FileMgr->getVirtualFileSystem() 314 : createVFSFromCompilerInvocation(getInvocation(), 315 getDiagnostics()); 316 assert(VFS && "FileManager has no VFS?"); 317 FileMgr = new FileManager(getFileSystemOpts(), std::move(VFS)); 318 return FileMgr.get(); 319 } 320 321 // Source Manager 322 323 void CompilerInstance::createSourceManager(FileManager &FileMgr) { 324 SourceMgr = new SourceManager(getDiagnostics(), FileMgr); 325 } 326 327 // Initialize the remapping of files to alternative contents, e.g., 328 // those specified through other files. 329 static void InitializeFileRemapping(DiagnosticsEngine &Diags, 330 SourceManager &SourceMgr, 331 FileManager &FileMgr, 332 const PreprocessorOptions &InitOpts) { 333 // Remap files in the source manager (with buffers). 334 for (const auto &RB : InitOpts.RemappedFileBuffers) { 335 // Create the file entry for the file that we're mapping from. 336 const FileEntry *FromFile = 337 FileMgr.getVirtualFile(RB.first, RB.second->getBufferSize(), 0); 338 if (!FromFile) { 339 Diags.Report(diag::err_fe_remap_missing_from_file) << RB.first; 340 if (!InitOpts.RetainRemappedFileBuffers) 341 delete RB.second; 342 continue; 343 } 344 345 // Override the contents of the "from" file with the contents of 346 // the "to" file. 347 SourceMgr.overrideFileContents(FromFile, RB.second, 348 InitOpts.RetainRemappedFileBuffers); 349 } 350 351 // Remap files in the source manager (with other files). 352 for (const auto &RF : InitOpts.RemappedFiles) { 353 // Find the file that we're mapping to. 354 auto ToFile = FileMgr.getFile(RF.second); 355 if (!ToFile) { 356 Diags.Report(diag::err_fe_remap_missing_to_file) << RF.first << RF.second; 357 continue; 358 } 359 360 // Create the file entry for the file that we're mapping from. 361 const FileEntry *FromFile = 362 FileMgr.getVirtualFile(RF.first, (*ToFile)->getSize(), 0); 363 if (!FromFile) { 364 Diags.Report(diag::err_fe_remap_missing_from_file) << RF.first; 365 continue; 366 } 367 368 // Override the contents of the "from" file with the contents of 369 // the "to" file. 370 SourceMgr.overrideFileContents(FromFile, *ToFile); 371 } 372 373 SourceMgr.setOverridenFilesKeepOriginalName( 374 InitOpts.RemappedFilesKeepOriginalName); 375 } 376 377 // Preprocessor 378 379 void CompilerInstance::createPreprocessor(TranslationUnitKind TUKind) { 380 const PreprocessorOptions &PPOpts = getPreprocessorOpts(); 381 382 // The module manager holds a reference to the old preprocessor (if any). 383 TheASTReader.reset(); 384 385 // Create the Preprocessor. 386 HeaderSearch *HeaderInfo = 387 new HeaderSearch(getHeaderSearchOptsPtr(), getSourceManager(), 388 getDiagnostics(), getLangOpts(), &getTarget()); 389 PP = std::make_shared<Preprocessor>(Invocation->getPreprocessorOptsPtr(), 390 getDiagnostics(), getLangOpts(), 391 getSourceManager(), *HeaderInfo, *this, 392 /*IdentifierInfoLookup=*/nullptr, 393 /*OwnsHeaderSearch=*/true, TUKind); 394 getTarget().adjust(getLangOpts()); 395 PP->Initialize(getTarget(), getAuxTarget()); 396 397 if (PPOpts.DetailedRecord) 398 PP->createPreprocessingRecord(); 399 400 // Apply remappings to the source manager. 401 InitializeFileRemapping(PP->getDiagnostics(), PP->getSourceManager(), 402 PP->getFileManager(), PPOpts); 403 404 // Predefine macros and configure the preprocessor. 405 InitializePreprocessor(*PP, PPOpts, getPCHContainerReader(), 406 getFrontendOpts()); 407 408 // Initialize the header search object. In CUDA compilations, we use the aux 409 // triple (the host triple) to initialize our header search, since we need to 410 // find the host headers in order to compile the CUDA code. 411 const llvm::Triple *HeaderSearchTriple = &PP->getTargetInfo().getTriple(); 412 if (PP->getTargetInfo().getTriple().getOS() == llvm::Triple::CUDA && 413 PP->getAuxTargetInfo()) 414 HeaderSearchTriple = &PP->getAuxTargetInfo()->getTriple(); 415 416 ApplyHeaderSearchOptions(PP->getHeaderSearchInfo(), getHeaderSearchOpts(), 417 PP->getLangOpts(), *HeaderSearchTriple); 418 419 PP->setPreprocessedOutput(getPreprocessorOutputOpts().ShowCPP); 420 421 if (PP->getLangOpts().Modules && PP->getLangOpts().ImplicitModules) 422 PP->getHeaderSearchInfo().setModuleCachePath(getSpecificModuleCachePath()); 423 424 // Handle generating dependencies, if requested. 425 const DependencyOutputOptions &DepOpts = getDependencyOutputOpts(); 426 if (!DepOpts.OutputFile.empty()) 427 addDependencyCollector(std::make_shared<DependencyFileGenerator>(DepOpts)); 428 if (!DepOpts.DOTOutputFile.empty()) 429 AttachDependencyGraphGen(*PP, DepOpts.DOTOutputFile, 430 getHeaderSearchOpts().Sysroot); 431 432 // If we don't have a collector, but we are collecting module dependencies, 433 // then we're the top level compiler instance and need to create one. 434 if (!ModuleDepCollector && !DepOpts.ModuleDependencyOutputDir.empty()) { 435 ModuleDepCollector = std::make_shared<ModuleDependencyCollector>( 436 DepOpts.ModuleDependencyOutputDir); 437 } 438 439 // If there is a module dep collector, register with other dep collectors 440 // and also (a) collect header maps and (b) TODO: input vfs overlay files. 441 if (ModuleDepCollector) { 442 addDependencyCollector(ModuleDepCollector); 443 collectHeaderMaps(PP->getHeaderSearchInfo(), ModuleDepCollector); 444 collectIncludePCH(*this, ModuleDepCollector); 445 collectVFSEntries(*this, ModuleDepCollector); 446 } 447 448 for (auto &Listener : DependencyCollectors) 449 Listener->attachToPreprocessor(*PP); 450 451 // Handle generating header include information, if requested. 452 if (DepOpts.ShowHeaderIncludes) 453 AttachHeaderIncludeGen(*PP, DepOpts); 454 if (!DepOpts.HeaderIncludeOutputFile.empty()) { 455 StringRef OutputPath = DepOpts.HeaderIncludeOutputFile; 456 if (OutputPath == "-") 457 OutputPath = ""; 458 AttachHeaderIncludeGen(*PP, DepOpts, 459 /*ShowAllHeaders=*/true, OutputPath, 460 /*ShowDepth=*/false); 461 } 462 463 if (DepOpts.ShowIncludesDest != ShowIncludesDestination::None) { 464 AttachHeaderIncludeGen(*PP, DepOpts, 465 /*ShowAllHeaders=*/true, /*OutputPath=*/"", 466 /*ShowDepth=*/true, /*MSStyle=*/true); 467 } 468 } 469 470 std::string CompilerInstance::getSpecificModuleCachePath() { 471 // Set up the module path, including the hash for the 472 // module-creation options. 473 SmallString<256> SpecificModuleCache(getHeaderSearchOpts().ModuleCachePath); 474 if (!SpecificModuleCache.empty() && !getHeaderSearchOpts().DisableModuleHash) 475 llvm::sys::path::append(SpecificModuleCache, 476 getInvocation().getModuleHash()); 477 return SpecificModuleCache.str(); 478 } 479 480 // ASTContext 481 482 void CompilerInstance::createASTContext() { 483 Preprocessor &PP = getPreprocessor(); 484 auto *Context = new ASTContext(getLangOpts(), PP.getSourceManager(), 485 PP.getIdentifierTable(), PP.getSelectorTable(), 486 PP.getBuiltinInfo()); 487 Context->InitBuiltinTypes(getTarget(), getAuxTarget()); 488 setASTContext(Context); 489 } 490 491 // ExternalASTSource 492 493 void CompilerInstance::createPCHExternalASTSource( 494 StringRef Path, bool DisablePCHValidation, bool AllowPCHWithCompilerErrors, 495 void *DeserializationListener, bool OwnDeserializationListener) { 496 bool Preamble = getPreprocessorOpts().PrecompiledPreambleBytes.first != 0; 497 TheASTReader = createPCHExternalASTSource( 498 Path, getHeaderSearchOpts().Sysroot, DisablePCHValidation, 499 AllowPCHWithCompilerErrors, getPreprocessor(), getModuleCache(), 500 getASTContext(), getPCHContainerReader(), 501 getFrontendOpts().ModuleFileExtensions, DependencyCollectors, 502 DeserializationListener, OwnDeserializationListener, Preamble, 503 getFrontendOpts().UseGlobalModuleIndex); 504 } 505 506 IntrusiveRefCntPtr<ASTReader> CompilerInstance::createPCHExternalASTSource( 507 StringRef Path, StringRef Sysroot, bool DisablePCHValidation, 508 bool AllowPCHWithCompilerErrors, Preprocessor &PP, 509 InMemoryModuleCache &ModuleCache, ASTContext &Context, 510 const PCHContainerReader &PCHContainerRdr, 511 ArrayRef<std::shared_ptr<ModuleFileExtension>> Extensions, 512 ArrayRef<std::shared_ptr<DependencyCollector>> DependencyCollectors, 513 void *DeserializationListener, bool OwnDeserializationListener, 514 bool Preamble, bool UseGlobalModuleIndex) { 515 HeaderSearchOptions &HSOpts = PP.getHeaderSearchInfo().getHeaderSearchOpts(); 516 517 IntrusiveRefCntPtr<ASTReader> Reader(new ASTReader( 518 PP, ModuleCache, &Context, PCHContainerRdr, Extensions, 519 Sysroot.empty() ? "" : Sysroot.data(), DisablePCHValidation, 520 AllowPCHWithCompilerErrors, /*AllowConfigurationMismatch*/ false, 521 HSOpts.ModulesValidateSystemHeaders, HSOpts.ValidateASTInputFilesContent, 522 UseGlobalModuleIndex)); 523 524 // We need the external source to be set up before we read the AST, because 525 // eagerly-deserialized declarations may use it. 526 Context.setExternalSource(Reader.get()); 527 528 Reader->setDeserializationListener( 529 static_cast<ASTDeserializationListener *>(DeserializationListener), 530 /*TakeOwnership=*/OwnDeserializationListener); 531 532 for (auto &Listener : DependencyCollectors) 533 Listener->attachToASTReader(*Reader); 534 535 switch (Reader->ReadAST(Path, 536 Preamble ? serialization::MK_Preamble 537 : serialization::MK_PCH, 538 SourceLocation(), 539 ASTReader::ARR_None)) { 540 case ASTReader::Success: 541 // Set the predefines buffer as suggested by the PCH reader. Typically, the 542 // predefines buffer will be empty. 543 PP.setPredefines(Reader->getSuggestedPredefines()); 544 return Reader; 545 546 case ASTReader::Failure: 547 // Unrecoverable failure: don't even try to process the input file. 548 break; 549 550 case ASTReader::Missing: 551 case ASTReader::OutOfDate: 552 case ASTReader::VersionMismatch: 553 case ASTReader::ConfigurationMismatch: 554 case ASTReader::HadErrors: 555 // No suitable PCH file could be found. Return an error. 556 break; 557 } 558 559 Context.setExternalSource(nullptr); 560 return nullptr; 561 } 562 563 // Code Completion 564 565 static bool EnableCodeCompletion(Preprocessor &PP, 566 StringRef Filename, 567 unsigned Line, 568 unsigned Column) { 569 // Tell the source manager to chop off the given file at a specific 570 // line and column. 571 auto Entry = PP.getFileManager().getFile(Filename); 572 if (!Entry) { 573 PP.getDiagnostics().Report(diag::err_fe_invalid_code_complete_file) 574 << Filename; 575 return true; 576 } 577 578 // Truncate the named file at the given line/column. 579 PP.SetCodeCompletionPoint(*Entry, Line, Column); 580 return false; 581 } 582 583 void CompilerInstance::createCodeCompletionConsumer() { 584 const ParsedSourceLocation &Loc = getFrontendOpts().CodeCompletionAt; 585 if (!CompletionConsumer) { 586 setCodeCompletionConsumer( 587 createCodeCompletionConsumer(getPreprocessor(), 588 Loc.FileName, Loc.Line, Loc.Column, 589 getFrontendOpts().CodeCompleteOpts, 590 llvm::outs())); 591 if (!CompletionConsumer) 592 return; 593 } else if (EnableCodeCompletion(getPreprocessor(), Loc.FileName, 594 Loc.Line, Loc.Column)) { 595 setCodeCompletionConsumer(nullptr); 596 return; 597 } 598 } 599 600 void CompilerInstance::createFrontendTimer() { 601 FrontendTimerGroup.reset( 602 new llvm::TimerGroup("frontend", "Clang front-end time report")); 603 FrontendTimer.reset( 604 new llvm::Timer("frontend", "Clang front-end timer", 605 *FrontendTimerGroup)); 606 } 607 608 CodeCompleteConsumer * 609 CompilerInstance::createCodeCompletionConsumer(Preprocessor &PP, 610 StringRef Filename, 611 unsigned Line, 612 unsigned Column, 613 const CodeCompleteOptions &Opts, 614 raw_ostream &OS) { 615 if (EnableCodeCompletion(PP, Filename, Line, Column)) 616 return nullptr; 617 618 // Set up the creation routine for code-completion. 619 return new PrintingCodeCompleteConsumer(Opts, OS); 620 } 621 622 void CompilerInstance::createSema(TranslationUnitKind TUKind, 623 CodeCompleteConsumer *CompletionConsumer) { 624 TheSema.reset(new Sema(getPreprocessor(), getASTContext(), getASTConsumer(), 625 TUKind, CompletionConsumer)); 626 // Attach the external sema source if there is any. 627 if (ExternalSemaSrc) { 628 TheSema->addExternalSource(ExternalSemaSrc.get()); 629 ExternalSemaSrc->InitializeSema(*TheSema); 630 } 631 } 632 633 // Output Files 634 635 void CompilerInstance::addOutputFile(OutputFile &&OutFile) { 636 OutputFiles.push_back(std::move(OutFile)); 637 } 638 639 void CompilerInstance::clearOutputFiles(bool EraseFiles) { 640 for (OutputFile &OF : OutputFiles) { 641 if (!OF.TempFilename.empty()) { 642 if (EraseFiles) { 643 llvm::sys::fs::remove(OF.TempFilename); 644 } else { 645 SmallString<128> NewOutFile(OF.Filename); 646 647 // If '-working-directory' was passed, the output filename should be 648 // relative to that. 649 FileMgr->FixupRelativePath(NewOutFile); 650 if (std::error_code ec = 651 llvm::sys::fs::rename(OF.TempFilename, NewOutFile)) { 652 getDiagnostics().Report(diag::err_unable_to_rename_temp) 653 << OF.TempFilename << OF.Filename << ec.message(); 654 655 llvm::sys::fs::remove(OF.TempFilename); 656 } 657 } 658 } else if (!OF.Filename.empty() && EraseFiles) 659 llvm::sys::fs::remove(OF.Filename); 660 } 661 OutputFiles.clear(); 662 if (DeleteBuiltModules) { 663 for (auto &Module : BuiltModules) 664 llvm::sys::fs::remove(Module.second); 665 BuiltModules.clear(); 666 } 667 NonSeekStream.reset(); 668 } 669 670 std::unique_ptr<raw_pwrite_stream> 671 CompilerInstance::createDefaultOutputFile(bool Binary, StringRef InFile, 672 StringRef Extension) { 673 return createOutputFile(getFrontendOpts().OutputFile, Binary, 674 /*RemoveFileOnSignal=*/true, InFile, Extension, 675 getFrontendOpts().UseTemporary); 676 } 677 678 std::unique_ptr<raw_pwrite_stream> CompilerInstance::createNullOutputFile() { 679 return std::make_unique<llvm::raw_null_ostream>(); 680 } 681 682 std::unique_ptr<raw_pwrite_stream> 683 CompilerInstance::createOutputFile(StringRef OutputPath, bool Binary, 684 bool RemoveFileOnSignal, StringRef InFile, 685 StringRef Extension, bool UseTemporary, 686 bool CreateMissingDirectories) { 687 std::string OutputPathName, TempPathName; 688 std::error_code EC; 689 std::unique_ptr<raw_pwrite_stream> OS = createOutputFile( 690 OutputPath, EC, Binary, RemoveFileOnSignal, InFile, Extension, 691 UseTemporary, CreateMissingDirectories, &OutputPathName, &TempPathName); 692 if (!OS) { 693 getDiagnostics().Report(diag::err_fe_unable_to_open_output) << OutputPath 694 << EC.message(); 695 return nullptr; 696 } 697 698 // Add the output file -- but don't try to remove "-", since this means we are 699 // using stdin. 700 addOutputFile( 701 OutputFile((OutputPathName != "-") ? OutputPathName : "", TempPathName)); 702 703 return OS; 704 } 705 706 std::unique_ptr<llvm::raw_pwrite_stream> CompilerInstance::createOutputFile( 707 StringRef OutputPath, std::error_code &Error, bool Binary, 708 bool RemoveFileOnSignal, StringRef InFile, StringRef Extension, 709 bool UseTemporary, bool CreateMissingDirectories, 710 std::string *ResultPathName, std::string *TempPathName) { 711 assert((!CreateMissingDirectories || UseTemporary) && 712 "CreateMissingDirectories is only allowed when using temporary files"); 713 714 std::string OutFile, TempFile; 715 if (!OutputPath.empty()) { 716 OutFile = OutputPath; 717 } else if (InFile == "-") { 718 OutFile = "-"; 719 } else if (!Extension.empty()) { 720 SmallString<128> Path(InFile); 721 llvm::sys::path::replace_extension(Path, Extension); 722 OutFile = Path.str(); 723 } else { 724 OutFile = "-"; 725 } 726 727 std::unique_ptr<llvm::raw_fd_ostream> OS; 728 std::string OSFile; 729 730 if (UseTemporary) { 731 if (OutFile == "-") 732 UseTemporary = false; 733 else { 734 llvm::sys::fs::file_status Status; 735 llvm::sys::fs::status(OutputPath, Status); 736 if (llvm::sys::fs::exists(Status)) { 737 // Fail early if we can't write to the final destination. 738 if (!llvm::sys::fs::can_write(OutputPath)) { 739 Error = make_error_code(llvm::errc::operation_not_permitted); 740 return nullptr; 741 } 742 743 // Don't use a temporary if the output is a special file. This handles 744 // things like '-o /dev/null' 745 if (!llvm::sys::fs::is_regular_file(Status)) 746 UseTemporary = false; 747 } 748 } 749 } 750 751 if (UseTemporary) { 752 // Create a temporary file. 753 // Insert -%%%%%%%% before the extension (if any), and because some tools 754 // (noticeable, clang's own GlobalModuleIndex.cpp) glob for build 755 // artifacts, also append .tmp. 756 StringRef OutputExtension = llvm::sys::path::extension(OutFile); 757 SmallString<128> TempPath = 758 StringRef(OutFile).drop_back(OutputExtension.size()); 759 TempPath += "-%%%%%%%%"; 760 TempPath += OutputExtension; 761 TempPath += ".tmp"; 762 int fd; 763 std::error_code EC = 764 llvm::sys::fs::createUniqueFile(TempPath, fd, TempPath); 765 766 if (CreateMissingDirectories && 767 EC == llvm::errc::no_such_file_or_directory) { 768 StringRef Parent = llvm::sys::path::parent_path(OutputPath); 769 EC = llvm::sys::fs::create_directories(Parent); 770 if (!EC) { 771 EC = llvm::sys::fs::createUniqueFile(TempPath, fd, TempPath); 772 } 773 } 774 775 if (!EC) { 776 OS.reset(new llvm::raw_fd_ostream(fd, /*shouldClose=*/true)); 777 OSFile = TempFile = TempPath.str(); 778 } 779 // If we failed to create the temporary, fallback to writing to the file 780 // directly. This handles the corner case where we cannot write to the 781 // directory, but can write to the file. 782 } 783 784 if (!OS) { 785 OSFile = OutFile; 786 OS.reset(new llvm::raw_fd_ostream( 787 OSFile, Error, 788 (Binary ? llvm::sys::fs::OF_None : llvm::sys::fs::OF_Text))); 789 if (Error) 790 return nullptr; 791 } 792 793 // Make sure the out stream file gets removed if we crash. 794 if (RemoveFileOnSignal) 795 llvm::sys::RemoveFileOnSignal(OSFile); 796 797 if (ResultPathName) 798 *ResultPathName = OutFile; 799 if (TempPathName) 800 *TempPathName = TempFile; 801 802 if (!Binary || OS->supportsSeeking()) 803 return std::move(OS); 804 805 auto B = std::make_unique<llvm::buffer_ostream>(*OS); 806 assert(!NonSeekStream); 807 NonSeekStream = std::move(OS); 808 return std::move(B); 809 } 810 811 // Initialization Utilities 812 813 bool CompilerInstance::InitializeSourceManager(const FrontendInputFile &Input){ 814 return InitializeSourceManager( 815 Input, getDiagnostics(), getFileManager(), getSourceManager(), 816 hasPreprocessor() ? &getPreprocessor().getHeaderSearchInfo() : nullptr, 817 getDependencyOutputOpts(), getFrontendOpts()); 818 } 819 820 // static 821 bool CompilerInstance::InitializeSourceManager( 822 const FrontendInputFile &Input, DiagnosticsEngine &Diags, 823 FileManager &FileMgr, SourceManager &SourceMgr, HeaderSearch *HS, 824 DependencyOutputOptions &DepOpts, const FrontendOptions &Opts) { 825 SrcMgr::CharacteristicKind Kind = 826 Input.getKind().getFormat() == InputKind::ModuleMap 827 ? Input.isSystem() ? SrcMgr::C_System_ModuleMap 828 : SrcMgr::C_User_ModuleMap 829 : Input.isSystem() ? SrcMgr::C_System : SrcMgr::C_User; 830 831 if (Input.isBuffer()) { 832 SourceMgr.setMainFileID(SourceMgr.createFileID(SourceManager::Unowned, 833 Input.getBuffer(), Kind)); 834 assert(SourceMgr.getMainFileID().isValid() && 835 "Couldn't establish MainFileID!"); 836 return true; 837 } 838 839 StringRef InputFile = Input.getFile(); 840 841 // Figure out where to get and map in the main file. 842 if (InputFile != "-") { 843 auto FileOrErr = FileMgr.getFileRef(InputFile, /*OpenFile=*/true); 844 if (!FileOrErr) { 845 // FIXME: include the error in the diagnostic. 846 consumeError(FileOrErr.takeError()); 847 Diags.Report(diag::err_fe_error_reading) << InputFile; 848 return false; 849 } 850 FileEntryRef File = *FileOrErr; 851 852 // The natural SourceManager infrastructure can't currently handle named 853 // pipes, but we would at least like to accept them for the main 854 // file. Detect them here, read them with the volatile flag so FileMgr will 855 // pick up the correct size, and simply override their contents as we do for 856 // STDIN. 857 if (File.getFileEntry().isNamedPipe()) { 858 auto MB = 859 FileMgr.getBufferForFile(&File.getFileEntry(), /*isVolatile=*/true); 860 if (MB) { 861 // Create a new virtual file that will have the correct size. 862 const FileEntry *FE = 863 FileMgr.getVirtualFile(InputFile, (*MB)->getBufferSize(), 0); 864 SourceMgr.overrideFileContents(FE, std::move(*MB)); 865 SourceMgr.setMainFileID( 866 SourceMgr.createFileID(FE, SourceLocation(), Kind)); 867 } else { 868 Diags.Report(diag::err_cannot_open_file) << InputFile 869 << MB.getError().message(); 870 return false; 871 } 872 } else { 873 SourceMgr.setMainFileID( 874 SourceMgr.createFileID(File, SourceLocation(), Kind)); 875 } 876 } else { 877 llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> SBOrErr = 878 llvm::MemoryBuffer::getSTDIN(); 879 if (std::error_code EC = SBOrErr.getError()) { 880 Diags.Report(diag::err_fe_error_reading_stdin) << EC.message(); 881 return false; 882 } 883 std::unique_ptr<llvm::MemoryBuffer> SB = std::move(SBOrErr.get()); 884 885 const FileEntry *File = FileMgr.getVirtualFile(SB->getBufferIdentifier(), 886 SB->getBufferSize(), 0); 887 SourceMgr.setMainFileID( 888 SourceMgr.createFileID(File, SourceLocation(), Kind)); 889 SourceMgr.overrideFileContents(File, std::move(SB)); 890 } 891 892 assert(SourceMgr.getMainFileID().isValid() && 893 "Couldn't establish MainFileID!"); 894 return true; 895 } 896 897 // High-Level Operations 898 899 bool CompilerInstance::ExecuteAction(FrontendAction &Act) { 900 assert(hasDiagnostics() && "Diagnostics engine is not initialized!"); 901 assert(!getFrontendOpts().ShowHelp && "Client must handle '-help'!"); 902 assert(!getFrontendOpts().ShowVersion && "Client must handle '-version'!"); 903 904 // Mark this point as the bottom of the stack if we don't have somewhere 905 // better. We generally expect frontend actions to be invoked with (nearly) 906 // DesiredStackSpace available. 907 noteBottomOfStack(); 908 909 raw_ostream &OS = getVerboseOutputStream(); 910 911 if (!Act.PrepareToExecute(*this)) 912 return false; 913 914 // Create the target instance. 915 setTarget(TargetInfo::CreateTargetInfo(getDiagnostics(), 916 getInvocation().TargetOpts)); 917 if (!hasTarget()) 918 return false; 919 920 // Create TargetInfo for the other side of CUDA/OpenMP/SYCL compilation. 921 if ((getLangOpts().CUDA || getLangOpts().OpenMPIsDevice || 922 getLangOpts().SYCLIsDevice) && 923 !getFrontendOpts().AuxTriple.empty()) { 924 auto TO = std::make_shared<TargetOptions>(); 925 TO->Triple = llvm::Triple::normalize(getFrontendOpts().AuxTriple); 926 TO->HostTriple = getTarget().getTriple().str(); 927 setAuxTarget(TargetInfo::CreateTargetInfo(getDiagnostics(), TO)); 928 } 929 930 if (!getTarget().hasStrictFP() && !getLangOpts().ExpStrictFP) { 931 if (getLangOpts().getFPRoundingMode() != 932 LangOptions::FPR_ToNearest) { 933 getDiagnostics().Report(diag::warn_fe_backend_unsupported_fp_rounding); 934 getLangOpts().setFPRoundingMode(LangOptions::FPR_ToNearest); 935 } 936 if (getLangOpts().getFPExceptionMode() != LangOptions::FPE_Ignore) { 937 getDiagnostics().Report(diag::warn_fe_backend_unsupported_fp_exceptions); 938 getLangOpts().setFPExceptionMode(LangOptions::FPE_Ignore); 939 } 940 // FIXME: can we disable FEnvAccess? 941 } 942 943 // Inform the target of the language options. 944 // 945 // FIXME: We shouldn't need to do this, the target should be immutable once 946 // created. This complexity should be lifted elsewhere. 947 getTarget().adjust(getLangOpts()); 948 949 // Adjust target options based on codegen options. 950 getTarget().adjustTargetOptions(getCodeGenOpts(), getTargetOpts()); 951 952 if (auto *Aux = getAuxTarget()) 953 getTarget().setAuxTarget(Aux); 954 955 // rewriter project will change target built-in bool type from its default. 956 if (getFrontendOpts().ProgramAction == frontend::RewriteObjC) 957 getTarget().noSignedCharForObjCBool(); 958 959 // Validate/process some options. 960 if (getHeaderSearchOpts().Verbose) 961 OS << "clang -cc1 version " CLANG_VERSION_STRING 962 << " based upon " << BACKEND_PACKAGE_STRING 963 << " default target " << llvm::sys::getDefaultTargetTriple() << "\n"; 964 965 if (getFrontendOpts().ShowTimers) 966 createFrontendTimer(); 967 968 if (getFrontendOpts().ShowStats || !getFrontendOpts().StatsFile.empty()) 969 llvm::EnableStatistics(false); 970 971 for (const FrontendInputFile &FIF : getFrontendOpts().Inputs) { 972 // Reset the ID tables if we are reusing the SourceManager and parsing 973 // regular files. 974 if (hasSourceManager() && !Act.isModelParsingAction()) 975 getSourceManager().clearIDTables(); 976 977 if (Act.BeginSourceFile(*this, FIF)) { 978 if (llvm::Error Err = Act.Execute()) { 979 consumeError(std::move(Err)); // FIXME this drops errors on the floor. 980 } 981 Act.EndSourceFile(); 982 } 983 } 984 985 // Notify the diagnostic client that all files were processed. 986 getDiagnostics().getClient()->finish(); 987 988 if (getDiagnosticOpts().ShowCarets) { 989 // We can have multiple diagnostics sharing one diagnostic client. 990 // Get the total number of warnings/errors from the client. 991 unsigned NumWarnings = getDiagnostics().getClient()->getNumWarnings(); 992 unsigned NumErrors = getDiagnostics().getClient()->getNumErrors(); 993 994 if (NumWarnings) 995 OS << NumWarnings << " warning" << (NumWarnings == 1 ? "" : "s"); 996 if (NumWarnings && NumErrors) 997 OS << " and "; 998 if (NumErrors) 999 OS << NumErrors << " error" << (NumErrors == 1 ? "" : "s"); 1000 if (NumWarnings || NumErrors) { 1001 OS << " generated"; 1002 if (getLangOpts().CUDA) { 1003 if (!getLangOpts().CUDAIsDevice) { 1004 OS << " when compiling for host"; 1005 } else { 1006 OS << " when compiling for " << getTargetOpts().CPU; 1007 } 1008 } 1009 OS << ".\n"; 1010 } 1011 } 1012 1013 if (getFrontendOpts().ShowStats) { 1014 if (hasFileManager()) { 1015 getFileManager().PrintStats(); 1016 OS << '\n'; 1017 } 1018 llvm::PrintStatistics(OS); 1019 } 1020 StringRef StatsFile = getFrontendOpts().StatsFile; 1021 if (!StatsFile.empty()) { 1022 std::error_code EC; 1023 auto StatS = std::make_unique<llvm::raw_fd_ostream>( 1024 StatsFile, EC, llvm::sys::fs::OF_Text); 1025 if (EC) { 1026 getDiagnostics().Report(diag::warn_fe_unable_to_open_stats_file) 1027 << StatsFile << EC.message(); 1028 } else { 1029 llvm::PrintStatisticsJSON(*StatS); 1030 } 1031 } 1032 1033 return !getDiagnostics().getClient()->getNumErrors(); 1034 } 1035 1036 /// Determine the appropriate source input kind based on language 1037 /// options. 1038 static Language getLanguageFromOptions(const LangOptions &LangOpts) { 1039 if (LangOpts.OpenCL) 1040 return Language::OpenCL; 1041 if (LangOpts.CUDA) 1042 return Language::CUDA; 1043 if (LangOpts.ObjC) 1044 return LangOpts.CPlusPlus ? Language::ObjCXX : Language::ObjC; 1045 return LangOpts.CPlusPlus ? Language::CXX : Language::C; 1046 } 1047 1048 /// Compile a module file for the given module, using the options 1049 /// provided by the importing compiler instance. Returns true if the module 1050 /// was built without errors. 1051 static bool 1052 compileModuleImpl(CompilerInstance &ImportingInstance, SourceLocation ImportLoc, 1053 StringRef ModuleName, FrontendInputFile Input, 1054 StringRef OriginalModuleMapFile, StringRef ModuleFileName, 1055 llvm::function_ref<void(CompilerInstance &)> PreBuildStep = 1056 [](CompilerInstance &) {}, 1057 llvm::function_ref<void(CompilerInstance &)> PostBuildStep = 1058 [](CompilerInstance &) {}) { 1059 llvm::TimeTraceScope TimeScope("Module Compile", ModuleName); 1060 1061 // Construct a compiler invocation for creating this module. 1062 auto Invocation = 1063 std::make_shared<CompilerInvocation>(ImportingInstance.getInvocation()); 1064 1065 PreprocessorOptions &PPOpts = Invocation->getPreprocessorOpts(); 1066 1067 // For any options that aren't intended to affect how a module is built, 1068 // reset them to their default values. 1069 Invocation->getLangOpts()->resetNonModularOptions(); 1070 PPOpts.resetNonModularOptions(); 1071 1072 // Remove any macro definitions that are explicitly ignored by the module. 1073 // They aren't supposed to affect how the module is built anyway. 1074 HeaderSearchOptions &HSOpts = Invocation->getHeaderSearchOpts(); 1075 PPOpts.Macros.erase( 1076 std::remove_if(PPOpts.Macros.begin(), PPOpts.Macros.end(), 1077 [&HSOpts](const std::pair<std::string, bool> &def) { 1078 StringRef MacroDef = def.first; 1079 return HSOpts.ModulesIgnoreMacros.count( 1080 llvm::CachedHashString(MacroDef.split('=').first)) > 0; 1081 }), 1082 PPOpts.Macros.end()); 1083 1084 // If the original compiler invocation had -fmodule-name, pass it through. 1085 Invocation->getLangOpts()->ModuleName = 1086 ImportingInstance.getInvocation().getLangOpts()->ModuleName; 1087 1088 // Note the name of the module we're building. 1089 Invocation->getLangOpts()->CurrentModule = ModuleName; 1090 1091 // Make sure that the failed-module structure has been allocated in 1092 // the importing instance, and propagate the pointer to the newly-created 1093 // instance. 1094 PreprocessorOptions &ImportingPPOpts 1095 = ImportingInstance.getInvocation().getPreprocessorOpts(); 1096 if (!ImportingPPOpts.FailedModules) 1097 ImportingPPOpts.FailedModules = 1098 std::make_shared<PreprocessorOptions::FailedModulesSet>(); 1099 PPOpts.FailedModules = ImportingPPOpts.FailedModules; 1100 1101 // If there is a module map file, build the module using the module map. 1102 // Set up the inputs/outputs so that we build the module from its umbrella 1103 // header. 1104 FrontendOptions &FrontendOpts = Invocation->getFrontendOpts(); 1105 FrontendOpts.OutputFile = ModuleFileName.str(); 1106 FrontendOpts.DisableFree = false; 1107 FrontendOpts.GenerateGlobalModuleIndex = false; 1108 FrontendOpts.BuildingImplicitModule = true; 1109 FrontendOpts.OriginalModuleMap = OriginalModuleMapFile; 1110 // Force implicitly-built modules to hash the content of the module file. 1111 HSOpts.ModulesHashContent = true; 1112 FrontendOpts.Inputs = {Input}; 1113 1114 // Don't free the remapped file buffers; they are owned by our caller. 1115 PPOpts.RetainRemappedFileBuffers = true; 1116 1117 Invocation->getDiagnosticOpts().VerifyDiagnostics = 0; 1118 assert(ImportingInstance.getInvocation().getModuleHash() == 1119 Invocation->getModuleHash() && "Module hash mismatch!"); 1120 1121 // Construct a compiler instance that will be used to actually create the 1122 // module. Since we're sharing an in-memory module cache, 1123 // CompilerInstance::CompilerInstance is responsible for finalizing the 1124 // buffers to prevent use-after-frees. 1125 CompilerInstance Instance(ImportingInstance.getPCHContainerOperations(), 1126 &ImportingInstance.getModuleCache()); 1127 auto &Inv = *Invocation; 1128 Instance.setInvocation(std::move(Invocation)); 1129 1130 Instance.createDiagnostics(new ForwardingDiagnosticConsumer( 1131 ImportingInstance.getDiagnosticClient()), 1132 /*ShouldOwnClient=*/true); 1133 1134 // Note that this module is part of the module build stack, so that we 1135 // can detect cycles in the module graph. 1136 Instance.setFileManager(&ImportingInstance.getFileManager()); 1137 Instance.createSourceManager(Instance.getFileManager()); 1138 SourceManager &SourceMgr = Instance.getSourceManager(); 1139 SourceMgr.setModuleBuildStack( 1140 ImportingInstance.getSourceManager().getModuleBuildStack()); 1141 SourceMgr.pushModuleBuildStack(ModuleName, 1142 FullSourceLoc(ImportLoc, ImportingInstance.getSourceManager())); 1143 1144 // If we're collecting module dependencies, we need to share a collector 1145 // between all of the module CompilerInstances. Other than that, we don't 1146 // want to produce any dependency output from the module build. 1147 Instance.setModuleDepCollector(ImportingInstance.getModuleDepCollector()); 1148 Inv.getDependencyOutputOpts() = DependencyOutputOptions(); 1149 1150 ImportingInstance.getDiagnostics().Report(ImportLoc, 1151 diag::remark_module_build) 1152 << ModuleName << ModuleFileName; 1153 1154 PreBuildStep(Instance); 1155 1156 // Execute the action to actually build the module in-place. Use a separate 1157 // thread so that we get a stack large enough. 1158 llvm::CrashRecoveryContext CRC; 1159 CRC.RunSafelyOnThread( 1160 [&]() { 1161 GenerateModuleFromModuleMapAction Action; 1162 Instance.ExecuteAction(Action); 1163 }, 1164 DesiredStackSize); 1165 1166 PostBuildStep(Instance); 1167 1168 ImportingInstance.getDiagnostics().Report(ImportLoc, 1169 diag::remark_module_build_done) 1170 << ModuleName; 1171 1172 // Delete the temporary module map file. 1173 // FIXME: Even though we're executing under crash protection, it would still 1174 // be nice to do this with RemoveFileOnSignal when we can. However, that 1175 // doesn't make sense for all clients, so clean this up manually. 1176 Instance.clearOutputFiles(/*EraseFiles=*/true); 1177 1178 return !Instance.getDiagnostics().hasErrorOccurred(); 1179 } 1180 1181 static const FileEntry *getPublicModuleMap(const FileEntry *File, 1182 FileManager &FileMgr) { 1183 StringRef Filename = llvm::sys::path::filename(File->getName()); 1184 SmallString<128> PublicFilename(File->getDir()->getName()); 1185 if (Filename == "module_private.map") 1186 llvm::sys::path::append(PublicFilename, "module.map"); 1187 else if (Filename == "module.private.modulemap") 1188 llvm::sys::path::append(PublicFilename, "module.modulemap"); 1189 else 1190 return nullptr; 1191 if (auto FE = FileMgr.getFile(PublicFilename)) 1192 return *FE; 1193 return nullptr; 1194 } 1195 1196 /// Compile a module file for the given module in a separate compiler instance, 1197 /// using the options provided by the importing compiler instance. Returns true 1198 /// if the module was built without errors. 1199 static bool compileModule(CompilerInstance &ImportingInstance, 1200 SourceLocation ImportLoc, Module *Module, 1201 StringRef ModuleFileName) { 1202 InputKind IK(getLanguageFromOptions(ImportingInstance.getLangOpts()), 1203 InputKind::ModuleMap); 1204 1205 // Get or create the module map that we'll use to build this module. 1206 ModuleMap &ModMap 1207 = ImportingInstance.getPreprocessor().getHeaderSearchInfo().getModuleMap(); 1208 bool Result; 1209 if (const FileEntry *ModuleMapFile = 1210 ModMap.getContainingModuleMapFile(Module)) { 1211 // Canonicalize compilation to start with the public module map. This is 1212 // vital for submodules declarations in the private module maps to be 1213 // correctly parsed when depending on a top level module in the public one. 1214 if (const FileEntry *PublicMMFile = getPublicModuleMap( 1215 ModuleMapFile, ImportingInstance.getFileManager())) 1216 ModuleMapFile = PublicMMFile; 1217 1218 // Use the module map where this module resides. 1219 Result = compileModuleImpl( 1220 ImportingInstance, ImportLoc, Module->getTopLevelModuleName(), 1221 FrontendInputFile(ModuleMapFile->getName(), IK, +Module->IsSystem), 1222 ModMap.getModuleMapFileForUniquing(Module)->getName(), 1223 ModuleFileName); 1224 } else { 1225 // FIXME: We only need to fake up an input file here as a way of 1226 // transporting the module's directory to the module map parser. We should 1227 // be able to do that more directly, and parse from a memory buffer without 1228 // inventing this file. 1229 SmallString<128> FakeModuleMapFile(Module->Directory->getName()); 1230 llvm::sys::path::append(FakeModuleMapFile, "__inferred_module.map"); 1231 1232 std::string InferredModuleMapContent; 1233 llvm::raw_string_ostream OS(InferredModuleMapContent); 1234 Module->print(OS); 1235 OS.flush(); 1236 1237 Result = compileModuleImpl( 1238 ImportingInstance, ImportLoc, Module->getTopLevelModuleName(), 1239 FrontendInputFile(FakeModuleMapFile, IK, +Module->IsSystem), 1240 ModMap.getModuleMapFileForUniquing(Module)->getName(), 1241 ModuleFileName, 1242 [&](CompilerInstance &Instance) { 1243 std::unique_ptr<llvm::MemoryBuffer> ModuleMapBuffer = 1244 llvm::MemoryBuffer::getMemBuffer(InferredModuleMapContent); 1245 ModuleMapFile = Instance.getFileManager().getVirtualFile( 1246 FakeModuleMapFile, InferredModuleMapContent.size(), 0); 1247 Instance.getSourceManager().overrideFileContents( 1248 ModuleMapFile, std::move(ModuleMapBuffer)); 1249 }); 1250 } 1251 1252 // We've rebuilt a module. If we're allowed to generate or update the global 1253 // module index, record that fact in the importing compiler instance. 1254 if (ImportingInstance.getFrontendOpts().GenerateGlobalModuleIndex) { 1255 ImportingInstance.setBuildGlobalModuleIndex(true); 1256 } 1257 1258 return Result; 1259 } 1260 1261 /// Compile a module in a separate compiler instance and read the AST, 1262 /// returning true if the module compiles without errors. 1263 /// 1264 /// Uses a lock file manager and exponential backoff to reduce the chances that 1265 /// multiple instances will compete to create the same module. On timeout, 1266 /// deletes the lock file in order to avoid deadlock from crashing processes or 1267 /// bugs in the lock file manager. 1268 static bool compileModuleAndReadAST(CompilerInstance &ImportingInstance, 1269 SourceLocation ImportLoc, 1270 SourceLocation ModuleNameLoc, 1271 Module *Module, StringRef ModuleFileName) { 1272 DiagnosticsEngine &Diags = ImportingInstance.getDiagnostics(); 1273 1274 auto diagnoseBuildFailure = [&] { 1275 Diags.Report(ModuleNameLoc, diag::err_module_not_built) 1276 << Module->Name << SourceRange(ImportLoc, ModuleNameLoc); 1277 }; 1278 1279 // FIXME: have LockFileManager return an error_code so that we can 1280 // avoid the mkdir when the directory already exists. 1281 StringRef Dir = llvm::sys::path::parent_path(ModuleFileName); 1282 llvm::sys::fs::create_directories(Dir); 1283 1284 while (1) { 1285 unsigned ModuleLoadCapabilities = ASTReader::ARR_Missing; 1286 llvm::LockFileManager Locked(ModuleFileName); 1287 switch (Locked) { 1288 case llvm::LockFileManager::LFS_Error: 1289 // ModuleCache takes care of correctness and locks are only necessary for 1290 // performance. Fallback to building the module in case of any lock 1291 // related errors. 1292 Diags.Report(ModuleNameLoc, diag::remark_module_lock_failure) 1293 << Module->Name << Locked.getErrorMessage(); 1294 // Clear out any potential leftover. 1295 Locked.unsafeRemoveLockFile(); 1296 LLVM_FALLTHROUGH; 1297 case llvm::LockFileManager::LFS_Owned: 1298 // We're responsible for building the module ourselves. 1299 if (!compileModule(ImportingInstance, ModuleNameLoc, Module, 1300 ModuleFileName)) { 1301 diagnoseBuildFailure(); 1302 return false; 1303 } 1304 break; 1305 1306 case llvm::LockFileManager::LFS_Shared: 1307 // Someone else is responsible for building the module. Wait for them to 1308 // finish. 1309 switch (Locked.waitForUnlock()) { 1310 case llvm::LockFileManager::Res_Success: 1311 ModuleLoadCapabilities |= ASTReader::ARR_OutOfDate; 1312 break; 1313 case llvm::LockFileManager::Res_OwnerDied: 1314 continue; // try again to get the lock. 1315 case llvm::LockFileManager::Res_Timeout: 1316 // Since ModuleCache takes care of correctness, we try waiting for 1317 // another process to complete the build so clang does not do it done 1318 // twice. If case of timeout, build it ourselves. 1319 Diags.Report(ModuleNameLoc, diag::remark_module_lock_timeout) 1320 << Module->Name; 1321 // Clear the lock file so that future invocations can make progress. 1322 Locked.unsafeRemoveLockFile(); 1323 continue; 1324 } 1325 break; 1326 } 1327 1328 // Try to read the module file, now that we've compiled it. 1329 ASTReader::ASTReadResult ReadResult = 1330 ImportingInstance.getASTReader()->ReadAST( 1331 ModuleFileName, serialization::MK_ImplicitModule, ImportLoc, 1332 ModuleLoadCapabilities); 1333 1334 if (ReadResult == ASTReader::OutOfDate && 1335 Locked == llvm::LockFileManager::LFS_Shared) { 1336 // The module may be out of date in the presence of file system races, 1337 // or if one of its imports depends on header search paths that are not 1338 // consistent with this ImportingInstance. Try again... 1339 continue; 1340 } else if (ReadResult == ASTReader::Missing) { 1341 diagnoseBuildFailure(); 1342 } else if (ReadResult != ASTReader::Success && 1343 !Diags.hasErrorOccurred()) { 1344 // The ASTReader didn't diagnose the error, so conservatively report it. 1345 diagnoseBuildFailure(); 1346 } 1347 return ReadResult == ASTReader::Success; 1348 } 1349 } 1350 1351 /// Diagnose differences between the current definition of the given 1352 /// configuration macro and the definition provided on the command line. 1353 static void checkConfigMacro(Preprocessor &PP, StringRef ConfigMacro, 1354 Module *Mod, SourceLocation ImportLoc) { 1355 IdentifierInfo *Id = PP.getIdentifierInfo(ConfigMacro); 1356 SourceManager &SourceMgr = PP.getSourceManager(); 1357 1358 // If this identifier has never had a macro definition, then it could 1359 // not have changed. 1360 if (!Id->hadMacroDefinition()) 1361 return; 1362 auto *LatestLocalMD = PP.getLocalMacroDirectiveHistory(Id); 1363 1364 // Find the macro definition from the command line. 1365 MacroInfo *CmdLineDefinition = nullptr; 1366 for (auto *MD = LatestLocalMD; MD; MD = MD->getPrevious()) { 1367 // We only care about the predefines buffer. 1368 FileID FID = SourceMgr.getFileID(MD->getLocation()); 1369 if (FID.isInvalid() || FID != PP.getPredefinesFileID()) 1370 continue; 1371 if (auto *DMD = dyn_cast<DefMacroDirective>(MD)) 1372 CmdLineDefinition = DMD->getMacroInfo(); 1373 break; 1374 } 1375 1376 auto *CurrentDefinition = PP.getMacroInfo(Id); 1377 if (CurrentDefinition == CmdLineDefinition) { 1378 // Macro matches. Nothing to do. 1379 } else if (!CurrentDefinition) { 1380 // This macro was defined on the command line, then #undef'd later. 1381 // Complain. 1382 PP.Diag(ImportLoc, diag::warn_module_config_macro_undef) 1383 << true << ConfigMacro << Mod->getFullModuleName(); 1384 auto LatestDef = LatestLocalMD->getDefinition(); 1385 assert(LatestDef.isUndefined() && 1386 "predefined macro went away with no #undef?"); 1387 PP.Diag(LatestDef.getUndefLocation(), diag::note_module_def_undef_here) 1388 << true; 1389 return; 1390 } else if (!CmdLineDefinition) { 1391 // There was no definition for this macro in the predefines buffer, 1392 // but there was a local definition. Complain. 1393 PP.Diag(ImportLoc, diag::warn_module_config_macro_undef) 1394 << false << ConfigMacro << Mod->getFullModuleName(); 1395 PP.Diag(CurrentDefinition->getDefinitionLoc(), 1396 diag::note_module_def_undef_here) 1397 << false; 1398 } else if (!CurrentDefinition->isIdenticalTo(*CmdLineDefinition, PP, 1399 /*Syntactically=*/true)) { 1400 // The macro definitions differ. 1401 PP.Diag(ImportLoc, diag::warn_module_config_macro_undef) 1402 << false << ConfigMacro << Mod->getFullModuleName(); 1403 PP.Diag(CurrentDefinition->getDefinitionLoc(), 1404 diag::note_module_def_undef_here) 1405 << false; 1406 } 1407 } 1408 1409 /// Write a new timestamp file with the given path. 1410 static void writeTimestampFile(StringRef TimestampFile) { 1411 std::error_code EC; 1412 llvm::raw_fd_ostream Out(TimestampFile.str(), EC, llvm::sys::fs::OF_None); 1413 } 1414 1415 /// Prune the module cache of modules that haven't been accessed in 1416 /// a long time. 1417 static void pruneModuleCache(const HeaderSearchOptions &HSOpts) { 1418 llvm::sys::fs::file_status StatBuf; 1419 llvm::SmallString<128> TimestampFile; 1420 TimestampFile = HSOpts.ModuleCachePath; 1421 assert(!TimestampFile.empty()); 1422 llvm::sys::path::append(TimestampFile, "modules.timestamp"); 1423 1424 // Try to stat() the timestamp file. 1425 if (std::error_code EC = llvm::sys::fs::status(TimestampFile, StatBuf)) { 1426 // If the timestamp file wasn't there, create one now. 1427 if (EC == std::errc::no_such_file_or_directory) { 1428 writeTimestampFile(TimestampFile); 1429 } 1430 return; 1431 } 1432 1433 // Check whether the time stamp is older than our pruning interval. 1434 // If not, do nothing. 1435 time_t TimeStampModTime = 1436 llvm::sys::toTimeT(StatBuf.getLastModificationTime()); 1437 time_t CurrentTime = time(nullptr); 1438 if (CurrentTime - TimeStampModTime <= time_t(HSOpts.ModuleCachePruneInterval)) 1439 return; 1440 1441 // Write a new timestamp file so that nobody else attempts to prune. 1442 // There is a benign race condition here, if two Clang instances happen to 1443 // notice at the same time that the timestamp is out-of-date. 1444 writeTimestampFile(TimestampFile); 1445 1446 // Walk the entire module cache, looking for unused module files and module 1447 // indices. 1448 std::error_code EC; 1449 SmallString<128> ModuleCachePathNative; 1450 llvm::sys::path::native(HSOpts.ModuleCachePath, ModuleCachePathNative); 1451 for (llvm::sys::fs::directory_iterator Dir(ModuleCachePathNative, EC), DirEnd; 1452 Dir != DirEnd && !EC; Dir.increment(EC)) { 1453 // If we don't have a directory, there's nothing to look into. 1454 if (!llvm::sys::fs::is_directory(Dir->path())) 1455 continue; 1456 1457 // Walk all of the files within this directory. 1458 for (llvm::sys::fs::directory_iterator File(Dir->path(), EC), FileEnd; 1459 File != FileEnd && !EC; File.increment(EC)) { 1460 // We only care about module and global module index files. 1461 StringRef Extension = llvm::sys::path::extension(File->path()); 1462 if (Extension != ".pcm" && Extension != ".timestamp" && 1463 llvm::sys::path::filename(File->path()) != "modules.idx") 1464 continue; 1465 1466 // Look at this file. If we can't stat it, there's nothing interesting 1467 // there. 1468 if (llvm::sys::fs::status(File->path(), StatBuf)) 1469 continue; 1470 1471 // If the file has been used recently enough, leave it there. 1472 time_t FileAccessTime = llvm::sys::toTimeT(StatBuf.getLastAccessedTime()); 1473 if (CurrentTime - FileAccessTime <= 1474 time_t(HSOpts.ModuleCachePruneAfter)) { 1475 continue; 1476 } 1477 1478 // Remove the file. 1479 llvm::sys::fs::remove(File->path()); 1480 1481 // Remove the timestamp file. 1482 std::string TimpestampFilename = File->path() + ".timestamp"; 1483 llvm::sys::fs::remove(TimpestampFilename); 1484 } 1485 1486 // If we removed all of the files in the directory, remove the directory 1487 // itself. 1488 if (llvm::sys::fs::directory_iterator(Dir->path(), EC) == 1489 llvm::sys::fs::directory_iterator() && !EC) 1490 llvm::sys::fs::remove(Dir->path()); 1491 } 1492 } 1493 1494 void CompilerInstance::createASTReader() { 1495 if (TheASTReader) 1496 return; 1497 1498 if (!hasASTContext()) 1499 createASTContext(); 1500 1501 // If we're implicitly building modules but not currently recursively 1502 // building a module, check whether we need to prune the module cache. 1503 if (getSourceManager().getModuleBuildStack().empty() && 1504 !getPreprocessor().getHeaderSearchInfo().getModuleCachePath().empty() && 1505 getHeaderSearchOpts().ModuleCachePruneInterval > 0 && 1506 getHeaderSearchOpts().ModuleCachePruneAfter > 0) { 1507 pruneModuleCache(getHeaderSearchOpts()); 1508 } 1509 1510 HeaderSearchOptions &HSOpts = getHeaderSearchOpts(); 1511 std::string Sysroot = HSOpts.Sysroot; 1512 const PreprocessorOptions &PPOpts = getPreprocessorOpts(); 1513 std::unique_ptr<llvm::Timer> ReadTimer; 1514 if (FrontendTimerGroup) 1515 ReadTimer = std::make_unique<llvm::Timer>("reading_modules", 1516 "Reading modules", 1517 *FrontendTimerGroup); 1518 TheASTReader = new ASTReader( 1519 getPreprocessor(), getModuleCache(), &getASTContext(), 1520 getPCHContainerReader(), getFrontendOpts().ModuleFileExtensions, 1521 Sysroot.empty() ? "" : Sysroot.c_str(), PPOpts.DisablePCHValidation, 1522 /*AllowASTWithCompilerErrors=*/false, 1523 /*AllowConfigurationMismatch=*/false, HSOpts.ModulesValidateSystemHeaders, 1524 HSOpts.ValidateASTInputFilesContent, 1525 getFrontendOpts().UseGlobalModuleIndex, std::move(ReadTimer)); 1526 if (hasASTConsumer()) { 1527 TheASTReader->setDeserializationListener( 1528 getASTConsumer().GetASTDeserializationListener()); 1529 getASTContext().setASTMutationListener( 1530 getASTConsumer().GetASTMutationListener()); 1531 } 1532 getASTContext().setExternalSource(TheASTReader); 1533 if (hasSema()) 1534 TheASTReader->InitializeSema(getSema()); 1535 if (hasASTConsumer()) 1536 TheASTReader->StartTranslationUnit(&getASTConsumer()); 1537 1538 for (auto &Listener : DependencyCollectors) 1539 Listener->attachToASTReader(*TheASTReader); 1540 } 1541 1542 bool CompilerInstance::loadModuleFile(StringRef FileName) { 1543 llvm::Timer Timer; 1544 if (FrontendTimerGroup) 1545 Timer.init("preloading." + FileName.str(), "Preloading " + FileName.str(), 1546 *FrontendTimerGroup); 1547 llvm::TimeRegion TimeLoading(FrontendTimerGroup ? &Timer : nullptr); 1548 1549 // Helper to recursively read the module names for all modules we're adding. 1550 // We mark these as known and redirect any attempt to load that module to 1551 // the files we were handed. 1552 struct ReadModuleNames : ASTReaderListener { 1553 CompilerInstance &CI; 1554 llvm::SmallVector<IdentifierInfo*, 8> LoadedModules; 1555 1556 ReadModuleNames(CompilerInstance &CI) : CI(CI) {} 1557 1558 void ReadModuleName(StringRef ModuleName) override { 1559 LoadedModules.push_back( 1560 CI.getPreprocessor().getIdentifierInfo(ModuleName)); 1561 } 1562 1563 void registerAll() { 1564 ModuleMap &MM = CI.getPreprocessor().getHeaderSearchInfo().getModuleMap(); 1565 for (auto *II : LoadedModules) 1566 MM.cacheModuleLoad(*II, MM.findModule(II->getName())); 1567 LoadedModules.clear(); 1568 } 1569 1570 void markAllUnavailable() { 1571 for (auto *II : LoadedModules) { 1572 if (Module *M = CI.getPreprocessor() 1573 .getHeaderSearchInfo() 1574 .getModuleMap() 1575 .findModule(II->getName())) { 1576 M->HasIncompatibleModuleFile = true; 1577 1578 // Mark module as available if the only reason it was unavailable 1579 // was missing headers. 1580 SmallVector<Module *, 2> Stack; 1581 Stack.push_back(M); 1582 while (!Stack.empty()) { 1583 Module *Current = Stack.pop_back_val(); 1584 if (Current->IsMissingRequirement) continue; 1585 Current->IsAvailable = true; 1586 Stack.insert(Stack.end(), 1587 Current->submodule_begin(), Current->submodule_end()); 1588 } 1589 } 1590 } 1591 LoadedModules.clear(); 1592 } 1593 }; 1594 1595 // If we don't already have an ASTReader, create one now. 1596 if (!TheASTReader) 1597 createASTReader(); 1598 1599 // If -Wmodule-file-config-mismatch is mapped as an error or worse, allow the 1600 // ASTReader to diagnose it, since it can produce better errors that we can. 1601 bool ConfigMismatchIsRecoverable = 1602 getDiagnostics().getDiagnosticLevel(diag::warn_module_config_mismatch, 1603 SourceLocation()) 1604 <= DiagnosticsEngine::Warning; 1605 1606 auto Listener = std::make_unique<ReadModuleNames>(*this); 1607 auto &ListenerRef = *Listener; 1608 ASTReader::ListenerScope ReadModuleNamesListener(*TheASTReader, 1609 std::move(Listener)); 1610 1611 // Try to load the module file. 1612 switch (TheASTReader->ReadAST( 1613 FileName, serialization::MK_ExplicitModule, SourceLocation(), 1614 ConfigMismatchIsRecoverable ? ASTReader::ARR_ConfigurationMismatch : 0)) { 1615 case ASTReader::Success: 1616 // We successfully loaded the module file; remember the set of provided 1617 // modules so that we don't try to load implicit modules for them. 1618 ListenerRef.registerAll(); 1619 return true; 1620 1621 case ASTReader::ConfigurationMismatch: 1622 // Ignore unusable module files. 1623 getDiagnostics().Report(SourceLocation(), diag::warn_module_config_mismatch) 1624 << FileName; 1625 // All modules provided by any files we tried and failed to load are now 1626 // unavailable; includes of those modules should now be handled textually. 1627 ListenerRef.markAllUnavailable(); 1628 return true; 1629 1630 default: 1631 return false; 1632 } 1633 } 1634 1635 namespace { 1636 enum ModuleSource { 1637 MS_ModuleNotFound, 1638 MS_ModuleCache, 1639 MS_PrebuiltModulePath, 1640 MS_ModuleBuildPragma 1641 }; 1642 } // end namespace 1643 1644 /// Select a source for loading the named module and compute the filename to 1645 /// load it from. 1646 static ModuleSource 1647 selectModuleSource(Module *M, StringRef ModuleName, std::string &ModuleFilename, 1648 const std::map<std::string, std::string> &BuiltModules, 1649 HeaderSearch &HS) { 1650 assert(ModuleFilename.empty() && "Already has a module source?"); 1651 1652 // Check to see if the module has been built as part of this compilation 1653 // via a module build pragma. 1654 auto BuiltModuleIt = BuiltModules.find(ModuleName); 1655 if (BuiltModuleIt != BuiltModules.end()) { 1656 ModuleFilename = BuiltModuleIt->second; 1657 return MS_ModuleBuildPragma; 1658 } 1659 1660 // Try to load the module from the prebuilt module path. 1661 const HeaderSearchOptions &HSOpts = HS.getHeaderSearchOpts(); 1662 if (!HSOpts.PrebuiltModuleFiles.empty() || 1663 !HSOpts.PrebuiltModulePaths.empty()) { 1664 ModuleFilename = HS.getPrebuiltModuleFileName(ModuleName); 1665 if (!ModuleFilename.empty()) 1666 return MS_PrebuiltModulePath; 1667 } 1668 1669 // Try to load the module from the module cache. 1670 if (M) { 1671 ModuleFilename = HS.getCachedModuleFileName(M); 1672 return MS_ModuleCache; 1673 } 1674 1675 return MS_ModuleNotFound; 1676 } 1677 1678 ModuleLoadResult CompilerInstance::findOrCompileModuleAndReadAST( 1679 StringRef ModuleName, SourceLocation ImportLoc, 1680 SourceLocation ModuleNameLoc, bool IsInclusionDirective) { 1681 // Search for a module with the given name. 1682 HeaderSearch &HS = PP->getHeaderSearchInfo(); 1683 Module *M = HS.lookupModule(ModuleName, true, !IsInclusionDirective); 1684 1685 // Select the source and filename for loading the named module. 1686 std::string ModuleFilename; 1687 ModuleSource Source = 1688 selectModuleSource(M, ModuleName, ModuleFilename, BuiltModules, HS); 1689 if (Source == MS_ModuleNotFound) { 1690 // We can't find a module, error out here. 1691 getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_found) 1692 << ModuleName << SourceRange(ImportLoc, ModuleNameLoc); 1693 ModuleBuildFailed = true; 1694 // FIXME: Why is this not cached? 1695 return ModuleLoadResult::OtherUncachedFailure; 1696 } 1697 if (ModuleFilename.empty()) { 1698 if (M && M->HasIncompatibleModuleFile) { 1699 // We tried and failed to load a module file for this module. Fall 1700 // back to textual inclusion for its headers. 1701 return ModuleLoadResult::ConfigMismatch; 1702 } 1703 1704 getDiagnostics().Report(ModuleNameLoc, diag::err_module_build_disabled) 1705 << ModuleName; 1706 ModuleBuildFailed = true; 1707 // FIXME: Why is this not cached? 1708 return ModuleLoadResult::OtherUncachedFailure; 1709 } 1710 1711 // Create an ASTReader on demand. 1712 if (!getASTReader()) 1713 createASTReader(); 1714 1715 // Time how long it takes to load the module. 1716 llvm::Timer Timer; 1717 if (FrontendTimerGroup) 1718 Timer.init("loading." + ModuleFilename, "Loading " + ModuleFilename, 1719 *FrontendTimerGroup); 1720 llvm::TimeRegion TimeLoading(FrontendTimerGroup ? &Timer : nullptr); 1721 llvm::TimeTraceScope TimeScope("Module Load", ModuleName); 1722 1723 // Try to load the module file. If we are not trying to load from the 1724 // module cache, we don't know how to rebuild modules. 1725 unsigned ARRFlags = Source == MS_ModuleCache 1726 ? ASTReader::ARR_OutOfDate | ASTReader::ARR_Missing 1727 : Source == MS_PrebuiltModulePath 1728 ? 0 1729 : ASTReader::ARR_ConfigurationMismatch; 1730 switch (getASTReader()->ReadAST(ModuleFilename, 1731 Source == MS_PrebuiltModulePath 1732 ? serialization::MK_PrebuiltModule 1733 : Source == MS_ModuleBuildPragma 1734 ? serialization::MK_ExplicitModule 1735 : serialization::MK_ImplicitModule, 1736 ImportLoc, ARRFlags)) { 1737 case ASTReader::Success: { 1738 if (M) 1739 return M; 1740 assert(Source != MS_ModuleCache && 1741 "missing module, but file loaded from cache"); 1742 1743 // A prebuilt module is indexed as a ModuleFile; the Module does not exist 1744 // until the first call to ReadAST. Look it up now. 1745 M = HS.lookupModule(ModuleName, true, !IsInclusionDirective); 1746 1747 // Check whether M refers to the file in the prebuilt module path. 1748 if (M && M->getASTFile()) 1749 if (auto ModuleFile = FileMgr->getFile(ModuleFilename)) 1750 if (*ModuleFile == M->getASTFile()) 1751 return M; 1752 1753 ModuleBuildFailed = true; 1754 getDiagnostics().Report(ModuleNameLoc, diag::err_module_prebuilt) 1755 << ModuleName; 1756 return ModuleLoadResult(); 1757 } 1758 1759 case ASTReader::OutOfDate: 1760 case ASTReader::Missing: 1761 // The most interesting case. 1762 break; 1763 1764 case ASTReader::ConfigurationMismatch: 1765 if (Source == MS_PrebuiltModulePath) 1766 // FIXME: We shouldn't be setting HadFatalFailure below if we only 1767 // produce a warning here! 1768 getDiagnostics().Report(SourceLocation(), 1769 diag::warn_module_config_mismatch) 1770 << ModuleFilename; 1771 // Fall through to error out. 1772 LLVM_FALLTHROUGH; 1773 case ASTReader::VersionMismatch: 1774 case ASTReader::HadErrors: 1775 // FIXME: Should this set ModuleBuildFailed = true? 1776 ModuleLoader::HadFatalFailure = true; 1777 // FIXME: The ASTReader will already have complained, but can we shoehorn 1778 // that diagnostic information into a more useful form? 1779 return ModuleLoadResult(); 1780 1781 case ASTReader::Failure: 1782 // FIXME: Should this set ModuleBuildFailed = true? 1783 ModuleLoader::HadFatalFailure = true; 1784 return ModuleLoadResult(); 1785 } 1786 1787 // ReadAST returned Missing or OutOfDate. 1788 if (Source != MS_ModuleCache) { 1789 // We don't know the desired configuration for this module and don't 1790 // necessarily even have a module map. Since ReadAST already produces 1791 // diagnostics for these two cases, we simply error out here. 1792 ModuleBuildFailed = true; 1793 return ModuleLoadResult(); 1794 } 1795 1796 // The module file is missing or out-of-date. Build it. 1797 assert(M && "missing module, but trying to compile for cache"); 1798 1799 // Check whether there is a cycle in the module graph. 1800 ModuleBuildStack ModPath = getSourceManager().getModuleBuildStack(); 1801 ModuleBuildStack::iterator Pos = ModPath.begin(), PosEnd = ModPath.end(); 1802 for (; Pos != PosEnd; ++Pos) { 1803 if (Pos->first == ModuleName) 1804 break; 1805 } 1806 1807 if (Pos != PosEnd) { 1808 SmallString<256> CyclePath; 1809 for (; Pos != PosEnd; ++Pos) { 1810 CyclePath += Pos->first; 1811 CyclePath += " -> "; 1812 } 1813 CyclePath += ModuleName; 1814 1815 getDiagnostics().Report(ModuleNameLoc, diag::err_module_cycle) 1816 << ModuleName << CyclePath; 1817 // FIXME: Should this set ModuleBuildFailed = true? 1818 // FIXME: Why is this not cached? 1819 return ModuleLoadResult::OtherUncachedFailure; 1820 } 1821 1822 // Check whether we have already attempted to build this module (but 1823 // failed). 1824 if (getPreprocessorOpts().FailedModules && 1825 getPreprocessorOpts().FailedModules->hasAlreadyFailed(ModuleName)) { 1826 getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_built) 1827 << ModuleName << SourceRange(ImportLoc, ModuleNameLoc); 1828 ModuleBuildFailed = true; 1829 // FIXME: Why is this not cached? 1830 return ModuleLoadResult::OtherUncachedFailure; 1831 } 1832 1833 // Try to compile and then read the AST. 1834 if (!compileModuleAndReadAST(*this, ImportLoc, ModuleNameLoc, M, 1835 ModuleFilename)) { 1836 assert(getDiagnostics().hasErrorOccurred() && 1837 "undiagnosed error in compileModuleAndReadAST"); 1838 if (getPreprocessorOpts().FailedModules) 1839 getPreprocessorOpts().FailedModules->addFailed(ModuleName); 1840 ModuleBuildFailed = true; 1841 // FIXME: Why is this not cached? 1842 return ModuleLoadResult::OtherUncachedFailure; 1843 } 1844 1845 // Okay, we've rebuilt and now loaded the module. 1846 return M; 1847 } 1848 1849 ModuleLoadResult 1850 CompilerInstance::loadModule(SourceLocation ImportLoc, 1851 ModuleIdPath Path, 1852 Module::NameVisibilityKind Visibility, 1853 bool IsInclusionDirective) { 1854 // Determine what file we're searching from. 1855 StringRef ModuleName = Path[0].first->getName(); 1856 SourceLocation ModuleNameLoc = Path[0].second; 1857 1858 // If we've already handled this import, just return the cached result. 1859 // This one-element cache is important to eliminate redundant diagnostics 1860 // when both the preprocessor and parser see the same import declaration. 1861 if (ImportLoc.isValid() && LastModuleImportLoc == ImportLoc) { 1862 // Make the named module visible. 1863 if (LastModuleImportResult && ModuleName != getLangOpts().CurrentModule) 1864 TheASTReader->makeModuleVisible(LastModuleImportResult, Visibility, 1865 ImportLoc); 1866 return LastModuleImportResult; 1867 } 1868 1869 // If we don't already have information on this module, load the module now. 1870 Module *Module = nullptr; 1871 ModuleMap &MM = getPreprocessor().getHeaderSearchInfo().getModuleMap(); 1872 if (auto MaybeModule = MM.getCachedModuleLoad(*Path[0].first)) { 1873 // Use the cached result, which may be nullptr. 1874 Module = *MaybeModule; 1875 } else if (ModuleName == getLangOpts().CurrentModule) { 1876 // This is the module we're building. 1877 Module = PP->getHeaderSearchInfo().lookupModule( 1878 ModuleName, /*AllowSearch*/ true, 1879 /*AllowExtraModuleMapSearch*/ !IsInclusionDirective); 1880 /// FIXME: perhaps we should (a) look for a module using the module name 1881 // to file map (PrebuiltModuleFiles) and (b) diagnose if still not found? 1882 //if (Module == nullptr) { 1883 // getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_found) 1884 // << ModuleName; 1885 // ModuleBuildFailed = true; 1886 // return ModuleLoadResult(); 1887 //} 1888 MM.cacheModuleLoad(*Path[0].first, Module); 1889 } else { 1890 ModuleLoadResult Result = findOrCompileModuleAndReadAST( 1891 ModuleName, ImportLoc, ModuleNameLoc, IsInclusionDirective); 1892 // FIXME: Can we pull 'ModuleBuildFailed = true' out of the return 1893 // sequences for findOrCompileModuleAndReadAST and do it here (as long as 1894 // the result is not a config mismatch)? See FIXMEs there. 1895 if (!Result.isNormal()) 1896 return Result; 1897 Module = Result; 1898 MM.cacheModuleLoad(*Path[0].first, Module); 1899 if (!Module) 1900 return Module; 1901 } 1902 1903 // If we never found the module, fail. Otherwise, verify the module and link 1904 // it up. 1905 if (!Module) 1906 return ModuleLoadResult(); 1907 1908 // Verify that the rest of the module path actually corresponds to 1909 // a submodule. 1910 bool MapPrivateSubModToTopLevel = false; 1911 if (Path.size() > 1) { 1912 for (unsigned I = 1, N = Path.size(); I != N; ++I) { 1913 StringRef Name = Path[I].first->getName(); 1914 clang::Module *Sub = Module->findSubmodule(Name); 1915 1916 // If the user is requesting Foo.Private and it doesn't exist, try to 1917 // match Foo_Private and emit a warning asking for the user to write 1918 // @import Foo_Private instead. FIXME: remove this when existing clients 1919 // migrate off of Foo.Private syntax. 1920 if (!Sub && PP->getLangOpts().ImplicitModules && Name == "Private" && 1921 Module == Module->getTopLevelModule()) { 1922 SmallString<128> PrivateModule(Module->Name); 1923 PrivateModule.append("_Private"); 1924 1925 SmallVector<std::pair<IdentifierInfo *, SourceLocation>, 2> PrivPath; 1926 auto &II = PP->getIdentifierTable().get( 1927 PrivateModule, PP->getIdentifierInfo(Module->Name)->getTokenID()); 1928 PrivPath.push_back(std::make_pair(&II, Path[0].second)); 1929 1930 if (PP->getHeaderSearchInfo().lookupModule(PrivateModule, true, 1931 !IsInclusionDirective)) 1932 Sub = 1933 loadModule(ImportLoc, PrivPath, Visibility, IsInclusionDirective); 1934 if (Sub) { 1935 MapPrivateSubModToTopLevel = true; 1936 if (!getDiagnostics().isIgnored( 1937 diag::warn_no_priv_submodule_use_toplevel, ImportLoc)) { 1938 getDiagnostics().Report(Path[I].second, 1939 diag::warn_no_priv_submodule_use_toplevel) 1940 << Path[I].first << Module->getFullModuleName() << PrivateModule 1941 << SourceRange(Path[0].second, Path[I].second) 1942 << FixItHint::CreateReplacement(SourceRange(Path[0].second), 1943 PrivateModule); 1944 getDiagnostics().Report(Sub->DefinitionLoc, 1945 diag::note_private_top_level_defined); 1946 } 1947 } 1948 } 1949 1950 if (!Sub) { 1951 // Attempt to perform typo correction to find a module name that works. 1952 SmallVector<StringRef, 2> Best; 1953 unsigned BestEditDistance = (std::numeric_limits<unsigned>::max)(); 1954 1955 for (clang::Module::submodule_iterator J = Module->submodule_begin(), 1956 JEnd = Module->submodule_end(); 1957 J != JEnd; ++J) { 1958 unsigned ED = Name.edit_distance((*J)->Name, 1959 /*AllowReplacements=*/true, 1960 BestEditDistance); 1961 if (ED <= BestEditDistance) { 1962 if (ED < BestEditDistance) { 1963 Best.clear(); 1964 BestEditDistance = ED; 1965 } 1966 1967 Best.push_back((*J)->Name); 1968 } 1969 } 1970 1971 // If there was a clear winner, user it. 1972 if (Best.size() == 1) { 1973 getDiagnostics().Report(Path[I].second, 1974 diag::err_no_submodule_suggest) 1975 << Path[I].first << Module->getFullModuleName() << Best[0] 1976 << SourceRange(Path[0].second, Path[I-1].second) 1977 << FixItHint::CreateReplacement(SourceRange(Path[I].second), 1978 Best[0]); 1979 1980 Sub = Module->findSubmodule(Best[0]); 1981 } 1982 } 1983 1984 if (!Sub) { 1985 // No submodule by this name. Complain, and don't look for further 1986 // submodules. 1987 getDiagnostics().Report(Path[I].second, diag::err_no_submodule) 1988 << Path[I].first << Module->getFullModuleName() 1989 << SourceRange(Path[0].second, Path[I-1].second); 1990 break; 1991 } 1992 1993 Module = Sub; 1994 } 1995 } 1996 1997 // Make the named module visible, if it's not already part of the module 1998 // we are parsing. 1999 if (ModuleName != getLangOpts().CurrentModule) { 2000 if (!Module->IsFromModuleFile && !MapPrivateSubModToTopLevel) { 2001 // We have an umbrella header or directory that doesn't actually include 2002 // all of the headers within the directory it covers. Complain about 2003 // this missing submodule and recover by forgetting that we ever saw 2004 // this submodule. 2005 // FIXME: Should we detect this at module load time? It seems fairly 2006 // expensive (and rare). 2007 getDiagnostics().Report(ImportLoc, diag::warn_missing_submodule) 2008 << Module->getFullModuleName() 2009 << SourceRange(Path.front().second, Path.back().second); 2010 2011 return ModuleLoadResult::MissingExpected; 2012 } 2013 2014 // Check whether this module is available. 2015 if (Preprocessor::checkModuleIsAvailable(getLangOpts(), getTarget(), 2016 getDiagnostics(), Module)) { 2017 getDiagnostics().Report(ImportLoc, diag::note_module_import_here) 2018 << SourceRange(Path.front().second, Path.back().second); 2019 LastModuleImportLoc = ImportLoc; 2020 LastModuleImportResult = ModuleLoadResult(); 2021 return ModuleLoadResult(); 2022 } 2023 2024 TheASTReader->makeModuleVisible(Module, Visibility, ImportLoc); 2025 } 2026 2027 // Check for any configuration macros that have changed. 2028 clang::Module *TopModule = Module->getTopLevelModule(); 2029 for (unsigned I = 0, N = TopModule->ConfigMacros.size(); I != N; ++I) { 2030 checkConfigMacro(getPreprocessor(), TopModule->ConfigMacros[I], 2031 Module, ImportLoc); 2032 } 2033 2034 // Resolve any remaining module using export_as for this one. 2035 getPreprocessor() 2036 .getHeaderSearchInfo() 2037 .getModuleMap() 2038 .resolveLinkAsDependencies(TopModule); 2039 2040 LastModuleImportLoc = ImportLoc; 2041 LastModuleImportResult = ModuleLoadResult(Module); 2042 return LastModuleImportResult; 2043 } 2044 2045 void CompilerInstance::createModuleFromSource(SourceLocation ImportLoc, 2046 StringRef ModuleName, 2047 StringRef Source) { 2048 // Avoid creating filenames with special characters. 2049 SmallString<128> CleanModuleName(ModuleName); 2050 for (auto &C : CleanModuleName) 2051 if (!isAlphanumeric(C)) 2052 C = '_'; 2053 2054 // FIXME: Using a randomized filename here means that our intermediate .pcm 2055 // output is nondeterministic (as .pcm files refer to each other by name). 2056 // Can this affect the output in any way? 2057 SmallString<128> ModuleFileName; 2058 if (std::error_code EC = llvm::sys::fs::createTemporaryFile( 2059 CleanModuleName, "pcm", ModuleFileName)) { 2060 getDiagnostics().Report(ImportLoc, diag::err_fe_unable_to_open_output) 2061 << ModuleFileName << EC.message(); 2062 return; 2063 } 2064 std::string ModuleMapFileName = (CleanModuleName + ".map").str(); 2065 2066 FrontendInputFile Input( 2067 ModuleMapFileName, 2068 InputKind(getLanguageFromOptions(*Invocation->getLangOpts()), 2069 InputKind::ModuleMap, /*Preprocessed*/true)); 2070 2071 std::string NullTerminatedSource(Source.str()); 2072 2073 auto PreBuildStep = [&](CompilerInstance &Other) { 2074 // Create a virtual file containing our desired source. 2075 // FIXME: We shouldn't need to do this. 2076 const FileEntry *ModuleMapFile = Other.getFileManager().getVirtualFile( 2077 ModuleMapFileName, NullTerminatedSource.size(), 0); 2078 Other.getSourceManager().overrideFileContents( 2079 ModuleMapFile, 2080 llvm::MemoryBuffer::getMemBuffer(NullTerminatedSource.c_str())); 2081 2082 Other.BuiltModules = std::move(BuiltModules); 2083 Other.DeleteBuiltModules = false; 2084 }; 2085 2086 auto PostBuildStep = [this](CompilerInstance &Other) { 2087 BuiltModules = std::move(Other.BuiltModules); 2088 }; 2089 2090 // Build the module, inheriting any modules that we've built locally. 2091 if (compileModuleImpl(*this, ImportLoc, ModuleName, Input, StringRef(), 2092 ModuleFileName, PreBuildStep, PostBuildStep)) { 2093 BuiltModules[ModuleName] = ModuleFileName.str(); 2094 llvm::sys::RemoveFileOnSignal(ModuleFileName); 2095 } 2096 } 2097 2098 void CompilerInstance::makeModuleVisible(Module *Mod, 2099 Module::NameVisibilityKind Visibility, 2100 SourceLocation ImportLoc) { 2101 if (!TheASTReader) 2102 createASTReader(); 2103 if (!TheASTReader) 2104 return; 2105 2106 TheASTReader->makeModuleVisible(Mod, Visibility, ImportLoc); 2107 } 2108 2109 GlobalModuleIndex *CompilerInstance::loadGlobalModuleIndex( 2110 SourceLocation TriggerLoc) { 2111 if (getPreprocessor().getHeaderSearchInfo().getModuleCachePath().empty()) 2112 return nullptr; 2113 if (!TheASTReader) 2114 createASTReader(); 2115 // Can't do anything if we don't have the module manager. 2116 if (!TheASTReader) 2117 return nullptr; 2118 // Get an existing global index. This loads it if not already 2119 // loaded. 2120 TheASTReader->loadGlobalIndex(); 2121 GlobalModuleIndex *GlobalIndex = TheASTReader->getGlobalIndex(); 2122 // If the global index doesn't exist, create it. 2123 if (!GlobalIndex && shouldBuildGlobalModuleIndex() && hasFileManager() && 2124 hasPreprocessor()) { 2125 llvm::sys::fs::create_directories( 2126 getPreprocessor().getHeaderSearchInfo().getModuleCachePath()); 2127 if (llvm::Error Err = GlobalModuleIndex::writeIndex( 2128 getFileManager(), getPCHContainerReader(), 2129 getPreprocessor().getHeaderSearchInfo().getModuleCachePath())) { 2130 // FIXME this drops the error on the floor. This code is only used for 2131 // typo correction and drops more than just this one source of errors 2132 // (such as the directory creation failure above). It should handle the 2133 // error. 2134 consumeError(std::move(Err)); 2135 return nullptr; 2136 } 2137 TheASTReader->resetForReload(); 2138 TheASTReader->loadGlobalIndex(); 2139 GlobalIndex = TheASTReader->getGlobalIndex(); 2140 } 2141 // For finding modules needing to be imported for fixit messages, 2142 // we need to make the global index cover all modules, so we do that here. 2143 if (!HaveFullGlobalModuleIndex && GlobalIndex && !buildingModule()) { 2144 ModuleMap &MMap = getPreprocessor().getHeaderSearchInfo().getModuleMap(); 2145 bool RecreateIndex = false; 2146 for (ModuleMap::module_iterator I = MMap.module_begin(), 2147 E = MMap.module_end(); I != E; ++I) { 2148 Module *TheModule = I->second; 2149 const FileEntry *Entry = TheModule->getASTFile(); 2150 if (!Entry) { 2151 SmallVector<std::pair<IdentifierInfo *, SourceLocation>, 2> Path; 2152 Path.push_back(std::make_pair( 2153 getPreprocessor().getIdentifierInfo(TheModule->Name), TriggerLoc)); 2154 std::reverse(Path.begin(), Path.end()); 2155 // Load a module as hidden. This also adds it to the global index. 2156 loadModule(TheModule->DefinitionLoc, Path, Module::Hidden, false); 2157 RecreateIndex = true; 2158 } 2159 } 2160 if (RecreateIndex) { 2161 if (llvm::Error Err = GlobalModuleIndex::writeIndex( 2162 getFileManager(), getPCHContainerReader(), 2163 getPreprocessor().getHeaderSearchInfo().getModuleCachePath())) { 2164 // FIXME As above, this drops the error on the floor. 2165 consumeError(std::move(Err)); 2166 return nullptr; 2167 } 2168 TheASTReader->resetForReload(); 2169 TheASTReader->loadGlobalIndex(); 2170 GlobalIndex = TheASTReader->getGlobalIndex(); 2171 } 2172 HaveFullGlobalModuleIndex = true; 2173 } 2174 return GlobalIndex; 2175 } 2176 2177 // Check global module index for missing imports. 2178 bool 2179 CompilerInstance::lookupMissingImports(StringRef Name, 2180 SourceLocation TriggerLoc) { 2181 // Look for the symbol in non-imported modules, but only if an error 2182 // actually occurred. 2183 if (!buildingModule()) { 2184 // Load global module index, or retrieve a previously loaded one. 2185 GlobalModuleIndex *GlobalIndex = loadGlobalModuleIndex( 2186 TriggerLoc); 2187 2188 // Only if we have a global index. 2189 if (GlobalIndex) { 2190 GlobalModuleIndex::HitSet FoundModules; 2191 2192 // Find the modules that reference the identifier. 2193 // Note that this only finds top-level modules. 2194 // We'll let diagnoseTypo find the actual declaration module. 2195 if (GlobalIndex->lookupIdentifier(Name, FoundModules)) 2196 return true; 2197 } 2198 } 2199 2200 return false; 2201 } 2202 void CompilerInstance::resetAndLeakSema() { llvm::BuryPointer(takeSema()); } 2203 2204 void CompilerInstance::setExternalSemaSource( 2205 IntrusiveRefCntPtr<ExternalSemaSource> ESS) { 2206 ExternalSemaSrc = std::move(ESS); 2207 } 2208