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