1 //===- unittest/ProfileData/CoverageMappingTest.cpp -------------------------=//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "llvm/ProfileData/CoverageMapping.h"
11 #include "llvm/ProfileData/CoverageMappingReader.h"
12 #include "llvm/ProfileData/CoverageMappingWriter.h"
13 #include "llvm/ProfileData/InstrProfReader.h"
14 #include "llvm/ProfileData/InstrProfWriter.h"
15 #include "llvm/Support/raw_ostream.h"
16 #include "gtest/gtest.h"
17 
18 #include <sstream>
19 
20 using namespace llvm;
21 using namespace coverage;
22 
23 static ::testing::AssertionResult NoError(std::error_code EC) {
24   if (!EC)
25     return ::testing::AssertionSuccess();
26   return ::testing::AssertionFailure() << "error " << EC.value()
27                                        << ": " << EC.message();
28 }
29 
30 namespace llvm {
31 namespace coverage {
32 void PrintTo(const Counter &C, ::std::ostream *os) {
33   if (C.isZero())
34     *os << "Zero";
35   else if (C.isExpression())
36     *os << "Expression " << C.getExpressionID();
37   else
38     *os << "Counter " << C.getCounterID();
39 }
40 
41 void PrintTo(const CoverageSegment &S, ::std::ostream *os) {
42   *os << "CoverageSegment(" << S.Line << ", " << S.Col << ", ";
43   if (S.HasCount)
44     *os << S.Count << ", ";
45   *os << (S.IsRegionEntry ? "true" : "false") << ")";
46 }
47 }
48 }
49 
50 namespace {
51 
52 struct OneFunctionCoverageReader : CoverageMappingReader {
53   StringRef Name;
54   uint64_t Hash;
55   std::vector<StringRef> Filenames;
56   ArrayRef<CounterMappingRegion> Regions;
57   bool Done;
58 
59   OneFunctionCoverageReader(StringRef Name, uint64_t Hash,
60                             ArrayRef<StringRef> Filenames,
61                             ArrayRef<CounterMappingRegion> Regions)
62       : Name(Name), Hash(Hash), Filenames(Filenames), Regions(Regions),
63         Done(false) {}
64 
65   std::error_code readNextRecord(CoverageMappingRecord &Record) override {
66     if (Done)
67       return instrprof_error::eof;
68     Done = true;
69 
70     Record.FunctionName = Name;
71     Record.FunctionHash = Hash;
72     Record.Filenames = Filenames;
73     Record.Expressions = {};
74     Record.MappingRegions = Regions;
75     return instrprof_error::success;
76   }
77 };
78 
79 struct CoverageMappingTest : ::testing::Test {
80   StringMap<unsigned> Files;
81   unsigned NextFile;
82   std::vector<CounterMappingRegion> InputCMRs;
83 
84   std::vector<StringRef> OutputFiles;
85   std::vector<CounterExpression> OutputExpressions;
86   std::vector<CounterMappingRegion> OutputCMRs;
87 
88   InstrProfWriter ProfileWriter;
89   std::unique_ptr<IndexedInstrProfReader> ProfileReader;
90 
91   std::unique_ptr<CoverageMapping> LoadedCoverage;
92 
93   void SetUp() override {
94     NextFile = 0;
95     ProfileWriter.setOutputSparse(false);
96   }
97 
98   unsigned getFile(StringRef Name) {
99     auto R = Files.find(Name);
100     if (R != Files.end())
101       return R->second;
102     Files[Name] = NextFile;
103     return NextFile++;
104   }
105 
106   void addCMR(Counter C, StringRef File, unsigned LS, unsigned CS, unsigned LE,
107               unsigned CE) {
108     InputCMRs.push_back(
109         CounterMappingRegion::makeRegion(C, getFile(File), LS, CS, LE, CE));
110   }
111 
112   void addExpansionCMR(StringRef File, StringRef ExpandedFile, unsigned LS,
113                        unsigned CS, unsigned LE, unsigned CE) {
114     InputCMRs.push_back(CounterMappingRegion::makeExpansion(
115         getFile(File), getFile(ExpandedFile), LS, CS, LE, CE));
116   }
117 
118   std::string writeCoverageRegions() {
119     SmallVector<unsigned, 8> FileIDs;
120     for (const auto &E : Files)
121       FileIDs.push_back(E.getValue());
122     std::string Coverage;
123     llvm::raw_string_ostream OS(Coverage);
124     CoverageMappingWriter(FileIDs, None, InputCMRs).write(OS);
125     return OS.str();
126   }
127 
128   void readCoverageRegions(std::string Coverage) {
129     SmallVector<StringRef, 8> Filenames;
130     for (const auto &E : Files)
131       Filenames.push_back(E.getKey());
132     RawCoverageMappingReader Reader(Coverage, Filenames, OutputFiles,
133                                     OutputExpressions, OutputCMRs);
134     ASSERT_TRUE(NoError(Reader.read()));
135   }
136 
137   void readProfCounts() {
138     auto Profile = ProfileWriter.writeBuffer();
139     auto ReaderOrErr = IndexedInstrProfReader::create(std::move(Profile));
140     ASSERT_TRUE(NoError(ReaderOrErr.getError()));
141     ProfileReader = std::move(ReaderOrErr.get());
142   }
143 
144   void loadCoverageMapping(StringRef FuncName, uint64_t Hash) {
145     std::string Regions = writeCoverageRegions();
146     readCoverageRegions(Regions);
147 
148     SmallVector<StringRef, 8> Filenames;
149     for (const auto &E : Files)
150       Filenames.push_back(E.getKey());
151     OneFunctionCoverageReader CovReader(FuncName, Hash, Filenames, OutputCMRs);
152     auto CoverageOrErr = CoverageMapping::load(CovReader, *ProfileReader);
153     ASSERT_TRUE(NoError(CoverageOrErr.getError()));
154     LoadedCoverage = std::move(CoverageOrErr.get());
155   }
156 };
157 
158 struct MaybeSparseCoverageMappingTest
159     : public CoverageMappingTest,
160       public ::testing::WithParamInterface<bool> {
161   void SetUp() {
162     CoverageMappingTest::SetUp();
163     ProfileWriter.setOutputSparse(GetParam());
164   }
165 };
166 
167 TEST_P(MaybeSparseCoverageMappingTest, basic_write_read) {
168   addCMR(Counter::getCounter(0), "foo", 1, 1, 1, 1);
169   addCMR(Counter::getCounter(1), "foo", 2, 1, 2, 2);
170   addCMR(Counter::getZero(),     "foo", 3, 1, 3, 4);
171   addCMR(Counter::getCounter(2), "foo", 4, 1, 4, 8);
172   addCMR(Counter::getCounter(3), "bar", 1, 2, 3, 4);
173   std::string Coverage = writeCoverageRegions();
174   readCoverageRegions(Coverage);
175 
176   size_t N = makeArrayRef(InputCMRs).size();
177   ASSERT_EQ(N, OutputCMRs.size());
178   for (size_t I = 0; I < N; ++I) {
179     ASSERT_EQ(InputCMRs[I].Count,      OutputCMRs[I].Count);
180     ASSERT_EQ(InputCMRs[I].FileID,     OutputCMRs[I].FileID);
181     ASSERT_EQ(InputCMRs[I].startLoc(), OutputCMRs[I].startLoc());
182     ASSERT_EQ(InputCMRs[I].endLoc(),   OutputCMRs[I].endLoc());
183     ASSERT_EQ(InputCMRs[I].Kind,       OutputCMRs[I].Kind);
184   }
185 }
186 
187 TEST_P(MaybeSparseCoverageMappingTest, expansion_gets_first_counter) {
188   addCMR(Counter::getCounter(1), "foo", 10, 1, 10, 2);
189   // This starts earlier in "foo", so the expansion should get its counter.
190   addCMR(Counter::getCounter(2), "foo", 1, 1, 20, 1);
191   addExpansionCMR("bar", "foo", 3, 3, 3, 3);
192   std::string Coverage = writeCoverageRegions();
193   readCoverageRegions(Coverage);
194 
195   ASSERT_EQ(CounterMappingRegion::ExpansionRegion, OutputCMRs[2].Kind);
196   ASSERT_EQ(Counter::getCounter(2), OutputCMRs[2].Count);
197   ASSERT_EQ(3U, OutputCMRs[2].LineStart);
198 }
199 
200 TEST_P(MaybeSparseCoverageMappingTest, basic_coverage_iteration) {
201   InstrProfRecord Record("func", 0x1234, {30, 20, 10, 0});
202   ProfileWriter.addRecord(std::move(Record));
203   readProfCounts();
204 
205   addCMR(Counter::getCounter(0), "file1", 1, 1, 9, 9);
206   addCMR(Counter::getCounter(1), "file1", 1, 1, 4, 7);
207   addCMR(Counter::getCounter(2), "file1", 5, 8, 9, 1);
208   addCMR(Counter::getCounter(3), "file1", 10, 10, 11, 11);
209   loadCoverageMapping("func", 0x1234);
210 
211   CoverageData Data = LoadedCoverage->getCoverageForFile("file1");
212   std::vector<CoverageSegment> Segments(Data.begin(), Data.end());
213   ASSERT_EQ(7U, Segments.size());
214   ASSERT_EQ(CoverageSegment(1, 1, 20, true),  Segments[0]);
215   ASSERT_EQ(CoverageSegment(4, 7, 30, false), Segments[1]);
216   ASSERT_EQ(CoverageSegment(5, 8, 10, true),  Segments[2]);
217   ASSERT_EQ(CoverageSegment(9, 1, 30, false), Segments[3]);
218   ASSERT_EQ(CoverageSegment(9, 9, false),     Segments[4]);
219   ASSERT_EQ(CoverageSegment(10, 10, 0, true), Segments[5]);
220   ASSERT_EQ(CoverageSegment(11, 11, false),   Segments[6]);
221 }
222 
223 TEST_P(MaybeSparseCoverageMappingTest, uncovered_function) {
224   readProfCounts();
225 
226   addCMR(Counter::getZero(), "file1", 1, 2, 3, 4);
227   loadCoverageMapping("func", 0x1234);
228 
229   CoverageData Data = LoadedCoverage->getCoverageForFile("file1");
230   std::vector<CoverageSegment> Segments(Data.begin(), Data.end());
231   ASSERT_EQ(2U, Segments.size());
232   ASSERT_EQ(CoverageSegment(1, 2, 0, true), Segments[0]);
233   ASSERT_EQ(CoverageSegment(3, 4, false),   Segments[1]);
234 }
235 
236 TEST_P(MaybeSparseCoverageMappingTest, uncovered_function_with_mapping) {
237   readProfCounts();
238 
239   addCMR(Counter::getCounter(0), "file1", 1, 1, 9, 9);
240   addCMR(Counter::getCounter(1), "file1", 1, 1, 4, 7);
241   loadCoverageMapping("func", 0x1234);
242 
243   CoverageData Data = LoadedCoverage->getCoverageForFile("file1");
244   std::vector<CoverageSegment> Segments(Data.begin(), Data.end());
245   ASSERT_EQ(3U, Segments.size());
246   ASSERT_EQ(CoverageSegment(1, 1, 0, true),  Segments[0]);
247   ASSERT_EQ(CoverageSegment(4, 7, 0, false), Segments[1]);
248   ASSERT_EQ(CoverageSegment(9, 9, false),    Segments[2]);
249 }
250 
251 TEST_P(MaybeSparseCoverageMappingTest, combine_regions) {
252   InstrProfRecord Record("func", 0x1234, {10, 20, 30});
253   ProfileWriter.addRecord(std::move(Record));
254   readProfCounts();
255 
256   addCMR(Counter::getCounter(0), "file1", 1, 1, 9, 9);
257   addCMR(Counter::getCounter(1), "file1", 3, 3, 4, 4);
258   addCMR(Counter::getCounter(2), "file1", 3, 3, 4, 4);
259   loadCoverageMapping("func", 0x1234);
260 
261   CoverageData Data = LoadedCoverage->getCoverageForFile("file1");
262   std::vector<CoverageSegment> Segments(Data.begin(), Data.end());
263   ASSERT_EQ(4U, Segments.size());
264   ASSERT_EQ(CoverageSegment(1, 1, 10, true), Segments[0]);
265   ASSERT_EQ(CoverageSegment(3, 3, 50, true), Segments[1]);
266   ASSERT_EQ(CoverageSegment(4, 4, 10, false), Segments[2]);
267   ASSERT_EQ(CoverageSegment(9, 9, false), Segments[3]);
268 }
269 
270 TEST_P(MaybeSparseCoverageMappingTest, dont_combine_expansions) {
271   InstrProfRecord Record1("func", 0x1234, {10, 20});
272   InstrProfRecord Record2("func", 0x1234, {0, 0});
273   ProfileWriter.addRecord(std::move(Record1));
274   ProfileWriter.addRecord(std::move(Record2));
275   readProfCounts();
276 
277   addCMR(Counter::getCounter(0), "file1", 1, 1, 9, 9);
278   addCMR(Counter::getCounter(1), "file1", 3, 3, 4, 4);
279   addCMR(Counter::getCounter(1), "include1", 6, 6, 7, 7);
280   addExpansionCMR("file1", "include1", 3, 3, 4, 4);
281   loadCoverageMapping("func", 0x1234);
282 
283   CoverageData Data = LoadedCoverage->getCoverageForFile("file1");
284   std::vector<CoverageSegment> Segments(Data.begin(), Data.end());
285   ASSERT_EQ(4U, Segments.size());
286   ASSERT_EQ(CoverageSegment(1, 1, 10, true), Segments[0]);
287   ASSERT_EQ(CoverageSegment(3, 3, 20, true), Segments[1]);
288   ASSERT_EQ(CoverageSegment(4, 4, 10, false), Segments[2]);
289   ASSERT_EQ(CoverageSegment(9, 9, false), Segments[3]);
290 }
291 
292 TEST_P(MaybeSparseCoverageMappingTest, strip_filename_prefix) {
293   InstrProfRecord Record("file1:func", 0x1234, {0});
294   ProfileWriter.addRecord(std::move(Record));
295   readProfCounts();
296 
297   addCMR(Counter::getCounter(0), "file1", 1, 1, 9, 9);
298   loadCoverageMapping("file1:func", 0x1234);
299 
300   std::vector<std::string> Names;
301   for (const auto &Func : LoadedCoverage->getCoveredFunctions())
302     Names.push_back(Func.Name);
303   ASSERT_EQ(1U, Names.size());
304   ASSERT_EQ("func", Names[0]);
305 }
306 
307 INSTANTIATE_TEST_CASE_P(MaybeSparse, MaybeSparseCoverageMappingTest,
308                         ::testing::Bool());
309 
310 } // end anonymous namespace
311