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