1 //===--- CompilerInstance.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/CompilerInstance.h"
10 #include "clang/AST/ASTConsumer.h"
11 #include "clang/AST/ASTContext.h"
12 #include "clang/AST/Decl.h"
13 #include "clang/Basic/CharInfo.h"
14 #include "clang/Basic/Diagnostic.h"
15 #include "clang/Basic/FileManager.h"
16 #include "clang/Basic/LangStandard.h"
17 #include "clang/Basic/SourceManager.h"
18 #include "clang/Basic/Stack.h"
19 #include "clang/Basic/TargetInfo.h"
20 #include "clang/Basic/Version.h"
21 #include "clang/Config/config.h"
22 #include "clang/Frontend/ChainedDiagnosticConsumer.h"
23 #include "clang/Frontend/FrontendAction.h"
24 #include "clang/Frontend/FrontendActions.h"
25 #include "clang/Frontend/FrontendDiagnostic.h"
26 #include "clang/Frontend/LogDiagnosticPrinter.h"
27 #include "clang/Frontend/SerializedDiagnosticPrinter.h"
28 #include "clang/Frontend/TextDiagnosticPrinter.h"
29 #include "clang/Frontend/Utils.h"
30 #include "clang/Frontend/VerifyDiagnosticConsumer.h"
31 #include "clang/Lex/HeaderSearch.h"
32 #include "clang/Lex/Preprocessor.h"
33 #include "clang/Lex/PreprocessorOptions.h"
34 #include "clang/Sema/CodeCompleteConsumer.h"
35 #include "clang/Sema/Sema.h"
36 #include "clang/Serialization/ASTReader.h"
37 #include "clang/Serialization/GlobalModuleIndex.h"
38 #include "clang/Serialization/InMemoryModuleCache.h"
39 #include "llvm/ADT/Statistic.h"
40 #include "llvm/Support/BuryPointer.h"
41 #include "llvm/Support/CrashRecoveryContext.h"
42 #include "llvm/Support/Errc.h"
43 #include "llvm/Support/FileSystem.h"
44 #include "llvm/Support/Host.h"
45 #include "llvm/Support/LockFileManager.h"
46 #include "llvm/Support/MemoryBuffer.h"
47 #include "llvm/Support/Path.h"
48 #include "llvm/Support/Program.h"
49 #include "llvm/Support/Signals.h"
50 #include "llvm/Support/TimeProfiler.h"
51 #include "llvm/Support/Timer.h"
52 #include "llvm/Support/raw_ostream.h"
53 #include <time.h>
54 #include <utility>
55 
56 using namespace clang;
57 
58 CompilerInstance::CompilerInstance(
59     std::shared_ptr<PCHContainerOperations> PCHContainerOps,
60     InMemoryModuleCache *SharedModuleCache)
61     : ModuleLoader(/* BuildingModule = */ SharedModuleCache),
62       Invocation(new CompilerInvocation()),
63       ModuleCache(SharedModuleCache ? SharedModuleCache
64                                     : new InMemoryModuleCache),
65       ThePCHContainerOperations(std::move(PCHContainerOps)) {}
66 
67 CompilerInstance::~CompilerInstance() {
68   assert(OutputFiles.empty() && "Still output files in flight?");
69 }
70 
71 void CompilerInstance::setInvocation(
72     std::shared_ptr<CompilerInvocation> Value) {
73   Invocation = std::move(Value);
74 }
75 
76 bool CompilerInstance::shouldBuildGlobalModuleIndex() const {
77   return (BuildGlobalModuleIndex ||
78           (TheASTReader && TheASTReader->isGlobalIndexUnavailable() &&
79            getFrontendOpts().GenerateGlobalModuleIndex)) &&
80          !ModuleBuildFailed;
81 }
82 
83 void CompilerInstance::setDiagnostics(DiagnosticsEngine *Value) {
84   Diagnostics = Value;
85 }
86 
87 void CompilerInstance::setVerboseOutputStream(raw_ostream &Value) {
88   OwnedVerboseOutputStream.release();
89   VerboseOutputStream = &Value;
90 }
91 
92 void CompilerInstance::setVerboseOutputStream(std::unique_ptr<raw_ostream> Value) {
93   OwnedVerboseOutputStream.swap(Value);
94   VerboseOutputStream = OwnedVerboseOutputStream.get();
95 }
96 
97 void CompilerInstance::setTarget(TargetInfo *Value) { Target = Value; }
98 void CompilerInstance::setAuxTarget(TargetInfo *Value) { AuxTarget = Value; }
99 
100 void CompilerInstance::setFileManager(FileManager *Value) {
101   FileMgr = Value;
102 }
103 
104 void CompilerInstance::setSourceManager(SourceManager *Value) {
105   SourceMgr = Value;
106 }
107 
108 void CompilerInstance::setPreprocessor(std::shared_ptr<Preprocessor> Value) {
109   PP = std::move(Value);
110 }
111 
112 void CompilerInstance::setASTContext(ASTContext *Value) {
113   Context = Value;
114 
115   if (Context && Consumer)
116     getASTConsumer().Initialize(getASTContext());
117 }
118 
119 void CompilerInstance::setSema(Sema *S) {
120   TheSema.reset(S);
121 }
122 
123 void CompilerInstance::setASTConsumer(std::unique_ptr<ASTConsumer> Value) {
124   Consumer = std::move(Value);
125 
126   if (Context && Consumer)
127     getASTConsumer().Initialize(getASTContext());
128 }
129 
130 void CompilerInstance::setCodeCompletionConsumer(CodeCompleteConsumer *Value) {
131   CompletionConsumer.reset(Value);
132 }
133 
134 std::unique_ptr<Sema> CompilerInstance::takeSema() {
135   return std::move(TheSema);
136 }
137 
138 IntrusiveRefCntPtr<ASTReader> CompilerInstance::getASTReader() const {
139   return TheASTReader;
140 }
141 void CompilerInstance::setModuleManager(IntrusiveRefCntPtr<ASTReader> Reader) {
142   assert(ModuleCache.get() == &Reader->getModuleManager().getModuleCache() &&
143          "Expected ASTReader to use the same PCM cache");
144   TheASTReader = std::move(Reader);
145 }
146 
147 std::shared_ptr<ModuleDependencyCollector>
148 CompilerInstance::getModuleDepCollector() const {
149   return ModuleDepCollector;
150 }
151 
152 void CompilerInstance::setModuleDepCollector(
153     std::shared_ptr<ModuleDependencyCollector> Collector) {
154   ModuleDepCollector = std::move(Collector);
155 }
156 
157 static void collectHeaderMaps(const HeaderSearch &HS,
158                               std::shared_ptr<ModuleDependencyCollector> MDC) {
159   SmallVector<std::string, 4> HeaderMapFileNames;
160   HS.getHeaderMapFileNames(HeaderMapFileNames);
161   for (auto &Name : HeaderMapFileNames)
162     MDC->addFile(Name);
163 }
164 
165 static void collectIncludePCH(CompilerInstance &CI,
166                               std::shared_ptr<ModuleDependencyCollector> MDC) {
167   const PreprocessorOptions &PPOpts = CI.getPreprocessorOpts();
168   if (PPOpts.ImplicitPCHInclude.empty())
169     return;
170 
171   StringRef PCHInclude = PPOpts.ImplicitPCHInclude;
172   FileManager &FileMgr = CI.getFileManager();
173   auto PCHDir = FileMgr.getDirectory(PCHInclude);
174   if (!PCHDir) {
175     MDC->addFile(PCHInclude);
176     return;
177   }
178 
179   std::error_code EC;
180   SmallString<128> DirNative;
181   llvm::sys::path::native((*PCHDir)->getName(), DirNative);
182   llvm::vfs::FileSystem &FS = FileMgr.getVirtualFileSystem();
183   SimpleASTReaderListener Validator(CI.getPreprocessor());
184   for (llvm::vfs::directory_iterator Dir = FS.dir_begin(DirNative, EC), DirEnd;
185        Dir != DirEnd && !EC; Dir.increment(EC)) {
186     // Check whether this is an AST file. ASTReader::isAcceptableASTFile is not
187     // used here since we're not interested in validating the PCH at this time,
188     // but only to check whether this is a file containing an AST.
189     if (!ASTReader::readASTFileControlBlock(
190             Dir->path(), FileMgr, CI.getPCHContainerReader(),
191             /*FindModuleFileExtensions=*/false, Validator,
192             /*ValidateDiagnosticOptions=*/false))
193       MDC->addFile(Dir->path());
194   }
195 }
196 
197 static void collectVFSEntries(CompilerInstance &CI,
198                               std::shared_ptr<ModuleDependencyCollector> MDC) {
199   if (CI.getHeaderSearchOpts().VFSOverlayFiles.empty())
200     return;
201 
202   // Collect all VFS found.
203   SmallVector<llvm::vfs::YAMLVFSEntry, 16> VFSEntries;
204   for (const std::string &VFSFile : CI.getHeaderSearchOpts().VFSOverlayFiles) {
205     llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> Buffer =
206         llvm::MemoryBuffer::getFile(VFSFile);
207     if (!Buffer)
208       return;
209     llvm::vfs::collectVFSFromYAML(std::move(Buffer.get()),
210                                   /*DiagHandler*/ nullptr, VFSFile, VFSEntries);
211   }
212 
213   for (auto &E : VFSEntries)
214     MDC->addFile(E.VPath, E.RPath);
215 }
216 
217 // Diagnostics
218 static void SetUpDiagnosticLog(DiagnosticOptions *DiagOpts,
219                                const CodeGenOptions *CodeGenOpts,
220                                DiagnosticsEngine &Diags) {
221   std::error_code EC;
222   std::unique_ptr<raw_ostream> StreamOwner;
223   raw_ostream *OS = &llvm::errs();
224   if (DiagOpts->DiagnosticLogFile != "-") {
225     // Create the output stream.
226     auto FileOS = std::make_unique<llvm::raw_fd_ostream>(
227         DiagOpts->DiagnosticLogFile, EC,
228         llvm::sys::fs::OF_Append | llvm::sys::fs::OF_Text);
229     if (EC) {
230       Diags.Report(diag::warn_fe_cc_log_diagnostics_failure)
231           << DiagOpts->DiagnosticLogFile << EC.message();
232     } else {
233       FileOS->SetUnbuffered();
234       OS = FileOS.get();
235       StreamOwner = std::move(FileOS);
236     }
237   }
238 
239   // Chain in the diagnostic client which will log the diagnostics.
240   auto Logger = std::make_unique<LogDiagnosticPrinter>(*OS, DiagOpts,
241                                                         std::move(StreamOwner));
242   if (CodeGenOpts)
243     Logger->setDwarfDebugFlags(CodeGenOpts->DwarfDebugFlags);
244   if (Diags.ownsClient()) {
245     Diags.setClient(
246         new ChainedDiagnosticConsumer(Diags.takeClient(), std::move(Logger)));
247   } else {
248     Diags.setClient(
249         new ChainedDiagnosticConsumer(Diags.getClient(), std::move(Logger)));
250   }
251 }
252 
253 static void SetupSerializedDiagnostics(DiagnosticOptions *DiagOpts,
254                                        DiagnosticsEngine &Diags,
255                                        StringRef OutputFile) {
256   auto SerializedConsumer =
257       clang::serialized_diags::create(OutputFile, DiagOpts);
258 
259   if (Diags.ownsClient()) {
260     Diags.setClient(new ChainedDiagnosticConsumer(
261         Diags.takeClient(), std::move(SerializedConsumer)));
262   } else {
263     Diags.setClient(new ChainedDiagnosticConsumer(
264         Diags.getClient(), std::move(SerializedConsumer)));
265   }
266 }
267 
268 void CompilerInstance::createDiagnostics(DiagnosticConsumer *Client,
269                                          bool ShouldOwnClient) {
270   Diagnostics = createDiagnostics(&getDiagnosticOpts(), Client,
271                                   ShouldOwnClient, &getCodeGenOpts());
272 }
273 
274 IntrusiveRefCntPtr<DiagnosticsEngine>
275 CompilerInstance::createDiagnostics(DiagnosticOptions *Opts,
276                                     DiagnosticConsumer *Client,
277                                     bool ShouldOwnClient,
278                                     const CodeGenOptions *CodeGenOpts) {
279   IntrusiveRefCntPtr<DiagnosticIDs> DiagID(new DiagnosticIDs());
280   IntrusiveRefCntPtr<DiagnosticsEngine>
281       Diags(new DiagnosticsEngine(DiagID, Opts));
282 
283   // Create the diagnostic client for reporting errors or for
284   // implementing -verify.
285   if (Client) {
286     Diags->setClient(Client, ShouldOwnClient);
287   } else
288     Diags->setClient(new TextDiagnosticPrinter(llvm::errs(), Opts));
289 
290   // Chain in -verify checker, if requested.
291   if (Opts->VerifyDiagnostics)
292     Diags->setClient(new VerifyDiagnosticConsumer(*Diags));
293 
294   // Chain in -diagnostic-log-file dumper, if requested.
295   if (!Opts->DiagnosticLogFile.empty())
296     SetUpDiagnosticLog(Opts, CodeGenOpts, *Diags);
297 
298   if (!Opts->DiagnosticSerializationFile.empty())
299     SetupSerializedDiagnostics(Opts, *Diags,
300                                Opts->DiagnosticSerializationFile);
301 
302   // Configure our handling of diagnostics.
303   ProcessWarningOptions(*Diags, *Opts);
304 
305   return Diags;
306 }
307 
308 // File Manager
309 
310 FileManager *CompilerInstance::createFileManager(
311     IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS) {
312   if (!VFS)
313     VFS = FileMgr ? &FileMgr->getVirtualFileSystem()
314                   : createVFSFromCompilerInvocation(getInvocation(),
315                                                     getDiagnostics());
316   assert(VFS && "FileManager has no VFS?");
317   FileMgr = new FileManager(getFileSystemOpts(), std::move(VFS));
318   return FileMgr.get();
319 }
320 
321 // Source Manager
322 
323 void CompilerInstance::createSourceManager(FileManager &FileMgr) {
324   SourceMgr = new SourceManager(getDiagnostics(), FileMgr);
325 }
326 
327 // Initialize the remapping of files to alternative contents, e.g.,
328 // those specified through other files.
329 static void InitializeFileRemapping(DiagnosticsEngine &Diags,
330                                     SourceManager &SourceMgr,
331                                     FileManager &FileMgr,
332                                     const PreprocessorOptions &InitOpts) {
333   // Remap files in the source manager (with buffers).
334   for (const auto &RB : InitOpts.RemappedFileBuffers) {
335     // Create the file entry for the file that we're mapping from.
336     const FileEntry *FromFile =
337         FileMgr.getVirtualFile(RB.first, RB.second->getBufferSize(), 0);
338     if (!FromFile) {
339       Diags.Report(diag::err_fe_remap_missing_from_file) << RB.first;
340       if (!InitOpts.RetainRemappedFileBuffers)
341         delete RB.second;
342       continue;
343     }
344 
345     // Override the contents of the "from" file with the contents of
346     // the "to" file.
347     SourceMgr.overrideFileContents(FromFile, RB.second,
348                                    InitOpts.RetainRemappedFileBuffers);
349   }
350 
351   // Remap files in the source manager (with other files).
352   for (const auto &RF : InitOpts.RemappedFiles) {
353     // Find the file that we're mapping to.
354     auto ToFile = FileMgr.getFile(RF.second);
355     if (!ToFile) {
356       Diags.Report(diag::err_fe_remap_missing_to_file) << RF.first << RF.second;
357       continue;
358     }
359 
360     // Create the file entry for the file that we're mapping from.
361     const FileEntry *FromFile =
362         FileMgr.getVirtualFile(RF.first, (*ToFile)->getSize(), 0);
363     if (!FromFile) {
364       Diags.Report(diag::err_fe_remap_missing_from_file) << RF.first;
365       continue;
366     }
367 
368     // Override the contents of the "from" file with the contents of
369     // the "to" file.
370     SourceMgr.overrideFileContents(FromFile, *ToFile);
371   }
372 
373   SourceMgr.setOverridenFilesKeepOriginalName(
374       InitOpts.RemappedFilesKeepOriginalName);
375 }
376 
377 // Preprocessor
378 
379 void CompilerInstance::createPreprocessor(TranslationUnitKind TUKind) {
380   const PreprocessorOptions &PPOpts = getPreprocessorOpts();
381 
382   // The module manager holds a reference to the old preprocessor (if any).
383   TheASTReader.reset();
384 
385   // Create the Preprocessor.
386   HeaderSearch *HeaderInfo =
387       new HeaderSearch(getHeaderSearchOptsPtr(), getSourceManager(),
388                        getDiagnostics(), getLangOpts(), &getTarget());
389   PP = std::make_shared<Preprocessor>(Invocation->getPreprocessorOptsPtr(),
390                                       getDiagnostics(), getLangOpts(),
391                                       getSourceManager(), *HeaderInfo, *this,
392                                       /*IdentifierInfoLookup=*/nullptr,
393                                       /*OwnsHeaderSearch=*/true, TUKind);
394   getTarget().adjust(getLangOpts());
395   PP->Initialize(getTarget(), getAuxTarget());
396 
397   if (PPOpts.DetailedRecord)
398     PP->createPreprocessingRecord();
399 
400   // Apply remappings to the source manager.
401   InitializeFileRemapping(PP->getDiagnostics(), PP->getSourceManager(),
402                           PP->getFileManager(), PPOpts);
403 
404   // Predefine macros and configure the preprocessor.
405   InitializePreprocessor(*PP, PPOpts, getPCHContainerReader(),
406                          getFrontendOpts());
407 
408   // Initialize the header search object.  In CUDA compilations, we use the aux
409   // triple (the host triple) to initialize our header search, since we need to
410   // find the host headers in order to compile the CUDA code.
411   const llvm::Triple *HeaderSearchTriple = &PP->getTargetInfo().getTriple();
412   if (PP->getTargetInfo().getTriple().getOS() == llvm::Triple::CUDA &&
413       PP->getAuxTargetInfo())
414     HeaderSearchTriple = &PP->getAuxTargetInfo()->getTriple();
415 
416   ApplyHeaderSearchOptions(PP->getHeaderSearchInfo(), getHeaderSearchOpts(),
417                            PP->getLangOpts(), *HeaderSearchTriple);
418 
419   PP->setPreprocessedOutput(getPreprocessorOutputOpts().ShowCPP);
420 
421   if (PP->getLangOpts().Modules && PP->getLangOpts().ImplicitModules)
422     PP->getHeaderSearchInfo().setModuleCachePath(getSpecificModuleCachePath());
423 
424   // Handle generating dependencies, if requested.
425   const DependencyOutputOptions &DepOpts = getDependencyOutputOpts();
426   if (!DepOpts.OutputFile.empty())
427     addDependencyCollector(std::make_shared<DependencyFileGenerator>(DepOpts));
428   if (!DepOpts.DOTOutputFile.empty())
429     AttachDependencyGraphGen(*PP, DepOpts.DOTOutputFile,
430                              getHeaderSearchOpts().Sysroot);
431 
432   // If we don't have a collector, but we are collecting module dependencies,
433   // then we're the top level compiler instance and need to create one.
434   if (!ModuleDepCollector && !DepOpts.ModuleDependencyOutputDir.empty()) {
435     ModuleDepCollector = std::make_shared<ModuleDependencyCollector>(
436         DepOpts.ModuleDependencyOutputDir);
437   }
438 
439   // If there is a module dep collector, register with other dep collectors
440   // and also (a) collect header maps and (b) TODO: input vfs overlay files.
441   if (ModuleDepCollector) {
442     addDependencyCollector(ModuleDepCollector);
443     collectHeaderMaps(PP->getHeaderSearchInfo(), ModuleDepCollector);
444     collectIncludePCH(*this, ModuleDepCollector);
445     collectVFSEntries(*this, ModuleDepCollector);
446   }
447 
448   for (auto &Listener : DependencyCollectors)
449     Listener->attachToPreprocessor(*PP);
450 
451   // Handle generating header include information, if requested.
452   if (DepOpts.ShowHeaderIncludes)
453     AttachHeaderIncludeGen(*PP, DepOpts);
454   if (!DepOpts.HeaderIncludeOutputFile.empty()) {
455     StringRef OutputPath = DepOpts.HeaderIncludeOutputFile;
456     if (OutputPath == "-")
457       OutputPath = "";
458     AttachHeaderIncludeGen(*PP, DepOpts,
459                            /*ShowAllHeaders=*/true, OutputPath,
460                            /*ShowDepth=*/false);
461   }
462 
463   if (DepOpts.ShowIncludesDest != ShowIncludesDestination::None) {
464     AttachHeaderIncludeGen(*PP, DepOpts,
465                            /*ShowAllHeaders=*/true, /*OutputPath=*/"",
466                            /*ShowDepth=*/true, /*MSStyle=*/true);
467   }
468 }
469 
470 std::string CompilerInstance::getSpecificModuleCachePath() {
471   // Set up the module path, including the hash for the
472   // module-creation options.
473   SmallString<256> SpecificModuleCache(getHeaderSearchOpts().ModuleCachePath);
474   if (!SpecificModuleCache.empty() && !getHeaderSearchOpts().DisableModuleHash)
475     llvm::sys::path::append(SpecificModuleCache,
476                             getInvocation().getModuleHash());
477   return SpecificModuleCache.str();
478 }
479 
480 // ASTContext
481 
482 void CompilerInstance::createASTContext() {
483   Preprocessor &PP = getPreprocessor();
484   auto *Context = new ASTContext(getLangOpts(), PP.getSourceManager(),
485                                  PP.getIdentifierTable(), PP.getSelectorTable(),
486                                  PP.getBuiltinInfo());
487   Context->InitBuiltinTypes(getTarget(), getAuxTarget());
488   setASTContext(Context);
489 }
490 
491 // ExternalASTSource
492 
493 void CompilerInstance::createPCHExternalASTSource(
494     StringRef Path, bool DisablePCHValidation, bool AllowPCHWithCompilerErrors,
495     void *DeserializationListener, bool OwnDeserializationListener) {
496   bool Preamble = getPreprocessorOpts().PrecompiledPreambleBytes.first != 0;
497   TheASTReader = createPCHExternalASTSource(
498       Path, getHeaderSearchOpts().Sysroot, DisablePCHValidation,
499       AllowPCHWithCompilerErrors, getPreprocessor(), getModuleCache(),
500       getASTContext(), getPCHContainerReader(),
501       getFrontendOpts().ModuleFileExtensions, DependencyCollectors,
502       DeserializationListener, OwnDeserializationListener, Preamble,
503       getFrontendOpts().UseGlobalModuleIndex);
504 }
505 
506 IntrusiveRefCntPtr<ASTReader> CompilerInstance::createPCHExternalASTSource(
507     StringRef Path, StringRef Sysroot, bool DisablePCHValidation,
508     bool AllowPCHWithCompilerErrors, Preprocessor &PP,
509     InMemoryModuleCache &ModuleCache, ASTContext &Context,
510     const PCHContainerReader &PCHContainerRdr,
511     ArrayRef<std::shared_ptr<ModuleFileExtension>> Extensions,
512     ArrayRef<std::shared_ptr<DependencyCollector>> DependencyCollectors,
513     void *DeserializationListener, bool OwnDeserializationListener,
514     bool Preamble, bool UseGlobalModuleIndex) {
515   HeaderSearchOptions &HSOpts = PP.getHeaderSearchInfo().getHeaderSearchOpts();
516 
517   IntrusiveRefCntPtr<ASTReader> Reader(new ASTReader(
518       PP, ModuleCache, &Context, PCHContainerRdr, Extensions,
519       Sysroot.empty() ? "" : Sysroot.data(), DisablePCHValidation,
520       AllowPCHWithCompilerErrors, /*AllowConfigurationMismatch*/ false,
521       HSOpts.ModulesValidateSystemHeaders, HSOpts.ValidateASTInputFilesContent,
522       UseGlobalModuleIndex));
523 
524   // We need the external source to be set up before we read the AST, because
525   // eagerly-deserialized declarations may use it.
526   Context.setExternalSource(Reader.get());
527 
528   Reader->setDeserializationListener(
529       static_cast<ASTDeserializationListener *>(DeserializationListener),
530       /*TakeOwnership=*/OwnDeserializationListener);
531 
532   for (auto &Listener : DependencyCollectors)
533     Listener->attachToASTReader(*Reader);
534 
535   switch (Reader->ReadAST(Path,
536                           Preamble ? serialization::MK_Preamble
537                                    : serialization::MK_PCH,
538                           SourceLocation(),
539                           ASTReader::ARR_None)) {
540   case ASTReader::Success:
541     // Set the predefines buffer as suggested by the PCH reader. Typically, the
542     // predefines buffer will be empty.
543     PP.setPredefines(Reader->getSuggestedPredefines());
544     return Reader;
545 
546   case ASTReader::Failure:
547     // Unrecoverable failure: don't even try to process the input file.
548     break;
549 
550   case ASTReader::Missing:
551   case ASTReader::OutOfDate:
552   case ASTReader::VersionMismatch:
553   case ASTReader::ConfigurationMismatch:
554   case ASTReader::HadErrors:
555     // No suitable PCH file could be found. Return an error.
556     break;
557   }
558 
559   Context.setExternalSource(nullptr);
560   return nullptr;
561 }
562 
563 // Code Completion
564 
565 static bool EnableCodeCompletion(Preprocessor &PP,
566                                  StringRef Filename,
567                                  unsigned Line,
568                                  unsigned Column) {
569   // Tell the source manager to chop off the given file at a specific
570   // line and column.
571   auto Entry = PP.getFileManager().getFile(Filename);
572   if (!Entry) {
573     PP.getDiagnostics().Report(diag::err_fe_invalid_code_complete_file)
574       << Filename;
575     return true;
576   }
577 
578   // Truncate the named file at the given line/column.
579   PP.SetCodeCompletionPoint(*Entry, Line, Column);
580   return false;
581 }
582 
583 void CompilerInstance::createCodeCompletionConsumer() {
584   const ParsedSourceLocation &Loc = getFrontendOpts().CodeCompletionAt;
585   if (!CompletionConsumer) {
586     setCodeCompletionConsumer(
587       createCodeCompletionConsumer(getPreprocessor(),
588                                    Loc.FileName, Loc.Line, Loc.Column,
589                                    getFrontendOpts().CodeCompleteOpts,
590                                    llvm::outs()));
591     if (!CompletionConsumer)
592       return;
593   } else if (EnableCodeCompletion(getPreprocessor(), Loc.FileName,
594                                   Loc.Line, Loc.Column)) {
595     setCodeCompletionConsumer(nullptr);
596     return;
597   }
598 }
599 
600 void CompilerInstance::createFrontendTimer() {
601   FrontendTimerGroup.reset(
602       new llvm::TimerGroup("frontend", "Clang front-end time report"));
603   FrontendTimer.reset(
604       new llvm::Timer("frontend", "Clang front-end timer",
605                       *FrontendTimerGroup));
606 }
607 
608 CodeCompleteConsumer *
609 CompilerInstance::createCodeCompletionConsumer(Preprocessor &PP,
610                                                StringRef Filename,
611                                                unsigned Line,
612                                                unsigned Column,
613                                                const CodeCompleteOptions &Opts,
614                                                raw_ostream &OS) {
615   if (EnableCodeCompletion(PP, Filename, Line, Column))
616     return nullptr;
617 
618   // Set up the creation routine for code-completion.
619   return new PrintingCodeCompleteConsumer(Opts, OS);
620 }
621 
622 void CompilerInstance::createSema(TranslationUnitKind TUKind,
623                                   CodeCompleteConsumer *CompletionConsumer) {
624   TheSema.reset(new Sema(getPreprocessor(), getASTContext(), getASTConsumer(),
625                          TUKind, CompletionConsumer));
626   // Attach the external sema source if there is any.
627   if (ExternalSemaSrc) {
628     TheSema->addExternalSource(ExternalSemaSrc.get());
629     ExternalSemaSrc->InitializeSema(*TheSema);
630   }
631 }
632 
633 // Output Files
634 
635 void CompilerInstance::addOutputFile(OutputFile &&OutFile) {
636   OutputFiles.push_back(std::move(OutFile));
637 }
638 
639 void CompilerInstance::clearOutputFiles(bool EraseFiles) {
640   for (OutputFile &OF : OutputFiles) {
641     if (!OF.TempFilename.empty()) {
642       if (EraseFiles) {
643         llvm::sys::fs::remove(OF.TempFilename);
644       } else {
645         SmallString<128> NewOutFile(OF.Filename);
646 
647         // If '-working-directory' was passed, the output filename should be
648         // relative to that.
649         FileMgr->FixupRelativePath(NewOutFile);
650         if (std::error_code ec =
651                 llvm::sys::fs::rename(OF.TempFilename, NewOutFile)) {
652           getDiagnostics().Report(diag::err_unable_to_rename_temp)
653             << OF.TempFilename << OF.Filename << ec.message();
654 
655           llvm::sys::fs::remove(OF.TempFilename);
656         }
657       }
658     } else if (!OF.Filename.empty() && EraseFiles)
659       llvm::sys::fs::remove(OF.Filename);
660   }
661   OutputFiles.clear();
662   if (DeleteBuiltModules) {
663     for (auto &Module : BuiltModules)
664       llvm::sys::fs::remove(Module.second);
665     BuiltModules.clear();
666   }
667   NonSeekStream.reset();
668 }
669 
670 std::unique_ptr<raw_pwrite_stream>
671 CompilerInstance::createDefaultOutputFile(bool Binary, StringRef InFile,
672                                           StringRef Extension) {
673   return createOutputFile(getFrontendOpts().OutputFile, Binary,
674                           /*RemoveFileOnSignal=*/true, InFile, Extension,
675                           getFrontendOpts().UseTemporary);
676 }
677 
678 std::unique_ptr<raw_pwrite_stream> CompilerInstance::createNullOutputFile() {
679   return std::make_unique<llvm::raw_null_ostream>();
680 }
681 
682 std::unique_ptr<raw_pwrite_stream>
683 CompilerInstance::createOutputFile(StringRef OutputPath, bool Binary,
684                                    bool RemoveFileOnSignal, StringRef InFile,
685                                    StringRef Extension, bool UseTemporary,
686                                    bool CreateMissingDirectories) {
687   std::string OutputPathName, TempPathName;
688   std::error_code EC;
689   std::unique_ptr<raw_pwrite_stream> OS = createOutputFile(
690       OutputPath, EC, Binary, RemoveFileOnSignal, InFile, Extension,
691       UseTemporary, CreateMissingDirectories, &OutputPathName, &TempPathName);
692   if (!OS) {
693     getDiagnostics().Report(diag::err_fe_unable_to_open_output) << OutputPath
694                                                                 << EC.message();
695     return nullptr;
696   }
697 
698   // Add the output file -- but don't try to remove "-", since this means we are
699   // using stdin.
700   addOutputFile(
701       OutputFile((OutputPathName != "-") ? OutputPathName : "", TempPathName));
702 
703   return OS;
704 }
705 
706 std::unique_ptr<llvm::raw_pwrite_stream> CompilerInstance::createOutputFile(
707     StringRef OutputPath, std::error_code &Error, bool Binary,
708     bool RemoveFileOnSignal, StringRef InFile, StringRef Extension,
709     bool UseTemporary, bool CreateMissingDirectories,
710     std::string *ResultPathName, std::string *TempPathName) {
711   assert((!CreateMissingDirectories || UseTemporary) &&
712          "CreateMissingDirectories is only allowed when using temporary files");
713 
714   std::string OutFile, TempFile;
715   if (!OutputPath.empty()) {
716     OutFile = OutputPath;
717   } else if (InFile == "-") {
718     OutFile = "-";
719   } else if (!Extension.empty()) {
720     SmallString<128> Path(InFile);
721     llvm::sys::path::replace_extension(Path, Extension);
722     OutFile = Path.str();
723   } else {
724     OutFile = "-";
725   }
726 
727   std::unique_ptr<llvm::raw_fd_ostream> OS;
728   std::string OSFile;
729 
730   if (UseTemporary) {
731     if (OutFile == "-")
732       UseTemporary = false;
733     else {
734       llvm::sys::fs::file_status Status;
735       llvm::sys::fs::status(OutputPath, Status);
736       if (llvm::sys::fs::exists(Status)) {
737         // Fail early if we can't write to the final destination.
738         if (!llvm::sys::fs::can_write(OutputPath)) {
739           Error = make_error_code(llvm::errc::operation_not_permitted);
740           return nullptr;
741         }
742 
743         // Don't use a temporary if the output is a special file. This handles
744         // things like '-o /dev/null'
745         if (!llvm::sys::fs::is_regular_file(Status))
746           UseTemporary = false;
747       }
748     }
749   }
750 
751   if (UseTemporary) {
752     // Create a temporary file.
753     // Insert -%%%%%%%% before the extension (if any), and because some tools
754     // (noticeable, clang's own GlobalModuleIndex.cpp) glob for build
755     // artifacts, also append .tmp.
756     StringRef OutputExtension = llvm::sys::path::extension(OutFile);
757     SmallString<128> TempPath =
758         StringRef(OutFile).drop_back(OutputExtension.size());
759     TempPath += "-%%%%%%%%";
760     TempPath += OutputExtension;
761     TempPath += ".tmp";
762     int fd;
763     std::error_code EC =
764         llvm::sys::fs::createUniqueFile(TempPath, fd, TempPath);
765 
766     if (CreateMissingDirectories &&
767         EC == llvm::errc::no_such_file_or_directory) {
768       StringRef Parent = llvm::sys::path::parent_path(OutputPath);
769       EC = llvm::sys::fs::create_directories(Parent);
770       if (!EC) {
771         EC = llvm::sys::fs::createUniqueFile(TempPath, fd, TempPath);
772       }
773     }
774 
775     if (!EC) {
776       OS.reset(new llvm::raw_fd_ostream(fd, /*shouldClose=*/true));
777       OSFile = TempFile = TempPath.str();
778     }
779     // If we failed to create the temporary, fallback to writing to the file
780     // directly. This handles the corner case where we cannot write to the
781     // directory, but can write to the file.
782   }
783 
784   if (!OS) {
785     OSFile = OutFile;
786     OS.reset(new llvm::raw_fd_ostream(
787         OSFile, Error,
788         (Binary ? llvm::sys::fs::OF_None : llvm::sys::fs::OF_Text)));
789     if (Error)
790       return nullptr;
791   }
792 
793   // Make sure the out stream file gets removed if we crash.
794   if (RemoveFileOnSignal)
795     llvm::sys::RemoveFileOnSignal(OSFile);
796 
797   if (ResultPathName)
798     *ResultPathName = OutFile;
799   if (TempPathName)
800     *TempPathName = TempFile;
801 
802   if (!Binary || OS->supportsSeeking())
803     return std::move(OS);
804 
805   auto B = std::make_unique<llvm::buffer_ostream>(*OS);
806   assert(!NonSeekStream);
807   NonSeekStream = std::move(OS);
808   return std::move(B);
809 }
810 
811 // Initialization Utilities
812 
813 bool CompilerInstance::InitializeSourceManager(const FrontendInputFile &Input){
814   return InitializeSourceManager(
815       Input, getDiagnostics(), getFileManager(), getSourceManager(),
816       hasPreprocessor() ? &getPreprocessor().getHeaderSearchInfo() : nullptr,
817       getDependencyOutputOpts(), getFrontendOpts());
818 }
819 
820 // static
821 bool CompilerInstance::InitializeSourceManager(
822     const FrontendInputFile &Input, DiagnosticsEngine &Diags,
823     FileManager &FileMgr, SourceManager &SourceMgr, HeaderSearch *HS,
824     DependencyOutputOptions &DepOpts, const FrontendOptions &Opts) {
825   SrcMgr::CharacteristicKind Kind =
826       Input.getKind().getFormat() == InputKind::ModuleMap
827           ? Input.isSystem() ? SrcMgr::C_System_ModuleMap
828                              : SrcMgr::C_User_ModuleMap
829           : Input.isSystem() ? SrcMgr::C_System : SrcMgr::C_User;
830 
831   if (Input.isBuffer()) {
832     SourceMgr.setMainFileID(SourceMgr.createFileID(SourceManager::Unowned,
833                                                    Input.getBuffer(), Kind));
834     assert(SourceMgr.getMainFileID().isValid() &&
835            "Couldn't establish MainFileID!");
836     return true;
837   }
838 
839   StringRef InputFile = Input.getFile();
840 
841   // Figure out where to get and map in the main file.
842   if (InputFile != "-") {
843     auto FileOrErr = FileMgr.getFileRef(InputFile, /*OpenFile=*/true);
844     if (!FileOrErr) {
845       // FIXME: include the error in the diagnostic.
846       consumeError(FileOrErr.takeError());
847       Diags.Report(diag::err_fe_error_reading) << InputFile;
848       return false;
849     }
850     FileEntryRef File = *FileOrErr;
851 
852     // The natural SourceManager infrastructure can't currently handle named
853     // pipes, but we would at least like to accept them for the main
854     // file. Detect them here, read them with the volatile flag so FileMgr will
855     // pick up the correct size, and simply override their contents as we do for
856     // STDIN.
857     if (File.getFileEntry().isNamedPipe()) {
858       auto MB =
859           FileMgr.getBufferForFile(&File.getFileEntry(), /*isVolatile=*/true);
860       if (MB) {
861         // Create a new virtual file that will have the correct size.
862         const FileEntry *FE =
863             FileMgr.getVirtualFile(InputFile, (*MB)->getBufferSize(), 0);
864         SourceMgr.overrideFileContents(FE, std::move(*MB));
865         SourceMgr.setMainFileID(
866             SourceMgr.createFileID(FE, SourceLocation(), Kind));
867       } else {
868         Diags.Report(diag::err_cannot_open_file) << InputFile
869                                                  << MB.getError().message();
870         return false;
871       }
872     } else {
873       SourceMgr.setMainFileID(
874           SourceMgr.createFileID(File, SourceLocation(), Kind));
875     }
876   } else {
877     llvm::ErrorOr<std::unique_ptr<llvm::MemoryBuffer>> SBOrErr =
878         llvm::MemoryBuffer::getSTDIN();
879     if (std::error_code EC = SBOrErr.getError()) {
880       Diags.Report(diag::err_fe_error_reading_stdin) << EC.message();
881       return false;
882     }
883     std::unique_ptr<llvm::MemoryBuffer> SB = std::move(SBOrErr.get());
884 
885     const FileEntry *File = FileMgr.getVirtualFile(SB->getBufferIdentifier(),
886                                                    SB->getBufferSize(), 0);
887     SourceMgr.setMainFileID(
888         SourceMgr.createFileID(File, SourceLocation(), Kind));
889     SourceMgr.overrideFileContents(File, std::move(SB));
890   }
891 
892   assert(SourceMgr.getMainFileID().isValid() &&
893          "Couldn't establish MainFileID!");
894   return true;
895 }
896 
897 // High-Level Operations
898 
899 bool CompilerInstance::ExecuteAction(FrontendAction &Act) {
900   assert(hasDiagnostics() && "Diagnostics engine is not initialized!");
901   assert(!getFrontendOpts().ShowHelp && "Client must handle '-help'!");
902   assert(!getFrontendOpts().ShowVersion && "Client must handle '-version'!");
903 
904   // Mark this point as the bottom of the stack if we don't have somewhere
905   // better. We generally expect frontend actions to be invoked with (nearly)
906   // DesiredStackSpace available.
907   noteBottomOfStack();
908 
909   raw_ostream &OS = getVerboseOutputStream();
910 
911   if (!Act.PrepareToExecute(*this))
912     return false;
913 
914   // Create the target instance.
915   setTarget(TargetInfo::CreateTargetInfo(getDiagnostics(),
916                                          getInvocation().TargetOpts));
917   if (!hasTarget())
918     return false;
919 
920   // Create TargetInfo for the other side of CUDA/OpenMP/SYCL compilation.
921   if ((getLangOpts().CUDA || getLangOpts().OpenMPIsDevice ||
922        getLangOpts().SYCLIsDevice) &&
923       !getFrontendOpts().AuxTriple.empty()) {
924     auto TO = std::make_shared<TargetOptions>();
925     TO->Triple = llvm::Triple::normalize(getFrontendOpts().AuxTriple);
926     TO->HostTriple = getTarget().getTriple().str();
927     setAuxTarget(TargetInfo::CreateTargetInfo(getDiagnostics(), TO));
928   }
929 
930   if (!getTarget().hasStrictFP() && !getLangOpts().ExpStrictFP) {
931     if (getLangOpts().getFPRoundingMode() !=
932         LangOptions::FPR_ToNearest) {
933       getDiagnostics().Report(diag::warn_fe_backend_unsupported_fp_rounding);
934       getLangOpts().setFPRoundingMode(LangOptions::FPR_ToNearest);
935     }
936     if (getLangOpts().getFPExceptionMode() != LangOptions::FPE_Ignore) {
937       getDiagnostics().Report(diag::warn_fe_backend_unsupported_fp_exceptions);
938       getLangOpts().setFPExceptionMode(LangOptions::FPE_Ignore);
939     }
940     // FIXME: can we disable FEnvAccess?
941   }
942 
943   // Inform the target of the language options.
944   //
945   // FIXME: We shouldn't need to do this, the target should be immutable once
946   // created. This complexity should be lifted elsewhere.
947   getTarget().adjust(getLangOpts());
948 
949   // Adjust target options based on codegen options.
950   getTarget().adjustTargetOptions(getCodeGenOpts(), getTargetOpts());
951 
952   if (auto *Aux = getAuxTarget())
953     getTarget().setAuxTarget(Aux);
954 
955   // rewriter project will change target built-in bool type from its default.
956   if (getFrontendOpts().ProgramAction == frontend::RewriteObjC)
957     getTarget().noSignedCharForObjCBool();
958 
959   // Validate/process some options.
960   if (getHeaderSearchOpts().Verbose)
961     OS << "clang -cc1 version " CLANG_VERSION_STRING
962        << " based upon " << BACKEND_PACKAGE_STRING
963        << " default target " << llvm::sys::getDefaultTargetTriple() << "\n";
964 
965   if (getFrontendOpts().ShowTimers)
966     createFrontendTimer();
967 
968   if (getFrontendOpts().ShowStats || !getFrontendOpts().StatsFile.empty())
969     llvm::EnableStatistics(false);
970 
971   for (const FrontendInputFile &FIF : getFrontendOpts().Inputs) {
972     // Reset the ID tables if we are reusing the SourceManager and parsing
973     // regular files.
974     if (hasSourceManager() && !Act.isModelParsingAction())
975       getSourceManager().clearIDTables();
976 
977     if (Act.BeginSourceFile(*this, FIF)) {
978       if (llvm::Error Err = Act.Execute()) {
979         consumeError(std::move(Err)); // FIXME this drops errors on the floor.
980       }
981       Act.EndSourceFile();
982     }
983   }
984 
985   // Notify the diagnostic client that all files were processed.
986   getDiagnostics().getClient()->finish();
987 
988   if (getDiagnosticOpts().ShowCarets) {
989     // We can have multiple diagnostics sharing one diagnostic client.
990     // Get the total number of warnings/errors from the client.
991     unsigned NumWarnings = getDiagnostics().getClient()->getNumWarnings();
992     unsigned NumErrors = getDiagnostics().getClient()->getNumErrors();
993 
994     if (NumWarnings)
995       OS << NumWarnings << " warning" << (NumWarnings == 1 ? "" : "s");
996     if (NumWarnings && NumErrors)
997       OS << " and ";
998     if (NumErrors)
999       OS << NumErrors << " error" << (NumErrors == 1 ? "" : "s");
1000     if (NumWarnings || NumErrors) {
1001       OS << " generated";
1002       if (getLangOpts().CUDA) {
1003         if (!getLangOpts().CUDAIsDevice) {
1004           OS << " when compiling for host";
1005         } else {
1006           OS << " when compiling for " << getTargetOpts().CPU;
1007         }
1008       }
1009       OS << ".\n";
1010     }
1011   }
1012 
1013   if (getFrontendOpts().ShowStats) {
1014     if (hasFileManager()) {
1015       getFileManager().PrintStats();
1016       OS << '\n';
1017     }
1018     llvm::PrintStatistics(OS);
1019   }
1020   StringRef StatsFile = getFrontendOpts().StatsFile;
1021   if (!StatsFile.empty()) {
1022     std::error_code EC;
1023     auto StatS = std::make_unique<llvm::raw_fd_ostream>(
1024         StatsFile, EC, llvm::sys::fs::OF_Text);
1025     if (EC) {
1026       getDiagnostics().Report(diag::warn_fe_unable_to_open_stats_file)
1027           << StatsFile << EC.message();
1028     } else {
1029       llvm::PrintStatisticsJSON(*StatS);
1030     }
1031   }
1032 
1033   return !getDiagnostics().getClient()->getNumErrors();
1034 }
1035 
1036 /// Determine the appropriate source input kind based on language
1037 /// options.
1038 static Language getLanguageFromOptions(const LangOptions &LangOpts) {
1039   if (LangOpts.OpenCL)
1040     return Language::OpenCL;
1041   if (LangOpts.CUDA)
1042     return Language::CUDA;
1043   if (LangOpts.ObjC)
1044     return LangOpts.CPlusPlus ? Language::ObjCXX : Language::ObjC;
1045   return LangOpts.CPlusPlus ? Language::CXX : Language::C;
1046 }
1047 
1048 /// Compile a module file for the given module, using the options
1049 /// provided by the importing compiler instance. Returns true if the module
1050 /// was built without errors.
1051 static bool
1052 compileModuleImpl(CompilerInstance &ImportingInstance, SourceLocation ImportLoc,
1053                   StringRef ModuleName, FrontendInputFile Input,
1054                   StringRef OriginalModuleMapFile, StringRef ModuleFileName,
1055                   llvm::function_ref<void(CompilerInstance &)> PreBuildStep =
1056                       [](CompilerInstance &) {},
1057                   llvm::function_ref<void(CompilerInstance &)> PostBuildStep =
1058                       [](CompilerInstance &) {}) {
1059   llvm::TimeTraceScope TimeScope("Module Compile", ModuleName);
1060 
1061   // Construct a compiler invocation for creating this module.
1062   auto Invocation =
1063       std::make_shared<CompilerInvocation>(ImportingInstance.getInvocation());
1064 
1065   PreprocessorOptions &PPOpts = Invocation->getPreprocessorOpts();
1066 
1067   // For any options that aren't intended to affect how a module is built,
1068   // reset them to their default values.
1069   Invocation->getLangOpts()->resetNonModularOptions();
1070   PPOpts.resetNonModularOptions();
1071 
1072   // Remove any macro definitions that are explicitly ignored by the module.
1073   // They aren't supposed to affect how the module is built anyway.
1074   HeaderSearchOptions &HSOpts = Invocation->getHeaderSearchOpts();
1075   PPOpts.Macros.erase(
1076       std::remove_if(PPOpts.Macros.begin(), PPOpts.Macros.end(),
1077                      [&HSOpts](const std::pair<std::string, bool> &def) {
1078         StringRef MacroDef = def.first;
1079         return HSOpts.ModulesIgnoreMacros.count(
1080                    llvm::CachedHashString(MacroDef.split('=').first)) > 0;
1081       }),
1082       PPOpts.Macros.end());
1083 
1084   // If the original compiler invocation had -fmodule-name, pass it through.
1085   Invocation->getLangOpts()->ModuleName =
1086       ImportingInstance.getInvocation().getLangOpts()->ModuleName;
1087 
1088   // Note the name of the module we're building.
1089   Invocation->getLangOpts()->CurrentModule = ModuleName;
1090 
1091   // Make sure that the failed-module structure has been allocated in
1092   // the importing instance, and propagate the pointer to the newly-created
1093   // instance.
1094   PreprocessorOptions &ImportingPPOpts
1095     = ImportingInstance.getInvocation().getPreprocessorOpts();
1096   if (!ImportingPPOpts.FailedModules)
1097     ImportingPPOpts.FailedModules =
1098         std::make_shared<PreprocessorOptions::FailedModulesSet>();
1099   PPOpts.FailedModules = ImportingPPOpts.FailedModules;
1100 
1101   // If there is a module map file, build the module using the module map.
1102   // Set up the inputs/outputs so that we build the module from its umbrella
1103   // header.
1104   FrontendOptions &FrontendOpts = Invocation->getFrontendOpts();
1105   FrontendOpts.OutputFile = ModuleFileName.str();
1106   FrontendOpts.DisableFree = false;
1107   FrontendOpts.GenerateGlobalModuleIndex = false;
1108   FrontendOpts.BuildingImplicitModule = true;
1109   FrontendOpts.OriginalModuleMap = OriginalModuleMapFile;
1110   // Force implicitly-built modules to hash the content of the module file.
1111   HSOpts.ModulesHashContent = true;
1112   FrontendOpts.Inputs = {Input};
1113 
1114   // Don't free the remapped file buffers; they are owned by our caller.
1115   PPOpts.RetainRemappedFileBuffers = true;
1116 
1117   Invocation->getDiagnosticOpts().VerifyDiagnostics = 0;
1118   assert(ImportingInstance.getInvocation().getModuleHash() ==
1119          Invocation->getModuleHash() && "Module hash mismatch!");
1120 
1121   // Construct a compiler instance that will be used to actually create the
1122   // module.  Since we're sharing an in-memory module cache,
1123   // CompilerInstance::CompilerInstance is responsible for finalizing the
1124   // buffers to prevent use-after-frees.
1125   CompilerInstance Instance(ImportingInstance.getPCHContainerOperations(),
1126                             &ImportingInstance.getModuleCache());
1127   auto &Inv = *Invocation;
1128   Instance.setInvocation(std::move(Invocation));
1129 
1130   Instance.createDiagnostics(new ForwardingDiagnosticConsumer(
1131                                    ImportingInstance.getDiagnosticClient()),
1132                              /*ShouldOwnClient=*/true);
1133 
1134   // Note that this module is part of the module build stack, so that we
1135   // can detect cycles in the module graph.
1136   Instance.setFileManager(&ImportingInstance.getFileManager());
1137   Instance.createSourceManager(Instance.getFileManager());
1138   SourceManager &SourceMgr = Instance.getSourceManager();
1139   SourceMgr.setModuleBuildStack(
1140     ImportingInstance.getSourceManager().getModuleBuildStack());
1141   SourceMgr.pushModuleBuildStack(ModuleName,
1142     FullSourceLoc(ImportLoc, ImportingInstance.getSourceManager()));
1143 
1144   // If we're collecting module dependencies, we need to share a collector
1145   // between all of the module CompilerInstances. Other than that, we don't
1146   // want to produce any dependency output from the module build.
1147   Instance.setModuleDepCollector(ImportingInstance.getModuleDepCollector());
1148   Inv.getDependencyOutputOpts() = DependencyOutputOptions();
1149 
1150   ImportingInstance.getDiagnostics().Report(ImportLoc,
1151                                             diag::remark_module_build)
1152     << ModuleName << ModuleFileName;
1153 
1154   PreBuildStep(Instance);
1155 
1156   // Execute the action to actually build the module in-place. Use a separate
1157   // thread so that we get a stack large enough.
1158   llvm::CrashRecoveryContext CRC;
1159   CRC.RunSafelyOnThread(
1160       [&]() {
1161         GenerateModuleFromModuleMapAction Action;
1162         Instance.ExecuteAction(Action);
1163       },
1164       DesiredStackSize);
1165 
1166   PostBuildStep(Instance);
1167 
1168   ImportingInstance.getDiagnostics().Report(ImportLoc,
1169                                             diag::remark_module_build_done)
1170     << ModuleName;
1171 
1172   // Delete the temporary module map file.
1173   // FIXME: Even though we're executing under crash protection, it would still
1174   // be nice to do this with RemoveFileOnSignal when we can. However, that
1175   // doesn't make sense for all clients, so clean this up manually.
1176   Instance.clearOutputFiles(/*EraseFiles=*/true);
1177 
1178   return !Instance.getDiagnostics().hasErrorOccurred();
1179 }
1180 
1181 static const FileEntry *getPublicModuleMap(const FileEntry *File,
1182                                            FileManager &FileMgr) {
1183   StringRef Filename = llvm::sys::path::filename(File->getName());
1184   SmallString<128> PublicFilename(File->getDir()->getName());
1185   if (Filename == "module_private.map")
1186     llvm::sys::path::append(PublicFilename, "module.map");
1187   else if (Filename == "module.private.modulemap")
1188     llvm::sys::path::append(PublicFilename, "module.modulemap");
1189   else
1190     return nullptr;
1191   if (auto FE = FileMgr.getFile(PublicFilename))
1192     return *FE;
1193   return nullptr;
1194 }
1195 
1196 /// Compile a module file for the given module in a separate compiler instance,
1197 /// using the options provided by the importing compiler instance. Returns true
1198 /// if the module was built without errors.
1199 static bool compileModule(CompilerInstance &ImportingInstance,
1200                           SourceLocation ImportLoc, Module *Module,
1201                           StringRef ModuleFileName) {
1202   InputKind IK(getLanguageFromOptions(ImportingInstance.getLangOpts()),
1203                InputKind::ModuleMap);
1204 
1205   // Get or create the module map that we'll use to build this module.
1206   ModuleMap &ModMap
1207     = ImportingInstance.getPreprocessor().getHeaderSearchInfo().getModuleMap();
1208   bool Result;
1209   if (const FileEntry *ModuleMapFile =
1210           ModMap.getContainingModuleMapFile(Module)) {
1211     // Canonicalize compilation to start with the public module map. This is
1212     // vital for submodules declarations in the private module maps to be
1213     // correctly parsed when depending on a top level module in the public one.
1214     if (const FileEntry *PublicMMFile = getPublicModuleMap(
1215             ModuleMapFile, ImportingInstance.getFileManager()))
1216       ModuleMapFile = PublicMMFile;
1217 
1218     // Use the module map where this module resides.
1219     Result = compileModuleImpl(
1220         ImportingInstance, ImportLoc, Module->getTopLevelModuleName(),
1221         FrontendInputFile(ModuleMapFile->getName(), IK, +Module->IsSystem),
1222         ModMap.getModuleMapFileForUniquing(Module)->getName(),
1223         ModuleFileName);
1224   } else {
1225     // FIXME: We only need to fake up an input file here as a way of
1226     // transporting the module's directory to the module map parser. We should
1227     // be able to do that more directly, and parse from a memory buffer without
1228     // inventing this file.
1229     SmallString<128> FakeModuleMapFile(Module->Directory->getName());
1230     llvm::sys::path::append(FakeModuleMapFile, "__inferred_module.map");
1231 
1232     std::string InferredModuleMapContent;
1233     llvm::raw_string_ostream OS(InferredModuleMapContent);
1234     Module->print(OS);
1235     OS.flush();
1236 
1237     Result = compileModuleImpl(
1238         ImportingInstance, ImportLoc, Module->getTopLevelModuleName(),
1239         FrontendInputFile(FakeModuleMapFile, IK, +Module->IsSystem),
1240         ModMap.getModuleMapFileForUniquing(Module)->getName(),
1241         ModuleFileName,
1242         [&](CompilerInstance &Instance) {
1243       std::unique_ptr<llvm::MemoryBuffer> ModuleMapBuffer =
1244           llvm::MemoryBuffer::getMemBuffer(InferredModuleMapContent);
1245       ModuleMapFile = Instance.getFileManager().getVirtualFile(
1246           FakeModuleMapFile, InferredModuleMapContent.size(), 0);
1247       Instance.getSourceManager().overrideFileContents(
1248           ModuleMapFile, std::move(ModuleMapBuffer));
1249     });
1250   }
1251 
1252   // We've rebuilt a module. If we're allowed to generate or update the global
1253   // module index, record that fact in the importing compiler instance.
1254   if (ImportingInstance.getFrontendOpts().GenerateGlobalModuleIndex) {
1255     ImportingInstance.setBuildGlobalModuleIndex(true);
1256   }
1257 
1258   return Result;
1259 }
1260 
1261 /// Compile a module in a separate compiler instance and read the AST,
1262 /// returning true if the module compiles without errors.
1263 ///
1264 /// Uses a lock file manager and exponential backoff to reduce the chances that
1265 /// multiple instances will compete to create the same module.  On timeout,
1266 /// deletes the lock file in order to avoid deadlock from crashing processes or
1267 /// bugs in the lock file manager.
1268 static bool compileModuleAndReadAST(CompilerInstance &ImportingInstance,
1269                                     SourceLocation ImportLoc,
1270                                     SourceLocation ModuleNameLoc,
1271                                     Module *Module, StringRef ModuleFileName) {
1272   DiagnosticsEngine &Diags = ImportingInstance.getDiagnostics();
1273 
1274   auto diagnoseBuildFailure = [&] {
1275     Diags.Report(ModuleNameLoc, diag::err_module_not_built)
1276         << Module->Name << SourceRange(ImportLoc, ModuleNameLoc);
1277   };
1278 
1279   // FIXME: have LockFileManager return an error_code so that we can
1280   // avoid the mkdir when the directory already exists.
1281   StringRef Dir = llvm::sys::path::parent_path(ModuleFileName);
1282   llvm::sys::fs::create_directories(Dir);
1283 
1284   while (1) {
1285     unsigned ModuleLoadCapabilities = ASTReader::ARR_Missing;
1286     llvm::LockFileManager Locked(ModuleFileName);
1287     switch (Locked) {
1288     case llvm::LockFileManager::LFS_Error:
1289       // ModuleCache takes care of correctness and locks are only necessary for
1290       // performance. Fallback to building the module in case of any lock
1291       // related errors.
1292       Diags.Report(ModuleNameLoc, diag::remark_module_lock_failure)
1293           << Module->Name << Locked.getErrorMessage();
1294       // Clear out any potential leftover.
1295       Locked.unsafeRemoveLockFile();
1296       LLVM_FALLTHROUGH;
1297     case llvm::LockFileManager::LFS_Owned:
1298       // We're responsible for building the module ourselves.
1299       if (!compileModule(ImportingInstance, ModuleNameLoc, Module,
1300                          ModuleFileName)) {
1301         diagnoseBuildFailure();
1302         return false;
1303       }
1304       break;
1305 
1306     case llvm::LockFileManager::LFS_Shared:
1307       // Someone else is responsible for building the module. Wait for them to
1308       // finish.
1309       switch (Locked.waitForUnlock()) {
1310       case llvm::LockFileManager::Res_Success:
1311         ModuleLoadCapabilities |= ASTReader::ARR_OutOfDate;
1312         break;
1313       case llvm::LockFileManager::Res_OwnerDied:
1314         continue; // try again to get the lock.
1315       case llvm::LockFileManager::Res_Timeout:
1316         // Since ModuleCache takes care of correctness, we try waiting for
1317         // another process to complete the build so clang does not do it done
1318         // twice. If case of timeout, build it ourselves.
1319         Diags.Report(ModuleNameLoc, diag::remark_module_lock_timeout)
1320             << Module->Name;
1321         // Clear the lock file so that future invocations can make progress.
1322         Locked.unsafeRemoveLockFile();
1323         continue;
1324       }
1325       break;
1326     }
1327 
1328     // Try to read the module file, now that we've compiled it.
1329     ASTReader::ASTReadResult ReadResult =
1330         ImportingInstance.getASTReader()->ReadAST(
1331             ModuleFileName, serialization::MK_ImplicitModule, ImportLoc,
1332             ModuleLoadCapabilities);
1333 
1334     if (ReadResult == ASTReader::OutOfDate &&
1335         Locked == llvm::LockFileManager::LFS_Shared) {
1336       // The module may be out of date in the presence of file system races,
1337       // or if one of its imports depends on header search paths that are not
1338       // consistent with this ImportingInstance.  Try again...
1339       continue;
1340     } else if (ReadResult == ASTReader::Missing) {
1341       diagnoseBuildFailure();
1342     } else if (ReadResult != ASTReader::Success &&
1343                !Diags.hasErrorOccurred()) {
1344       // The ASTReader didn't diagnose the error, so conservatively report it.
1345       diagnoseBuildFailure();
1346     }
1347     return ReadResult == ASTReader::Success;
1348   }
1349 }
1350 
1351 /// Diagnose differences between the current definition of the given
1352 /// configuration macro and the definition provided on the command line.
1353 static void checkConfigMacro(Preprocessor &PP, StringRef ConfigMacro,
1354                              Module *Mod, SourceLocation ImportLoc) {
1355   IdentifierInfo *Id = PP.getIdentifierInfo(ConfigMacro);
1356   SourceManager &SourceMgr = PP.getSourceManager();
1357 
1358   // If this identifier has never had a macro definition, then it could
1359   // not have changed.
1360   if (!Id->hadMacroDefinition())
1361     return;
1362   auto *LatestLocalMD = PP.getLocalMacroDirectiveHistory(Id);
1363 
1364   // Find the macro definition from the command line.
1365   MacroInfo *CmdLineDefinition = nullptr;
1366   for (auto *MD = LatestLocalMD; MD; MD = MD->getPrevious()) {
1367     // We only care about the predefines buffer.
1368     FileID FID = SourceMgr.getFileID(MD->getLocation());
1369     if (FID.isInvalid() || FID != PP.getPredefinesFileID())
1370       continue;
1371     if (auto *DMD = dyn_cast<DefMacroDirective>(MD))
1372       CmdLineDefinition = DMD->getMacroInfo();
1373     break;
1374   }
1375 
1376   auto *CurrentDefinition = PP.getMacroInfo(Id);
1377   if (CurrentDefinition == CmdLineDefinition) {
1378     // Macro matches. Nothing to do.
1379   } else if (!CurrentDefinition) {
1380     // This macro was defined on the command line, then #undef'd later.
1381     // Complain.
1382     PP.Diag(ImportLoc, diag::warn_module_config_macro_undef)
1383       << true << ConfigMacro << Mod->getFullModuleName();
1384     auto LatestDef = LatestLocalMD->getDefinition();
1385     assert(LatestDef.isUndefined() &&
1386            "predefined macro went away with no #undef?");
1387     PP.Diag(LatestDef.getUndefLocation(), diag::note_module_def_undef_here)
1388       << true;
1389     return;
1390   } else if (!CmdLineDefinition) {
1391     // There was no definition for this macro in the predefines buffer,
1392     // but there was a local definition. Complain.
1393     PP.Diag(ImportLoc, diag::warn_module_config_macro_undef)
1394       << false << ConfigMacro << Mod->getFullModuleName();
1395     PP.Diag(CurrentDefinition->getDefinitionLoc(),
1396             diag::note_module_def_undef_here)
1397       << false;
1398   } else if (!CurrentDefinition->isIdenticalTo(*CmdLineDefinition, PP,
1399                                                /*Syntactically=*/true)) {
1400     // The macro definitions differ.
1401     PP.Diag(ImportLoc, diag::warn_module_config_macro_undef)
1402       << false << ConfigMacro << Mod->getFullModuleName();
1403     PP.Diag(CurrentDefinition->getDefinitionLoc(),
1404             diag::note_module_def_undef_here)
1405       << false;
1406   }
1407 }
1408 
1409 /// Write a new timestamp file with the given path.
1410 static void writeTimestampFile(StringRef TimestampFile) {
1411   std::error_code EC;
1412   llvm::raw_fd_ostream Out(TimestampFile.str(), EC, llvm::sys::fs::OF_None);
1413 }
1414 
1415 /// Prune the module cache of modules that haven't been accessed in
1416 /// a long time.
1417 static void pruneModuleCache(const HeaderSearchOptions &HSOpts) {
1418   llvm::sys::fs::file_status StatBuf;
1419   llvm::SmallString<128> TimestampFile;
1420   TimestampFile = HSOpts.ModuleCachePath;
1421   assert(!TimestampFile.empty());
1422   llvm::sys::path::append(TimestampFile, "modules.timestamp");
1423 
1424   // Try to stat() the timestamp file.
1425   if (std::error_code EC = llvm::sys::fs::status(TimestampFile, StatBuf)) {
1426     // If the timestamp file wasn't there, create one now.
1427     if (EC == std::errc::no_such_file_or_directory) {
1428       writeTimestampFile(TimestampFile);
1429     }
1430     return;
1431   }
1432 
1433   // Check whether the time stamp is older than our pruning interval.
1434   // If not, do nothing.
1435   time_t TimeStampModTime =
1436       llvm::sys::toTimeT(StatBuf.getLastModificationTime());
1437   time_t CurrentTime = time(nullptr);
1438   if (CurrentTime - TimeStampModTime <= time_t(HSOpts.ModuleCachePruneInterval))
1439     return;
1440 
1441   // Write a new timestamp file so that nobody else attempts to prune.
1442   // There is a benign race condition here, if two Clang instances happen to
1443   // notice at the same time that the timestamp is out-of-date.
1444   writeTimestampFile(TimestampFile);
1445 
1446   // Walk the entire module cache, looking for unused module files and module
1447   // indices.
1448   std::error_code EC;
1449   SmallString<128> ModuleCachePathNative;
1450   llvm::sys::path::native(HSOpts.ModuleCachePath, ModuleCachePathNative);
1451   for (llvm::sys::fs::directory_iterator Dir(ModuleCachePathNative, EC), DirEnd;
1452        Dir != DirEnd && !EC; Dir.increment(EC)) {
1453     // If we don't have a directory, there's nothing to look into.
1454     if (!llvm::sys::fs::is_directory(Dir->path()))
1455       continue;
1456 
1457     // Walk all of the files within this directory.
1458     for (llvm::sys::fs::directory_iterator File(Dir->path(), EC), FileEnd;
1459          File != FileEnd && !EC; File.increment(EC)) {
1460       // We only care about module and global module index files.
1461       StringRef Extension = llvm::sys::path::extension(File->path());
1462       if (Extension != ".pcm" && Extension != ".timestamp" &&
1463           llvm::sys::path::filename(File->path()) != "modules.idx")
1464         continue;
1465 
1466       // Look at this file. If we can't stat it, there's nothing interesting
1467       // there.
1468       if (llvm::sys::fs::status(File->path(), StatBuf))
1469         continue;
1470 
1471       // If the file has been used recently enough, leave it there.
1472       time_t FileAccessTime = llvm::sys::toTimeT(StatBuf.getLastAccessedTime());
1473       if (CurrentTime - FileAccessTime <=
1474               time_t(HSOpts.ModuleCachePruneAfter)) {
1475         continue;
1476       }
1477 
1478       // Remove the file.
1479       llvm::sys::fs::remove(File->path());
1480 
1481       // Remove the timestamp file.
1482       std::string TimpestampFilename = File->path() + ".timestamp";
1483       llvm::sys::fs::remove(TimpestampFilename);
1484     }
1485 
1486     // If we removed all of the files in the directory, remove the directory
1487     // itself.
1488     if (llvm::sys::fs::directory_iterator(Dir->path(), EC) ==
1489             llvm::sys::fs::directory_iterator() && !EC)
1490       llvm::sys::fs::remove(Dir->path());
1491   }
1492 }
1493 
1494 void CompilerInstance::createASTReader() {
1495   if (TheASTReader)
1496     return;
1497 
1498   if (!hasASTContext())
1499     createASTContext();
1500 
1501   // If we're implicitly building modules but not currently recursively
1502   // building a module, check whether we need to prune the module cache.
1503   if (getSourceManager().getModuleBuildStack().empty() &&
1504       !getPreprocessor().getHeaderSearchInfo().getModuleCachePath().empty() &&
1505       getHeaderSearchOpts().ModuleCachePruneInterval > 0 &&
1506       getHeaderSearchOpts().ModuleCachePruneAfter > 0) {
1507     pruneModuleCache(getHeaderSearchOpts());
1508   }
1509 
1510   HeaderSearchOptions &HSOpts = getHeaderSearchOpts();
1511   std::string Sysroot = HSOpts.Sysroot;
1512   const PreprocessorOptions &PPOpts = getPreprocessorOpts();
1513   std::unique_ptr<llvm::Timer> ReadTimer;
1514   if (FrontendTimerGroup)
1515     ReadTimer = std::make_unique<llvm::Timer>("reading_modules",
1516                                                 "Reading modules",
1517                                                 *FrontendTimerGroup);
1518   TheASTReader = new ASTReader(
1519       getPreprocessor(), getModuleCache(), &getASTContext(),
1520       getPCHContainerReader(), getFrontendOpts().ModuleFileExtensions,
1521       Sysroot.empty() ? "" : Sysroot.c_str(), PPOpts.DisablePCHValidation,
1522       /*AllowASTWithCompilerErrors=*/false,
1523       /*AllowConfigurationMismatch=*/false, HSOpts.ModulesValidateSystemHeaders,
1524       HSOpts.ValidateASTInputFilesContent,
1525       getFrontendOpts().UseGlobalModuleIndex, std::move(ReadTimer));
1526   if (hasASTConsumer()) {
1527     TheASTReader->setDeserializationListener(
1528         getASTConsumer().GetASTDeserializationListener());
1529     getASTContext().setASTMutationListener(
1530       getASTConsumer().GetASTMutationListener());
1531   }
1532   getASTContext().setExternalSource(TheASTReader);
1533   if (hasSema())
1534     TheASTReader->InitializeSema(getSema());
1535   if (hasASTConsumer())
1536     TheASTReader->StartTranslationUnit(&getASTConsumer());
1537 
1538   for (auto &Listener : DependencyCollectors)
1539     Listener->attachToASTReader(*TheASTReader);
1540 }
1541 
1542 bool CompilerInstance::loadModuleFile(StringRef FileName) {
1543   llvm::Timer Timer;
1544   if (FrontendTimerGroup)
1545     Timer.init("preloading." + FileName.str(), "Preloading " + FileName.str(),
1546                *FrontendTimerGroup);
1547   llvm::TimeRegion TimeLoading(FrontendTimerGroup ? &Timer : nullptr);
1548 
1549   // Helper to recursively read the module names for all modules we're adding.
1550   // We mark these as known and redirect any attempt to load that module to
1551   // the files we were handed.
1552   struct ReadModuleNames : ASTReaderListener {
1553     CompilerInstance &CI;
1554     llvm::SmallVector<IdentifierInfo*, 8> LoadedModules;
1555 
1556     ReadModuleNames(CompilerInstance &CI) : CI(CI) {}
1557 
1558     void ReadModuleName(StringRef ModuleName) override {
1559       LoadedModules.push_back(
1560           CI.getPreprocessor().getIdentifierInfo(ModuleName));
1561     }
1562 
1563     void registerAll() {
1564       ModuleMap &MM = CI.getPreprocessor().getHeaderSearchInfo().getModuleMap();
1565       for (auto *II : LoadedModules)
1566         MM.cacheModuleLoad(*II, MM.findModule(II->getName()));
1567       LoadedModules.clear();
1568     }
1569 
1570     void markAllUnavailable() {
1571       for (auto *II : LoadedModules) {
1572         if (Module *M = CI.getPreprocessor()
1573                             .getHeaderSearchInfo()
1574                             .getModuleMap()
1575                             .findModule(II->getName())) {
1576           M->HasIncompatibleModuleFile = true;
1577 
1578           // Mark module as available if the only reason it was unavailable
1579           // was missing headers.
1580           SmallVector<Module *, 2> Stack;
1581           Stack.push_back(M);
1582           while (!Stack.empty()) {
1583             Module *Current = Stack.pop_back_val();
1584             if (Current->IsMissingRequirement) continue;
1585             Current->IsAvailable = true;
1586             Stack.insert(Stack.end(),
1587                          Current->submodule_begin(), Current->submodule_end());
1588           }
1589         }
1590       }
1591       LoadedModules.clear();
1592     }
1593   };
1594 
1595   // If we don't already have an ASTReader, create one now.
1596   if (!TheASTReader)
1597     createASTReader();
1598 
1599   // If -Wmodule-file-config-mismatch is mapped as an error or worse, allow the
1600   // ASTReader to diagnose it, since it can produce better errors that we can.
1601   bool ConfigMismatchIsRecoverable =
1602       getDiagnostics().getDiagnosticLevel(diag::warn_module_config_mismatch,
1603                                           SourceLocation())
1604         <= DiagnosticsEngine::Warning;
1605 
1606   auto Listener = std::make_unique<ReadModuleNames>(*this);
1607   auto &ListenerRef = *Listener;
1608   ASTReader::ListenerScope ReadModuleNamesListener(*TheASTReader,
1609                                                    std::move(Listener));
1610 
1611   // Try to load the module file.
1612   switch (TheASTReader->ReadAST(
1613       FileName, serialization::MK_ExplicitModule, SourceLocation(),
1614       ConfigMismatchIsRecoverable ? ASTReader::ARR_ConfigurationMismatch : 0)) {
1615   case ASTReader::Success:
1616     // We successfully loaded the module file; remember the set of provided
1617     // modules so that we don't try to load implicit modules for them.
1618     ListenerRef.registerAll();
1619     return true;
1620 
1621   case ASTReader::ConfigurationMismatch:
1622     // Ignore unusable module files.
1623     getDiagnostics().Report(SourceLocation(), diag::warn_module_config_mismatch)
1624         << FileName;
1625     // All modules provided by any files we tried and failed to load are now
1626     // unavailable; includes of those modules should now be handled textually.
1627     ListenerRef.markAllUnavailable();
1628     return true;
1629 
1630   default:
1631     return false;
1632   }
1633 }
1634 
1635 namespace {
1636 enum ModuleSource {
1637   MS_ModuleNotFound,
1638   MS_ModuleCache,
1639   MS_PrebuiltModulePath,
1640   MS_ModuleBuildPragma
1641 };
1642 } // end namespace
1643 
1644 /// Select a source for loading the named module and compute the filename to
1645 /// load it from.
1646 static ModuleSource
1647 selectModuleSource(Module *M, StringRef ModuleName, std::string &ModuleFilename,
1648                    const std::map<std::string, std::string> &BuiltModules,
1649                    HeaderSearch &HS) {
1650   assert(ModuleFilename.empty() && "Already has a module source?");
1651 
1652   // Check to see if the module has been built as part of this compilation
1653   // via a module build pragma.
1654   auto BuiltModuleIt = BuiltModules.find(ModuleName);
1655   if (BuiltModuleIt != BuiltModules.end()) {
1656     ModuleFilename = BuiltModuleIt->second;
1657     return MS_ModuleBuildPragma;
1658   }
1659 
1660   // Try to load the module from the prebuilt module path.
1661   const HeaderSearchOptions &HSOpts = HS.getHeaderSearchOpts();
1662   if (!HSOpts.PrebuiltModuleFiles.empty() ||
1663       !HSOpts.PrebuiltModulePaths.empty()) {
1664     ModuleFilename = HS.getPrebuiltModuleFileName(ModuleName);
1665     if (!ModuleFilename.empty())
1666       return MS_PrebuiltModulePath;
1667   }
1668 
1669   // Try to load the module from the module cache.
1670   if (M) {
1671     ModuleFilename = HS.getCachedModuleFileName(M);
1672     return MS_ModuleCache;
1673   }
1674 
1675   return MS_ModuleNotFound;
1676 }
1677 
1678 ModuleLoadResult CompilerInstance::findOrCompileModuleAndReadAST(
1679     StringRef ModuleName, SourceLocation ImportLoc,
1680     SourceLocation ModuleNameLoc, bool IsInclusionDirective) {
1681   // Search for a module with the given name.
1682   HeaderSearch &HS = PP->getHeaderSearchInfo();
1683   Module *M = HS.lookupModule(ModuleName, true, !IsInclusionDirective);
1684 
1685   // Select the source and filename for loading the named module.
1686   std::string ModuleFilename;
1687   ModuleSource Source =
1688       selectModuleSource(M, ModuleName, ModuleFilename, BuiltModules, HS);
1689   if (Source == MS_ModuleNotFound) {
1690     // We can't find a module, error out here.
1691     getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_found)
1692         << ModuleName << SourceRange(ImportLoc, ModuleNameLoc);
1693     ModuleBuildFailed = true;
1694     // FIXME: Why is this not cached?
1695     return ModuleLoadResult::OtherUncachedFailure;
1696   }
1697   if (ModuleFilename.empty()) {
1698     if (M && M->HasIncompatibleModuleFile) {
1699       // We tried and failed to load a module file for this module. Fall
1700       // back to textual inclusion for its headers.
1701       return ModuleLoadResult::ConfigMismatch;
1702     }
1703 
1704     getDiagnostics().Report(ModuleNameLoc, diag::err_module_build_disabled)
1705         << ModuleName;
1706     ModuleBuildFailed = true;
1707     // FIXME: Why is this not cached?
1708     return ModuleLoadResult::OtherUncachedFailure;
1709   }
1710 
1711   // Create an ASTReader on demand.
1712   if (!getASTReader())
1713     createASTReader();
1714 
1715   // Time how long it takes to load the module.
1716   llvm::Timer Timer;
1717   if (FrontendTimerGroup)
1718     Timer.init("loading." + ModuleFilename, "Loading " + ModuleFilename,
1719                *FrontendTimerGroup);
1720   llvm::TimeRegion TimeLoading(FrontendTimerGroup ? &Timer : nullptr);
1721   llvm::TimeTraceScope TimeScope("Module Load", ModuleName);
1722 
1723   // Try to load the module file. If we are not trying to load from the
1724   // module cache, we don't know how to rebuild modules.
1725   unsigned ARRFlags = Source == MS_ModuleCache
1726                           ? ASTReader::ARR_OutOfDate | ASTReader::ARR_Missing
1727                           : Source == MS_PrebuiltModulePath
1728                                 ? 0
1729                                 : ASTReader::ARR_ConfigurationMismatch;
1730   switch (getASTReader()->ReadAST(ModuleFilename,
1731                                   Source == MS_PrebuiltModulePath
1732                                       ? serialization::MK_PrebuiltModule
1733                                       : Source == MS_ModuleBuildPragma
1734                                             ? serialization::MK_ExplicitModule
1735                                             : serialization::MK_ImplicitModule,
1736                                   ImportLoc, ARRFlags)) {
1737   case ASTReader::Success: {
1738     if (M)
1739       return M;
1740     assert(Source != MS_ModuleCache &&
1741            "missing module, but file loaded from cache");
1742 
1743     // A prebuilt module is indexed as a ModuleFile; the Module does not exist
1744     // until the first call to ReadAST.  Look it up now.
1745     M = HS.lookupModule(ModuleName, true, !IsInclusionDirective);
1746 
1747     // Check whether M refers to the file in the prebuilt module path.
1748     if (M && M->getASTFile())
1749       if (auto ModuleFile = FileMgr->getFile(ModuleFilename))
1750         if (*ModuleFile == M->getASTFile())
1751           return M;
1752 
1753     ModuleBuildFailed = true;
1754     getDiagnostics().Report(ModuleNameLoc, diag::err_module_prebuilt)
1755         << ModuleName;
1756     return ModuleLoadResult();
1757   }
1758 
1759   case ASTReader::OutOfDate:
1760   case ASTReader::Missing:
1761     // The most interesting case.
1762     break;
1763 
1764   case ASTReader::ConfigurationMismatch:
1765     if (Source == MS_PrebuiltModulePath)
1766       // FIXME: We shouldn't be setting HadFatalFailure below if we only
1767       // produce a warning here!
1768       getDiagnostics().Report(SourceLocation(),
1769                               diag::warn_module_config_mismatch)
1770           << ModuleFilename;
1771     // Fall through to error out.
1772     LLVM_FALLTHROUGH;
1773   case ASTReader::VersionMismatch:
1774   case ASTReader::HadErrors:
1775     // FIXME: Should this set ModuleBuildFailed = true?
1776     ModuleLoader::HadFatalFailure = true;
1777     // FIXME: The ASTReader will already have complained, but can we shoehorn
1778     // that diagnostic information into a more useful form?
1779     return ModuleLoadResult();
1780 
1781   case ASTReader::Failure:
1782     // FIXME: Should this set ModuleBuildFailed = true?
1783     ModuleLoader::HadFatalFailure = true;
1784     return ModuleLoadResult();
1785   }
1786 
1787   // ReadAST returned Missing or OutOfDate.
1788   if (Source != MS_ModuleCache) {
1789     // We don't know the desired configuration for this module and don't
1790     // necessarily even have a module map. Since ReadAST already produces
1791     // diagnostics for these two cases, we simply error out here.
1792     ModuleBuildFailed = true;
1793     return ModuleLoadResult();
1794   }
1795 
1796   // The module file is missing or out-of-date. Build it.
1797   assert(M && "missing module, but trying to compile for cache");
1798 
1799   // Check whether there is a cycle in the module graph.
1800   ModuleBuildStack ModPath = getSourceManager().getModuleBuildStack();
1801   ModuleBuildStack::iterator Pos = ModPath.begin(), PosEnd = ModPath.end();
1802   for (; Pos != PosEnd; ++Pos) {
1803     if (Pos->first == ModuleName)
1804       break;
1805   }
1806 
1807   if (Pos != PosEnd) {
1808     SmallString<256> CyclePath;
1809     for (; Pos != PosEnd; ++Pos) {
1810       CyclePath += Pos->first;
1811       CyclePath += " -> ";
1812     }
1813     CyclePath += ModuleName;
1814 
1815     getDiagnostics().Report(ModuleNameLoc, diag::err_module_cycle)
1816         << ModuleName << CyclePath;
1817     // FIXME: Should this set ModuleBuildFailed = true?
1818     // FIXME: Why is this not cached?
1819     return ModuleLoadResult::OtherUncachedFailure;
1820   }
1821 
1822   // Check whether we have already attempted to build this module (but
1823   // failed).
1824   if (getPreprocessorOpts().FailedModules &&
1825       getPreprocessorOpts().FailedModules->hasAlreadyFailed(ModuleName)) {
1826     getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_built)
1827         << ModuleName << SourceRange(ImportLoc, ModuleNameLoc);
1828     ModuleBuildFailed = true;
1829     // FIXME: Why is this not cached?
1830     return ModuleLoadResult::OtherUncachedFailure;
1831   }
1832 
1833   // Try to compile and then read the AST.
1834   if (!compileModuleAndReadAST(*this, ImportLoc, ModuleNameLoc, M,
1835                                ModuleFilename)) {
1836     assert(getDiagnostics().hasErrorOccurred() &&
1837            "undiagnosed error in compileModuleAndReadAST");
1838     if (getPreprocessorOpts().FailedModules)
1839       getPreprocessorOpts().FailedModules->addFailed(ModuleName);
1840     ModuleBuildFailed = true;
1841     // FIXME: Why is this not cached?
1842     return ModuleLoadResult::OtherUncachedFailure;
1843   }
1844 
1845   // Okay, we've rebuilt and now loaded the module.
1846   return M;
1847 }
1848 
1849 ModuleLoadResult
1850 CompilerInstance::loadModule(SourceLocation ImportLoc,
1851                              ModuleIdPath Path,
1852                              Module::NameVisibilityKind Visibility,
1853                              bool IsInclusionDirective) {
1854   // Determine what file we're searching from.
1855   StringRef ModuleName = Path[0].first->getName();
1856   SourceLocation ModuleNameLoc = Path[0].second;
1857 
1858   // If we've already handled this import, just return the cached result.
1859   // This one-element cache is important to eliminate redundant diagnostics
1860   // when both the preprocessor and parser see the same import declaration.
1861   if (ImportLoc.isValid() && LastModuleImportLoc == ImportLoc) {
1862     // Make the named module visible.
1863     if (LastModuleImportResult && ModuleName != getLangOpts().CurrentModule)
1864       TheASTReader->makeModuleVisible(LastModuleImportResult, Visibility,
1865                                       ImportLoc);
1866     return LastModuleImportResult;
1867   }
1868 
1869   // If we don't already have information on this module, load the module now.
1870   Module *Module = nullptr;
1871   ModuleMap &MM = getPreprocessor().getHeaderSearchInfo().getModuleMap();
1872   if (auto MaybeModule = MM.getCachedModuleLoad(*Path[0].first)) {
1873     // Use the cached result, which may be nullptr.
1874     Module = *MaybeModule;
1875   } else if (ModuleName == getLangOpts().CurrentModule) {
1876     // This is the module we're building.
1877     Module = PP->getHeaderSearchInfo().lookupModule(
1878         ModuleName, /*AllowSearch*/ true,
1879         /*AllowExtraModuleMapSearch*/ !IsInclusionDirective);
1880     /// FIXME: perhaps we should (a) look for a module using the module name
1881     //  to file map (PrebuiltModuleFiles) and (b) diagnose if still not found?
1882     //if (Module == nullptr) {
1883     //  getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_found)
1884     //    << ModuleName;
1885     //  ModuleBuildFailed = true;
1886     //  return ModuleLoadResult();
1887     //}
1888     MM.cacheModuleLoad(*Path[0].first, Module);
1889   } else {
1890     ModuleLoadResult Result = findOrCompileModuleAndReadAST(
1891         ModuleName, ImportLoc, ModuleNameLoc, IsInclusionDirective);
1892     // FIXME: Can we pull 'ModuleBuildFailed = true' out of the return
1893     // sequences for findOrCompileModuleAndReadAST and do it here (as long as
1894     // the result is not a config mismatch)?  See FIXMEs there.
1895     if (!Result.isNormal())
1896       return Result;
1897     Module = Result;
1898     MM.cacheModuleLoad(*Path[0].first, Module);
1899     if (!Module)
1900       return Module;
1901   }
1902 
1903   // If we never found the module, fail.  Otherwise, verify the module and link
1904   // it up.
1905   if (!Module)
1906     return ModuleLoadResult();
1907 
1908   // Verify that the rest of the module path actually corresponds to
1909   // a submodule.
1910   bool MapPrivateSubModToTopLevel = false;
1911   if (Path.size() > 1) {
1912     for (unsigned I = 1, N = Path.size(); I != N; ++I) {
1913       StringRef Name = Path[I].first->getName();
1914       clang::Module *Sub = Module->findSubmodule(Name);
1915 
1916       // If the user is requesting Foo.Private and it doesn't exist, try to
1917       // match Foo_Private and emit a warning asking for the user to write
1918       // @import Foo_Private instead. FIXME: remove this when existing clients
1919       // migrate off of Foo.Private syntax.
1920       if (!Sub && PP->getLangOpts().ImplicitModules && Name == "Private" &&
1921           Module == Module->getTopLevelModule()) {
1922         SmallString<128> PrivateModule(Module->Name);
1923         PrivateModule.append("_Private");
1924 
1925         SmallVector<std::pair<IdentifierInfo *, SourceLocation>, 2> PrivPath;
1926         auto &II = PP->getIdentifierTable().get(
1927             PrivateModule, PP->getIdentifierInfo(Module->Name)->getTokenID());
1928         PrivPath.push_back(std::make_pair(&II, Path[0].second));
1929 
1930         if (PP->getHeaderSearchInfo().lookupModule(PrivateModule, true,
1931                                                    !IsInclusionDirective))
1932           Sub =
1933               loadModule(ImportLoc, PrivPath, Visibility, IsInclusionDirective);
1934         if (Sub) {
1935           MapPrivateSubModToTopLevel = true;
1936           if (!getDiagnostics().isIgnored(
1937                   diag::warn_no_priv_submodule_use_toplevel, ImportLoc)) {
1938             getDiagnostics().Report(Path[I].second,
1939                                     diag::warn_no_priv_submodule_use_toplevel)
1940                 << Path[I].first << Module->getFullModuleName() << PrivateModule
1941                 << SourceRange(Path[0].second, Path[I].second)
1942                 << FixItHint::CreateReplacement(SourceRange(Path[0].second),
1943                                                 PrivateModule);
1944             getDiagnostics().Report(Sub->DefinitionLoc,
1945                                     diag::note_private_top_level_defined);
1946           }
1947         }
1948       }
1949 
1950       if (!Sub) {
1951         // Attempt to perform typo correction to find a module name that works.
1952         SmallVector<StringRef, 2> Best;
1953         unsigned BestEditDistance = (std::numeric_limits<unsigned>::max)();
1954 
1955         for (clang::Module::submodule_iterator J = Module->submodule_begin(),
1956                                             JEnd = Module->submodule_end();
1957              J != JEnd; ++J) {
1958           unsigned ED = Name.edit_distance((*J)->Name,
1959                                            /*AllowReplacements=*/true,
1960                                            BestEditDistance);
1961           if (ED <= BestEditDistance) {
1962             if (ED < BestEditDistance) {
1963               Best.clear();
1964               BestEditDistance = ED;
1965             }
1966 
1967             Best.push_back((*J)->Name);
1968           }
1969         }
1970 
1971         // If there was a clear winner, user it.
1972         if (Best.size() == 1) {
1973           getDiagnostics().Report(Path[I].second,
1974                                   diag::err_no_submodule_suggest)
1975             << Path[I].first << Module->getFullModuleName() << Best[0]
1976             << SourceRange(Path[0].second, Path[I-1].second)
1977             << FixItHint::CreateReplacement(SourceRange(Path[I].second),
1978                                             Best[0]);
1979 
1980           Sub = Module->findSubmodule(Best[0]);
1981         }
1982       }
1983 
1984       if (!Sub) {
1985         // No submodule by this name. Complain, and don't look for further
1986         // submodules.
1987         getDiagnostics().Report(Path[I].second, diag::err_no_submodule)
1988           << Path[I].first << Module->getFullModuleName()
1989           << SourceRange(Path[0].second, Path[I-1].second);
1990         break;
1991       }
1992 
1993       Module = Sub;
1994     }
1995   }
1996 
1997   // Make the named module visible, if it's not already part of the module
1998   // we are parsing.
1999   if (ModuleName != getLangOpts().CurrentModule) {
2000     if (!Module->IsFromModuleFile && !MapPrivateSubModToTopLevel) {
2001       // We have an umbrella header or directory that doesn't actually include
2002       // all of the headers within the directory it covers. Complain about
2003       // this missing submodule and recover by forgetting that we ever saw
2004       // this submodule.
2005       // FIXME: Should we detect this at module load time? It seems fairly
2006       // expensive (and rare).
2007       getDiagnostics().Report(ImportLoc, diag::warn_missing_submodule)
2008         << Module->getFullModuleName()
2009         << SourceRange(Path.front().second, Path.back().second);
2010 
2011       return ModuleLoadResult::MissingExpected;
2012     }
2013 
2014     // Check whether this module is available.
2015     if (Preprocessor::checkModuleIsAvailable(getLangOpts(), getTarget(),
2016                                              getDiagnostics(), Module)) {
2017       getDiagnostics().Report(ImportLoc, diag::note_module_import_here)
2018         << SourceRange(Path.front().second, Path.back().second);
2019       LastModuleImportLoc = ImportLoc;
2020       LastModuleImportResult = ModuleLoadResult();
2021       return ModuleLoadResult();
2022     }
2023 
2024     TheASTReader->makeModuleVisible(Module, Visibility, ImportLoc);
2025   }
2026 
2027   // Check for any configuration macros that have changed.
2028   clang::Module *TopModule = Module->getTopLevelModule();
2029   for (unsigned I = 0, N = TopModule->ConfigMacros.size(); I != N; ++I) {
2030     checkConfigMacro(getPreprocessor(), TopModule->ConfigMacros[I],
2031                      Module, ImportLoc);
2032   }
2033 
2034   // Resolve any remaining module using export_as for this one.
2035   getPreprocessor()
2036       .getHeaderSearchInfo()
2037       .getModuleMap()
2038       .resolveLinkAsDependencies(TopModule);
2039 
2040   LastModuleImportLoc = ImportLoc;
2041   LastModuleImportResult = ModuleLoadResult(Module);
2042   return LastModuleImportResult;
2043 }
2044 
2045 void CompilerInstance::createModuleFromSource(SourceLocation ImportLoc,
2046                                               StringRef ModuleName,
2047                                               StringRef Source) {
2048   // Avoid creating filenames with special characters.
2049   SmallString<128> CleanModuleName(ModuleName);
2050   for (auto &C : CleanModuleName)
2051     if (!isAlphanumeric(C))
2052       C = '_';
2053 
2054   // FIXME: Using a randomized filename here means that our intermediate .pcm
2055   // output is nondeterministic (as .pcm files refer to each other by name).
2056   // Can this affect the output in any way?
2057   SmallString<128> ModuleFileName;
2058   if (std::error_code EC = llvm::sys::fs::createTemporaryFile(
2059           CleanModuleName, "pcm", ModuleFileName)) {
2060     getDiagnostics().Report(ImportLoc, diag::err_fe_unable_to_open_output)
2061         << ModuleFileName << EC.message();
2062     return;
2063   }
2064   std::string ModuleMapFileName = (CleanModuleName + ".map").str();
2065 
2066   FrontendInputFile Input(
2067       ModuleMapFileName,
2068       InputKind(getLanguageFromOptions(*Invocation->getLangOpts()),
2069                 InputKind::ModuleMap, /*Preprocessed*/true));
2070 
2071   std::string NullTerminatedSource(Source.str());
2072 
2073   auto PreBuildStep = [&](CompilerInstance &Other) {
2074     // Create a virtual file containing our desired source.
2075     // FIXME: We shouldn't need to do this.
2076     const FileEntry *ModuleMapFile = Other.getFileManager().getVirtualFile(
2077         ModuleMapFileName, NullTerminatedSource.size(), 0);
2078     Other.getSourceManager().overrideFileContents(
2079         ModuleMapFile,
2080         llvm::MemoryBuffer::getMemBuffer(NullTerminatedSource.c_str()));
2081 
2082     Other.BuiltModules = std::move(BuiltModules);
2083     Other.DeleteBuiltModules = false;
2084   };
2085 
2086   auto PostBuildStep = [this](CompilerInstance &Other) {
2087     BuiltModules = std::move(Other.BuiltModules);
2088   };
2089 
2090   // Build the module, inheriting any modules that we've built locally.
2091   if (compileModuleImpl(*this, ImportLoc, ModuleName, Input, StringRef(),
2092                         ModuleFileName, PreBuildStep, PostBuildStep)) {
2093     BuiltModules[ModuleName] = ModuleFileName.str();
2094     llvm::sys::RemoveFileOnSignal(ModuleFileName);
2095   }
2096 }
2097 
2098 void CompilerInstance::makeModuleVisible(Module *Mod,
2099                                          Module::NameVisibilityKind Visibility,
2100                                          SourceLocation ImportLoc) {
2101   if (!TheASTReader)
2102     createASTReader();
2103   if (!TheASTReader)
2104     return;
2105 
2106   TheASTReader->makeModuleVisible(Mod, Visibility, ImportLoc);
2107 }
2108 
2109 GlobalModuleIndex *CompilerInstance::loadGlobalModuleIndex(
2110     SourceLocation TriggerLoc) {
2111   if (getPreprocessor().getHeaderSearchInfo().getModuleCachePath().empty())
2112     return nullptr;
2113   if (!TheASTReader)
2114     createASTReader();
2115   // Can't do anything if we don't have the module manager.
2116   if (!TheASTReader)
2117     return nullptr;
2118   // Get an existing global index.  This loads it if not already
2119   // loaded.
2120   TheASTReader->loadGlobalIndex();
2121   GlobalModuleIndex *GlobalIndex = TheASTReader->getGlobalIndex();
2122   // If the global index doesn't exist, create it.
2123   if (!GlobalIndex && shouldBuildGlobalModuleIndex() && hasFileManager() &&
2124       hasPreprocessor()) {
2125     llvm::sys::fs::create_directories(
2126       getPreprocessor().getHeaderSearchInfo().getModuleCachePath());
2127     if (llvm::Error Err = GlobalModuleIndex::writeIndex(
2128             getFileManager(), getPCHContainerReader(),
2129             getPreprocessor().getHeaderSearchInfo().getModuleCachePath())) {
2130       // FIXME this drops the error on the floor. This code is only used for
2131       // typo correction and drops more than just this one source of errors
2132       // (such as the directory creation failure above). It should handle the
2133       // error.
2134       consumeError(std::move(Err));
2135       return nullptr;
2136     }
2137     TheASTReader->resetForReload();
2138     TheASTReader->loadGlobalIndex();
2139     GlobalIndex = TheASTReader->getGlobalIndex();
2140   }
2141   // For finding modules needing to be imported for fixit messages,
2142   // we need to make the global index cover all modules, so we do that here.
2143   if (!HaveFullGlobalModuleIndex && GlobalIndex && !buildingModule()) {
2144     ModuleMap &MMap = getPreprocessor().getHeaderSearchInfo().getModuleMap();
2145     bool RecreateIndex = false;
2146     for (ModuleMap::module_iterator I = MMap.module_begin(),
2147         E = MMap.module_end(); I != E; ++I) {
2148       Module *TheModule = I->second;
2149       const FileEntry *Entry = TheModule->getASTFile();
2150       if (!Entry) {
2151         SmallVector<std::pair<IdentifierInfo *, SourceLocation>, 2> Path;
2152         Path.push_back(std::make_pair(
2153             getPreprocessor().getIdentifierInfo(TheModule->Name), TriggerLoc));
2154         std::reverse(Path.begin(), Path.end());
2155         // Load a module as hidden.  This also adds it to the global index.
2156         loadModule(TheModule->DefinitionLoc, Path, Module::Hidden, false);
2157         RecreateIndex = true;
2158       }
2159     }
2160     if (RecreateIndex) {
2161       if (llvm::Error Err = GlobalModuleIndex::writeIndex(
2162               getFileManager(), getPCHContainerReader(),
2163               getPreprocessor().getHeaderSearchInfo().getModuleCachePath())) {
2164         // FIXME As above, this drops the error on the floor.
2165         consumeError(std::move(Err));
2166         return nullptr;
2167       }
2168       TheASTReader->resetForReload();
2169       TheASTReader->loadGlobalIndex();
2170       GlobalIndex = TheASTReader->getGlobalIndex();
2171     }
2172     HaveFullGlobalModuleIndex = true;
2173   }
2174   return GlobalIndex;
2175 }
2176 
2177 // Check global module index for missing imports.
2178 bool
2179 CompilerInstance::lookupMissingImports(StringRef Name,
2180                                        SourceLocation TriggerLoc) {
2181   // Look for the symbol in non-imported modules, but only if an error
2182   // actually occurred.
2183   if (!buildingModule()) {
2184     // Load global module index, or retrieve a previously loaded one.
2185     GlobalModuleIndex *GlobalIndex = loadGlobalModuleIndex(
2186       TriggerLoc);
2187 
2188     // Only if we have a global index.
2189     if (GlobalIndex) {
2190       GlobalModuleIndex::HitSet FoundModules;
2191 
2192       // Find the modules that reference the identifier.
2193       // Note that this only finds top-level modules.
2194       // We'll let diagnoseTypo find the actual declaration module.
2195       if (GlobalIndex->lookupIdentifier(Name, FoundModules))
2196         return true;
2197     }
2198   }
2199 
2200   return false;
2201 }
2202 void CompilerInstance::resetAndLeakSema() { llvm::BuryPointer(takeSema()); }
2203 
2204 void CompilerInstance::setExternalSemaSource(
2205     IntrusiveRefCntPtr<ExternalSemaSource> ESS) {
2206   ExternalSemaSrc = std::move(ESS);
2207 }
2208