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