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