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