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