xref: /freebsd/contrib/llvm-project/clang/lib/Frontend/ASTUnit.cpp (revision e40139ff33b48b56a24c808b166b04b8ee6f5b21)
1 //===- ASTUnit.cpp - ASTUnit utility --------------------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // ASTUnit Implementation.
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #include "clang/Frontend/ASTUnit.h"
14 #include "clang/AST/ASTConsumer.h"
15 #include "clang/AST/ASTContext.h"
16 #include "clang/AST/CommentCommandTraits.h"
17 #include "clang/AST/Decl.h"
18 #include "clang/AST/DeclBase.h"
19 #include "clang/AST/DeclCXX.h"
20 #include "clang/AST/DeclGroup.h"
21 #include "clang/AST/DeclObjC.h"
22 #include "clang/AST/DeclTemplate.h"
23 #include "clang/AST/DeclarationName.h"
24 #include "clang/AST/ExternalASTSource.h"
25 #include "clang/AST/PrettyPrinter.h"
26 #include "clang/AST/Type.h"
27 #include "clang/AST/TypeOrdering.h"
28 #include "clang/Basic/Diagnostic.h"
29 #include "clang/Basic/FileManager.h"
30 #include "clang/Basic/IdentifierTable.h"
31 #include "clang/Basic/LLVM.h"
32 #include "clang/Basic/LangOptions.h"
33 #include "clang/Basic/LangStandard.h"
34 #include "clang/Basic/Module.h"
35 #include "clang/Basic/SourceLocation.h"
36 #include "clang/Basic/SourceManager.h"
37 #include "clang/Basic/TargetInfo.h"
38 #include "clang/Basic/TargetOptions.h"
39 #include "clang/Frontend/CompilerInstance.h"
40 #include "clang/Frontend/CompilerInvocation.h"
41 #include "clang/Frontend/FrontendAction.h"
42 #include "clang/Frontend/FrontendActions.h"
43 #include "clang/Frontend/FrontendDiagnostic.h"
44 #include "clang/Frontend/FrontendOptions.h"
45 #include "clang/Frontend/MultiplexConsumer.h"
46 #include "clang/Frontend/PrecompiledPreamble.h"
47 #include "clang/Frontend/Utils.h"
48 #include "clang/Lex/HeaderSearch.h"
49 #include "clang/Lex/HeaderSearchOptions.h"
50 #include "clang/Lex/Lexer.h"
51 #include "clang/Lex/PPCallbacks.h"
52 #include "clang/Lex/PreprocessingRecord.h"
53 #include "clang/Lex/Preprocessor.h"
54 #include "clang/Lex/PreprocessorOptions.h"
55 #include "clang/Lex/Token.h"
56 #include "clang/Sema/CodeCompleteConsumer.h"
57 #include "clang/Sema/CodeCompleteOptions.h"
58 #include "clang/Sema/Sema.h"
59 #include "clang/Serialization/ASTBitCodes.h"
60 #include "clang/Serialization/ASTReader.h"
61 #include "clang/Serialization/ASTWriter.h"
62 #include "clang/Serialization/ContinuousRangeMap.h"
63 #include "clang/Serialization/InMemoryModuleCache.h"
64 #include "clang/Serialization/Module.h"
65 #include "clang/Serialization/PCHContainerOperations.h"
66 #include "llvm/ADT/ArrayRef.h"
67 #include "llvm/ADT/DenseMap.h"
68 #include "llvm/ADT/IntrusiveRefCntPtr.h"
69 #include "llvm/ADT/None.h"
70 #include "llvm/ADT/Optional.h"
71 #include "llvm/ADT/STLExtras.h"
72 #include "llvm/ADT/SmallString.h"
73 #include "llvm/ADT/SmallVector.h"
74 #include "llvm/ADT/StringMap.h"
75 #include "llvm/ADT/StringRef.h"
76 #include "llvm/ADT/StringSet.h"
77 #include "llvm/ADT/Twine.h"
78 #include "llvm/ADT/iterator_range.h"
79 #include "llvm/Bitstream/BitstreamWriter.h"
80 #include "llvm/Support/Allocator.h"
81 #include "llvm/Support/Casting.h"
82 #include "llvm/Support/CrashRecoveryContext.h"
83 #include "llvm/Support/DJB.h"
84 #include "llvm/Support/ErrorHandling.h"
85 #include "llvm/Support/ErrorOr.h"
86 #include "llvm/Support/FileSystem.h"
87 #include "llvm/Support/FileUtilities.h"
88 #include "llvm/Support/MemoryBuffer.h"
89 #include "llvm/Support/Timer.h"
90 #include "llvm/Support/VirtualFileSystem.h"
91 #include "llvm/Support/raw_ostream.h"
92 #include <algorithm>
93 #include <atomic>
94 #include <cassert>
95 #include <cstdint>
96 #include <cstdio>
97 #include <cstdlib>
98 #include <memory>
99 #include <mutex>
100 #include <string>
101 #include <tuple>
102 #include <utility>
103 #include <vector>
104 
105 using namespace clang;
106 
107 using llvm::TimeRecord;
108 
109 namespace {
110 
111   class SimpleTimer {
112     bool WantTiming;
113     TimeRecord Start;
114     std::string Output;
115 
116   public:
117     explicit SimpleTimer(bool WantTiming) : WantTiming(WantTiming) {
118       if (WantTiming)
119         Start = TimeRecord::getCurrentTime();
120     }
121 
122     ~SimpleTimer() {
123       if (WantTiming) {
124         TimeRecord Elapsed = TimeRecord::getCurrentTime();
125         Elapsed -= Start;
126         llvm::errs() << Output << ':';
127         Elapsed.print(Elapsed, llvm::errs());
128         llvm::errs() << '\n';
129       }
130     }
131 
132     void setOutput(const Twine &Output) {
133       if (WantTiming)
134         this->Output = Output.str();
135     }
136   };
137 
138 } // namespace
139 
140 template <class T>
141 static std::unique_ptr<T> valueOrNull(llvm::ErrorOr<std::unique_ptr<T>> Val) {
142   if (!Val)
143     return nullptr;
144   return std::move(*Val);
145 }
146 
147 template <class T>
148 static bool moveOnNoError(llvm::ErrorOr<T> Val, T &Output) {
149   if (!Val)
150     return false;
151   Output = std::move(*Val);
152   return true;
153 }
154 
155 /// Get a source buffer for \p MainFilePath, handling all file-to-file
156 /// and file-to-buffer remappings inside \p Invocation.
157 static std::unique_ptr<llvm::MemoryBuffer>
158 getBufferForFileHandlingRemapping(const CompilerInvocation &Invocation,
159                                   llvm::vfs::FileSystem *VFS,
160                                   StringRef FilePath, bool isVolatile) {
161   const auto &PreprocessorOpts = Invocation.getPreprocessorOpts();
162 
163   // Try to determine if the main file has been remapped, either from the
164   // command line (to another file) or directly through the compiler
165   // invocation (to a memory buffer).
166   llvm::MemoryBuffer *Buffer = nullptr;
167   std::unique_ptr<llvm::MemoryBuffer> BufferOwner;
168   auto FileStatus = VFS->status(FilePath);
169   if (FileStatus) {
170     llvm::sys::fs::UniqueID MainFileID = FileStatus->getUniqueID();
171 
172     // Check whether there is a file-file remapping of the main file
173     for (const auto &RF : PreprocessorOpts.RemappedFiles) {
174       std::string MPath(RF.first);
175       auto MPathStatus = VFS->status(MPath);
176       if (MPathStatus) {
177         llvm::sys::fs::UniqueID MID = MPathStatus->getUniqueID();
178         if (MainFileID == MID) {
179           // We found a remapping. Try to load the resulting, remapped source.
180           BufferOwner = valueOrNull(VFS->getBufferForFile(RF.second, -1, true, isVolatile));
181           if (!BufferOwner)
182             return nullptr;
183         }
184       }
185     }
186 
187     // Check whether there is a file-buffer remapping. It supercedes the
188     // file-file remapping.
189     for (const auto &RB : PreprocessorOpts.RemappedFileBuffers) {
190       std::string MPath(RB.first);
191       auto MPathStatus = VFS->status(MPath);
192       if (MPathStatus) {
193         llvm::sys::fs::UniqueID MID = MPathStatus->getUniqueID();
194         if (MainFileID == MID) {
195           // We found a remapping.
196           BufferOwner.reset();
197           Buffer = const_cast<llvm::MemoryBuffer *>(RB.second);
198         }
199       }
200     }
201   }
202 
203   // If the main source file was not remapped, load it now.
204   if (!Buffer && !BufferOwner) {
205     BufferOwner = valueOrNull(VFS->getBufferForFile(FilePath, -1, true, isVolatile));
206     if (!BufferOwner)
207       return nullptr;
208   }
209 
210   if (BufferOwner)
211     return BufferOwner;
212   if (!Buffer)
213     return nullptr;
214   return llvm::MemoryBuffer::getMemBufferCopy(Buffer->getBuffer(), FilePath);
215 }
216 
217 struct ASTUnit::ASTWriterData {
218   SmallString<128> Buffer;
219   llvm::BitstreamWriter Stream;
220   ASTWriter Writer;
221 
222   ASTWriterData(InMemoryModuleCache &ModuleCache)
223       : Stream(Buffer), Writer(Stream, Buffer, ModuleCache, {}) {}
224 };
225 
226 void ASTUnit::clearFileLevelDecls() {
227   llvm::DeleteContainerSeconds(FileDecls);
228 }
229 
230 /// After failing to build a precompiled preamble (due to
231 /// errors in the source that occurs in the preamble), the number of
232 /// reparses during which we'll skip even trying to precompile the
233 /// preamble.
234 const unsigned DefaultPreambleRebuildInterval = 5;
235 
236 /// Tracks the number of ASTUnit objects that are currently active.
237 ///
238 /// Used for debugging purposes only.
239 static std::atomic<unsigned> ActiveASTUnitObjects;
240 
241 ASTUnit::ASTUnit(bool _MainFileIsAST)
242     : MainFileIsAST(_MainFileIsAST), WantTiming(getenv("LIBCLANG_TIMING")),
243       ShouldCacheCodeCompletionResults(false),
244       IncludeBriefCommentsInCodeCompletion(false), UserFilesAreVolatile(false),
245       UnsafeToFree(false) {
246   if (getenv("LIBCLANG_OBJTRACKING"))
247     fprintf(stderr, "+++ %u translation units\n", ++ActiveASTUnitObjects);
248 }
249 
250 ASTUnit::~ASTUnit() {
251   // If we loaded from an AST file, balance out the BeginSourceFile call.
252   if (MainFileIsAST && getDiagnostics().getClient()) {
253     getDiagnostics().getClient()->EndSourceFile();
254   }
255 
256   clearFileLevelDecls();
257 
258   // Free the buffers associated with remapped files. We are required to
259   // perform this operation here because we explicitly request that the
260   // compiler instance *not* free these buffers for each invocation of the
261   // parser.
262   if (Invocation && OwnsRemappedFileBuffers) {
263     PreprocessorOptions &PPOpts = Invocation->getPreprocessorOpts();
264     for (const auto &RB : PPOpts.RemappedFileBuffers)
265       delete RB.second;
266   }
267 
268   ClearCachedCompletionResults();
269 
270   if (getenv("LIBCLANG_OBJTRACKING"))
271     fprintf(stderr, "--- %u translation units\n", --ActiveASTUnitObjects);
272 }
273 
274 void ASTUnit::setPreprocessor(std::shared_ptr<Preprocessor> PP) {
275   this->PP = std::move(PP);
276 }
277 
278 void ASTUnit::enableSourceFileDiagnostics() {
279   assert(getDiagnostics().getClient() && Ctx &&
280       "Bad context for source file");
281   getDiagnostics().getClient()->BeginSourceFile(Ctx->getLangOpts(), PP.get());
282 }
283 
284 /// Determine the set of code-completion contexts in which this
285 /// declaration should be shown.
286 static uint64_t getDeclShowContexts(const NamedDecl *ND,
287                                     const LangOptions &LangOpts,
288                                     bool &IsNestedNameSpecifier) {
289   IsNestedNameSpecifier = false;
290 
291   if (isa<UsingShadowDecl>(ND))
292     ND = ND->getUnderlyingDecl();
293   if (!ND)
294     return 0;
295 
296   uint64_t Contexts = 0;
297   if (isa<TypeDecl>(ND) || isa<ObjCInterfaceDecl>(ND) ||
298       isa<ClassTemplateDecl>(ND) || isa<TemplateTemplateParmDecl>(ND) ||
299       isa<TypeAliasTemplateDecl>(ND)) {
300     // Types can appear in these contexts.
301     if (LangOpts.CPlusPlus || !isa<TagDecl>(ND))
302       Contexts |= (1LL << CodeCompletionContext::CCC_TopLevel)
303                |  (1LL << CodeCompletionContext::CCC_ObjCIvarList)
304                |  (1LL << CodeCompletionContext::CCC_ClassStructUnion)
305                |  (1LL << CodeCompletionContext::CCC_Statement)
306                |  (1LL << CodeCompletionContext::CCC_Type)
307                |  (1LL << CodeCompletionContext::CCC_ParenthesizedExpression);
308 
309     // In C++, types can appear in expressions contexts (for functional casts).
310     if (LangOpts.CPlusPlus)
311       Contexts |= (1LL << CodeCompletionContext::CCC_Expression);
312 
313     // In Objective-C, message sends can send interfaces. In Objective-C++,
314     // all types are available due to functional casts.
315     if (LangOpts.CPlusPlus || isa<ObjCInterfaceDecl>(ND))
316       Contexts |= (1LL << CodeCompletionContext::CCC_ObjCMessageReceiver);
317 
318     // In Objective-C, you can only be a subclass of another Objective-C class
319     if (const auto *ID = dyn_cast<ObjCInterfaceDecl>(ND)) {
320       // Objective-C interfaces can be used in a class property expression.
321       if (ID->getDefinition())
322         Contexts |= (1LL << CodeCompletionContext::CCC_Expression);
323       Contexts |= (1LL << CodeCompletionContext::CCC_ObjCInterfaceName);
324     }
325 
326     // Deal with tag names.
327     if (isa<EnumDecl>(ND)) {
328       Contexts |= (1LL << CodeCompletionContext::CCC_EnumTag);
329 
330       // Part of the nested-name-specifier in C++0x.
331       if (LangOpts.CPlusPlus11)
332         IsNestedNameSpecifier = true;
333     } else if (const auto *Record = dyn_cast<RecordDecl>(ND)) {
334       if (Record->isUnion())
335         Contexts |= (1LL << CodeCompletionContext::CCC_UnionTag);
336       else
337         Contexts |= (1LL << CodeCompletionContext::CCC_ClassOrStructTag);
338 
339       if (LangOpts.CPlusPlus)
340         IsNestedNameSpecifier = true;
341     } else if (isa<ClassTemplateDecl>(ND))
342       IsNestedNameSpecifier = true;
343   } else if (isa<ValueDecl>(ND) || isa<FunctionTemplateDecl>(ND)) {
344     // Values can appear in these contexts.
345     Contexts = (1LL << CodeCompletionContext::CCC_Statement)
346              | (1LL << CodeCompletionContext::CCC_Expression)
347              | (1LL << CodeCompletionContext::CCC_ParenthesizedExpression)
348              | (1LL << CodeCompletionContext::CCC_ObjCMessageReceiver);
349   } else if (isa<ObjCProtocolDecl>(ND)) {
350     Contexts = (1LL << CodeCompletionContext::CCC_ObjCProtocolName);
351   } else if (isa<ObjCCategoryDecl>(ND)) {
352     Contexts = (1LL << CodeCompletionContext::CCC_ObjCCategoryName);
353   } else if (isa<NamespaceDecl>(ND) || isa<NamespaceAliasDecl>(ND)) {
354     Contexts = (1LL << CodeCompletionContext::CCC_Namespace);
355 
356     // Part of the nested-name-specifier.
357     IsNestedNameSpecifier = true;
358   }
359 
360   return Contexts;
361 }
362 
363 void ASTUnit::CacheCodeCompletionResults() {
364   if (!TheSema)
365     return;
366 
367   SimpleTimer Timer(WantTiming);
368   Timer.setOutput("Cache global code completions for " + getMainFileName());
369 
370   // Clear out the previous results.
371   ClearCachedCompletionResults();
372 
373   // Gather the set of global code completions.
374   using Result = CodeCompletionResult;
375   SmallVector<Result, 8> Results;
376   CachedCompletionAllocator = std::make_shared<GlobalCodeCompletionAllocator>();
377   CodeCompletionTUInfo CCTUInfo(CachedCompletionAllocator);
378   TheSema->GatherGlobalCodeCompletions(*CachedCompletionAllocator,
379                                        CCTUInfo, Results);
380 
381   // Translate global code completions into cached completions.
382   llvm::DenseMap<CanQualType, unsigned> CompletionTypes;
383   CodeCompletionContext CCContext(CodeCompletionContext::CCC_TopLevel);
384 
385   for (auto &R : Results) {
386     switch (R.Kind) {
387     case Result::RK_Declaration: {
388       bool IsNestedNameSpecifier = false;
389       CachedCodeCompletionResult CachedResult;
390       CachedResult.Completion = R.CreateCodeCompletionString(
391           *TheSema, CCContext, *CachedCompletionAllocator, CCTUInfo,
392           IncludeBriefCommentsInCodeCompletion);
393       CachedResult.ShowInContexts = getDeclShowContexts(
394           R.Declaration, Ctx->getLangOpts(), IsNestedNameSpecifier);
395       CachedResult.Priority = R.Priority;
396       CachedResult.Kind = R.CursorKind;
397       CachedResult.Availability = R.Availability;
398 
399       // Keep track of the type of this completion in an ASTContext-agnostic
400       // way.
401       QualType UsageType = getDeclUsageType(*Ctx, R.Declaration);
402       if (UsageType.isNull()) {
403         CachedResult.TypeClass = STC_Void;
404         CachedResult.Type = 0;
405       } else {
406         CanQualType CanUsageType
407           = Ctx->getCanonicalType(UsageType.getUnqualifiedType());
408         CachedResult.TypeClass = getSimplifiedTypeClass(CanUsageType);
409 
410         // Determine whether we have already seen this type. If so, we save
411         // ourselves the work of formatting the type string by using the
412         // temporary, CanQualType-based hash table to find the associated value.
413         unsigned &TypeValue = CompletionTypes[CanUsageType];
414         if (TypeValue == 0) {
415           TypeValue = CompletionTypes.size();
416           CachedCompletionTypes[QualType(CanUsageType).getAsString()]
417             = TypeValue;
418         }
419 
420         CachedResult.Type = TypeValue;
421       }
422 
423       CachedCompletionResults.push_back(CachedResult);
424 
425       /// Handle nested-name-specifiers in C++.
426       if (TheSema->Context.getLangOpts().CPlusPlus && IsNestedNameSpecifier &&
427           !R.StartsNestedNameSpecifier) {
428         // The contexts in which a nested-name-specifier can appear in C++.
429         uint64_t NNSContexts
430           = (1LL << CodeCompletionContext::CCC_TopLevel)
431           | (1LL << CodeCompletionContext::CCC_ObjCIvarList)
432           | (1LL << CodeCompletionContext::CCC_ClassStructUnion)
433           | (1LL << CodeCompletionContext::CCC_Statement)
434           | (1LL << CodeCompletionContext::CCC_Expression)
435           | (1LL << CodeCompletionContext::CCC_ObjCMessageReceiver)
436           | (1LL << CodeCompletionContext::CCC_EnumTag)
437           | (1LL << CodeCompletionContext::CCC_UnionTag)
438           | (1LL << CodeCompletionContext::CCC_ClassOrStructTag)
439           | (1LL << CodeCompletionContext::CCC_Type)
440           | (1LL << CodeCompletionContext::CCC_SymbolOrNewName)
441           | (1LL << CodeCompletionContext::CCC_ParenthesizedExpression);
442 
443         if (isa<NamespaceDecl>(R.Declaration) ||
444             isa<NamespaceAliasDecl>(R.Declaration))
445           NNSContexts |= (1LL << CodeCompletionContext::CCC_Namespace);
446 
447         if (uint64_t RemainingContexts
448                                 = NNSContexts & ~CachedResult.ShowInContexts) {
449           // If there any contexts where this completion can be a
450           // nested-name-specifier but isn't already an option, create a
451           // nested-name-specifier completion.
452           R.StartsNestedNameSpecifier = true;
453           CachedResult.Completion = R.CreateCodeCompletionString(
454               *TheSema, CCContext, *CachedCompletionAllocator, CCTUInfo,
455               IncludeBriefCommentsInCodeCompletion);
456           CachedResult.ShowInContexts = RemainingContexts;
457           CachedResult.Priority = CCP_NestedNameSpecifier;
458           CachedResult.TypeClass = STC_Void;
459           CachedResult.Type = 0;
460           CachedCompletionResults.push_back(CachedResult);
461         }
462       }
463       break;
464     }
465 
466     case Result::RK_Keyword:
467     case Result::RK_Pattern:
468       // Ignore keywords and patterns; we don't care, since they are so
469       // easily regenerated.
470       break;
471 
472     case Result::RK_Macro: {
473       CachedCodeCompletionResult CachedResult;
474       CachedResult.Completion = R.CreateCodeCompletionString(
475           *TheSema, CCContext, *CachedCompletionAllocator, CCTUInfo,
476           IncludeBriefCommentsInCodeCompletion);
477       CachedResult.ShowInContexts
478         = (1LL << CodeCompletionContext::CCC_TopLevel)
479         | (1LL << CodeCompletionContext::CCC_ObjCInterface)
480         | (1LL << CodeCompletionContext::CCC_ObjCImplementation)
481         | (1LL << CodeCompletionContext::CCC_ObjCIvarList)
482         | (1LL << CodeCompletionContext::CCC_ClassStructUnion)
483         | (1LL << CodeCompletionContext::CCC_Statement)
484         | (1LL << CodeCompletionContext::CCC_Expression)
485         | (1LL << CodeCompletionContext::CCC_ObjCMessageReceiver)
486         | (1LL << CodeCompletionContext::CCC_MacroNameUse)
487         | (1LL << CodeCompletionContext::CCC_PreprocessorExpression)
488         | (1LL << CodeCompletionContext::CCC_ParenthesizedExpression)
489         | (1LL << CodeCompletionContext::CCC_OtherWithMacros);
490 
491       CachedResult.Priority = R.Priority;
492       CachedResult.Kind = R.CursorKind;
493       CachedResult.Availability = R.Availability;
494       CachedResult.TypeClass = STC_Void;
495       CachedResult.Type = 0;
496       CachedCompletionResults.push_back(CachedResult);
497       break;
498     }
499     }
500   }
501 
502   // Save the current top-level hash value.
503   CompletionCacheTopLevelHashValue = CurrentTopLevelHashValue;
504 }
505 
506 void ASTUnit::ClearCachedCompletionResults() {
507   CachedCompletionResults.clear();
508   CachedCompletionTypes.clear();
509   CachedCompletionAllocator = nullptr;
510 }
511 
512 namespace {
513 
514 /// Gathers information from ASTReader that will be used to initialize
515 /// a Preprocessor.
516 class ASTInfoCollector : public ASTReaderListener {
517   Preprocessor &PP;
518   ASTContext *Context;
519   HeaderSearchOptions &HSOpts;
520   PreprocessorOptions &PPOpts;
521   LangOptions &LangOpt;
522   std::shared_ptr<TargetOptions> &TargetOpts;
523   IntrusiveRefCntPtr<TargetInfo> &Target;
524   unsigned &Counter;
525   bool InitializedLanguage = false;
526 
527 public:
528   ASTInfoCollector(Preprocessor &PP, ASTContext *Context,
529                    HeaderSearchOptions &HSOpts, PreprocessorOptions &PPOpts,
530                    LangOptions &LangOpt,
531                    std::shared_ptr<TargetOptions> &TargetOpts,
532                    IntrusiveRefCntPtr<TargetInfo> &Target, unsigned &Counter)
533       : PP(PP), Context(Context), HSOpts(HSOpts), PPOpts(PPOpts),
534         LangOpt(LangOpt), TargetOpts(TargetOpts), Target(Target),
535         Counter(Counter) {}
536 
537   bool ReadLanguageOptions(const LangOptions &LangOpts, bool Complain,
538                            bool AllowCompatibleDifferences) override {
539     if (InitializedLanguage)
540       return false;
541 
542     LangOpt = LangOpts;
543     InitializedLanguage = true;
544 
545     updated();
546     return false;
547   }
548 
549   bool ReadHeaderSearchOptions(const HeaderSearchOptions &HSOpts,
550                                StringRef SpecificModuleCachePath,
551                                bool Complain) override {
552     this->HSOpts = HSOpts;
553     return false;
554   }
555 
556   bool ReadPreprocessorOptions(const PreprocessorOptions &PPOpts, bool Complain,
557                                std::string &SuggestedPredefines) override {
558     this->PPOpts = PPOpts;
559     return false;
560   }
561 
562   bool ReadTargetOptions(const TargetOptions &TargetOpts, bool Complain,
563                          bool AllowCompatibleDifferences) override {
564     // If we've already initialized the target, don't do it again.
565     if (Target)
566       return false;
567 
568     this->TargetOpts = std::make_shared<TargetOptions>(TargetOpts);
569     Target =
570         TargetInfo::CreateTargetInfo(PP.getDiagnostics(), this->TargetOpts);
571 
572     updated();
573     return false;
574   }
575 
576   void ReadCounter(const serialization::ModuleFile &M,
577                    unsigned Value) override {
578     Counter = Value;
579   }
580 
581 private:
582   void updated() {
583     if (!Target || !InitializedLanguage)
584       return;
585 
586     // Inform the target of the language options.
587     //
588     // FIXME: We shouldn't need to do this, the target should be immutable once
589     // created. This complexity should be lifted elsewhere.
590     Target->adjust(LangOpt);
591 
592     // Initialize the preprocessor.
593     PP.Initialize(*Target);
594 
595     if (!Context)
596       return;
597 
598     // Initialize the ASTContext
599     Context->InitBuiltinTypes(*Target);
600 
601     // Adjust printing policy based on language options.
602     Context->setPrintingPolicy(PrintingPolicy(LangOpt));
603 
604     // We didn't have access to the comment options when the ASTContext was
605     // constructed, so register them now.
606     Context->getCommentCommandTraits().registerCommentOptions(
607         LangOpt.CommentOpts);
608   }
609 };
610 
611 /// Diagnostic consumer that saves each diagnostic it is given.
612 class FilterAndStoreDiagnosticConsumer : public DiagnosticConsumer {
613   SmallVectorImpl<StoredDiagnostic> *StoredDiags;
614   SmallVectorImpl<ASTUnit::StandaloneDiagnostic> *StandaloneDiags;
615   bool CaptureNonErrorsFromIncludes = true;
616   const LangOptions *LangOpts = nullptr;
617   SourceManager *SourceMgr = nullptr;
618 
619 public:
620   FilterAndStoreDiagnosticConsumer(
621       SmallVectorImpl<StoredDiagnostic> *StoredDiags,
622       SmallVectorImpl<ASTUnit::StandaloneDiagnostic> *StandaloneDiags,
623       bool CaptureNonErrorsFromIncludes)
624       : StoredDiags(StoredDiags), StandaloneDiags(StandaloneDiags),
625         CaptureNonErrorsFromIncludes(CaptureNonErrorsFromIncludes) {
626     assert((StoredDiags || StandaloneDiags) &&
627            "No output collections were passed to StoredDiagnosticConsumer.");
628   }
629 
630   void BeginSourceFile(const LangOptions &LangOpts,
631                        const Preprocessor *PP = nullptr) override {
632     this->LangOpts = &LangOpts;
633     if (PP)
634       SourceMgr = &PP->getSourceManager();
635   }
636 
637   void HandleDiagnostic(DiagnosticsEngine::Level Level,
638                         const Diagnostic &Info) override;
639 };
640 
641 /// RAII object that optionally captures and filters diagnostics, if
642 /// there is no diagnostic client to capture them already.
643 class CaptureDroppedDiagnostics {
644   DiagnosticsEngine &Diags;
645   FilterAndStoreDiagnosticConsumer Client;
646   DiagnosticConsumer *PreviousClient = nullptr;
647   std::unique_ptr<DiagnosticConsumer> OwningPreviousClient;
648 
649 public:
650   CaptureDroppedDiagnostics(
651       CaptureDiagsKind CaptureDiagnostics, DiagnosticsEngine &Diags,
652       SmallVectorImpl<StoredDiagnostic> *StoredDiags,
653       SmallVectorImpl<ASTUnit::StandaloneDiagnostic> *StandaloneDiags)
654       : Diags(Diags),
655         Client(StoredDiags, StandaloneDiags,
656                CaptureDiagnostics !=
657                    CaptureDiagsKind::AllWithoutNonErrorsFromIncludes) {
658     if (CaptureDiagnostics != CaptureDiagsKind::None ||
659         Diags.getClient() == nullptr) {
660       OwningPreviousClient = Diags.takeClient();
661       PreviousClient = Diags.getClient();
662       Diags.setClient(&Client, false);
663     }
664   }
665 
666   ~CaptureDroppedDiagnostics() {
667     if (Diags.getClient() == &Client)
668       Diags.setClient(PreviousClient, !!OwningPreviousClient.release());
669   }
670 };
671 
672 } // namespace
673 
674 static ASTUnit::StandaloneDiagnostic
675 makeStandaloneDiagnostic(const LangOptions &LangOpts,
676                          const StoredDiagnostic &InDiag);
677 
678 static bool isInMainFile(const clang::Diagnostic &D) {
679   if (!D.hasSourceManager() || !D.getLocation().isValid())
680     return false;
681 
682   auto &M = D.getSourceManager();
683   return M.isWrittenInMainFile(M.getExpansionLoc(D.getLocation()));
684 }
685 
686 void FilterAndStoreDiagnosticConsumer::HandleDiagnostic(
687     DiagnosticsEngine::Level Level, const Diagnostic &Info) {
688   // Default implementation (Warnings/errors count).
689   DiagnosticConsumer::HandleDiagnostic(Level, Info);
690 
691   // Only record the diagnostic if it's part of the source manager we know
692   // about. This effectively drops diagnostics from modules we're building.
693   // FIXME: In the long run, ee don't want to drop source managers from modules.
694   if (!Info.hasSourceManager() || &Info.getSourceManager() == SourceMgr) {
695     if (!CaptureNonErrorsFromIncludes && Level <= DiagnosticsEngine::Warning &&
696         !isInMainFile(Info)) {
697       return;
698     }
699 
700     StoredDiagnostic *ResultDiag = nullptr;
701     if (StoredDiags) {
702       StoredDiags->emplace_back(Level, Info);
703       ResultDiag = &StoredDiags->back();
704     }
705 
706     if (StandaloneDiags) {
707       llvm::Optional<StoredDiagnostic> StoredDiag = None;
708       if (!ResultDiag) {
709         StoredDiag.emplace(Level, Info);
710         ResultDiag = StoredDiag.getPointer();
711       }
712       StandaloneDiags->push_back(
713           makeStandaloneDiagnostic(*LangOpts, *ResultDiag));
714     }
715   }
716 }
717 
718 IntrusiveRefCntPtr<ASTReader> ASTUnit::getASTReader() const {
719   return Reader;
720 }
721 
722 ASTMutationListener *ASTUnit::getASTMutationListener() {
723   if (WriterData)
724     return &WriterData->Writer;
725   return nullptr;
726 }
727 
728 ASTDeserializationListener *ASTUnit::getDeserializationListener() {
729   if (WriterData)
730     return &WriterData->Writer;
731   return nullptr;
732 }
733 
734 std::unique_ptr<llvm::MemoryBuffer>
735 ASTUnit::getBufferForFile(StringRef Filename, std::string *ErrorStr) {
736   assert(FileMgr);
737   auto Buffer = FileMgr->getBufferForFile(Filename, UserFilesAreVolatile);
738   if (Buffer)
739     return std::move(*Buffer);
740   if (ErrorStr)
741     *ErrorStr = Buffer.getError().message();
742   return nullptr;
743 }
744 
745 /// Configure the diagnostics object for use with ASTUnit.
746 void ASTUnit::ConfigureDiags(IntrusiveRefCntPtr<DiagnosticsEngine> Diags,
747                              ASTUnit &AST,
748                              CaptureDiagsKind CaptureDiagnostics) {
749   assert(Diags.get() && "no DiagnosticsEngine was provided");
750   if (CaptureDiagnostics != CaptureDiagsKind::None)
751     Diags->setClient(new FilterAndStoreDiagnosticConsumer(
752         &AST.StoredDiagnostics, nullptr,
753         CaptureDiagnostics != CaptureDiagsKind::AllWithoutNonErrorsFromIncludes));
754 }
755 
756 std::unique_ptr<ASTUnit> ASTUnit::LoadFromASTFile(
757     const std::string &Filename, const PCHContainerReader &PCHContainerRdr,
758     WhatToLoad ToLoad, IntrusiveRefCntPtr<DiagnosticsEngine> Diags,
759     const FileSystemOptions &FileSystemOpts, bool UseDebugInfo,
760     bool OnlyLocalDecls, ArrayRef<RemappedFile> RemappedFiles,
761     CaptureDiagsKind CaptureDiagnostics, bool AllowPCHWithCompilerErrors,
762     bool UserFilesAreVolatile) {
763   std::unique_ptr<ASTUnit> AST(new ASTUnit(true));
764 
765   // Recover resources if we crash before exiting this method.
766   llvm::CrashRecoveryContextCleanupRegistrar<ASTUnit>
767     ASTUnitCleanup(AST.get());
768   llvm::CrashRecoveryContextCleanupRegistrar<DiagnosticsEngine,
769     llvm::CrashRecoveryContextReleaseRefCleanup<DiagnosticsEngine>>
770     DiagCleanup(Diags.get());
771 
772   ConfigureDiags(Diags, *AST, CaptureDiagnostics);
773 
774   AST->LangOpts = std::make_shared<LangOptions>();
775   AST->OnlyLocalDecls = OnlyLocalDecls;
776   AST->CaptureDiagnostics = CaptureDiagnostics;
777   AST->Diagnostics = Diags;
778   IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS =
779       llvm::vfs::getRealFileSystem();
780   AST->FileMgr = new FileManager(FileSystemOpts, VFS);
781   AST->UserFilesAreVolatile = UserFilesAreVolatile;
782   AST->SourceMgr = new SourceManager(AST->getDiagnostics(),
783                                      AST->getFileManager(),
784                                      UserFilesAreVolatile);
785   AST->ModuleCache = new InMemoryModuleCache;
786   AST->HSOpts = std::make_shared<HeaderSearchOptions>();
787   AST->HSOpts->ModuleFormat = PCHContainerRdr.getFormat();
788   AST->HeaderInfo.reset(new HeaderSearch(AST->HSOpts,
789                                          AST->getSourceManager(),
790                                          AST->getDiagnostics(),
791                                          AST->getLangOpts(),
792                                          /*Target=*/nullptr));
793   AST->PPOpts = std::make_shared<PreprocessorOptions>();
794 
795   for (const auto &RemappedFile : RemappedFiles)
796     AST->PPOpts->addRemappedFile(RemappedFile.first, RemappedFile.second);
797 
798   // Gather Info for preprocessor construction later on.
799 
800   HeaderSearch &HeaderInfo = *AST->HeaderInfo;
801   unsigned Counter;
802 
803   AST->PP = std::make_shared<Preprocessor>(
804       AST->PPOpts, AST->getDiagnostics(), *AST->LangOpts,
805       AST->getSourceManager(), HeaderInfo, AST->ModuleLoader,
806       /*IILookup=*/nullptr,
807       /*OwnsHeaderSearch=*/false);
808   Preprocessor &PP = *AST->PP;
809 
810   if (ToLoad >= LoadASTOnly)
811     AST->Ctx = new ASTContext(*AST->LangOpts, AST->getSourceManager(),
812                               PP.getIdentifierTable(), PP.getSelectorTable(),
813                               PP.getBuiltinInfo());
814 
815   bool disableValid = false;
816   if (::getenv("LIBCLANG_DISABLE_PCH_VALIDATION"))
817     disableValid = true;
818   AST->Reader = new ASTReader(
819       PP, *AST->ModuleCache, AST->Ctx.get(), PCHContainerRdr, {},
820       /*isysroot=*/"",
821       /*DisableValidation=*/disableValid, AllowPCHWithCompilerErrors);
822 
823   AST->Reader->setListener(std::make_unique<ASTInfoCollector>(
824       *AST->PP, AST->Ctx.get(), *AST->HSOpts, *AST->PPOpts, *AST->LangOpts,
825       AST->TargetOpts, AST->Target, Counter));
826 
827   // Attach the AST reader to the AST context as an external AST
828   // source, so that declarations will be deserialized from the
829   // AST file as needed.
830   // We need the external source to be set up before we read the AST, because
831   // eagerly-deserialized declarations may use it.
832   if (AST->Ctx)
833     AST->Ctx->setExternalSource(AST->Reader);
834 
835   switch (AST->Reader->ReadAST(Filename, serialization::MK_MainFile,
836                           SourceLocation(), ASTReader::ARR_None)) {
837   case ASTReader::Success:
838     break;
839 
840   case ASTReader::Failure:
841   case ASTReader::Missing:
842   case ASTReader::OutOfDate:
843   case ASTReader::VersionMismatch:
844   case ASTReader::ConfigurationMismatch:
845   case ASTReader::HadErrors:
846     AST->getDiagnostics().Report(diag::err_fe_unable_to_load_pch);
847     return nullptr;
848   }
849 
850   AST->OriginalSourceFile = AST->Reader->getOriginalSourceFile();
851 
852   PP.setCounterValue(Counter);
853 
854   // Create an AST consumer, even though it isn't used.
855   if (ToLoad >= LoadASTOnly)
856     AST->Consumer.reset(new ASTConsumer);
857 
858   // Create a semantic analysis object and tell the AST reader about it.
859   if (ToLoad >= LoadEverything) {
860     AST->TheSema.reset(new Sema(PP, *AST->Ctx, *AST->Consumer));
861     AST->TheSema->Initialize();
862     AST->Reader->InitializeSema(*AST->TheSema);
863   }
864 
865   // Tell the diagnostic client that we have started a source file.
866   AST->getDiagnostics().getClient()->BeginSourceFile(PP.getLangOpts(), &PP);
867 
868   return AST;
869 }
870 
871 /// Add the given macro to the hash of all top-level entities.
872 static void AddDefinedMacroToHash(const Token &MacroNameTok, unsigned &Hash) {
873   Hash = llvm::djbHash(MacroNameTok.getIdentifierInfo()->getName(), Hash);
874 }
875 
876 namespace {
877 
878 /// Preprocessor callback class that updates a hash value with the names
879 /// of all macros that have been defined by the translation unit.
880 class MacroDefinitionTrackerPPCallbacks : public PPCallbacks {
881   unsigned &Hash;
882 
883 public:
884   explicit MacroDefinitionTrackerPPCallbacks(unsigned &Hash) : Hash(Hash) {}
885 
886   void MacroDefined(const Token &MacroNameTok,
887                     const MacroDirective *MD) override {
888     AddDefinedMacroToHash(MacroNameTok, Hash);
889   }
890 };
891 
892 } // namespace
893 
894 /// Add the given declaration to the hash of all top-level entities.
895 static void AddTopLevelDeclarationToHash(Decl *D, unsigned &Hash) {
896   if (!D)
897     return;
898 
899   DeclContext *DC = D->getDeclContext();
900   if (!DC)
901     return;
902 
903   if (!(DC->isTranslationUnit() || DC->getLookupParent()->isTranslationUnit()))
904     return;
905 
906   if (const auto *ND = dyn_cast<NamedDecl>(D)) {
907     if (const auto *EnumD = dyn_cast<EnumDecl>(D)) {
908       // For an unscoped enum include the enumerators in the hash since they
909       // enter the top-level namespace.
910       if (!EnumD->isScoped()) {
911         for (const auto *EI : EnumD->enumerators()) {
912           if (EI->getIdentifier())
913             Hash = llvm::djbHash(EI->getIdentifier()->getName(), Hash);
914         }
915       }
916     }
917 
918     if (ND->getIdentifier())
919       Hash = llvm::djbHash(ND->getIdentifier()->getName(), Hash);
920     else if (DeclarationName Name = ND->getDeclName()) {
921       std::string NameStr = Name.getAsString();
922       Hash = llvm::djbHash(NameStr, Hash);
923     }
924     return;
925   }
926 
927   if (const auto *ImportD = dyn_cast<ImportDecl>(D)) {
928     if (const Module *Mod = ImportD->getImportedModule()) {
929       std::string ModName = Mod->getFullModuleName();
930       Hash = llvm::djbHash(ModName, Hash);
931     }
932     return;
933   }
934 }
935 
936 namespace {
937 
938 class TopLevelDeclTrackerConsumer : public ASTConsumer {
939   ASTUnit &Unit;
940   unsigned &Hash;
941 
942 public:
943   TopLevelDeclTrackerConsumer(ASTUnit &_Unit, unsigned &Hash)
944       : Unit(_Unit), Hash(Hash) {
945     Hash = 0;
946   }
947 
948   void handleTopLevelDecl(Decl *D) {
949     if (!D)
950       return;
951 
952     // FIXME: Currently ObjC method declarations are incorrectly being
953     // reported as top-level declarations, even though their DeclContext
954     // is the containing ObjC @interface/@implementation.  This is a
955     // fundamental problem in the parser right now.
956     if (isa<ObjCMethodDecl>(D))
957       return;
958 
959     AddTopLevelDeclarationToHash(D, Hash);
960     Unit.addTopLevelDecl(D);
961 
962     handleFileLevelDecl(D);
963   }
964 
965   void handleFileLevelDecl(Decl *D) {
966     Unit.addFileLevelDecl(D);
967     if (auto *NSD = dyn_cast<NamespaceDecl>(D)) {
968       for (auto *I : NSD->decls())
969         handleFileLevelDecl(I);
970     }
971   }
972 
973   bool HandleTopLevelDecl(DeclGroupRef D) override {
974     for (auto *TopLevelDecl : D)
975       handleTopLevelDecl(TopLevelDecl);
976     return true;
977   }
978 
979   // We're not interested in "interesting" decls.
980   void HandleInterestingDecl(DeclGroupRef) override {}
981 
982   void HandleTopLevelDeclInObjCContainer(DeclGroupRef D) override {
983     for (auto *TopLevelDecl : D)
984       handleTopLevelDecl(TopLevelDecl);
985   }
986 
987   ASTMutationListener *GetASTMutationListener() override {
988     return Unit.getASTMutationListener();
989   }
990 
991   ASTDeserializationListener *GetASTDeserializationListener() override {
992     return Unit.getDeserializationListener();
993   }
994 };
995 
996 class TopLevelDeclTrackerAction : public ASTFrontendAction {
997 public:
998   ASTUnit &Unit;
999 
1000   std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
1001                                                  StringRef InFile) override {
1002     CI.getPreprocessor().addPPCallbacks(
1003         std::make_unique<MacroDefinitionTrackerPPCallbacks>(
1004                                            Unit.getCurrentTopLevelHashValue()));
1005     return std::make_unique<TopLevelDeclTrackerConsumer>(
1006         Unit, Unit.getCurrentTopLevelHashValue());
1007   }
1008 
1009 public:
1010   TopLevelDeclTrackerAction(ASTUnit &_Unit) : Unit(_Unit) {}
1011 
1012   bool hasCodeCompletionSupport() const override { return false; }
1013 
1014   TranslationUnitKind getTranslationUnitKind() override {
1015     return Unit.getTranslationUnitKind();
1016   }
1017 };
1018 
1019 class ASTUnitPreambleCallbacks : public PreambleCallbacks {
1020 public:
1021   unsigned getHash() const { return Hash; }
1022 
1023   std::vector<Decl *> takeTopLevelDecls() { return std::move(TopLevelDecls); }
1024 
1025   std::vector<serialization::DeclID> takeTopLevelDeclIDs() {
1026     return std::move(TopLevelDeclIDs);
1027   }
1028 
1029   void AfterPCHEmitted(ASTWriter &Writer) override {
1030     TopLevelDeclIDs.reserve(TopLevelDecls.size());
1031     for (const auto *D : TopLevelDecls) {
1032       // Invalid top-level decls may not have been serialized.
1033       if (D->isInvalidDecl())
1034         continue;
1035       TopLevelDeclIDs.push_back(Writer.getDeclID(D));
1036     }
1037   }
1038 
1039   void HandleTopLevelDecl(DeclGroupRef DG) override {
1040     for (auto *D : DG) {
1041       // FIXME: Currently ObjC method declarations are incorrectly being
1042       // reported as top-level declarations, even though their DeclContext
1043       // is the containing ObjC @interface/@implementation.  This is a
1044       // fundamental problem in the parser right now.
1045       if (isa<ObjCMethodDecl>(D))
1046         continue;
1047       AddTopLevelDeclarationToHash(D, Hash);
1048       TopLevelDecls.push_back(D);
1049     }
1050   }
1051 
1052   std::unique_ptr<PPCallbacks> createPPCallbacks() override {
1053     return std::make_unique<MacroDefinitionTrackerPPCallbacks>(Hash);
1054   }
1055 
1056 private:
1057   unsigned Hash = 0;
1058   std::vector<Decl *> TopLevelDecls;
1059   std::vector<serialization::DeclID> TopLevelDeclIDs;
1060   llvm::SmallVector<ASTUnit::StandaloneDiagnostic, 4> PreambleDiags;
1061 };
1062 
1063 } // namespace
1064 
1065 static bool isNonDriverDiag(const StoredDiagnostic &StoredDiag) {
1066   return StoredDiag.getLocation().isValid();
1067 }
1068 
1069 static void
1070 checkAndRemoveNonDriverDiags(SmallVectorImpl<StoredDiagnostic> &StoredDiags) {
1071   // Get rid of stored diagnostics except the ones from the driver which do not
1072   // have a source location.
1073   StoredDiags.erase(
1074       std::remove_if(StoredDiags.begin(), StoredDiags.end(), isNonDriverDiag),
1075       StoredDiags.end());
1076 }
1077 
1078 static void checkAndSanitizeDiags(SmallVectorImpl<StoredDiagnostic> &
1079                                                               StoredDiagnostics,
1080                                   SourceManager &SM) {
1081   // The stored diagnostic has the old source manager in it; update
1082   // the locations to refer into the new source manager. Since we've
1083   // been careful to make sure that the source manager's state
1084   // before and after are identical, so that we can reuse the source
1085   // location itself.
1086   for (auto &SD : StoredDiagnostics) {
1087     if (SD.getLocation().isValid()) {
1088       FullSourceLoc Loc(SD.getLocation(), SM);
1089       SD.setLocation(Loc);
1090     }
1091   }
1092 }
1093 
1094 /// Parse the source file into a translation unit using the given compiler
1095 /// invocation, replacing the current translation unit.
1096 ///
1097 /// \returns True if a failure occurred that causes the ASTUnit not to
1098 /// contain any translation-unit information, false otherwise.
1099 bool ASTUnit::Parse(std::shared_ptr<PCHContainerOperations> PCHContainerOps,
1100                     std::unique_ptr<llvm::MemoryBuffer> OverrideMainBuffer,
1101                     IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS) {
1102   if (!Invocation)
1103     return true;
1104 
1105   if (VFS && FileMgr)
1106     assert(VFS == &FileMgr->getVirtualFileSystem() &&
1107            "VFS passed to Parse and VFS in FileMgr are different");
1108 
1109   auto CCInvocation = std::make_shared<CompilerInvocation>(*Invocation);
1110   if (OverrideMainBuffer) {
1111     assert(Preamble &&
1112            "No preamble was built, but OverrideMainBuffer is not null");
1113     Preamble->AddImplicitPreamble(*CCInvocation, VFS, OverrideMainBuffer.get());
1114     // VFS may have changed...
1115   }
1116 
1117   // Create the compiler instance to use for building the AST.
1118   std::unique_ptr<CompilerInstance> Clang(
1119       new CompilerInstance(std::move(PCHContainerOps)));
1120 
1121   // Ensure that Clang has a FileManager with the right VFS, which may have
1122   // changed above in AddImplicitPreamble.  If VFS is nullptr, rely on
1123   // createFileManager to create one.
1124   if (VFS && FileMgr && &FileMgr->getVirtualFileSystem() == VFS)
1125     Clang->setFileManager(&*FileMgr);
1126   else
1127     FileMgr = Clang->createFileManager(std::move(VFS));
1128 
1129   // Recover resources if we crash before exiting this method.
1130   llvm::CrashRecoveryContextCleanupRegistrar<CompilerInstance>
1131     CICleanup(Clang.get());
1132 
1133   Clang->setInvocation(CCInvocation);
1134   OriginalSourceFile = Clang->getFrontendOpts().Inputs[0].getFile();
1135 
1136   // Set up diagnostics, capturing any diagnostics that would
1137   // otherwise be dropped.
1138   Clang->setDiagnostics(&getDiagnostics());
1139 
1140   // Create the target instance.
1141   Clang->setTarget(TargetInfo::CreateTargetInfo(
1142       Clang->getDiagnostics(), Clang->getInvocation().TargetOpts));
1143   if (!Clang->hasTarget())
1144     return true;
1145 
1146   // Inform the target of the language options.
1147   //
1148   // FIXME: We shouldn't need to do this, the target should be immutable once
1149   // created. This complexity should be lifted elsewhere.
1150   Clang->getTarget().adjust(Clang->getLangOpts());
1151 
1152   assert(Clang->getFrontendOpts().Inputs.size() == 1 &&
1153          "Invocation must have exactly one source file!");
1154   assert(Clang->getFrontendOpts().Inputs[0].getKind().getFormat() ==
1155              InputKind::Source &&
1156          "FIXME: AST inputs not yet supported here!");
1157   assert(Clang->getFrontendOpts().Inputs[0].getKind().getLanguage() !=
1158              Language::LLVM_IR &&
1159          "IR inputs not support here!");
1160 
1161   // Configure the various subsystems.
1162   LangOpts = Clang->getInvocation().LangOpts;
1163   FileSystemOpts = Clang->getFileSystemOpts();
1164 
1165   ResetForParse();
1166 
1167   SourceMgr = new SourceManager(getDiagnostics(), *FileMgr,
1168                                 UserFilesAreVolatile);
1169   if (!OverrideMainBuffer) {
1170     checkAndRemoveNonDriverDiags(StoredDiagnostics);
1171     TopLevelDeclsInPreamble.clear();
1172   }
1173 
1174   // Create a file manager object to provide access to and cache the filesystem.
1175   Clang->setFileManager(&getFileManager());
1176 
1177   // Create the source manager.
1178   Clang->setSourceManager(&getSourceManager());
1179 
1180   // If the main file has been overridden due to the use of a preamble,
1181   // make that override happen and introduce the preamble.
1182   if (OverrideMainBuffer) {
1183     // The stored diagnostic has the old source manager in it; update
1184     // the locations to refer into the new source manager. Since we've
1185     // been careful to make sure that the source manager's state
1186     // before and after are identical, so that we can reuse the source
1187     // location itself.
1188     checkAndSanitizeDiags(StoredDiagnostics, getSourceManager());
1189 
1190     // Keep track of the override buffer;
1191     SavedMainFileBuffer = std::move(OverrideMainBuffer);
1192   }
1193 
1194   std::unique_ptr<TopLevelDeclTrackerAction> Act(
1195       new TopLevelDeclTrackerAction(*this));
1196 
1197   // Recover resources if we crash before exiting this method.
1198   llvm::CrashRecoveryContextCleanupRegistrar<TopLevelDeclTrackerAction>
1199     ActCleanup(Act.get());
1200 
1201   if (!Act->BeginSourceFile(*Clang.get(), Clang->getFrontendOpts().Inputs[0]))
1202     goto error;
1203 
1204   if (SavedMainFileBuffer)
1205     TranslateStoredDiagnostics(getFileManager(), getSourceManager(),
1206                                PreambleDiagnostics, StoredDiagnostics);
1207   else
1208     PreambleSrcLocCache.clear();
1209 
1210   if (llvm::Error Err = Act->Execute()) {
1211     consumeError(std::move(Err)); // FIXME this drops errors on the floor.
1212     goto error;
1213   }
1214 
1215   transferASTDataFromCompilerInstance(*Clang);
1216 
1217   Act->EndSourceFile();
1218 
1219   FailedParseDiagnostics.clear();
1220 
1221   return false;
1222 
1223 error:
1224   // Remove the overridden buffer we used for the preamble.
1225   SavedMainFileBuffer = nullptr;
1226 
1227   // Keep the ownership of the data in the ASTUnit because the client may
1228   // want to see the diagnostics.
1229   transferASTDataFromCompilerInstance(*Clang);
1230   FailedParseDiagnostics.swap(StoredDiagnostics);
1231   StoredDiagnostics.clear();
1232   NumStoredDiagnosticsFromDriver = 0;
1233   return true;
1234 }
1235 
1236 static std::pair<unsigned, unsigned>
1237 makeStandaloneRange(CharSourceRange Range, const SourceManager &SM,
1238                     const LangOptions &LangOpts) {
1239   CharSourceRange FileRange = Lexer::makeFileCharRange(Range, SM, LangOpts);
1240   unsigned Offset = SM.getFileOffset(FileRange.getBegin());
1241   unsigned EndOffset = SM.getFileOffset(FileRange.getEnd());
1242   return std::make_pair(Offset, EndOffset);
1243 }
1244 
1245 static ASTUnit::StandaloneFixIt makeStandaloneFixIt(const SourceManager &SM,
1246                                                     const LangOptions &LangOpts,
1247                                                     const FixItHint &InFix) {
1248   ASTUnit::StandaloneFixIt OutFix;
1249   OutFix.RemoveRange = makeStandaloneRange(InFix.RemoveRange, SM, LangOpts);
1250   OutFix.InsertFromRange = makeStandaloneRange(InFix.InsertFromRange, SM,
1251                                                LangOpts);
1252   OutFix.CodeToInsert = InFix.CodeToInsert;
1253   OutFix.BeforePreviousInsertions = InFix.BeforePreviousInsertions;
1254   return OutFix;
1255 }
1256 
1257 static ASTUnit::StandaloneDiagnostic
1258 makeStandaloneDiagnostic(const LangOptions &LangOpts,
1259                          const StoredDiagnostic &InDiag) {
1260   ASTUnit::StandaloneDiagnostic OutDiag;
1261   OutDiag.ID = InDiag.getID();
1262   OutDiag.Level = InDiag.getLevel();
1263   OutDiag.Message = InDiag.getMessage();
1264   OutDiag.LocOffset = 0;
1265   if (InDiag.getLocation().isInvalid())
1266     return OutDiag;
1267   const SourceManager &SM = InDiag.getLocation().getManager();
1268   SourceLocation FileLoc = SM.getFileLoc(InDiag.getLocation());
1269   OutDiag.Filename = SM.getFilename(FileLoc);
1270   if (OutDiag.Filename.empty())
1271     return OutDiag;
1272   OutDiag.LocOffset = SM.getFileOffset(FileLoc);
1273   for (const auto &Range : InDiag.getRanges())
1274     OutDiag.Ranges.push_back(makeStandaloneRange(Range, SM, LangOpts));
1275   for (const auto &FixIt : InDiag.getFixIts())
1276     OutDiag.FixIts.push_back(makeStandaloneFixIt(SM, LangOpts, FixIt));
1277 
1278   return OutDiag;
1279 }
1280 
1281 /// Attempt to build or re-use a precompiled preamble when (re-)parsing
1282 /// the source file.
1283 ///
1284 /// This routine will compute the preamble of the main source file. If a
1285 /// non-trivial preamble is found, it will precompile that preamble into a
1286 /// precompiled header so that the precompiled preamble can be used to reduce
1287 /// reparsing time. If a precompiled preamble has already been constructed,
1288 /// this routine will determine if it is still valid and, if so, avoid
1289 /// rebuilding the precompiled preamble.
1290 ///
1291 /// \param AllowRebuild When true (the default), this routine is
1292 /// allowed to rebuild the precompiled preamble if it is found to be
1293 /// out-of-date.
1294 ///
1295 /// \param MaxLines When non-zero, the maximum number of lines that
1296 /// can occur within the preamble.
1297 ///
1298 /// \returns If the precompiled preamble can be used, returns a newly-allocated
1299 /// buffer that should be used in place of the main file when doing so.
1300 /// Otherwise, returns a NULL pointer.
1301 std::unique_ptr<llvm::MemoryBuffer>
1302 ASTUnit::getMainBufferWithPrecompiledPreamble(
1303     std::shared_ptr<PCHContainerOperations> PCHContainerOps,
1304     CompilerInvocation &PreambleInvocationIn,
1305     IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS, bool AllowRebuild,
1306     unsigned MaxLines) {
1307   auto MainFilePath =
1308       PreambleInvocationIn.getFrontendOpts().Inputs[0].getFile();
1309   std::unique_ptr<llvm::MemoryBuffer> MainFileBuffer =
1310       getBufferForFileHandlingRemapping(PreambleInvocationIn, VFS.get(),
1311                                         MainFilePath, UserFilesAreVolatile);
1312   if (!MainFileBuffer)
1313     return nullptr;
1314 
1315   PreambleBounds Bounds =
1316       ComputePreambleBounds(*PreambleInvocationIn.getLangOpts(),
1317                             MainFileBuffer.get(), MaxLines);
1318   if (!Bounds.Size)
1319     return nullptr;
1320 
1321   if (Preamble) {
1322     if (Preamble->CanReuse(PreambleInvocationIn, MainFileBuffer.get(), Bounds,
1323                            VFS.get())) {
1324       // Okay! We can re-use the precompiled preamble.
1325 
1326       // Set the state of the diagnostic object to mimic its state
1327       // after parsing the preamble.
1328       getDiagnostics().Reset();
1329       ProcessWarningOptions(getDiagnostics(),
1330                             PreambleInvocationIn.getDiagnosticOpts());
1331       getDiagnostics().setNumWarnings(NumWarningsInPreamble);
1332 
1333       PreambleRebuildCountdown = 1;
1334       return MainFileBuffer;
1335     } else {
1336       Preamble.reset();
1337       PreambleDiagnostics.clear();
1338       TopLevelDeclsInPreamble.clear();
1339       PreambleSrcLocCache.clear();
1340       PreambleRebuildCountdown = 1;
1341     }
1342   }
1343 
1344   // If the preamble rebuild counter > 1, it's because we previously
1345   // failed to build a preamble and we're not yet ready to try
1346   // again. Decrement the counter and return a failure.
1347   if (PreambleRebuildCountdown > 1) {
1348     --PreambleRebuildCountdown;
1349     return nullptr;
1350   }
1351 
1352   assert(!Preamble && "No Preamble should be stored at that point");
1353   // If we aren't allowed to rebuild the precompiled preamble, just
1354   // return now.
1355   if (!AllowRebuild)
1356     return nullptr;
1357 
1358   ++PreambleCounter;
1359 
1360   SmallVector<StandaloneDiagnostic, 4> NewPreambleDiagsStandalone;
1361   SmallVector<StoredDiagnostic, 4> NewPreambleDiags;
1362   ASTUnitPreambleCallbacks Callbacks;
1363   {
1364     llvm::Optional<CaptureDroppedDiagnostics> Capture;
1365     if (CaptureDiagnostics != CaptureDiagsKind::None)
1366       Capture.emplace(CaptureDiagnostics, *Diagnostics, &NewPreambleDiags,
1367                       &NewPreambleDiagsStandalone);
1368 
1369     // We did not previously compute a preamble, or it can't be reused anyway.
1370     SimpleTimer PreambleTimer(WantTiming);
1371     PreambleTimer.setOutput("Precompiling preamble");
1372 
1373     const bool PreviousSkipFunctionBodies =
1374         PreambleInvocationIn.getFrontendOpts().SkipFunctionBodies;
1375     if (SkipFunctionBodies == SkipFunctionBodiesScope::Preamble)
1376       PreambleInvocationIn.getFrontendOpts().SkipFunctionBodies = true;
1377 
1378     llvm::ErrorOr<PrecompiledPreamble> NewPreamble = PrecompiledPreamble::Build(
1379         PreambleInvocationIn, MainFileBuffer.get(), Bounds, *Diagnostics, VFS,
1380         PCHContainerOps, /*StoreInMemory=*/false, Callbacks);
1381 
1382     PreambleInvocationIn.getFrontendOpts().SkipFunctionBodies =
1383         PreviousSkipFunctionBodies;
1384 
1385     if (NewPreamble) {
1386       Preamble = std::move(*NewPreamble);
1387       PreambleRebuildCountdown = 1;
1388     } else {
1389       switch (static_cast<BuildPreambleError>(NewPreamble.getError().value())) {
1390       case BuildPreambleError::CouldntCreateTempFile:
1391         // Try again next time.
1392         PreambleRebuildCountdown = 1;
1393         return nullptr;
1394       case BuildPreambleError::CouldntCreateTargetInfo:
1395       case BuildPreambleError::BeginSourceFileFailed:
1396       case BuildPreambleError::CouldntEmitPCH:
1397       case BuildPreambleError::BadInputs:
1398         // These erros are more likely to repeat, retry after some period.
1399         PreambleRebuildCountdown = DefaultPreambleRebuildInterval;
1400         return nullptr;
1401       }
1402       llvm_unreachable("unexpected BuildPreambleError");
1403     }
1404   }
1405 
1406   assert(Preamble && "Preamble wasn't built");
1407 
1408   TopLevelDecls.clear();
1409   TopLevelDeclsInPreamble = Callbacks.takeTopLevelDeclIDs();
1410   PreambleTopLevelHashValue = Callbacks.getHash();
1411 
1412   NumWarningsInPreamble = getDiagnostics().getNumWarnings();
1413 
1414   checkAndRemoveNonDriverDiags(NewPreambleDiags);
1415   StoredDiagnostics = std::move(NewPreambleDiags);
1416   PreambleDiagnostics = std::move(NewPreambleDiagsStandalone);
1417 
1418   // If the hash of top-level entities differs from the hash of the top-level
1419   // entities the last time we rebuilt the preamble, clear out the completion
1420   // cache.
1421   if (CurrentTopLevelHashValue != PreambleTopLevelHashValue) {
1422     CompletionCacheTopLevelHashValue = 0;
1423     PreambleTopLevelHashValue = CurrentTopLevelHashValue;
1424   }
1425 
1426   return MainFileBuffer;
1427 }
1428 
1429 void ASTUnit::RealizeTopLevelDeclsFromPreamble() {
1430   assert(Preamble && "Should only be called when preamble was built");
1431 
1432   std::vector<Decl *> Resolved;
1433   Resolved.reserve(TopLevelDeclsInPreamble.size());
1434   ExternalASTSource &Source = *getASTContext().getExternalSource();
1435   for (const auto TopLevelDecl : TopLevelDeclsInPreamble) {
1436     // Resolve the declaration ID to an actual declaration, possibly
1437     // deserializing the declaration in the process.
1438     if (Decl *D = Source.GetExternalDecl(TopLevelDecl))
1439       Resolved.push_back(D);
1440   }
1441   TopLevelDeclsInPreamble.clear();
1442   TopLevelDecls.insert(TopLevelDecls.begin(), Resolved.begin(), Resolved.end());
1443 }
1444 
1445 void ASTUnit::transferASTDataFromCompilerInstance(CompilerInstance &CI) {
1446   // Steal the created target, context, and preprocessor if they have been
1447   // created.
1448   assert(CI.hasInvocation() && "missing invocation");
1449   LangOpts = CI.getInvocation().LangOpts;
1450   TheSema = CI.takeSema();
1451   Consumer = CI.takeASTConsumer();
1452   if (CI.hasASTContext())
1453     Ctx = &CI.getASTContext();
1454   if (CI.hasPreprocessor())
1455     PP = CI.getPreprocessorPtr();
1456   CI.setSourceManager(nullptr);
1457   CI.setFileManager(nullptr);
1458   if (CI.hasTarget())
1459     Target = &CI.getTarget();
1460   Reader = CI.getModuleManager();
1461   HadModuleLoaderFatalFailure = CI.hadModuleLoaderFatalFailure();
1462 }
1463 
1464 StringRef ASTUnit::getMainFileName() const {
1465   if (Invocation && !Invocation->getFrontendOpts().Inputs.empty()) {
1466     const FrontendInputFile &Input = Invocation->getFrontendOpts().Inputs[0];
1467     if (Input.isFile())
1468       return Input.getFile();
1469     else
1470       return Input.getBuffer()->getBufferIdentifier();
1471   }
1472 
1473   if (SourceMgr) {
1474     if (const FileEntry *
1475           FE = SourceMgr->getFileEntryForID(SourceMgr->getMainFileID()))
1476       return FE->getName();
1477   }
1478 
1479   return {};
1480 }
1481 
1482 StringRef ASTUnit::getASTFileName() const {
1483   if (!isMainFileAST())
1484     return {};
1485 
1486   serialization::ModuleFile &
1487     Mod = Reader->getModuleManager().getPrimaryModule();
1488   return Mod.FileName;
1489 }
1490 
1491 std::unique_ptr<ASTUnit>
1492 ASTUnit::create(std::shared_ptr<CompilerInvocation> CI,
1493                 IntrusiveRefCntPtr<DiagnosticsEngine> Diags,
1494                 CaptureDiagsKind CaptureDiagnostics,
1495                 bool UserFilesAreVolatile) {
1496   std::unique_ptr<ASTUnit> AST(new ASTUnit(false));
1497   ConfigureDiags(Diags, *AST, CaptureDiagnostics);
1498   IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS =
1499       createVFSFromCompilerInvocation(*CI, *Diags);
1500   AST->Diagnostics = Diags;
1501   AST->FileSystemOpts = CI->getFileSystemOpts();
1502   AST->Invocation = std::move(CI);
1503   AST->FileMgr = new FileManager(AST->FileSystemOpts, VFS);
1504   AST->UserFilesAreVolatile = UserFilesAreVolatile;
1505   AST->SourceMgr = new SourceManager(AST->getDiagnostics(), *AST->FileMgr,
1506                                      UserFilesAreVolatile);
1507   AST->ModuleCache = new InMemoryModuleCache;
1508 
1509   return AST;
1510 }
1511 
1512 ASTUnit *ASTUnit::LoadFromCompilerInvocationAction(
1513     std::shared_ptr<CompilerInvocation> CI,
1514     std::shared_ptr<PCHContainerOperations> PCHContainerOps,
1515     IntrusiveRefCntPtr<DiagnosticsEngine> Diags, FrontendAction *Action,
1516     ASTUnit *Unit, bool Persistent, StringRef ResourceFilesPath,
1517     bool OnlyLocalDecls, CaptureDiagsKind CaptureDiagnostics,
1518     unsigned PrecompilePreambleAfterNParses, bool CacheCodeCompletionResults,
1519     bool IncludeBriefCommentsInCodeCompletion, bool UserFilesAreVolatile,
1520     std::unique_ptr<ASTUnit> *ErrAST) {
1521   assert(CI && "A CompilerInvocation is required");
1522 
1523   std::unique_ptr<ASTUnit> OwnAST;
1524   ASTUnit *AST = Unit;
1525   if (!AST) {
1526     // Create the AST unit.
1527     OwnAST = create(CI, Diags, CaptureDiagnostics, UserFilesAreVolatile);
1528     AST = OwnAST.get();
1529     if (!AST)
1530       return nullptr;
1531   }
1532 
1533   if (!ResourceFilesPath.empty()) {
1534     // Override the resources path.
1535     CI->getHeaderSearchOpts().ResourceDir = ResourceFilesPath;
1536   }
1537   AST->OnlyLocalDecls = OnlyLocalDecls;
1538   AST->CaptureDiagnostics = CaptureDiagnostics;
1539   if (PrecompilePreambleAfterNParses > 0)
1540     AST->PreambleRebuildCountdown = PrecompilePreambleAfterNParses;
1541   AST->TUKind = Action ? Action->getTranslationUnitKind() : TU_Complete;
1542   AST->ShouldCacheCodeCompletionResults = CacheCodeCompletionResults;
1543   AST->IncludeBriefCommentsInCodeCompletion
1544     = IncludeBriefCommentsInCodeCompletion;
1545 
1546   // Recover resources if we crash before exiting this method.
1547   llvm::CrashRecoveryContextCleanupRegistrar<ASTUnit>
1548     ASTUnitCleanup(OwnAST.get());
1549   llvm::CrashRecoveryContextCleanupRegistrar<DiagnosticsEngine,
1550     llvm::CrashRecoveryContextReleaseRefCleanup<DiagnosticsEngine>>
1551     DiagCleanup(Diags.get());
1552 
1553   // We'll manage file buffers ourselves.
1554   CI->getPreprocessorOpts().RetainRemappedFileBuffers = true;
1555   CI->getFrontendOpts().DisableFree = false;
1556   ProcessWarningOptions(AST->getDiagnostics(), CI->getDiagnosticOpts());
1557 
1558   // Create the compiler instance to use for building the AST.
1559   std::unique_ptr<CompilerInstance> Clang(
1560       new CompilerInstance(std::move(PCHContainerOps)));
1561 
1562   // Recover resources if we crash before exiting this method.
1563   llvm::CrashRecoveryContextCleanupRegistrar<CompilerInstance>
1564     CICleanup(Clang.get());
1565 
1566   Clang->setInvocation(std::move(CI));
1567   AST->OriginalSourceFile = Clang->getFrontendOpts().Inputs[0].getFile();
1568 
1569   // Set up diagnostics, capturing any diagnostics that would
1570   // otherwise be dropped.
1571   Clang->setDiagnostics(&AST->getDiagnostics());
1572 
1573   // Create the target instance.
1574   Clang->setTarget(TargetInfo::CreateTargetInfo(
1575       Clang->getDiagnostics(), Clang->getInvocation().TargetOpts));
1576   if (!Clang->hasTarget())
1577     return nullptr;
1578 
1579   // Inform the target of the language options.
1580   //
1581   // FIXME: We shouldn't need to do this, the target should be immutable once
1582   // created. This complexity should be lifted elsewhere.
1583   Clang->getTarget().adjust(Clang->getLangOpts());
1584 
1585   assert(Clang->getFrontendOpts().Inputs.size() == 1 &&
1586          "Invocation must have exactly one source file!");
1587   assert(Clang->getFrontendOpts().Inputs[0].getKind().getFormat() ==
1588              InputKind::Source &&
1589          "FIXME: AST inputs not yet supported here!");
1590   assert(Clang->getFrontendOpts().Inputs[0].getKind().getLanguage() !=
1591              Language::LLVM_IR &&
1592          "IR inputs not support here!");
1593 
1594   // Configure the various subsystems.
1595   AST->TheSema.reset();
1596   AST->Ctx = nullptr;
1597   AST->PP = nullptr;
1598   AST->Reader = nullptr;
1599 
1600   // Create a file manager object to provide access to and cache the filesystem.
1601   Clang->setFileManager(&AST->getFileManager());
1602 
1603   // Create the source manager.
1604   Clang->setSourceManager(&AST->getSourceManager());
1605 
1606   FrontendAction *Act = Action;
1607 
1608   std::unique_ptr<TopLevelDeclTrackerAction> TrackerAct;
1609   if (!Act) {
1610     TrackerAct.reset(new TopLevelDeclTrackerAction(*AST));
1611     Act = TrackerAct.get();
1612   }
1613 
1614   // Recover resources if we crash before exiting this method.
1615   llvm::CrashRecoveryContextCleanupRegistrar<TopLevelDeclTrackerAction>
1616     ActCleanup(TrackerAct.get());
1617 
1618   if (!Act->BeginSourceFile(*Clang.get(), Clang->getFrontendOpts().Inputs[0])) {
1619     AST->transferASTDataFromCompilerInstance(*Clang);
1620     if (OwnAST && ErrAST)
1621       ErrAST->swap(OwnAST);
1622 
1623     return nullptr;
1624   }
1625 
1626   if (Persistent && !TrackerAct) {
1627     Clang->getPreprocessor().addPPCallbacks(
1628         std::make_unique<MacroDefinitionTrackerPPCallbacks>(
1629                                            AST->getCurrentTopLevelHashValue()));
1630     std::vector<std::unique_ptr<ASTConsumer>> Consumers;
1631     if (Clang->hasASTConsumer())
1632       Consumers.push_back(Clang->takeASTConsumer());
1633     Consumers.push_back(std::make_unique<TopLevelDeclTrackerConsumer>(
1634         *AST, AST->getCurrentTopLevelHashValue()));
1635     Clang->setASTConsumer(
1636         std::make_unique<MultiplexConsumer>(std::move(Consumers)));
1637   }
1638   if (llvm::Error Err = Act->Execute()) {
1639     consumeError(std::move(Err)); // FIXME this drops errors on the floor.
1640     AST->transferASTDataFromCompilerInstance(*Clang);
1641     if (OwnAST && ErrAST)
1642       ErrAST->swap(OwnAST);
1643 
1644     return nullptr;
1645   }
1646 
1647   // Steal the created target, context, and preprocessor.
1648   AST->transferASTDataFromCompilerInstance(*Clang);
1649 
1650   Act->EndSourceFile();
1651 
1652   if (OwnAST)
1653     return OwnAST.release();
1654   else
1655     return AST;
1656 }
1657 
1658 bool ASTUnit::LoadFromCompilerInvocation(
1659     std::shared_ptr<PCHContainerOperations> PCHContainerOps,
1660     unsigned PrecompilePreambleAfterNParses,
1661     IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS) {
1662   if (!Invocation)
1663     return true;
1664 
1665   assert(VFS && "VFS is null");
1666 
1667   // We'll manage file buffers ourselves.
1668   Invocation->getPreprocessorOpts().RetainRemappedFileBuffers = true;
1669   Invocation->getFrontendOpts().DisableFree = false;
1670   getDiagnostics().Reset();
1671   ProcessWarningOptions(getDiagnostics(), Invocation->getDiagnosticOpts());
1672 
1673   std::unique_ptr<llvm::MemoryBuffer> OverrideMainBuffer;
1674   if (PrecompilePreambleAfterNParses > 0) {
1675     PreambleRebuildCountdown = PrecompilePreambleAfterNParses;
1676     OverrideMainBuffer =
1677         getMainBufferWithPrecompiledPreamble(PCHContainerOps, *Invocation, VFS);
1678     getDiagnostics().Reset();
1679     ProcessWarningOptions(getDiagnostics(), Invocation->getDiagnosticOpts());
1680   }
1681 
1682   SimpleTimer ParsingTimer(WantTiming);
1683   ParsingTimer.setOutput("Parsing " + getMainFileName());
1684 
1685   // Recover resources if we crash before exiting this method.
1686   llvm::CrashRecoveryContextCleanupRegistrar<llvm::MemoryBuffer>
1687     MemBufferCleanup(OverrideMainBuffer.get());
1688 
1689   return Parse(std::move(PCHContainerOps), std::move(OverrideMainBuffer), VFS);
1690 }
1691 
1692 std::unique_ptr<ASTUnit> ASTUnit::LoadFromCompilerInvocation(
1693     std::shared_ptr<CompilerInvocation> CI,
1694     std::shared_ptr<PCHContainerOperations> PCHContainerOps,
1695     IntrusiveRefCntPtr<DiagnosticsEngine> Diags, FileManager *FileMgr,
1696     bool OnlyLocalDecls, CaptureDiagsKind CaptureDiagnostics,
1697     unsigned PrecompilePreambleAfterNParses, TranslationUnitKind TUKind,
1698     bool CacheCodeCompletionResults, bool IncludeBriefCommentsInCodeCompletion,
1699     bool UserFilesAreVolatile) {
1700   // Create the AST unit.
1701   std::unique_ptr<ASTUnit> AST(new ASTUnit(false));
1702   ConfigureDiags(Diags, *AST, CaptureDiagnostics);
1703   AST->Diagnostics = Diags;
1704   AST->OnlyLocalDecls = OnlyLocalDecls;
1705   AST->CaptureDiagnostics = CaptureDiagnostics;
1706   AST->TUKind = TUKind;
1707   AST->ShouldCacheCodeCompletionResults = CacheCodeCompletionResults;
1708   AST->IncludeBriefCommentsInCodeCompletion
1709     = IncludeBriefCommentsInCodeCompletion;
1710   AST->Invocation = std::move(CI);
1711   AST->FileSystemOpts = FileMgr->getFileSystemOpts();
1712   AST->FileMgr = FileMgr;
1713   AST->UserFilesAreVolatile = UserFilesAreVolatile;
1714 
1715   // Recover resources if we crash before exiting this method.
1716   llvm::CrashRecoveryContextCleanupRegistrar<ASTUnit>
1717     ASTUnitCleanup(AST.get());
1718   llvm::CrashRecoveryContextCleanupRegistrar<DiagnosticsEngine,
1719     llvm::CrashRecoveryContextReleaseRefCleanup<DiagnosticsEngine>>
1720     DiagCleanup(Diags.get());
1721 
1722   if (AST->LoadFromCompilerInvocation(std::move(PCHContainerOps),
1723                                       PrecompilePreambleAfterNParses,
1724                                       &AST->FileMgr->getVirtualFileSystem()))
1725     return nullptr;
1726   return AST;
1727 }
1728 
1729 ASTUnit *ASTUnit::LoadFromCommandLine(
1730     const char **ArgBegin, const char **ArgEnd,
1731     std::shared_ptr<PCHContainerOperations> PCHContainerOps,
1732     IntrusiveRefCntPtr<DiagnosticsEngine> Diags, StringRef ResourceFilesPath,
1733     bool OnlyLocalDecls, CaptureDiagsKind CaptureDiagnostics,
1734     ArrayRef<RemappedFile> RemappedFiles, bool RemappedFilesKeepOriginalName,
1735     unsigned PrecompilePreambleAfterNParses, TranslationUnitKind TUKind,
1736     bool CacheCodeCompletionResults, bool IncludeBriefCommentsInCodeCompletion,
1737     bool AllowPCHWithCompilerErrors, SkipFunctionBodiesScope SkipFunctionBodies,
1738     bool SingleFileParse, bool UserFilesAreVolatile, bool ForSerialization,
1739     bool RetainExcludedConditionalBlocks,
1740     llvm::Optional<StringRef> ModuleFormat, std::unique_ptr<ASTUnit> *ErrAST,
1741     IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS) {
1742   assert(Diags.get() && "no DiagnosticsEngine was provided");
1743 
1744   SmallVector<StoredDiagnostic, 4> StoredDiagnostics;
1745 
1746   std::shared_ptr<CompilerInvocation> CI;
1747 
1748   {
1749     CaptureDroppedDiagnostics Capture(CaptureDiagnostics, *Diags,
1750                                       &StoredDiagnostics, nullptr);
1751 
1752     CI = createInvocationFromCommandLine(
1753         llvm::makeArrayRef(ArgBegin, ArgEnd), Diags, VFS);
1754     if (!CI)
1755       return nullptr;
1756   }
1757 
1758   // Override any files that need remapping
1759   for (const auto &RemappedFile : RemappedFiles) {
1760     CI->getPreprocessorOpts().addRemappedFile(RemappedFile.first,
1761                                               RemappedFile.second);
1762   }
1763   PreprocessorOptions &PPOpts = CI->getPreprocessorOpts();
1764   PPOpts.RemappedFilesKeepOriginalName = RemappedFilesKeepOriginalName;
1765   PPOpts.AllowPCHWithCompilerErrors = AllowPCHWithCompilerErrors;
1766   PPOpts.SingleFileParseMode = SingleFileParse;
1767   PPOpts.RetainExcludedConditionalBlocks = RetainExcludedConditionalBlocks;
1768 
1769   // Override the resources path.
1770   CI->getHeaderSearchOpts().ResourceDir = ResourceFilesPath;
1771 
1772   CI->getFrontendOpts().SkipFunctionBodies =
1773       SkipFunctionBodies == SkipFunctionBodiesScope::PreambleAndMainFile;
1774 
1775   if (ModuleFormat)
1776     CI->getHeaderSearchOpts().ModuleFormat = ModuleFormat.getValue();
1777 
1778   // Create the AST unit.
1779   std::unique_ptr<ASTUnit> AST;
1780   AST.reset(new ASTUnit(false));
1781   AST->NumStoredDiagnosticsFromDriver = StoredDiagnostics.size();
1782   AST->StoredDiagnostics.swap(StoredDiagnostics);
1783   ConfigureDiags(Diags, *AST, CaptureDiagnostics);
1784   AST->Diagnostics = Diags;
1785   AST->FileSystemOpts = CI->getFileSystemOpts();
1786   if (!VFS)
1787     VFS = llvm::vfs::getRealFileSystem();
1788   VFS = createVFSFromCompilerInvocation(*CI, *Diags, VFS);
1789   AST->FileMgr = new FileManager(AST->FileSystemOpts, VFS);
1790   AST->ModuleCache = new InMemoryModuleCache;
1791   AST->OnlyLocalDecls = OnlyLocalDecls;
1792   AST->CaptureDiagnostics = CaptureDiagnostics;
1793   AST->TUKind = TUKind;
1794   AST->ShouldCacheCodeCompletionResults = CacheCodeCompletionResults;
1795   AST->IncludeBriefCommentsInCodeCompletion
1796     = IncludeBriefCommentsInCodeCompletion;
1797   AST->UserFilesAreVolatile = UserFilesAreVolatile;
1798   AST->Invocation = CI;
1799   AST->SkipFunctionBodies = SkipFunctionBodies;
1800   if (ForSerialization)
1801     AST->WriterData.reset(new ASTWriterData(*AST->ModuleCache));
1802   // Zero out now to ease cleanup during crash recovery.
1803   CI = nullptr;
1804   Diags = nullptr;
1805 
1806   // Recover resources if we crash before exiting this method.
1807   llvm::CrashRecoveryContextCleanupRegistrar<ASTUnit>
1808     ASTUnitCleanup(AST.get());
1809 
1810   if (AST->LoadFromCompilerInvocation(std::move(PCHContainerOps),
1811                                       PrecompilePreambleAfterNParses,
1812                                       VFS)) {
1813     // Some error occurred, if caller wants to examine diagnostics, pass it the
1814     // ASTUnit.
1815     if (ErrAST) {
1816       AST->StoredDiagnostics.swap(AST->FailedParseDiagnostics);
1817       ErrAST->swap(AST);
1818     }
1819     return nullptr;
1820   }
1821 
1822   return AST.release();
1823 }
1824 
1825 bool ASTUnit::Reparse(std::shared_ptr<PCHContainerOperations> PCHContainerOps,
1826                       ArrayRef<RemappedFile> RemappedFiles,
1827                       IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS) {
1828   if (!Invocation)
1829     return true;
1830 
1831   if (!VFS) {
1832     assert(FileMgr && "FileMgr is null on Reparse call");
1833     VFS = &FileMgr->getVirtualFileSystem();
1834   }
1835 
1836   clearFileLevelDecls();
1837 
1838   SimpleTimer ParsingTimer(WantTiming);
1839   ParsingTimer.setOutput("Reparsing " + getMainFileName());
1840 
1841   // Remap files.
1842   PreprocessorOptions &PPOpts = Invocation->getPreprocessorOpts();
1843   for (const auto &RB : PPOpts.RemappedFileBuffers)
1844     delete RB.second;
1845 
1846   Invocation->getPreprocessorOpts().clearRemappedFiles();
1847   for (const auto &RemappedFile : RemappedFiles) {
1848     Invocation->getPreprocessorOpts().addRemappedFile(RemappedFile.first,
1849                                                       RemappedFile.second);
1850   }
1851 
1852   // If we have a preamble file lying around, or if we might try to
1853   // build a precompiled preamble, do so now.
1854   std::unique_ptr<llvm::MemoryBuffer> OverrideMainBuffer;
1855   if (Preamble || PreambleRebuildCountdown > 0)
1856     OverrideMainBuffer =
1857         getMainBufferWithPrecompiledPreamble(PCHContainerOps, *Invocation, VFS);
1858 
1859   // Clear out the diagnostics state.
1860   FileMgr.reset();
1861   getDiagnostics().Reset();
1862   ProcessWarningOptions(getDiagnostics(), Invocation->getDiagnosticOpts());
1863   if (OverrideMainBuffer)
1864     getDiagnostics().setNumWarnings(NumWarningsInPreamble);
1865 
1866   // Parse the sources
1867   bool Result =
1868       Parse(std::move(PCHContainerOps), std::move(OverrideMainBuffer), VFS);
1869 
1870   // If we're caching global code-completion results, and the top-level
1871   // declarations have changed, clear out the code-completion cache.
1872   if (!Result && ShouldCacheCodeCompletionResults &&
1873       CurrentTopLevelHashValue != CompletionCacheTopLevelHashValue)
1874     CacheCodeCompletionResults();
1875 
1876   // We now need to clear out the completion info related to this translation
1877   // unit; it'll be recreated if necessary.
1878   CCTUInfo.reset();
1879 
1880   return Result;
1881 }
1882 
1883 void ASTUnit::ResetForParse() {
1884   SavedMainFileBuffer.reset();
1885 
1886   SourceMgr.reset();
1887   TheSema.reset();
1888   Ctx.reset();
1889   PP.reset();
1890   Reader.reset();
1891 
1892   TopLevelDecls.clear();
1893   clearFileLevelDecls();
1894 }
1895 
1896 //----------------------------------------------------------------------------//
1897 // Code completion
1898 //----------------------------------------------------------------------------//
1899 
1900 namespace {
1901 
1902   /// Code completion consumer that combines the cached code-completion
1903   /// results from an ASTUnit with the code-completion results provided to it,
1904   /// then passes the result on to
1905   class AugmentedCodeCompleteConsumer : public CodeCompleteConsumer {
1906     uint64_t NormalContexts;
1907     ASTUnit &AST;
1908     CodeCompleteConsumer &Next;
1909 
1910   public:
1911     AugmentedCodeCompleteConsumer(ASTUnit &AST, CodeCompleteConsumer &Next,
1912                                   const CodeCompleteOptions &CodeCompleteOpts)
1913         : CodeCompleteConsumer(CodeCompleteOpts), AST(AST), Next(Next) {
1914       // Compute the set of contexts in which we will look when we don't have
1915       // any information about the specific context.
1916       NormalContexts
1917         = (1LL << CodeCompletionContext::CCC_TopLevel)
1918         | (1LL << CodeCompletionContext::CCC_ObjCInterface)
1919         | (1LL << CodeCompletionContext::CCC_ObjCImplementation)
1920         | (1LL << CodeCompletionContext::CCC_ObjCIvarList)
1921         | (1LL << CodeCompletionContext::CCC_Statement)
1922         | (1LL << CodeCompletionContext::CCC_Expression)
1923         | (1LL << CodeCompletionContext::CCC_ObjCMessageReceiver)
1924         | (1LL << CodeCompletionContext::CCC_DotMemberAccess)
1925         | (1LL << CodeCompletionContext::CCC_ArrowMemberAccess)
1926         | (1LL << CodeCompletionContext::CCC_ObjCPropertyAccess)
1927         | (1LL << CodeCompletionContext::CCC_ObjCProtocolName)
1928         | (1LL << CodeCompletionContext::CCC_ParenthesizedExpression)
1929         | (1LL << CodeCompletionContext::CCC_Recovery);
1930 
1931       if (AST.getASTContext().getLangOpts().CPlusPlus)
1932         NormalContexts |= (1LL << CodeCompletionContext::CCC_EnumTag)
1933                        |  (1LL << CodeCompletionContext::CCC_UnionTag)
1934                        |  (1LL << CodeCompletionContext::CCC_ClassOrStructTag);
1935     }
1936 
1937     void ProcessCodeCompleteResults(Sema &S, CodeCompletionContext Context,
1938                                     CodeCompletionResult *Results,
1939                                     unsigned NumResults) override;
1940 
1941     void ProcessOverloadCandidates(Sema &S, unsigned CurrentArg,
1942                                    OverloadCandidate *Candidates,
1943                                    unsigned NumCandidates,
1944                                    SourceLocation OpenParLoc) override {
1945       Next.ProcessOverloadCandidates(S, CurrentArg, Candidates, NumCandidates,
1946                                      OpenParLoc);
1947     }
1948 
1949     CodeCompletionAllocator &getAllocator() override {
1950       return Next.getAllocator();
1951     }
1952 
1953     CodeCompletionTUInfo &getCodeCompletionTUInfo() override {
1954       return Next.getCodeCompletionTUInfo();
1955     }
1956   };
1957 
1958 } // namespace
1959 
1960 /// Helper function that computes which global names are hidden by the
1961 /// local code-completion results.
1962 static void CalculateHiddenNames(const CodeCompletionContext &Context,
1963                                  CodeCompletionResult *Results,
1964                                  unsigned NumResults,
1965                                  ASTContext &Ctx,
1966                           llvm::StringSet<llvm::BumpPtrAllocator> &HiddenNames){
1967   bool OnlyTagNames = false;
1968   switch (Context.getKind()) {
1969   case CodeCompletionContext::CCC_Recovery:
1970   case CodeCompletionContext::CCC_TopLevel:
1971   case CodeCompletionContext::CCC_ObjCInterface:
1972   case CodeCompletionContext::CCC_ObjCImplementation:
1973   case CodeCompletionContext::CCC_ObjCIvarList:
1974   case CodeCompletionContext::CCC_ClassStructUnion:
1975   case CodeCompletionContext::CCC_Statement:
1976   case CodeCompletionContext::CCC_Expression:
1977   case CodeCompletionContext::CCC_ObjCMessageReceiver:
1978   case CodeCompletionContext::CCC_DotMemberAccess:
1979   case CodeCompletionContext::CCC_ArrowMemberAccess:
1980   case CodeCompletionContext::CCC_ObjCPropertyAccess:
1981   case CodeCompletionContext::CCC_Namespace:
1982   case CodeCompletionContext::CCC_Type:
1983   case CodeCompletionContext::CCC_Symbol:
1984   case CodeCompletionContext::CCC_SymbolOrNewName:
1985   case CodeCompletionContext::CCC_ParenthesizedExpression:
1986   case CodeCompletionContext::CCC_ObjCInterfaceName:
1987     break;
1988 
1989   case CodeCompletionContext::CCC_EnumTag:
1990   case CodeCompletionContext::CCC_UnionTag:
1991   case CodeCompletionContext::CCC_ClassOrStructTag:
1992     OnlyTagNames = true;
1993     break;
1994 
1995   case CodeCompletionContext::CCC_ObjCProtocolName:
1996   case CodeCompletionContext::CCC_MacroName:
1997   case CodeCompletionContext::CCC_MacroNameUse:
1998   case CodeCompletionContext::CCC_PreprocessorExpression:
1999   case CodeCompletionContext::CCC_PreprocessorDirective:
2000   case CodeCompletionContext::CCC_NaturalLanguage:
2001   case CodeCompletionContext::CCC_SelectorName:
2002   case CodeCompletionContext::CCC_TypeQualifiers:
2003   case CodeCompletionContext::CCC_Other:
2004   case CodeCompletionContext::CCC_OtherWithMacros:
2005   case CodeCompletionContext::CCC_ObjCInstanceMessage:
2006   case CodeCompletionContext::CCC_ObjCClassMessage:
2007   case CodeCompletionContext::CCC_ObjCCategoryName:
2008   case CodeCompletionContext::CCC_IncludedFile:
2009   case CodeCompletionContext::CCC_NewName:
2010     // We're looking for nothing, or we're looking for names that cannot
2011     // be hidden.
2012     return;
2013   }
2014 
2015   using Result = CodeCompletionResult;
2016   for (unsigned I = 0; I != NumResults; ++I) {
2017     if (Results[I].Kind != Result::RK_Declaration)
2018       continue;
2019 
2020     unsigned IDNS
2021       = Results[I].Declaration->getUnderlyingDecl()->getIdentifierNamespace();
2022 
2023     bool Hiding = false;
2024     if (OnlyTagNames)
2025       Hiding = (IDNS & Decl::IDNS_Tag);
2026     else {
2027       unsigned HiddenIDNS = (Decl::IDNS_Type | Decl::IDNS_Member |
2028                              Decl::IDNS_Namespace | Decl::IDNS_Ordinary |
2029                              Decl::IDNS_NonMemberOperator);
2030       if (Ctx.getLangOpts().CPlusPlus)
2031         HiddenIDNS |= Decl::IDNS_Tag;
2032       Hiding = (IDNS & HiddenIDNS);
2033     }
2034 
2035     if (!Hiding)
2036       continue;
2037 
2038     DeclarationName Name = Results[I].Declaration->getDeclName();
2039     if (IdentifierInfo *Identifier = Name.getAsIdentifierInfo())
2040       HiddenNames.insert(Identifier->getName());
2041     else
2042       HiddenNames.insert(Name.getAsString());
2043   }
2044 }
2045 
2046 void AugmentedCodeCompleteConsumer::ProcessCodeCompleteResults(Sema &S,
2047                                             CodeCompletionContext Context,
2048                                             CodeCompletionResult *Results,
2049                                             unsigned NumResults) {
2050   // Merge the results we were given with the results we cached.
2051   bool AddedResult = false;
2052   uint64_t InContexts =
2053       Context.getKind() == CodeCompletionContext::CCC_Recovery
2054         ? NormalContexts : (1LL << Context.getKind());
2055   // Contains the set of names that are hidden by "local" completion results.
2056   llvm::StringSet<llvm::BumpPtrAllocator> HiddenNames;
2057   using Result = CodeCompletionResult;
2058   SmallVector<Result, 8> AllResults;
2059   for (ASTUnit::cached_completion_iterator
2060             C = AST.cached_completion_begin(),
2061          CEnd = AST.cached_completion_end();
2062        C != CEnd; ++C) {
2063     // If the context we are in matches any of the contexts we are
2064     // interested in, we'll add this result.
2065     if ((C->ShowInContexts & InContexts) == 0)
2066       continue;
2067 
2068     // If we haven't added any results previously, do so now.
2069     if (!AddedResult) {
2070       CalculateHiddenNames(Context, Results, NumResults, S.Context,
2071                            HiddenNames);
2072       AllResults.insert(AllResults.end(), Results, Results + NumResults);
2073       AddedResult = true;
2074     }
2075 
2076     // Determine whether this global completion result is hidden by a local
2077     // completion result. If so, skip it.
2078     if (C->Kind != CXCursor_MacroDefinition &&
2079         HiddenNames.count(C->Completion->getTypedText()))
2080       continue;
2081 
2082     // Adjust priority based on similar type classes.
2083     unsigned Priority = C->Priority;
2084     CodeCompletionString *Completion = C->Completion;
2085     if (!Context.getPreferredType().isNull()) {
2086       if (C->Kind == CXCursor_MacroDefinition) {
2087         Priority = getMacroUsagePriority(C->Completion->getTypedText(),
2088                                          S.getLangOpts(),
2089                                Context.getPreferredType()->isAnyPointerType());
2090       } else if (C->Type) {
2091         CanQualType Expected
2092           = S.Context.getCanonicalType(
2093                                Context.getPreferredType().getUnqualifiedType());
2094         SimplifiedTypeClass ExpectedSTC = getSimplifiedTypeClass(Expected);
2095         if (ExpectedSTC == C->TypeClass) {
2096           // We know this type is similar; check for an exact match.
2097           llvm::StringMap<unsigned> &CachedCompletionTypes
2098             = AST.getCachedCompletionTypes();
2099           llvm::StringMap<unsigned>::iterator Pos
2100             = CachedCompletionTypes.find(QualType(Expected).getAsString());
2101           if (Pos != CachedCompletionTypes.end() && Pos->second == C->Type)
2102             Priority /= CCF_ExactTypeMatch;
2103           else
2104             Priority /= CCF_SimilarTypeMatch;
2105         }
2106       }
2107     }
2108 
2109     // Adjust the completion string, if required.
2110     if (C->Kind == CXCursor_MacroDefinition &&
2111         Context.getKind() == CodeCompletionContext::CCC_MacroNameUse) {
2112       // Create a new code-completion string that just contains the
2113       // macro name, without its arguments.
2114       CodeCompletionBuilder Builder(getAllocator(), getCodeCompletionTUInfo(),
2115                                     CCP_CodePattern, C->Availability);
2116       Builder.AddTypedTextChunk(C->Completion->getTypedText());
2117       Priority = CCP_CodePattern;
2118       Completion = Builder.TakeString();
2119     }
2120 
2121     AllResults.push_back(Result(Completion, Priority, C->Kind,
2122                                 C->Availability));
2123   }
2124 
2125   // If we did not add any cached completion results, just forward the
2126   // results we were given to the next consumer.
2127   if (!AddedResult) {
2128     Next.ProcessCodeCompleteResults(S, Context, Results, NumResults);
2129     return;
2130   }
2131 
2132   Next.ProcessCodeCompleteResults(S, Context, AllResults.data(),
2133                                   AllResults.size());
2134 }
2135 
2136 void ASTUnit::CodeComplete(
2137     StringRef File, unsigned Line, unsigned Column,
2138     ArrayRef<RemappedFile> RemappedFiles, bool IncludeMacros,
2139     bool IncludeCodePatterns, bool IncludeBriefComments,
2140     CodeCompleteConsumer &Consumer,
2141     std::shared_ptr<PCHContainerOperations> PCHContainerOps,
2142     DiagnosticsEngine &Diag, LangOptions &LangOpts, SourceManager &SourceMgr,
2143     FileManager &FileMgr, SmallVectorImpl<StoredDiagnostic> &StoredDiagnostics,
2144     SmallVectorImpl<const llvm::MemoryBuffer *> &OwnedBuffers) {
2145   if (!Invocation)
2146     return;
2147 
2148   SimpleTimer CompletionTimer(WantTiming);
2149   CompletionTimer.setOutput("Code completion @ " + File + ":" +
2150                             Twine(Line) + ":" + Twine(Column));
2151 
2152   auto CCInvocation = std::make_shared<CompilerInvocation>(*Invocation);
2153 
2154   FrontendOptions &FrontendOpts = CCInvocation->getFrontendOpts();
2155   CodeCompleteOptions &CodeCompleteOpts = FrontendOpts.CodeCompleteOpts;
2156   PreprocessorOptions &PreprocessorOpts = CCInvocation->getPreprocessorOpts();
2157 
2158   CodeCompleteOpts.IncludeMacros = IncludeMacros &&
2159                                    CachedCompletionResults.empty();
2160   CodeCompleteOpts.IncludeCodePatterns = IncludeCodePatterns;
2161   CodeCompleteOpts.IncludeGlobals = CachedCompletionResults.empty();
2162   CodeCompleteOpts.IncludeBriefComments = IncludeBriefComments;
2163   CodeCompleteOpts.LoadExternal = Consumer.loadExternal();
2164   CodeCompleteOpts.IncludeFixIts = Consumer.includeFixIts();
2165 
2166   assert(IncludeBriefComments == this->IncludeBriefCommentsInCodeCompletion);
2167 
2168   FrontendOpts.CodeCompletionAt.FileName = File;
2169   FrontendOpts.CodeCompletionAt.Line = Line;
2170   FrontendOpts.CodeCompletionAt.Column = Column;
2171 
2172   // Set the language options appropriately.
2173   LangOpts = *CCInvocation->getLangOpts();
2174 
2175   // Spell-checking and warnings are wasteful during code-completion.
2176   LangOpts.SpellChecking = false;
2177   CCInvocation->getDiagnosticOpts().IgnoreWarnings = true;
2178 
2179   std::unique_ptr<CompilerInstance> Clang(
2180       new CompilerInstance(PCHContainerOps));
2181 
2182   // Recover resources if we crash before exiting this method.
2183   llvm::CrashRecoveryContextCleanupRegistrar<CompilerInstance>
2184     CICleanup(Clang.get());
2185 
2186   auto &Inv = *CCInvocation;
2187   Clang->setInvocation(std::move(CCInvocation));
2188   OriginalSourceFile = Clang->getFrontendOpts().Inputs[0].getFile();
2189 
2190   // Set up diagnostics, capturing any diagnostics produced.
2191   Clang->setDiagnostics(&Diag);
2192   CaptureDroppedDiagnostics Capture(CaptureDiagsKind::All,
2193                                     Clang->getDiagnostics(),
2194                                     &StoredDiagnostics, nullptr);
2195   ProcessWarningOptions(Diag, Inv.getDiagnosticOpts());
2196 
2197   // Create the target instance.
2198   Clang->setTarget(TargetInfo::CreateTargetInfo(
2199       Clang->getDiagnostics(), Clang->getInvocation().TargetOpts));
2200   if (!Clang->hasTarget()) {
2201     Clang->setInvocation(nullptr);
2202     return;
2203   }
2204 
2205   // Inform the target of the language options.
2206   //
2207   // FIXME: We shouldn't need to do this, the target should be immutable once
2208   // created. This complexity should be lifted elsewhere.
2209   Clang->getTarget().adjust(Clang->getLangOpts());
2210 
2211   assert(Clang->getFrontendOpts().Inputs.size() == 1 &&
2212          "Invocation must have exactly one source file!");
2213   assert(Clang->getFrontendOpts().Inputs[0].getKind().getFormat() ==
2214              InputKind::Source &&
2215          "FIXME: AST inputs not yet supported here!");
2216   assert(Clang->getFrontendOpts().Inputs[0].getKind().getLanguage() !=
2217              Language::LLVM_IR &&
2218          "IR inputs not support here!");
2219 
2220   // Use the source and file managers that we were given.
2221   Clang->setFileManager(&FileMgr);
2222   Clang->setSourceManager(&SourceMgr);
2223 
2224   // Remap files.
2225   PreprocessorOpts.clearRemappedFiles();
2226   PreprocessorOpts.RetainRemappedFileBuffers = true;
2227   for (const auto &RemappedFile : RemappedFiles) {
2228     PreprocessorOpts.addRemappedFile(RemappedFile.first, RemappedFile.second);
2229     OwnedBuffers.push_back(RemappedFile.second);
2230   }
2231 
2232   // Use the code completion consumer we were given, but adding any cached
2233   // code-completion results.
2234   AugmentedCodeCompleteConsumer *AugmentedConsumer
2235     = new AugmentedCodeCompleteConsumer(*this, Consumer, CodeCompleteOpts);
2236   Clang->setCodeCompletionConsumer(AugmentedConsumer);
2237 
2238   // If we have a precompiled preamble, try to use it. We only allow
2239   // the use of the precompiled preamble if we're if the completion
2240   // point is within the main file, after the end of the precompiled
2241   // preamble.
2242   std::unique_ptr<llvm::MemoryBuffer> OverrideMainBuffer;
2243   if (Preamble) {
2244     std::string CompleteFilePath(File);
2245 
2246     auto &VFS = FileMgr.getVirtualFileSystem();
2247     auto CompleteFileStatus = VFS.status(CompleteFilePath);
2248     if (CompleteFileStatus) {
2249       llvm::sys::fs::UniqueID CompleteFileID = CompleteFileStatus->getUniqueID();
2250 
2251       std::string MainPath(OriginalSourceFile);
2252       auto MainStatus = VFS.status(MainPath);
2253       if (MainStatus) {
2254         llvm::sys::fs::UniqueID MainID = MainStatus->getUniqueID();
2255         if (CompleteFileID == MainID && Line > 1)
2256           OverrideMainBuffer = getMainBufferWithPrecompiledPreamble(
2257               PCHContainerOps, Inv, &VFS, false, Line - 1);
2258       }
2259     }
2260   }
2261 
2262   // If the main file has been overridden due to the use of a preamble,
2263   // make that override happen and introduce the preamble.
2264   if (OverrideMainBuffer) {
2265     assert(Preamble &&
2266            "No preamble was built, but OverrideMainBuffer is not null");
2267 
2268     IntrusiveRefCntPtr<llvm::vfs::FileSystem> VFS =
2269         &FileMgr.getVirtualFileSystem();
2270     Preamble->AddImplicitPreamble(Clang->getInvocation(), VFS,
2271                                   OverrideMainBuffer.get());
2272     // FIXME: there is no way to update VFS if it was changed by
2273     // AddImplicitPreamble as FileMgr is accepted as a parameter by this method.
2274     // We use on-disk preambles instead and rely on FileMgr's VFS to ensure the
2275     // PCH files are always readable.
2276     OwnedBuffers.push_back(OverrideMainBuffer.release());
2277   } else {
2278     PreprocessorOpts.PrecompiledPreambleBytes.first = 0;
2279     PreprocessorOpts.PrecompiledPreambleBytes.second = false;
2280   }
2281 
2282   // Disable the preprocessing record if modules are not enabled.
2283   if (!Clang->getLangOpts().Modules)
2284     PreprocessorOpts.DetailedRecord = false;
2285 
2286   std::unique_ptr<SyntaxOnlyAction> Act;
2287   Act.reset(new SyntaxOnlyAction);
2288   if (Act->BeginSourceFile(*Clang.get(), Clang->getFrontendOpts().Inputs[0])) {
2289     if (llvm::Error Err = Act->Execute()) {
2290       consumeError(std::move(Err)); // FIXME this drops errors on the floor.
2291     }
2292     Act->EndSourceFile();
2293   }
2294 }
2295 
2296 bool ASTUnit::Save(StringRef File) {
2297   if (HadModuleLoaderFatalFailure)
2298     return true;
2299 
2300   // Write to a temporary file and later rename it to the actual file, to avoid
2301   // possible race conditions.
2302   SmallString<128> TempPath;
2303   TempPath = File;
2304   TempPath += "-%%%%%%%%";
2305   // FIXME: Can we somehow regenerate the stat cache here, or do we need to
2306   // unconditionally create a stat cache when we parse the file?
2307 
2308   if (llvm::Error Err = llvm::writeFileAtomically(
2309           TempPath, File, [this](llvm::raw_ostream &Out) {
2310             return serialize(Out) ? llvm::make_error<llvm::StringError>(
2311                                         "ASTUnit serialization failed",
2312                                         llvm::inconvertibleErrorCode())
2313                                   : llvm::Error::success();
2314           })) {
2315     consumeError(std::move(Err));
2316     return true;
2317   }
2318   return false;
2319 }
2320 
2321 static bool serializeUnit(ASTWriter &Writer,
2322                           SmallVectorImpl<char> &Buffer,
2323                           Sema &S,
2324                           bool hasErrors,
2325                           raw_ostream &OS) {
2326   Writer.WriteAST(S, std::string(), nullptr, "", hasErrors);
2327 
2328   // Write the generated bitstream to "Out".
2329   if (!Buffer.empty())
2330     OS.write(Buffer.data(), Buffer.size());
2331 
2332   return false;
2333 }
2334 
2335 bool ASTUnit::serialize(raw_ostream &OS) {
2336   // For serialization we are lenient if the errors were only warn-as-error kind.
2337   bool hasErrors = getDiagnostics().hasUncompilableErrorOccurred();
2338 
2339   if (WriterData)
2340     return serializeUnit(WriterData->Writer, WriterData->Buffer,
2341                          getSema(), hasErrors, OS);
2342 
2343   SmallString<128> Buffer;
2344   llvm::BitstreamWriter Stream(Buffer);
2345   InMemoryModuleCache ModuleCache;
2346   ASTWriter Writer(Stream, Buffer, ModuleCache, {});
2347   return serializeUnit(Writer, Buffer, getSema(), hasErrors, OS);
2348 }
2349 
2350 using SLocRemap = ContinuousRangeMap<unsigned, int, 2>;
2351 
2352 void ASTUnit::TranslateStoredDiagnostics(
2353                           FileManager &FileMgr,
2354                           SourceManager &SrcMgr,
2355                           const SmallVectorImpl<StandaloneDiagnostic> &Diags,
2356                           SmallVectorImpl<StoredDiagnostic> &Out) {
2357   // Map the standalone diagnostic into the new source manager. We also need to
2358   // remap all the locations to the new view. This includes the diag location,
2359   // any associated source ranges, and the source ranges of associated fix-its.
2360   // FIXME: There should be a cleaner way to do this.
2361   SmallVector<StoredDiagnostic, 4> Result;
2362   Result.reserve(Diags.size());
2363 
2364   for (const auto &SD : Diags) {
2365     // Rebuild the StoredDiagnostic.
2366     if (SD.Filename.empty())
2367       continue;
2368     auto FE = FileMgr.getFile(SD.Filename);
2369     if (!FE)
2370       continue;
2371     SourceLocation FileLoc;
2372     auto ItFileID = PreambleSrcLocCache.find(SD.Filename);
2373     if (ItFileID == PreambleSrcLocCache.end()) {
2374       FileID FID = SrcMgr.translateFile(*FE);
2375       FileLoc = SrcMgr.getLocForStartOfFile(FID);
2376       PreambleSrcLocCache[SD.Filename] = FileLoc;
2377     } else {
2378       FileLoc = ItFileID->getValue();
2379     }
2380 
2381     if (FileLoc.isInvalid())
2382       continue;
2383     SourceLocation L = FileLoc.getLocWithOffset(SD.LocOffset);
2384     FullSourceLoc Loc(L, SrcMgr);
2385 
2386     SmallVector<CharSourceRange, 4> Ranges;
2387     Ranges.reserve(SD.Ranges.size());
2388     for (const auto &Range : SD.Ranges) {
2389       SourceLocation BL = FileLoc.getLocWithOffset(Range.first);
2390       SourceLocation EL = FileLoc.getLocWithOffset(Range.second);
2391       Ranges.push_back(CharSourceRange::getCharRange(BL, EL));
2392     }
2393 
2394     SmallVector<FixItHint, 2> FixIts;
2395     FixIts.reserve(SD.FixIts.size());
2396     for (const auto &FixIt : SD.FixIts) {
2397       FixIts.push_back(FixItHint());
2398       FixItHint &FH = FixIts.back();
2399       FH.CodeToInsert = FixIt.CodeToInsert;
2400       SourceLocation BL = FileLoc.getLocWithOffset(FixIt.RemoveRange.first);
2401       SourceLocation EL = FileLoc.getLocWithOffset(FixIt.RemoveRange.second);
2402       FH.RemoveRange = CharSourceRange::getCharRange(BL, EL);
2403     }
2404 
2405     Result.push_back(StoredDiagnostic(SD.Level, SD.ID,
2406                                       SD.Message, Loc, Ranges, FixIts));
2407   }
2408   Result.swap(Out);
2409 }
2410 
2411 void ASTUnit::addFileLevelDecl(Decl *D) {
2412   assert(D);
2413 
2414   // We only care about local declarations.
2415   if (D->isFromASTFile())
2416     return;
2417 
2418   SourceManager &SM = *SourceMgr;
2419   SourceLocation Loc = D->getLocation();
2420   if (Loc.isInvalid() || !SM.isLocalSourceLocation(Loc))
2421     return;
2422 
2423   // We only keep track of the file-level declarations of each file.
2424   if (!D->getLexicalDeclContext()->isFileContext())
2425     return;
2426 
2427   SourceLocation FileLoc = SM.getFileLoc(Loc);
2428   assert(SM.isLocalSourceLocation(FileLoc));
2429   FileID FID;
2430   unsigned Offset;
2431   std::tie(FID, Offset) = SM.getDecomposedLoc(FileLoc);
2432   if (FID.isInvalid())
2433     return;
2434 
2435   LocDeclsTy *&Decls = FileDecls[FID];
2436   if (!Decls)
2437     Decls = new LocDeclsTy();
2438 
2439   std::pair<unsigned, Decl *> LocDecl(Offset, D);
2440 
2441   if (Decls->empty() || Decls->back().first <= Offset) {
2442     Decls->push_back(LocDecl);
2443     return;
2444   }
2445 
2446   LocDeclsTy::iterator I =
2447       llvm::upper_bound(*Decls, LocDecl, llvm::less_first());
2448 
2449   Decls->insert(I, LocDecl);
2450 }
2451 
2452 void ASTUnit::findFileRegionDecls(FileID File, unsigned Offset, unsigned Length,
2453                                   SmallVectorImpl<Decl *> &Decls) {
2454   if (File.isInvalid())
2455     return;
2456 
2457   if (SourceMgr->isLoadedFileID(File)) {
2458     assert(Ctx->getExternalSource() && "No external source!");
2459     return Ctx->getExternalSource()->FindFileRegionDecls(File, Offset, Length,
2460                                                          Decls);
2461   }
2462 
2463   FileDeclsTy::iterator I = FileDecls.find(File);
2464   if (I == FileDecls.end())
2465     return;
2466 
2467   LocDeclsTy &LocDecls = *I->second;
2468   if (LocDecls.empty())
2469     return;
2470 
2471   LocDeclsTy::iterator BeginIt =
2472       llvm::partition_point(LocDecls, [=](std::pair<unsigned, Decl *> LD) {
2473         return LD.first < Offset;
2474       });
2475   if (BeginIt != LocDecls.begin())
2476     --BeginIt;
2477 
2478   // If we are pointing at a top-level decl inside an objc container, we need
2479   // to backtrack until we find it otherwise we will fail to report that the
2480   // region overlaps with an objc container.
2481   while (BeginIt != LocDecls.begin() &&
2482          BeginIt->second->isTopLevelDeclInObjCContainer())
2483     --BeginIt;
2484 
2485   LocDeclsTy::iterator EndIt = llvm::upper_bound(
2486       LocDecls, std::make_pair(Offset + Length, (Decl *)nullptr),
2487       llvm::less_first());
2488   if (EndIt != LocDecls.end())
2489     ++EndIt;
2490 
2491   for (LocDeclsTy::iterator DIt = BeginIt; DIt != EndIt; ++DIt)
2492     Decls.push_back(DIt->second);
2493 }
2494 
2495 SourceLocation ASTUnit::getLocation(const FileEntry *File,
2496                                     unsigned Line, unsigned Col) const {
2497   const SourceManager &SM = getSourceManager();
2498   SourceLocation Loc = SM.translateFileLineCol(File, Line, Col);
2499   return SM.getMacroArgExpandedLocation(Loc);
2500 }
2501 
2502 SourceLocation ASTUnit::getLocation(const FileEntry *File,
2503                                     unsigned Offset) const {
2504   const SourceManager &SM = getSourceManager();
2505   SourceLocation FileLoc = SM.translateFileLineCol(File, 1, 1);
2506   return SM.getMacroArgExpandedLocation(FileLoc.getLocWithOffset(Offset));
2507 }
2508 
2509 /// If \arg Loc is a loaded location from the preamble, returns
2510 /// the corresponding local location of the main file, otherwise it returns
2511 /// \arg Loc.
2512 SourceLocation ASTUnit::mapLocationFromPreamble(SourceLocation Loc) const {
2513   FileID PreambleID;
2514   if (SourceMgr)
2515     PreambleID = SourceMgr->getPreambleFileID();
2516 
2517   if (Loc.isInvalid() || !Preamble || PreambleID.isInvalid())
2518     return Loc;
2519 
2520   unsigned Offs;
2521   if (SourceMgr->isInFileID(Loc, PreambleID, &Offs) && Offs < Preamble->getBounds().Size) {
2522     SourceLocation FileLoc
2523         = SourceMgr->getLocForStartOfFile(SourceMgr->getMainFileID());
2524     return FileLoc.getLocWithOffset(Offs);
2525   }
2526 
2527   return Loc;
2528 }
2529 
2530 /// If \arg Loc is a local location of the main file but inside the
2531 /// preamble chunk, returns the corresponding loaded location from the
2532 /// preamble, otherwise it returns \arg Loc.
2533 SourceLocation ASTUnit::mapLocationToPreamble(SourceLocation Loc) const {
2534   FileID PreambleID;
2535   if (SourceMgr)
2536     PreambleID = SourceMgr->getPreambleFileID();
2537 
2538   if (Loc.isInvalid() || !Preamble || PreambleID.isInvalid())
2539     return Loc;
2540 
2541   unsigned Offs;
2542   if (SourceMgr->isInFileID(Loc, SourceMgr->getMainFileID(), &Offs) &&
2543       Offs < Preamble->getBounds().Size) {
2544     SourceLocation FileLoc = SourceMgr->getLocForStartOfFile(PreambleID);
2545     return FileLoc.getLocWithOffset(Offs);
2546   }
2547 
2548   return Loc;
2549 }
2550 
2551 bool ASTUnit::isInPreambleFileID(SourceLocation Loc) const {
2552   FileID FID;
2553   if (SourceMgr)
2554     FID = SourceMgr->getPreambleFileID();
2555 
2556   if (Loc.isInvalid() || FID.isInvalid())
2557     return false;
2558 
2559   return SourceMgr->isInFileID(Loc, FID);
2560 }
2561 
2562 bool ASTUnit::isInMainFileID(SourceLocation Loc) const {
2563   FileID FID;
2564   if (SourceMgr)
2565     FID = SourceMgr->getMainFileID();
2566 
2567   if (Loc.isInvalid() || FID.isInvalid())
2568     return false;
2569 
2570   return SourceMgr->isInFileID(Loc, FID);
2571 }
2572 
2573 SourceLocation ASTUnit::getEndOfPreambleFileID() const {
2574   FileID FID;
2575   if (SourceMgr)
2576     FID = SourceMgr->getPreambleFileID();
2577 
2578   if (FID.isInvalid())
2579     return {};
2580 
2581   return SourceMgr->getLocForEndOfFile(FID);
2582 }
2583 
2584 SourceLocation ASTUnit::getStartOfMainFileID() const {
2585   FileID FID;
2586   if (SourceMgr)
2587     FID = SourceMgr->getMainFileID();
2588 
2589   if (FID.isInvalid())
2590     return {};
2591 
2592   return SourceMgr->getLocForStartOfFile(FID);
2593 }
2594 
2595 llvm::iterator_range<PreprocessingRecord::iterator>
2596 ASTUnit::getLocalPreprocessingEntities() const {
2597   if (isMainFileAST()) {
2598     serialization::ModuleFile &
2599       Mod = Reader->getModuleManager().getPrimaryModule();
2600     return Reader->getModulePreprocessedEntities(Mod);
2601   }
2602 
2603   if (PreprocessingRecord *PPRec = PP->getPreprocessingRecord())
2604     return llvm::make_range(PPRec->local_begin(), PPRec->local_end());
2605 
2606   return llvm::make_range(PreprocessingRecord::iterator(),
2607                           PreprocessingRecord::iterator());
2608 }
2609 
2610 bool ASTUnit::visitLocalTopLevelDecls(void *context, DeclVisitorFn Fn) {
2611   if (isMainFileAST()) {
2612     serialization::ModuleFile &
2613       Mod = Reader->getModuleManager().getPrimaryModule();
2614     for (const auto *D : Reader->getModuleFileLevelDecls(Mod)) {
2615       if (!Fn(context, D))
2616         return false;
2617     }
2618 
2619     return true;
2620   }
2621 
2622   for (ASTUnit::top_level_iterator TL = top_level_begin(),
2623                                 TLEnd = top_level_end();
2624          TL != TLEnd; ++TL) {
2625     if (!Fn(context, *TL))
2626       return false;
2627   }
2628 
2629   return true;
2630 }
2631 
2632 const FileEntry *ASTUnit::getPCHFile() {
2633   if (!Reader)
2634     return nullptr;
2635 
2636   serialization::ModuleFile *Mod = nullptr;
2637   Reader->getModuleManager().visit([&Mod](serialization::ModuleFile &M) {
2638     switch (M.Kind) {
2639     case serialization::MK_ImplicitModule:
2640     case serialization::MK_ExplicitModule:
2641     case serialization::MK_PrebuiltModule:
2642       return true; // skip dependencies.
2643     case serialization::MK_PCH:
2644       Mod = &M;
2645       return true; // found it.
2646     case serialization::MK_Preamble:
2647       return false; // look in dependencies.
2648     case serialization::MK_MainFile:
2649       return false; // look in dependencies.
2650     }
2651 
2652     return true;
2653   });
2654   if (Mod)
2655     return Mod->File;
2656 
2657   return nullptr;
2658 }
2659 
2660 bool ASTUnit::isModuleFile() const {
2661   return isMainFileAST() && getLangOpts().isCompilingModule();
2662 }
2663 
2664 InputKind ASTUnit::getInputKind() const {
2665   auto &LangOpts = getLangOpts();
2666 
2667   Language Lang;
2668   if (LangOpts.OpenCL)
2669     Lang = Language::OpenCL;
2670   else if (LangOpts.CUDA)
2671     Lang = Language::CUDA;
2672   else if (LangOpts.RenderScript)
2673     Lang = Language::RenderScript;
2674   else if (LangOpts.CPlusPlus)
2675     Lang = LangOpts.ObjC ? Language::ObjCXX : Language::CXX;
2676   else
2677     Lang = LangOpts.ObjC ? Language::ObjC : Language::C;
2678 
2679   InputKind::Format Fmt = InputKind::Source;
2680   if (LangOpts.getCompilingModule() == LangOptions::CMK_ModuleMap)
2681     Fmt = InputKind::ModuleMap;
2682 
2683   // We don't know if input was preprocessed. Assume not.
2684   bool PP = false;
2685 
2686   return InputKind(Lang, Fmt, PP);
2687 }
2688 
2689 #ifndef NDEBUG
2690 ASTUnit::ConcurrencyState::ConcurrencyState() {
2691   Mutex = new std::recursive_mutex;
2692 }
2693 
2694 ASTUnit::ConcurrencyState::~ConcurrencyState() {
2695   delete static_cast<std::recursive_mutex *>(Mutex);
2696 }
2697 
2698 void ASTUnit::ConcurrencyState::start() {
2699   bool acquired = static_cast<std::recursive_mutex *>(Mutex)->try_lock();
2700   assert(acquired && "Concurrent access to ASTUnit!");
2701 }
2702 
2703 void ASTUnit::ConcurrencyState::finish() {
2704   static_cast<std::recursive_mutex *>(Mutex)->unlock();
2705 }
2706 
2707 #else // NDEBUG
2708 
2709 ASTUnit::ConcurrencyState::ConcurrencyState() { Mutex = nullptr; }
2710 ASTUnit::ConcurrencyState::~ConcurrencyState() {}
2711 void ASTUnit::ConcurrencyState::start() {}
2712 void ASTUnit::ConcurrencyState::finish() {}
2713 
2714 #endif // NDEBUG
2715