1 //===--- FrontendAction.cpp -----------------------------------------------===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 9 #include "clang/Frontend/FrontendAction.h" 10 #include "clang/AST/ASTConsumer.h" 11 #include "clang/AST/ASTContext.h" 12 #include "clang/AST/DeclGroup.h" 13 #include "clang/Basic/Builtins.h" 14 #include "clang/Basic/LangStandard.h" 15 #include "clang/Frontend/ASTUnit.h" 16 #include "clang/Frontend/CompilerInstance.h" 17 #include "clang/Frontend/FrontendDiagnostic.h" 18 #include "clang/Frontend/FrontendPluginRegistry.h" 19 #include "clang/Frontend/LayoutOverrideSource.h" 20 #include "clang/Frontend/MultiplexConsumer.h" 21 #include "clang/Frontend/Utils.h" 22 #include "clang/Lex/HeaderSearch.h" 23 #include "clang/Lex/LiteralSupport.h" 24 #include "clang/Lex/Preprocessor.h" 25 #include "clang/Lex/PreprocessorOptions.h" 26 #include "clang/Parse/ParseAST.h" 27 #include "clang/Serialization/ASTDeserializationListener.h" 28 #include "clang/Serialization/ASTReader.h" 29 #include "clang/Serialization/GlobalModuleIndex.h" 30 #include "llvm/ADT/ScopeExit.h" 31 #include "llvm/Support/BuryPointer.h" 32 #include "llvm/Support/ErrorHandling.h" 33 #include "llvm/Support/FileSystem.h" 34 #include "llvm/Support/Path.h" 35 #include "llvm/Support/Timer.h" 36 #include "llvm/Support/raw_ostream.h" 37 #include <system_error> 38 using namespace clang; 39 40 LLVM_INSTANTIATE_REGISTRY(FrontendPluginRegistry) 41 42 namespace { 43 44 class DelegatingDeserializationListener : public ASTDeserializationListener { 45 ASTDeserializationListener *Previous; 46 bool DeletePrevious; 47 48 public: 49 explicit DelegatingDeserializationListener( 50 ASTDeserializationListener *Previous, bool DeletePrevious) 51 : Previous(Previous), DeletePrevious(DeletePrevious) {} 52 ~DelegatingDeserializationListener() override { 53 if (DeletePrevious) 54 delete Previous; 55 } 56 57 void ReaderInitialized(ASTReader *Reader) override { 58 if (Previous) 59 Previous->ReaderInitialized(Reader); 60 } 61 void IdentifierRead(serialization::IdentID ID, 62 IdentifierInfo *II) override { 63 if (Previous) 64 Previous->IdentifierRead(ID, II); 65 } 66 void TypeRead(serialization::TypeIdx Idx, QualType T) override { 67 if (Previous) 68 Previous->TypeRead(Idx, T); 69 } 70 void DeclRead(serialization::DeclID ID, const Decl *D) override { 71 if (Previous) 72 Previous->DeclRead(ID, D); 73 } 74 void SelectorRead(serialization::SelectorID ID, Selector Sel) override { 75 if (Previous) 76 Previous->SelectorRead(ID, Sel); 77 } 78 void MacroDefinitionRead(serialization::PreprocessedEntityID PPID, 79 MacroDefinitionRecord *MD) override { 80 if (Previous) 81 Previous->MacroDefinitionRead(PPID, MD); 82 } 83 }; 84 85 /// Dumps deserialized declarations. 86 class DeserializedDeclsDumper : public DelegatingDeserializationListener { 87 public: 88 explicit DeserializedDeclsDumper(ASTDeserializationListener *Previous, 89 bool DeletePrevious) 90 : DelegatingDeserializationListener(Previous, DeletePrevious) {} 91 92 void DeclRead(serialization::DeclID ID, const Decl *D) override { 93 llvm::outs() << "PCH DECL: " << D->getDeclKindName(); 94 if (const NamedDecl *ND = dyn_cast<NamedDecl>(D)) { 95 llvm::outs() << " - "; 96 ND->printQualifiedName(llvm::outs()); 97 } 98 llvm::outs() << "\n"; 99 100 DelegatingDeserializationListener::DeclRead(ID, D); 101 } 102 }; 103 104 /// Checks deserialized declarations and emits error if a name 105 /// matches one given in command-line using -error-on-deserialized-decl. 106 class DeserializedDeclsChecker : public DelegatingDeserializationListener { 107 ASTContext &Ctx; 108 std::set<std::string> NamesToCheck; 109 110 public: 111 DeserializedDeclsChecker(ASTContext &Ctx, 112 const std::set<std::string> &NamesToCheck, 113 ASTDeserializationListener *Previous, 114 bool DeletePrevious) 115 : DelegatingDeserializationListener(Previous, DeletePrevious), Ctx(Ctx), 116 NamesToCheck(NamesToCheck) {} 117 118 void DeclRead(serialization::DeclID ID, const Decl *D) override { 119 if (const NamedDecl *ND = dyn_cast<NamedDecl>(D)) 120 if (NamesToCheck.find(ND->getNameAsString()) != NamesToCheck.end()) { 121 unsigned DiagID 122 = Ctx.getDiagnostics().getCustomDiagID(DiagnosticsEngine::Error, 123 "%0 was deserialized"); 124 Ctx.getDiagnostics().Report(Ctx.getFullLoc(D->getLocation()), DiagID) 125 << ND; 126 } 127 128 DelegatingDeserializationListener::DeclRead(ID, D); 129 } 130 }; 131 132 } // end anonymous namespace 133 134 FrontendAction::FrontendAction() : Instance(nullptr) {} 135 136 FrontendAction::~FrontendAction() {} 137 138 void FrontendAction::setCurrentInput(const FrontendInputFile &CurrentInput, 139 std::unique_ptr<ASTUnit> AST) { 140 this->CurrentInput = CurrentInput; 141 CurrentASTUnit = std::move(AST); 142 } 143 144 Module *FrontendAction::getCurrentModule() const { 145 CompilerInstance &CI = getCompilerInstance(); 146 return CI.getPreprocessor().getHeaderSearchInfo().lookupModule( 147 CI.getLangOpts().CurrentModule, SourceLocation(), /*AllowSearch*/false); 148 } 149 150 std::unique_ptr<ASTConsumer> 151 FrontendAction::CreateWrappedASTConsumer(CompilerInstance &CI, 152 StringRef InFile) { 153 std::unique_ptr<ASTConsumer> Consumer = CreateASTConsumer(CI, InFile); 154 if (!Consumer) 155 return nullptr; 156 157 // Validate -add-plugin args. 158 bool FoundAllPlugins = true; 159 for (const std::string &Arg : CI.getFrontendOpts().AddPluginActions) { 160 bool Found = false; 161 for (const FrontendPluginRegistry::entry &Plugin : 162 FrontendPluginRegistry::entries()) { 163 if (Plugin.getName() == Arg) 164 Found = true; 165 } 166 if (!Found) { 167 CI.getDiagnostics().Report(diag::err_fe_invalid_plugin_name) << Arg; 168 FoundAllPlugins = false; 169 } 170 } 171 if (!FoundAllPlugins) 172 return nullptr; 173 174 // If there are no registered plugins we don't need to wrap the consumer 175 if (FrontendPluginRegistry::begin() == FrontendPluginRegistry::end()) 176 return Consumer; 177 178 // If this is a code completion run, avoid invoking the plugin consumers 179 if (CI.hasCodeCompletionConsumer()) 180 return Consumer; 181 182 // Collect the list of plugins that go before the main action (in Consumers) 183 // or after it (in AfterConsumers) 184 std::vector<std::unique_ptr<ASTConsumer>> Consumers; 185 std::vector<std::unique_ptr<ASTConsumer>> AfterConsumers; 186 for (const FrontendPluginRegistry::entry &Plugin : 187 FrontendPluginRegistry::entries()) { 188 std::unique_ptr<PluginASTAction> P = Plugin.instantiate(); 189 PluginASTAction::ActionType ActionType = P->getActionType(); 190 if (ActionType == PluginASTAction::CmdlineAfterMainAction || 191 ActionType == PluginASTAction::CmdlineBeforeMainAction) { 192 // This is O(|plugins| * |add_plugins|), but since both numbers are 193 // way below 50 in practice, that's ok. 194 if (llvm::any_of(CI.getFrontendOpts().AddPluginActions, 195 [&](const std::string &PluginAction) { 196 return PluginAction == Plugin.getName(); 197 })) { 198 if (ActionType == PluginASTAction::CmdlineBeforeMainAction) 199 ActionType = PluginASTAction::AddBeforeMainAction; 200 else 201 ActionType = PluginASTAction::AddAfterMainAction; 202 } 203 } 204 if ((ActionType == PluginASTAction::AddBeforeMainAction || 205 ActionType == PluginASTAction::AddAfterMainAction) && 206 P->ParseArgs( 207 CI, 208 CI.getFrontendOpts().PluginArgs[std::string(Plugin.getName())])) { 209 std::unique_ptr<ASTConsumer> PluginConsumer = P->CreateASTConsumer(CI, InFile); 210 if (ActionType == PluginASTAction::AddBeforeMainAction) { 211 Consumers.push_back(std::move(PluginConsumer)); 212 } else { 213 AfterConsumers.push_back(std::move(PluginConsumer)); 214 } 215 } 216 } 217 218 // Add to Consumers the main consumer, then all the plugins that go after it 219 Consumers.push_back(std::move(Consumer)); 220 if (!AfterConsumers.empty()) { 221 // If we have plugins after the main consumer, which may be the codegen 222 // action, they likely will need the ASTContext, so don't clear it in the 223 // codegen action. 224 CI.getCodeGenOpts().ClearASTBeforeBackend = false; 225 for (auto &C : AfterConsumers) 226 Consumers.push_back(std::move(C)); 227 } 228 229 return std::make_unique<MultiplexConsumer>(std::move(Consumers)); 230 } 231 232 /// For preprocessed files, if the first line is the linemarker and specifies 233 /// the original source file name, use that name as the input file name. 234 /// Returns the location of the first token after the line marker directive. 235 /// 236 /// \param CI The compiler instance. 237 /// \param InputFile Populated with the filename from the line marker. 238 /// \param IsModuleMap If \c true, add a line note corresponding to this line 239 /// directive. (We need to do this because the directive will not be 240 /// visited by the preprocessor.) 241 static SourceLocation ReadOriginalFileName(CompilerInstance &CI, 242 std::string &InputFile, 243 bool IsModuleMap = false) { 244 auto &SourceMgr = CI.getSourceManager(); 245 auto MainFileID = SourceMgr.getMainFileID(); 246 247 auto MainFileBuf = SourceMgr.getBufferOrNone(MainFileID); 248 if (!MainFileBuf) 249 return SourceLocation(); 250 251 std::unique_ptr<Lexer> RawLexer( 252 new Lexer(MainFileID, *MainFileBuf, SourceMgr, CI.getLangOpts())); 253 254 // If the first line has the syntax of 255 // 256 // # NUM "FILENAME" 257 // 258 // we use FILENAME as the input file name. 259 Token T; 260 if (RawLexer->LexFromRawLexer(T) || T.getKind() != tok::hash) 261 return SourceLocation(); 262 if (RawLexer->LexFromRawLexer(T) || T.isAtStartOfLine() || 263 T.getKind() != tok::numeric_constant) 264 return SourceLocation(); 265 266 unsigned LineNo; 267 SourceLocation LineNoLoc = T.getLocation(); 268 if (IsModuleMap) { 269 llvm::SmallString<16> Buffer; 270 if (Lexer::getSpelling(LineNoLoc, Buffer, SourceMgr, CI.getLangOpts()) 271 .getAsInteger(10, LineNo)) 272 return SourceLocation(); 273 } 274 275 RawLexer->LexFromRawLexer(T); 276 if (T.isAtStartOfLine() || T.getKind() != tok::string_literal) 277 return SourceLocation(); 278 279 StringLiteralParser Literal(T, CI.getPreprocessor()); 280 if (Literal.hadError) 281 return SourceLocation(); 282 RawLexer->LexFromRawLexer(T); 283 if (T.isNot(tok::eof) && !T.isAtStartOfLine()) 284 return SourceLocation(); 285 InputFile = Literal.GetString().str(); 286 287 if (IsModuleMap) 288 CI.getSourceManager().AddLineNote( 289 LineNoLoc, LineNo, SourceMgr.getLineTableFilenameID(InputFile), false, 290 false, SrcMgr::C_User_ModuleMap); 291 292 return T.getLocation(); 293 } 294 295 static SmallVectorImpl<char> & 296 operator+=(SmallVectorImpl<char> &Includes, StringRef RHS) { 297 Includes.append(RHS.begin(), RHS.end()); 298 return Includes; 299 } 300 301 static void addHeaderInclude(StringRef HeaderName, 302 SmallVectorImpl<char> &Includes, 303 const LangOptions &LangOpts, 304 bool IsExternC) { 305 if (IsExternC && LangOpts.CPlusPlus) 306 Includes += "extern \"C\" {\n"; 307 if (LangOpts.ObjC) 308 Includes += "#import \""; 309 else 310 Includes += "#include \""; 311 312 Includes += HeaderName; 313 314 Includes += "\"\n"; 315 if (IsExternC && LangOpts.CPlusPlus) 316 Includes += "}\n"; 317 } 318 319 /// Collect the set of header includes needed to construct the given 320 /// module and update the TopHeaders file set of the module. 321 /// 322 /// \param Module The module we're collecting includes from. 323 /// 324 /// \param Includes Will be augmented with the set of \#includes or \#imports 325 /// needed to load all of the named headers. 326 static std::error_code collectModuleHeaderIncludes( 327 const LangOptions &LangOpts, FileManager &FileMgr, DiagnosticsEngine &Diag, 328 ModuleMap &ModMap, clang::Module *Module, SmallVectorImpl<char> &Includes) { 329 // Don't collect any headers for unavailable modules. 330 if (!Module->isAvailable()) 331 return std::error_code(); 332 333 // Resolve all lazy header directives to header files. 334 ModMap.resolveHeaderDirectives(Module); 335 336 // If any headers are missing, we can't build this module. In most cases, 337 // diagnostics for this should have already been produced; we only get here 338 // if explicit stat information was provided. 339 // FIXME: If the name resolves to a file with different stat information, 340 // produce a better diagnostic. 341 if (!Module->MissingHeaders.empty()) { 342 auto &MissingHeader = Module->MissingHeaders.front(); 343 Diag.Report(MissingHeader.FileNameLoc, diag::err_module_header_missing) 344 << MissingHeader.IsUmbrella << MissingHeader.FileName; 345 return std::error_code(); 346 } 347 348 // Add includes for each of these headers. 349 for (auto HK : {Module::HK_Normal, Module::HK_Private}) { 350 for (Module::Header &H : Module->Headers[HK]) { 351 Module->addTopHeader(H.Entry); 352 // Use the path as specified in the module map file. We'll look for this 353 // file relative to the module build directory (the directory containing 354 // the module map file) so this will find the same file that we found 355 // while parsing the module map. 356 addHeaderInclude(H.PathRelativeToRootModuleDirectory, Includes, LangOpts, 357 Module->IsExternC); 358 } 359 } 360 // Note that Module->PrivateHeaders will not be a TopHeader. 361 362 if (Module::Header UmbrellaHeader = Module->getUmbrellaHeader()) { 363 Module->addTopHeader(UmbrellaHeader.Entry); 364 if (Module->Parent) 365 // Include the umbrella header for submodules. 366 addHeaderInclude(UmbrellaHeader.PathRelativeToRootModuleDirectory, 367 Includes, LangOpts, Module->IsExternC); 368 } else if (Module::DirectoryName UmbrellaDir = Module->getUmbrellaDir()) { 369 // Add all of the headers we find in this subdirectory. 370 std::error_code EC; 371 SmallString<128> DirNative; 372 llvm::sys::path::native(UmbrellaDir.Entry->getName(), DirNative); 373 374 llvm::vfs::FileSystem &FS = FileMgr.getVirtualFileSystem(); 375 SmallVector<std::pair<std::string, const FileEntry *>, 8> Headers; 376 for (llvm::vfs::recursive_directory_iterator Dir(FS, DirNative, EC), End; 377 Dir != End && !EC; Dir.increment(EC)) { 378 // Check whether this entry has an extension typically associated with 379 // headers. 380 if (!llvm::StringSwitch<bool>(llvm::sys::path::extension(Dir->path())) 381 .Cases(".h", ".H", ".hh", ".hpp", true) 382 .Default(false)) 383 continue; 384 385 auto Header = FileMgr.getFile(Dir->path()); 386 // FIXME: This shouldn't happen unless there is a file system race. Is 387 // that worth diagnosing? 388 if (!Header) 389 continue; 390 391 // If this header is marked 'unavailable' in this module, don't include 392 // it. 393 if (ModMap.isHeaderUnavailableInModule(*Header, Module)) 394 continue; 395 396 // Compute the relative path from the directory to this file. 397 SmallVector<StringRef, 16> Components; 398 auto PathIt = llvm::sys::path::rbegin(Dir->path()); 399 for (int I = 0; I != Dir.level() + 1; ++I, ++PathIt) 400 Components.push_back(*PathIt); 401 SmallString<128> RelativeHeader( 402 UmbrellaDir.PathRelativeToRootModuleDirectory); 403 for (auto It = Components.rbegin(), End = Components.rend(); It != End; 404 ++It) 405 llvm::sys::path::append(RelativeHeader, *It); 406 407 std::string RelName = RelativeHeader.c_str(); 408 Headers.push_back(std::make_pair(RelName, *Header)); 409 } 410 411 if (EC) 412 return EC; 413 414 // Sort header paths and make the header inclusion order deterministic 415 // across different OSs and filesystems. 416 llvm::sort(Headers.begin(), Headers.end(), []( 417 const std::pair<std::string, const FileEntry *> &LHS, 418 const std::pair<std::string, const FileEntry *> &RHS) { 419 return LHS.first < RHS.first; 420 }); 421 for (auto &H : Headers) { 422 // Include this header as part of the umbrella directory. 423 Module->addTopHeader(H.second); 424 addHeaderInclude(H.first, Includes, LangOpts, Module->IsExternC); 425 } 426 } 427 428 // Recurse into submodules. 429 for (clang::Module::submodule_iterator Sub = Module->submodule_begin(), 430 SubEnd = Module->submodule_end(); 431 Sub != SubEnd; ++Sub) 432 if (std::error_code Err = collectModuleHeaderIncludes( 433 LangOpts, FileMgr, Diag, ModMap, *Sub, Includes)) 434 return Err; 435 436 return std::error_code(); 437 } 438 439 static bool loadModuleMapForModuleBuild(CompilerInstance &CI, bool IsSystem, 440 bool IsPreprocessed, 441 std::string &PresumedModuleMapFile, 442 unsigned &Offset) { 443 auto &SrcMgr = CI.getSourceManager(); 444 HeaderSearch &HS = CI.getPreprocessor().getHeaderSearchInfo(); 445 446 // Map the current input to a file. 447 FileID ModuleMapID = SrcMgr.getMainFileID(); 448 const FileEntry *ModuleMap = SrcMgr.getFileEntryForID(ModuleMapID); 449 450 // If the module map is preprocessed, handle the initial line marker; 451 // line directives are not part of the module map syntax in general. 452 Offset = 0; 453 if (IsPreprocessed) { 454 SourceLocation EndOfLineMarker = 455 ReadOriginalFileName(CI, PresumedModuleMapFile, /*IsModuleMap*/ true); 456 if (EndOfLineMarker.isValid()) 457 Offset = CI.getSourceManager().getDecomposedLoc(EndOfLineMarker).second; 458 } 459 460 // Load the module map file. 461 if (HS.loadModuleMapFile(ModuleMap, IsSystem, ModuleMapID, &Offset, 462 PresumedModuleMapFile)) 463 return true; 464 465 if (SrcMgr.getBufferOrFake(ModuleMapID).getBufferSize() == Offset) 466 Offset = 0; 467 468 return false; 469 } 470 471 static Module *prepareToBuildModule(CompilerInstance &CI, 472 StringRef ModuleMapFilename) { 473 if (CI.getLangOpts().CurrentModule.empty()) { 474 CI.getDiagnostics().Report(diag::err_missing_module_name); 475 476 // FIXME: Eventually, we could consider asking whether there was just 477 // a single module described in the module map, and use that as a 478 // default. Then it would be fairly trivial to just "compile" a module 479 // map with a single module (the common case). 480 return nullptr; 481 } 482 483 // Dig out the module definition. 484 HeaderSearch &HS = CI.getPreprocessor().getHeaderSearchInfo(); 485 Module *M = HS.lookupModule(CI.getLangOpts().CurrentModule, SourceLocation(), 486 /*AllowSearch=*/true); 487 if (!M) { 488 CI.getDiagnostics().Report(diag::err_missing_module) 489 << CI.getLangOpts().CurrentModule << ModuleMapFilename; 490 491 return nullptr; 492 } 493 494 // Check whether we can build this module at all. 495 if (Preprocessor::checkModuleIsAvailable(CI.getLangOpts(), CI.getTarget(), 496 CI.getDiagnostics(), M)) 497 return nullptr; 498 499 // Inform the preprocessor that includes from within the input buffer should 500 // be resolved relative to the build directory of the module map file. 501 CI.getPreprocessor().setMainFileDir(M->Directory); 502 503 // If the module was inferred from a different module map (via an expanded 504 // umbrella module definition), track that fact. 505 // FIXME: It would be preferable to fill this in as part of processing 506 // the module map, rather than adding it after the fact. 507 StringRef OriginalModuleMapName = CI.getFrontendOpts().OriginalModuleMap; 508 if (!OriginalModuleMapName.empty()) { 509 auto OriginalModuleMap = 510 CI.getFileManager().getFile(OriginalModuleMapName, 511 /*openFile*/ true); 512 if (!OriginalModuleMap) { 513 CI.getDiagnostics().Report(diag::err_module_map_not_found) 514 << OriginalModuleMapName; 515 return nullptr; 516 } 517 if (*OriginalModuleMap != CI.getSourceManager().getFileEntryForID( 518 CI.getSourceManager().getMainFileID())) { 519 M->IsInferred = true; 520 CI.getPreprocessor().getHeaderSearchInfo().getModuleMap() 521 .setInferredModuleAllowedBy(M, *OriginalModuleMap); 522 } 523 } 524 525 // If we're being run from the command-line, the module build stack will not 526 // have been filled in yet, so complete it now in order to allow us to detect 527 // module cycles. 528 SourceManager &SourceMgr = CI.getSourceManager(); 529 if (SourceMgr.getModuleBuildStack().empty()) 530 SourceMgr.pushModuleBuildStack(CI.getLangOpts().CurrentModule, 531 FullSourceLoc(SourceLocation(), SourceMgr)); 532 return M; 533 } 534 535 /// Compute the input buffer that should be used to build the specified module. 536 static std::unique_ptr<llvm::MemoryBuffer> 537 getInputBufferForModule(CompilerInstance &CI, Module *M) { 538 FileManager &FileMgr = CI.getFileManager(); 539 540 // Collect the set of #includes we need to build the module. 541 SmallString<256> HeaderContents; 542 std::error_code Err = std::error_code(); 543 if (Module::Header UmbrellaHeader = M->getUmbrellaHeader()) 544 addHeaderInclude(UmbrellaHeader.PathRelativeToRootModuleDirectory, 545 HeaderContents, CI.getLangOpts(), M->IsExternC); 546 Err = collectModuleHeaderIncludes( 547 CI.getLangOpts(), FileMgr, CI.getDiagnostics(), 548 CI.getPreprocessor().getHeaderSearchInfo().getModuleMap(), M, 549 HeaderContents); 550 551 if (Err) { 552 CI.getDiagnostics().Report(diag::err_module_cannot_create_includes) 553 << M->getFullModuleName() << Err.message(); 554 return nullptr; 555 } 556 557 return llvm::MemoryBuffer::getMemBufferCopy( 558 HeaderContents, Module::getModuleInputBufferName()); 559 } 560 561 bool FrontendAction::BeginSourceFile(CompilerInstance &CI, 562 const FrontendInputFile &RealInput) { 563 FrontendInputFile Input(RealInput); 564 assert(!Instance && "Already processing a source file!"); 565 assert(!Input.isEmpty() && "Unexpected empty filename!"); 566 setCurrentInput(Input); 567 setCompilerInstance(&CI); 568 569 bool HasBegunSourceFile = false; 570 bool ReplayASTFile = Input.getKind().getFormat() == InputKind::Precompiled && 571 usesPreprocessorOnly(); 572 573 // If we fail, reset state since the client will not end up calling the 574 // matching EndSourceFile(). All paths that return true should release this. 575 auto FailureCleanup = llvm::make_scope_exit([&]() { 576 if (HasBegunSourceFile) 577 CI.getDiagnosticClient().EndSourceFile(); 578 CI.clearOutputFiles(/*EraseFiles=*/true); 579 CI.getLangOpts().setCompilingModule(LangOptions::CMK_None); 580 setCurrentInput(FrontendInputFile()); 581 setCompilerInstance(nullptr); 582 }); 583 584 if (!BeginInvocation(CI)) 585 return false; 586 587 // If we're replaying the build of an AST file, import it and set up 588 // the initial state from its build. 589 if (ReplayASTFile) { 590 IntrusiveRefCntPtr<DiagnosticsEngine> Diags(&CI.getDiagnostics()); 591 592 // The AST unit populates its own diagnostics engine rather than ours. 593 IntrusiveRefCntPtr<DiagnosticsEngine> ASTDiags( 594 new DiagnosticsEngine(Diags->getDiagnosticIDs(), 595 &Diags->getDiagnosticOptions())); 596 ASTDiags->setClient(Diags->getClient(), /*OwnsClient*/false); 597 598 // FIXME: What if the input is a memory buffer? 599 StringRef InputFile = Input.getFile(); 600 601 std::unique_ptr<ASTUnit> AST = ASTUnit::LoadFromASTFile( 602 std::string(InputFile), CI.getPCHContainerReader(), 603 ASTUnit::LoadPreprocessorOnly, ASTDiags, CI.getFileSystemOpts(), 604 CI.getCodeGenOpts().DebugTypeExtRefs); 605 if (!AST) 606 return false; 607 608 // Options relating to how we treat the input (but not what we do with it) 609 // are inherited from the AST unit. 610 CI.getHeaderSearchOpts() = AST->getHeaderSearchOpts(); 611 CI.getPreprocessorOpts() = AST->getPreprocessorOpts(); 612 CI.getLangOpts() = AST->getLangOpts(); 613 614 // Set the shared objects, these are reset when we finish processing the 615 // file, otherwise the CompilerInstance will happily destroy them. 616 CI.setFileManager(&AST->getFileManager()); 617 CI.createSourceManager(CI.getFileManager()); 618 CI.getSourceManager().initializeForReplay(AST->getSourceManager()); 619 620 // Preload all the module files loaded transitively by the AST unit. Also 621 // load all module map files that were parsed as part of building the AST 622 // unit. 623 if (auto ASTReader = AST->getASTReader()) { 624 auto &MM = ASTReader->getModuleManager(); 625 auto &PrimaryModule = MM.getPrimaryModule(); 626 627 for (serialization::ModuleFile &MF : MM) 628 if (&MF != &PrimaryModule) 629 CI.getFrontendOpts().ModuleFiles.push_back(MF.FileName); 630 631 ASTReader->visitTopLevelModuleMaps( 632 PrimaryModule, [&](const FileEntry *FE) { 633 CI.getFrontendOpts().ModuleMapFiles.push_back( 634 std::string(FE->getName())); 635 }); 636 } 637 638 // Set up the input file for replay purposes. 639 auto Kind = AST->getInputKind(); 640 if (Kind.getFormat() == InputKind::ModuleMap) { 641 Module *ASTModule = 642 AST->getPreprocessor().getHeaderSearchInfo().lookupModule( 643 AST->getLangOpts().CurrentModule, SourceLocation(), 644 /*AllowSearch*/ false); 645 assert(ASTModule && "module file does not define its own module"); 646 Input = FrontendInputFile(ASTModule->PresumedModuleMapFile, Kind); 647 } else { 648 auto &OldSM = AST->getSourceManager(); 649 FileID ID = OldSM.getMainFileID(); 650 if (auto *File = OldSM.getFileEntryForID(ID)) 651 Input = FrontendInputFile(File->getName(), Kind); 652 else 653 Input = FrontendInputFile(OldSM.getBufferOrFake(ID), Kind); 654 } 655 setCurrentInput(Input, std::move(AST)); 656 } 657 658 // AST files follow a very different path, since they share objects via the 659 // AST unit. 660 if (Input.getKind().getFormat() == InputKind::Precompiled) { 661 assert(!usesPreprocessorOnly() && "this case was handled above"); 662 assert(hasASTFileSupport() && 663 "This action does not have AST file support!"); 664 665 IntrusiveRefCntPtr<DiagnosticsEngine> Diags(&CI.getDiagnostics()); 666 667 // FIXME: What if the input is a memory buffer? 668 StringRef InputFile = Input.getFile(); 669 670 std::unique_ptr<ASTUnit> AST = ASTUnit::LoadFromASTFile( 671 std::string(InputFile), CI.getPCHContainerReader(), 672 ASTUnit::LoadEverything, Diags, CI.getFileSystemOpts(), 673 CI.getCodeGenOpts().DebugTypeExtRefs); 674 675 if (!AST) 676 return false; 677 678 // Inform the diagnostic client we are processing a source file. 679 CI.getDiagnosticClient().BeginSourceFile(CI.getLangOpts(), nullptr); 680 HasBegunSourceFile = true; 681 682 // Set the shared objects, these are reset when we finish processing the 683 // file, otherwise the CompilerInstance will happily destroy them. 684 CI.setFileManager(&AST->getFileManager()); 685 CI.setSourceManager(&AST->getSourceManager()); 686 CI.setPreprocessor(AST->getPreprocessorPtr()); 687 Preprocessor &PP = CI.getPreprocessor(); 688 PP.getBuiltinInfo().initializeBuiltins(PP.getIdentifierTable(), 689 PP.getLangOpts()); 690 CI.setASTContext(&AST->getASTContext()); 691 692 setCurrentInput(Input, std::move(AST)); 693 694 // Initialize the action. 695 if (!BeginSourceFileAction(CI)) 696 return false; 697 698 // Create the AST consumer. 699 CI.setASTConsumer(CreateWrappedASTConsumer(CI, InputFile)); 700 if (!CI.hasASTConsumer()) 701 return false; 702 703 FailureCleanup.release(); 704 return true; 705 } 706 707 // Set up the file and source managers, if needed. 708 if (!CI.hasFileManager()) { 709 if (!CI.createFileManager()) { 710 return false; 711 } 712 } 713 if (!CI.hasSourceManager()) 714 CI.createSourceManager(CI.getFileManager()); 715 716 // Set up embedding for any specified files. Do this before we load any 717 // source files, including the primary module map for the compilation. 718 for (const auto &F : CI.getFrontendOpts().ModulesEmbedFiles) { 719 if (auto FE = CI.getFileManager().getFile(F, /*openFile*/true)) 720 CI.getSourceManager().setFileIsTransient(*FE); 721 else 722 CI.getDiagnostics().Report(diag::err_modules_embed_file_not_found) << F; 723 } 724 if (CI.getFrontendOpts().ModulesEmbedAllFiles) 725 CI.getSourceManager().setAllFilesAreTransient(true); 726 727 // IR files bypass the rest of initialization. 728 if (Input.getKind().getLanguage() == Language::LLVM_IR) { 729 assert(hasIRSupport() && 730 "This action does not have IR file support!"); 731 732 // Inform the diagnostic client we are processing a source file. 733 CI.getDiagnosticClient().BeginSourceFile(CI.getLangOpts(), nullptr); 734 HasBegunSourceFile = true; 735 736 // Initialize the action. 737 if (!BeginSourceFileAction(CI)) 738 return false; 739 740 // Initialize the main file entry. 741 if (!CI.InitializeSourceManager(CurrentInput)) 742 return false; 743 744 FailureCleanup.release(); 745 return true; 746 } 747 748 // If the implicit PCH include is actually a directory, rather than 749 // a single file, search for a suitable PCH file in that directory. 750 if (!CI.getPreprocessorOpts().ImplicitPCHInclude.empty()) { 751 FileManager &FileMgr = CI.getFileManager(); 752 PreprocessorOptions &PPOpts = CI.getPreprocessorOpts(); 753 StringRef PCHInclude = PPOpts.ImplicitPCHInclude; 754 std::string SpecificModuleCachePath = CI.getSpecificModuleCachePath(); 755 if (auto PCHDir = FileMgr.getDirectory(PCHInclude)) { 756 std::error_code EC; 757 SmallString<128> DirNative; 758 llvm::sys::path::native((*PCHDir)->getName(), DirNative); 759 bool Found = false; 760 llvm::vfs::FileSystem &FS = FileMgr.getVirtualFileSystem(); 761 for (llvm::vfs::directory_iterator Dir = FS.dir_begin(DirNative, EC), 762 DirEnd; 763 Dir != DirEnd && !EC; Dir.increment(EC)) { 764 // Check whether this is an acceptable AST file. 765 if (ASTReader::isAcceptableASTFile( 766 Dir->path(), FileMgr, CI.getPCHContainerReader(), 767 CI.getLangOpts(), CI.getTargetOpts(), CI.getPreprocessorOpts(), 768 SpecificModuleCachePath)) { 769 PPOpts.ImplicitPCHInclude = std::string(Dir->path()); 770 Found = true; 771 break; 772 } 773 } 774 775 if (!Found) { 776 CI.getDiagnostics().Report(diag::err_fe_no_pch_in_dir) << PCHInclude; 777 return false; 778 } 779 } 780 } 781 782 // Set up the preprocessor if needed. When parsing model files the 783 // preprocessor of the original source is reused. 784 if (!isModelParsingAction()) 785 CI.createPreprocessor(getTranslationUnitKind()); 786 787 // Inform the diagnostic client we are processing a source file. 788 CI.getDiagnosticClient().BeginSourceFile(CI.getLangOpts(), 789 &CI.getPreprocessor()); 790 HasBegunSourceFile = true; 791 792 // Initialize the main file entry. 793 if (!CI.InitializeSourceManager(Input)) 794 return false; 795 796 // For module map files, we first parse the module map and synthesize a 797 // "<module-includes>" buffer before more conventional processing. 798 if (Input.getKind().getFormat() == InputKind::ModuleMap) { 799 CI.getLangOpts().setCompilingModule(LangOptions::CMK_ModuleMap); 800 801 std::string PresumedModuleMapFile; 802 unsigned OffsetToContents; 803 if (loadModuleMapForModuleBuild(CI, Input.isSystem(), 804 Input.isPreprocessed(), 805 PresumedModuleMapFile, OffsetToContents)) 806 return false; 807 808 auto *CurrentModule = prepareToBuildModule(CI, Input.getFile()); 809 if (!CurrentModule) 810 return false; 811 812 CurrentModule->PresumedModuleMapFile = PresumedModuleMapFile; 813 814 if (OffsetToContents) 815 // If the module contents are in the same file, skip to them. 816 CI.getPreprocessor().setSkipMainFilePreamble(OffsetToContents, true); 817 else { 818 // Otherwise, convert the module description to a suitable input buffer. 819 auto Buffer = getInputBufferForModule(CI, CurrentModule); 820 if (!Buffer) 821 return false; 822 823 // Reinitialize the main file entry to refer to the new input. 824 auto Kind = CurrentModule->IsSystem ? SrcMgr::C_System : SrcMgr::C_User; 825 auto &SourceMgr = CI.getSourceManager(); 826 auto BufferID = SourceMgr.createFileID(std::move(Buffer), Kind); 827 assert(BufferID.isValid() && "couldn't create module buffer ID"); 828 SourceMgr.setMainFileID(BufferID); 829 } 830 } 831 832 // Initialize the action. 833 if (!BeginSourceFileAction(CI)) 834 return false; 835 836 // If we were asked to load any module map files, do so now. 837 for (const auto &Filename : CI.getFrontendOpts().ModuleMapFiles) { 838 if (auto File = CI.getFileManager().getFile(Filename)) 839 CI.getPreprocessor().getHeaderSearchInfo().loadModuleMapFile( 840 *File, /*IsSystem*/false); 841 else 842 CI.getDiagnostics().Report(diag::err_module_map_not_found) << Filename; 843 } 844 845 // Add a module declaration scope so that modules from -fmodule-map-file 846 // arguments may shadow modules found implicitly in search paths. 847 CI.getPreprocessor() 848 .getHeaderSearchInfo() 849 .getModuleMap() 850 .finishModuleDeclarationScope(); 851 852 // Create the AST context and consumer unless this is a preprocessor only 853 // action. 854 if (!usesPreprocessorOnly()) { 855 // Parsing a model file should reuse the existing ASTContext. 856 if (!isModelParsingAction()) 857 CI.createASTContext(); 858 859 // For preprocessed files, check if the first line specifies the original 860 // source file name with a linemarker. 861 std::string PresumedInputFile = std::string(getCurrentFileOrBufferName()); 862 if (Input.isPreprocessed()) 863 ReadOriginalFileName(CI, PresumedInputFile); 864 865 std::unique_ptr<ASTConsumer> Consumer = 866 CreateWrappedASTConsumer(CI, PresumedInputFile); 867 if (!Consumer) 868 return false; 869 870 // FIXME: should not overwrite ASTMutationListener when parsing model files? 871 if (!isModelParsingAction()) 872 CI.getASTContext().setASTMutationListener(Consumer->GetASTMutationListener()); 873 874 if (!CI.getPreprocessorOpts().ChainedIncludes.empty()) { 875 // Convert headers to PCH and chain them. 876 IntrusiveRefCntPtr<ExternalSemaSource> source, FinalReader; 877 source = createChainedIncludesSource(CI, FinalReader); 878 if (!source) 879 return false; 880 CI.setASTReader(static_cast<ASTReader *>(FinalReader.get())); 881 CI.getASTContext().setExternalSource(source); 882 } else if (CI.getLangOpts().Modules || 883 !CI.getPreprocessorOpts().ImplicitPCHInclude.empty()) { 884 // Use PCM or PCH. 885 assert(hasPCHSupport() && "This action does not have PCH support!"); 886 ASTDeserializationListener *DeserialListener = 887 Consumer->GetASTDeserializationListener(); 888 bool DeleteDeserialListener = false; 889 if (CI.getPreprocessorOpts().DumpDeserializedPCHDecls) { 890 DeserialListener = new DeserializedDeclsDumper(DeserialListener, 891 DeleteDeserialListener); 892 DeleteDeserialListener = true; 893 } 894 if (!CI.getPreprocessorOpts().DeserializedPCHDeclsToErrorOn.empty()) { 895 DeserialListener = new DeserializedDeclsChecker( 896 CI.getASTContext(), 897 CI.getPreprocessorOpts().DeserializedPCHDeclsToErrorOn, 898 DeserialListener, DeleteDeserialListener); 899 DeleteDeserialListener = true; 900 } 901 if (!CI.getPreprocessorOpts().ImplicitPCHInclude.empty()) { 902 CI.createPCHExternalASTSource( 903 CI.getPreprocessorOpts().ImplicitPCHInclude, 904 CI.getPreprocessorOpts().DisablePCHOrModuleValidation, 905 CI.getPreprocessorOpts().AllowPCHWithCompilerErrors, 906 DeserialListener, DeleteDeserialListener); 907 if (!CI.getASTContext().getExternalSource()) 908 return false; 909 } 910 // If modules are enabled, create the AST reader before creating 911 // any builtins, so that all declarations know that they might be 912 // extended by an external source. 913 if (CI.getLangOpts().Modules || !CI.hasASTContext() || 914 !CI.getASTContext().getExternalSource()) { 915 CI.createASTReader(); 916 CI.getASTReader()->setDeserializationListener(DeserialListener, 917 DeleteDeserialListener); 918 } 919 } 920 921 CI.setASTConsumer(std::move(Consumer)); 922 if (!CI.hasASTConsumer()) 923 return false; 924 } 925 926 // Initialize built-in info as long as we aren't using an external AST 927 // source. 928 if (CI.getLangOpts().Modules || !CI.hasASTContext() || 929 !CI.getASTContext().getExternalSource()) { 930 Preprocessor &PP = CI.getPreprocessor(); 931 PP.getBuiltinInfo().initializeBuiltins(PP.getIdentifierTable(), 932 PP.getLangOpts()); 933 } else { 934 // FIXME: If this is a problem, recover from it by creating a multiplex 935 // source. 936 assert((!CI.getLangOpts().Modules || CI.getASTReader()) && 937 "modules enabled but created an external source that " 938 "doesn't support modules"); 939 } 940 941 // If we were asked to load any module files, do so now. 942 for (const auto &ModuleFile : CI.getFrontendOpts().ModuleFiles) 943 if (!CI.loadModuleFile(ModuleFile)) 944 return false; 945 946 // If there is a layout overrides file, attach an external AST source that 947 // provides the layouts from that file. 948 if (!CI.getFrontendOpts().OverrideRecordLayoutsFile.empty() && 949 CI.hasASTContext() && !CI.getASTContext().getExternalSource()) { 950 IntrusiveRefCntPtr<ExternalASTSource> 951 Override(new LayoutOverrideSource( 952 CI.getFrontendOpts().OverrideRecordLayoutsFile)); 953 CI.getASTContext().setExternalSource(Override); 954 } 955 956 FailureCleanup.release(); 957 return true; 958 } 959 960 llvm::Error FrontendAction::Execute() { 961 CompilerInstance &CI = getCompilerInstance(); 962 963 if (CI.hasFrontendTimer()) { 964 llvm::TimeRegion Timer(CI.getFrontendTimer()); 965 ExecuteAction(); 966 } 967 else ExecuteAction(); 968 969 // If we are supposed to rebuild the global module index, do so now unless 970 // there were any module-build failures. 971 if (CI.shouldBuildGlobalModuleIndex() && CI.hasFileManager() && 972 CI.hasPreprocessor()) { 973 StringRef Cache = 974 CI.getPreprocessor().getHeaderSearchInfo().getModuleCachePath(); 975 if (!Cache.empty()) { 976 if (llvm::Error Err = GlobalModuleIndex::writeIndex( 977 CI.getFileManager(), CI.getPCHContainerReader(), Cache)) { 978 // FIXME this drops the error on the floor, but 979 // Index/pch-from-libclang.c seems to rely on dropping at least some of 980 // the error conditions! 981 consumeError(std::move(Err)); 982 } 983 } 984 } 985 986 return llvm::Error::success(); 987 } 988 989 void FrontendAction::EndSourceFile() { 990 CompilerInstance &CI = getCompilerInstance(); 991 992 // Inform the diagnostic client we are done with this source file. 993 CI.getDiagnosticClient().EndSourceFile(); 994 995 // Inform the preprocessor we are done. 996 if (CI.hasPreprocessor()) 997 CI.getPreprocessor().EndSourceFile(); 998 999 // Finalize the action. 1000 EndSourceFileAction(); 1001 1002 // Sema references the ast consumer, so reset sema first. 1003 // 1004 // FIXME: There is more per-file stuff we could just drop here? 1005 bool DisableFree = CI.getFrontendOpts().DisableFree; 1006 if (DisableFree) { 1007 CI.resetAndLeakSema(); 1008 CI.resetAndLeakASTContext(); 1009 llvm::BuryPointer(CI.takeASTConsumer().get()); 1010 } else { 1011 CI.setSema(nullptr); 1012 CI.setASTContext(nullptr); 1013 CI.setASTConsumer(nullptr); 1014 } 1015 1016 if (CI.getFrontendOpts().ShowStats) { 1017 llvm::errs() << "\nSTATISTICS FOR '" << getCurrentFile() << "':\n"; 1018 CI.getPreprocessor().PrintStats(); 1019 CI.getPreprocessor().getIdentifierTable().PrintStats(); 1020 CI.getPreprocessor().getHeaderSearchInfo().PrintStats(); 1021 CI.getSourceManager().PrintStats(); 1022 llvm::errs() << "\n"; 1023 } 1024 1025 // Cleanup the output streams, and erase the output files if instructed by the 1026 // FrontendAction. 1027 CI.clearOutputFiles(/*EraseFiles=*/shouldEraseOutputFiles()); 1028 1029 if (isCurrentFileAST()) { 1030 if (DisableFree) { 1031 CI.resetAndLeakPreprocessor(); 1032 CI.resetAndLeakSourceManager(); 1033 CI.resetAndLeakFileManager(); 1034 llvm::BuryPointer(std::move(CurrentASTUnit)); 1035 } else { 1036 CI.setPreprocessor(nullptr); 1037 CI.setSourceManager(nullptr); 1038 CI.setFileManager(nullptr); 1039 } 1040 } 1041 1042 setCompilerInstance(nullptr); 1043 setCurrentInput(FrontendInputFile()); 1044 CI.getLangOpts().setCompilingModule(LangOptions::CMK_None); 1045 } 1046 1047 bool FrontendAction::shouldEraseOutputFiles() { 1048 return getCompilerInstance().getDiagnostics().hasErrorOccurred(); 1049 } 1050 1051 //===----------------------------------------------------------------------===// 1052 // Utility Actions 1053 //===----------------------------------------------------------------------===// 1054 1055 void ASTFrontendAction::ExecuteAction() { 1056 CompilerInstance &CI = getCompilerInstance(); 1057 if (!CI.hasPreprocessor()) 1058 return; 1059 1060 // FIXME: Move the truncation aspect of this into Sema, we delayed this till 1061 // here so the source manager would be initialized. 1062 if (hasCodeCompletionSupport() && 1063 !CI.getFrontendOpts().CodeCompletionAt.FileName.empty()) 1064 CI.createCodeCompletionConsumer(); 1065 1066 // Use a code completion consumer? 1067 CodeCompleteConsumer *CompletionConsumer = nullptr; 1068 if (CI.hasCodeCompletionConsumer()) 1069 CompletionConsumer = &CI.getCodeCompletionConsumer(); 1070 1071 if (!CI.hasSema()) 1072 CI.createSema(getTranslationUnitKind(), CompletionConsumer); 1073 1074 ParseAST(CI.getSema(), CI.getFrontendOpts().ShowStats, 1075 CI.getFrontendOpts().SkipFunctionBodies); 1076 } 1077 1078 void PluginASTAction::anchor() { } 1079 1080 std::unique_ptr<ASTConsumer> 1081 PreprocessorFrontendAction::CreateASTConsumer(CompilerInstance &CI, 1082 StringRef InFile) { 1083 llvm_unreachable("Invalid CreateASTConsumer on preprocessor action!"); 1084 } 1085 1086 bool WrapperFrontendAction::PrepareToExecuteAction(CompilerInstance &CI) { 1087 return WrappedAction->PrepareToExecuteAction(CI); 1088 } 1089 std::unique_ptr<ASTConsumer> 1090 WrapperFrontendAction::CreateASTConsumer(CompilerInstance &CI, 1091 StringRef InFile) { 1092 return WrappedAction->CreateASTConsumer(CI, InFile); 1093 } 1094 bool WrapperFrontendAction::BeginInvocation(CompilerInstance &CI) { 1095 return WrappedAction->BeginInvocation(CI); 1096 } 1097 bool WrapperFrontendAction::BeginSourceFileAction(CompilerInstance &CI) { 1098 WrappedAction->setCurrentInput(getCurrentInput()); 1099 WrappedAction->setCompilerInstance(&CI); 1100 auto Ret = WrappedAction->BeginSourceFileAction(CI); 1101 // BeginSourceFileAction may change CurrentInput, e.g. during module builds. 1102 setCurrentInput(WrappedAction->getCurrentInput()); 1103 return Ret; 1104 } 1105 void WrapperFrontendAction::ExecuteAction() { 1106 WrappedAction->ExecuteAction(); 1107 } 1108 void WrapperFrontendAction::EndSourceFile() { WrappedAction->EndSourceFile(); } 1109 void WrapperFrontendAction::EndSourceFileAction() { 1110 WrappedAction->EndSourceFileAction(); 1111 } 1112 bool WrapperFrontendAction::shouldEraseOutputFiles() { 1113 return WrappedAction->shouldEraseOutputFiles(); 1114 } 1115 1116 bool WrapperFrontendAction::usesPreprocessorOnly() const { 1117 return WrappedAction->usesPreprocessorOnly(); 1118 } 1119 TranslationUnitKind WrapperFrontendAction::getTranslationUnitKind() { 1120 return WrappedAction->getTranslationUnitKind(); 1121 } 1122 bool WrapperFrontendAction::hasPCHSupport() const { 1123 return WrappedAction->hasPCHSupport(); 1124 } 1125 bool WrapperFrontendAction::hasASTFileSupport() const { 1126 return WrappedAction->hasASTFileSupport(); 1127 } 1128 bool WrapperFrontendAction::hasIRSupport() const { 1129 return WrappedAction->hasIRSupport(); 1130 } 1131 bool WrapperFrontendAction::hasCodeCompletionSupport() const { 1132 return WrappedAction->hasCodeCompletionSupport(); 1133 } 1134 1135 WrapperFrontendAction::WrapperFrontendAction( 1136 std::unique_ptr<FrontendAction> WrappedAction) 1137 : WrappedAction(std::move(WrappedAction)) {} 1138 1139