xref: /llvm-project/clang/lib/Frontend/CompilerInstance.cpp (revision 2fca3c2c87baef6d0bc481f8c9503b7f6a6e21f4)
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/Sema/Sema.h"
12 #include "clang/AST/ASTConsumer.h"
13 #include "clang/AST/ASTContext.h"
14 #include "clang/AST/Decl.h"
15 #include "clang/Basic/Diagnostic.h"
16 #include "clang/Basic/FileManager.h"
17 #include "clang/Basic/SourceManager.h"
18 #include "clang/Basic/TargetInfo.h"
19 #include "clang/Basic/Version.h"
20 #include "clang/Lex/HeaderSearch.h"
21 #include "clang/Lex/Preprocessor.h"
22 #include "clang/Lex/PTHManager.h"
23 #include "clang/Frontend/ChainedDiagnosticConsumer.h"
24 #include "clang/Frontend/FrontendAction.h"
25 #include "clang/Frontend/FrontendActions.h"
26 #include "clang/Frontend/FrontendDiagnostic.h"
27 #include "clang/Frontend/LogDiagnosticPrinter.h"
28 #include "clang/Frontend/SerializedDiagnosticPrinter.h"
29 #include "clang/Frontend/TextDiagnosticPrinter.h"
30 #include "clang/Frontend/VerifyDiagnosticConsumer.h"
31 #include "clang/Frontend/Utils.h"
32 #include "clang/Serialization/ASTReader.h"
33 #include "clang/Sema/CodeCompleteConsumer.h"
34 #include "llvm/Support/FileSystem.h"
35 #include "llvm/Support/MemoryBuffer.h"
36 #include "llvm/Support/raw_ostream.h"
37 #include "llvm/ADT/Statistic.h"
38 #include "llvm/Support/Timer.h"
39 #include "llvm/Support/Host.h"
40 #include "llvm/Support/LockFileManager.h"
41 #include "llvm/Support/Path.h"
42 #include "llvm/Support/Program.h"
43 #include "llvm/Support/Signals.h"
44 #include "llvm/Support/system_error.h"
45 #include "llvm/Support/CrashRecoveryContext.h"
46 #include "llvm/Config/config.h"
47 
48 using namespace clang;
49 
50 CompilerInstance::CompilerInstance()
51   : Invocation(new CompilerInvocation()), ModuleManager(0) {
52 }
53 
54 CompilerInstance::~CompilerInstance() {
55 }
56 
57 void CompilerInstance::setInvocation(CompilerInvocation *Value) {
58   Invocation = Value;
59 }
60 
61 void CompilerInstance::setDiagnostics(DiagnosticsEngine *Value) {
62   Diagnostics = Value;
63 }
64 
65 void CompilerInstance::setTarget(TargetInfo *Value) {
66   Target = Value;
67 }
68 
69 void CompilerInstance::setFileManager(FileManager *Value) {
70   FileMgr = Value;
71 }
72 
73 void CompilerInstance::setSourceManager(SourceManager *Value) {
74   SourceMgr = Value;
75 }
76 
77 void CompilerInstance::setPreprocessor(Preprocessor *Value) { PP = Value; }
78 
79 void CompilerInstance::setASTContext(ASTContext *Value) { Context = Value; }
80 
81 void CompilerInstance::setSema(Sema *S) {
82   TheSema.reset(S);
83 }
84 
85 void CompilerInstance::setASTConsumer(ASTConsumer *Value) {
86   Consumer.reset(Value);
87 }
88 
89 void CompilerInstance::setCodeCompletionConsumer(CodeCompleteConsumer *Value) {
90   CompletionConsumer.reset(Value);
91   getFrontendOpts().SkipFunctionBodies = Value != 0;
92 }
93 
94 // Diagnostics
95 static void SetUpBuildDumpLog(const DiagnosticOptions &DiagOpts,
96                               unsigned argc, const char* const *argv,
97                               DiagnosticsEngine &Diags) {
98   std::string ErrorInfo;
99   OwningPtr<raw_ostream> OS(
100     new llvm::raw_fd_ostream(DiagOpts.DumpBuildInformation.c_str(), ErrorInfo));
101   if (!ErrorInfo.empty()) {
102     Diags.Report(diag::err_fe_unable_to_open_logfile)
103                  << DiagOpts.DumpBuildInformation << ErrorInfo;
104     return;
105   }
106 
107   (*OS) << "clang -cc1 command line arguments: ";
108   for (unsigned i = 0; i != argc; ++i)
109     (*OS) << argv[i] << ' ';
110   (*OS) << '\n';
111 
112   // Chain in a diagnostic client which will log the diagnostics.
113   DiagnosticConsumer *Logger =
114     new TextDiagnosticPrinter(*OS.take(), DiagOpts, /*OwnsOutputStream=*/true);
115   Diags.setClient(new ChainedDiagnosticConsumer(Diags.takeClient(), Logger));
116 }
117 
118 static void SetUpDiagnosticLog(const DiagnosticOptions &DiagOpts,
119                                const CodeGenOptions *CodeGenOpts,
120                                DiagnosticsEngine &Diags) {
121   std::string ErrorInfo;
122   bool OwnsStream = false;
123   raw_ostream *OS = &llvm::errs();
124   if (DiagOpts.DiagnosticLogFile != "-") {
125     // Create the output stream.
126     llvm::raw_fd_ostream *FileOS(
127       new llvm::raw_fd_ostream(DiagOpts.DiagnosticLogFile.c_str(),
128                                ErrorInfo, llvm::raw_fd_ostream::F_Append));
129     if (!ErrorInfo.empty()) {
130       Diags.Report(diag::warn_fe_cc_log_diagnostics_failure)
131         << DiagOpts.DumpBuildInformation << ErrorInfo;
132     } else {
133       FileOS->SetUnbuffered();
134       FileOS->SetUseAtomicWrites(true);
135       OS = FileOS;
136       OwnsStream = true;
137     }
138   }
139 
140   // Chain in the diagnostic client which will log the diagnostics.
141   LogDiagnosticPrinter *Logger = new LogDiagnosticPrinter(*OS, DiagOpts,
142                                                           OwnsStream);
143   if (CodeGenOpts)
144     Logger->setDwarfDebugFlags(CodeGenOpts->DwarfDebugFlags);
145   Diags.setClient(new ChainedDiagnosticConsumer(Diags.takeClient(), Logger));
146 }
147 
148 static void SetupSerializedDiagnostics(const DiagnosticOptions &DiagOpts,
149                                        DiagnosticsEngine &Diags,
150                                        StringRef OutputFile) {
151   std::string ErrorInfo;
152   OwningPtr<llvm::raw_fd_ostream> OS;
153   OS.reset(new llvm::raw_fd_ostream(OutputFile.str().c_str(), ErrorInfo,
154                                     llvm::raw_fd_ostream::F_Binary));
155 
156   if (!ErrorInfo.empty()) {
157     Diags.Report(diag::warn_fe_serialized_diag_failure)
158       << OutputFile << ErrorInfo;
159     return;
160   }
161 
162   DiagnosticConsumer *SerializedConsumer =
163     clang::serialized_diags::create(OS.take(), DiagOpts);
164 
165 
166   Diags.setClient(new ChainedDiagnosticConsumer(Diags.takeClient(),
167                                                 SerializedConsumer));
168 }
169 
170 void CompilerInstance::createDiagnostics(int Argc, const char* const *Argv,
171                                          DiagnosticConsumer *Client,
172                                          bool ShouldOwnClient,
173                                          bool ShouldCloneClient) {
174   Diagnostics = createDiagnostics(getDiagnosticOpts(), Argc, Argv, Client,
175                                   ShouldOwnClient, ShouldCloneClient,
176                                   &getCodeGenOpts());
177 }
178 
179 IntrusiveRefCntPtr<DiagnosticsEngine>
180 CompilerInstance::createDiagnostics(const DiagnosticOptions &Opts,
181                                     int Argc, const char* const *Argv,
182                                     DiagnosticConsumer *Client,
183                                     bool ShouldOwnClient,
184                                     bool ShouldCloneClient,
185                                     const CodeGenOptions *CodeGenOpts) {
186   IntrusiveRefCntPtr<DiagnosticIDs> DiagID(new DiagnosticIDs());
187   IntrusiveRefCntPtr<DiagnosticsEngine>
188       Diags(new DiagnosticsEngine(DiagID));
189 
190   // Create the diagnostic client for reporting errors or for
191   // implementing -verify.
192   if (Client) {
193     if (ShouldCloneClient)
194       Diags->setClient(Client->clone(*Diags), ShouldOwnClient);
195     else
196       Diags->setClient(Client, ShouldOwnClient);
197   } else
198     Diags->setClient(new TextDiagnosticPrinter(llvm::errs(), Opts));
199 
200   // Chain in -verify checker, if requested.
201   if (Opts.VerifyDiagnostics)
202     Diags->setClient(new VerifyDiagnosticConsumer(*Diags));
203 
204   // Chain in -diagnostic-log-file dumper, if requested.
205   if (!Opts.DiagnosticLogFile.empty())
206     SetUpDiagnosticLog(Opts, CodeGenOpts, *Diags);
207 
208   if (!Opts.DumpBuildInformation.empty())
209     SetUpBuildDumpLog(Opts, Argc, Argv, *Diags);
210 
211   if (!Opts.DiagnosticSerializationFile.empty())
212     SetupSerializedDiagnostics(Opts, *Diags,
213                                Opts.DiagnosticSerializationFile);
214 
215   // Configure our handling of diagnostics.
216   ProcessWarningOptions(*Diags, Opts);
217 
218   return Diags;
219 }
220 
221 // File Manager
222 
223 void CompilerInstance::createFileManager() {
224   FileMgr = new FileManager(getFileSystemOpts());
225 }
226 
227 // Source Manager
228 
229 void CompilerInstance::createSourceManager(FileManager &FileMgr) {
230   SourceMgr = new SourceManager(getDiagnostics(), FileMgr);
231 }
232 
233 // Preprocessor
234 
235 void CompilerInstance::createPreprocessor() {
236   const PreprocessorOptions &PPOpts = getPreprocessorOpts();
237 
238   // Create a PTH manager if we are using some form of a token cache.
239   PTHManager *PTHMgr = 0;
240   if (!PPOpts.TokenCache.empty())
241     PTHMgr = PTHManager::Create(PPOpts.TokenCache, getDiagnostics());
242 
243   // Create the Preprocessor.
244   HeaderSearch *HeaderInfo = new HeaderSearch(getFileManager(),
245                                               getDiagnostics(),
246                                               getLangOpts(),
247                                               &getTarget());
248   PP = new Preprocessor(getDiagnostics(), getLangOpts(), &getTarget(),
249                         getSourceManager(), *HeaderInfo, *this, PTHMgr,
250                         /*OwnsHeaderSearch=*/true);
251 
252   // Note that this is different then passing PTHMgr to Preprocessor's ctor.
253   // That argument is used as the IdentifierInfoLookup argument to
254   // IdentifierTable's ctor.
255   if (PTHMgr) {
256     PTHMgr->setPreprocessor(&*PP);
257     PP->setPTHManager(PTHMgr);
258   }
259 
260   if (PPOpts.DetailedRecord)
261     PP->createPreprocessingRecord(PPOpts.DetailedRecordConditionalDirectives);
262 
263   InitializePreprocessor(*PP, PPOpts, getHeaderSearchOpts(), getFrontendOpts());
264 
265   // Set up the module path, including the hash for the
266   // module-creation options.
267   SmallString<256> SpecificModuleCache(
268                            getHeaderSearchOpts().ModuleCachePath);
269   if (!getHeaderSearchOpts().DisableModuleHash)
270     llvm::sys::path::append(SpecificModuleCache,
271                             getInvocation().getModuleHash());
272   PP->getHeaderSearchInfo().setModuleCachePath(SpecificModuleCache);
273 
274   // Handle generating dependencies, if requested.
275   const DependencyOutputOptions &DepOpts = getDependencyOutputOpts();
276   if (!DepOpts.OutputFile.empty())
277     AttachDependencyFileGen(*PP, DepOpts);
278   if (!DepOpts.DOTOutputFile.empty())
279     AttachDependencyGraphGen(*PP, DepOpts.DOTOutputFile,
280                              getHeaderSearchOpts().Sysroot);
281 
282 
283   // Handle generating header include information, if requested.
284   if (DepOpts.ShowHeaderIncludes)
285     AttachHeaderIncludeGen(*PP);
286   if (!DepOpts.HeaderIncludeOutputFile.empty()) {
287     StringRef OutputPath = DepOpts.HeaderIncludeOutputFile;
288     if (OutputPath == "-")
289       OutputPath = "";
290     AttachHeaderIncludeGen(*PP, /*ShowAllHeaders=*/true, OutputPath,
291                            /*ShowDepth=*/false);
292   }
293 }
294 
295 // ASTContext
296 
297 void CompilerInstance::createASTContext() {
298   Preprocessor &PP = getPreprocessor();
299   Context = new ASTContext(getLangOpts(), PP.getSourceManager(),
300                            &getTarget(), PP.getIdentifierTable(),
301                            PP.getSelectorTable(), PP.getBuiltinInfo(),
302                            /*size_reserve=*/ 0);
303 }
304 
305 // ExternalASTSource
306 
307 void CompilerInstance::createPCHExternalASTSource(StringRef Path,
308                                                   bool DisablePCHValidation,
309                                                   bool DisableStatCache,
310                                                 bool AllowPCHWithCompilerErrors,
311                                                  void *DeserializationListener){
312   OwningPtr<ExternalASTSource> Source;
313   bool Preamble = getPreprocessorOpts().PrecompiledPreambleBytes.first != 0;
314   Source.reset(createPCHExternalASTSource(Path, getHeaderSearchOpts().Sysroot,
315                                           DisablePCHValidation,
316                                           DisableStatCache,
317                                           AllowPCHWithCompilerErrors,
318                                           getPreprocessor(), getASTContext(),
319                                           DeserializationListener,
320                                           Preamble));
321   ModuleManager = static_cast<ASTReader*>(Source.get());
322   getASTContext().setExternalSource(Source);
323 }
324 
325 ExternalASTSource *
326 CompilerInstance::createPCHExternalASTSource(StringRef Path,
327                                              const std::string &Sysroot,
328                                              bool DisablePCHValidation,
329                                              bool DisableStatCache,
330                                              bool AllowPCHWithCompilerErrors,
331                                              Preprocessor &PP,
332                                              ASTContext &Context,
333                                              void *DeserializationListener,
334                                              bool Preamble) {
335   OwningPtr<ASTReader> Reader;
336   Reader.reset(new ASTReader(PP, Context,
337                              Sysroot.empty() ? "" : Sysroot.c_str(),
338                              DisablePCHValidation, DisableStatCache,
339                              AllowPCHWithCompilerErrors));
340 
341   Reader->setDeserializationListener(
342             static_cast<ASTDeserializationListener *>(DeserializationListener));
343   switch (Reader->ReadAST(Path,
344                           Preamble ? serialization::MK_Preamble
345                                    : serialization::MK_PCH)) {
346   case ASTReader::Success:
347     // Set the predefines buffer as suggested by the PCH reader. Typically, the
348     // predefines buffer will be empty.
349     PP.setPredefines(Reader->getSuggestedPredefines());
350     return Reader.take();
351 
352   case ASTReader::Failure:
353     // Unrecoverable failure: don't even try to process the input file.
354     break;
355 
356   case ASTReader::IgnorePCH:
357     // No suitable PCH file could be found. Return an error.
358     break;
359   }
360 
361   return 0;
362 }
363 
364 // Code Completion
365 
366 static bool EnableCodeCompletion(Preprocessor &PP,
367                                  const std::string &Filename,
368                                  unsigned Line,
369                                  unsigned Column) {
370   // Tell the source manager to chop off the given file at a specific
371   // line and column.
372   const FileEntry *Entry = PP.getFileManager().getFile(Filename);
373   if (!Entry) {
374     PP.getDiagnostics().Report(diag::err_fe_invalid_code_complete_file)
375       << Filename;
376     return true;
377   }
378 
379   // Truncate the named file at the given line/column.
380   PP.SetCodeCompletionPoint(Entry, Line, Column);
381   return false;
382 }
383 
384 void CompilerInstance::createCodeCompletionConsumer() {
385   const ParsedSourceLocation &Loc = getFrontendOpts().CodeCompletionAt;
386   if (!CompletionConsumer) {
387     setCodeCompletionConsumer(
388       createCodeCompletionConsumer(getPreprocessor(),
389                                    Loc.FileName, Loc.Line, Loc.Column,
390                                    getFrontendOpts().ShowMacrosInCodeCompletion,
391                              getFrontendOpts().ShowCodePatternsInCodeCompletion,
392                            getFrontendOpts().ShowGlobalSymbolsInCodeCompletion,
393                                    llvm::outs()));
394     if (!CompletionConsumer)
395       return;
396   } else if (EnableCodeCompletion(getPreprocessor(), Loc.FileName,
397                                   Loc.Line, Loc.Column)) {
398     setCodeCompletionConsumer(0);
399     return;
400   }
401 
402   if (CompletionConsumer->isOutputBinary() &&
403       llvm::sys::Program::ChangeStdoutToBinary()) {
404     getPreprocessor().getDiagnostics().Report(diag::err_fe_stdout_binary);
405     setCodeCompletionConsumer(0);
406   }
407 }
408 
409 void CompilerInstance::createFrontendTimer() {
410   FrontendTimer.reset(new llvm::Timer("Clang front-end timer"));
411 }
412 
413 CodeCompleteConsumer *
414 CompilerInstance::createCodeCompletionConsumer(Preprocessor &PP,
415                                                const std::string &Filename,
416                                                unsigned Line,
417                                                unsigned Column,
418                                                bool ShowMacros,
419                                                bool ShowCodePatterns,
420                                                bool ShowGlobals,
421                                                raw_ostream &OS) {
422   if (EnableCodeCompletion(PP, Filename, Line, Column))
423     return 0;
424 
425   // Set up the creation routine for code-completion.
426   return new PrintingCodeCompleteConsumer(ShowMacros, ShowCodePatterns,
427                                           ShowGlobals, OS);
428 }
429 
430 void CompilerInstance::createSema(TranslationUnitKind TUKind,
431                                   CodeCompleteConsumer *CompletionConsumer) {
432   TheSema.reset(new Sema(getPreprocessor(), getASTContext(), getASTConsumer(),
433                          TUKind, CompletionConsumer));
434 }
435 
436 // Output Files
437 
438 void CompilerInstance::addOutputFile(const OutputFile &OutFile) {
439   assert(OutFile.OS && "Attempt to add empty stream to output list!");
440   OutputFiles.push_back(OutFile);
441 }
442 
443 void CompilerInstance::clearOutputFiles(bool EraseFiles) {
444   for (std::list<OutputFile>::iterator
445          it = OutputFiles.begin(), ie = OutputFiles.end(); it != ie; ++it) {
446     delete it->OS;
447     if (!it->TempFilename.empty()) {
448       if (EraseFiles) {
449         bool existed;
450         llvm::sys::fs::remove(it->TempFilename, existed);
451       } else {
452         SmallString<128> NewOutFile(it->Filename);
453 
454         // If '-working-directory' was passed, the output filename should be
455         // relative to that.
456         FileMgr->FixupRelativePath(NewOutFile);
457         if (llvm::error_code ec = llvm::sys::fs::rename(it->TempFilename,
458                                                         NewOutFile.str())) {
459           getDiagnostics().Report(diag::err_fe_unable_to_rename_temp)
460             << it->TempFilename << it->Filename << ec.message();
461 
462           bool existed;
463           llvm::sys::fs::remove(it->TempFilename, existed);
464         }
465       }
466     } else if (!it->Filename.empty() && EraseFiles)
467       llvm::sys::Path(it->Filename).eraseFromDisk();
468 
469   }
470   OutputFiles.clear();
471 }
472 
473 llvm::raw_fd_ostream *
474 CompilerInstance::createDefaultOutputFile(bool Binary,
475                                           StringRef InFile,
476                                           StringRef Extension) {
477   return createOutputFile(getFrontendOpts().OutputFile, Binary,
478                           /*RemoveFileOnSignal=*/true, InFile, Extension,
479                           /*UseTemporary=*/true);
480 }
481 
482 llvm::raw_fd_ostream *
483 CompilerInstance::createOutputFile(StringRef OutputPath,
484                                    bool Binary, bool RemoveFileOnSignal,
485                                    StringRef InFile,
486                                    StringRef Extension,
487                                    bool UseTemporary,
488                                    bool CreateMissingDirectories) {
489   std::string Error, OutputPathName, TempPathName;
490   llvm::raw_fd_ostream *OS = createOutputFile(OutputPath, Error, Binary,
491                                               RemoveFileOnSignal,
492                                               InFile, Extension,
493                                               UseTemporary,
494                                               CreateMissingDirectories,
495                                               &OutputPathName,
496                                               &TempPathName);
497   if (!OS) {
498     getDiagnostics().Report(diag::err_fe_unable_to_open_output)
499       << OutputPath << Error;
500     return 0;
501   }
502 
503   // Add the output file -- but don't try to remove "-", since this means we are
504   // using stdin.
505   addOutputFile(OutputFile((OutputPathName != "-") ? OutputPathName : "",
506                 TempPathName, OS));
507 
508   return OS;
509 }
510 
511 llvm::raw_fd_ostream *
512 CompilerInstance::createOutputFile(StringRef OutputPath,
513                                    std::string &Error,
514                                    bool Binary,
515                                    bool RemoveFileOnSignal,
516                                    StringRef InFile,
517                                    StringRef Extension,
518                                    bool UseTemporary,
519                                    bool CreateMissingDirectories,
520                                    std::string *ResultPathName,
521                                    std::string *TempPathName) {
522   assert((!CreateMissingDirectories || UseTemporary) &&
523          "CreateMissingDirectories is only allowed when using temporary files");
524 
525   std::string OutFile, TempFile;
526   if (!OutputPath.empty()) {
527     OutFile = OutputPath;
528   } else if (InFile == "-") {
529     OutFile = "-";
530   } else if (!Extension.empty()) {
531     llvm::sys::Path Path(InFile);
532     Path.eraseSuffix();
533     Path.appendSuffix(Extension);
534     OutFile = Path.str();
535   } else {
536     OutFile = "-";
537   }
538 
539   OwningPtr<llvm::raw_fd_ostream> OS;
540   std::string OSFile;
541 
542   if (UseTemporary && OutFile != "-") {
543     // Only create the temporary if the parent directory exists (or create
544     // missing directories is true) and we can actually write to OutPath,
545     // otherwise we want to fail early.
546     SmallString<256> AbsPath(OutputPath);
547     llvm::sys::fs::make_absolute(AbsPath);
548     llvm::sys::Path OutPath(AbsPath);
549     bool ParentExists = false;
550     if (llvm::sys::fs::exists(llvm::sys::path::parent_path(AbsPath.str()),
551                               ParentExists))
552       ParentExists = false;
553     bool Exists;
554     if ((CreateMissingDirectories || ParentExists) &&
555         ((llvm::sys::fs::exists(AbsPath.str(), Exists) || !Exists) ||
556          (OutPath.isRegularFile() && OutPath.canWrite()))) {
557       // Create a temporary file.
558       SmallString<128> TempPath;
559       TempPath = OutFile;
560       TempPath += "-%%%%%%%%";
561       int fd;
562       if (llvm::sys::fs::unique_file(TempPath.str(), fd, TempPath,
563                                /*makeAbsolute=*/false) == llvm::errc::success) {
564         OS.reset(new llvm::raw_fd_ostream(fd, /*shouldClose=*/true));
565         OSFile = TempFile = TempPath.str();
566       }
567     }
568   }
569 
570   if (!OS) {
571     OSFile = OutFile;
572     OS.reset(
573       new llvm::raw_fd_ostream(OSFile.c_str(), Error,
574                                (Binary ? llvm::raw_fd_ostream::F_Binary : 0)));
575     if (!Error.empty())
576       return 0;
577   }
578 
579   // Make sure the out stream file gets removed if we crash.
580   if (RemoveFileOnSignal)
581     llvm::sys::RemoveFileOnSignal(llvm::sys::Path(OSFile));
582 
583   if (ResultPathName)
584     *ResultPathName = OutFile;
585   if (TempPathName)
586     *TempPathName = TempFile;
587 
588   return OS.take();
589 }
590 
591 // Initialization Utilities
592 
593 bool CompilerInstance::InitializeSourceManager(StringRef InputFile,
594                                                SrcMgr::CharacteristicKind Kind){
595   return InitializeSourceManager(InputFile, Kind, getDiagnostics(),
596                                  getFileManager(), getSourceManager(),
597                                  getFrontendOpts());
598 }
599 
600 bool CompilerInstance::InitializeSourceManager(StringRef InputFile,
601                                                SrcMgr::CharacteristicKind Kind,
602                                                DiagnosticsEngine &Diags,
603                                                FileManager &FileMgr,
604                                                SourceManager &SourceMgr,
605                                                const FrontendOptions &Opts) {
606   // Figure out where to get and map in the main file.
607   if (InputFile != "-") {
608     const FileEntry *File = FileMgr.getFile(InputFile);
609     if (!File) {
610       Diags.Report(diag::err_fe_error_reading) << InputFile;
611       return false;
612     }
613     SourceMgr.createMainFileID(File, Kind);
614   } else {
615     OwningPtr<llvm::MemoryBuffer> SB;
616     if (llvm::MemoryBuffer::getSTDIN(SB)) {
617       // FIXME: Give ec.message() in this diag.
618       Diags.Report(diag::err_fe_error_reading_stdin);
619       return false;
620     }
621     const FileEntry *File = FileMgr.getVirtualFile(SB->getBufferIdentifier(),
622                                                    SB->getBufferSize(), 0);
623     SourceMgr.createMainFileID(File, Kind);
624     SourceMgr.overrideFileContents(File, SB.take());
625   }
626 
627   assert(!SourceMgr.getMainFileID().isInvalid() &&
628          "Couldn't establish MainFileID!");
629   return true;
630 }
631 
632 // High-Level Operations
633 
634 bool CompilerInstance::ExecuteAction(FrontendAction &Act) {
635   assert(hasDiagnostics() && "Diagnostics engine is not initialized!");
636   assert(!getFrontendOpts().ShowHelp && "Client must handle '-help'!");
637   assert(!getFrontendOpts().ShowVersion && "Client must handle '-version'!");
638 
639   // FIXME: Take this as an argument, once all the APIs we used have moved to
640   // taking it as an input instead of hard-coding llvm::errs.
641   raw_ostream &OS = llvm::errs();
642 
643   // Create the target instance.
644   setTarget(TargetInfo::CreateTargetInfo(getDiagnostics(), getTargetOpts()));
645   if (!hasTarget())
646     return false;
647 
648   // Inform the target of the language options.
649   //
650   // FIXME: We shouldn't need to do this, the target should be immutable once
651   // created. This complexity should be lifted elsewhere.
652   getTarget().setForcedLangOptions(getLangOpts());
653 
654   // Validate/process some options.
655   if (getHeaderSearchOpts().Verbose)
656     OS << "clang -cc1 version " CLANG_VERSION_STRING
657        << " based upon " << PACKAGE_STRING
658        << " default target " << llvm::sys::getDefaultTargetTriple() << "\n";
659 
660   if (getFrontendOpts().ShowTimers)
661     createFrontendTimer();
662 
663   if (getFrontendOpts().ShowStats)
664     llvm::EnableStatistics();
665 
666   for (unsigned i = 0, e = getFrontendOpts().Inputs.size(); i != e; ++i) {
667     // Reset the ID tables if we are reusing the SourceManager.
668     if (hasSourceManager())
669       getSourceManager().clearIDTables();
670 
671     if (Act.BeginSourceFile(*this, getFrontendOpts().Inputs[i])) {
672       Act.Execute();
673       Act.EndSourceFile();
674     }
675   }
676 
677   // Notify the diagnostic client that all files were processed.
678   getDiagnostics().getClient()->finish();
679 
680   if (getDiagnosticOpts().ShowCarets) {
681     // We can have multiple diagnostics sharing one diagnostic client.
682     // Get the total number of warnings/errors from the client.
683     unsigned NumWarnings = getDiagnostics().getClient()->getNumWarnings();
684     unsigned NumErrors = getDiagnostics().getClient()->getNumErrors();
685 
686     if (NumWarnings)
687       OS << NumWarnings << " warning" << (NumWarnings == 1 ? "" : "s");
688     if (NumWarnings && NumErrors)
689       OS << " and ";
690     if (NumErrors)
691       OS << NumErrors << " error" << (NumErrors == 1 ? "" : "s");
692     if (NumWarnings || NumErrors)
693       OS << " generated.\n";
694   }
695 
696   if (getFrontendOpts().ShowStats && hasFileManager()) {
697     getFileManager().PrintStats();
698     OS << "\n";
699   }
700 
701   return !getDiagnostics().getClient()->getNumErrors();
702 }
703 
704 /// \brief Determine the appropriate source input kind based on language
705 /// options.
706 static InputKind getSourceInputKindFromOptions(const LangOptions &LangOpts) {
707   if (LangOpts.OpenCL)
708     return IK_OpenCL;
709   if (LangOpts.CUDA)
710     return IK_CUDA;
711   if (LangOpts.ObjC1)
712     return LangOpts.CPlusPlus? IK_ObjCXX : IK_ObjC;
713   return LangOpts.CPlusPlus? IK_CXX : IK_C;
714 }
715 
716 namespace {
717   struct CompileModuleMapData {
718     CompilerInstance &Instance;
719     GenerateModuleAction &CreateModuleAction;
720   };
721 }
722 
723 /// \brief Helper function that executes the module-generating action under
724 /// a crash recovery context.
725 static void doCompileMapModule(void *UserData) {
726   CompileModuleMapData &Data
727     = *reinterpret_cast<CompileModuleMapData *>(UserData);
728   Data.Instance.ExecuteAction(Data.CreateModuleAction);
729 }
730 
731 /// \brief Compile a module file for the given module, using the options
732 /// provided by the importing compiler instance.
733 static void compileModule(CompilerInstance &ImportingInstance,
734                           Module *Module,
735                           StringRef ModuleFileName) {
736   llvm::LockFileManager Locked(ModuleFileName);
737   switch (Locked) {
738   case llvm::LockFileManager::LFS_Error:
739     return;
740 
741   case llvm::LockFileManager::LFS_Owned:
742     // We're responsible for building the module ourselves. Do so below.
743     break;
744 
745   case llvm::LockFileManager::LFS_Shared:
746     // Someone else is responsible for building the module. Wait for them to
747     // finish.
748     Locked.waitForUnlock();
749     break;
750   }
751 
752   ModuleMap &ModMap
753     = ImportingInstance.getPreprocessor().getHeaderSearchInfo().getModuleMap();
754 
755   // Construct a compiler invocation for creating this module.
756   IntrusiveRefCntPtr<CompilerInvocation> Invocation
757     (new CompilerInvocation(ImportingInstance.getInvocation()));
758 
759   PreprocessorOptions &PPOpts = Invocation->getPreprocessorOpts();
760 
761   // For any options that aren't intended to affect how a module is built,
762   // reset them to their default values.
763   Invocation->getLangOpts()->resetNonModularOptions();
764   PPOpts.resetNonModularOptions();
765 
766   // Note the name of the module we're building.
767   Invocation->getLangOpts()->CurrentModule = Module->getTopLevelModuleName();
768 
769   // Note that this module is part of the module build path, so that we
770   // can detect cycles in the module graph.
771   PPOpts.ModuleBuildPath.push_back(Module->getTopLevelModuleName());
772 
773   // If there is a module map file, build the module using the module map.
774   // Set up the inputs/outputs so that we build the module from its umbrella
775   // header.
776   FrontendOptions &FrontendOpts = Invocation->getFrontendOpts();
777   FrontendOpts.OutputFile = ModuleFileName.str();
778   FrontendOpts.DisableFree = false;
779   FrontendOpts.Inputs.clear();
780   InputKind IK = getSourceInputKindFromOptions(*Invocation->getLangOpts());
781 
782   // Get or create the module map that we'll use to build this module.
783   SmallString<128> TempModuleMapFileName;
784   if (const FileEntry *ModuleMapFile
785                                   = ModMap.getContainingModuleMapFile(Module)) {
786     // Use the module map where this module resides.
787     FrontendOpts.Inputs.push_back(FrontendInputFile(ModuleMapFile->getName(),
788                                                     IK));
789   } else {
790     // Create a temporary module map file.
791     TempModuleMapFileName = Module->Name;
792     TempModuleMapFileName += "-%%%%%%%%.map";
793     int FD;
794     if (llvm::sys::fs::unique_file(TempModuleMapFileName.str(), FD,
795                                    TempModuleMapFileName,
796                                    /*makeAbsolute=*/true)
797           != llvm::errc::success) {
798       ImportingInstance.getDiagnostics().Report(diag::err_module_map_temp_file)
799         << TempModuleMapFileName;
800       return;
801     }
802     // Print the module map to this file.
803     llvm::raw_fd_ostream OS(FD, /*shouldClose=*/true);
804     Module->print(OS);
805     FrontendOpts.Inputs.push_back(
806       FrontendInputFile(TempModuleMapFileName.str().str(), IK));
807   }
808 
809   // Don't free the remapped file buffers; they are owned by our caller.
810   PPOpts.RetainRemappedFileBuffers = true;
811 
812   Invocation->getDiagnosticOpts().VerifyDiagnostics = 0;
813   assert(ImportingInstance.getInvocation().getModuleHash() ==
814          Invocation->getModuleHash() && "Module hash mismatch!");
815 
816   // Construct a compiler instance that will be used to actually create the
817   // module.
818   CompilerInstance Instance;
819   Instance.setInvocation(&*Invocation);
820   Instance.createDiagnostics(/*argc=*/0, /*argv=*/0,
821                              &ImportingInstance.getDiagnosticClient(),
822                              /*ShouldOwnClient=*/true,
823                              /*ShouldCloneClient=*/true);
824 
825   // Construct a module-generating action.
826   GenerateModuleAction CreateModuleAction;
827 
828   // Execute the action to actually build the module in-place. Use a separate
829   // thread so that we get a stack large enough.
830   const unsigned ThreadStackSize = 8 << 20;
831   llvm::CrashRecoveryContext CRC;
832   CompileModuleMapData Data = { Instance, CreateModuleAction };
833   CRC.RunSafelyOnThread(&doCompileMapModule, &Data, ThreadStackSize);
834 
835   // Delete the temporary module map file.
836   // FIXME: Even though we're executing under crash protection, it would still
837   // be nice to do this with RemoveFileOnSignal when we can. However, that
838   // doesn't make sense for all clients, so clean this up manually.
839   if (!TempModuleMapFileName.empty())
840     llvm::sys::Path(TempModuleMapFileName).eraseFromDisk();
841 }
842 
843 Module *CompilerInstance::loadModule(SourceLocation ImportLoc,
844                                      ModuleIdPath Path,
845                                      Module::NameVisibilityKind Visibility,
846                                      bool IsInclusionDirective) {
847   // If we've already handled this import, just return the cached result.
848   // This one-element cache is important to eliminate redundant diagnostics
849   // when both the preprocessor and parser see the same import declaration.
850   if (!ImportLoc.isInvalid() && LastModuleImportLoc == ImportLoc) {
851     // Make the named module visible.
852     if (LastModuleImportResult)
853       ModuleManager->makeModuleVisible(LastModuleImportResult, Visibility);
854     return LastModuleImportResult;
855   }
856 
857   // Determine what file we're searching from.
858   SourceManager &SourceMgr = getSourceManager();
859   SourceLocation ExpandedImportLoc = SourceMgr.getExpansionLoc(ImportLoc);
860   const FileEntry *CurFile
861     = SourceMgr.getFileEntryForID(SourceMgr.getFileID(ExpandedImportLoc));
862   if (!CurFile)
863     CurFile = SourceMgr.getFileEntryForID(SourceMgr.getMainFileID());
864 
865   StringRef ModuleName = Path[0].first->getName();
866   SourceLocation ModuleNameLoc = Path[0].second;
867 
868   clang::Module *Module = 0;
869 
870   // If we don't already have information on this module, load the module now.
871   llvm::DenseMap<const IdentifierInfo *, clang::Module *>::iterator Known
872     = KnownModules.find(Path[0].first);
873   if (Known != KnownModules.end()) {
874     // Retrieve the cached top-level module.
875     Module = Known->second;
876   } else if (ModuleName == getLangOpts().CurrentModule) {
877     // This is the module we're building.
878     Module = PP->getHeaderSearchInfo().getModuleMap().findModule(ModuleName);
879     Known = KnownModules.insert(std::make_pair(Path[0].first, Module)).first;
880   } else {
881     // Search for a module with the given name.
882     Module = PP->getHeaderSearchInfo().lookupModule(ModuleName);
883     std::string ModuleFileName;
884     if (Module)
885       ModuleFileName = PP->getHeaderSearchInfo().getModuleFileName(Module);
886     else
887       ModuleFileName = PP->getHeaderSearchInfo().getModuleFileName(ModuleName);
888 
889     if (ModuleFileName.empty()) {
890       getDiagnostics().Report(ModuleNameLoc, diag::err_module_not_found)
891         << ModuleName
892         << SourceRange(ImportLoc, ModuleNameLoc);
893       LastModuleImportLoc = ImportLoc;
894       LastModuleImportResult = 0;
895       return 0;
896     }
897 
898     const FileEntry *ModuleFile
899       = getFileManager().getFile(ModuleFileName, /*OpenFile=*/false,
900                                  /*CacheFailure=*/false);
901     bool BuildingModule = false;
902     if (!ModuleFile && Module) {
903       // The module is not cached, but we have a module map from which we can
904       // build the module.
905 
906       // Check whether there is a cycle in the module graph.
907       SmallVectorImpl<std::string> &ModuleBuildPath
908         = getPreprocessorOpts().ModuleBuildPath;
909       SmallVectorImpl<std::string>::iterator Pos
910         = std::find(ModuleBuildPath.begin(), ModuleBuildPath.end(), ModuleName);
911       if (Pos != ModuleBuildPath.end()) {
912         SmallString<256> CyclePath;
913         for (; Pos != ModuleBuildPath.end(); ++Pos) {
914           CyclePath += *Pos;
915           CyclePath += " -> ";
916         }
917         CyclePath += ModuleName;
918 
919         getDiagnostics().Report(ModuleNameLoc, diag::err_module_cycle)
920           << ModuleName << CyclePath;
921         return 0;
922       }
923 
924       getDiagnostics().Report(ModuleNameLoc, diag::warn_module_build)
925         << ModuleName;
926       BuildingModule = true;
927       compileModule(*this, Module, ModuleFileName);
928       ModuleFile = FileMgr->getFile(ModuleFileName);
929     }
930 
931     if (!ModuleFile) {
932       getDiagnostics().Report(ModuleNameLoc,
933                               BuildingModule? diag::err_module_not_built
934                                             : diag::err_module_not_found)
935         << ModuleName
936         << SourceRange(ImportLoc, ModuleNameLoc);
937       return 0;
938     }
939 
940     // If we don't already have an ASTReader, create one now.
941     if (!ModuleManager) {
942       if (!hasASTContext())
943         createASTContext();
944 
945       std::string Sysroot = getHeaderSearchOpts().Sysroot;
946       const PreprocessorOptions &PPOpts = getPreprocessorOpts();
947       ModuleManager = new ASTReader(getPreprocessor(), *Context,
948                                     Sysroot.empty() ? "" : Sysroot.c_str(),
949                                     PPOpts.DisablePCHValidation,
950                                     PPOpts.DisableStatCache);
951       if (hasASTConsumer()) {
952         ModuleManager->setDeserializationListener(
953           getASTConsumer().GetASTDeserializationListener());
954         getASTContext().setASTMutationListener(
955           getASTConsumer().GetASTMutationListener());
956       }
957       OwningPtr<ExternalASTSource> Source;
958       Source.reset(ModuleManager);
959       getASTContext().setExternalSource(Source);
960       if (hasSema())
961         ModuleManager->InitializeSema(getSema());
962       if (hasASTConsumer())
963         ModuleManager->StartTranslationUnit(&getASTConsumer());
964     }
965 
966     // Try to load the module we found.
967     switch (ModuleManager->ReadAST(ModuleFile->getName(),
968                                    serialization::MK_Module)) {
969     case ASTReader::Success:
970       break;
971 
972     case ASTReader::IgnorePCH:
973       // FIXME: The ASTReader will already have complained, but can we showhorn
974       // that diagnostic information into a more useful form?
975       KnownModules[Path[0].first] = 0;
976       return 0;
977 
978     case ASTReader::Failure:
979       // Already complained, but note now that we failed.
980       KnownModules[Path[0].first] = 0;
981       return 0;
982     }
983 
984     if (!Module) {
985       // If we loaded the module directly, without finding a module map first,
986       // we'll have loaded the module's information from the module itself.
987       Module = PP->getHeaderSearchInfo().getModuleMap()
988                  .findModule((Path[0].first->getName()));
989     }
990 
991     // Cache the result of this top-level module lookup for later.
992     Known = KnownModules.insert(std::make_pair(Path[0].first, Module)).first;
993   }
994 
995   // If we never found the module, fail.
996   if (!Module)
997     return 0;
998 
999   // Verify that the rest of the module path actually corresponds to
1000   // a submodule.
1001   if (Path.size() > 1) {
1002     for (unsigned I = 1, N = Path.size(); I != N; ++I) {
1003       StringRef Name = Path[I].first->getName();
1004       clang::Module *Sub = Module->findSubmodule(Name);
1005 
1006       if (!Sub) {
1007         // Attempt to perform typo correction to find a module name that works.
1008         llvm::SmallVector<StringRef, 2> Best;
1009         unsigned BestEditDistance = (std::numeric_limits<unsigned>::max)();
1010 
1011         for (clang::Module::submodule_iterator J = Module->submodule_begin(),
1012                                             JEnd = Module->submodule_end();
1013              J != JEnd; ++J) {
1014           unsigned ED = Name.edit_distance((*J)->Name,
1015                                            /*AllowReplacements=*/true,
1016                                            BestEditDistance);
1017           if (ED <= BestEditDistance) {
1018             if (ED < BestEditDistance) {
1019               Best.clear();
1020               BestEditDistance = ED;
1021             }
1022 
1023             Best.push_back((*J)->Name);
1024           }
1025         }
1026 
1027         // If there was a clear winner, user it.
1028         if (Best.size() == 1) {
1029           getDiagnostics().Report(Path[I].second,
1030                                   diag::err_no_submodule_suggest)
1031             << Path[I].first << Module->getFullModuleName() << Best[0]
1032             << SourceRange(Path[0].second, Path[I-1].second)
1033             << FixItHint::CreateReplacement(SourceRange(Path[I].second),
1034                                             Best[0]);
1035 
1036           Sub = Module->findSubmodule(Best[0]);
1037         }
1038       }
1039 
1040       if (!Sub) {
1041         // No submodule by this name. Complain, and don't look for further
1042         // submodules.
1043         getDiagnostics().Report(Path[I].second, diag::err_no_submodule)
1044           << Path[I].first << Module->getFullModuleName()
1045           << SourceRange(Path[0].second, Path[I-1].second);
1046         break;
1047       }
1048 
1049       Module = Sub;
1050     }
1051   }
1052 
1053   // Make the named module visible, if it's not already part of the module
1054   // we are parsing.
1055   if (ModuleName != getLangOpts().CurrentModule) {
1056     if (!Module->IsFromModuleFile) {
1057       // We have an umbrella header or directory that doesn't actually include
1058       // all of the headers within the directory it covers. Complain about
1059       // this missing submodule and recover by forgetting that we ever saw
1060       // this submodule.
1061       // FIXME: Should we detect this at module load time? It seems fairly
1062       // expensive (and rare).
1063       getDiagnostics().Report(ImportLoc, diag::warn_missing_submodule)
1064         << Module->getFullModuleName()
1065         << SourceRange(Path.front().second, Path.back().second);
1066 
1067       return 0;
1068     }
1069 
1070     // Check whether this module is available.
1071     StringRef Feature;
1072     if (!Module->isAvailable(getLangOpts(), getTarget(), Feature)) {
1073       getDiagnostics().Report(ImportLoc, diag::err_module_unavailable)
1074         << Module->getFullModuleName()
1075         << Feature
1076         << SourceRange(Path.front().second, Path.back().second);
1077       LastModuleImportLoc = ImportLoc;
1078       LastModuleImportResult = 0;
1079       return 0;
1080     }
1081 
1082     ModuleManager->makeModuleVisible(Module, Visibility);
1083   }
1084 
1085   // If this module import was due to an inclusion directive, create an
1086   // implicit import declaration to capture it in the AST.
1087   if (IsInclusionDirective && hasASTContext()) {
1088     TranslationUnitDecl *TU = getASTContext().getTranslationUnitDecl();
1089     TU->addDecl(ImportDecl::CreateImplicit(getASTContext(), TU,
1090                                            ImportLoc, Module,
1091                                            Path.back().second));
1092   }
1093 
1094   LastModuleImportLoc = ImportLoc;
1095   LastModuleImportResult = Module;
1096   return Module;
1097 }
1098