1 //===- CodeCoverage.cpp - Coverage tool based on profiling instrumentation-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // The 'CodeCoverageTool' class implements a command line tool to analyze and
10 // report coverage information using the profiling instrumentation and code
11 // coverage mapping.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #include "CoverageExporterJson.h"
16 #include "CoverageExporterLcov.h"
17 #include "CoverageFilters.h"
18 #include "CoverageReport.h"
19 #include "CoverageSummaryInfo.h"
20 #include "CoverageViewOptions.h"
21 #include "RenderingSupport.h"
22 #include "SourceCoverageView.h"
23 #include "llvm/ADT/SmallString.h"
24 #include "llvm/ADT/StringRef.h"
25 #include "llvm/Debuginfod/BuildIDFetcher.h"
26 #include "llvm/Debuginfod/Debuginfod.h"
27 #include "llvm/Debuginfod/HTTPClient.h"
28 #include "llvm/Object/BuildID.h"
29 #include "llvm/ProfileData/Coverage/CoverageMapping.h"
30 #include "llvm/ProfileData/InstrProfReader.h"
31 #include "llvm/Support/CommandLine.h"
32 #include "llvm/Support/FileSystem.h"
33 #include "llvm/Support/Format.h"
34 #include "llvm/Support/MemoryBuffer.h"
35 #include "llvm/Support/Path.h"
36 #include "llvm/Support/Process.h"
37 #include "llvm/Support/Program.h"
38 #include "llvm/Support/ScopedPrinter.h"
39 #include "llvm/Support/SpecialCaseList.h"
40 #include "llvm/Support/ThreadPool.h"
41 #include "llvm/Support/Threading.h"
42 #include "llvm/Support/ToolOutputFile.h"
43 #include "llvm/Support/VirtualFileSystem.h"
44 #include "llvm/TargetParser/Triple.h"
45 
46 #include <functional>
47 #include <map>
48 #include <optional>
49 #include <system_error>
50 
51 using namespace llvm;
52 using namespace coverage;
53 
54 void exportCoverageDataToJson(const coverage::CoverageMapping &CoverageMapping,
55                               const CoverageViewOptions &Options,
56                               raw_ostream &OS);
57 
58 namespace {
59 /// The implementation of the coverage tool.
60 class CodeCoverageTool {
61 public:
62   enum Command {
63     /// The show command.
64     Show,
65     /// The report command.
66     Report,
67     /// The export command.
68     Export
69   };
70 
71   int run(Command Cmd, int argc, const char **argv);
72 
73 private:
74   /// Print the error message to the error output stream.
75   void error(const Twine &Message, StringRef Whence = "");
76 
77   /// Print the warning message to the error output stream.
78   void warning(const Twine &Message, StringRef Whence = "");
79 
80   /// Convert \p Path into an absolute path and append it to the list
81   /// of collected paths.
82   void addCollectedPath(const std::string &Path);
83 
84   /// If \p Path is a regular file, collect the path. If it's a
85   /// directory, recursively collect all of the paths within the directory.
86   void collectPaths(const std::string &Path);
87 
88   /// Check if the two given files are the same file.
89   bool isEquivalentFile(StringRef FilePath1, StringRef FilePath2);
90 
91   /// Retrieve a file status with a cache.
92   std::optional<sys::fs::file_status> getFileStatus(StringRef FilePath);
93 
94   /// Return a memory buffer for the given source file.
95   ErrorOr<const MemoryBuffer &> getSourceFile(StringRef SourceFile);
96 
97   /// Create source views for the expansions of the view.
98   void attachExpansionSubViews(SourceCoverageView &View,
99                                ArrayRef<ExpansionRecord> Expansions,
100                                const CoverageMapping &Coverage);
101 
102   /// Create source views for the branches of the view.
103   void attachBranchSubViews(SourceCoverageView &View, StringRef SourceName,
104                             ArrayRef<CountedRegion> Branches,
105                             const MemoryBuffer &File,
106                             CoverageData &CoverageInfo);
107 
108   /// Create source views for the MCDC records.
109   void attachMCDCSubViews(SourceCoverageView &View, StringRef SourceName,
110                           ArrayRef<MCDCRecord> MCDCRecords,
111                           const MemoryBuffer &File, CoverageData &CoverageInfo);
112 
113   /// Create the source view of a particular function.
114   std::unique_ptr<SourceCoverageView>
115   createFunctionView(const FunctionRecord &Function,
116                      const CoverageMapping &Coverage);
117 
118   /// Create the main source view of a particular source file.
119   std::unique_ptr<SourceCoverageView>
120   createSourceFileView(StringRef SourceFile, const CoverageMapping &Coverage);
121 
122   /// Load the coverage mapping data. Return nullptr if an error occurred.
123   std::unique_ptr<CoverageMapping> load();
124 
125   /// Create a mapping from files in the Coverage data to local copies
126   /// (path-equivalence).
127   void remapPathNames(const CoverageMapping &Coverage);
128 
129   /// Remove input source files which aren't mapped by \p Coverage.
130   void removeUnmappedInputs(const CoverageMapping &Coverage);
131 
132   /// If a demangler is available, demangle all symbol names.
133   void demangleSymbols(const CoverageMapping &Coverage);
134 
135   /// Write out a source file view to the filesystem.
136   void writeSourceFileView(StringRef SourceFile, CoverageMapping *Coverage,
137                            CoveragePrinter *Printer, bool ShowFilenames);
138 
139   typedef llvm::function_ref<int(int, const char **)> CommandLineParserType;
140 
141   int doShow(int argc, const char **argv,
142              CommandLineParserType commandLineParser);
143 
144   int doReport(int argc, const char **argv,
145                CommandLineParserType commandLineParser);
146 
147   int doExport(int argc, const char **argv,
148                CommandLineParserType commandLineParser);
149 
150   std::vector<StringRef> ObjectFilenames;
151   CoverageViewOptions ViewOpts;
152   CoverageFiltersMatchAll Filters;
153   CoverageFilters IgnoreFilenameFilters;
154 
155   /// True if InputSourceFiles are provided.
156   bool HadSourceFiles = false;
157 
158   /// The path to the indexed profile.
159   std::string PGOFilename;
160 
161   /// A list of input source files.
162   std::vector<std::string> SourceFiles;
163 
164   /// In -path-equivalence mode, this maps the absolute paths from the coverage
165   /// mapping data to the input source files.
166   StringMap<std::string> RemappedFilenames;
167 
168   /// The coverage data path to be remapped from, and the source path to be
169   /// remapped to, when using -path-equivalence.
170   std::optional<std::vector<std::pair<std::string, std::string>>>
171       PathRemappings;
172 
173   /// File status cache used when finding the same file.
174   StringMap<std::optional<sys::fs::file_status>> FileStatusCache;
175 
176   /// The architecture the coverage mapping data targets.
177   std::vector<StringRef> CoverageArches;
178 
179   /// A cache for demangled symbols.
180   DemangleCache DC;
181 
182   /// A lock which guards printing to stderr.
183   std::mutex ErrsLock;
184 
185   /// A container for input source file buffers.
186   std::mutex LoadedSourceFilesLock;
187   std::vector<std::pair<std::string, std::unique_ptr<MemoryBuffer>>>
188       LoadedSourceFiles;
189 
190   /// Allowlist from -name-allowlist to be used for filtering.
191   std::unique_ptr<SpecialCaseList> NameAllowlist;
192 
193   std::unique_ptr<object::BuildIDFetcher> BIDFetcher;
194 
195   bool CheckBinaryIDs;
196 };
197 }
198 
199 static std::string getErrorString(const Twine &Message, StringRef Whence,
200                                   bool Warning) {
201   std::string Str = (Warning ? "warning" : "error");
202   Str += ": ";
203   if (!Whence.empty())
204     Str += Whence.str() + ": ";
205   Str += Message.str() + "\n";
206   return Str;
207 }
208 
209 void CodeCoverageTool::error(const Twine &Message, StringRef Whence) {
210   std::unique_lock<std::mutex> Guard{ErrsLock};
211   ViewOpts.colored_ostream(errs(), raw_ostream::RED)
212       << getErrorString(Message, Whence, false);
213 }
214 
215 void CodeCoverageTool::warning(const Twine &Message, StringRef Whence) {
216   std::unique_lock<std::mutex> Guard{ErrsLock};
217   ViewOpts.colored_ostream(errs(), raw_ostream::RED)
218       << getErrorString(Message, Whence, true);
219 }
220 
221 void CodeCoverageTool::addCollectedPath(const std::string &Path) {
222   SmallString<128> EffectivePath(Path);
223   if (std::error_code EC = sys::fs::make_absolute(EffectivePath)) {
224     error(EC.message(), Path);
225     return;
226   }
227   sys::path::remove_dots(EffectivePath, /*remove_dot_dot=*/true);
228   if (!IgnoreFilenameFilters.matchesFilename(EffectivePath))
229     SourceFiles.emplace_back(EffectivePath.str());
230   HadSourceFiles = !SourceFiles.empty();
231 }
232 
233 void CodeCoverageTool::collectPaths(const std::string &Path) {
234   llvm::sys::fs::file_status Status;
235   llvm::sys::fs::status(Path, Status);
236   if (!llvm::sys::fs::exists(Status)) {
237     if (PathRemappings)
238       addCollectedPath(Path);
239     else
240       warning("Source file doesn't exist, proceeded by ignoring it.", Path);
241     return;
242   }
243 
244   if (llvm::sys::fs::is_regular_file(Status)) {
245     addCollectedPath(Path);
246     return;
247   }
248 
249   if (llvm::sys::fs::is_directory(Status)) {
250     std::error_code EC;
251     for (llvm::sys::fs::recursive_directory_iterator F(Path, EC), E;
252          F != E; F.increment(EC)) {
253 
254       auto Status = F->status();
255       if (!Status) {
256         warning(Status.getError().message(), F->path());
257         continue;
258       }
259 
260       if (Status->type() == llvm::sys::fs::file_type::regular_file)
261         addCollectedPath(F->path());
262     }
263   }
264 }
265 
266 std::optional<sys::fs::file_status>
267 CodeCoverageTool::getFileStatus(StringRef FilePath) {
268   auto It = FileStatusCache.try_emplace(FilePath);
269   auto &CachedStatus = It.first->getValue();
270   if (!It.second)
271     return CachedStatus;
272 
273   sys::fs::file_status Status;
274   if (!sys::fs::status(FilePath, Status))
275     CachedStatus = Status;
276   return CachedStatus;
277 }
278 
279 bool CodeCoverageTool::isEquivalentFile(StringRef FilePath1,
280                                         StringRef FilePath2) {
281   auto Status1 = getFileStatus(FilePath1);
282   auto Status2 = getFileStatus(FilePath2);
283   return Status1 && Status2 && sys::fs::equivalent(*Status1, *Status2);
284 }
285 
286 ErrorOr<const MemoryBuffer &>
287 CodeCoverageTool::getSourceFile(StringRef SourceFile) {
288   // If we've remapped filenames, look up the real location for this file.
289   std::unique_lock<std::mutex> Guard{LoadedSourceFilesLock};
290   if (!RemappedFilenames.empty()) {
291     auto Loc = RemappedFilenames.find(SourceFile);
292     if (Loc != RemappedFilenames.end())
293       SourceFile = Loc->second;
294   }
295   for (const auto &Files : LoadedSourceFiles)
296     if (isEquivalentFile(SourceFile, Files.first))
297       return *Files.second;
298   auto Buffer = MemoryBuffer::getFile(SourceFile);
299   if (auto EC = Buffer.getError()) {
300     error(EC.message(), SourceFile);
301     return EC;
302   }
303   LoadedSourceFiles.emplace_back(std::string(SourceFile),
304                                  std::move(Buffer.get()));
305   return *LoadedSourceFiles.back().second;
306 }
307 
308 void CodeCoverageTool::attachExpansionSubViews(
309     SourceCoverageView &View, ArrayRef<ExpansionRecord> Expansions,
310     const CoverageMapping &Coverage) {
311   if (!ViewOpts.ShowExpandedRegions)
312     return;
313   for (const auto &Expansion : Expansions) {
314     auto ExpansionCoverage = Coverage.getCoverageForExpansion(Expansion);
315     if (ExpansionCoverage.empty())
316       continue;
317     auto SourceBuffer = getSourceFile(ExpansionCoverage.getFilename());
318     if (!SourceBuffer)
319       continue;
320 
321     auto SubViewBranches = ExpansionCoverage.getBranches();
322     auto SubViewExpansions = ExpansionCoverage.getExpansions();
323     auto SubView =
324         SourceCoverageView::create(Expansion.Function.Name, SourceBuffer.get(),
325                                    ViewOpts, std::move(ExpansionCoverage));
326     attachExpansionSubViews(*SubView, SubViewExpansions, Coverage);
327     attachBranchSubViews(*SubView, Expansion.Function.Name, SubViewBranches,
328                          SourceBuffer.get(), ExpansionCoverage);
329     View.addExpansion(Expansion.Region, std::move(SubView));
330   }
331 }
332 
333 void CodeCoverageTool::attachBranchSubViews(SourceCoverageView &View,
334                                             StringRef SourceName,
335                                             ArrayRef<CountedRegion> Branches,
336                                             const MemoryBuffer &File,
337                                             CoverageData &CoverageInfo) {
338   if (!ViewOpts.ShowBranchCounts && !ViewOpts.ShowBranchPercents)
339     return;
340 
341   const auto *NextBranch = Branches.begin();
342   const auto *EndBranch = Branches.end();
343 
344   // Group branches that have the same line number into the same subview.
345   while (NextBranch != EndBranch) {
346     std::vector<CountedRegion> ViewBranches;
347     unsigned CurrentLine = NextBranch->LineStart;
348 
349     while (NextBranch != EndBranch && CurrentLine == NextBranch->LineStart)
350       ViewBranches.push_back(*NextBranch++);
351 
352     if (!ViewBranches.empty()) {
353       auto SubView = SourceCoverageView::create(SourceName, File, ViewOpts,
354                                                 std::move(CoverageInfo));
355       View.addBranch(CurrentLine, ViewBranches, std::move(SubView));
356     }
357   }
358 }
359 
360 void CodeCoverageTool::attachMCDCSubViews(SourceCoverageView &View,
361                                           StringRef SourceName,
362                                           ArrayRef<MCDCRecord> MCDCRecords,
363                                           const MemoryBuffer &File,
364                                           CoverageData &CoverageInfo) {
365   if (!ViewOpts.ShowMCDC)
366     return;
367 
368   const auto *NextRecord = MCDCRecords.begin();
369   const auto *EndRecord = MCDCRecords.end();
370 
371   // Group and process MCDC records that have the same line number into the
372   // same subview.
373   while (NextRecord != EndRecord) {
374     std::vector<MCDCRecord> ViewMCDCRecords;
375     unsigned CurrentLine = NextRecord->getDecisionRegion().LineEnd;
376 
377     while (NextRecord != EndRecord &&
378            CurrentLine == NextRecord->getDecisionRegion().LineEnd) {
379       ViewMCDCRecords.push_back(*NextRecord++);
380     }
381 
382     if (ViewMCDCRecords.empty())
383       continue;
384 
385     auto SubView = SourceCoverageView::create(SourceName, File, ViewOpts,
386                                               std::move(CoverageInfo));
387     View.addMCDCRecord(CurrentLine, ViewMCDCRecords, std::move(SubView));
388   }
389 }
390 
391 std::unique_ptr<SourceCoverageView>
392 CodeCoverageTool::createFunctionView(const FunctionRecord &Function,
393                                      const CoverageMapping &Coverage) {
394   auto FunctionCoverage = Coverage.getCoverageForFunction(Function);
395   if (FunctionCoverage.empty())
396     return nullptr;
397   auto SourceBuffer = getSourceFile(FunctionCoverage.getFilename());
398   if (!SourceBuffer)
399     return nullptr;
400 
401   auto Branches = FunctionCoverage.getBranches();
402   auto Expansions = FunctionCoverage.getExpansions();
403   auto MCDCRecords = FunctionCoverage.getMCDCRecords();
404   auto View = SourceCoverageView::create(DC.demangle(Function.Name),
405                                          SourceBuffer.get(), ViewOpts,
406                                          std::move(FunctionCoverage));
407   attachExpansionSubViews(*View, Expansions, Coverage);
408   attachBranchSubViews(*View, DC.demangle(Function.Name), Branches,
409                        SourceBuffer.get(), FunctionCoverage);
410   attachMCDCSubViews(*View, DC.demangle(Function.Name), MCDCRecords,
411                      SourceBuffer.get(), FunctionCoverage);
412 
413   return View;
414 }
415 
416 std::unique_ptr<SourceCoverageView>
417 CodeCoverageTool::createSourceFileView(StringRef SourceFile,
418                                        const CoverageMapping &Coverage) {
419   auto SourceBuffer = getSourceFile(SourceFile);
420   if (!SourceBuffer)
421     return nullptr;
422   auto FileCoverage = Coverage.getCoverageForFile(SourceFile);
423   if (FileCoverage.empty())
424     return nullptr;
425 
426   auto Branches = FileCoverage.getBranches();
427   auto Expansions = FileCoverage.getExpansions();
428   auto MCDCRecords = FileCoverage.getMCDCRecords();
429   auto View = SourceCoverageView::create(SourceFile, SourceBuffer.get(),
430                                          ViewOpts, std::move(FileCoverage));
431   attachExpansionSubViews(*View, Expansions, Coverage);
432   attachBranchSubViews(*View, SourceFile, Branches, SourceBuffer.get(),
433                        FileCoverage);
434   attachMCDCSubViews(*View, SourceFile, MCDCRecords, SourceBuffer.get(),
435                      FileCoverage);
436   if (!ViewOpts.ShowFunctionInstantiations)
437     return View;
438 
439   for (const auto &Group : Coverage.getInstantiationGroups(SourceFile)) {
440     // Skip functions which have a single instantiation.
441     if (Group.size() < 2)
442       continue;
443 
444     for (const FunctionRecord *Function : Group.getInstantiations()) {
445       std::unique_ptr<SourceCoverageView> SubView{nullptr};
446 
447       StringRef Funcname = DC.demangle(Function->Name);
448 
449       if (Function->ExecutionCount > 0) {
450         auto SubViewCoverage = Coverage.getCoverageForFunction(*Function);
451         auto SubViewExpansions = SubViewCoverage.getExpansions();
452         auto SubViewBranches = SubViewCoverage.getBranches();
453         auto SubViewMCDCRecords = SubViewCoverage.getMCDCRecords();
454         SubView = SourceCoverageView::create(
455             Funcname, SourceBuffer.get(), ViewOpts, std::move(SubViewCoverage));
456         attachExpansionSubViews(*SubView, SubViewExpansions, Coverage);
457         attachBranchSubViews(*SubView, SourceFile, SubViewBranches,
458                              SourceBuffer.get(), SubViewCoverage);
459         attachMCDCSubViews(*SubView, SourceFile, SubViewMCDCRecords,
460                            SourceBuffer.get(), SubViewCoverage);
461       }
462 
463       unsigned FileID = Function->CountedRegions.front().FileID;
464       unsigned Line = 0;
465       for (const auto &CR : Function->CountedRegions)
466         if (CR.FileID == FileID)
467           Line = std::max(CR.LineEnd, Line);
468       View->addInstantiation(Funcname, Line, std::move(SubView));
469     }
470   }
471   return View;
472 }
473 
474 static bool modifiedTimeGT(StringRef LHS, StringRef RHS) {
475   sys::fs::file_status Status;
476   if (sys::fs::status(LHS, Status))
477     return false;
478   auto LHSTime = Status.getLastModificationTime();
479   if (sys::fs::status(RHS, Status))
480     return false;
481   auto RHSTime = Status.getLastModificationTime();
482   return LHSTime > RHSTime;
483 }
484 
485 std::unique_ptr<CoverageMapping> CodeCoverageTool::load() {
486   for (StringRef ObjectFilename : ObjectFilenames)
487     if (modifiedTimeGT(ObjectFilename, PGOFilename))
488       warning("profile data may be out of date - object is newer",
489               ObjectFilename);
490   auto FS = vfs::getRealFileSystem();
491   auto CoverageOrErr = CoverageMapping::load(
492       ObjectFilenames, PGOFilename, *FS, CoverageArches,
493       ViewOpts.CompilationDirectory, BIDFetcher.get(), CheckBinaryIDs);
494   if (Error E = CoverageOrErr.takeError()) {
495     error("failed to load coverage: " + toString(std::move(E)));
496     return nullptr;
497   }
498   auto Coverage = std::move(CoverageOrErr.get());
499   unsigned Mismatched = Coverage->getMismatchedCount();
500   if (Mismatched) {
501     warning(Twine(Mismatched) + " functions have mismatched data");
502 
503     if (ViewOpts.Debug) {
504       for (const auto &HashMismatch : Coverage->getHashMismatches())
505         errs() << "hash-mismatch: "
506                << "No profile record found for '" << HashMismatch.first << "'"
507                << " with hash = 0x" << Twine::utohexstr(HashMismatch.second)
508                << '\n';
509     }
510   }
511 
512   remapPathNames(*Coverage);
513 
514   if (!SourceFiles.empty())
515     removeUnmappedInputs(*Coverage);
516 
517   demangleSymbols(*Coverage);
518 
519   return Coverage;
520 }
521 
522 void CodeCoverageTool::remapPathNames(const CoverageMapping &Coverage) {
523   if (!PathRemappings)
524     return;
525 
526   // Convert remapping paths to native paths with trailing seperators.
527   auto nativeWithTrailing = [](StringRef Path) -> std::string {
528     if (Path.empty())
529       return "";
530     SmallString<128> NativePath;
531     sys::path::native(Path, NativePath);
532     sys::path::remove_dots(NativePath, true);
533     if (!NativePath.empty() && !sys::path::is_separator(NativePath.back()))
534       NativePath += sys::path::get_separator();
535     return NativePath.c_str();
536   };
537 
538   for (std::pair<std::string, std::string> &PathRemapping : *PathRemappings) {
539     std::string RemapFrom = nativeWithTrailing(PathRemapping.first);
540     std::string RemapTo = nativeWithTrailing(PathRemapping.second);
541 
542     // Create a mapping from coverage data file paths to local paths.
543     for (StringRef Filename : Coverage.getUniqueSourceFiles()) {
544       if (RemappedFilenames.count(Filename) == 1)
545         continue;
546 
547       SmallString<128> NativeFilename;
548       sys::path::native(Filename, NativeFilename);
549       sys::path::remove_dots(NativeFilename, true);
550       if (NativeFilename.starts_with(RemapFrom)) {
551         RemappedFilenames[Filename] =
552             RemapTo + NativeFilename.substr(RemapFrom.size()).str();
553       }
554     }
555   }
556 
557   // Convert input files from local paths to coverage data file paths.
558   StringMap<std::string> InvRemappedFilenames;
559   for (const auto &RemappedFilename : RemappedFilenames)
560     InvRemappedFilenames[RemappedFilename.getValue()] =
561         std::string(RemappedFilename.getKey());
562 
563   for (std::string &Filename : SourceFiles) {
564     SmallString<128> NativeFilename;
565     sys::path::native(Filename, NativeFilename);
566     auto CovFileName = InvRemappedFilenames.find(NativeFilename);
567     if (CovFileName != InvRemappedFilenames.end())
568       Filename = CovFileName->second;
569   }
570 }
571 
572 void CodeCoverageTool::removeUnmappedInputs(const CoverageMapping &Coverage) {
573   std::vector<StringRef> CoveredFiles = Coverage.getUniqueSourceFiles();
574 
575   // The user may have specified source files which aren't in the coverage
576   // mapping. Filter these files away.
577   llvm::erase_if(SourceFiles, [&](const std::string &SF) {
578     return !std::binary_search(CoveredFiles.begin(), CoveredFiles.end(), SF);
579   });
580 }
581 
582 void CodeCoverageTool::demangleSymbols(const CoverageMapping &Coverage) {
583   if (!ViewOpts.hasDemangler())
584     return;
585 
586   // Pass function names to the demangler in a temporary file.
587   int InputFD;
588   SmallString<256> InputPath;
589   std::error_code EC =
590       sys::fs::createTemporaryFile("demangle-in", "list", InputFD, InputPath);
591   if (EC) {
592     error(InputPath, EC.message());
593     return;
594   }
595   ToolOutputFile InputTOF{InputPath, InputFD};
596 
597   unsigned NumSymbols = 0;
598   for (const auto &Function : Coverage.getCoveredFunctions()) {
599     InputTOF.os() << Function.Name << '\n';
600     ++NumSymbols;
601   }
602   InputTOF.os().close();
603 
604   // Use another temporary file to store the demangler's output.
605   int OutputFD;
606   SmallString<256> OutputPath;
607   EC = sys::fs::createTemporaryFile("demangle-out", "list", OutputFD,
608                                     OutputPath);
609   if (EC) {
610     error(OutputPath, EC.message());
611     return;
612   }
613   ToolOutputFile OutputTOF{OutputPath, OutputFD};
614   OutputTOF.os().close();
615 
616   // Invoke the demangler.
617   std::vector<StringRef> ArgsV;
618   ArgsV.reserve(ViewOpts.DemanglerOpts.size());
619   for (StringRef Arg : ViewOpts.DemanglerOpts)
620     ArgsV.push_back(Arg);
621   std::optional<StringRef> Redirects[] = {
622       InputPath.str(), OutputPath.str(), {""}};
623   std::string ErrMsg;
624   int RC =
625       sys::ExecuteAndWait(ViewOpts.DemanglerOpts[0], ArgsV,
626                           /*env=*/std::nullopt, Redirects, /*secondsToWait=*/0,
627                           /*memoryLimit=*/0, &ErrMsg);
628   if (RC) {
629     error(ErrMsg, ViewOpts.DemanglerOpts[0]);
630     return;
631   }
632 
633   // Parse the demangler's output.
634   auto BufOrError = MemoryBuffer::getFile(OutputPath);
635   if (!BufOrError) {
636     error(OutputPath, BufOrError.getError().message());
637     return;
638   }
639 
640   std::unique_ptr<MemoryBuffer> DemanglerBuf = std::move(*BufOrError);
641 
642   SmallVector<StringRef, 8> Symbols;
643   StringRef DemanglerData = DemanglerBuf->getBuffer();
644   DemanglerData.split(Symbols, '\n', /*MaxSplit=*/NumSymbols,
645                       /*KeepEmpty=*/false);
646   if (Symbols.size() != NumSymbols) {
647     error("demangler did not provide expected number of symbols");
648     return;
649   }
650 
651   // Cache the demangled names.
652   unsigned I = 0;
653   for (const auto &Function : Coverage.getCoveredFunctions())
654     // On Windows, lines in the demangler's output file end with "\r\n".
655     // Splitting by '\n' keeps '\r's, so cut them now.
656     DC.DemangledNames[Function.Name] = std::string(Symbols[I++].rtrim());
657 }
658 
659 void CodeCoverageTool::writeSourceFileView(StringRef SourceFile,
660                                            CoverageMapping *Coverage,
661                                            CoveragePrinter *Printer,
662                                            bool ShowFilenames) {
663   auto View = createSourceFileView(SourceFile, *Coverage);
664   if (!View) {
665     warning("The file '" + SourceFile + "' isn't covered.");
666     return;
667   }
668 
669   auto OSOrErr = Printer->createViewFile(SourceFile, /*InToplevel=*/false);
670   if (Error E = OSOrErr.takeError()) {
671     error("could not create view file!", toString(std::move(E)));
672     return;
673   }
674   auto OS = std::move(OSOrErr.get());
675 
676   View->print(*OS.get(), /*Wholefile=*/true,
677               /*ShowSourceName=*/ShowFilenames,
678               /*ShowTitle=*/ViewOpts.hasOutputDirectory());
679   Printer->closeViewFile(std::move(OS));
680 }
681 
682 int CodeCoverageTool::run(Command Cmd, int argc, const char **argv) {
683   cl::opt<std::string> CovFilename(
684       cl::Positional, cl::desc("Covered executable or object file."));
685 
686   cl::list<std::string> CovFilenames(
687       "object", cl::desc("Coverage executable or object file"));
688 
689   cl::opt<bool> DebugDumpCollectedObjects(
690       "dump-collected-objects", cl::Optional, cl::Hidden,
691       cl::desc("Show the collected coverage object files"));
692 
693   cl::list<std::string> InputSourceFiles("sources", cl::Positional,
694                                          cl::desc("<Source files>"));
695 
696   cl::opt<bool> DebugDumpCollectedPaths(
697       "dump-collected-paths", cl::Optional, cl::Hidden,
698       cl::desc("Show the collected paths to source files"));
699 
700   cl::opt<std::string, true> PGOFilename(
701       "instr-profile", cl::Required, cl::location(this->PGOFilename),
702       cl::desc(
703           "File with the profile data obtained after an instrumented run"));
704 
705   cl::list<std::string> Arches(
706       "arch", cl::desc("architectures of the coverage mapping binaries"));
707 
708   cl::opt<bool> DebugDump("dump", cl::Optional,
709                           cl::desc("Show internal debug dump"));
710 
711   cl::list<std::string> DebugFileDirectory(
712       "debug-file-directory",
713       cl::desc("Directories to search for object files by build ID"));
714   cl::opt<bool> Debuginfod(
715       "debuginfod", cl::ZeroOrMore,
716       cl::desc("Use debuginfod to look up object files from profile"),
717       cl::init(canUseDebuginfod()));
718 
719   cl::opt<CoverageViewOptions::OutputFormat> Format(
720       "format", cl::desc("Output format for line-based coverage reports"),
721       cl::values(clEnumValN(CoverageViewOptions::OutputFormat::Text, "text",
722                             "Text output"),
723                  clEnumValN(CoverageViewOptions::OutputFormat::HTML, "html",
724                             "HTML output"),
725                  clEnumValN(CoverageViewOptions::OutputFormat::Lcov, "lcov",
726                             "lcov tracefile output")),
727       cl::init(CoverageViewOptions::OutputFormat::Text));
728 
729   cl::list<std::string> PathRemaps(
730       "path-equivalence", cl::Optional,
731       cl::desc("<from>,<to> Map coverage data paths to local source file "
732                "paths"));
733 
734   cl::OptionCategory FilteringCategory("Function filtering options");
735 
736   cl::list<std::string> NameFilters(
737       "name", cl::Optional,
738       cl::desc("Show code coverage only for functions with the given name"),
739       cl::cat(FilteringCategory));
740 
741   cl::list<std::string> NameFilterFiles(
742       "name-allowlist", cl::Optional,
743       cl::desc("Show code coverage only for functions listed in the given "
744                "file"),
745       cl::cat(FilteringCategory));
746 
747   cl::list<std::string> NameRegexFilters(
748       "name-regex", cl::Optional,
749       cl::desc("Show code coverage only for functions that match the given "
750                "regular expression"),
751       cl::cat(FilteringCategory));
752 
753   cl::list<std::string> IgnoreFilenameRegexFilters(
754       "ignore-filename-regex", cl::Optional,
755       cl::desc("Skip source code files with file paths that match the given "
756                "regular expression"),
757       cl::cat(FilteringCategory));
758 
759   cl::opt<double> RegionCoverageLtFilter(
760       "region-coverage-lt", cl::Optional,
761       cl::desc("Show code coverage only for functions with region coverage "
762                "less than the given threshold"),
763       cl::cat(FilteringCategory));
764 
765   cl::opt<double> RegionCoverageGtFilter(
766       "region-coverage-gt", cl::Optional,
767       cl::desc("Show code coverage only for functions with region coverage "
768                "greater than the given threshold"),
769       cl::cat(FilteringCategory));
770 
771   cl::opt<double> LineCoverageLtFilter(
772       "line-coverage-lt", cl::Optional,
773       cl::desc("Show code coverage only for functions with line coverage less "
774                "than the given threshold"),
775       cl::cat(FilteringCategory));
776 
777   cl::opt<double> LineCoverageGtFilter(
778       "line-coverage-gt", cl::Optional,
779       cl::desc("Show code coverage only for functions with line coverage "
780                "greater than the given threshold"),
781       cl::cat(FilteringCategory));
782 
783   cl::opt<cl::boolOrDefault> UseColor(
784       "use-color", cl::desc("Emit colored output (default=autodetect)"),
785       cl::init(cl::BOU_UNSET));
786 
787   cl::list<std::string> DemanglerOpts(
788       "Xdemangler", cl::desc("<demangler-path>|<demangler-option>"));
789 
790   cl::opt<bool> RegionSummary(
791       "show-region-summary", cl::Optional,
792       cl::desc("Show region statistics in summary table"),
793       cl::init(true));
794 
795   cl::opt<bool> BranchSummary(
796       "show-branch-summary", cl::Optional,
797       cl::desc("Show branch condition statistics in summary table"),
798       cl::init(true));
799 
800   cl::opt<bool> MCDCSummary("show-mcdc-summary", cl::Optional,
801                             cl::desc("Show MCDC statistics in summary table"),
802                             cl::init(false));
803 
804   cl::opt<bool> InstantiationSummary(
805       "show-instantiation-summary", cl::Optional,
806       cl::desc("Show instantiation statistics in summary table"));
807 
808   cl::opt<bool> SummaryOnly(
809       "summary-only", cl::Optional,
810       cl::desc("Export only summary information for each source file"));
811 
812   cl::opt<unsigned> NumThreads(
813       "num-threads", cl::init(0),
814       cl::desc("Number of merge threads to use (default: autodetect)"));
815   cl::alias NumThreadsA("j", cl::desc("Alias for --num-threads"),
816                         cl::aliasopt(NumThreads));
817 
818   cl::opt<std::string> CompilationDirectory(
819       "compilation-dir", cl::init(""),
820       cl::desc("Directory used as a base for relative coverage mapping paths"));
821 
822   cl::opt<bool> CheckBinaryIDs(
823       "check-binary-ids", cl::desc("Fail if an object couldn't be found for a "
824                                    "binary ID in the profile"));
825 
826   auto commandLineParser = [&, this](int argc, const char **argv) -> int {
827     cl::ParseCommandLineOptions(argc, argv, "LLVM code coverage tool\n");
828     ViewOpts.Debug = DebugDump;
829     if (Debuginfod) {
830       HTTPClient::initialize();
831       BIDFetcher = std::make_unique<DebuginfodFetcher>(DebugFileDirectory);
832     } else {
833       BIDFetcher = std::make_unique<object::BuildIDFetcher>(DebugFileDirectory);
834     }
835     this->CheckBinaryIDs = CheckBinaryIDs;
836 
837     if (!CovFilename.empty())
838       ObjectFilenames.emplace_back(CovFilename);
839     for (const std::string &Filename : CovFilenames)
840       ObjectFilenames.emplace_back(Filename);
841     if (ObjectFilenames.empty() && !Debuginfod && DebugFileDirectory.empty()) {
842       errs() << "No filenames specified!\n";
843       ::exit(1);
844     }
845 
846     if (DebugDumpCollectedObjects) {
847       for (StringRef OF : ObjectFilenames)
848         outs() << OF << '\n';
849       ::exit(0);
850     }
851 
852     ViewOpts.Format = Format;
853     switch (ViewOpts.Format) {
854     case CoverageViewOptions::OutputFormat::Text:
855       ViewOpts.Colors = UseColor == cl::BOU_UNSET
856                             ? sys::Process::StandardOutHasColors()
857                             : UseColor == cl::BOU_TRUE;
858       break;
859     case CoverageViewOptions::OutputFormat::HTML:
860       if (UseColor == cl::BOU_FALSE)
861         errs() << "Color output cannot be disabled when generating html.\n";
862       ViewOpts.Colors = true;
863       break;
864     case CoverageViewOptions::OutputFormat::Lcov:
865       if (UseColor == cl::BOU_TRUE)
866         errs() << "Color output cannot be enabled when generating lcov.\n";
867       ViewOpts.Colors = false;
868       break;
869     }
870 
871     if (!PathRemaps.empty()) {
872       std::vector<std::pair<std::string, std::string>> Remappings;
873 
874       for (const std::string &PathRemap : PathRemaps) {
875         auto EquivPair = StringRef(PathRemap).split(',');
876         if (EquivPair.first.empty() || EquivPair.second.empty()) {
877           error("invalid argument '" + PathRemap +
878                     "', must be in format 'from,to'",
879                 "-path-equivalence");
880           return 1;
881         }
882 
883         Remappings.push_back(
884             {std::string(EquivPair.first), std::string(EquivPair.second)});
885       }
886 
887       PathRemappings = Remappings;
888     }
889 
890     // If a demangler is supplied, check if it exists and register it.
891     if (!DemanglerOpts.empty()) {
892       auto DemanglerPathOrErr = sys::findProgramByName(DemanglerOpts[0]);
893       if (!DemanglerPathOrErr) {
894         error("could not find the demangler!",
895               DemanglerPathOrErr.getError().message());
896         return 1;
897       }
898       DemanglerOpts[0] = *DemanglerPathOrErr;
899       ViewOpts.DemanglerOpts.swap(DemanglerOpts);
900     }
901 
902     // Read in -name-allowlist files.
903     if (!NameFilterFiles.empty()) {
904       std::string SpecialCaseListErr;
905       NameAllowlist = SpecialCaseList::create(
906           NameFilterFiles, *vfs::getRealFileSystem(), SpecialCaseListErr);
907       if (!NameAllowlist)
908         error(SpecialCaseListErr);
909     }
910 
911     // Create the function filters
912     if (!NameFilters.empty() || NameAllowlist || !NameRegexFilters.empty()) {
913       auto NameFilterer = std::make_unique<CoverageFilters>();
914       for (const auto &Name : NameFilters)
915         NameFilterer->push_back(std::make_unique<NameCoverageFilter>(Name));
916       if (NameAllowlist && !NameFilterFiles.empty())
917         NameFilterer->push_back(
918             std::make_unique<NameAllowlistCoverageFilter>(*NameAllowlist));
919       for (const auto &Regex : NameRegexFilters)
920         NameFilterer->push_back(
921             std::make_unique<NameRegexCoverageFilter>(Regex));
922       Filters.push_back(std::move(NameFilterer));
923     }
924 
925     if (RegionCoverageLtFilter.getNumOccurrences() ||
926         RegionCoverageGtFilter.getNumOccurrences() ||
927         LineCoverageLtFilter.getNumOccurrences() ||
928         LineCoverageGtFilter.getNumOccurrences()) {
929       auto StatFilterer = std::make_unique<CoverageFilters>();
930       if (RegionCoverageLtFilter.getNumOccurrences())
931         StatFilterer->push_back(std::make_unique<RegionCoverageFilter>(
932             RegionCoverageFilter::LessThan, RegionCoverageLtFilter));
933       if (RegionCoverageGtFilter.getNumOccurrences())
934         StatFilterer->push_back(std::make_unique<RegionCoverageFilter>(
935             RegionCoverageFilter::GreaterThan, RegionCoverageGtFilter));
936       if (LineCoverageLtFilter.getNumOccurrences())
937         StatFilterer->push_back(std::make_unique<LineCoverageFilter>(
938             LineCoverageFilter::LessThan, LineCoverageLtFilter));
939       if (LineCoverageGtFilter.getNumOccurrences())
940         StatFilterer->push_back(std::make_unique<LineCoverageFilter>(
941             RegionCoverageFilter::GreaterThan, LineCoverageGtFilter));
942       Filters.push_back(std::move(StatFilterer));
943     }
944 
945     // Create the ignore filename filters.
946     for (const auto &RE : IgnoreFilenameRegexFilters)
947       IgnoreFilenameFilters.push_back(
948           std::make_unique<NameRegexCoverageFilter>(RE));
949 
950     if (!Arches.empty()) {
951       for (const std::string &Arch : Arches) {
952         if (Triple(Arch).getArch() == llvm::Triple::ArchType::UnknownArch) {
953           error("unknown architecture: " + Arch);
954           return 1;
955         }
956         CoverageArches.emplace_back(Arch);
957       }
958       if (CoverageArches.size() != 1 &&
959           CoverageArches.size() != ObjectFilenames.size()) {
960         error("number of architectures doesn't match the number of objects");
961         return 1;
962       }
963     }
964 
965     // IgnoreFilenameFilters are applied even when InputSourceFiles specified.
966     for (const std::string &File : InputSourceFiles)
967       collectPaths(File);
968 
969     if (DebugDumpCollectedPaths) {
970       for (const std::string &SF : SourceFiles)
971         outs() << SF << '\n';
972       ::exit(0);
973     }
974 
975     ViewOpts.ShowMCDCSummary = MCDCSummary;
976     ViewOpts.ShowBranchSummary = BranchSummary;
977     ViewOpts.ShowRegionSummary = RegionSummary;
978     ViewOpts.ShowInstantiationSummary = InstantiationSummary;
979     ViewOpts.ExportSummaryOnly = SummaryOnly;
980     ViewOpts.NumThreads = NumThreads;
981     ViewOpts.CompilationDirectory = CompilationDirectory;
982 
983     return 0;
984   };
985 
986   switch (Cmd) {
987   case Show:
988     return doShow(argc, argv, commandLineParser);
989   case Report:
990     return doReport(argc, argv, commandLineParser);
991   case Export:
992     return doExport(argc, argv, commandLineParser);
993   }
994   return 0;
995 }
996 
997 int CodeCoverageTool::doShow(int argc, const char **argv,
998                              CommandLineParserType commandLineParser) {
999 
1000   cl::OptionCategory ViewCategory("Viewing options");
1001 
1002   cl::opt<bool> ShowLineExecutionCounts(
1003       "show-line-counts", cl::Optional,
1004       cl::desc("Show the execution counts for each line"), cl::init(true),
1005       cl::cat(ViewCategory));
1006 
1007   cl::opt<bool> ShowRegions(
1008       "show-regions", cl::Optional,
1009       cl::desc("Show the execution counts for each region"),
1010       cl::cat(ViewCategory));
1011 
1012   cl::opt<CoverageViewOptions::BranchOutputType> ShowBranches(
1013       "show-branches", cl::Optional,
1014       cl::desc("Show coverage for branch conditions"), cl::cat(ViewCategory),
1015       cl::values(clEnumValN(CoverageViewOptions::BranchOutputType::Count,
1016                             "count", "Show True/False counts"),
1017                  clEnumValN(CoverageViewOptions::BranchOutputType::Percent,
1018                             "percent", "Show True/False percent")),
1019       cl::init(CoverageViewOptions::BranchOutputType::Off));
1020 
1021   cl::opt<bool> ShowMCDC(
1022       "show-mcdc", cl::Optional,
1023       cl::desc("Show the MCDC Coverage for each applicable boolean expression"),
1024       cl::cat(ViewCategory));
1025 
1026   cl::opt<bool> ShowBestLineRegionsCounts(
1027       "show-line-counts-or-regions", cl::Optional,
1028       cl::desc("Show the execution counts for each line, or the execution "
1029                "counts for each region on lines that have multiple regions"),
1030       cl::cat(ViewCategory));
1031 
1032   cl::opt<bool> ShowExpansions("show-expansions", cl::Optional,
1033                                cl::desc("Show expanded source regions"),
1034                                cl::cat(ViewCategory));
1035 
1036   cl::opt<bool> ShowInstantiations("show-instantiations", cl::Optional,
1037                                    cl::desc("Show function instantiations"),
1038                                    cl::init(true), cl::cat(ViewCategory));
1039 
1040   cl::opt<bool> ShowDirectoryCoverage("show-directory-coverage", cl::Optional,
1041                                       cl::desc("Show directory coverage"),
1042                                       cl::cat(ViewCategory));
1043 
1044   cl::opt<std::string> ShowOutputDirectory(
1045       "output-dir", cl::init(""),
1046       cl::desc("Directory in which coverage information is written out"));
1047   cl::alias ShowOutputDirectoryA("o", cl::desc("Alias for --output-dir"),
1048                                  cl::aliasopt(ShowOutputDirectory));
1049 
1050   cl::opt<uint32_t> TabSize(
1051       "tab-size", cl::init(2),
1052       cl::desc(
1053           "Set tab expansion size for html coverage reports (default = 2)"));
1054 
1055   cl::opt<std::string> ProjectTitle(
1056       "project-title", cl::Optional,
1057       cl::desc("Set project title for the coverage report"));
1058 
1059   cl::opt<std::string> CovWatermark(
1060       "coverage-watermark", cl::Optional,
1061       cl::desc("<high>,<low> value indicate thresholds for high and low"
1062                "coverage watermark"));
1063 
1064   auto Err = commandLineParser(argc, argv);
1065   if (Err)
1066     return Err;
1067 
1068   if (ViewOpts.Format == CoverageViewOptions::OutputFormat::Lcov) {
1069     error("lcov format should be used with 'llvm-cov export'.");
1070     return 1;
1071   }
1072 
1073   ViewOpts.HighCovWatermark = 100.0;
1074   ViewOpts.LowCovWatermark = 80.0;
1075   if (!CovWatermark.empty()) {
1076     auto WaterMarkPair = StringRef(CovWatermark).split(',');
1077     if (WaterMarkPair.first.empty() || WaterMarkPair.second.empty()) {
1078       error("invalid argument '" + CovWatermark +
1079                 "', must be in format 'high,low'",
1080             "-coverage-watermark");
1081       return 1;
1082     }
1083 
1084     char *EndPointer = nullptr;
1085     ViewOpts.HighCovWatermark =
1086         strtod(WaterMarkPair.first.begin(), &EndPointer);
1087     if (EndPointer != WaterMarkPair.first.end()) {
1088       error("invalid number '" + WaterMarkPair.first +
1089                 "', invalid value for 'high'",
1090             "-coverage-watermark");
1091       return 1;
1092     }
1093 
1094     ViewOpts.LowCovWatermark =
1095         strtod(WaterMarkPair.second.begin(), &EndPointer);
1096     if (EndPointer != WaterMarkPair.second.end()) {
1097       error("invalid number '" + WaterMarkPair.second +
1098                 "', invalid value for 'low'",
1099             "-coverage-watermark");
1100       return 1;
1101     }
1102 
1103     if (ViewOpts.HighCovWatermark > 100 || ViewOpts.LowCovWatermark < 0 ||
1104         ViewOpts.HighCovWatermark <= ViewOpts.LowCovWatermark) {
1105       error(
1106           "invalid number range '" + CovWatermark +
1107               "', must be both high and low should be between 0-100, and high "
1108               "> low",
1109           "-coverage-watermark");
1110       return 1;
1111     }
1112   }
1113 
1114   ViewOpts.ShowLineNumbers = true;
1115   ViewOpts.ShowLineStats = ShowLineExecutionCounts.getNumOccurrences() != 0 ||
1116                            !ShowRegions || ShowBestLineRegionsCounts;
1117   ViewOpts.ShowRegionMarkers = ShowRegions || ShowBestLineRegionsCounts;
1118   ViewOpts.ShowExpandedRegions = ShowExpansions;
1119   ViewOpts.ShowBranchCounts =
1120       ShowBranches == CoverageViewOptions::BranchOutputType::Count;
1121   ViewOpts.ShowMCDC = ShowMCDC;
1122   ViewOpts.ShowBranchPercents =
1123       ShowBranches == CoverageViewOptions::BranchOutputType::Percent;
1124   ViewOpts.ShowFunctionInstantiations = ShowInstantiations;
1125   ViewOpts.ShowDirectoryCoverage = ShowDirectoryCoverage;
1126   ViewOpts.ShowOutputDirectory = ShowOutputDirectory;
1127   ViewOpts.TabSize = TabSize;
1128   ViewOpts.ProjectTitle = ProjectTitle;
1129 
1130   if (ViewOpts.hasOutputDirectory()) {
1131     if (auto E = sys::fs::create_directories(ViewOpts.ShowOutputDirectory)) {
1132       error("could not create output directory!", E.message());
1133       return 1;
1134     }
1135   }
1136 
1137   sys::fs::file_status Status;
1138   if (std::error_code EC = sys::fs::status(PGOFilename, Status)) {
1139     error("could not read profile data!" + EC.message(), PGOFilename);
1140     return 1;
1141   }
1142 
1143   auto ModifiedTime = Status.getLastModificationTime();
1144   std::string ModifiedTimeStr = to_string(ModifiedTime);
1145   size_t found = ModifiedTimeStr.rfind(':');
1146   ViewOpts.CreatedTimeStr = (found != std::string::npos)
1147                                 ? "Created: " + ModifiedTimeStr.substr(0, found)
1148                                 : "Created: " + ModifiedTimeStr;
1149 
1150   auto Coverage = load();
1151   if (!Coverage)
1152     return 1;
1153 
1154   auto Printer = CoveragePrinter::create(ViewOpts);
1155 
1156   if (SourceFiles.empty() && !HadSourceFiles)
1157     // Get the source files from the function coverage mapping.
1158     for (StringRef Filename : Coverage->getUniqueSourceFiles()) {
1159       if (!IgnoreFilenameFilters.matchesFilename(Filename))
1160         SourceFiles.push_back(std::string(Filename));
1161     }
1162 
1163   // Create an index out of the source files.
1164   if (ViewOpts.hasOutputDirectory()) {
1165     if (Error E = Printer->createIndexFile(SourceFiles, *Coverage, Filters)) {
1166       error("could not create index file!", toString(std::move(E)));
1167       return 1;
1168     }
1169   }
1170 
1171   if (!Filters.empty()) {
1172     // Build the map of filenames to functions.
1173     std::map<llvm::StringRef, std::vector<const FunctionRecord *>>
1174         FilenameFunctionMap;
1175     for (const auto &SourceFile : SourceFiles)
1176       for (const auto &Function : Coverage->getCoveredFunctions(SourceFile))
1177         if (Filters.matches(*Coverage, Function))
1178           FilenameFunctionMap[SourceFile].push_back(&Function);
1179 
1180     // Only print filter matching functions for each file.
1181     for (const auto &FileFunc : FilenameFunctionMap) {
1182       StringRef File = FileFunc.first;
1183       const auto &Functions = FileFunc.second;
1184 
1185       auto OSOrErr = Printer->createViewFile(File, /*InToplevel=*/false);
1186       if (Error E = OSOrErr.takeError()) {
1187         error("could not create view file!", toString(std::move(E)));
1188         return 1;
1189       }
1190       auto OS = std::move(OSOrErr.get());
1191 
1192       bool ShowTitle = ViewOpts.hasOutputDirectory();
1193       for (const auto *Function : Functions) {
1194         auto FunctionView = createFunctionView(*Function, *Coverage);
1195         if (!FunctionView) {
1196           warning("Could not read coverage for '" + Function->Name + "'.");
1197           continue;
1198         }
1199         FunctionView->print(*OS.get(), /*WholeFile=*/false,
1200                             /*ShowSourceName=*/true, ShowTitle);
1201         ShowTitle = false;
1202       }
1203 
1204       Printer->closeViewFile(std::move(OS));
1205     }
1206     return 0;
1207   }
1208 
1209   // Show files
1210   bool ShowFilenames =
1211       (SourceFiles.size() != 1) || ViewOpts.hasOutputDirectory() ||
1212       (ViewOpts.Format == CoverageViewOptions::OutputFormat::HTML);
1213 
1214   ThreadPoolStrategy S = hardware_concurrency(ViewOpts.NumThreads);
1215   if (ViewOpts.NumThreads == 0) {
1216     // If NumThreads is not specified, create one thread for each input, up to
1217     // the number of hardware cores.
1218     S = heavyweight_hardware_concurrency(SourceFiles.size());
1219     S.Limit = true;
1220   }
1221 
1222   if (!ViewOpts.hasOutputDirectory() || S.ThreadsRequested == 1) {
1223     for (const std::string &SourceFile : SourceFiles)
1224       writeSourceFileView(SourceFile, Coverage.get(), Printer.get(),
1225                           ShowFilenames);
1226   } else {
1227     // In -output-dir mode, it's safe to use multiple threads to print files.
1228     ThreadPool Pool(S);
1229     for (const std::string &SourceFile : SourceFiles)
1230       Pool.async(&CodeCoverageTool::writeSourceFileView, this, SourceFile,
1231                  Coverage.get(), Printer.get(), ShowFilenames);
1232     Pool.wait();
1233   }
1234 
1235   return 0;
1236 }
1237 
1238 int CodeCoverageTool::doReport(int argc, const char **argv,
1239                                CommandLineParserType commandLineParser) {
1240   cl::opt<bool> ShowFunctionSummaries(
1241       "show-functions", cl::Optional, cl::init(false),
1242       cl::desc("Show coverage summaries for each function"));
1243 
1244   auto Err = commandLineParser(argc, argv);
1245   if (Err)
1246     return Err;
1247 
1248   if (ViewOpts.Format == CoverageViewOptions::OutputFormat::HTML) {
1249     error("HTML output for summary reports is not yet supported.");
1250     return 1;
1251   } else if (ViewOpts.Format == CoverageViewOptions::OutputFormat::Lcov) {
1252     error("lcov format should be used with 'llvm-cov export'.");
1253     return 1;
1254   }
1255 
1256   sys::fs::file_status Status;
1257   if (std::error_code EC = sys::fs::status(PGOFilename, Status)) {
1258     error("could not read profile data!" + EC.message(), PGOFilename);
1259     return 1;
1260   }
1261 
1262   auto Coverage = load();
1263   if (!Coverage)
1264     return 1;
1265 
1266   CoverageReport Report(ViewOpts, *Coverage);
1267   if (!ShowFunctionSummaries) {
1268     if (SourceFiles.empty())
1269       Report.renderFileReports(llvm::outs(), IgnoreFilenameFilters);
1270     else
1271       Report.renderFileReports(llvm::outs(), SourceFiles);
1272   } else {
1273     if (SourceFiles.empty()) {
1274       error("source files must be specified when -show-functions=true is "
1275             "specified");
1276       return 1;
1277     }
1278 
1279     Report.renderFunctionReports(SourceFiles, DC, llvm::outs());
1280   }
1281   return 0;
1282 }
1283 
1284 int CodeCoverageTool::doExport(int argc, const char **argv,
1285                                CommandLineParserType commandLineParser) {
1286 
1287   cl::OptionCategory ExportCategory("Exporting options");
1288 
1289   cl::opt<bool> SkipExpansions("skip-expansions", cl::Optional,
1290                                cl::desc("Don't export expanded source regions"),
1291                                cl::cat(ExportCategory));
1292 
1293   cl::opt<bool> SkipFunctions("skip-functions", cl::Optional,
1294                               cl::desc("Don't export per-function data"),
1295                               cl::cat(ExportCategory));
1296 
1297   cl::opt<bool> SkipBranches("skip-branches", cl::Optional,
1298                               cl::desc("Don't export branch data (LCOV)"),
1299                               cl::cat(ExportCategory));
1300 
1301   auto Err = commandLineParser(argc, argv);
1302   if (Err)
1303     return Err;
1304 
1305   ViewOpts.SkipExpansions = SkipExpansions;
1306   ViewOpts.SkipFunctions = SkipFunctions;
1307   ViewOpts.SkipBranches = SkipBranches;
1308 
1309   if (ViewOpts.Format != CoverageViewOptions::OutputFormat::Text &&
1310       ViewOpts.Format != CoverageViewOptions::OutputFormat::Lcov) {
1311     error("coverage data can only be exported as textual JSON or an "
1312           "lcov tracefile.");
1313     return 1;
1314   }
1315 
1316   sys::fs::file_status Status;
1317   if (std::error_code EC = sys::fs::status(PGOFilename, Status)) {
1318     error("could not read profile data!" + EC.message(), PGOFilename);
1319     return 1;
1320   }
1321 
1322   auto Coverage = load();
1323   if (!Coverage) {
1324     error("could not load coverage information");
1325     return 1;
1326   }
1327 
1328   std::unique_ptr<CoverageExporter> Exporter;
1329 
1330   switch (ViewOpts.Format) {
1331   case CoverageViewOptions::OutputFormat::Text:
1332     Exporter =
1333         std::make_unique<CoverageExporterJson>(*Coverage, ViewOpts, outs());
1334     break;
1335   case CoverageViewOptions::OutputFormat::HTML:
1336     // Unreachable because we should have gracefully terminated with an error
1337     // above.
1338     llvm_unreachable("Export in HTML is not supported!");
1339   case CoverageViewOptions::OutputFormat::Lcov:
1340     Exporter =
1341         std::make_unique<CoverageExporterLcov>(*Coverage, ViewOpts, outs());
1342     break;
1343   }
1344 
1345   if (SourceFiles.empty())
1346     Exporter->renderRoot(IgnoreFilenameFilters);
1347   else
1348     Exporter->renderRoot(SourceFiles);
1349 
1350   return 0;
1351 }
1352 
1353 int showMain(int argc, const char *argv[]) {
1354   CodeCoverageTool Tool;
1355   return Tool.run(CodeCoverageTool::Show, argc, argv);
1356 }
1357 
1358 int reportMain(int argc, const char *argv[]) {
1359   CodeCoverageTool Tool;
1360   return Tool.run(CodeCoverageTool::Report, argc, argv);
1361 }
1362 
1363 int exportMain(int argc, const char *argv[]) {
1364   CodeCoverageTool Tool;
1365   return Tool.run(CodeCoverageTool::Export, argc, argv);
1366 }
1367