1 //===--- CoverageMappingGen.cpp - Coverage mapping generation ---*- 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 // Instrumentation-based code coverage mapping generator
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "CoverageMappingGen.h"
15 #include "CodeGenFunction.h"
16 #include "clang/AST/StmtVisitor.h"
17 #include "clang/Lex/Lexer.h"
18 #include "llvm/ADT/SmallSet.h"
19 #include "llvm/ADT/StringExtras.h"
20 #include "llvm/ADT/Optional.h"
21 #include "llvm/ProfileData/Coverage/CoverageMapping.h"
22 #include "llvm/ProfileData/Coverage/CoverageMappingReader.h"
23 #include "llvm/ProfileData/Coverage/CoverageMappingWriter.h"
24 #include "llvm/ProfileData/InstrProfReader.h"
25 #include "llvm/Support/FileSystem.h"
26 #include "llvm/Support/Path.h"
27 
28 using namespace clang;
29 using namespace CodeGen;
30 using namespace llvm::coverage;
31 
32 void CoverageSourceInfo::SourceRangeSkipped(SourceRange Range, SourceLocation) {
33   SkippedRanges.push_back(Range);
34 }
35 
36 namespace {
37 
38 /// \brief A region of source code that can be mapped to a counter.
39 class SourceMappingRegion {
40   Counter Count;
41 
42   /// \brief The region's starting location.
43   Optional<SourceLocation> LocStart;
44 
45   /// \brief The region's ending location.
46   Optional<SourceLocation> LocEnd;
47 
48   /// Whether this region should be emitted after its parent is emitted.
49   bool DeferRegion;
50 
51   /// Whether this region is a gap region. The count from a gap region is set
52   /// as the line execution count if there are no other regions on the line.
53   bool GapRegion;
54 
55 public:
56   SourceMappingRegion(Counter Count, Optional<SourceLocation> LocStart,
57                       Optional<SourceLocation> LocEnd, bool DeferRegion = false,
58                       bool GapRegion = false)
59       : Count(Count), LocStart(LocStart), LocEnd(LocEnd),
60         DeferRegion(DeferRegion), GapRegion(GapRegion) {}
61 
62   const Counter &getCounter() const { return Count; }
63 
64   void setCounter(Counter C) { Count = C; }
65 
66   bool hasStartLoc() const { return LocStart.hasValue(); }
67 
68   void setStartLoc(SourceLocation Loc) { LocStart = Loc; }
69 
70   SourceLocation getStartLoc() const {
71     assert(LocStart && "Region has no start location");
72     return *LocStart;
73   }
74 
75   bool hasEndLoc() const { return LocEnd.hasValue(); }
76 
77   void setEndLoc(SourceLocation Loc) {
78     assert(Loc.isValid() && "Setting an invalid end location");
79     LocEnd = Loc;
80   }
81 
82   SourceLocation getEndLoc() const {
83     assert(LocEnd && "Region has no end location");
84     return *LocEnd;
85   }
86 
87   bool isDeferred() const { return DeferRegion; }
88 
89   void setDeferred(bool Deferred) { DeferRegion = Deferred; }
90 
91   bool isGap() const { return GapRegion; }
92 
93   void setGap(bool Gap) { GapRegion = Gap; }
94 };
95 
96 /// Spelling locations for the start and end of a source region.
97 struct SpellingRegion {
98   /// The line where the region starts.
99   unsigned LineStart;
100 
101   /// The column where the region starts.
102   unsigned ColumnStart;
103 
104   /// The line where the region ends.
105   unsigned LineEnd;
106 
107   /// The column where the region ends.
108   unsigned ColumnEnd;
109 
110   SpellingRegion(SourceManager &SM, SourceLocation LocStart,
111                  SourceLocation LocEnd) {
112     LineStart = SM.getSpellingLineNumber(LocStart);
113     ColumnStart = SM.getSpellingColumnNumber(LocStart);
114     LineEnd = SM.getSpellingLineNumber(LocEnd);
115     ColumnEnd = SM.getSpellingColumnNumber(LocEnd);
116   }
117 
118   SpellingRegion(SourceManager &SM, SourceMappingRegion &R)
119       : SpellingRegion(SM, R.getStartLoc(), R.getEndLoc()) {}
120 
121   /// Check if the start and end locations appear in source order, i.e
122   /// top->bottom, left->right.
123   bool isInSourceOrder() const {
124     return (LineStart < LineEnd) ||
125            (LineStart == LineEnd && ColumnStart <= ColumnEnd);
126   }
127 };
128 
129 /// \brief Provides the common functionality for the different
130 /// coverage mapping region builders.
131 class CoverageMappingBuilder {
132 public:
133   CoverageMappingModuleGen &CVM;
134   SourceManager &SM;
135   const LangOptions &LangOpts;
136 
137 private:
138   /// \brief Map of clang's FileIDs to IDs used for coverage mapping.
139   llvm::SmallDenseMap<FileID, std::pair<unsigned, SourceLocation>, 8>
140       FileIDMapping;
141 
142 public:
143   /// \brief The coverage mapping regions for this function
144   llvm::SmallVector<CounterMappingRegion, 32> MappingRegions;
145   /// \brief The source mapping regions for this function.
146   std::vector<SourceMappingRegion> SourceRegions;
147 
148   /// \brief A set of regions which can be used as a filter.
149   ///
150   /// It is produced by emitExpansionRegions() and is used in
151   /// emitSourceRegions() to suppress producing code regions if
152   /// the same area is covered by expansion regions.
153   typedef llvm::SmallSet<std::pair<SourceLocation, SourceLocation>, 8>
154       SourceRegionFilter;
155 
156   CoverageMappingBuilder(CoverageMappingModuleGen &CVM, SourceManager &SM,
157                          const LangOptions &LangOpts)
158       : CVM(CVM), SM(SM), LangOpts(LangOpts) {}
159 
160   /// \brief Return the precise end location for the given token.
161   SourceLocation getPreciseTokenLocEnd(SourceLocation Loc) {
162     // We avoid getLocForEndOfToken here, because it doesn't do what we want for
163     // macro locations, which we just treat as expanded files.
164     unsigned TokLen =
165         Lexer::MeasureTokenLength(SM.getSpellingLoc(Loc), SM, LangOpts);
166     return Loc.getLocWithOffset(TokLen);
167   }
168 
169   /// \brief Return the start location of an included file or expanded macro.
170   SourceLocation getStartOfFileOrMacro(SourceLocation Loc) {
171     if (Loc.isMacroID())
172       return Loc.getLocWithOffset(-SM.getFileOffset(Loc));
173     return SM.getLocForStartOfFile(SM.getFileID(Loc));
174   }
175 
176   /// \brief Return the end location of an included file or expanded macro.
177   SourceLocation getEndOfFileOrMacro(SourceLocation Loc) {
178     if (Loc.isMacroID())
179       return Loc.getLocWithOffset(SM.getFileIDSize(SM.getFileID(Loc)) -
180                                   SM.getFileOffset(Loc));
181     return SM.getLocForEndOfFile(SM.getFileID(Loc));
182   }
183 
184   /// \brief Find out where the current file is included or macro is expanded.
185   SourceLocation getIncludeOrExpansionLoc(SourceLocation Loc) {
186     return Loc.isMacroID() ? SM.getImmediateExpansionRange(Loc).first
187                            : SM.getIncludeLoc(SM.getFileID(Loc));
188   }
189 
190   /// \brief Return true if \c Loc is a location in a built-in macro.
191   bool isInBuiltin(SourceLocation Loc) {
192     return SM.getBufferName(SM.getSpellingLoc(Loc)) == "<built-in>";
193   }
194 
195   /// \brief Check whether \c Loc is included or expanded from \c Parent.
196   bool isNestedIn(SourceLocation Loc, FileID Parent) {
197     do {
198       Loc = getIncludeOrExpansionLoc(Loc);
199       if (Loc.isInvalid())
200         return false;
201     } while (!SM.isInFileID(Loc, Parent));
202     return true;
203   }
204 
205   /// \brief Get the start of \c S ignoring macro arguments and builtin macros.
206   SourceLocation getStart(const Stmt *S) {
207     SourceLocation Loc = S->getLocStart();
208     while (SM.isMacroArgExpansion(Loc) || isInBuiltin(Loc))
209       Loc = SM.getImmediateExpansionRange(Loc).first;
210     return Loc;
211   }
212 
213   /// \brief Get the end of \c S ignoring macro arguments and builtin macros.
214   SourceLocation getEnd(const Stmt *S) {
215     SourceLocation Loc = S->getLocEnd();
216     while (SM.isMacroArgExpansion(Loc) || isInBuiltin(Loc))
217       Loc = SM.getImmediateExpansionRange(Loc).first;
218     return getPreciseTokenLocEnd(Loc);
219   }
220 
221   /// \brief Find the set of files we have regions for and assign IDs
222   ///
223   /// Fills \c Mapping with the virtual file mapping needed to write out
224   /// coverage and collects the necessary file information to emit source and
225   /// expansion regions.
226   void gatherFileIDs(SmallVectorImpl<unsigned> &Mapping) {
227     FileIDMapping.clear();
228 
229     llvm::SmallSet<FileID, 8> Visited;
230     SmallVector<std::pair<SourceLocation, unsigned>, 8> FileLocs;
231     for (const auto &Region : SourceRegions) {
232       SourceLocation Loc = Region.getStartLoc();
233       FileID File = SM.getFileID(Loc);
234       if (!Visited.insert(File).second)
235         continue;
236 
237       // Do not map FileID's associated with system headers.
238       if (SM.isInSystemHeader(SM.getSpellingLoc(Loc)))
239         continue;
240 
241       unsigned Depth = 0;
242       for (SourceLocation Parent = getIncludeOrExpansionLoc(Loc);
243            Parent.isValid(); Parent = getIncludeOrExpansionLoc(Parent))
244         ++Depth;
245       FileLocs.push_back(std::make_pair(Loc, Depth));
246     }
247     std::stable_sort(FileLocs.begin(), FileLocs.end(), llvm::less_second());
248 
249     for (const auto &FL : FileLocs) {
250       SourceLocation Loc = FL.first;
251       FileID SpellingFile = SM.getDecomposedSpellingLoc(Loc).first;
252       auto Entry = SM.getFileEntryForID(SpellingFile);
253       if (!Entry)
254         continue;
255 
256       FileIDMapping[SM.getFileID(Loc)] = std::make_pair(Mapping.size(), Loc);
257       Mapping.push_back(CVM.getFileID(Entry));
258     }
259   }
260 
261   /// \brief Get the coverage mapping file ID for \c Loc.
262   ///
263   /// If such file id doesn't exist, return None.
264   Optional<unsigned> getCoverageFileID(SourceLocation Loc) {
265     auto Mapping = FileIDMapping.find(SM.getFileID(Loc));
266     if (Mapping != FileIDMapping.end())
267       return Mapping->second.first;
268     return None;
269   }
270 
271   /// \brief Gather all the regions that were skipped by the preprocessor
272   /// using the constructs like #if.
273   void gatherSkippedRegions() {
274     /// An array of the minimum lineStarts and the maximum lineEnds
275     /// for mapping regions from the appropriate source files.
276     llvm::SmallVector<std::pair<unsigned, unsigned>, 8> FileLineRanges;
277     FileLineRanges.resize(
278         FileIDMapping.size(),
279         std::make_pair(std::numeric_limits<unsigned>::max(), 0));
280     for (const auto &R : MappingRegions) {
281       FileLineRanges[R.FileID].first =
282           std::min(FileLineRanges[R.FileID].first, R.LineStart);
283       FileLineRanges[R.FileID].second =
284           std::max(FileLineRanges[R.FileID].second, R.LineEnd);
285     }
286 
287     auto SkippedRanges = CVM.getSourceInfo().getSkippedRanges();
288     for (const auto &I : SkippedRanges) {
289       auto LocStart = I.getBegin();
290       auto LocEnd = I.getEnd();
291       assert(SM.isWrittenInSameFile(LocStart, LocEnd) &&
292              "region spans multiple files");
293 
294       auto CovFileID = getCoverageFileID(LocStart);
295       if (!CovFileID)
296         continue;
297       SpellingRegion SR{SM, LocStart, LocEnd};
298       auto Region = CounterMappingRegion::makeSkipped(
299           *CovFileID, SR.LineStart, SR.ColumnStart, SR.LineEnd, SR.ColumnEnd);
300       // Make sure that we only collect the regions that are inside
301       // the souce code of this function.
302       if (Region.LineStart >= FileLineRanges[*CovFileID].first &&
303           Region.LineEnd <= FileLineRanges[*CovFileID].second)
304         MappingRegions.push_back(Region);
305     }
306   }
307 
308   /// \brief Generate the coverage counter mapping regions from collected
309   /// source regions.
310   void emitSourceRegions(const SourceRegionFilter &Filter) {
311     for (const auto &Region : SourceRegions) {
312       assert(Region.hasEndLoc() && "incomplete region");
313 
314       SourceLocation LocStart = Region.getStartLoc();
315       assert(SM.getFileID(LocStart).isValid() && "region in invalid file");
316 
317       // Ignore regions from system headers.
318       if (SM.isInSystemHeader(SM.getSpellingLoc(LocStart)))
319         continue;
320 
321       auto CovFileID = getCoverageFileID(LocStart);
322       // Ignore regions that don't have a file, such as builtin macros.
323       if (!CovFileID)
324         continue;
325 
326       SourceLocation LocEnd = Region.getEndLoc();
327       assert(SM.isWrittenInSameFile(LocStart, LocEnd) &&
328              "region spans multiple files");
329 
330       // Don't add code regions for the area covered by expansion regions.
331       // This not only suppresses redundant regions, but sometimes prevents
332       // creating regions with wrong counters if, for example, a statement's
333       // body ends at the end of a nested macro.
334       if (Filter.count(std::make_pair(LocStart, LocEnd)))
335         continue;
336 
337       // Find the spelling locations for the mapping region.
338       SpellingRegion SR{SM, LocStart, LocEnd};
339       assert(SR.isInSourceOrder() && "region start and end out of order");
340 
341       if (Region.isGap()) {
342         MappingRegions.push_back(CounterMappingRegion::makeGapRegion(
343             Region.getCounter(), *CovFileID, SR.LineStart, SR.ColumnStart,
344             SR.LineEnd, SR.ColumnEnd));
345       } else {
346         MappingRegions.push_back(CounterMappingRegion::makeRegion(
347             Region.getCounter(), *CovFileID, SR.LineStart, SR.ColumnStart,
348             SR.LineEnd, SR.ColumnEnd));
349       }
350     }
351   }
352 
353   /// \brief Generate expansion regions for each virtual file we've seen.
354   SourceRegionFilter emitExpansionRegions() {
355     SourceRegionFilter Filter;
356     for (const auto &FM : FileIDMapping) {
357       SourceLocation ExpandedLoc = FM.second.second;
358       SourceLocation ParentLoc = getIncludeOrExpansionLoc(ExpandedLoc);
359       if (ParentLoc.isInvalid())
360         continue;
361 
362       auto ParentFileID = getCoverageFileID(ParentLoc);
363       if (!ParentFileID)
364         continue;
365       auto ExpandedFileID = getCoverageFileID(ExpandedLoc);
366       assert(ExpandedFileID && "expansion in uncovered file");
367 
368       SourceLocation LocEnd = getPreciseTokenLocEnd(ParentLoc);
369       assert(SM.isWrittenInSameFile(ParentLoc, LocEnd) &&
370              "region spans multiple files");
371       Filter.insert(std::make_pair(ParentLoc, LocEnd));
372 
373       SpellingRegion SR{SM, ParentLoc, LocEnd};
374       assert(SR.isInSourceOrder() && "region start and end out of order");
375       MappingRegions.push_back(CounterMappingRegion::makeExpansion(
376           *ParentFileID, *ExpandedFileID, SR.LineStart, SR.ColumnStart,
377           SR.LineEnd, SR.ColumnEnd));
378     }
379     return Filter;
380   }
381 };
382 
383 /// \brief Creates unreachable coverage regions for the functions that
384 /// are not emitted.
385 struct EmptyCoverageMappingBuilder : public CoverageMappingBuilder {
386   EmptyCoverageMappingBuilder(CoverageMappingModuleGen &CVM, SourceManager &SM,
387                               const LangOptions &LangOpts)
388       : CoverageMappingBuilder(CVM, SM, LangOpts) {}
389 
390   void VisitDecl(const Decl *D) {
391     if (!D->hasBody())
392       return;
393     auto Body = D->getBody();
394     SourceLocation Start = getStart(Body);
395     SourceLocation End = getEnd(Body);
396     if (!SM.isWrittenInSameFile(Start, End)) {
397       // Walk up to find the common ancestor.
398       // Correct the locations accordingly.
399       FileID StartFileID = SM.getFileID(Start);
400       FileID EndFileID = SM.getFileID(End);
401       while (StartFileID != EndFileID && !isNestedIn(End, StartFileID)) {
402         Start = getIncludeOrExpansionLoc(Start);
403         assert(Start.isValid() &&
404                "Declaration start location not nested within a known region");
405         StartFileID = SM.getFileID(Start);
406       }
407       while (StartFileID != EndFileID) {
408         End = getPreciseTokenLocEnd(getIncludeOrExpansionLoc(End));
409         assert(End.isValid() &&
410                "Declaration end location not nested within a known region");
411         EndFileID = SM.getFileID(End);
412       }
413     }
414     SourceRegions.emplace_back(Counter(), Start, End);
415   }
416 
417   /// \brief Write the mapping data to the output stream
418   void write(llvm::raw_ostream &OS) {
419     SmallVector<unsigned, 16> FileIDMapping;
420     gatherFileIDs(FileIDMapping);
421     emitSourceRegions(SourceRegionFilter());
422 
423     if (MappingRegions.empty())
424       return;
425 
426     CoverageMappingWriter Writer(FileIDMapping, None, MappingRegions);
427     Writer.write(OS);
428   }
429 };
430 
431 /// \brief A StmtVisitor that creates coverage mapping regions which map
432 /// from the source code locations to the PGO counters.
433 struct CounterCoverageMappingBuilder
434     : public CoverageMappingBuilder,
435       public ConstStmtVisitor<CounterCoverageMappingBuilder> {
436   /// \brief The map of statements to count values.
437   llvm::DenseMap<const Stmt *, unsigned> &CounterMap;
438 
439   /// \brief A stack of currently live regions.
440   std::vector<SourceMappingRegion> RegionStack;
441 
442   /// The currently deferred region: its end location and count can be set once
443   /// its parent has been popped from the region stack.
444   Optional<SourceMappingRegion> DeferredRegion;
445 
446   CounterExpressionBuilder Builder;
447 
448   /// \brief A location in the most recently visited file or macro.
449   ///
450   /// This is used to adjust the active source regions appropriately when
451   /// expressions cross file or macro boundaries.
452   SourceLocation MostRecentLocation;
453 
454   /// Location of the last terminated region.
455   Optional<std::pair<SourceLocation, size_t>> LastTerminatedRegion;
456 
457   /// \brief Return a counter for the subtraction of \c RHS from \c LHS
458   Counter subtractCounters(Counter LHS, Counter RHS) {
459     return Builder.subtract(LHS, RHS);
460   }
461 
462   /// \brief Return a counter for the sum of \c LHS and \c RHS.
463   Counter addCounters(Counter LHS, Counter RHS) {
464     return Builder.add(LHS, RHS);
465   }
466 
467   Counter addCounters(Counter C1, Counter C2, Counter C3) {
468     return addCounters(addCounters(C1, C2), C3);
469   }
470 
471   /// \brief Return the region counter for the given statement.
472   ///
473   /// This should only be called on statements that have a dedicated counter.
474   Counter getRegionCounter(const Stmt *S) {
475     return Counter::getCounter(CounterMap[S]);
476   }
477 
478   /// \brief Push a region onto the stack.
479   ///
480   /// Returns the index on the stack where the region was pushed. This can be
481   /// used with popRegions to exit a "scope", ending the region that was pushed.
482   size_t pushRegion(Counter Count, Optional<SourceLocation> StartLoc = None,
483                     Optional<SourceLocation> EndLoc = None) {
484     if (StartLoc) {
485       MostRecentLocation = *StartLoc;
486       completeDeferred(Count, MostRecentLocation);
487     }
488     RegionStack.emplace_back(Count, StartLoc, EndLoc);
489 
490     return RegionStack.size() - 1;
491   }
492 
493   /// Complete any pending deferred region by setting its end location and
494   /// count, and then pushing it onto the region stack.
495   size_t completeDeferred(Counter Count, SourceLocation DeferredEndLoc) {
496     size_t Index = RegionStack.size();
497     if (!DeferredRegion)
498       return Index;
499 
500     // Consume the pending region.
501     SourceMappingRegion DR = DeferredRegion.getValue();
502     DeferredRegion = None;
503 
504     // If the region ends in an expansion, find the expansion site.
505     FileID StartFile = SM.getFileID(DR.getStartLoc());
506     if (SM.getFileID(DeferredEndLoc) != StartFile) {
507       if (isNestedIn(DeferredEndLoc, StartFile)) {
508         do {
509           DeferredEndLoc = getIncludeOrExpansionLoc(DeferredEndLoc);
510         } while (StartFile != SM.getFileID(DeferredEndLoc));
511       } else {
512         return Index;
513       }
514     }
515 
516     // The parent of this deferred region ends where the containing decl ends,
517     // so the region isn't useful.
518     if (DR.getStartLoc() == DeferredEndLoc)
519       return Index;
520 
521     // If we're visiting statements in non-source order (e.g switch cases or
522     // a loop condition) we can't construct a sensible deferred region.
523     if (!SpellingRegion(SM, DR.getStartLoc(), DeferredEndLoc).isInSourceOrder())
524       return Index;
525 
526     DR.setGap(true);
527     DR.setCounter(Count);
528     DR.setEndLoc(DeferredEndLoc);
529     handleFileExit(DeferredEndLoc);
530     RegionStack.push_back(DR);
531     return Index;
532   }
533 
534   /// Complete a deferred region created after a terminated region at the
535   /// top-level.
536   void completeTopLevelDeferredRegion(Counter Count,
537                                       SourceLocation DeferredEndLoc) {
538     if (DeferredRegion || !LastTerminatedRegion)
539       return;
540 
541     if (LastTerminatedRegion->second != RegionStack.size())
542       return;
543 
544     SourceLocation Start = LastTerminatedRegion->first;
545     if (SM.getFileID(Start) != SM.getMainFileID())
546       return;
547 
548     SourceMappingRegion DR = RegionStack.back();
549     DR.setStartLoc(Start);
550     DR.setDeferred(false);
551     DeferredRegion = DR;
552     completeDeferred(Count, DeferredEndLoc);
553   }
554 
555   /// \brief Pop regions from the stack into the function's list of regions.
556   ///
557   /// Adds all regions from \c ParentIndex to the top of the stack to the
558   /// function's \c SourceRegions.
559   void popRegions(size_t ParentIndex) {
560     assert(RegionStack.size() >= ParentIndex && "parent not in stack");
561     bool ParentOfDeferredRegion = false;
562     while (RegionStack.size() > ParentIndex) {
563       SourceMappingRegion &Region = RegionStack.back();
564       if (Region.hasStartLoc()) {
565         SourceLocation StartLoc = Region.getStartLoc();
566         SourceLocation EndLoc = Region.hasEndLoc()
567                                     ? Region.getEndLoc()
568                                     : RegionStack[ParentIndex].getEndLoc();
569         while (!SM.isWrittenInSameFile(StartLoc, EndLoc)) {
570           // The region ends in a nested file or macro expansion. Create a
571           // separate region for each expansion.
572           SourceLocation NestedLoc = getStartOfFileOrMacro(EndLoc);
573           assert(SM.isWrittenInSameFile(NestedLoc, EndLoc));
574 
575           if (!isRegionAlreadyAdded(NestedLoc, EndLoc))
576             SourceRegions.emplace_back(Region.getCounter(), NestedLoc, EndLoc);
577 
578           EndLoc = getPreciseTokenLocEnd(getIncludeOrExpansionLoc(EndLoc));
579           if (EndLoc.isInvalid())
580             llvm::report_fatal_error("File exit not handled before popRegions");
581         }
582         Region.setEndLoc(EndLoc);
583 
584         MostRecentLocation = EndLoc;
585         // If this region happens to span an entire expansion, we need to make
586         // sure we don't overlap the parent region with it.
587         if (StartLoc == getStartOfFileOrMacro(StartLoc) &&
588             EndLoc == getEndOfFileOrMacro(EndLoc))
589           MostRecentLocation = getIncludeOrExpansionLoc(EndLoc);
590 
591         assert(SM.isWrittenInSameFile(Region.getStartLoc(), EndLoc));
592         assert(SpellingRegion(SM, Region).isInSourceOrder());
593         SourceRegions.push_back(Region);
594 
595         if (ParentOfDeferredRegion) {
596           ParentOfDeferredRegion = false;
597 
598           // If there's an existing deferred region, keep the old one, because
599           // it means there are two consecutive returns (or a similar pattern).
600           if (!DeferredRegion.hasValue() &&
601               // File IDs aren't gathered within macro expansions, so it isn't
602               // useful to try and create a deferred region inside of one.
603               !EndLoc.isMacroID())
604             DeferredRegion =
605                 SourceMappingRegion(Counter::getZero(), EndLoc, None);
606         }
607       } else if (Region.isDeferred()) {
608         assert(!ParentOfDeferredRegion && "Consecutive deferred regions");
609         ParentOfDeferredRegion = true;
610       }
611       RegionStack.pop_back();
612 
613       // If the zero region pushed after the last terminated region no longer
614       // exists, clear its cached information.
615       if (LastTerminatedRegion &&
616           RegionStack.size() < LastTerminatedRegion->second)
617         LastTerminatedRegion = None;
618     }
619     assert(!ParentOfDeferredRegion && "Deferred region with no parent");
620   }
621 
622   /// \brief Return the currently active region.
623   SourceMappingRegion &getRegion() {
624     assert(!RegionStack.empty() && "statement has no region");
625     return RegionStack.back();
626   }
627 
628   /// \brief Propagate counts through the children of \c S.
629   Counter propagateCounts(Counter TopCount, const Stmt *S) {
630     SourceLocation StartLoc = getStart(S);
631     SourceLocation EndLoc = getEnd(S);
632     size_t Index = pushRegion(TopCount, StartLoc, EndLoc);
633     Visit(S);
634     Counter ExitCount = getRegion().getCounter();
635     popRegions(Index);
636 
637     // The statement may be spanned by an expansion. Make sure we handle a file
638     // exit out of this expansion before moving to the next statement.
639     if (SM.isBeforeInTranslationUnit(StartLoc, S->getLocStart()))
640       MostRecentLocation = EndLoc;
641 
642     return ExitCount;
643   }
644 
645   /// \brief Check whether a region with bounds \c StartLoc and \c EndLoc
646   /// is already added to \c SourceRegions.
647   bool isRegionAlreadyAdded(SourceLocation StartLoc, SourceLocation EndLoc) {
648     return SourceRegions.rend() !=
649            std::find_if(SourceRegions.rbegin(), SourceRegions.rend(),
650                         [&](const SourceMappingRegion &Region) {
651                           return Region.getStartLoc() == StartLoc &&
652                                  Region.getEndLoc() == EndLoc;
653                         });
654   }
655 
656   /// \brief Adjust the most recently visited location to \c EndLoc.
657   ///
658   /// This should be used after visiting any statements in non-source order.
659   void adjustForOutOfOrderTraversal(SourceLocation EndLoc) {
660     MostRecentLocation = EndLoc;
661     // The code region for a whole macro is created in handleFileExit() when
662     // it detects exiting of the virtual file of that macro. If we visited
663     // statements in non-source order, we might already have such a region
664     // added, for example, if a body of a loop is divided among multiple
665     // macros. Avoid adding duplicate regions in such case.
666     if (getRegion().hasEndLoc() &&
667         MostRecentLocation == getEndOfFileOrMacro(MostRecentLocation) &&
668         isRegionAlreadyAdded(getStartOfFileOrMacro(MostRecentLocation),
669                              MostRecentLocation))
670       MostRecentLocation = getIncludeOrExpansionLoc(MostRecentLocation);
671   }
672 
673   /// \brief Adjust regions and state when \c NewLoc exits a file.
674   ///
675   /// If moving from our most recently tracked location to \c NewLoc exits any
676   /// files, this adjusts our current region stack and creates the file regions
677   /// for the exited file.
678   void handleFileExit(SourceLocation NewLoc) {
679     if (NewLoc.isInvalid() ||
680         SM.isWrittenInSameFile(MostRecentLocation, NewLoc))
681       return;
682 
683     // If NewLoc is not in a file that contains MostRecentLocation, walk up to
684     // find the common ancestor.
685     SourceLocation LCA = NewLoc;
686     FileID ParentFile = SM.getFileID(LCA);
687     while (!isNestedIn(MostRecentLocation, ParentFile)) {
688       LCA = getIncludeOrExpansionLoc(LCA);
689       if (LCA.isInvalid() || SM.isWrittenInSameFile(LCA, MostRecentLocation)) {
690         // Since there isn't a common ancestor, no file was exited. We just need
691         // to adjust our location to the new file.
692         MostRecentLocation = NewLoc;
693         return;
694       }
695       ParentFile = SM.getFileID(LCA);
696     }
697 
698     llvm::SmallSet<SourceLocation, 8> StartLocs;
699     Optional<Counter> ParentCounter;
700     for (SourceMappingRegion &I : llvm::reverse(RegionStack)) {
701       if (!I.hasStartLoc())
702         continue;
703       SourceLocation Loc = I.getStartLoc();
704       if (!isNestedIn(Loc, ParentFile)) {
705         ParentCounter = I.getCounter();
706         break;
707       }
708 
709       while (!SM.isInFileID(Loc, ParentFile)) {
710         // The most nested region for each start location is the one with the
711         // correct count. We avoid creating redundant regions by stopping once
712         // we've seen this region.
713         if (StartLocs.insert(Loc).second)
714           SourceRegions.emplace_back(I.getCounter(), Loc,
715                                      getEndOfFileOrMacro(Loc));
716         Loc = getIncludeOrExpansionLoc(Loc);
717       }
718       I.setStartLoc(getPreciseTokenLocEnd(Loc));
719     }
720 
721     if (ParentCounter) {
722       // If the file is contained completely by another region and doesn't
723       // immediately start its own region, the whole file gets a region
724       // corresponding to the parent.
725       SourceLocation Loc = MostRecentLocation;
726       while (isNestedIn(Loc, ParentFile)) {
727         SourceLocation FileStart = getStartOfFileOrMacro(Loc);
728         if (StartLocs.insert(FileStart).second) {
729           SourceRegions.emplace_back(*ParentCounter, FileStart,
730                                      getEndOfFileOrMacro(Loc));
731           assert(SpellingRegion(SM, SourceRegions.back()).isInSourceOrder());
732         }
733         Loc = getIncludeOrExpansionLoc(Loc);
734       }
735     }
736 
737     MostRecentLocation = NewLoc;
738   }
739 
740   /// \brief Ensure that \c S is included in the current region.
741   void extendRegion(const Stmt *S) {
742     SourceMappingRegion &Region = getRegion();
743     SourceLocation StartLoc = getStart(S);
744 
745     handleFileExit(StartLoc);
746     if (!Region.hasStartLoc())
747       Region.setStartLoc(StartLoc);
748 
749     completeDeferred(Region.getCounter(), StartLoc);
750   }
751 
752   /// \brief Mark \c S as a terminator, starting a zero region.
753   void terminateRegion(const Stmt *S) {
754     extendRegion(S);
755     SourceMappingRegion &Region = getRegion();
756     SourceLocation EndLoc = getEnd(S);
757     if (!Region.hasEndLoc())
758       Region.setEndLoc(EndLoc);
759     pushRegion(Counter::getZero());
760     auto &ZeroRegion = getRegion();
761     ZeroRegion.setDeferred(true);
762     LastTerminatedRegion = {EndLoc, RegionStack.size()};
763   }
764 
765   /// Find a valid gap range between \p AfterLoc and \p BeforeLoc.
766   Optional<SourceRange> findGapAreaBetween(SourceLocation AfterLoc,
767                                            SourceLocation BeforeLoc) {
768     // If the start and end locations of the gap are both within the same macro
769     // file, the range may not be in source order.
770     if (AfterLoc.isMacroID() || BeforeLoc.isMacroID())
771       return None;
772     if (!SM.isWrittenInSameFile(AfterLoc, BeforeLoc))
773       return None;
774     return {{AfterLoc, BeforeLoc}};
775   }
776 
777   /// Find the source range after \p AfterStmt and before \p BeforeStmt.
778   Optional<SourceRange> findGapAreaBetween(const Stmt *AfterStmt,
779                                            const Stmt *BeforeStmt) {
780     return findGapAreaBetween(getPreciseTokenLocEnd(getEnd(AfterStmt)),
781                               getStart(BeforeStmt));
782   }
783 
784   /// Emit a gap region between \p StartLoc and \p EndLoc with the given count.
785   void fillGapAreaWithCount(SourceLocation StartLoc, SourceLocation EndLoc,
786                             Counter Count) {
787     if (StartLoc == EndLoc)
788       return;
789     assert(SpellingRegion(SM, StartLoc, EndLoc).isInSourceOrder());
790     handleFileExit(StartLoc);
791     size_t Index = pushRegion(Count, StartLoc, EndLoc);
792     getRegion().setGap(true);
793     handleFileExit(EndLoc);
794     popRegions(Index);
795   }
796 
797   /// \brief Keep counts of breaks and continues inside loops.
798   struct BreakContinue {
799     Counter BreakCount;
800     Counter ContinueCount;
801   };
802   SmallVector<BreakContinue, 8> BreakContinueStack;
803 
804   CounterCoverageMappingBuilder(
805       CoverageMappingModuleGen &CVM,
806       llvm::DenseMap<const Stmt *, unsigned> &CounterMap, SourceManager &SM,
807       const LangOptions &LangOpts)
808       : CoverageMappingBuilder(CVM, SM, LangOpts), CounterMap(CounterMap),
809         DeferredRegion(None) {}
810 
811   /// \brief Write the mapping data to the output stream
812   void write(llvm::raw_ostream &OS) {
813     llvm::SmallVector<unsigned, 8> VirtualFileMapping;
814     gatherFileIDs(VirtualFileMapping);
815     SourceRegionFilter Filter = emitExpansionRegions();
816     assert(!DeferredRegion && "Deferred region never completed");
817     emitSourceRegions(Filter);
818     gatherSkippedRegions();
819 
820     if (MappingRegions.empty())
821       return;
822 
823     CoverageMappingWriter Writer(VirtualFileMapping, Builder.getExpressions(),
824                                  MappingRegions);
825     Writer.write(OS);
826   }
827 
828   void VisitStmt(const Stmt *S) {
829     if (S->getLocStart().isValid())
830       extendRegion(S);
831     for (const Stmt *Child : S->children())
832       if (Child)
833         this->Visit(Child);
834     handleFileExit(getEnd(S));
835   }
836 
837   /// Determine whether the final deferred region emitted in \p Body should be
838   /// discarded.
839   static bool discardFinalDeferredRegionInDecl(Stmt *Body) {
840     if (auto *CS = dyn_cast<CompoundStmt>(Body)) {
841       Stmt *LastStmt = CS->body_back();
842       if (auto *IfElse = dyn_cast<IfStmt>(LastStmt)) {
843         if (auto *Else = dyn_cast_or_null<CompoundStmt>(IfElse->getElse()))
844           LastStmt = Else->body_back();
845         else
846           LastStmt = IfElse->getElse();
847       }
848       return dyn_cast_or_null<ReturnStmt>(LastStmt);
849     }
850     return false;
851   }
852 
853   void VisitDecl(const Decl *D) {
854     assert(!DeferredRegion && "Deferred region never completed");
855 
856     Stmt *Body = D->getBody();
857 
858     // Do not propagate region counts into system headers.
859     if (Body && SM.isInSystemHeader(SM.getSpellingLoc(getStart(Body))))
860       return;
861 
862     Counter ExitCount = propagateCounts(getRegionCounter(Body), Body);
863     assert(RegionStack.empty() && "Regions entered but never exited");
864 
865     if (DeferredRegion) {
866       // Complete (or discard) any deferred regions introduced by the last
867       // statement.
868       if (discardFinalDeferredRegionInDecl(Body))
869         DeferredRegion = None;
870       else
871         popRegions(completeDeferred(ExitCount, getEnd(Body)));
872     }
873   }
874 
875   void VisitReturnStmt(const ReturnStmt *S) {
876     extendRegion(S);
877     if (S->getRetValue())
878       Visit(S->getRetValue());
879     terminateRegion(S);
880   }
881 
882   void VisitCXXThrowExpr(const CXXThrowExpr *E) {
883     extendRegion(E);
884     if (E->getSubExpr())
885       Visit(E->getSubExpr());
886     terminateRegion(E);
887   }
888 
889   void VisitGotoStmt(const GotoStmt *S) { terminateRegion(S); }
890 
891   void VisitLabelStmt(const LabelStmt *S) {
892     Counter LabelCount = getRegionCounter(S);
893     SourceLocation Start = getStart(S);
894     completeTopLevelDeferredRegion(LabelCount, Start);
895     // We can't extendRegion here or we risk overlapping with our new region.
896     handleFileExit(Start);
897     pushRegion(LabelCount, Start);
898     Visit(S->getSubStmt());
899   }
900 
901   void VisitBreakStmt(const BreakStmt *S) {
902     assert(!BreakContinueStack.empty() && "break not in a loop or switch!");
903     BreakContinueStack.back().BreakCount = addCounters(
904         BreakContinueStack.back().BreakCount, getRegion().getCounter());
905     // FIXME: a break in a switch should terminate regions for all preceding
906     // case statements, not just the most recent one.
907     terminateRegion(S);
908   }
909 
910   void VisitContinueStmt(const ContinueStmt *S) {
911     assert(!BreakContinueStack.empty() && "continue stmt not in a loop!");
912     BreakContinueStack.back().ContinueCount = addCounters(
913         BreakContinueStack.back().ContinueCount, getRegion().getCounter());
914     terminateRegion(S);
915   }
916 
917   void VisitCallExpr(const CallExpr *E) {
918     VisitStmt(E);
919 
920     // Terminate the region when we hit a noreturn function.
921     // (This is helpful dealing with switch statements.)
922     QualType CalleeType = E->getCallee()->getType();
923     if (getFunctionExtInfo(*CalleeType).getNoReturn())
924       terminateRegion(E);
925   }
926 
927   void VisitWhileStmt(const WhileStmt *S) {
928     extendRegion(S);
929 
930     Counter ParentCount = getRegion().getCounter();
931     Counter BodyCount = getRegionCounter(S);
932 
933     // Handle the body first so that we can get the backedge count.
934     BreakContinueStack.push_back(BreakContinue());
935     extendRegion(S->getBody());
936     Counter BackedgeCount = propagateCounts(BodyCount, S->getBody());
937     BreakContinue BC = BreakContinueStack.pop_back_val();
938 
939     // Go back to handle the condition.
940     Counter CondCount =
941         addCounters(ParentCount, BackedgeCount, BC.ContinueCount);
942     propagateCounts(CondCount, S->getCond());
943     adjustForOutOfOrderTraversal(getEnd(S));
944 
945     // The body count applies to the area immediately after the increment.
946     auto Gap = findGapAreaBetween(S->getCond(), S->getBody());
947     if (Gap)
948       fillGapAreaWithCount(Gap->getBegin(), Gap->getEnd(), BodyCount);
949 
950     Counter OutCount =
951         addCounters(BC.BreakCount, subtractCounters(CondCount, BodyCount));
952     if (OutCount != ParentCount)
953       pushRegion(OutCount);
954   }
955 
956   void VisitDoStmt(const DoStmt *S) {
957     extendRegion(S);
958 
959     Counter ParentCount = getRegion().getCounter();
960     Counter BodyCount = getRegionCounter(S);
961 
962     BreakContinueStack.push_back(BreakContinue());
963     extendRegion(S->getBody());
964     Counter BackedgeCount =
965         propagateCounts(addCounters(ParentCount, BodyCount), S->getBody());
966     BreakContinue BC = BreakContinueStack.pop_back_val();
967 
968     Counter CondCount = addCounters(BackedgeCount, BC.ContinueCount);
969     propagateCounts(CondCount, S->getCond());
970 
971     Counter OutCount =
972         addCounters(BC.BreakCount, subtractCounters(CondCount, BodyCount));
973     if (OutCount != ParentCount)
974       pushRegion(OutCount);
975   }
976 
977   void VisitForStmt(const ForStmt *S) {
978     extendRegion(S);
979     if (S->getInit())
980       Visit(S->getInit());
981 
982     Counter ParentCount = getRegion().getCounter();
983     Counter BodyCount = getRegionCounter(S);
984 
985     // Handle the body first so that we can get the backedge count.
986     BreakContinueStack.push_back(BreakContinue());
987     extendRegion(S->getBody());
988     Counter BackedgeCount = propagateCounts(BodyCount, S->getBody());
989     BreakContinue BC = BreakContinueStack.pop_back_val();
990 
991     // The increment is essentially part of the body but it needs to include
992     // the count for all the continue statements.
993     if (const Stmt *Inc = S->getInc())
994       propagateCounts(addCounters(BackedgeCount, BC.ContinueCount), Inc);
995 
996     // Go back to handle the condition.
997     Counter CondCount =
998         addCounters(ParentCount, BackedgeCount, BC.ContinueCount);
999     if (const Expr *Cond = S->getCond()) {
1000       propagateCounts(CondCount, Cond);
1001       adjustForOutOfOrderTraversal(getEnd(S));
1002     }
1003 
1004     // The body count applies to the area immediately after the increment.
1005     auto Gap = findGapAreaBetween(getPreciseTokenLocEnd(S->getRParenLoc()),
1006                                   getStart(S->getBody()));
1007     if (Gap)
1008       fillGapAreaWithCount(Gap->getBegin(), Gap->getEnd(), BodyCount);
1009 
1010     Counter OutCount =
1011         addCounters(BC.BreakCount, subtractCounters(CondCount, BodyCount));
1012     if (OutCount != ParentCount)
1013       pushRegion(OutCount);
1014   }
1015 
1016   void VisitCXXForRangeStmt(const CXXForRangeStmt *S) {
1017     extendRegion(S);
1018     Visit(S->getLoopVarStmt());
1019     Visit(S->getRangeStmt());
1020 
1021     Counter ParentCount = getRegion().getCounter();
1022     Counter BodyCount = getRegionCounter(S);
1023 
1024     BreakContinueStack.push_back(BreakContinue());
1025     extendRegion(S->getBody());
1026     Counter BackedgeCount = propagateCounts(BodyCount, S->getBody());
1027     BreakContinue BC = BreakContinueStack.pop_back_val();
1028 
1029     // The body count applies to the area immediately after the range.
1030     auto Gap = findGapAreaBetween(getPreciseTokenLocEnd(S->getRParenLoc()),
1031                                   getStart(S->getBody()));
1032     if (Gap)
1033       fillGapAreaWithCount(Gap->getBegin(), Gap->getEnd(), BodyCount);
1034 
1035     Counter LoopCount =
1036         addCounters(ParentCount, BackedgeCount, BC.ContinueCount);
1037     Counter OutCount =
1038         addCounters(BC.BreakCount, subtractCounters(LoopCount, BodyCount));
1039     if (OutCount != ParentCount)
1040       pushRegion(OutCount);
1041   }
1042 
1043   void VisitObjCForCollectionStmt(const ObjCForCollectionStmt *S) {
1044     extendRegion(S);
1045     Visit(S->getElement());
1046 
1047     Counter ParentCount = getRegion().getCounter();
1048     Counter BodyCount = getRegionCounter(S);
1049 
1050     BreakContinueStack.push_back(BreakContinue());
1051     extendRegion(S->getBody());
1052     Counter BackedgeCount = propagateCounts(BodyCount, S->getBody());
1053     BreakContinue BC = BreakContinueStack.pop_back_val();
1054 
1055     // The body count applies to the area immediately after the collection.
1056     auto Gap = findGapAreaBetween(getPreciseTokenLocEnd(S->getRParenLoc()),
1057                                   getStart(S->getBody()));
1058     if (Gap)
1059       fillGapAreaWithCount(Gap->getBegin(), Gap->getEnd(), BodyCount);
1060 
1061     Counter LoopCount =
1062         addCounters(ParentCount, BackedgeCount, BC.ContinueCount);
1063     Counter OutCount =
1064         addCounters(BC.BreakCount, subtractCounters(LoopCount, BodyCount));
1065     if (OutCount != ParentCount)
1066       pushRegion(OutCount);
1067   }
1068 
1069   void VisitSwitchStmt(const SwitchStmt *S) {
1070     extendRegion(S);
1071     if (S->getInit())
1072       Visit(S->getInit());
1073     Visit(S->getCond());
1074 
1075     BreakContinueStack.push_back(BreakContinue());
1076 
1077     const Stmt *Body = S->getBody();
1078     extendRegion(Body);
1079     if (const auto *CS = dyn_cast<CompoundStmt>(Body)) {
1080       if (!CS->body_empty()) {
1081         // Make a region for the body of the switch.  If the body starts with
1082         // a case, that case will reuse this region; otherwise, this covers
1083         // the unreachable code at the beginning of the switch body.
1084         size_t Index =
1085             pushRegion(Counter::getZero(), getStart(CS->body_front()));
1086         for (const auto *Child : CS->children())
1087           Visit(Child);
1088 
1089         // Set the end for the body of the switch, if it isn't already set.
1090         for (size_t i = RegionStack.size(); i != Index; --i) {
1091           if (!RegionStack[i - 1].hasEndLoc())
1092             RegionStack[i - 1].setEndLoc(getEnd(CS->body_back()));
1093         }
1094 
1095         popRegions(Index);
1096       }
1097     } else
1098       propagateCounts(Counter::getZero(), Body);
1099     BreakContinue BC = BreakContinueStack.pop_back_val();
1100 
1101     if (!BreakContinueStack.empty())
1102       BreakContinueStack.back().ContinueCount = addCounters(
1103           BreakContinueStack.back().ContinueCount, BC.ContinueCount);
1104 
1105     Counter ExitCount = getRegionCounter(S);
1106     SourceLocation ExitLoc = getEnd(S);
1107     pushRegion(ExitCount);
1108 
1109     // Ensure that handleFileExit recognizes when the end location is located
1110     // in a different file.
1111     MostRecentLocation = getStart(S);
1112     handleFileExit(ExitLoc);
1113   }
1114 
1115   void VisitSwitchCase(const SwitchCase *S) {
1116     extendRegion(S);
1117 
1118     SourceMappingRegion &Parent = getRegion();
1119 
1120     Counter Count = addCounters(Parent.getCounter(), getRegionCounter(S));
1121     // Reuse the existing region if it starts at our label. This is typical of
1122     // the first case in a switch.
1123     if (Parent.hasStartLoc() && Parent.getStartLoc() == getStart(S))
1124       Parent.setCounter(Count);
1125     else
1126       pushRegion(Count, getStart(S));
1127 
1128     if (const auto *CS = dyn_cast<CaseStmt>(S)) {
1129       Visit(CS->getLHS());
1130       if (const Expr *RHS = CS->getRHS())
1131         Visit(RHS);
1132     }
1133     Visit(S->getSubStmt());
1134   }
1135 
1136   void VisitIfStmt(const IfStmt *S) {
1137     extendRegion(S);
1138     if (S->getInit())
1139       Visit(S->getInit());
1140 
1141     // Extend into the condition before we propagate through it below - this is
1142     // needed to handle macros that generate the "if" but not the condition.
1143     extendRegion(S->getCond());
1144 
1145     Counter ParentCount = getRegion().getCounter();
1146     Counter ThenCount = getRegionCounter(S);
1147 
1148     // Emitting a counter for the condition makes it easier to interpret the
1149     // counter for the body when looking at the coverage.
1150     propagateCounts(ParentCount, S->getCond());
1151 
1152     // The 'then' count applies to the area immediately after the condition.
1153     auto Gap = findGapAreaBetween(S->getCond(), S->getThen());
1154     if (Gap)
1155       fillGapAreaWithCount(Gap->getBegin(), Gap->getEnd(), ThenCount);
1156 
1157     extendRegion(S->getThen());
1158     Counter OutCount = propagateCounts(ThenCount, S->getThen());
1159 
1160     Counter ElseCount = subtractCounters(ParentCount, ThenCount);
1161     if (const Stmt *Else = S->getElse()) {
1162       // The 'else' count applies to the area immediately after the 'then'.
1163       Gap = findGapAreaBetween(S->getThen(), Else);
1164       if (Gap)
1165         fillGapAreaWithCount(Gap->getBegin(), Gap->getEnd(), ElseCount);
1166       extendRegion(Else);
1167       OutCount = addCounters(OutCount, propagateCounts(ElseCount, Else));
1168     } else
1169       OutCount = addCounters(OutCount, ElseCount);
1170 
1171     if (OutCount != ParentCount)
1172       pushRegion(OutCount);
1173   }
1174 
1175   void VisitCXXTryStmt(const CXXTryStmt *S) {
1176     extendRegion(S);
1177     // Handle macros that generate the "try" but not the rest.
1178     extendRegion(S->getTryBlock());
1179 
1180     Counter ParentCount = getRegion().getCounter();
1181     propagateCounts(ParentCount, S->getTryBlock());
1182 
1183     for (unsigned I = 0, E = S->getNumHandlers(); I < E; ++I)
1184       Visit(S->getHandler(I));
1185 
1186     Counter ExitCount = getRegionCounter(S);
1187     pushRegion(ExitCount);
1188   }
1189 
1190   void VisitCXXCatchStmt(const CXXCatchStmt *S) {
1191     propagateCounts(getRegionCounter(S), S->getHandlerBlock());
1192   }
1193 
1194   void VisitAbstractConditionalOperator(const AbstractConditionalOperator *E) {
1195     extendRegion(E);
1196 
1197     Counter ParentCount = getRegion().getCounter();
1198     Counter TrueCount = getRegionCounter(E);
1199 
1200     Visit(E->getCond());
1201 
1202     if (!isa<BinaryConditionalOperator>(E)) {
1203       // The 'then' count applies to the area immediately after the condition.
1204       auto Gap =
1205           findGapAreaBetween(E->getQuestionLoc(), getStart(E->getTrueExpr()));
1206       if (Gap)
1207         fillGapAreaWithCount(Gap->getBegin(), Gap->getEnd(), TrueCount);
1208 
1209       extendRegion(E->getTrueExpr());
1210       propagateCounts(TrueCount, E->getTrueExpr());
1211     }
1212 
1213     extendRegion(E->getFalseExpr());
1214     propagateCounts(subtractCounters(ParentCount, TrueCount),
1215                     E->getFalseExpr());
1216   }
1217 
1218   void VisitBinLAnd(const BinaryOperator *E) {
1219     extendRegion(E->getLHS());
1220     propagateCounts(getRegion().getCounter(), E->getLHS());
1221     handleFileExit(getEnd(E->getLHS()));
1222 
1223     extendRegion(E->getRHS());
1224     propagateCounts(getRegionCounter(E), E->getRHS());
1225   }
1226 
1227   void VisitBinLOr(const BinaryOperator *E) {
1228     extendRegion(E->getLHS());
1229     propagateCounts(getRegion().getCounter(), E->getLHS());
1230     handleFileExit(getEnd(E->getLHS()));
1231 
1232     extendRegion(E->getRHS());
1233     propagateCounts(getRegionCounter(E), E->getRHS());
1234   }
1235 
1236   void VisitLambdaExpr(const LambdaExpr *LE) {
1237     // Lambdas are treated as their own functions for now, so we shouldn't
1238     // propagate counts into them.
1239   }
1240 };
1241 
1242 std::string getCoverageSection(const CodeGenModule &CGM) {
1243   return llvm::getInstrProfSectionName(
1244       llvm::IPSK_covmap,
1245       CGM.getContext().getTargetInfo().getTriple().getObjectFormat());
1246 }
1247 
1248 std::string normalizeFilename(StringRef Filename) {
1249   llvm::SmallString<256> Path(Filename);
1250   llvm::sys::fs::make_absolute(Path);
1251   llvm::sys::path::remove_dots(Path, /*remove_dot_dots=*/true);
1252   return Path.str().str();
1253 }
1254 
1255 } // end anonymous namespace
1256 
1257 static void dump(llvm::raw_ostream &OS, StringRef FunctionName,
1258                  ArrayRef<CounterExpression> Expressions,
1259                  ArrayRef<CounterMappingRegion> Regions) {
1260   OS << FunctionName << ":\n";
1261   CounterMappingContext Ctx(Expressions);
1262   for (const auto &R : Regions) {
1263     OS.indent(2);
1264     switch (R.Kind) {
1265     case CounterMappingRegion::CodeRegion:
1266       break;
1267     case CounterMappingRegion::ExpansionRegion:
1268       OS << "Expansion,";
1269       break;
1270     case CounterMappingRegion::SkippedRegion:
1271       OS << "Skipped,";
1272       break;
1273     case CounterMappingRegion::GapRegion:
1274       OS << "Gap,";
1275       break;
1276     }
1277 
1278     OS << "File " << R.FileID << ", " << R.LineStart << ":" << R.ColumnStart
1279        << " -> " << R.LineEnd << ":" << R.ColumnEnd << " = ";
1280     Ctx.dump(R.Count, OS);
1281     if (R.Kind == CounterMappingRegion::ExpansionRegion)
1282       OS << " (Expanded file = " << R.ExpandedFileID << ")";
1283     OS << "\n";
1284   }
1285 }
1286 
1287 void CoverageMappingModuleGen::addFunctionMappingRecord(
1288     llvm::GlobalVariable *NamePtr, StringRef NameValue, uint64_t FuncHash,
1289     const std::string &CoverageMapping, bool IsUsed) {
1290   llvm::LLVMContext &Ctx = CGM.getLLVMContext();
1291   if (!FunctionRecordTy) {
1292 #define COVMAP_FUNC_RECORD(Type, LLVMType, Name, Init) LLVMType,
1293     llvm::Type *FunctionRecordTypes[] = {
1294       #include "llvm/ProfileData/InstrProfData.inc"
1295     };
1296     FunctionRecordTy =
1297         llvm::StructType::get(Ctx, makeArrayRef(FunctionRecordTypes),
1298                               /*isPacked=*/true);
1299   }
1300 
1301   #define COVMAP_FUNC_RECORD(Type, LLVMType, Name, Init) Init,
1302   llvm::Constant *FunctionRecordVals[] = {
1303       #include "llvm/ProfileData/InstrProfData.inc"
1304   };
1305   FunctionRecords.push_back(llvm::ConstantStruct::get(
1306       FunctionRecordTy, makeArrayRef(FunctionRecordVals)));
1307   if (!IsUsed)
1308     FunctionNames.push_back(
1309         llvm::ConstantExpr::getBitCast(NamePtr, llvm::Type::getInt8PtrTy(Ctx)));
1310   CoverageMappings.push_back(CoverageMapping);
1311 
1312   if (CGM.getCodeGenOpts().DumpCoverageMapping) {
1313     // Dump the coverage mapping data for this function by decoding the
1314     // encoded data. This allows us to dump the mapping regions which were
1315     // also processed by the CoverageMappingWriter which performs
1316     // additional minimization operations such as reducing the number of
1317     // expressions.
1318     std::vector<StringRef> Filenames;
1319     std::vector<CounterExpression> Expressions;
1320     std::vector<CounterMappingRegion> Regions;
1321     llvm::SmallVector<std::string, 16> FilenameStrs;
1322     llvm::SmallVector<StringRef, 16> FilenameRefs;
1323     FilenameStrs.resize(FileEntries.size());
1324     FilenameRefs.resize(FileEntries.size());
1325     for (const auto &Entry : FileEntries) {
1326       auto I = Entry.second;
1327       FilenameStrs[I] = normalizeFilename(Entry.first->getName());
1328       FilenameRefs[I] = FilenameStrs[I];
1329     }
1330     RawCoverageMappingReader Reader(CoverageMapping, FilenameRefs, Filenames,
1331                                     Expressions, Regions);
1332     if (Reader.read())
1333       return;
1334     dump(llvm::outs(), NameValue, Expressions, Regions);
1335   }
1336 }
1337 
1338 void CoverageMappingModuleGen::emit() {
1339   if (FunctionRecords.empty())
1340     return;
1341   llvm::LLVMContext &Ctx = CGM.getLLVMContext();
1342   auto *Int32Ty = llvm::Type::getInt32Ty(Ctx);
1343 
1344   // Create the filenames and merge them with coverage mappings
1345   llvm::SmallVector<std::string, 16> FilenameStrs;
1346   llvm::SmallVector<StringRef, 16> FilenameRefs;
1347   FilenameStrs.resize(FileEntries.size());
1348   FilenameRefs.resize(FileEntries.size());
1349   for (const auto &Entry : FileEntries) {
1350     auto I = Entry.second;
1351     FilenameStrs[I] = normalizeFilename(Entry.first->getName());
1352     FilenameRefs[I] = FilenameStrs[I];
1353   }
1354 
1355   std::string FilenamesAndCoverageMappings;
1356   llvm::raw_string_ostream OS(FilenamesAndCoverageMappings);
1357   CoverageFilenamesSectionWriter(FilenameRefs).write(OS);
1358   std::string RawCoverageMappings =
1359       llvm::join(CoverageMappings.begin(), CoverageMappings.end(), "");
1360   OS << RawCoverageMappings;
1361   size_t CoverageMappingSize = RawCoverageMappings.size();
1362   size_t FilenamesSize = OS.str().size() - CoverageMappingSize;
1363   // Append extra zeroes if necessary to ensure that the size of the filenames
1364   // and coverage mappings is a multiple of 8.
1365   if (size_t Rem = OS.str().size() % 8) {
1366     CoverageMappingSize += 8 - Rem;
1367     for (size_t I = 0, S = 8 - Rem; I < S; ++I)
1368       OS << '\0';
1369   }
1370   auto *FilenamesAndMappingsVal =
1371       llvm::ConstantDataArray::getString(Ctx, OS.str(), false);
1372 
1373   // Create the deferred function records array
1374   auto RecordsTy =
1375       llvm::ArrayType::get(FunctionRecordTy, FunctionRecords.size());
1376   auto RecordsVal = llvm::ConstantArray::get(RecordsTy, FunctionRecords);
1377 
1378   llvm::Type *CovDataHeaderTypes[] = {
1379 #define COVMAP_HEADER(Type, LLVMType, Name, Init) LLVMType,
1380 #include "llvm/ProfileData/InstrProfData.inc"
1381   };
1382   auto CovDataHeaderTy =
1383       llvm::StructType::get(Ctx, makeArrayRef(CovDataHeaderTypes));
1384   llvm::Constant *CovDataHeaderVals[] = {
1385 #define COVMAP_HEADER(Type, LLVMType, Name, Init) Init,
1386 #include "llvm/ProfileData/InstrProfData.inc"
1387   };
1388   auto CovDataHeaderVal = llvm::ConstantStruct::get(
1389       CovDataHeaderTy, makeArrayRef(CovDataHeaderVals));
1390 
1391   // Create the coverage data record
1392   llvm::Type *CovDataTypes[] = {CovDataHeaderTy, RecordsTy,
1393                                 FilenamesAndMappingsVal->getType()};
1394   auto CovDataTy = llvm::StructType::get(Ctx, makeArrayRef(CovDataTypes));
1395   llvm::Constant *TUDataVals[] = {CovDataHeaderVal, RecordsVal,
1396                                   FilenamesAndMappingsVal};
1397   auto CovDataVal =
1398       llvm::ConstantStruct::get(CovDataTy, makeArrayRef(TUDataVals));
1399   auto CovData = new llvm::GlobalVariable(
1400       CGM.getModule(), CovDataTy, true, llvm::GlobalValue::InternalLinkage,
1401       CovDataVal, llvm::getCoverageMappingVarName());
1402 
1403   CovData->setSection(getCoverageSection(CGM));
1404   CovData->setAlignment(8);
1405 
1406   // Make sure the data doesn't get deleted.
1407   CGM.addUsedGlobal(CovData);
1408   // Create the deferred function records array
1409   if (!FunctionNames.empty()) {
1410     auto NamesArrTy = llvm::ArrayType::get(llvm::Type::getInt8PtrTy(Ctx),
1411                                            FunctionNames.size());
1412     auto NamesArrVal = llvm::ConstantArray::get(NamesArrTy, FunctionNames);
1413     // This variable will *NOT* be emitted to the object file. It is used
1414     // to pass the list of names referenced to codegen.
1415     new llvm::GlobalVariable(CGM.getModule(), NamesArrTy, true,
1416                              llvm::GlobalValue::InternalLinkage, NamesArrVal,
1417                              llvm::getCoverageUnusedNamesVarName());
1418   }
1419 }
1420 
1421 unsigned CoverageMappingModuleGen::getFileID(const FileEntry *File) {
1422   auto It = FileEntries.find(File);
1423   if (It != FileEntries.end())
1424     return It->second;
1425   unsigned FileID = FileEntries.size();
1426   FileEntries.insert(std::make_pair(File, FileID));
1427   return FileID;
1428 }
1429 
1430 void CoverageMappingGen::emitCounterMapping(const Decl *D,
1431                                             llvm::raw_ostream &OS) {
1432   assert(CounterMap);
1433   CounterCoverageMappingBuilder Walker(CVM, *CounterMap, SM, LangOpts);
1434   Walker.VisitDecl(D);
1435   Walker.write(OS);
1436 }
1437 
1438 void CoverageMappingGen::emitEmptyMapping(const Decl *D,
1439                                           llvm::raw_ostream &OS) {
1440   EmptyCoverageMappingBuilder Walker(CVM, SM, LangOpts);
1441   Walker.VisitDecl(D);
1442   Walker.write(OS);
1443 }
1444