1//===- PathDiagnostic.cpp - Path-Specific Diagnostic Handling -------------===//
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// This file defines the PathDiagnostic-related interfaces.
10//
11//===----------------------------------------------------------------------===//
12
13#include "clang/Analysis/PathDiagnostic.h"
14#include "clang/AST/Decl.h"
15#include "clang/AST/DeclBase.h"
16#include "clang/AST/DeclCXX.h"
17#include "clang/AST/DeclObjC.h"
18#include "clang/AST/DeclTemplate.h"
19#include "clang/AST/Expr.h"
20#include "clang/AST/ExprCXX.h"
21#include "clang/AST/ParentMap.h"
22#include "clang/AST/PrettyPrinter.h"
23#include "clang/AST/Stmt.h"
24#include "clang/AST/Type.h"
25#include "clang/Analysis/AnalysisDeclContext.h"
26#include "clang/Analysis/CFG.h"
27#include "clang/Analysis/IssueHash.h"
28#include "clang/Analysis/ProgramPoint.h"
29#include "clang/Basic/LLVM.h"
30#include "clang/Basic/SourceLocation.h"
31#include "clang/Basic/SourceManager.h"
32#include "llvm/ADT/ArrayRef.h"
33#include "llvm/ADT/FoldingSet.h"
34#include "llvm/ADT/STLExtras.h"
35#include "llvm/ADT/StringExtras.h"
36#include "llvm/ADT/StringRef.h"
37#include "llvm/Support/ErrorHandling.h"
38#include "llvm/Support/raw_ostream.h"
39#include <cassert>
40#include <cstring>
41#include <memory>
42#include <optional>
43#include <utility>
44#include <vector>
45
46using namespace clang;
47using namespace ento;
48
49static StringRef StripTrailingDots(StringRef s) { return s.rtrim(Char: '.'); }
50
51PathDiagnosticPiece::PathDiagnosticPiece(StringRef s,
52 Kind k, DisplayHint hint)
53 : str(StripTrailingDots(s)), kind(k), Hint(hint) {}
54
55PathDiagnosticPiece::PathDiagnosticPiece(Kind k, DisplayHint hint)
56 : kind(k), Hint(hint) {}
57
58PathDiagnosticPiece::~PathDiagnosticPiece() = default;
59
60PathDiagnosticEventPiece::~PathDiagnosticEventPiece() = default;
61
62PathDiagnosticCallPiece::~PathDiagnosticCallPiece() = default;
63
64PathDiagnosticControlFlowPiece::~PathDiagnosticControlFlowPiece() = default;
65
66PathDiagnosticMacroPiece::~PathDiagnosticMacroPiece() = default;
67
68PathDiagnosticNotePiece::~PathDiagnosticNotePiece() = default;
69
70PathDiagnosticPopUpPiece::~PathDiagnosticPopUpPiece() = default;
71
72void PathPieces::flattenTo(PathPieces &Primary, PathPieces &Current,
73 bool ShouldFlattenMacros) const {
74 for (auto &Piece : *this) {
75 switch (Piece->getKind()) {
76 case PathDiagnosticPiece::Call: {
77 auto &Call = cast<PathDiagnosticCallPiece>(Val&: *Piece);
78 if (auto CallEnter = Call.getCallEnterEvent())
79 Current.push_back(x: std::move(CallEnter));
80 Call.path.flattenTo(Primary, Current&: Primary, ShouldFlattenMacros);
81 if (auto callExit = Call.getCallExitEvent())
82 Current.push_back(x: std::move(callExit));
83 break;
84 }
85 case PathDiagnosticPiece::Macro: {
86 auto &Macro = cast<PathDiagnosticMacroPiece>(Val&: *Piece);
87 if (ShouldFlattenMacros) {
88 Macro.subPieces.flattenTo(Primary, Current&: Primary, ShouldFlattenMacros);
89 } else {
90 Current.push_back(x: Piece);
91 PathPieces NewPath;
92 Macro.subPieces.flattenTo(Primary, Current&: NewPath, ShouldFlattenMacros);
93 // FIXME: This probably shouldn't mutate the original path piece.
94 Macro.subPieces = NewPath;
95 }
96 break;
97 }
98 case PathDiagnosticPiece::Event:
99 case PathDiagnosticPiece::ControlFlow:
100 case PathDiagnosticPiece::Note:
101 case PathDiagnosticPiece::PopUp:
102 Current.push_back(x: Piece);
103 break;
104 }
105 }
106}
107
108PathDiagnostic::~PathDiagnostic() = default;
109
110PathDiagnostic::PathDiagnostic(
111 StringRef CheckerName, const Decl *declWithIssue, StringRef bugtype,
112 StringRef verboseDesc, StringRef shortDesc, StringRef category,
113 PathDiagnosticLocation LocationToUnique, const Decl *DeclToUnique,
114 const Decl *AnalysisEntryPoint,
115 std::unique_ptr<FilesToLineNumsMap> ExecutedLines)
116 : CheckerName(CheckerName), DeclWithIssue(declWithIssue),
117 BugType(StripTrailingDots(s: bugtype)),
118 VerboseDesc(StripTrailingDots(s: verboseDesc)),
119 ShortDesc(StripTrailingDots(s: shortDesc)),
120 Category(StripTrailingDots(s: category)), UniqueingLoc(LocationToUnique),
121 UniqueingDecl(DeclToUnique), AnalysisEntryPoint(AnalysisEntryPoint),
122 ExecutedLines(std::move(ExecutedLines)), path(pathImpl) {
123 assert(AnalysisEntryPoint);
124}
125
126void PathDiagnosticConsumer::anchor() {}
127
128PathDiagnosticConsumer::~PathDiagnosticConsumer() {
129 // Delete the contents of the FoldingSet if it isn't empty already.
130 for (auto &Diag : Diags)
131 delete &Diag;
132}
133
134void PathDiagnosticConsumer::HandlePathDiagnostic(
135 std::unique_ptr<PathDiagnostic> D) {
136 if (!D || D->path.empty())
137 return;
138
139 // We need to flatten the locations (convert Stmt* to locations) because
140 // the referenced statements may be freed by the time the diagnostics
141 // are emitted.
142 D->flattenLocations();
143
144 // If the PathDiagnosticConsumer does not support diagnostics that
145 // cross file boundaries, prune out such diagnostics now.
146 if (!supportsCrossFileDiagnostics()) {
147 // Verify that the entire path is from the same FileID.
148 FileID FID;
149 const SourceManager &SMgr = D->path.front()->getLocation().getManager();
150 SmallVector<const PathPieces *, 5> WorkList;
151 WorkList.push_back(Elt: &D->path);
152 SmallString<128> buf;
153 llvm::raw_svector_ostream warning(buf);
154 warning << "warning: Path diagnostic report is not generated. Current "
155 << "output format does not support diagnostics that cross file "
156 << "boundaries. Refer to --analyzer-output for valid output "
157 << "formats\n";
158
159 while (!WorkList.empty()) {
160 const PathPieces &path = *WorkList.pop_back_val();
161
162 for (const auto &I : path) {
163 const PathDiagnosticPiece *piece = I.get();
164 FullSourceLoc L = piece->getLocation().asLocation().getExpansionLoc();
165
166 if (FID.isInvalid()) {
167 FID = SMgr.getFileID(SpellingLoc: L);
168 } else if (SMgr.getFileID(SpellingLoc: L) != FID) {
169 llvm::errs() << warning.str();
170 return;
171 }
172
173 // Check the source ranges.
174 ArrayRef<SourceRange> Ranges = piece->getRanges();
175 for (const auto &I : Ranges) {
176 SourceLocation L = SMgr.getExpansionLoc(Loc: I.getBegin());
177 if (!L.isFileID() || SMgr.getFileID(SpellingLoc: L) != FID) {
178 llvm::errs() << warning.str();
179 return;
180 }
181 L = SMgr.getExpansionLoc(Loc: I.getEnd());
182 if (!L.isFileID() || SMgr.getFileID(SpellingLoc: L) != FID) {
183 llvm::errs() << warning.str();
184 return;
185 }
186 }
187
188 if (const auto *call = dyn_cast<PathDiagnosticCallPiece>(Val: piece))
189 WorkList.push_back(Elt: &call->path);
190 else if (const auto *macro = dyn_cast<PathDiagnosticMacroPiece>(Val: piece))
191 WorkList.push_back(Elt: &macro->subPieces);
192 }
193 }
194
195 if (FID.isInvalid())
196 return; // FIXME: Emit a warning?
197 }
198
199 // Profile the node to see if we already have something matching it
200 llvm::FoldingSetNodeID profile;
201 D->Profile(ID&: profile);
202 void *InsertPos = nullptr;
203
204 if (PathDiagnostic *orig = Diags.FindNodeOrInsertPos(ID: profile, InsertPos)) {
205 // Keep the PathDiagnostic with the shorter path.
206 // Note, the enclosing routine is called in deterministic order, so the
207 // results will be consistent between runs (no reason to break ties if the
208 // size is the same).
209 const unsigned orig_size = orig->full_size();
210 const unsigned new_size = D->full_size();
211 if (orig_size <= new_size)
212 return;
213
214 assert(orig != D.get());
215 Diags.RemoveNode(N: orig);
216 delete orig;
217 }
218
219 Diags.InsertNode(N: D.release());
220}
221
222static std::optional<bool> comparePath(const PathPieces &X,
223 const PathPieces &Y);
224
225static std::optional<bool>
226compareControlFlow(const PathDiagnosticControlFlowPiece &X,
227 const PathDiagnosticControlFlowPiece &Y) {
228 FullSourceLoc XSL = X.getStartLocation().asLocation();
229 FullSourceLoc YSL = Y.getStartLocation().asLocation();
230 if (XSL != YSL)
231 return XSL.isBeforeInTranslationUnitThan(Loc: YSL);
232 FullSourceLoc XEL = X.getEndLocation().asLocation();
233 FullSourceLoc YEL = Y.getEndLocation().asLocation();
234 if (XEL != YEL)
235 return XEL.isBeforeInTranslationUnitThan(Loc: YEL);
236 return std::nullopt;
237}
238
239static std::optional<bool> compareMacro(const PathDiagnosticMacroPiece &X,
240 const PathDiagnosticMacroPiece &Y) {
241 return comparePath(X: X.subPieces, Y: Y.subPieces);
242}
243
244static std::optional<bool> compareCall(const PathDiagnosticCallPiece &X,
245 const PathDiagnosticCallPiece &Y) {
246 FullSourceLoc X_CEL = X.callEnter.asLocation();
247 FullSourceLoc Y_CEL = Y.callEnter.asLocation();
248 if (X_CEL != Y_CEL)
249 return X_CEL.isBeforeInTranslationUnitThan(Loc: Y_CEL);
250 FullSourceLoc X_CEWL = X.callEnterWithin.asLocation();
251 FullSourceLoc Y_CEWL = Y.callEnterWithin.asLocation();
252 if (X_CEWL != Y_CEWL)
253 return X_CEWL.isBeforeInTranslationUnitThan(Loc: Y_CEWL);
254 FullSourceLoc X_CRL = X.callReturn.asLocation();
255 FullSourceLoc Y_CRL = Y.callReturn.asLocation();
256 if (X_CRL != Y_CRL)
257 return X_CRL.isBeforeInTranslationUnitThan(Loc: Y_CRL);
258 return comparePath(X: X.path, Y: Y.path);
259}
260
261static std::optional<bool> comparePiece(const PathDiagnosticPiece &X,
262 const PathDiagnosticPiece &Y) {
263 if (X.getKind() != Y.getKind())
264 return X.getKind() < Y.getKind();
265
266 FullSourceLoc XL = X.getLocation().asLocation();
267 FullSourceLoc YL = Y.getLocation().asLocation();
268 if (XL != YL)
269 return XL.isBeforeInTranslationUnitThan(Loc: YL);
270
271 if (X.getString() != Y.getString())
272 return X.getString() < Y.getString();
273
274 if (X.getRanges().size() != Y.getRanges().size())
275 return X.getRanges().size() < Y.getRanges().size();
276
277 const SourceManager &SM = XL.getManager();
278
279 for (unsigned i = 0, n = X.getRanges().size(); i < n; ++i) {
280 SourceRange XR = X.getRanges()[i];
281 SourceRange YR = Y.getRanges()[i];
282 if (XR != YR) {
283 if (XR.getBegin() != YR.getBegin())
284 return SM.isBeforeInTranslationUnit(LHS: XR.getBegin(), RHS: YR.getBegin());
285 return SM.isBeforeInTranslationUnit(LHS: XR.getEnd(), RHS: YR.getEnd());
286 }
287 }
288
289 switch (X.getKind()) {
290 case PathDiagnosticPiece::ControlFlow:
291 return compareControlFlow(X: cast<PathDiagnosticControlFlowPiece>(Val: X),
292 Y: cast<PathDiagnosticControlFlowPiece>(Val: Y));
293 case PathDiagnosticPiece::Macro:
294 return compareMacro(X: cast<PathDiagnosticMacroPiece>(Val: X),
295 Y: cast<PathDiagnosticMacroPiece>(Val: Y));
296 case PathDiagnosticPiece::Call:
297 return compareCall(X: cast<PathDiagnosticCallPiece>(Val: X),
298 Y: cast<PathDiagnosticCallPiece>(Val: Y));
299 case PathDiagnosticPiece::Event:
300 case PathDiagnosticPiece::Note:
301 case PathDiagnosticPiece::PopUp:
302 return std::nullopt;
303 }
304 llvm_unreachable("all cases handled");
305}
306
307static std::optional<bool> comparePath(const PathPieces &X,
308 const PathPieces &Y) {
309 if (X.size() != Y.size())
310 return X.size() < Y.size();
311
312 PathPieces::const_iterator X_I = X.begin(), X_end = X.end();
313 PathPieces::const_iterator Y_I = Y.begin(), Y_end = Y.end();
314
315 for (; X_I != X_end && Y_I != Y_end; ++X_I, ++Y_I)
316 if (std::optional<bool> b = comparePiece(X: **X_I, Y: **Y_I))
317 return *b;
318
319 return std::nullopt;
320}
321
322static bool compareCrossTUSourceLocs(FullSourceLoc XL, FullSourceLoc YL) {
323 if (XL.isInvalid() && YL.isValid())
324 return true;
325 if (XL.isValid() && YL.isInvalid())
326 return false;
327 FileIDAndOffset XOffs = XL.getDecomposedLoc();
328 FileIDAndOffset YOffs = YL.getDecomposedLoc();
329 const SourceManager &SM = XL.getManager();
330 std::pair<bool, bool> InSameTU = SM.isInTheSameTranslationUnit(LOffs&: XOffs, ROffs&: YOffs);
331 if (InSameTU.first)
332 return XL.isBeforeInTranslationUnitThan(Loc: YL);
333 OptionalFileEntryRef XFE =
334 SM.getFileEntryRefForID(FID: XL.getSpellingLoc().getFileID());
335 OptionalFileEntryRef YFE =
336 SM.getFileEntryRefForID(FID: YL.getSpellingLoc().getFileID());
337 if (!XFE || !YFE)
338 return XFE && !YFE;
339 int NameCmp = XFE->getName().compare(RHS: YFE->getName());
340 if (NameCmp != 0)
341 return NameCmp < 0;
342 // Last resort: Compare raw file IDs that are possibly expansions.
343 return XL.getFileID() < YL.getFileID();
344}
345
346static bool compare(const PathDiagnostic &X, const PathDiagnostic &Y) {
347 FullSourceLoc XL = X.getLocation().asLocation();
348 FullSourceLoc YL = Y.getLocation().asLocation();
349 if (XL != YL)
350 return compareCrossTUSourceLocs(XL, YL);
351 FullSourceLoc XUL = X.getUniqueingLoc().asLocation();
352 FullSourceLoc YUL = Y.getUniqueingLoc().asLocation();
353 if (XUL != YUL)
354 return compareCrossTUSourceLocs(XL: XUL, YL: YUL);
355 if (X.getBugType() != Y.getBugType())
356 return X.getBugType() < Y.getBugType();
357 if (X.getCategory() != Y.getCategory())
358 return X.getCategory() < Y.getCategory();
359 if (X.getVerboseDescription() != Y.getVerboseDescription())
360 return X.getVerboseDescription() < Y.getVerboseDescription();
361 if (X.getShortDescription() != Y.getShortDescription())
362 return X.getShortDescription() < Y.getShortDescription();
363 auto CompareDecls = [&XL](const Decl *D1,
364 const Decl *D2) -> std::optional<bool> {
365 if (D1 == D2)
366 return std::nullopt;
367 if (!D1)
368 return true;
369 if (!D2)
370 return false;
371 SourceLocation D1L = D1->getLocation();
372 SourceLocation D2L = D2->getLocation();
373 if (D1L != D2L) {
374 const SourceManager &SM = XL.getManager();
375 return compareCrossTUSourceLocs(XL: FullSourceLoc(D1L, SM),
376 YL: FullSourceLoc(D2L, SM));
377 }
378 return std::nullopt;
379 };
380 if (auto Result = CompareDecls(X.getDeclWithIssue(), Y.getDeclWithIssue()))
381 return *Result;
382 if (XUL.isValid()) {
383 if (auto Result = CompareDecls(X.getUniqueingDecl(), Y.getUniqueingDecl()))
384 return *Result;
385 }
386 PathDiagnostic::meta_iterator XI = X.meta_begin(), XE = X.meta_end();
387 PathDiagnostic::meta_iterator YI = Y.meta_begin(), YE = Y.meta_end();
388 if (XE - XI != YE - YI)
389 return (XE - XI) < (YE - YI);
390 for ( ; XI != XE ; ++XI, ++YI) {
391 if (*XI != *YI)
392 return (*XI) < (*YI);
393 }
394 return *comparePath(X: X.path, Y: Y.path);
395}
396
397void PathDiagnosticConsumer::FlushDiagnostics(
398 PathDiagnosticConsumer::FilesMade *Files) {
399 if (flushed)
400 return;
401
402 flushed = true;
403
404 std::vector<const PathDiagnostic *> BatchDiags;
405 for (const auto &D : Diags)
406 BatchDiags.push_back(x: &D);
407
408 // Sort the diagnostics so that they are always emitted in a deterministic
409 // order.
410 int (*Comp)(const PathDiagnostic *const *, const PathDiagnostic *const *) =
411 [](const PathDiagnostic *const *X, const PathDiagnostic *const *Y) {
412 assert(*X != *Y && "PathDiagnostics not uniqued!");
413 if (compare(X: **X, Y: **Y))
414 return -1;
415 assert(compare(**Y, **X) && "Not a total order!");
416 return 1;
417 };
418 array_pod_sort(Start: BatchDiags.begin(), End: BatchDiags.end(), Compare: Comp);
419
420 FlushDiagnosticsImpl(Diags&: BatchDiags, filesMade: Files);
421
422 // Delete the flushed diagnostics.
423 for (const auto D : BatchDiags)
424 delete D;
425
426 // Clear out the FoldingSet.
427 Diags.clear();
428}
429
430PathDiagnosticConsumer::FilesMade::~FilesMade() {
431 for (auto It = Set.begin(); It != Set.end();)
432 (It++)->~PDFileEntry();
433}
434
435void PathDiagnosticConsumer::FilesMade::addDiagnostic(const PathDiagnostic &PD,
436 StringRef ConsumerName,
437 StringRef FileName) {
438 llvm::FoldingSetNodeID NodeID;
439 NodeID.Add(x: PD);
440 void *InsertPos;
441 PDFileEntry *Entry = Set.FindNodeOrInsertPos(ID: NodeID, InsertPos);
442 if (!Entry) {
443 Entry = Alloc.Allocate<PDFileEntry>();
444 Entry = new (Entry) PDFileEntry(NodeID);
445 Set.InsertNode(N: Entry, InsertPos);
446 }
447
448 // Allocate persistent storage for the file name.
449 char *FileName_cstr = (char*) Alloc.Allocate(Size: FileName.size(), Alignment: 1);
450 memcpy(dest: FileName_cstr, src: FileName.data(), n: FileName.size());
451
452 Entry->files.push_back(x: std::make_pair(x&: ConsumerName,
453 y: StringRef(FileName_cstr,
454 FileName.size())));
455}
456
457PathDiagnosticConsumer::PDFileEntry::ConsumerFiles *
458PathDiagnosticConsumer::FilesMade::getFiles(const PathDiagnostic &PD) {
459 llvm::FoldingSetNodeID NodeID;
460 NodeID.Add(x: PD);
461 void *InsertPos;
462 PDFileEntry *Entry = Set.FindNodeOrInsertPos(ID: NodeID, InsertPos);
463 if (!Entry)
464 return nullptr;
465 return &Entry->files;
466}
467
468//===----------------------------------------------------------------------===//
469// PathDiagnosticLocation methods.
470//===----------------------------------------------------------------------===//
471
472SourceLocation PathDiagnosticLocation::getValidSourceLocation(
473 const Stmt *S, LocationOrAnalysisDeclContext LAC, bool UseEndOfStatement) {
474 SourceLocation L = UseEndOfStatement ? S->getEndLoc() : S->getBeginLoc();
475 assert(!LAC.isNull() &&
476 "A valid LocationContext or AnalysisDeclContext should be passed to "
477 "PathDiagnosticLocation upon creation.");
478
479 // S might be a temporary statement that does not have a location in the
480 // source code, so find an enclosing statement and use its location.
481 if (!L.isValid()) {
482 AnalysisDeclContext *ADC;
483 if (auto *LC = dyn_cast<const LocationContext *>(Val&: LAC))
484 ADC = LC->getAnalysisDeclContext();
485 else
486 ADC = cast<AnalysisDeclContext *>(Val&: LAC);
487
488 ParentMap &PM = ADC->getParentMap();
489
490 const Stmt *Parent = S;
491 do {
492 Parent = PM.getParent(S: Parent);
493
494 // In rare cases, we have implicit top-level expressions,
495 // such as arguments for implicit member initializers.
496 // In this case, fall back to the start of the body (even if we were
497 // asked for the statement end location).
498 if (!Parent) {
499 const Stmt *Body = ADC->getBody();
500 if (Body)
501 L = Body->getBeginLoc();
502 else
503 L = ADC->getDecl()->getEndLoc();
504 break;
505 }
506
507 L = UseEndOfStatement ? Parent->getEndLoc() : Parent->getBeginLoc();
508 } while (!L.isValid());
509 }
510
511 // FIXME: Ironically, this assert actually fails in some cases.
512 //assert(L.isValid());
513 return L;
514}
515
516static PathDiagnosticLocation
517getLocationForCaller(const StackFrameContext *SFC,
518 const LocationContext *CallerCtx,
519 const SourceManager &SM) {
520 const CFGBlock &Block = *SFC->getCallSiteBlock();
521 CFGElement Source = Block[SFC->getIndex()];
522
523 switch (Source.getKind()) {
524 case CFGElement::Statement:
525 case CFGElement::Constructor:
526 case CFGElement::CXXRecordTypedCall:
527 return PathDiagnosticLocation(Source.castAs<CFGStmt>().getStmt(),
528 SM, CallerCtx);
529 case CFGElement::Initializer: {
530 const CFGInitializer &Init = Source.castAs<CFGInitializer>();
531 return PathDiagnosticLocation(Init.getInitializer()->getInit(),
532 SM, CallerCtx);
533 }
534 case CFGElement::AutomaticObjectDtor: {
535 const CFGAutomaticObjDtor &Dtor = Source.castAs<CFGAutomaticObjDtor>();
536 return PathDiagnosticLocation::createEnd(S: Dtor.getTriggerStmt(),
537 SM, LAC: CallerCtx);
538 }
539 case CFGElement::DeleteDtor: {
540 const CFGDeleteDtor &Dtor = Source.castAs<CFGDeleteDtor>();
541 return PathDiagnosticLocation(Dtor.getDeleteExpr(), SM, CallerCtx);
542 }
543 case CFGElement::BaseDtor:
544 case CFGElement::MemberDtor: {
545 const AnalysisDeclContext *CallerInfo = CallerCtx->getAnalysisDeclContext();
546 if (const Stmt *CallerBody = CallerInfo->getBody())
547 return PathDiagnosticLocation::createEnd(S: CallerBody, SM, LAC: CallerCtx);
548 return PathDiagnosticLocation::create(D: CallerInfo->getDecl(), SM);
549 }
550 case CFGElement::NewAllocator: {
551 const CFGNewAllocator &Alloc = Source.castAs<CFGNewAllocator>();
552 return PathDiagnosticLocation(Alloc.getAllocatorExpr(), SM, CallerCtx);
553 }
554 case CFGElement::TemporaryDtor: {
555 // Temporary destructors are for temporaries. They die immediately at around
556 // the location of CXXBindTemporaryExpr. If they are lifetime-extended,
557 // they'd be dealt with via an AutomaticObjectDtor instead.
558 const auto &Dtor = Source.castAs<CFGTemporaryDtor>();
559 return PathDiagnosticLocation::createEnd(S: Dtor.getBindTemporaryExpr(), SM,
560 LAC: CallerCtx);
561 }
562 case CFGElement::ScopeBegin:
563 case CFGElement::ScopeEnd:
564 case CFGElement::CleanupFunction:
565 llvm_unreachable("not yet implemented!");
566 case CFGElement::LifetimeEnds:
567 case CFGElement::FullExprCleanup:
568 case CFGElement::LoopExit:
569 llvm_unreachable("CFGElement kind should not be on callsite!");
570 }
571
572 llvm_unreachable("Unknown CFGElement kind");
573}
574
575PathDiagnosticLocation
576PathDiagnosticLocation::createBegin(const Decl *D,
577 const SourceManager &SM) {
578 return PathDiagnosticLocation(D->getBeginLoc(), SM, SingleLocK);
579}
580
581PathDiagnosticLocation
582PathDiagnosticLocation::createBegin(const Stmt *S,
583 const SourceManager &SM,
584 LocationOrAnalysisDeclContext LAC) {
585 assert(S && "Statement cannot be null");
586 return PathDiagnosticLocation(getValidSourceLocation(S, LAC),
587 SM, SingleLocK);
588}
589
590PathDiagnosticLocation
591PathDiagnosticLocation::createEnd(const Stmt *S,
592 const SourceManager &SM,
593 LocationOrAnalysisDeclContext LAC) {
594 if (const auto *CS = dyn_cast<CompoundStmt>(Val: S))
595 return createEndBrace(CS, SM);
596 return PathDiagnosticLocation(getValidSourceLocation(S, LAC, /*End=*/UseEndOfStatement: true),
597 SM, SingleLocK);
598}
599
600PathDiagnosticLocation
601PathDiagnosticLocation::createOperatorLoc(const BinaryOperator *BO,
602 const SourceManager &SM) {
603 return PathDiagnosticLocation(BO->getOperatorLoc(), SM, SingleLocK);
604}
605
606PathDiagnosticLocation
607PathDiagnosticLocation::createConditionalColonLoc(
608 const ConditionalOperator *CO,
609 const SourceManager &SM) {
610 return PathDiagnosticLocation(CO->getColonLoc(), SM, SingleLocK);
611}
612
613PathDiagnosticLocation
614PathDiagnosticLocation::createMemberLoc(const MemberExpr *ME,
615 const SourceManager &SM) {
616
617 assert(ME->getMemberLoc().isValid() || ME->getBeginLoc().isValid());
618
619 // In some cases, getMemberLoc isn't valid -- in this case we'll return with
620 // some other related valid SourceLocation.
621 if (ME->getMemberLoc().isValid())
622 return PathDiagnosticLocation(ME->getMemberLoc(), SM, SingleLocK);
623
624 return PathDiagnosticLocation(ME->getBeginLoc(), SM, SingleLocK);
625}
626
627PathDiagnosticLocation
628PathDiagnosticLocation::createBeginBrace(const CompoundStmt *CS,
629 const SourceManager &SM) {
630 SourceLocation L = CS->getLBracLoc();
631 return PathDiagnosticLocation(L, SM, SingleLocK);
632}
633
634PathDiagnosticLocation
635PathDiagnosticLocation::createEndBrace(const CompoundStmt *CS,
636 const SourceManager &SM) {
637 SourceLocation L = CS->getRBracLoc();
638 return PathDiagnosticLocation(L, SM, SingleLocK);
639}
640
641PathDiagnosticLocation
642PathDiagnosticLocation::createDeclBegin(const LocationContext *LC,
643 const SourceManager &SM) {
644 // FIXME: Should handle CXXTryStmt if analyser starts supporting C++.
645 if (const auto *CS = dyn_cast_or_null<CompoundStmt>(Val: LC->getDecl()->getBody()))
646 if (!CS->body_empty()) {
647 SourceLocation Loc = (*CS->body_begin())->getBeginLoc();
648 return PathDiagnosticLocation(Loc, SM, SingleLocK);
649 }
650
651 return PathDiagnosticLocation();
652}
653
654PathDiagnosticLocation
655PathDiagnosticLocation::createDeclEnd(const LocationContext *LC,
656 const SourceManager &SM) {
657 SourceLocation L = LC->getDecl()->getBodyRBrace();
658 return PathDiagnosticLocation(L, SM, SingleLocK);
659}
660
661PathDiagnosticLocation
662PathDiagnosticLocation::create(const ProgramPoint& P,
663 const SourceManager &SMng) {
664 const Stmt* S = nullptr;
665 if (std::optional<BlockEdge> BE = P.getAs<BlockEdge>()) {
666 const CFGBlock *BSrc = BE->getSrc();
667 if (BSrc->getTerminator().isVirtualBaseBranch()) {
668 // TODO: VirtualBaseBranches should also appear for destructors.
669 // In this case we should put the diagnostic at the end of decl.
670 return PathDiagnosticLocation::createBegin(
671 D: P.getLocationContext()->getDecl(), SM: SMng);
672
673 } else {
674 S = BSrc->getTerminatorCondition();
675 if (!S) {
676 // If the BlockEdge has no terminator condition statement but its
677 // source is the entry of the CFG (e.g. a checker crated the branch at
678 // the beginning of a function), use the function's declaration instead.
679 assert(BSrc == &BSrc->getParent()->getEntry() && "CFGBlock has no "
680 "TerminatorCondition and is not the enrty block of the CFG");
681 return PathDiagnosticLocation::createBegin(
682 D: P.getLocationContext()->getDecl(), SM: SMng);
683 }
684 }
685 } else if (std::optional<StmtPoint> SP = P.getAs<StmtPoint>()) {
686 S = SP->getStmt();
687 if (P.getAs<PostStmtPurgeDeadSymbols>())
688 return PathDiagnosticLocation::createEnd(S, SM: SMng, LAC: P.getLocationContext());
689 } else if (std::optional<PostInitializer> PIP = P.getAs<PostInitializer>()) {
690 return PathDiagnosticLocation(PIP->getInitializer()->getSourceLocation(),
691 SMng);
692 } else if (std::optional<PreImplicitCall> PIC = P.getAs<PreImplicitCall>()) {
693 return PathDiagnosticLocation(PIC->getLocation(), SMng);
694 } else if (std::optional<PostImplicitCall> PIE =
695 P.getAs<PostImplicitCall>()) {
696 return PathDiagnosticLocation(PIE->getLocation(), SMng);
697 } else if (std::optional<CallEnter> CE = P.getAs<CallEnter>()) {
698 return getLocationForCaller(SFC: CE->getCalleeContext(),
699 CallerCtx: CE->getLocationContext(),
700 SM: SMng);
701 } else if (std::optional<CallExitEnd> CEE = P.getAs<CallExitEnd>()) {
702 return getLocationForCaller(SFC: CEE->getCalleeContext(),
703 CallerCtx: CEE->getLocationContext(),
704 SM: SMng);
705 } else if (auto CEB = P.getAs<CallExitBegin>()) {
706 if (const ReturnStmt *RS = CEB->getReturnStmt())
707 return PathDiagnosticLocation::createBegin(S: RS, SM: SMng,
708 LAC: CEB->getLocationContext());
709 return PathDiagnosticLocation(
710 CEB->getLocationContext()->getDecl()->getSourceRange().getEnd(), SMng);
711 } else if (std::optional<BlockEntrance> BE = P.getAs<BlockEntrance>()) {
712 if (std::optional<CFGElement> BlockFront = BE->getFirstElement()) {
713 if (auto StmtElt = BlockFront->getAs<CFGStmt>()) {
714 return PathDiagnosticLocation(StmtElt->getStmt()->getBeginLoc(), SMng);
715 } else if (auto NewAllocElt = BlockFront->getAs<CFGNewAllocator>()) {
716 return PathDiagnosticLocation(
717 NewAllocElt->getAllocatorExpr()->getBeginLoc(), SMng);
718 }
719 llvm_unreachable("Unexpected CFG element at front of block");
720 }
721
722 return PathDiagnosticLocation(
723 BE->getBlock()->getTerminatorStmt()->getBeginLoc(), SMng);
724 } else if (std::optional<FunctionExitPoint> FE =
725 P.getAs<FunctionExitPoint>()) {
726 return PathDiagnosticLocation(FE->getStmt(), SMng,
727 FE->getLocationContext());
728 } else {
729 llvm_unreachable("Unexpected ProgramPoint");
730 }
731
732 return PathDiagnosticLocation(S, SMng, P.getLocationContext());
733}
734
735PathDiagnosticLocation PathDiagnosticLocation::createSingleLocation(
736 const PathDiagnosticLocation &PDL) {
737 FullSourceLoc L = PDL.asLocation();
738 return PathDiagnosticLocation(L, L.getManager(), SingleLocK);
739}
740
741FullSourceLoc
742 PathDiagnosticLocation::genLocation(SourceLocation L,
743 LocationOrAnalysisDeclContext LAC) const {
744 assert(isValid());
745 // Note that we want a 'switch' here so that the compiler can warn us in
746 // case we add more cases.
747 switch (K) {
748 case SingleLocK:
749 case RangeK:
750 break;
751 case StmtK:
752 // Defensive checking.
753 if (!S)
754 break;
755 return FullSourceLoc(getValidSourceLocation(S, LAC),
756 const_cast<SourceManager&>(*SM));
757 case DeclK:
758 // Defensive checking.
759 if (!D)
760 break;
761 return FullSourceLoc(D->getLocation(), const_cast<SourceManager&>(*SM));
762 }
763
764 return FullSourceLoc(L, const_cast<SourceManager&>(*SM));
765}
766
767PathDiagnosticRange
768 PathDiagnosticLocation::genRange(LocationOrAnalysisDeclContext LAC) const {
769 assert(isValid());
770 // Note that we want a 'switch' here so that the compiler can warn us in
771 // case we add more cases.
772 switch (K) {
773 case SingleLocK:
774 return PathDiagnosticRange(SourceRange(Loc,Loc), true);
775 case RangeK:
776 break;
777 case StmtK: {
778 const Stmt *S = asStmt();
779 switch (S->getStmtClass()) {
780 default:
781 break;
782 case Stmt::DeclStmtClass: {
783 const auto *DS = cast<DeclStmt>(Val: S);
784 if (DS->isSingleDecl()) {
785 // Should always be the case, but we'll be defensive.
786 return SourceRange(DS->getBeginLoc(),
787 DS->getSingleDecl()->getLocation());
788 }
789 break;
790 }
791 // FIXME: Provide better range information for different
792 // terminators.
793 case Stmt::IfStmtClass:
794 case Stmt::WhileStmtClass:
795 case Stmt::DoStmtClass:
796 case Stmt::ForStmtClass:
797 case Stmt::ChooseExprClass:
798 case Stmt::IndirectGotoStmtClass:
799 case Stmt::SwitchStmtClass:
800 case Stmt::BinaryConditionalOperatorClass:
801 case Stmt::ConditionalOperatorClass:
802 case Stmt::ObjCForCollectionStmtClass: {
803 SourceLocation L = getValidSourceLocation(S, LAC);
804 return SourceRange(L, L);
805 }
806 }
807 SourceRange R = S->getSourceRange();
808 if (R.isValid())
809 return R;
810 break;
811 }
812 case DeclK:
813 if (const auto *MD = dyn_cast<ObjCMethodDecl>(Val: D))
814 return MD->getSourceRange();
815 if (const auto *FD = dyn_cast<FunctionDecl>(Val: D)) {
816 if (Stmt *Body = FD->getBody())
817 return Body->getSourceRange();
818 }
819 else {
820 SourceLocation L = D->getLocation();
821 return PathDiagnosticRange(SourceRange(L, L), true);
822 }
823 }
824
825 return SourceRange(Loc, Loc);
826}
827
828void PathDiagnosticLocation::flatten() {
829 if (K == StmtK) {
830 K = RangeK;
831 S = nullptr;
832 D = nullptr;
833 }
834 else if (K == DeclK) {
835 K = SingleLocK;
836 S = nullptr;
837 D = nullptr;
838 }
839}
840
841//===----------------------------------------------------------------------===//
842// Manipulation of PathDiagnosticCallPieces.
843//===----------------------------------------------------------------------===//
844
845std::shared_ptr<PathDiagnosticCallPiece>
846PathDiagnosticCallPiece::construct(const CallExitEnd &CE,
847 const SourceManager &SM) {
848 const Decl *caller = CE.getLocationContext()->getDecl();
849 PathDiagnosticLocation pos = getLocationForCaller(SFC: CE.getCalleeContext(),
850 CallerCtx: CE.getLocationContext(),
851 SM);
852 return std::shared_ptr<PathDiagnosticCallPiece>(
853 new PathDiagnosticCallPiece(caller, pos));
854}
855
856PathDiagnosticCallPiece *
857PathDiagnosticCallPiece::construct(PathPieces &path,
858 const Decl *caller) {
859 std::shared_ptr<PathDiagnosticCallPiece> C(
860 new PathDiagnosticCallPiece(path, caller));
861 path.clear();
862 auto *R = C.get();
863 path.push_front(x: std::move(C));
864 return R;
865}
866
867void PathDiagnosticCallPiece::setCallee(const CallEnter &CE,
868 const SourceManager &SM) {
869 const StackFrameContext *CalleeCtx = CE.getCalleeContext();
870 Callee = CalleeCtx->getDecl();
871
872 callEnterWithin = PathDiagnosticLocation::createBegin(D: Callee, SM);
873 callEnter = getLocationForCaller(SFC: CalleeCtx, CallerCtx: CE.getLocationContext(), SM);
874
875 // Autosynthesized property accessors are special because we'd never
876 // pop back up to non-autosynthesized code until we leave them.
877 // This is not generally true for autosynthesized callees, which may call
878 // non-autosynthesized callbacks.
879 // Unless set here, the IsCalleeAnAutosynthesizedPropertyAccessor flag
880 // defaults to false.
881 if (const auto *MD = dyn_cast<ObjCMethodDecl>(Val: Callee))
882 IsCalleeAnAutosynthesizedPropertyAccessor = (
883 MD->isPropertyAccessor() &&
884 CalleeCtx->getAnalysisDeclContext()->isBodyAutosynthesized());
885}
886
887static void describeTemplateParameters(raw_ostream &Out,
888 const ArrayRef<TemplateArgument> TAList,
889 const LangOptions &LO,
890 StringRef Prefix = StringRef(),
891 StringRef Postfix = StringRef());
892
893static void describeTemplateParameter(raw_ostream &Out,
894 const TemplateArgument &TArg,
895 const LangOptions &LO) {
896
897 if (TArg.getKind() == TemplateArgument::ArgKind::Pack) {
898 describeTemplateParameters(Out, TAList: TArg.getPackAsArray(), LO);
899 } else {
900 TArg.print(Policy: PrintingPolicy(LO), Out, /*IncludeType*/ true);
901 }
902}
903
904static void describeTemplateParameters(raw_ostream &Out,
905 const ArrayRef<TemplateArgument> TAList,
906 const LangOptions &LO,
907 StringRef Prefix, StringRef Postfix) {
908 if (TAList.empty())
909 return;
910
911 Out << Prefix;
912 for (int I = 0, Last = TAList.size() - 1; I != Last; ++I) {
913 describeTemplateParameter(Out, TArg: TAList[I], LO);
914 Out << ", ";
915 }
916 describeTemplateParameter(Out, TArg: TAList[TAList.size() - 1], LO);
917 Out << Postfix;
918}
919
920static void describeClass(raw_ostream &Out, const CXXRecordDecl *D,
921 StringRef Prefix = StringRef()) {
922 if (!D->getIdentifier())
923 return;
924 Out << Prefix << '\'' << *D;
925 if (const auto T = dyn_cast<ClassTemplateSpecializationDecl>(Val: D))
926 describeTemplateParameters(Out, TAList: T->getTemplateArgs().asArray(),
927 LO: D->getLangOpts(), Prefix: "<", Postfix: ">");
928
929 Out << '\'';
930}
931
932static bool describeCodeDecl(raw_ostream &Out, const Decl *D,
933 bool ExtendedDescription,
934 StringRef Prefix = StringRef()) {
935 if (!D)
936 return false;
937
938 if (isa<BlockDecl>(Val: D)) {
939 if (ExtendedDescription)
940 Out << Prefix << "anonymous block";
941 return ExtendedDescription;
942 }
943
944 if (const auto *MD = dyn_cast<CXXMethodDecl>(Val: D)) {
945 Out << Prefix;
946 if (ExtendedDescription && !MD->isUserProvided()) {
947 if (MD->isExplicitlyDefaulted())
948 Out << "defaulted ";
949 else
950 Out << "implicit ";
951 }
952
953 if (const auto *CD = dyn_cast<CXXConstructorDecl>(Val: MD)) {
954 if (CD->isDefaultConstructor())
955 Out << "default ";
956 else if (CD->isCopyConstructor())
957 Out << "copy ";
958 else if (CD->isMoveConstructor())
959 Out << "move ";
960
961 Out << "constructor";
962 describeClass(Out, D: MD->getParent(), Prefix: " for ");
963 } else if (isa<CXXDestructorDecl>(Val: MD)) {
964 if (!MD->isUserProvided()) {
965 Out << "destructor";
966 describeClass(Out, D: MD->getParent(), Prefix: " for ");
967 } else {
968 // Use ~Foo for explicitly-written destructors.
969 Out << "'" << *MD << "'";
970 }
971 } else if (MD->isCopyAssignmentOperator()) {
972 Out << "copy assignment operator";
973 describeClass(Out, D: MD->getParent(), Prefix: " for ");
974 } else if (MD->isMoveAssignmentOperator()) {
975 Out << "move assignment operator";
976 describeClass(Out, D: MD->getParent(), Prefix: " for ");
977 } else {
978 if (MD->getParent()->getIdentifier())
979 Out << "'" << *MD->getParent() << "::" << *MD << "'";
980 else
981 Out << "'" << *MD << "'";
982 }
983
984 return true;
985 }
986
987 Out << Prefix << '\'' << cast<NamedDecl>(Val: *D);
988
989 // Adding template parameters.
990 if (const auto FD = dyn_cast<FunctionDecl>(Val: D))
991 if (const TemplateArgumentList *TAList =
992 FD->getTemplateSpecializationArgs())
993 describeTemplateParameters(Out, TAList: TAList->asArray(), LO: FD->getLangOpts(), Prefix: "<",
994 Postfix: ">");
995
996 Out << '\'';
997 return true;
998}
999
1000std::shared_ptr<PathDiagnosticEventPiece>
1001PathDiagnosticCallPiece::getCallEnterEvent() const {
1002 // We do not produce call enters and call exits for autosynthesized property
1003 // accessors. We do generally produce them for other functions coming from
1004 // the body farm because they may call callbacks that bring us back into
1005 // visible code.
1006 if (!Callee || IsCalleeAnAutosynthesizedPropertyAccessor)
1007 return nullptr;
1008
1009 SmallString<256> buf;
1010 llvm::raw_svector_ostream Out(buf);
1011
1012 Out << "Calling ";
1013 describeCodeDecl(Out, D: Callee, /*ExtendedDescription=*/true);
1014
1015 assert(callEnter.asLocation().isValid());
1016 return std::make_shared<PathDiagnosticEventPiece>(args: callEnter, args: Out.str());
1017}
1018
1019std::shared_ptr<PathDiagnosticEventPiece>
1020PathDiagnosticCallPiece::getCallEnterWithinCallerEvent() const {
1021 if (!callEnterWithin.asLocation().isValid())
1022 return nullptr;
1023 if (Callee->isImplicit() || !Callee->hasBody())
1024 return nullptr;
1025 if (const auto *MD = dyn_cast<CXXMethodDecl>(Val: Callee))
1026 if (MD->isDefaulted())
1027 return nullptr;
1028
1029 SmallString<256> buf;
1030 llvm::raw_svector_ostream Out(buf);
1031
1032 Out << "Entered call";
1033 describeCodeDecl(Out, D: Caller, /*ExtendedDescription=*/false, Prefix: " from ");
1034
1035 return std::make_shared<PathDiagnosticEventPiece>(args: callEnterWithin, args: Out.str());
1036}
1037
1038std::shared_ptr<PathDiagnosticEventPiece>
1039PathDiagnosticCallPiece::getCallExitEvent() const {
1040 // We do not produce call enters and call exits for autosynthesized property
1041 // accessors. We do generally produce them for other functions coming from
1042 // the body farm because they may call callbacks that bring us back into
1043 // visible code.
1044 if (NoExit || IsCalleeAnAutosynthesizedPropertyAccessor)
1045 return nullptr;
1046
1047 SmallString<256> buf;
1048 llvm::raw_svector_ostream Out(buf);
1049
1050 if (!CallStackMessage.empty()) {
1051 Out << CallStackMessage;
1052 } else {
1053 bool DidDescribe = describeCodeDecl(Out, D: Callee,
1054 /*ExtendedDescription=*/false,
1055 Prefix: "Returning from ");
1056 if (!DidDescribe)
1057 Out << "Returning to caller";
1058 }
1059
1060 assert(callReturn.asLocation().isValid());
1061 return std::make_shared<PathDiagnosticEventPiece>(args: callReturn, args: Out.str());
1062}
1063
1064static void compute_path_size(const PathPieces &pieces, unsigned &size) {
1065 for (const auto &I : pieces) {
1066 const PathDiagnosticPiece *piece = I.get();
1067 if (const auto *cp = dyn_cast<PathDiagnosticCallPiece>(Val: piece))
1068 compute_path_size(pieces: cp->path, size);
1069 else
1070 ++size;
1071 }
1072}
1073
1074unsigned PathDiagnostic::full_size() {
1075 unsigned size = 0;
1076 compute_path_size(pieces: path, size);
1077 return size;
1078}
1079
1080SmallString<32>
1081PathDiagnostic::getIssueHash(const SourceManager &SrcMgr,
1082 const LangOptions &LangOpts) const {
1083 PathDiagnosticLocation UPDLoc = getUniqueingLoc();
1084 FullSourceLoc FullLoc(
1085 SrcMgr.getExpansionLoc(Loc: UPDLoc.isValid() ? UPDLoc.asLocation()
1086 : getLocation().asLocation()),
1087 SrcMgr);
1088
1089 return clang::getIssueHash(IssueLoc: FullLoc, CheckerName: getCheckerName(), WarningMessage: getBugType(),
1090 IssueDecl: getDeclWithIssue(), LangOpts);
1091}
1092
1093//===----------------------------------------------------------------------===//
1094// FoldingSet profiling methods.
1095//===----------------------------------------------------------------------===//
1096
1097void PathDiagnosticLocation::Profile(llvm::FoldingSetNodeID &ID) const {
1098 ID.Add(x: Range.getBegin());
1099 ID.Add(x: Range.getEnd());
1100 ID.Add(x: static_cast<const SourceLocation &>(Loc));
1101}
1102
1103void PathDiagnosticPiece::Profile(llvm::FoldingSetNodeID &ID) const {
1104 ID.AddInteger(I: (unsigned) getKind());
1105 ID.AddString(String: str);
1106 // FIXME: Add profiling support for code hints.
1107 ID.AddInteger(I: (unsigned) getDisplayHint());
1108 ArrayRef<SourceRange> Ranges = getRanges();
1109 for (const auto &I : Ranges) {
1110 ID.Add(x: I.getBegin());
1111 ID.Add(x: I.getEnd());
1112 }
1113}
1114
1115void PathDiagnosticCallPiece::Profile(llvm::FoldingSetNodeID &ID) const {
1116 PathDiagnosticPiece::Profile(ID);
1117 for (const auto &I : path)
1118 ID.Add(x: *I);
1119}
1120
1121void PathDiagnosticSpotPiece::Profile(llvm::FoldingSetNodeID &ID) const {
1122 PathDiagnosticPiece::Profile(ID);
1123 ID.Add(x: Pos);
1124}
1125
1126void PathDiagnosticControlFlowPiece::Profile(llvm::FoldingSetNodeID &ID) const {
1127 PathDiagnosticPiece::Profile(ID);
1128 for (const auto &I : *this)
1129 ID.Add(x: I);
1130}
1131
1132void PathDiagnosticMacroPiece::Profile(llvm::FoldingSetNodeID &ID) const {
1133 PathDiagnosticSpotPiece::Profile(ID);
1134 for (const auto &I : subPieces)
1135 ID.Add(x: *I);
1136}
1137
1138void PathDiagnosticNotePiece::Profile(llvm::FoldingSetNodeID &ID) const {
1139 PathDiagnosticSpotPiece::Profile(ID);
1140}
1141
1142void PathDiagnosticPopUpPiece::Profile(llvm::FoldingSetNodeID &ID) const {
1143 PathDiagnosticSpotPiece::Profile(ID);
1144}
1145
1146void PathDiagnostic::Profile(llvm::FoldingSetNodeID &ID) const {
1147 ID.Add(x: getLocation());
1148 ID.Add(x: getUniqueingLoc());
1149 ID.AddString(String: BugType);
1150 ID.AddString(String: VerboseDesc);
1151 ID.AddString(String: Category);
1152}
1153
1154void PathDiagnostic::FullProfile(llvm::FoldingSetNodeID &ID) const {
1155 Profile(ID);
1156 for (const auto &I : path)
1157 ID.Add(x: *I);
1158 for (meta_iterator I = meta_begin(), E = meta_end(); I != E; ++I)
1159 ID.AddString(String: *I);
1160}
1161
1162LLVM_DUMP_METHOD void PathPieces::dump() const {
1163 unsigned index = 0;
1164 for (const PathDiagnosticPieceRef &Piece : *this) {
1165 llvm::errs() << "[" << index++ << "] ";
1166 Piece->dump();
1167 llvm::errs() << "\n";
1168 }
1169}
1170
1171LLVM_DUMP_METHOD void PathDiagnosticCallPiece::dump() const {
1172 llvm::errs() << "CALL\n--------------\n";
1173
1174 if (const Stmt *SLoc = getLocation().getStmtOrNull())
1175 SLoc->dump();
1176 else if (const auto *ND = dyn_cast_or_null<NamedDecl>(Val: getCallee()))
1177 llvm::errs() << *ND << "\n";
1178 else
1179 getLocation().dump();
1180}
1181
1182LLVM_DUMP_METHOD void PathDiagnosticEventPiece::dump() const {
1183 llvm::errs() << "EVENT\n--------------\n";
1184 llvm::errs() << getString() << "\n";
1185 llvm::errs() << " ---- at ----\n";
1186 getLocation().dump();
1187}
1188
1189LLVM_DUMP_METHOD void PathDiagnosticControlFlowPiece::dump() const {
1190 llvm::errs() << "CONTROL\n--------------\n";
1191 getStartLocation().dump();
1192 llvm::errs() << " ---- to ----\n";
1193 getEndLocation().dump();
1194}
1195
1196LLVM_DUMP_METHOD void PathDiagnosticMacroPiece::dump() const {
1197 llvm::errs() << "MACRO\n--------------\n";
1198 // FIXME: Print which macro is being invoked.
1199}
1200
1201LLVM_DUMP_METHOD void PathDiagnosticNotePiece::dump() const {
1202 llvm::errs() << "NOTE\n--------------\n";
1203 llvm::errs() << getString() << "\n";
1204 llvm::errs() << " ---- at ----\n";
1205 getLocation().dump();
1206}
1207
1208LLVM_DUMP_METHOD void PathDiagnosticPopUpPiece::dump() const {
1209 llvm::errs() << "POP-UP\n--------------\n";
1210 llvm::errs() << getString() << "\n";
1211 llvm::errs() << " ---- at ----\n";
1212 getLocation().dump();
1213}
1214
1215LLVM_DUMP_METHOD void PathDiagnosticLocation::dump() const {
1216 if (!isValid()) {
1217 llvm::errs() << "<INVALID>\n";
1218 return;
1219 }
1220
1221 switch (K) {
1222 case RangeK:
1223 // FIXME: actually print the range.
1224 llvm::errs() << "<range>\n";
1225 break;
1226 case SingleLocK:
1227 asLocation().dump();
1228 llvm::errs() << "\n";
1229 break;
1230 case StmtK:
1231 if (S)
1232 S->dump();
1233 else
1234 llvm::errs() << "<NULL STMT>\n";
1235 break;
1236 case DeclK:
1237 if (const auto *ND = dyn_cast_or_null<NamedDecl>(Val: D))
1238 llvm::errs() << *ND << "\n";
1239 else if (isa<BlockDecl>(Val: D))
1240 // FIXME: Make this nicer.
1241 llvm::errs() << "<block>\n";
1242 else if (D)
1243 llvm::errs() << "<unknown decl>\n";
1244 else
1245 llvm::errs() << "<NULL DECL>\n";
1246 break;
1247 }
1248}
1249