1 //===--- CompilerInstance.cpp ---------------------------------------------===// 2 // 3 // The LLVM Compiler Infrastructure 4 // 5 // This file is distributed under the University of Illinois Open Source 6 // License. See LICENSE.TXT for details. 7 // 8 //===----------------------------------------------------------------------===// 9 10 #include "clang/Frontend/CompilerInstance.h" 11 #include "clang/AST/ASTConsumer.h" 12 #include "clang/AST/ASTContext.h" 13 #include "clang/AST/Decl.h" 14 #include "clang/Basic/Diagnostic.h" 15 #include "clang/Basic/FileManager.h" 16 #include "clang/Basic/SourceManager.h" 17 #include "clang/Basic/TargetInfo.h" 18 #include "clang/Basic/Version.h" 19 #include "clang/Config/config.h" 20 #include "clang/Frontend/ChainedDiagnosticConsumer.h" 21 #include "clang/Frontend/FrontendAction.h" 22 #include "clang/Frontend/FrontendActions.h" 23 #include "clang/Frontend/FrontendDiagnostic.h" 24 #include "clang/Frontend/LogDiagnosticPrinter.h" 25 #include "clang/Frontend/SerializedDiagnosticPrinter.h" 26 #include "clang/Frontend/TextDiagnosticPrinter.h" 27 #include "clang/Frontend/Utils.h" 28 #include "clang/Frontend/VerifyDiagnosticConsumer.h" 29 #include "clang/Lex/HeaderSearch.h" 30 #include "clang/Lex/PTHManager.h" 31 #include "clang/Lex/Preprocessor.h" 32 #include "clang/Sema/CodeCompleteConsumer.h" 33 #include "clang/Sema/Sema.h" 34 #include "clang/Serialization/ASTReader.h" 35 #include "clang/Serialization/GlobalModuleIndex.h" 36 #include "llvm/ADT/Statistic.h" 37 #include "llvm/Support/CrashRecoveryContext.h" 38 #include "llvm/Support/Errc.h" 39 #include "llvm/Support/FileSystem.h" 40 #include "llvm/Support/Host.h" 41 #include "llvm/Support/LockFileManager.h" 42 #include "llvm/Support/MemoryBuffer.h" 43 #include "llvm/Support/Path.h" 44 #include "llvm/Support/Program.h" 45 #include "llvm/Support/Signals.h" 46 #include "llvm/Support/Timer.h" 47 #include "llvm/Support/raw_ostream.h" 48 #include <sys/stat.h> 49 #include <system_error> 50 #include <time.h> 51 52 using namespace clang; 53 54 CompilerInstance::CompilerInstance(bool BuildingModule) 55 : ModuleLoader(BuildingModule), 56 Invocation(new CompilerInvocation()), ModuleManager(nullptr), 57 BuildGlobalModuleIndex(false), HaveFullGlobalModuleIndex(false), 58 ModuleBuildFailed(false) { 59 } 60 61 CompilerInstance::~CompilerInstance() { 62 assert(OutputFiles.empty() && "Still output files in flight?"); 63 } 64 65 void CompilerInstance::setInvocation(CompilerInvocation *Value) { 66 Invocation = Value; 67 } 68 69 bool CompilerInstance::shouldBuildGlobalModuleIndex() const { 70 return (BuildGlobalModuleIndex || 71 (ModuleManager && ModuleManager->isGlobalIndexUnavailable() && 72 getFrontendOpts().GenerateGlobalModuleIndex)) && 73 !ModuleBuildFailed; 74 } 75 76 void CompilerInstance::setDiagnostics(DiagnosticsEngine *Value) { 77 Diagnostics = Value; 78 } 79 80 void CompilerInstance::setTarget(TargetInfo *Value) { 81 Target = Value; 82 } 83 84 void CompilerInstance::setFileManager(FileManager *Value) { 85 FileMgr = Value; 86 if (Value) 87 VirtualFileSystem = Value->getVirtualFileSystem(); 88 else 89 VirtualFileSystem.reset(); 90 } 91 92 void CompilerInstance::setSourceManager(SourceManager *Value) { 93 SourceMgr = Value; 94 } 95 96 void CompilerInstance::setPreprocessor(Preprocessor *Value) { PP = Value; } 97 98 void CompilerInstance::setASTContext(ASTContext *Value) { Context = Value; } 99 100 void CompilerInstance::setSema(Sema *S) { 101 TheSema.reset(S); 102 } 103 104 void CompilerInstance::setASTConsumer(std::unique_ptr<ASTConsumer> Value) { 105 Consumer = std::move(Value); 106 } 107 108 void CompilerInstance::setCodeCompletionConsumer(CodeCompleteConsumer *Value) { 109 CompletionConsumer.reset(Value); 110 } 111 112 std::unique_ptr<Sema> CompilerInstance::takeSema() { 113 return std::move(TheSema); 114 } 115 116 IntrusiveRefCntPtr<ASTReader> CompilerInstance::getModuleManager() const { 117 return ModuleManager; 118 } 119 void CompilerInstance::setModuleManager(IntrusiveRefCntPtr<ASTReader> Reader) { 120 ModuleManager = Reader; 121 } 122 123 std::shared_ptr<ModuleDependencyCollector> 124 CompilerInstance::getModuleDepCollector() const { 125 return ModuleDepCollector; 126 } 127 128 void CompilerInstance::setModuleDepCollector( 129 std::shared_ptr<ModuleDependencyCollector> Collector) { 130 ModuleDepCollector = Collector; 131 } 132 133 // Diagnostics 134 static void SetUpDiagnosticLog(DiagnosticOptions *DiagOpts, 135 const CodeGenOptions *CodeGenOpts, 136 DiagnosticsEngine &Diags) { 137 std::error_code EC; 138 bool OwnsStream = false; 139 raw_ostream *OS = &llvm::errs(); 140 if (DiagOpts->DiagnosticLogFile != "-") { 141 // Create the output stream. 142 llvm::raw_fd_ostream *FileOS(new llvm::raw_fd_ostream( 143 DiagOpts->DiagnosticLogFile, EC, 144 llvm::sys::fs::F_Append | llvm::sys::fs::F_Text)); 145 if (EC) { 146 Diags.Report(diag::warn_fe_cc_log_diagnostics_failure) 147 << DiagOpts->DiagnosticLogFile << EC.message(); 148 } else { 149 FileOS->SetUnbuffered(); 150 FileOS->SetUseAtomicWrites(true); 151 OS = FileOS; 152 OwnsStream = true; 153 } 154 } 155 156 // Chain in the diagnostic client which will log the diagnostics. 157 LogDiagnosticPrinter *Logger = new LogDiagnosticPrinter(*OS, DiagOpts, 158 OwnsStream); 159 if (CodeGenOpts) 160 Logger->setDwarfDebugFlags(CodeGenOpts->DwarfDebugFlags); 161 Diags.setClient(new ChainedDiagnosticConsumer(Diags.takeClient(), Logger)); 162 } 163 164 static void SetupSerializedDiagnostics(DiagnosticOptions *DiagOpts, 165 DiagnosticsEngine &Diags, 166 StringRef OutputFile) { 167 std::error_code EC; 168 auto OS = llvm::make_unique<llvm::raw_fd_ostream>(OutputFile.str(), EC, 169 llvm::sys::fs::F_None); 170 171 if (EC) { 172 Diags.Report(diag::warn_fe_serialized_diag_failure) << OutputFile 173 << EC.message(); 174 return; 175 } 176 177 DiagnosticConsumer *SerializedConsumer = 178 clang::serialized_diags::create(std::move(OS), DiagOpts); 179 180 Diags.setClient(new ChainedDiagnosticConsumer(Diags.takeClient(), 181 SerializedConsumer)); 182 } 183 184 void CompilerInstance::createDiagnostics(DiagnosticConsumer *Client, 185 bool ShouldOwnClient) { 186 Diagnostics = createDiagnostics(&getDiagnosticOpts(), Client, 187 ShouldOwnClient, &getCodeGenOpts()); 188 } 189 190 IntrusiveRefCntPtr<DiagnosticsEngine> 191 CompilerInstance::createDiagnostics(DiagnosticOptions *Opts, 192 DiagnosticConsumer *Client, 193 bool ShouldOwnClient, 194 const CodeGenOptions *CodeGenOpts) { 195 IntrusiveRefCntPtr<DiagnosticIDs> DiagID(new DiagnosticIDs()); 196 IntrusiveRefCntPtr<DiagnosticsEngine> 197 Diags(new DiagnosticsEngine(DiagID, Opts)); 198 199 // Create the diagnostic client for reporting errors or for 200 // implementing -verify. 201 if (Client) { 202 Diags->setClient(Client, ShouldOwnClient); 203 } else 204 Diags->setClient(new TextDiagnosticPrinter(llvm::errs(), Opts)); 205 206 // Chain in -verify checker, if requested. 207 if (Opts->VerifyDiagnostics) 208 Diags->setClient(new VerifyDiagnosticConsumer(*Diags)); 209 210 // Chain in -diagnostic-log-file dumper, if requested. 211 if (!Opts->DiagnosticLogFile.empty()) 212 SetUpDiagnosticLog(Opts, CodeGenOpts, *Diags); 213 214 if (!Opts->DiagnosticSerializationFile.empty()) 215 SetupSerializedDiagnostics(Opts, *Diags, 216 Opts->DiagnosticSerializationFile); 217 218 // Configure our handling of diagnostics. 219 ProcessWarningOptions(*Diags, *Opts); 220 221 return Diags; 222 } 223 224 // File Manager 225 226 void CompilerInstance::createFileManager() { 227 if (!hasVirtualFileSystem()) { 228 // TODO: choose the virtual file system based on the CompilerInvocation. 229 setVirtualFileSystem(vfs::getRealFileSystem()); 230 } 231 FileMgr = new FileManager(getFileSystemOpts(), VirtualFileSystem); 232 } 233 234 // Source Manager 235 236 void CompilerInstance::createSourceManager(FileManager &FileMgr) { 237 SourceMgr = new SourceManager(getDiagnostics(), FileMgr); 238 } 239 240 // Initialize the remapping of files to alternative contents, e.g., 241 // those specified through other files. 242 static void InitializeFileRemapping(DiagnosticsEngine &Diags, 243 SourceManager &SourceMgr, 244 FileManager &FileMgr, 245 const PreprocessorOptions &InitOpts) { 246 // Remap files in the source manager (with buffers). 247 for (const auto &RB : InitOpts.RemappedFileBuffers) { 248 // Create the file entry for the file that we're mapping from. 249 const FileEntry *FromFile = 250 FileMgr.getVirtualFile(RB.first, RB.second->getBufferSize(), 0); 251 if (!FromFile) { 252 Diags.Report(diag::err_fe_remap_missing_from_file) << RB.first; 253 if (!InitOpts.RetainRemappedFileBuffers) 254 delete RB.second; 255 continue; 256 } 257 258 // Override the contents of the "from" file with the contents of 259 // the "to" file. 260 SourceMgr.overrideFileContents(FromFile, RB.second, 261 InitOpts.RetainRemappedFileBuffers); 262 } 263 264 // Remap files in the source manager (with other files). 265 for (const auto &RF : InitOpts.RemappedFiles) { 266 // Find the file that we're mapping to. 267 const FileEntry *ToFile = FileMgr.getFile(RF.second); 268 if (!ToFile) { 269 Diags.Report(diag::err_fe_remap_missing_to_file) << RF.first << RF.second; 270 continue; 271 } 272 273 // Create the file entry for the file that we're mapping from. 274 const FileEntry *FromFile = 275 FileMgr.getVirtualFile(RF.first, ToFile->getSize(), 0); 276 if (!FromFile) { 277 Diags.Report(diag::err_fe_remap_missing_from_file) << RF.first; 278 continue; 279 } 280 281 // Override the contents of the "from" file with the contents of 282 // the "to" file. 283 SourceMgr.overrideFileContents(FromFile, ToFile); 284 } 285 286 SourceMgr.setOverridenFilesKeepOriginalName( 287 InitOpts.RemappedFilesKeepOriginalName); 288 } 289 290 // Preprocessor 291 292 void CompilerInstance::createPreprocessor(TranslationUnitKind TUKind) { 293 const PreprocessorOptions &PPOpts = getPreprocessorOpts(); 294 295 // Create a PTH manager if we are using some form of a token cache. 296 PTHManager *PTHMgr = nullptr; 297 if (!PPOpts.TokenCache.empty()) 298 PTHMgr = PTHManager::Create(PPOpts.TokenCache, getDiagnostics()); 299 300 // Create the Preprocessor. 301 HeaderSearch *HeaderInfo = new HeaderSearch(&getHeaderSearchOpts(), 302 getSourceManager(), 303 getDiagnostics(), 304 getLangOpts(), 305 &getTarget()); 306 PP = new Preprocessor(&getPreprocessorOpts(), getDiagnostics(), getLangOpts(), 307 getSourceManager(), *HeaderInfo, *this, PTHMgr, 308 /*OwnsHeaderSearch=*/true, TUKind); 309 PP->Initialize(getTarget()); 310 311 // Note that this is different then passing PTHMgr to Preprocessor's ctor. 312 // That argument is used as the IdentifierInfoLookup argument to 313 // IdentifierTable's ctor. 314 if (PTHMgr) { 315 PTHMgr->setPreprocessor(&*PP); 316 PP->setPTHManager(PTHMgr); 317 } 318 319 if (PPOpts.DetailedRecord) 320 PP->createPreprocessingRecord(); 321 322 // Apply remappings to the source manager. 323 InitializeFileRemapping(PP->getDiagnostics(), PP->getSourceManager(), 324 PP->getFileManager(), PPOpts); 325 326 // Predefine macros and configure the preprocessor. 327 InitializePreprocessor(*PP, PPOpts, getFrontendOpts()); 328 329 // Initialize the header search object. 330 ApplyHeaderSearchOptions(PP->getHeaderSearchInfo(), getHeaderSearchOpts(), 331 PP->getLangOpts(), PP->getTargetInfo().getTriple()); 332 333 PP->setPreprocessedOutput(getPreprocessorOutputOpts().ShowCPP); 334 335 // Set up the module path, including the hash for the 336 // module-creation options. 337 SmallString<256> SpecificModuleCache( 338 getHeaderSearchOpts().ModuleCachePath); 339 if (!getHeaderSearchOpts().DisableModuleHash) 340 llvm::sys::path::append(SpecificModuleCache, 341 getInvocation().getModuleHash()); 342 PP->getHeaderSearchInfo().setModuleCachePath(SpecificModuleCache); 343 344 // Handle generating dependencies, if requested. 345 const DependencyOutputOptions &DepOpts = getDependencyOutputOpts(); 346 if (!DepOpts.OutputFile.empty()) 347 TheDependencyFileGenerator.reset( 348 DependencyFileGenerator::CreateAndAttachToPreprocessor(*PP, DepOpts)); 349 if (!DepOpts.DOTOutputFile.empty()) 350 AttachDependencyGraphGen(*PP, DepOpts.DOTOutputFile, 351 getHeaderSearchOpts().Sysroot); 352 353 for (auto &Listener : DependencyCollectors) 354 Listener->attachToPreprocessor(*PP); 355 356 // If we don't have a collector, but we are collecting module dependencies, 357 // then we're the top level compiler instance and need to create one. 358 if (!ModuleDepCollector && !DepOpts.ModuleDependencyOutputDir.empty()) 359 ModuleDepCollector = std::make_shared<ModuleDependencyCollector>( 360 DepOpts.ModuleDependencyOutputDir); 361 362 // Handle generating header include information, if requested. 363 if (DepOpts.ShowHeaderIncludes) 364 AttachHeaderIncludeGen(*PP); 365 if (!DepOpts.HeaderIncludeOutputFile.empty()) { 366 StringRef OutputPath = DepOpts.HeaderIncludeOutputFile; 367 if (OutputPath == "-") 368 OutputPath = ""; 369 AttachHeaderIncludeGen(*PP, /*ShowAllHeaders=*/true, OutputPath, 370 /*ShowDepth=*/false); 371 } 372 373 if (DepOpts.PrintShowIncludes) { 374 AttachHeaderIncludeGen(*PP, /*ShowAllHeaders=*/false, /*OutputPath=*/"", 375 /*ShowDepth=*/true, /*MSStyle=*/true); 376 } 377 } 378 379 // ASTContext 380 381 void CompilerInstance::createASTContext() { 382 Preprocessor &PP = getPreprocessor(); 383 Context = new ASTContext(getLangOpts(), PP.getSourceManager(), 384 PP.getIdentifierTable(), PP.getSelectorTable(), 385 PP.getBuiltinInfo()); 386 Context->InitBuiltinTypes(getTarget()); 387 } 388 389 // ExternalASTSource 390 391 void CompilerInstance::createPCHExternalASTSource( 392 StringRef Path, bool DisablePCHValidation, bool AllowPCHWithCompilerErrors, 393 void *DeserializationListener, bool OwnDeserializationListener) { 394 IntrusiveRefCntPtr<ExternalASTSource> Source; 395 bool Preamble = getPreprocessorOpts().PrecompiledPreambleBytes.first != 0; 396 Source = createPCHExternalASTSource( 397 Path, getHeaderSearchOpts().Sysroot, DisablePCHValidation, 398 AllowPCHWithCompilerErrors, getPreprocessor(), getASTContext(), 399 DeserializationListener, OwnDeserializationListener, Preamble, 400 getFrontendOpts().UseGlobalModuleIndex); 401 ModuleManager = static_cast<ASTReader*>(Source.get()); 402 getASTContext().setExternalSource(Source); 403 } 404 405 ExternalASTSource *CompilerInstance::createPCHExternalASTSource( 406 StringRef Path, const std::string &Sysroot, bool DisablePCHValidation, 407 bool AllowPCHWithCompilerErrors, Preprocessor &PP, ASTContext &Context, 408 void *DeserializationListener, bool OwnDeserializationListener, 409 bool Preamble, bool UseGlobalModuleIndex) { 410 HeaderSearchOptions &HSOpts = PP.getHeaderSearchInfo().getHeaderSearchOpts(); 411 412 std::unique_ptr<ASTReader> Reader; 413 Reader.reset(new ASTReader(PP, Context, 414 Sysroot.empty() ? "" : Sysroot.c_str(), 415 DisablePCHValidation, 416 AllowPCHWithCompilerErrors, 417 /*AllowConfigurationMismatch*/false, 418 HSOpts.ModulesValidateSystemHeaders, 419 UseGlobalModuleIndex)); 420 421 Reader->setDeserializationListener( 422 static_cast<ASTDeserializationListener *>(DeserializationListener), 423 /*TakeOwnership=*/OwnDeserializationListener); 424 switch (Reader->ReadAST(Path, 425 Preamble ? serialization::MK_Preamble 426 : serialization::MK_PCH, 427 SourceLocation(), 428 ASTReader::ARR_None)) { 429 case ASTReader::Success: 430 // Set the predefines buffer as suggested by the PCH reader. Typically, the 431 // predefines buffer will be empty. 432 PP.setPredefines(Reader->getSuggestedPredefines()); 433 return Reader.release(); 434 435 case ASTReader::Failure: 436 // Unrecoverable failure: don't even try to process the input file. 437 break; 438 439 case ASTReader::Missing: 440 case ASTReader::OutOfDate: 441 case ASTReader::VersionMismatch: 442 case ASTReader::ConfigurationMismatch: 443 case ASTReader::HadErrors: 444 // No suitable PCH file could be found. Return an error. 445 break; 446 } 447 448 return nullptr; 449 } 450 451 // Code Completion 452 453 static bool EnableCodeCompletion(Preprocessor &PP, 454 const std::string &Filename, 455 unsigned Line, 456 unsigned Column) { 457 // Tell the source manager to chop off the given file at a specific 458 // line and column. 459 const FileEntry *Entry = PP.getFileManager().getFile(Filename); 460 if (!Entry) { 461 PP.getDiagnostics().Report(diag::err_fe_invalid_code_complete_file) 462 << Filename; 463 return true; 464 } 465 466 // Truncate the named file at the given line/column. 467 PP.SetCodeCompletionPoint(Entry, Line, Column); 468 return false; 469 } 470 471 void CompilerInstance::createCodeCompletionConsumer() { 472 const ParsedSourceLocation &Loc = getFrontendOpts().CodeCompletionAt; 473 if (!CompletionConsumer) { 474 setCodeCompletionConsumer( 475 createCodeCompletionConsumer(getPreprocessor(), 476 Loc.FileName, Loc.Line, Loc.Column, 477 getFrontendOpts().CodeCompleteOpts, 478 llvm::outs())); 479 if (!CompletionConsumer) 480 return; 481 } else if (EnableCodeCompletion(getPreprocessor(), Loc.FileName, 482 Loc.Line, Loc.Column)) { 483 setCodeCompletionConsumer(nullptr); 484 return; 485 } 486 487 if (CompletionConsumer->isOutputBinary() && 488 llvm::sys::ChangeStdoutToBinary()) { 489 getPreprocessor().getDiagnostics().Report(diag::err_fe_stdout_binary); 490 setCodeCompletionConsumer(nullptr); 491 } 492 } 493 494 void CompilerInstance::createFrontendTimer() { 495 FrontendTimer.reset(new llvm::Timer("Clang front-end timer")); 496 } 497 498 CodeCompleteConsumer * 499 CompilerInstance::createCodeCompletionConsumer(Preprocessor &PP, 500 const std::string &Filename, 501 unsigned Line, 502 unsigned Column, 503 const CodeCompleteOptions &Opts, 504 raw_ostream &OS) { 505 if (EnableCodeCompletion(PP, Filename, Line, Column)) 506 return nullptr; 507 508 // Set up the creation routine for code-completion. 509 return new PrintingCodeCompleteConsumer(Opts, OS); 510 } 511 512 void CompilerInstance::createSema(TranslationUnitKind TUKind, 513 CodeCompleteConsumer *CompletionConsumer) { 514 TheSema.reset(new Sema(getPreprocessor(), getASTContext(), getASTConsumer(), 515 TUKind, CompletionConsumer)); 516 } 517 518 // Output Files 519 520 void CompilerInstance::addOutputFile(const OutputFile &OutFile) { 521 assert(OutFile.OS && "Attempt to add empty stream to output list!"); 522 OutputFiles.push_back(OutFile); 523 } 524 525 void CompilerInstance::clearOutputFiles(bool EraseFiles) { 526 for (std::list<OutputFile>::iterator 527 it = OutputFiles.begin(), ie = OutputFiles.end(); it != ie; ++it) { 528 delete it->OS; 529 if (!it->TempFilename.empty()) { 530 if (EraseFiles) { 531 llvm::sys::fs::remove(it->TempFilename); 532 } else { 533 SmallString<128> NewOutFile(it->Filename); 534 535 // If '-working-directory' was passed, the output filename should be 536 // relative to that. 537 FileMgr->FixupRelativePath(NewOutFile); 538 if (std::error_code ec = 539 llvm::sys::fs::rename(it->TempFilename, NewOutFile.str())) { 540 getDiagnostics().Report(diag::err_unable_to_rename_temp) 541 << it->TempFilename << it->Filename << ec.message(); 542 543 llvm::sys::fs::remove(it->TempFilename); 544 } 545 } 546 } else if (!it->Filename.empty() && EraseFiles) 547 llvm::sys::fs::remove(it->Filename); 548 549 } 550 OutputFiles.clear(); 551 } 552 553 llvm::raw_fd_ostream * 554 CompilerInstance::createDefaultOutputFile(bool Binary, 555 StringRef InFile, 556 StringRef Extension) { 557 return createOutputFile(getFrontendOpts().OutputFile, Binary, 558 /*RemoveFileOnSignal=*/true, InFile, Extension, 559 /*UseTemporary=*/true); 560 } 561 562 llvm::raw_null_ostream *CompilerInstance::createNullOutputFile() { 563 llvm::raw_null_ostream *OS = new llvm::raw_null_ostream(); 564 addOutputFile(OutputFile("", "", OS)); 565 return OS; 566 } 567 568 llvm::raw_fd_ostream * 569 CompilerInstance::createOutputFile(StringRef OutputPath, 570 bool Binary, bool RemoveFileOnSignal, 571 StringRef InFile, 572 StringRef Extension, 573 bool UseTemporary, 574 bool CreateMissingDirectories) { 575 std::string OutputPathName, TempPathName; 576 std::error_code EC; 577 llvm::raw_fd_ostream *OS = createOutputFile( 578 OutputPath, EC, Binary, RemoveFileOnSignal, InFile, Extension, 579 UseTemporary, CreateMissingDirectories, &OutputPathName, &TempPathName); 580 if (!OS) { 581 getDiagnostics().Report(diag::err_fe_unable_to_open_output) << OutputPath 582 << EC.message(); 583 return nullptr; 584 } 585 586 // Add the output file -- but don't try to remove "-", since this means we are 587 // using stdin. 588 addOutputFile(OutputFile((OutputPathName != "-") ? OutputPathName : "", 589 TempPathName, OS)); 590 591 return OS; 592 } 593 594 llvm::raw_fd_ostream *CompilerInstance::createOutputFile( 595 StringRef OutputPath, std::error_code &Error, bool Binary, 596 bool RemoveFileOnSignal, StringRef InFile, StringRef Extension, 597 bool UseTemporary, bool CreateMissingDirectories, 598 std::string *ResultPathName, std::string *TempPathName) { 599 assert((!CreateMissingDirectories || UseTemporary) && 600 "CreateMissingDirectories is only allowed when using temporary files"); 601 602 std::string OutFile, TempFile; 603 if (!OutputPath.empty()) { 604 OutFile = OutputPath; 605 } else if (InFile == "-") { 606 OutFile = "-"; 607 } else if (!Extension.empty()) { 608 SmallString<128> Path(InFile); 609 llvm::sys::path::replace_extension(Path, Extension); 610 OutFile = Path.str(); 611 } else { 612 OutFile = "-"; 613 } 614 615 std::unique_ptr<llvm::raw_fd_ostream> OS; 616 std::string OSFile; 617 618 if (UseTemporary) { 619 if (OutFile == "-") 620 UseTemporary = false; 621 else { 622 llvm::sys::fs::file_status Status; 623 llvm::sys::fs::status(OutputPath, Status); 624 if (llvm::sys::fs::exists(Status)) { 625 // Fail early if we can't write to the final destination. 626 if (!llvm::sys::fs::can_write(OutputPath)) 627 return nullptr; 628 629 // Don't use a temporary if the output is a special file. This handles 630 // things like '-o /dev/null' 631 if (!llvm::sys::fs::is_regular_file(Status)) 632 UseTemporary = false; 633 } 634 } 635 } 636 637 if (UseTemporary) { 638 // Create a temporary file. 639 SmallString<128> TempPath; 640 TempPath = OutFile; 641 TempPath += "-%%%%%%%%"; 642 int fd; 643 std::error_code EC = 644 llvm::sys::fs::createUniqueFile(TempPath.str(), fd, TempPath); 645 646 if (CreateMissingDirectories && 647 EC == llvm::errc::no_such_file_or_directory) { 648 StringRef Parent = llvm::sys::path::parent_path(OutputPath); 649 EC = llvm::sys::fs::create_directories(Parent); 650 if (!EC) { 651 EC = llvm::sys::fs::createUniqueFile(TempPath.str(), fd, TempPath); 652 } 653 } 654 655 if (!EC) { 656 OS.reset(new llvm::raw_fd_ostream(fd, /*shouldClose=*/true)); 657 OSFile = TempFile = TempPath.str(); 658 } 659 // If we failed to create the temporary, fallback to writing to the file 660 // directly. This handles the corner case where we cannot write to the 661 // directory, but can write to the file. 662 } 663 664 if (!OS) { 665 OSFile = OutFile; 666 OS.reset(new llvm::raw_fd_ostream( 667 OSFile, Error, 668 (Binary ? llvm::sys::fs::F_None : llvm::sys::fs::F_Text))); 669 if (Error) 670 return nullptr; 671 } 672 673 // Make sure the out stream file gets removed if we crash. 674 if (RemoveFileOnSignal) 675 llvm::sys::RemoveFileOnSignal(OSFile); 676 677 if (ResultPathName) 678 *ResultPathName = OutFile; 679 if (TempPathName) 680 *TempPathName = TempFile; 681 682 return OS.release(); 683 } 684 685 // Initialization Utilities 686 687 bool CompilerInstance::InitializeSourceManager(const FrontendInputFile &Input){ 688 return InitializeSourceManager(Input, getDiagnostics(), 689 getFileManager(), getSourceManager(), 690 getFrontendOpts()); 691 } 692 693 bool CompilerInstance::InitializeSourceManager(const FrontendInputFile &Input, 694 DiagnosticsEngine &Diags, 695 FileManager &FileMgr, 696 SourceManager &SourceMgr, 697 const FrontendOptions &Opts) { 698 SrcMgr::CharacteristicKind 699 Kind = Input.isSystem() ? SrcMgr::C_System : SrcMgr::C_User; 700 701 if (Input.isBuffer()) { 702 SourceMgr.setMainFileID(SourceMgr.createFileID( 703 std::unique_ptr<llvm::MemoryBuffer>(Input.getBuffer()), Kind)); 704 assert(!SourceMgr.getMainFileID().isInvalid() && 705 "Couldn't establish MainFileID!"); 706 return true; 707 } 708 709 StringRef InputFile = Input.getFile(); 710 711 // Figure out where to get and map in the main file. 712 if (InputFile != "-") { 713 const FileEntry *File = FileMgr.getFile(InputFile, /*OpenFile=*/true); 714 if (!File) { 715 Diags.Report(diag::err_fe_error_reading) << InputFile; 716 return false; 717 } 718 719 // The natural SourceManager infrastructure can't currently handle named 720 // pipes, but we would at least like to accept them for the main 721 // file. Detect them here, read them with the volatile flag so FileMgr will 722 // pick up the correct size, and simply override their contents as we do for 723 // STDIN. 724 if (File->isNamedPipe()) { 725 std::string ErrorStr; 726 if (std::unique_ptr<llvm::MemoryBuffer> MB = 727 FileMgr.getBufferForFile(File, &ErrorStr, /*isVolatile=*/true)) { 728 // Create a new virtual file that will have the correct size. 729 File = FileMgr.getVirtualFile(InputFile, MB->getBufferSize(), 0); 730 SourceMgr.overrideFileContents(File, std::move(MB)); 731 } else { 732 Diags.Report(diag::err_cannot_open_file) << InputFile << ErrorStr; 733 return false; 734 } 735 } 736 737 SourceMgr.setMainFileID( 738 SourceMgr.createFileID(File, SourceLocation(), Kind)); 739 } else { 740 llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> SBOrErr = 741 llvm::MemoryBuffer::getSTDIN(); 742 if (std::error_code EC = SBOrErr.getError()) { 743 Diags.Report(diag::err_fe_error_reading_stdin) << EC.message(); 744 return false; 745 } 746 std::unique_ptr<llvm::MemoryBuffer> SB = std::move(SBOrErr.get()); 747 748 const FileEntry *File = FileMgr.getVirtualFile(SB->getBufferIdentifier(), 749 SB->getBufferSize(), 0); 750 SourceMgr.setMainFileID( 751 SourceMgr.createFileID(File, SourceLocation(), Kind)); 752 SourceMgr.overrideFileContents(File, std::move(SB)); 753 } 754 755 assert(!SourceMgr.getMainFileID().isInvalid() && 756 "Couldn't establish MainFileID!"); 757 return true; 758 } 759 760 // High-Level Operations 761 762 bool CompilerInstance::ExecuteAction(FrontendAction &Act) { 763 assert(hasDiagnostics() && "Diagnostics engine is not initialized!"); 764 assert(!getFrontendOpts().ShowHelp && "Client must handle '-help'!"); 765 assert(!getFrontendOpts().ShowVersion && "Client must handle '-version'!"); 766 767 // FIXME: Take this as an argument, once all the APIs we used have moved to 768 // taking it as an input instead of hard-coding llvm::errs. 769 raw_ostream &OS = llvm::errs(); 770 771 // Create the target instance. 772 setTarget(TargetInfo::CreateTargetInfo(getDiagnostics(), 773 getInvocation().TargetOpts)); 774 if (!hasTarget()) 775 return false; 776 777 // Inform the target of the language options. 778 // 779 // FIXME: We shouldn't need to do this, the target should be immutable once 780 // created. This complexity should be lifted elsewhere. 781 getTarget().adjust(getLangOpts()); 782 783 // rewriter project will change target built-in bool type from its default. 784 if (getFrontendOpts().ProgramAction == frontend::RewriteObjC) 785 getTarget().noSignedCharForObjCBool(); 786 787 // Validate/process some options. 788 if (getHeaderSearchOpts().Verbose) 789 OS << "clang -cc1 version " CLANG_VERSION_STRING 790 << " based upon " << BACKEND_PACKAGE_STRING 791 << " default target " << llvm::sys::getDefaultTargetTriple() << "\n"; 792 793 if (getFrontendOpts().ShowTimers) 794 createFrontendTimer(); 795 796 if (getFrontendOpts().ShowStats) 797 llvm::EnableStatistics(); 798 799 for (unsigned i = 0, e = getFrontendOpts().Inputs.size(); i != e; ++i) { 800 // Reset the ID tables if we are reusing the SourceManager and parsing 801 // regular files. 802 if (hasSourceManager() && !Act.isModelParsingAction()) 803 getSourceManager().clearIDTables(); 804 805 if (Act.BeginSourceFile(*this, getFrontendOpts().Inputs[i])) { 806 Act.Execute(); 807 Act.EndSourceFile(); 808 } 809 } 810 811 // Notify the diagnostic client that all files were processed. 812 getDiagnostics().getClient()->finish(); 813 814 if (getDiagnosticOpts().ShowCarets) { 815 // We can have multiple diagnostics sharing one diagnostic client. 816 // Get the total number of warnings/errors from the client. 817 unsigned NumWarnings = getDiagnostics().getClient()->getNumWarnings(); 818 unsigned NumErrors = getDiagnostics().getClient()->getNumErrors(); 819 820 if (NumWarnings) 821 OS << NumWarnings << " warning" << (NumWarnings == 1 ? "" : "s"); 822 if (NumWarnings && NumErrors) 823 OS << " and "; 824 if (NumErrors) 825 OS << NumErrors << " error" << (NumErrors == 1 ? "" : "s"); 826 if (NumWarnings || NumErrors) 827 OS << " generated.\n"; 828 } 829 830 if (getFrontendOpts().ShowStats && hasFileManager()) { 831 getFileManager().PrintStats(); 832 OS << "\n"; 833 } 834 835 return !getDiagnostics().getClient()->getNumErrors(); 836 } 837 838 /// \brief Determine the appropriate source input kind based on language 839 /// options. 840 static InputKind getSourceInputKindFromOptions(const LangOptions &LangOpts) { 841 if (LangOpts.OpenCL) 842 return IK_OpenCL; 843 if (LangOpts.CUDA) 844 return IK_CUDA; 845 if (LangOpts.ObjC1) 846 return LangOpts.CPlusPlus? IK_ObjCXX : IK_ObjC; 847 return LangOpts.CPlusPlus? IK_CXX : IK_C; 848 } 849 850 /// \brief Compile a module file for the given module, using the options 851 /// provided by the importing compiler instance. Returns true if the module 852 /// was built without errors. 853 static bool compileModuleImpl(CompilerInstance &ImportingInstance, 854 SourceLocation ImportLoc, 855 Module *Module, 856 StringRef ModuleFileName) { 857 ModuleMap &ModMap 858 = ImportingInstance.getPreprocessor().getHeaderSearchInfo().getModuleMap(); 859 860 // Construct a compiler invocation for creating this module. 861 IntrusiveRefCntPtr<CompilerInvocation> Invocation 862 (new CompilerInvocation(ImportingInstance.getInvocation())); 863 864 PreprocessorOptions &PPOpts = Invocation->getPreprocessorOpts(); 865 866 // For any options that aren't intended to affect how a module is built, 867 // reset them to their default values. 868 Invocation->getLangOpts()->resetNonModularOptions(); 869 PPOpts.resetNonModularOptions(); 870 871 // Remove any macro definitions that are explicitly ignored by the module. 872 // They aren't supposed to affect how the module is built anyway. 873 const HeaderSearchOptions &HSOpts = Invocation->getHeaderSearchOpts(); 874 PPOpts.Macros.erase( 875 std::remove_if(PPOpts.Macros.begin(), PPOpts.Macros.end(), 876 [&HSOpts](const std::pair<std::string, bool> &def) { 877 StringRef MacroDef = def.first; 878 return HSOpts.ModulesIgnoreMacros.count(MacroDef.split('=').first) > 0; 879 }), 880 PPOpts.Macros.end()); 881 882 // Note the name of the module we're building. 883 Invocation->getLangOpts()->CurrentModule = Module->getTopLevelModuleName(); 884 885 // Make sure that the failed-module structure has been allocated in 886 // the importing instance, and propagate the pointer to the newly-created 887 // instance. 888 PreprocessorOptions &ImportingPPOpts 889 = ImportingInstance.getInvocation().getPreprocessorOpts(); 890 if (!ImportingPPOpts.FailedModules) 891 ImportingPPOpts.FailedModules = new PreprocessorOptions::FailedModulesSet; 892 PPOpts.FailedModules = ImportingPPOpts.FailedModules; 893 894 // If there is a module map file, build the module using the module map. 895 // Set up the inputs/outputs so that we build the module from its umbrella 896 // header. 897 FrontendOptions &FrontendOpts = Invocation->getFrontendOpts(); 898 FrontendOpts.OutputFile = ModuleFileName.str(); 899 FrontendOpts.DisableFree = false; 900 FrontendOpts.GenerateGlobalModuleIndex = false; 901 FrontendOpts.Inputs.clear(); 902 InputKind IK = getSourceInputKindFromOptions(*Invocation->getLangOpts()); 903 904 // Don't free the remapped file buffers; they are owned by our caller. 905 PPOpts.RetainRemappedFileBuffers = true; 906 907 Invocation->getDiagnosticOpts().VerifyDiagnostics = 0; 908 assert(ImportingInstance.getInvocation().getModuleHash() == 909 Invocation->getModuleHash() && "Module hash mismatch!"); 910 911 // Construct a compiler instance that will be used to actually create the 912 // module. 913 CompilerInstance Instance(/*BuildingModule=*/true); 914 Instance.setInvocation(&*Invocation); 915 916 Instance.createDiagnostics(new ForwardingDiagnosticConsumer( 917 ImportingInstance.getDiagnosticClient()), 918 /*ShouldOwnClient=*/true); 919 920 Instance.setVirtualFileSystem(&ImportingInstance.getVirtualFileSystem()); 921 922 // Note that this module is part of the module build stack, so that we 923 // can detect cycles in the module graph. 924 Instance.setFileManager(&ImportingInstance.getFileManager()); 925 Instance.createSourceManager(Instance.getFileManager()); 926 SourceManager &SourceMgr = Instance.getSourceManager(); 927 SourceMgr.setModuleBuildStack( 928 ImportingInstance.getSourceManager().getModuleBuildStack()); 929 SourceMgr.pushModuleBuildStack(Module->getTopLevelModuleName(), 930 FullSourceLoc(ImportLoc, ImportingInstance.getSourceManager())); 931 932 // If we're collecting module dependencies, we need to share a collector 933 // between all of the module CompilerInstances. 934 Instance.setModuleDepCollector(ImportingInstance.getModuleDepCollector()); 935 936 // Get or create the module map that we'll use to build this module. 937 std::string InferredModuleMapContent; 938 if (const FileEntry *ModuleMapFile = 939 ModMap.getContainingModuleMapFile(Module)) { 940 // Use the module map where this module resides. 941 FrontendOpts.Inputs.push_back( 942 FrontendInputFile(ModuleMapFile->getName(), IK)); 943 } else { 944 llvm::raw_string_ostream OS(InferredModuleMapContent); 945 Module->print(OS); 946 OS.flush(); 947 FrontendOpts.Inputs.push_back( 948 FrontendInputFile("__inferred_module.map", IK)); 949 950 std::unique_ptr<llvm::MemoryBuffer> ModuleMapBuffer = 951 llvm::MemoryBuffer::getMemBuffer(InferredModuleMapContent); 952 ModuleMapFile = Instance.getFileManager().getVirtualFile( 953 "__inferred_module.map", InferredModuleMapContent.size(), 0); 954 SourceMgr.overrideFileContents(ModuleMapFile, std::move(ModuleMapBuffer)); 955 } 956 957 // Construct a module-generating action. Passing through the module map is 958 // safe because the FileManager is shared between the compiler instances. 959 GenerateModuleAction CreateModuleAction( 960 ModMap.getModuleMapFileForUniquing(Module), Module->IsSystem); 961 962 // Execute the action to actually build the module in-place. Use a separate 963 // thread so that we get a stack large enough. 964 const unsigned ThreadStackSize = 8 << 20; 965 llvm::CrashRecoveryContext CRC; 966 CRC.RunSafelyOnThread([&]() { Instance.ExecuteAction(CreateModuleAction); }, 967 ThreadStackSize); 968 969 // Delete the temporary module map file. 970 // FIXME: Even though we're executing under crash protection, it would still 971 // be nice to do this with RemoveFileOnSignal when we can. However, that 972 // doesn't make sense for all clients, so clean this up manually. 973 Instance.clearOutputFiles(/*EraseFiles=*/true); 974 975 // We've rebuilt a module. If we're allowed to generate or update the global 976 // module index, record that fact in the importing compiler instance. 977 if (ImportingInstance.getFrontendOpts().GenerateGlobalModuleIndex) { 978 ImportingInstance.setBuildGlobalModuleIndex(true); 979 } 980 981 return !Instance.getDiagnostics().hasErrorOccurred(); 982 } 983 984 static bool compileAndLoadModule(CompilerInstance &ImportingInstance, 985 SourceLocation ImportLoc, 986 SourceLocation ModuleNameLoc, Module *Module, 987 StringRef ModuleFileName) { 988 auto diagnoseBuildFailure = [&] { 989 ImportingInstance.getDiagnostics().Report(ModuleNameLoc, 990 diag::err_module_not_built) 991 << Module->Name << SourceRange(ImportLoc, ModuleNameLoc); 992 }; 993 994 // FIXME: have LockFileManager return an error_code so that we can 995 // avoid the mkdir when the directory already exists. 996 StringRef Dir = llvm::sys::path::parent_path(ModuleFileName); 997 llvm::sys::fs::create_directories(Dir); 998 999 while (1) { 1000 unsigned ModuleLoadCapabilities = ASTReader::ARR_Missing; 1001 llvm::LockFileManager Locked(ModuleFileName); 1002 switch (Locked) { 1003 case llvm::LockFileManager::LFS_Error: 1004 return false; 1005 1006 case llvm::LockFileManager::LFS_Owned: 1007 // We're responsible for building the module ourselves. 1008 if (!compileModuleImpl(ImportingInstance, ModuleNameLoc, Module, 1009 ModuleFileName)) { 1010 diagnoseBuildFailure(); 1011 return false; 1012 } 1013 break; 1014 1015 case llvm::LockFileManager::LFS_Shared: 1016 // Someone else is responsible for building the module. Wait for them to 1017 // finish. 1018 if (Locked.waitForUnlock() == llvm::LockFileManager::Res_OwnerDied) 1019 continue; // try again to get the lock. 1020 ModuleLoadCapabilities |= ASTReader::ARR_OutOfDate; 1021 break; 1022 } 1023 1024 // Try to read the module file, now that we've compiled it. 1025 ASTReader::ASTReadResult ReadResult = 1026 ImportingInstance.getModuleManager()->ReadAST( 1027 ModuleFileName, serialization::MK_Module, ImportLoc, 1028 ModuleLoadCapabilities); 1029 1030 if (ReadResult == ASTReader::OutOfDate && 1031 Locked == llvm::LockFileManager::LFS_Shared) { 1032 // The module may be out of date in the presence of file system races, 1033 // or if one of its imports depends on header search paths that are not 1034 // consistent with this ImportingInstance. Try again... 1035 continue; 1036 } else if (ReadResult == ASTReader::Missing) { 1037 diagnoseBuildFailure(); 1038 } 1039 return ReadResult == ASTReader::Success; 1040 } 1041 } 1042 1043 /// \brief Diagnose differences between the current definition of the given 1044 /// configuration macro and the definition provided on the command line. 1045 static void checkConfigMacro(Preprocessor &PP, StringRef ConfigMacro, 1046 Module *Mod, SourceLocation ImportLoc) { 1047 IdentifierInfo *Id = PP.getIdentifierInfo(ConfigMacro); 1048 SourceManager &SourceMgr = PP.getSourceManager(); 1049 1050 // If this identifier has never had a macro definition, then it could 1051 // not have changed. 1052 if (!Id->hadMacroDefinition()) 1053 return; 1054 1055 // If this identifier does not currently have a macro definition, 1056 // check whether it had one on the command line. 1057 if (!Id->hasMacroDefinition()) { 1058 MacroDirective::DefInfo LatestDef = 1059 PP.getMacroDirectiveHistory(Id)->getDefinition(); 1060 for (MacroDirective::DefInfo Def = LatestDef; Def; 1061 Def = Def.getPreviousDefinition()) { 1062 FileID FID = SourceMgr.getFileID(Def.getLocation()); 1063 if (FID.isInvalid()) 1064 continue; 1065 1066 // We only care about the predefines buffer. 1067 if (FID != PP.getPredefinesFileID()) 1068 continue; 1069 1070 // This macro was defined on the command line, then #undef'd later. 1071 // Complain. 1072 PP.Diag(ImportLoc, diag::warn_module_config_macro_undef) 1073 << true << ConfigMacro << Mod->getFullModuleName(); 1074 if (LatestDef.isUndefined()) 1075 PP.Diag(LatestDef.getUndefLocation(), diag::note_module_def_undef_here) 1076 << true; 1077 return; 1078 } 1079 1080 // Okay: no definition in the predefines buffer. 1081 return; 1082 } 1083 1084 // This identifier has a macro definition. Check whether we had a definition 1085 // on the command line. 1086 MacroDirective::DefInfo LatestDef = 1087 PP.getMacroDirectiveHistory(Id)->getDefinition(); 1088 MacroDirective::DefInfo PredefinedDef; 1089 for (MacroDirective::DefInfo Def = LatestDef; Def; 1090 Def = Def.getPreviousDefinition()) { 1091 FileID FID = SourceMgr.getFileID(Def.getLocation()); 1092 if (FID.isInvalid()) 1093 continue; 1094 1095 // We only care about the predefines buffer. 1096 if (FID != PP.getPredefinesFileID()) 1097 continue; 1098 1099 PredefinedDef = Def; 1100 break; 1101 } 1102 1103 // If there was no definition for this macro in the predefines buffer, 1104 // complain. 1105 if (!PredefinedDef || 1106 (!PredefinedDef.getLocation().isValid() && 1107 PredefinedDef.getUndefLocation().isValid())) { 1108 PP.Diag(ImportLoc, diag::warn_module_config_macro_undef) 1109 << false << ConfigMacro << Mod->getFullModuleName(); 1110 PP.Diag(LatestDef.getLocation(), diag::note_module_def_undef_here) 1111 << false; 1112 return; 1113 } 1114 1115 // If the current macro definition is the same as the predefined macro 1116 // definition, it's okay. 1117 if (LatestDef.getMacroInfo() == PredefinedDef.getMacroInfo() || 1118 LatestDef.getMacroInfo()->isIdenticalTo(*PredefinedDef.getMacroInfo(),PP, 1119 /*Syntactically=*/true)) 1120 return; 1121 1122 // The macro definitions differ. 1123 PP.Diag(ImportLoc, diag::warn_module_config_macro_undef) 1124 << false << ConfigMacro << Mod->getFullModuleName(); 1125 PP.Diag(LatestDef.getLocation(), diag::note_module_def_undef_here) 1126 << false; 1127 } 1128 1129 /// \brief Write a new timestamp file with the given path. 1130 static void writeTimestampFile(StringRef TimestampFile) { 1131 std::error_code EC; 1132 llvm::raw_fd_ostream Out(TimestampFile.str(), EC, llvm::sys::fs::F_None); 1133 } 1134 1135 /// \brief Prune the module cache of modules that haven't been accessed in 1136 /// a long time. 1137 static void pruneModuleCache(const HeaderSearchOptions &HSOpts) { 1138 struct stat StatBuf; 1139 llvm::SmallString<128> TimestampFile; 1140 TimestampFile = HSOpts.ModuleCachePath; 1141 llvm::sys::path::append(TimestampFile, "modules.timestamp"); 1142 1143 // Try to stat() the timestamp file. 1144 if (::stat(TimestampFile.c_str(), &StatBuf)) { 1145 // If the timestamp file wasn't there, create one now. 1146 if (errno == ENOENT) { 1147 writeTimestampFile(TimestampFile); 1148 } 1149 return; 1150 } 1151 1152 // Check whether the time stamp is older than our pruning interval. 1153 // If not, do nothing. 1154 time_t TimeStampModTime = StatBuf.st_mtime; 1155 time_t CurrentTime = time(nullptr); 1156 if (CurrentTime - TimeStampModTime <= time_t(HSOpts.ModuleCachePruneInterval)) 1157 return; 1158 1159 // Write a new timestamp file so that nobody else attempts to prune. 1160 // There is a benign race condition here, if two Clang instances happen to 1161 // notice at the same time that the timestamp is out-of-date. 1162 writeTimestampFile(TimestampFile); 1163 1164 // Walk the entire module cache, looking for unused module files and module 1165 // indices. 1166 std::error_code EC; 1167 SmallString<128> ModuleCachePathNative; 1168 llvm::sys::path::native(HSOpts.ModuleCachePath, ModuleCachePathNative); 1169 for (llvm::sys::fs::directory_iterator 1170 Dir(ModuleCachePathNative.str(), EC), DirEnd; 1171 Dir != DirEnd && !EC; Dir.increment(EC)) { 1172 // If we don't have a directory, there's nothing to look into. 1173 if (!llvm::sys::fs::is_directory(Dir->path())) 1174 continue; 1175 1176 // Walk all of the files within this directory. 1177 for (llvm::sys::fs::directory_iterator File(Dir->path(), EC), FileEnd; 1178 File != FileEnd && !EC; File.increment(EC)) { 1179 // We only care about module and global module index files. 1180 StringRef Extension = llvm::sys::path::extension(File->path()); 1181 if (Extension != ".pcm" && Extension != ".timestamp" && 1182 llvm::sys::path::filename(File->path()) != "modules.idx") 1183 continue; 1184 1185 // Look at this file. If we can't stat it, there's nothing interesting 1186 // there. 1187 if (::stat(File->path().c_str(), &StatBuf)) 1188 continue; 1189 1190 // If the file has been used recently enough, leave it there. 1191 time_t FileAccessTime = StatBuf.st_atime; 1192 if (CurrentTime - FileAccessTime <= 1193 time_t(HSOpts.ModuleCachePruneAfter)) { 1194 continue; 1195 } 1196 1197 // Remove the file. 1198 llvm::sys::fs::remove(File->path()); 1199 1200 // Remove the timestamp file. 1201 std::string TimpestampFilename = File->path() + ".timestamp"; 1202 llvm::sys::fs::remove(TimpestampFilename); 1203 } 1204 1205 // If we removed all of the files in the directory, remove the directory 1206 // itself. 1207 if (llvm::sys::fs::directory_iterator(Dir->path(), EC) == 1208 llvm::sys::fs::directory_iterator() && !EC) 1209 llvm::sys::fs::remove(Dir->path()); 1210 } 1211 } 1212 1213 void CompilerInstance::createModuleManager() { 1214 if (!ModuleManager) { 1215 if (!hasASTContext()) 1216 createASTContext(); 1217 1218 // If we're not recursively building a module, check whether we 1219 // need to prune the module cache. 1220 if (getSourceManager().getModuleBuildStack().empty() && 1221 getHeaderSearchOpts().ModuleCachePruneInterval > 0 && 1222 getHeaderSearchOpts().ModuleCachePruneAfter > 0) { 1223 pruneModuleCache(getHeaderSearchOpts()); 1224 } 1225 1226 HeaderSearchOptions &HSOpts = getHeaderSearchOpts(); 1227 std::string Sysroot = HSOpts.Sysroot; 1228 const PreprocessorOptions &PPOpts = getPreprocessorOpts(); 1229 ModuleManager = new ASTReader(getPreprocessor(), *Context, 1230 Sysroot.empty() ? "" : Sysroot.c_str(), 1231 PPOpts.DisablePCHValidation, 1232 /*AllowASTWithCompilerErrors=*/false, 1233 /*AllowConfigurationMismatch=*/false, 1234 HSOpts.ModulesValidateSystemHeaders, 1235 getFrontendOpts().UseGlobalModuleIndex); 1236 if (hasASTConsumer()) { 1237 ModuleManager->setDeserializationListener( 1238 getASTConsumer().GetASTDeserializationListener()); 1239 getASTContext().setASTMutationListener( 1240 getASTConsumer().GetASTMutationListener()); 1241 } 1242 getASTContext().setExternalSource(ModuleManager); 1243 if (hasSema()) 1244 ModuleManager->InitializeSema(getSema()); 1245 if (hasASTConsumer()) 1246 ModuleManager->StartTranslationUnit(&getASTConsumer()); 1247 } 1248 } 1249 1250 ModuleLoadResult 1251 CompilerInstance::loadModule(SourceLocation ImportLoc, 1252 ModuleIdPath Path, 1253 Module::NameVisibilityKind Visibility, 1254 bool IsInclusionDirective) { 1255 // Determine what file we're searching from. 1256 StringRef ModuleName = Path[0].first->getName(); 1257 SourceLocation ModuleNameLoc = Path[0].second; 1258 1259 // If we've already handled this import, just return the cached result. 1260 // This one-element cache is important to eliminate redundant diagnostics 1261 // when both the preprocessor and parser see the same import declaration. 1262 if (!ImportLoc.isInvalid() && LastModuleImportLoc == ImportLoc) { 1263 // Make the named module visible. 1264 if (LastModuleImportResult && ModuleName != getLangOpts().CurrentModule && 1265 ModuleName != getLangOpts().ImplementationOfModule) 1266 ModuleManager->makeModuleVisible(LastModuleImportResult, Visibility, 1267 ImportLoc, /*Complain=*/false); 1268 return LastModuleImportResult; 1269 } 1270 1271 clang::Module *Module = nullptr; 1272 1273 // If we don't already have information on this module, load the module now. 1274 llvm::DenseMap<const IdentifierInfo *, clang::Module *>::iterator Known 1275 = KnownModules.find(Path[0].first); 1276 if (Known != KnownModules.end()) { 1277 // Retrieve the cached top-level module. 1278 Module = Known->second; 1279 } else if (ModuleName == getLangOpts().CurrentModule || 1280 ModuleName == getLangOpts().ImplementationOfModule) { 1281 // This is the module we're building. 1282 Module = PP->getHeaderSearchInfo().lookupModule(ModuleName); 1283 Known = KnownModules.insert(std::make_pair(Path[0].first, Module)).first; 1284 } else { 1285 // Search for a module with the given name. 1286 Module = PP->getHeaderSearchInfo().lookupModule(ModuleName); 1287 if (!Module) { 1288 getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_found) 1289 << ModuleName 1290 << SourceRange(ImportLoc, ModuleNameLoc); 1291 ModuleBuildFailed = true; 1292 return ModuleLoadResult(); 1293 } 1294 1295 std::string ModuleFileName = 1296 PP->getHeaderSearchInfo().getModuleFileName(Module); 1297 1298 // If we don't already have an ASTReader, create one now. 1299 if (!ModuleManager) 1300 createModuleManager(); 1301 1302 if (TheDependencyFileGenerator) 1303 TheDependencyFileGenerator->AttachToASTReader(*ModuleManager); 1304 1305 if (ModuleDepCollector) 1306 ModuleDepCollector->attachToASTReader(*ModuleManager); 1307 1308 for (auto &Listener : DependencyCollectors) 1309 Listener->attachToASTReader(*ModuleManager); 1310 1311 // Try to load the module file. 1312 unsigned ARRFlags = ASTReader::ARR_OutOfDate | ASTReader::ARR_Missing; 1313 switch (ModuleManager->ReadAST(ModuleFileName, serialization::MK_Module, 1314 ImportLoc, ARRFlags)) { 1315 case ASTReader::Success: 1316 break; 1317 1318 case ASTReader::OutOfDate: 1319 case ASTReader::Missing: { 1320 // The module file is missing or out-of-date. Build it. 1321 assert(Module && "missing module file"); 1322 // Check whether there is a cycle in the module graph. 1323 ModuleBuildStack ModPath = getSourceManager().getModuleBuildStack(); 1324 ModuleBuildStack::iterator Pos = ModPath.begin(), PosEnd = ModPath.end(); 1325 for (; Pos != PosEnd; ++Pos) { 1326 if (Pos->first == ModuleName) 1327 break; 1328 } 1329 1330 if (Pos != PosEnd) { 1331 SmallString<256> CyclePath; 1332 for (; Pos != PosEnd; ++Pos) { 1333 CyclePath += Pos->first; 1334 CyclePath += " -> "; 1335 } 1336 CyclePath += ModuleName; 1337 1338 getDiagnostics().Report(ModuleNameLoc, diag::err_module_cycle) 1339 << ModuleName << CyclePath; 1340 return ModuleLoadResult(); 1341 } 1342 1343 getDiagnostics().Report(ImportLoc, diag::remark_module_build) 1344 << ModuleName << ModuleFileName; 1345 1346 // Check whether we have already attempted to build this module (but 1347 // failed). 1348 if (getPreprocessorOpts().FailedModules && 1349 getPreprocessorOpts().FailedModules->hasAlreadyFailed(ModuleName)) { 1350 getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_built) 1351 << ModuleName 1352 << SourceRange(ImportLoc, ModuleNameLoc); 1353 ModuleBuildFailed = true; 1354 return ModuleLoadResult(); 1355 } 1356 1357 // Try to compile and then load the module. 1358 if (!compileAndLoadModule(*this, ImportLoc, ModuleNameLoc, Module, 1359 ModuleFileName)) { 1360 if (getPreprocessorOpts().FailedModules) 1361 getPreprocessorOpts().FailedModules->addFailed(ModuleName); 1362 KnownModules[Path[0].first] = nullptr; 1363 ModuleBuildFailed = true; 1364 return ModuleLoadResult(); 1365 } 1366 1367 // Okay, we've rebuilt and now loaded the module. 1368 break; 1369 } 1370 1371 case ASTReader::VersionMismatch: 1372 case ASTReader::ConfigurationMismatch: 1373 case ASTReader::HadErrors: 1374 ModuleLoader::HadFatalFailure = true; 1375 // FIXME: The ASTReader will already have complained, but can we showhorn 1376 // that diagnostic information into a more useful form? 1377 KnownModules[Path[0].first] = nullptr; 1378 return ModuleLoadResult(); 1379 1380 case ASTReader::Failure: 1381 ModuleLoader::HadFatalFailure = true; 1382 // Already complained, but note now that we failed. 1383 KnownModules[Path[0].first] = nullptr; 1384 ModuleBuildFailed = true; 1385 return ModuleLoadResult(); 1386 } 1387 1388 // Cache the result of this top-level module lookup for later. 1389 Known = KnownModules.insert(std::make_pair(Path[0].first, Module)).first; 1390 } 1391 1392 // If we never found the module, fail. 1393 if (!Module) 1394 return ModuleLoadResult(); 1395 1396 // Verify that the rest of the module path actually corresponds to 1397 // a submodule. 1398 if (Path.size() > 1) { 1399 for (unsigned I = 1, N = Path.size(); I != N; ++I) { 1400 StringRef Name = Path[I].first->getName(); 1401 clang::Module *Sub = Module->findSubmodule(Name); 1402 1403 if (!Sub) { 1404 // Attempt to perform typo correction to find a module name that works. 1405 SmallVector<StringRef, 2> Best; 1406 unsigned BestEditDistance = (std::numeric_limits<unsigned>::max)(); 1407 1408 for (clang::Module::submodule_iterator J = Module->submodule_begin(), 1409 JEnd = Module->submodule_end(); 1410 J != JEnd; ++J) { 1411 unsigned ED = Name.edit_distance((*J)->Name, 1412 /*AllowReplacements=*/true, 1413 BestEditDistance); 1414 if (ED <= BestEditDistance) { 1415 if (ED < BestEditDistance) { 1416 Best.clear(); 1417 BestEditDistance = ED; 1418 } 1419 1420 Best.push_back((*J)->Name); 1421 } 1422 } 1423 1424 // If there was a clear winner, user it. 1425 if (Best.size() == 1) { 1426 getDiagnostics().Report(Path[I].second, 1427 diag::err_no_submodule_suggest) 1428 << Path[I].first << Module->getFullModuleName() << Best[0] 1429 << SourceRange(Path[0].second, Path[I-1].second) 1430 << FixItHint::CreateReplacement(SourceRange(Path[I].second), 1431 Best[0]); 1432 1433 Sub = Module->findSubmodule(Best[0]); 1434 } 1435 } 1436 1437 if (!Sub) { 1438 // No submodule by this name. Complain, and don't look for further 1439 // submodules. 1440 getDiagnostics().Report(Path[I].second, diag::err_no_submodule) 1441 << Path[I].first << Module->getFullModuleName() 1442 << SourceRange(Path[0].second, Path[I-1].second); 1443 break; 1444 } 1445 1446 Module = Sub; 1447 } 1448 } 1449 1450 // Don't make the module visible if we are in the implementation. 1451 if (ModuleName == getLangOpts().ImplementationOfModule) 1452 return ModuleLoadResult(Module, false); 1453 1454 // Make the named module visible, if it's not already part of the module 1455 // we are parsing. 1456 if (ModuleName != getLangOpts().CurrentModule) { 1457 if (!Module->IsFromModuleFile) { 1458 // We have an umbrella header or directory that doesn't actually include 1459 // all of the headers within the directory it covers. Complain about 1460 // this missing submodule and recover by forgetting that we ever saw 1461 // this submodule. 1462 // FIXME: Should we detect this at module load time? It seems fairly 1463 // expensive (and rare). 1464 getDiagnostics().Report(ImportLoc, diag::warn_missing_submodule) 1465 << Module->getFullModuleName() 1466 << SourceRange(Path.front().second, Path.back().second); 1467 1468 return ModuleLoadResult(nullptr, true); 1469 } 1470 1471 // Check whether this module is available. 1472 clang::Module::Requirement Requirement; 1473 clang::Module::HeaderDirective MissingHeader; 1474 if (!Module->isAvailable(getLangOpts(), getTarget(), Requirement, 1475 MissingHeader)) { 1476 if (MissingHeader.FileNameLoc.isValid()) { 1477 getDiagnostics().Report(MissingHeader.FileNameLoc, 1478 diag::err_module_header_missing) 1479 << MissingHeader.IsUmbrella << MissingHeader.FileName; 1480 } else { 1481 getDiagnostics().Report(ImportLoc, diag::err_module_unavailable) 1482 << Module->getFullModuleName() 1483 << Requirement.second << Requirement.first 1484 << SourceRange(Path.front().second, Path.back().second); 1485 } 1486 LastModuleImportLoc = ImportLoc; 1487 LastModuleImportResult = ModuleLoadResult(); 1488 return ModuleLoadResult(); 1489 } 1490 1491 ModuleManager->makeModuleVisible(Module, Visibility, ImportLoc, 1492 /*Complain=*/true); 1493 } 1494 1495 // Check for any configuration macros that have changed. 1496 clang::Module *TopModule = Module->getTopLevelModule(); 1497 for (unsigned I = 0, N = TopModule->ConfigMacros.size(); I != N; ++I) { 1498 checkConfigMacro(getPreprocessor(), TopModule->ConfigMacros[I], 1499 Module, ImportLoc); 1500 } 1501 1502 // If this module import was due to an inclusion directive, create an 1503 // implicit import declaration to capture it in the AST. 1504 if (IsInclusionDirective && hasASTContext()) { 1505 TranslationUnitDecl *TU = getASTContext().getTranslationUnitDecl(); 1506 ImportDecl *ImportD = ImportDecl::CreateImplicit(getASTContext(), TU, 1507 ImportLoc, Module, 1508 Path.back().second); 1509 TU->addDecl(ImportD); 1510 if (Consumer) 1511 Consumer->HandleImplicitImportDecl(ImportD); 1512 } 1513 1514 LastModuleImportLoc = ImportLoc; 1515 LastModuleImportResult = ModuleLoadResult(Module, false); 1516 return LastModuleImportResult; 1517 } 1518 1519 void CompilerInstance::makeModuleVisible(Module *Mod, 1520 Module::NameVisibilityKind Visibility, 1521 SourceLocation ImportLoc, 1522 bool Complain){ 1523 ModuleManager->makeModuleVisible(Mod, Visibility, ImportLoc, Complain); 1524 } 1525 1526 GlobalModuleIndex *CompilerInstance::loadGlobalModuleIndex( 1527 SourceLocation TriggerLoc) { 1528 if (!ModuleManager) 1529 createModuleManager(); 1530 // Can't do anything if we don't have the module manager. 1531 if (!ModuleManager) 1532 return nullptr; 1533 // Get an existing global index. This loads it if not already 1534 // loaded. 1535 ModuleManager->loadGlobalIndex(); 1536 GlobalModuleIndex *GlobalIndex = ModuleManager->getGlobalIndex(); 1537 // If the global index doesn't exist, create it. 1538 if (!GlobalIndex && shouldBuildGlobalModuleIndex() && hasFileManager() && 1539 hasPreprocessor()) { 1540 llvm::sys::fs::create_directories( 1541 getPreprocessor().getHeaderSearchInfo().getModuleCachePath()); 1542 GlobalModuleIndex::writeIndex( 1543 getFileManager(), 1544 getPreprocessor().getHeaderSearchInfo().getModuleCachePath()); 1545 ModuleManager->resetForReload(); 1546 ModuleManager->loadGlobalIndex(); 1547 GlobalIndex = ModuleManager->getGlobalIndex(); 1548 } 1549 // For finding modules needing to be imported for fixit messages, 1550 // we need to make the global index cover all modules, so we do that here. 1551 if (!HaveFullGlobalModuleIndex && GlobalIndex && !buildingModule()) { 1552 ModuleMap &MMap = getPreprocessor().getHeaderSearchInfo().getModuleMap(); 1553 bool RecreateIndex = false; 1554 for (ModuleMap::module_iterator I = MMap.module_begin(), 1555 E = MMap.module_end(); I != E; ++I) { 1556 Module *TheModule = I->second; 1557 const FileEntry *Entry = TheModule->getASTFile(); 1558 if (!Entry) { 1559 SmallVector<std::pair<IdentifierInfo *, SourceLocation>, 2> Path; 1560 Path.push_back(std::make_pair( 1561 getPreprocessor().getIdentifierInfo(TheModule->Name), TriggerLoc)); 1562 std::reverse(Path.begin(), Path.end()); 1563 // Load a module as hidden. This also adds it to the global index. 1564 loadModule(TheModule->DefinitionLoc, Path, 1565 Module::Hidden, false); 1566 RecreateIndex = true; 1567 } 1568 } 1569 if (RecreateIndex) { 1570 GlobalModuleIndex::writeIndex( 1571 getFileManager(), 1572 getPreprocessor().getHeaderSearchInfo().getModuleCachePath()); 1573 ModuleManager->resetForReload(); 1574 ModuleManager->loadGlobalIndex(); 1575 GlobalIndex = ModuleManager->getGlobalIndex(); 1576 } 1577 HaveFullGlobalModuleIndex = true; 1578 } 1579 return GlobalIndex; 1580 } 1581 1582 // Check global module index for missing imports. 1583 bool 1584 CompilerInstance::lookupMissingImports(StringRef Name, 1585 SourceLocation TriggerLoc) { 1586 // Look for the symbol in non-imported modules, but only if an error 1587 // actually occurred. 1588 if (!buildingModule()) { 1589 // Load global module index, or retrieve a previously loaded one. 1590 GlobalModuleIndex *GlobalIndex = loadGlobalModuleIndex( 1591 TriggerLoc); 1592 1593 // Only if we have a global index. 1594 if (GlobalIndex) { 1595 GlobalModuleIndex::HitSet FoundModules; 1596 1597 // Find the modules that reference the identifier. 1598 // Note that this only finds top-level modules. 1599 // We'll let diagnoseTypo find the actual declaration module. 1600 if (GlobalIndex->lookupIdentifier(Name, FoundModules)) 1601 return true; 1602 } 1603 } 1604 1605 return false; 1606 } 1607 void CompilerInstance::resetAndLeakSema() { BuryPointer(takeSema()); } 1608