LLVM 24.0.0git
Debugify.cpp
Go to the documentation of this file.
1//===- Debugify.cpp - Check debug info preservation in optimizations ------===//
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/// \file In the `synthetic` mode, the `-debugify` attaches synthetic debug info
10/// to everything. It can be used to create targeted tests for debug info
11/// preservation. In addition, when using the `original` mode, it can check
12/// original debug info preservation. The `synthetic` mode is default one.
13///
14//===----------------------------------------------------------------------===//
15
17#include "llvm/ADT/BitVector.h"
19#include "llvm/Config/llvm-config.h"
20#include "llvm/IR/DIBuilder.h"
21#include "llvm/IR/DebugInfo.h"
23#include "llvm/IR/DebugLoc.h"
26#include "llvm/IR/Module.h"
28#include "llvm/Pass.h"
31#include "llvm/Support/JSON.h"
32#include <optional>
33#if LLVM_ENABLE_DEBUGLOC_TRACKING_ORIGIN
34// We need the Signals header to operate on stacktraces if we're using DebugLoc
35// origin-tracking.
37#else
39#endif
40
41#define DEBUG_TYPE "debugify"
42
43using namespace llvm;
44
45namespace {
46
47cl::opt<bool> ApplyAtomGroups("debugify-atoms", cl::init(false));
48
49cl::opt<bool> Quiet("debugify-quiet",
50 cl::desc("Suppress verbose debugify output"));
51
52cl::opt<uint64_t> DebugifyFunctionsLimit(
53 "debugify-func-limit",
54 cl::desc("Set max number of processed functions per pass."),
55 cl::init(UINT_MAX));
56
57enum class Level {
58 Locations,
59 LocationsAndVariables
60};
61
62cl::opt<Level> DebugifyLevel(
63 "debugify-level", cl::desc("Kind of debug info to add"),
64 cl::values(clEnumValN(Level::Locations, "locations", "Locations only"),
65 clEnumValN(Level::LocationsAndVariables, "location+variables",
66 "Locations and Variables")),
67 cl::init(Level::LocationsAndVariables));
68
69raw_ostream &dbg() { return Quiet ? nulls() : errs(); }
70
71#if LLVM_ENABLE_DEBUGLOC_TRACKING_ORIGIN
72cl::list<std::string> EnableOriginStacktraces(
73 "enable-origin-stacktraces",
74 cl::desc("Collect DebugLoc origin stacktraces; a comma-separated list of "
75 "passes may be given, in which case stacktraces will be collected "
76 "in those passes only"),
77 cl::value_desc("Pass1,Pass2,Pass3,..."), cl::CommaSeparated,
79
80// For a given pass, sets whether the collection of DebugLoc origin stacktraces
81// is enabled or not.
82static void setDebugLocOriginCollectionForPass(StringRef PassName) {
83 if (!EnableOriginStacktraces.getNumOccurrences()) {
84 llvm::DebugLocOriginCollectionEnabled = false;
85 return;
86 }
87 if (EnableOriginStacktraces.size() == 1 &&
88 EnableOriginStacktraces[0].empty()) {
89 llvm::DebugLocOriginCollectionEnabled = true;
90 return;
91 }
92 llvm::DebugLocOriginCollectionEnabled =
93 llvm::is_contained(EnableOriginStacktraces, PassName);
94}
95static void unsetDebugLocOriginCollection() {
96 llvm::DebugLocOriginCollectionEnabled = false;
97}
98
99// These maps refer to addresses in the current LLVM process, so we can reuse
100// them everywhere - therefore, we store them at file scope.
101static SymbolizedAddressMap SymbolizedAddrs;
102static AddressSet UnsymbolizedAddrs;
103
104std::string symbolizeStackTrace(const Instruction *I) {
105 // We flush the set of unsymbolized addresses at the latest possible moment,
106 // i.e. now.
107 if (!UnsymbolizedAddrs.empty()) {
108 sys::symbolizeAddresses(UnsymbolizedAddrs, SymbolizedAddrs);
109 UnsymbolizedAddrs.clear();
110 }
111 const DbgLocOrigin::StackTracesTy &OriginStackTraces =
112 I->getDebugLoc().getOriginStackTraces();
113 std::string Result;
114 raw_string_ostream OS(Result);
115 for (size_t TraceIdx = 0; TraceIdx < OriginStackTraces.size(); ++TraceIdx) {
116 if (TraceIdx != 0)
117 OS << "========================================\n";
118 auto &[Depth, StackTrace] = OriginStackTraces[TraceIdx];
119 unsigned VirtualFrameNo = 0;
120 for (int Frame = 0; Frame < Depth; ++Frame) {
121 assert(SymbolizedAddrs.contains(StackTrace[Frame]) &&
122 "Expected each address to have been symbolized.");
123 for (std::string &SymbolizedFrame : SymbolizedAddrs[StackTrace[Frame]]) {
124 OS << right_justify(formatv("#{0}", VirtualFrameNo++).str(),
125 std::log10(Depth) + 2)
126 << ' ' << SymbolizedFrame << '\n';
127 }
128 }
129 }
130 return Result;
131}
132void collectStackAddresses(Instruction &I) {
133 auto &OriginStackTraces = I.getDebugLoc().getOriginStackTraces();
134 for (auto &[Depth, StackTrace] : OriginStackTraces) {
135 for (int Frame = 0; Frame < Depth; ++Frame) {
136 void *Addr = StackTrace[Frame];
137 if (!SymbolizedAddrs.contains(Addr))
138 UnsymbolizedAddrs.insert(Addr);
139 }
140 }
141}
142#else
143// These functions are only used in origin-tracking builds; they are no-ops in
144// normal builds.
145static void setDebugLocOriginCollectionForPass(StringRef PassName) {}
146static void unsetDebugLocOriginCollection() {}
147
148cl::list<std::string> EnableOriginStacktraces(
149 "enable-origin-stacktraces",
150 cl::desc("Collect DebugLoc origin stacktraces; requires "
151 "LLVM_ENABLE_DEBUGLOC_COVERAGE_TRACKING=COVERAGE_AND_ORIGIN"),
153 cl::cb<void, std::string>([](std::string Pass) {
154 WithColor::warning() << "--enable-origin-stacktraces has no effect "
155 "without LLVM_ENABLE_DEBUGLOC_COVERAGE_TRACKING="
156 "COVERAGE_AND_ORIGIN\n";
157 }));
158
159void collectStackAddresses(Instruction &I) {}
160#endif // LLVM_ENABLE_DEBUGLOC_TRACKING_ORIGIN
161
162uint64_t getAllocSizeInBits(Module &M, Type *Ty) {
163 return Ty->isSized() ? M.getDataLayout().getTypeAllocSizeInBits(Ty) : 0;
164}
165
166bool isFunctionSkipped(Function &F) {
167 return F.isDeclaration() || !F.hasExactDefinition();
168}
169
170/// Find the basic block's terminating instruction.
171///
172/// Special care is needed to handle musttail and deopt calls, as these behave
173/// like (but are in fact not) terminators.
174Instruction *findTerminatingInstruction(BasicBlock &BB) {
175 if (auto *I = BB.getTerminatingMustTailCall())
176 return I;
177 if (auto *I = BB.getTerminatingDeoptimizeCall())
178 return I;
179 return BB.getTerminator();
180}
181} // end anonymous namespace
182
185 std::function<bool(DIBuilder &DIB, Function &F)> ApplyToMF) {
186 // Skip modules with debug info.
187 if (M.getNamedMetadata("llvm.dbg.cu")) {
188 dbg() << Banner << "Skipping module with debug info\n";
189 return false;
190 }
191
192 DIBuilder DIB(M);
193 LLVMContext &Ctx = M.getContext();
194 auto *Int32Ty = Type::getInt32Ty(Ctx);
195
196 // Get a DIType which corresponds to Ty.
198 auto getCachedDIType = [&](Type *Ty) -> DIType * {
199 uint64_t Size = getAllocSizeInBits(M, Ty);
200 DIType *&DTy = TypeCache[Size];
201 if (!DTy) {
202 std::string Name = "ty" + utostr(Size);
203 DTy = DIB.createBasicType(Name, Size, dwarf::DW_ATE_unsigned);
204 }
205 return DTy;
206 };
207
208 unsigned NextLine = 1;
209 unsigned NextVar = 1;
210 auto File = DIB.createFile(M.getName(), "/");
211 auto CU = DIB.createCompileUnit(DISourceLanguageName(dwarf::DW_LANG_C), File,
212 "debugify", /*isOptimized=*/true, "", 0);
213
214 // Visit each instruction.
215 for (Function &F : Functions) {
216 if (isFunctionSkipped(F))
217 continue;
218
219 bool InsertedDbgVal = false;
220 auto SPType = DIB.createSubroutineType(DIB.getOrCreateTypeArray({}));
222 DISubprogram::SPFlagDefinition | DISubprogram::SPFlagOptimized;
223 if (F.hasPrivateLinkage() || F.hasInternalLinkage())
224 SPFlags |= DISubprogram::SPFlagLocalToUnit;
225 auto SP = DIB.createFunction(CU, F.getName(), F.getName(), File, NextLine,
226 SPType, NextLine, DINode::FlagZero, SPFlags,
227 nullptr, nullptr, nullptr, nullptr, "",
228 /*UseKeyInstructions*/ ApplyAtomGroups);
229 F.setSubprogram(SP);
230
231 // Helper that inserts a dbg.value before \p InsertBefore, copying the
232 // location (and possibly the type, if it's non-void) from \p TemplateInst.
233 auto insertDbgVal = [&](Instruction &TemplateInst,
234 BasicBlock::iterator InsertPt) {
235 std::string Name = utostr(NextVar++);
236 Value *V = &TemplateInst;
237 if (TemplateInst.getType()->isVoidTy())
238 V = ConstantInt::get(Int32Ty, 0);
239 const DILocation *Loc = TemplateInst.getDebugLoc().get();
240 auto LocalVar = DIB.createAutoVariable(SP, Name, File, Loc->getLine(),
241 getCachedDIType(V->getType()),
242 /*AlwaysPreserve=*/true);
243 DIB.insertDbgValue(V, LocalVar, DIB.createExpression(), Loc, InsertPt);
244 };
245
246 for (BasicBlock &BB : F) {
247 // Attach debug locations.
248 for (Instruction &I : BB) {
249 uint64_t AtomGroup = ApplyAtomGroups ? NextLine : 0;
250 uint8_t AtomRank = ApplyAtomGroups ? 1 : 0;
251 uint64_t Line = NextLine++;
252 I.setDebugLoc(DILocation::get(Ctx, Line, 1, SP, nullptr, false,
253 AtomGroup, AtomRank));
254 }
255
256 if (DebugifyLevel < Level::LocationsAndVariables)
257 continue;
258
259 // Inserting debug values into EH pads can break IR invariants.
260 if (BB.isEHPad())
261 continue;
262
263 // Find the terminating instruction, after which no debug values are
264 // attached.
265 Instruction *LastInst = findTerminatingInstruction(BB);
266 assert(LastInst && "Expected basic block with a terminator");
267
268 // Maintain an insertion point which can't be invalidated when updates
269 // are made.
270 BasicBlock::iterator InsertPt = BB.getFirstInsertionPt();
271 assert(InsertPt != BB.end() && "Expected to find an insertion point");
272
273 // Insert after existing debug values to preserve order.
274 InsertPt.setHeadBit(false);
275
276 // Attach debug values.
277 for (Instruction *I = &*BB.begin(); I != LastInst; I = I->getNextNode()) {
278 // Skip void-valued instructions.
279 if (I->getType()->isVoidTy())
280 continue;
281
282 // Phis and EH pads must be grouped at the beginning of the block.
283 // Only advance the insertion point when we finish visiting these.
284 if (!isa<PHINode>(I) && !I->isEHPad())
285 InsertPt = std::next(I->getIterator());
286
287 insertDbgVal(*I, InsertPt);
288 InsertedDbgVal = true;
289 }
290 }
291 // Make sure we emit at least one dbg.value, otherwise MachineDebugify may
292 // not have anything to work with as it goes about inserting DBG_VALUEs.
293 // (It's common for MIR tests to be written containing skeletal IR with
294 // empty functions -- we're still interested in debugifying the MIR within
295 // those tests, and this helps with that.)
296 if (DebugifyLevel == Level::LocationsAndVariables && !InsertedDbgVal) {
297 auto *Term = findTerminatingInstruction(F.getEntryBlock());
298 insertDbgVal(*Term, Term->getIterator());
299 }
300 if (ApplyToMF)
301 ApplyToMF(DIB, F);
302 }
303 DIB.finalize();
304
305 // Track the number of distinct lines and variables.
306 NamedMDNode *NMD = M.getOrInsertNamedMetadata("llvm.debugify");
307 auto addDebugifyOperand = [&](unsigned N) {
309 Ctx, ValueAsMetadata::getConstant(ConstantInt::get(Int32Ty, N))));
310 };
311 addDebugifyOperand(NextLine - 1); // Original number of lines.
312 addDebugifyOperand(NextVar - 1); // Original number of variables.
313 assert(NMD->getNumOperands() == 2 &&
314 "llvm.debugify should have exactly 2 operands!");
315
316 // Claim that this synthetic debug info is valid.
317 StringRef DIVersionKey = "Debug Info Version";
318 if (!M.getModuleFlag(DIVersionKey))
319 M.addModuleFlag(Module::Warning, DIVersionKey, DEBUG_METADATA_VERSION);
320
321 return true;
322}
323
325 DebugInfoPerPass *DebugInfoBeforePass,
326 StringRef NameOfWrappedPass = "") {
327 setDebugLocOriginCollectionForPass(NameOfWrappedPass);
328 Module &M = *F.getParent();
329 auto FuncIt = F.getIterator();
331 return applyDebugifyMetadata(M, make_range(FuncIt, std::next(FuncIt)),
332 "FunctionDebugify: ", /*ApplyToMF*/ nullptr);
333 assert(DebugInfoBeforePass && "Missing debug info metadata");
334 return collectDebugInfoMetadata(M, M.functions(), *DebugInfoBeforePass,
335 "FunctionDebugify (original debuginfo)",
336 NameOfWrappedPass);
337}
338
340 DebugInfoPerPass *DebugInfoBeforePass,
341 StringRef NameOfWrappedPass = "") {
342 setDebugLocOriginCollectionForPass(NameOfWrappedPass);
344 return applyDebugifyMetadata(M, M.functions(),
345 "ModuleDebugify: ", /*ApplyToMF*/ nullptr);
346 assert(DebugInfoBeforePass && "Missing debug info metadata");
347 return collectDebugInfoMetadata(M, M.functions(), *DebugInfoBeforePass,
348 "ModuleDebugify (original debuginfo)",
349 NameOfWrappedPass);
350}
351
353 bool Changed = false;
354
355 // Remove the llvm.debugify and llvm.mir.debugify module-level named metadata.
356 NamedMDNode *DebugifyMD = M.getNamedMetadata("llvm.debugify");
357 if (DebugifyMD) {
358 M.eraseNamedMetadata(DebugifyMD);
359 Changed = true;
360 }
361
362 if (auto *MIRDebugifyMD = M.getNamedMetadata("llvm.mir.debugify")) {
363 M.eraseNamedMetadata(MIRDebugifyMD);
364 Changed = true;
365 }
366
367 // Strip out all debug intrinsics and supporting metadata (subprograms, types,
368 // variables, etc).
370
371 // Strip out the dead dbg.value prototype.
372 Function *DbgValF = M.getFunction("llvm.dbg.value");
373 if (DbgValF) {
374 assert(DbgValF->isDeclaration() && DbgValF->use_empty() &&
375 "Not all debug info stripped?");
376 DbgValF->eraseFromParent();
377 Changed = true;
378 }
379
380 // Strip out the module-level Debug Info Version metadata.
381 // FIXME: There must be an easier way to remove an operand from a NamedMDNode.
382 NamedMDNode *NMD = M.getModuleFlagsMetadata();
383 if (!NMD)
384 return Changed;
386 NMD->clearOperands();
387 for (MDNode *Flag : Flags) {
388 auto *Key = cast<MDString>(Flag->getOperand(1));
389 if (Key->getString() == "Debug Info Version") {
390 Changed = true;
391 continue;
392 }
393 NMD->addOperand(Flag);
394 }
395 // If we left it empty we might as well remove it.
396 if (NMD->getNumOperands() == 0)
397 NMD->eraseFromParent();
398
399 return Changed;
400}
401
402bool hasLoc(const Instruction &I) {
403 const DILocation *Loc = I.getDebugLoc().get();
404#if LLVM_ENABLE_DEBUGLOC_TRACKING_COVERAGE
405 DebugLocKind Kind = I.getDebugLoc().getKind();
406 return Loc || Kind != DebugLocKind::Normal;
407#else
408 return Loc;
409#endif
410}
411
414 DebugInfoPerPass &DebugInfoBeforePass,
415 StringRef Banner,
416 StringRef NameOfWrappedPass) {
417 LLVM_DEBUG(dbgs() << Banner << ": (before) " << NameOfWrappedPass << '\n');
418
419 if (!M.getNamedMetadata("llvm.dbg.cu")) {
420 dbg() << Banner << ": Skipping module without debug info\n";
421 return false;
422 }
423
424 uint64_t FunctionsCnt = DebugInfoBeforePass.DIFunctions.size();
425 // Visit each instruction.
426 for (Function &F : Functions) {
427 // Use DI collected after previous Pass (when -debugify-each is used).
428 if (DebugInfoBeforePass.DIFunctions.count(&F))
429 continue;
430
431 if (isFunctionSkipped(F))
432 continue;
433
434 // Stop collecting DI if the Functions number reached the limit.
435 if (++FunctionsCnt >= DebugifyFunctionsLimit)
436 break;
437 // Collect the DISubprogram.
438 auto *SP = F.getSubprogram();
439 DebugInfoBeforePass.DIFunctions.insert({&F, SP});
440 if (SP) {
441 LLVM_DEBUG(dbgs() << " Collecting subprogram: " << *SP << '\n');
442 for (const MDNode *DN : SP->getRetainedNodes()) {
443 if (const auto *DV = dyn_cast<DILocalVariable>(DN)) {
444 DebugInfoBeforePass.DIVariables[DV] = 0;
445 }
446 }
447 }
448 if (DebugifyLevel > Level::Locations) {
449 for (BasicBlock &BB : F) {
450 // Collect debug variable records.
451 for (Instruction &I : BB) {
452 // PHIs have no variable records.
453 if (isa<PHINode>(I))
454 continue;
455 auto HandleDbgVariable = [&](DbgVariableRecord *DbgVar) {
456 if (!SP)
457 return;
458 // Skip inlined variables.
459 if (DbgVar->getDebugLoc().getInlinedAt())
460 return;
461 // Skip undef values.
462 if (DbgVar->isKillLocation())
463 return;
464
465 auto *Var = DbgVar->getVariable();
466 DebugInfoBeforePass.DIVariables[Var]++;
467 };
468 for (DbgVariableRecord &DVR : filterDbgVars(I.getDbgRecordRange()))
469 HandleDbgVariable(&DVR);
470 }
471 }
472 }
473 }
474
475 return true;
476}
477
478// This checks the preservation of original debug info attached to functions.
479static bool checkFunctions(const DebugFnMap &DIFunctionsBefore,
480 const DebugFnMap &DIFunctionsAfter,
481 StringRef NameOfWrappedPass,
482 StringRef FileNameFromCU, bool ShouldWriteIntoJSON,
483 llvm::json::Array &Bugs) {
484 bool Preserved = true;
485 for (const auto &F : DIFunctionsAfter) {
486 if (F.second)
487 continue;
488 auto SPIt = DIFunctionsBefore.find(F.first);
489 if (SPIt == DIFunctionsBefore.end()) {
490 if (ShouldWriteIntoJSON)
491 Bugs.push_back(llvm::json::Object({{"metadata", "DISubprogram"},
492 {"name", F.first->getName()},
493 {"action", "not-generate"}}));
494 else
495 dbg() << "ERROR: " << NameOfWrappedPass
496 << " did not generate DISubprogram for " << F.first->getName()
497 << " from " << FileNameFromCU << '\n';
498 Preserved = false;
499 } else {
500 auto SP = SPIt->second;
501 if (!SP)
502 continue;
503 // If the function had the SP attached before the pass, consider it as
504 // a debug info bug.
505 if (ShouldWriteIntoJSON)
506 Bugs.push_back(llvm::json::Object({{"metadata", "DISubprogram"},
507 {"name", F.first->getName()},
508 {"action", "drop"}}));
509 else
510 dbg() << "ERROR: " << NameOfWrappedPass << " dropped DISubprogram of "
511 << F.first->getName() << " from " << FileNameFromCU << '\n';
512 Preserved = false;
513 }
514 }
515
516 return Preserved;
517}
518
520 StringRef NameOfWrappedPass,
521 StringRef FileNameFromCU,
522 bool ShouldWriteIntoJSON,
523 llvm::json::Array &Bugs) {
524 if (hasLoc(I))
525 return true;
526
527 Instruction *Instr = &I;
528 collectStackAddresses(I);
529 auto FnName = Instr->getFunction()->getName();
530 auto BB = Instr->getParent();
531 auto BBName = BB->hasName() ? BB->getName() : "no-name";
532 auto InstName = Instruction::getOpcodeName(Instr->getOpcode());
533
534 auto CreateJSONBugEntry = [&](const char *Action) {
535 auto BugEntry = llvm::json::Object({
536 {"metadata", "DILocation"},
537 {"fn-name", FnName.str()},
538 {"bb-name", BBName.str()},
539 {"instr", InstName},
540 {"action", Action},
541 });
542#if LLVM_ENABLE_DEBUGLOC_TRACKING_ORIGIN
543 if (!Instr->getDebugLoc().getOriginStackTraces().empty())
544 BugEntry.insert({"origin", symbolizeStackTrace(Instr)});
545#endif
546 Bugs.push_back(std::move(BugEntry));
547 };
548
549 if (ShouldWriteIntoJSON)
550 CreateJSONBugEntry("not-generate");
551 else
552 dbg() << "WARNING: " << NameOfWrappedPass
553 << " did not generate DILocation for " << *Instr << " (BB: " << BBName
554 << ", Fn: " << FnName << ", File: " << FileNameFromCU << ")\n";
555 return false;
556}
557
558// This checks the preservation of original debug variable intrinsics.
559static bool checkVars(const DebugVarMap &DIVarsBefore,
560 const DebugVarMap &DIVarsAfter,
561 StringRef NameOfWrappedPass, StringRef FileNameFromCU,
562 bool ShouldWriteIntoJSON, llvm::json::Array &Bugs) {
563 bool Preserved = true;
564 for (const auto &V : DIVarsBefore) {
565 auto VarIt = DIVarsAfter.find(V.first);
566 if (VarIt == DIVarsAfter.end())
567 continue;
568
569 unsigned NumOfDbgValsAfter = VarIt->second;
570
571 if (V.second > NumOfDbgValsAfter) {
572 if (ShouldWriteIntoJSON)
574 {{"metadata", "dbg-var-intrinsic"},
575 {"name", V.first->getName()},
576 {"fn-name", V.first->getScope()->getSubprogram()->getName()},
577 {"action", "drop"}}));
578 else
579 dbg() << "WARNING: " << NameOfWrappedPass
580 << " drops dbg.value()/dbg.declare() for " << V.first->getName()
581 << " from "
582 << "function " << V.first->getScope()->getSubprogram()->getName()
583 << " (file " << FileNameFromCU << ")\n";
584 Preserved = false;
585 }
586 }
587
588 return Preserved;
589}
590
591// Write the json data into the specifed file.
592static void writeJSON(StringRef OrigDIVerifyBugsReportFilePath,
593 StringRef FileNameFromCU, StringRef NameOfWrappedPass,
594 llvm::json::Array &Bugs) {
595 std::error_code EC;
596 raw_fd_ostream OS_FILE{OrigDIVerifyBugsReportFilePath, EC,
598 if (EC) {
599 errs() << "Could not open file: " << EC.message() << ", "
600 << OrigDIVerifyBugsReportFilePath << '\n';
601 return;
602 }
603
604 if (auto L = OS_FILE.lock()) {
605 OS_FILE << "{\"file\":\"" << FileNameFromCU << "\", ";
606
608 NameOfWrappedPass != "" ? NameOfWrappedPass : "no-name";
609 OS_FILE << "\"pass\":\"" << PassName << "\", ";
610
611 llvm::json::Value BugsToPrint{std::move(Bugs)};
612 OS_FILE << "\"bugs\": " << BugsToPrint;
613
614 OS_FILE << "}\n";
615 }
616 OS_FILE.close();
617}
618
621 DebugInfoPerPass &DebugInfoBeforePass,
622 StringRef Banner, StringRef NameOfWrappedPass,
623 StringRef OrigDIVerifyBugsReportFilePath) {
624 LLVM_DEBUG(dbgs() << Banner << ": (after) " << NameOfWrappedPass << '\n');
625 unsetDebugLocOriginCollection();
626
627 if (!M.getNamedMetadata("llvm.dbg.cu")) {
628 dbg() << Banner << ": Skipping module without debug info\n";
629 return false;
630 }
631
632 // Map the debug info holding DIs after a pass.
633 DebugInfoPerPass DebugInfoAfterPass;
634
635 bool ShouldWriteIntoJSON = !OrigDIVerifyBugsReportFilePath.empty();
636
637 // TODO: The name of the module could be read better?
638 StringRef FileNameFromCU =
639 (cast<DICompileUnit>(M.getNamedMetadata("llvm.dbg.cu")->getOperand(0)))
640 ->getFilename();
642
643 bool ResultForInsts = true;
644
645 // Visit each instruction.
646 for (Function &F : Functions) {
647 if (isFunctionSkipped(F))
648 continue;
649
650 // Don't process functions without DI collected before the Pass.
651 if (!DebugInfoBeforePass.DIFunctions.count(&F))
652 continue;
653 // TODO: Collect metadata other than DISubprograms.
654 // Collect the DISubprogram.
655 auto *SP = F.getSubprogram();
656 DebugInfoAfterPass.DIFunctions.insert({&F, SP});
657
658 if (SP) {
659 LLVM_DEBUG(dbgs() << " Collecting subprogram: " << *SP << '\n');
660 for (const MDNode *DN : SP->getRetainedNodes()) {
661 if (const auto *DV = dyn_cast<DILocalVariable>(DN)) {
662 DebugInfoAfterPass.DIVariables[DV] = 0;
663 }
664 }
665 }
666
667 for (BasicBlock &BB : F) {
668 // Collect debug locations (!dbg) and debug variable intrinsics.
669 for (Instruction &I : BB) {
670 // Skip PHIs.
671 if (isa<PHINode>(I))
672 continue;
673
674 // Collect dbg.values and dbg.declares.
675 if (DebugifyLevel > Level::Locations) {
676 auto HandleDbgVariable = [&](DbgVariableRecord *DbgVar) {
677 if (!SP)
678 return;
679 // Skip inlined variables.
680 if (DbgVar->getDebugLoc().getInlinedAt())
681 return;
682 // Skip undef values.
683 if (DbgVar->isKillLocation())
684 return;
685
686 auto *Var = DbgVar->getVariable();
687 DebugInfoAfterPass.DIVariables[Var]++;
688 };
689 for (DbgVariableRecord &DVR : filterDbgVars(I.getDbgRecordRange()))
690 HandleDbgVariable(&DVR);
691 }
692
693 LLVM_DEBUG(dbgs() << " Collecting info for inst: " << I << '\n');
694
695 // Track the addresses to symbolize, if the feature is enabled.
696 bool InstResult = checkInstructionCoverage(
697 I, NameOfWrappedPass, FileNameFromCU, ShouldWriteIntoJSON, Bugs);
698 if (!InstResult)
699 I.setDebugLoc(DebugLoc::getUnknown());
700 ResultForInsts &= InstResult;
701 }
702 }
703 }
704
705 auto DIFunctionsBefore = DebugInfoBeforePass.DIFunctions;
706 auto DIFunctionsAfter = DebugInfoAfterPass.DIFunctions;
707
708 auto InstToDelete = DebugInfoBeforePass.InstToDelete;
709
710 auto DIVarsBefore = DebugInfoBeforePass.DIVariables;
711 auto DIVarsAfter = DebugInfoAfterPass.DIVariables;
712
713 bool ResultForFunc =
714 checkFunctions(DIFunctionsBefore, DIFunctionsAfter, NameOfWrappedPass,
715 FileNameFromCU, ShouldWriteIntoJSON, Bugs);
716
717 bool ResultForVars = checkVars(DIVarsBefore, DIVarsAfter, NameOfWrappedPass,
718 FileNameFromCU, ShouldWriteIntoJSON, Bugs);
719
720 bool Result = ResultForFunc && ResultForInsts && ResultForVars;
721
722 StringRef ResultBanner = NameOfWrappedPass != "" ? NameOfWrappedPass : Banner;
723 if (ShouldWriteIntoJSON && !Bugs.empty())
724 writeJSON(OrigDIVerifyBugsReportFilePath, FileNameFromCU, NameOfWrappedPass,
725 Bugs);
726
727 if (Result)
728 dbg() << ResultBanner << ": PASS\n";
729 else
730 dbg() << ResultBanner << ": FAIL\n";
731
732 // In the case of the `debugify-each`, no need to go over all the instructions
733 // again in the collectDebugInfoMetadata(), since as an input we can use
734 // the debugging information from the previous pass.
735 DebugInfoBeforePass = DebugInfoAfterPass;
736
737 LLVM_DEBUG(dbgs() << "\n\n");
738 return Result;
739}
740
741namespace {
742/// Return true if a mis-sized diagnostic is issued for \p DbgVal.
743template <typename DbgValTy>
744bool diagnoseMisSizedDbgValue(Module &M, DbgValTy *DbgVal) {
745 // The size of a dbg.value's value operand should match the size of the
746 // variable it corresponds to.
747 //
748 // TODO: This, along with a check for non-null value operands, should be
749 // promoted to verifier failures.
750
751 // For now, don't try to interpret anything more complicated than an empty
752 // DIExpression. Eventually we should try to handle OP_deref and fragments.
753 if (DbgVal->getExpression()->getNumElements())
754 return false;
755
756 Value *V = DbgVal->getVariableLocationOp(0);
757 if (!V)
758 return false;
759
760 Type *Ty = V->getType();
761 uint64_t ValueOperandSize = getAllocSizeInBits(M, Ty);
762 std::optional<uint64_t> DbgVarSize = DbgVal->getFragmentSizeInBits();
763 if (!ValueOperandSize || !DbgVarSize)
764 return false;
765
766 bool HasBadSize = false;
767 if (Ty->isIntegerTy()) {
768 auto Signedness = DbgVal->getVariable()->getSignedness();
769 if (Signedness == DIBasicType::Signedness::Signed)
770 HasBadSize = ValueOperandSize < *DbgVarSize;
771 } else {
772 HasBadSize = ValueOperandSize != *DbgVarSize;
773 }
774
775 if (HasBadSize) {
776 dbg() << "ERROR: dbg.value operand has size " << ValueOperandSize
777 << ", but its variable has size " << *DbgVarSize << ": ";
778 DbgVal->print(dbg());
779 dbg() << "\n";
780 }
781 return HasBadSize;
782}
783
784bool checkDebugifyMetadata(Module &M,
786 StringRef NameOfWrappedPass, StringRef Banner,
787 bool Strip, DebugifyStatsMap *StatsMap) {
788 // Skip modules without debugify metadata.
789 NamedMDNode *NMD = M.getNamedMetadata("llvm.debugify");
790 unsetDebugLocOriginCollection();
791 if (!NMD) {
792 dbg() << Banner << ": Skipping module without debugify metadata\n";
793 return false;
794 }
795
796 auto getDebugifyOperand = [&](unsigned Idx) -> unsigned {
798 ->getZExtValue();
799 };
800 assert(NMD->getNumOperands() == 2 &&
801 "llvm.debugify should have exactly 2 operands!");
802 unsigned OriginalNumLines = getDebugifyOperand(0);
803 unsigned OriginalNumVars = getDebugifyOperand(1);
804 bool HasErrors = false;
805
806 // Track debug info loss statistics if able.
807 DebugifyStatistics *Stats = nullptr;
808 if (StatsMap && !NameOfWrappedPass.empty())
809 Stats = &StatsMap->operator[](NameOfWrappedPass);
810
811 BitVector MissingLines{OriginalNumLines, true};
812 BitVector MissingVars{OriginalNumVars, true};
813 for (Function &F : Functions) {
814 if (isFunctionSkipped(F))
815 continue;
816
817 // Find missing lines.
818 for (Instruction &I : instructions(F)) {
819 auto DL = I.getDebugLoc();
820 if (DL && DL.getLine() != 0) {
821 MissingLines.reset(DL.getLine() - 1);
822 continue;
823 }
824
825 if (!isa<PHINode>(&I) && !DL) {
826 dbg() << "WARNING: Instruction with empty DebugLoc in function ";
827 dbg() << F.getName() << " --";
828 I.print(dbg());
829 dbg() << "\n";
830 }
831 }
832
833 // Find missing variables and mis-sized debug values.
834 auto CheckForMisSized = [&](auto *DbgVal) {
835 unsigned Var = ~0U;
836 (void)to_integer(DbgVal->getVariable()->getName(), Var, 10);
837 assert(Var <= OriginalNumVars && "Unexpected name for DILocalVariable");
838 bool HasBadSize = diagnoseMisSizedDbgValue(M, DbgVal);
839 if (!HasBadSize)
840 MissingVars.reset(Var - 1);
841 HasErrors |= HasBadSize;
842 };
843 for (Instruction &I : instructions(F)) {
844 for (DbgVariableRecord &DVR : filterDbgVars(I.getDbgRecordRange()))
845 if (DVR.isDbgValue() || DVR.isDbgAssign())
846 CheckForMisSized(&DVR);
847 }
848 }
849
850 // Print the results.
851 for (unsigned Idx : MissingLines.set_bits())
852 dbg() << "WARNING: Missing line " << Idx + 1 << "\n";
853
854 for (unsigned Idx : MissingVars.set_bits())
855 dbg() << "WARNING: Missing variable " << Idx + 1 << "\n";
856
857 // Update DI loss statistics.
858 if (Stats) {
859 Stats->NumDbgLocsExpected += OriginalNumLines;
860 Stats->NumDbgLocsMissing += MissingLines.count();
861 Stats->NumDbgValuesExpected += OriginalNumVars;
862 Stats->NumDbgValuesMissing += MissingVars.count();
863 }
864
865 dbg() << Banner;
866 if (!NameOfWrappedPass.empty())
867 dbg() << " [" << NameOfWrappedPass << "]";
868 dbg() << ": " << (HasErrors ? "FAIL" : "PASS") << '\n';
869
870 // Strip debugify metadata if required.
871 bool Ret = false;
872 if (Strip)
873 Ret = stripDebugifyMetadata(M);
874
875 return Ret;
876}
877
878/// ModulePass for attaching synthetic debug info to everything, used with the
879/// legacy module pass manager.
880struct DebugifyModulePass : public ModulePass {
881 bool runOnModule(Module &M) override {
882 bool Result =
883 applyDebugify(M, Mode, DebugInfoBeforePass, NameOfWrappedPass);
884 return Result;
885 }
886
887 DebugifyModulePass(enum DebugifyMode Mode = DebugifyMode::SyntheticDebugInfo,
888 StringRef NameOfWrappedPass = "",
889 DebugInfoPerPass *DebugInfoBeforePass = nullptr)
890 : ModulePass(ID), NameOfWrappedPass(NameOfWrappedPass),
891 DebugInfoBeforePass(DebugInfoBeforePass), Mode(Mode) {}
892
893 void getAnalysisUsage(AnalysisUsage &AU) const override {
894 AU.setPreservesAll();
895 }
896
897 static char ID; // Pass identification.
898
899private:
900 StringRef NameOfWrappedPass;
901 DebugInfoPerPass *DebugInfoBeforePass;
902 enum DebugifyMode Mode;
903};
904
905/// FunctionPass for attaching synthetic debug info to instructions within a
906/// single function, used with the legacy module pass manager.
907struct DebugifyFunctionPass : public FunctionPass {
908 bool runOnFunction(Function &F) override {
909 bool Result =
910 applyDebugify(F, Mode, DebugInfoBeforePass, NameOfWrappedPass);
911 return Result;
912 }
913
914 DebugifyFunctionPass(
916 StringRef NameOfWrappedPass = "",
917 DebugInfoPerPass *DebugInfoBeforePass = nullptr)
918 : FunctionPass(ID), NameOfWrappedPass(NameOfWrappedPass),
919 DebugInfoBeforePass(DebugInfoBeforePass), Mode(Mode) {}
920
921 void getAnalysisUsage(AnalysisUsage &AU) const override {
922 AU.setPreservesAll();
923 }
924
925 static char ID; // Pass identification.
926
927private:
928 StringRef NameOfWrappedPass;
929 DebugInfoPerPass *DebugInfoBeforePass;
930 enum DebugifyMode Mode;
931};
932
933/// ModulePass for checking debug info inserted by -debugify, used with the
934/// legacy module pass manager.
935struct CheckDebugifyModulePass : public ModulePass {
936 bool runOnModule(Module &M) override {
937 bool Result;
939 Result = checkDebugifyMetadata(M, M.functions(), NameOfWrappedPass,
940 "CheckModuleDebugify", Strip, StatsMap);
941 else
943 M, M.functions(), *DebugInfoBeforePass,
944 "CheckModuleDebugify (original debuginfo)", NameOfWrappedPass,
945 OrigDIVerifyBugsReportFilePath);
946
947 return Result;
948 }
949
950 CheckDebugifyModulePass(
951 bool Strip = false, StringRef NameOfWrappedPass = "",
952 DebugifyStatsMap *StatsMap = nullptr,
954 DebugInfoPerPass *DebugInfoBeforePass = nullptr,
955 StringRef OrigDIVerifyBugsReportFilePath = "")
956 : ModulePass(ID), NameOfWrappedPass(NameOfWrappedPass),
957 OrigDIVerifyBugsReportFilePath(OrigDIVerifyBugsReportFilePath),
958 StatsMap(StatsMap), DebugInfoBeforePass(DebugInfoBeforePass), Mode(Mode),
959 Strip(Strip) {}
960
961 void getAnalysisUsage(AnalysisUsage &AU) const override {
962 AU.setPreservesAll();
963 }
964
965 static char ID; // Pass identification.
966
967private:
968 StringRef NameOfWrappedPass;
969 StringRef OrigDIVerifyBugsReportFilePath;
970 DebugifyStatsMap *StatsMap;
971 DebugInfoPerPass *DebugInfoBeforePass;
972 enum DebugifyMode Mode;
973 bool Strip;
974};
975
976/// FunctionPass for checking debug info inserted by -debugify-function, used
977/// with the legacy module pass manager.
978struct CheckDebugifyFunctionPass : public FunctionPass {
979 bool runOnFunction(Function &F) override {
980 Module &M = *F.getParent();
981 auto FuncIt = F.getIterator();
982 bool Result;
984 Result = checkDebugifyMetadata(M, make_range(FuncIt, std::next(FuncIt)),
985 NameOfWrappedPass, "CheckFunctionDebugify",
986 Strip, StatsMap);
987 else
989 M, make_range(FuncIt, std::next(FuncIt)), *DebugInfoBeforePass,
990 "CheckFunctionDebugify (original debuginfo)", NameOfWrappedPass,
991 OrigDIVerifyBugsReportFilePath);
992
993 return Result;
994 }
995
996 CheckDebugifyFunctionPass(
997 bool Strip = false, StringRef NameOfWrappedPass = "",
998 DebugifyStatsMap *StatsMap = nullptr,
1000 DebugInfoPerPass *DebugInfoBeforePass = nullptr,
1001 StringRef OrigDIVerifyBugsReportFilePath = "")
1002 : FunctionPass(ID), NameOfWrappedPass(NameOfWrappedPass),
1003 OrigDIVerifyBugsReportFilePath(OrigDIVerifyBugsReportFilePath),
1004 StatsMap(StatsMap), DebugInfoBeforePass(DebugInfoBeforePass), Mode(Mode),
1005 Strip(Strip) {}
1006
1007 void getAnalysisUsage(AnalysisUsage &AU) const override {
1008 AU.setPreservesAll();
1009 }
1010
1011 static char ID; // Pass identification.
1012
1013private:
1014 StringRef NameOfWrappedPass;
1015 StringRef OrigDIVerifyBugsReportFilePath;
1016 DebugifyStatsMap *StatsMap;
1017 DebugInfoPerPass *DebugInfoBeforePass;
1018 enum DebugifyMode Mode;
1019 bool Strip;
1020};
1021
1022} // end anonymous namespace
1023
1025 std::error_code EC;
1026 raw_fd_ostream OS{Path, EC};
1027 if (EC) {
1028 errs() << "Could not open file: " << EC.message() << ", " << Path << '\n';
1029 return;
1030 }
1031
1032 OS << "Pass Name" << ',' << "# of missing debug values" << ','
1033 << "# of missing locations" << ',' << "Missing/Expected value ratio" << ','
1034 << "Missing/Expected location ratio" << '\n';
1035 for (const auto &Entry : Map) {
1036 StringRef Pass = Entry.first;
1037 DebugifyStatistics Stats = Entry.second;
1038
1039 OS << Pass << ',' << Stats.NumDbgValuesMissing << ','
1040 << Stats.NumDbgLocsMissing << ',' << Stats.getMissingValueRatio() << ','
1041 << Stats.getEmptyLocationRatio() << '\n';
1042 }
1043}
1044
1046 llvm::StringRef NameOfWrappedPass,
1047 DebugInfoPerPass *DebugInfoBeforePass) {
1049 return new DebugifyModulePass();
1050 assert(Mode == DebugifyMode::OriginalDebugInfo && "Must be original mode");
1051 return new DebugifyModulePass(Mode, NameOfWrappedPass, DebugInfoBeforePass);
1052}
1053
1056 llvm::StringRef NameOfWrappedPass,
1057 DebugInfoPerPass *DebugInfoBeforePass) {
1059 return new DebugifyFunctionPass();
1060 assert(Mode == DebugifyMode::OriginalDebugInfo && "Must be original mode");
1061 return new DebugifyFunctionPass(Mode, NameOfWrappedPass, DebugInfoBeforePass);
1062}
1063
1066 if (ApplyToMF) {
1067 auto ApplyToMFWrapper = [&](DIBuilder &DIB, Function &F) -> bool {
1068 return ApplyToMF(DIB, F, AM);
1069 };
1070 applyDebugifyMetadata(M, M.functions(),
1071 "ModuleDebugify: ", ApplyToMFWrapper);
1072 } else {
1073 applyDebugifyMetadata(M, M.functions(), "ModuleDebugify: ", nullptr);
1074 }
1075 } else {
1076 collectDebugInfoMetadata(M, M.functions(), *DebugInfoBeforePass,
1077 "ModuleDebugify (original debuginfo)",
1078 NameOfWrappedPass);
1079 }
1080
1082 if (ApplyToMF)
1085 return PA;
1086}
1087
1089 bool Strip, StringRef NameOfWrappedPass, DebugifyStatsMap *StatsMap,
1090 enum DebugifyMode Mode, DebugInfoPerPass *DebugInfoBeforePass,
1091 StringRef OrigDIVerifyBugsReportFilePath) {
1093 return new CheckDebugifyModulePass(Strip, NameOfWrappedPass, StatsMap);
1094 assert(Mode == DebugifyMode::OriginalDebugInfo && "Must be original mode");
1095 return new CheckDebugifyModulePass(false, NameOfWrappedPass, nullptr, Mode,
1096 DebugInfoBeforePass,
1097 OrigDIVerifyBugsReportFilePath);
1098}
1099
1101 bool Strip, StringRef NameOfWrappedPass, DebugifyStatsMap *StatsMap,
1102 enum DebugifyMode Mode, DebugInfoPerPass *DebugInfoBeforePass,
1103 StringRef OrigDIVerifyBugsReportFilePath) {
1105 return new CheckDebugifyFunctionPass(Strip, NameOfWrappedPass, StatsMap);
1106 assert(Mode == DebugifyMode::OriginalDebugInfo && "Must be original mode");
1107 return new CheckDebugifyFunctionPass(false, NameOfWrappedPass, nullptr, Mode,
1108 DebugInfoBeforePass,
1109 OrigDIVerifyBugsReportFilePath);
1110}
1111
1115 checkDebugifyMetadata(M, M.functions(), NameOfWrappedPass,
1116 "CheckModuleDebugify", Strip, StatsMap);
1117 else
1119 M, M.functions(), *DebugInfoBeforePass,
1120 "CheckModuleDebugify (original debuginfo)", NameOfWrappedPass,
1121 OrigDIVerifyBugsReportFilePath);
1122
1123 return PreservedAnalyses::all();
1124}
1125
1126static bool isIgnoredPass(StringRef PassID) {
1127 return isSpecialPass(PassID, {"PassManager", "PassAdaptor",
1128 "AnalysisManagerProxy", "PrintFunctionPass",
1129 "PrintModulePass", "BitcodeWriterPass",
1130 "ThinLTOBitcodeWriterPass", "VerifierPass"});
1131}
1132
1135 PIC.registerBeforeNonSkippedPassCallback([this, &MAM](StringRef P, Any IR) {
1136 if (isIgnoredPass(P))
1137 return;
1140 if (const auto **CF = llvm::any_cast<const Function *>(&IR)) {
1141 Function &F = *const_cast<Function *>(*CF);
1142 applyDebugify(F, Mode, DebugInfoBeforePass, P);
1143 MAM.getResult<FunctionAnalysisManagerModuleProxy>(*F.getParent())
1144 .getManager()
1145 .invalidate(F, PA);
1146 } else if (const auto **CM = llvm::any_cast<const Module *>(&IR)) {
1147 Module &M = *const_cast<Module *>(*CM);
1148 applyDebugify(M, Mode, DebugInfoBeforePass, P);
1149 MAM.invalidate(M, PA);
1150 }
1151 });
1152 PIC.registerAfterPassCallback(
1153 [this, &MAM](StringRef P, Any IR, const PreservedAnalyses &PassPA) {
1154 if (isIgnoredPass(P))
1155 return;
1158 if (const auto **CF = llvm::any_cast<const Function *>(&IR)) {
1159 auto &F = *const_cast<Function *>(*CF);
1160 Module &M = *F.getParent();
1161 auto It = F.getIterator();
1163 checkDebugifyMetadata(M, make_range(It, std::next(It)), P,
1164 "CheckFunctionDebugify", /*Strip=*/true,
1165 DIStatsMap);
1166 else
1167 checkDebugInfoMetadata(M, make_range(It, std::next(It)),
1168 *DebugInfoBeforePass,
1169 "CheckModuleDebugify (original debuginfo)",
1170 P, OrigDIVerifyBugsReportFilePath);
1171 MAM.getResult<FunctionAnalysisManagerModuleProxy>(*F.getParent())
1172 .getManager()
1173 .invalidate(F, PA);
1174 } else if (const auto **CM = llvm::any_cast<const Module *>(&IR)) {
1175 Module &M = *const_cast<Module *>(*CM);
1177 checkDebugifyMetadata(M, M.functions(), P, "CheckModuleDebugify",
1178 /*Strip=*/true, DIStatsMap);
1179 else
1180 checkDebugInfoMetadata(M, M.functions(), *DebugInfoBeforePass,
1181 "CheckModuleDebugify (original debuginfo)",
1182 P, OrigDIVerifyBugsReportFilePath);
1183 MAM.invalidate(M, PA);
1184 }
1185 });
1186}
1187
1188char DebugifyModulePass::ID = 0;
1190 "Attach debug info to everything");
1191
1192char CheckDebugifyModulePass::ID = 0;
1194 CDM("check-debugify", "Check debug info from -debugify");
1195
1196char DebugifyFunctionPass::ID = 0;
1197static RegisterPass<DebugifyFunctionPass> DF("debugify-function",
1198 "Attach debug info to a function");
1199
1200char CheckDebugifyFunctionPass::ID = 0;
1202 CDF("check-debugify-function", "Check debug info from -debugify-function");
assert(UImm &&(UImm !=~static_cast< T >(0)) &&"Invalid immediate!")
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
Expand Atomic instructions
This file implements the BitVector class.
#define clEnumValN(ENUMVAL, FLAGNAME, DESC)
static RegisterPass< CheckDebugifyModulePass > CDM("check-debugify", "Check debug info from -debugify")
ModulePass * createDebugifyModulePass(enum DebugifyMode Mode, llvm::StringRef NameOfWrappedPass, DebugInfoPerPass *DebugInfoBeforePass)
bool hasLoc(const Instruction &I)
Definition Debugify.cpp:402
FunctionPass * createDebugifyFunctionPass(enum DebugifyMode Mode, llvm::StringRef NameOfWrappedPass, DebugInfoPerPass *DebugInfoBeforePass)
static bool isIgnoredPass(StringRef PassID)
static bool applyDebugify(Function &F, enum DebugifyMode Mode, DebugInfoPerPass *DebugInfoBeforePass, StringRef NameOfWrappedPass="")
Definition Debugify.cpp:324
static bool checkInstructionCoverage(Instruction &I, StringRef NameOfWrappedPass, StringRef FileNameFromCU, bool ShouldWriteIntoJSON, llvm::json::Array &Bugs)
Definition Debugify.cpp:519
ModulePass * createCheckDebugifyModulePass(bool Strip, StringRef NameOfWrappedPass, DebugifyStatsMap *StatsMap, enum DebugifyMode Mode, DebugInfoPerPass *DebugInfoBeforePass, StringRef OrigDIVerifyBugsReportFilePath)
static void writeJSON(StringRef OrigDIVerifyBugsReportFilePath, StringRef FileNameFromCU, StringRef NameOfWrappedPass, llvm::json::Array &Bugs)
Definition Debugify.cpp:592
static RegisterPass< DebugifyFunctionPass > DF("debugify-function", "Attach debug info to a function")
static RegisterPass< DebugifyModulePass > DM("debugify", "Attach debug info to everything")
static bool checkFunctions(const DebugFnMap &DIFunctionsBefore, const DebugFnMap &DIFunctionsAfter, StringRef NameOfWrappedPass, StringRef FileNameFromCU, bool ShouldWriteIntoJSON, llvm::json::Array &Bugs)
Definition Debugify.cpp:479
static RegisterPass< CheckDebugifyFunctionPass > CDF("check-debugify-function", "Check debug info from -debugify-function")
FunctionPass * createCheckDebugifyFunctionPass(bool Strip, StringRef NameOfWrappedPass, DebugifyStatsMap *StatsMap, enum DebugifyMode Mode, DebugInfoPerPass *DebugInfoBeforePass, StringRef OrigDIVerifyBugsReportFilePath)
static bool checkVars(const DebugVarMap &DIVarsBefore, const DebugVarMap &DIVarsAfter, StringRef NameOfWrappedPass, StringRef FileNameFromCU, bool ShouldWriteIntoJSON, llvm::json::Array &Bugs)
Definition Debugify.cpp:559
DebugifyMode
Used to check whether we track synthetic or original debug info.
Definition Debugify.h:96
@ SyntheticDebugInfo
Definition Debugify.h:96
@ OriginalDebugInfo
Definition Debugify.h:96
llvm::MapVector< const llvm::Function *, const llvm::DISubprogram * > DebugFnMap
Definition Debugify.h:29
llvm::MapVector< llvm::StringRef, DebugifyStatistics > DebugifyStatsMap
Map pass names to a per-pass DebugifyStatistics instance.
Definition Debugify.h:157
llvm::MapVector< const llvm::DILocalVariable *, unsigned > DebugVarMap
Definition Debugify.h:32
static bool runOnFunction(Function &F, bool PostInlining)
static SmallString< 128 > getFilename(const DIScope *SP, vfs::FileSystem &VFS)
Extract a filename for a DIScope.
Module.h This file contains the declarations for the Module class.
This file supports working with JSON data.
Legalize the Machine IR a function s Machine IR
Definition Legalizer.cpp:81
#define F(x, y, z)
Definition MD5.cpp:54
#define I(x, y, z)
Definition MD5.cpp:57
block placement Basic Block Placement Stats
Machine Check Debug Module
#define P(N)
ModuleAnalysisManager MAM
PassInstrumentationCallbacks PIC
This file defines the Pass Instrumentation classes that provide instrumentation points into the pass ...
static cl::opt< RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode > Mode("regalloc-enable-advisor", cl::Hidden, cl::init(RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode::Default), cl::desc("Enable regalloc advisor mode"), cl::values(clEnumValN(RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode::Default, "default", "Default"), clEnumValN(RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode::Release, "release", "precompiled"), clEnumValN(RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode::Development, "development", "for training")))
This file contains some functions that are useful when dealing with strings.
#define LLVM_DEBUG(...)
Definition Debug.h:119
static const char PassName[]
LLVM_ABI llvm::PreservedAnalyses run(llvm::Module &M, llvm::ModuleAnalysisManager &AM)
LLVM_ABI llvm::PreservedAnalyses run(llvm::Module &M, llvm::ModuleAnalysisManager &AM)
void setPreservesAll()
Set by analyses that do not transform their input at all.
LLVM Basic Block Representation.
Definition BasicBlock.h:62
LLVM_ABI const CallInst * getTerminatingDeoptimizeCall() const
Returns the call instruction calling @llvm.experimental.deoptimize prior to the terminating return in...
InstListType::iterator iterator
Instruction iterators...
Definition BasicBlock.h:170
LLVM_ABI const CallInst * getTerminatingMustTailCall() const
Returns the call instruction marked 'musttail' prior to the terminating return instruction of this ba...
const Instruction * getTerminator() const LLVM_READONLY
Returns the terminator instruction; assumes that the block is well-formed.
Definition BasicBlock.h:237
BitVector & reset()
Reset all bits in the bitvector.
Definition BitVector.h:409
size_type count() const
Returns the number of bits which are set.
Definition BitVector.h:181
iterator_range< const_set_bits_iterator > set_bits() const
Definition BitVector.h:159
Represents analyses that only rely on functions' control flow.
Definition Analysis.h:73
LLVM_ABI void finalize()
Construct any deferred debug info descriptors.
Definition DIBuilder.cpp:74
LLVM_ABI DISubroutineType * createSubroutineType(DITypeArray ParameterTypes, DINode::DIFlags Flags=DINode::FlagZero, unsigned CC=0)
Create subroutine type.
LLVM_ABI DbgRecord * insertDbgValue(llvm::Value *Val, DILocalVariable *VarInfo, DIExpression *Expr, const DILocation *DL, InsertPosition InsertPt)
Insert a new dbg_value record.
LLVM_ABI DISubprogram * createFunction(DIScope *Scope, StringRef Name, StringRef LinkageName, DIFile *File, unsigned LineNo, DISubroutineType *Ty, unsigned ScopeLine, DINode::DIFlags Flags=DINode::FlagZero, DISubprogram::DISPFlags SPFlags=DISubprogram::SPFlagZero, DITemplateParameterArray TParams=nullptr, DISubprogram *Decl=nullptr, DITypeArray ThrownTypes=nullptr, DINodeArray Annotations=nullptr, StringRef TargetFuncName="", bool UseKeyInstructions=false)
Create a new descriptor for the specified subprogram.
LLVM_ABI DITypeArray getOrCreateTypeArray(ArrayRef< Metadata * > Elements)
Get a DITypeArray, create one if required.
LLVM_ABI DIBasicType * createBasicType(StringRef Name, uint64_t SizeInBits, unsigned Encoding, DINode::DIFlags Flags=DINode::FlagZero, uint32_t NumExtraInhabitants=0, uint32_t DataSizeInBits=0)
Create debugging information entry for a basic type.
LLVM_ABI DICompileUnit * createCompileUnit(DISourceLanguageName Lang, DIFile *File, StringRef Producer, bool isOptimized, StringRef Flags, unsigned RV, StringRef SplitName=StringRef(), DICompileUnit::DebugEmissionKind Kind=DICompileUnit::DebugEmissionKind::FullDebug, uint64_t DWOId=0, bool SplitDebugInlining=true, bool DebugInfoForProfiling=false, DICompileUnit::DebugNameTableKind NameTableKind=DICompileUnit::DebugNameTableKind::Default, bool RangesBaseAddress=false, StringRef SysRoot={}, StringRef SDK={})
A CompileUnit provides an anchor for all debugging information generated during this instance of comp...
LLVM_ABI DIExpression * createExpression(ArrayRef< uint64_t > Addr={})
Create a new descriptor for the specified variable which has a complex address expression for its add...
LLVM_ABI DILocalVariable * createAutoVariable(DIScope *Scope, StringRef Name, DIFile *File, unsigned LineNo, DIType *Ty, bool AlwaysPreserve=false, DINode::DIFlags Flags=DINode::FlagZero, uint32_t AlignInBits=0)
Create a new descriptor for an auto variable.
LLVM_ABI DIFile * createFile(StringRef Filename, StringRef Directory, std::optional< DIFile::ChecksumInfo< StringRef > > Checksum=std::nullopt, std::optional< StringRef > Source=std::nullopt)
Create a file descriptor to hold debugging information for a file.
Wrapper structure that holds source language identity metadata that includes language name,...
DISPFlags
Debug info subprogram flags.
Base class for types.
Record of a variable value-assignment, aka a non instruction representation of the dbg....
DILocation * get() const
Get the underlying DILocation.
Definition DebugLoc.h:220
static DebugLoc getUnknown()
Definition DebugLoc.h:153
LLVM_ABI void registerCallbacks(PassInstrumentationCallbacks &PIC, ModuleAnalysisManager &MAM)
FunctionPass class - This class is used to implement most global optimizations.
Definition Pass.h:314
const Function & getFunction() const
Definition Function.h:166
void eraseFromParent()
eraseFromParent - This method unlinks 'this' from the containing module and deletes it.
Definition Function.cpp:448
LLVM_ABI bool isDeclaration() const
Return true if the primary definition of this global value is outside of the current translation unit...
Definition Globals.cpp:408
const DebugLoc & getDebugLoc() const
Return the debug location for this node as a DebugLoc.
const char * getOpcodeName() const
This is an important class for using LLVM in a threaded context.
Definition LLVMContext.h:68
Metadata node.
Definition Metadata.h:1069
const MDOperand & getOperand(unsigned I) const
Definition Metadata.h:1426
static MDTuple * get(LLVMContext &Context, ArrayRef< Metadata * > MDs)
Definition Metadata.h:1567
iterator find(const KeyT &Key)
Definition MapVector.h:156
iterator end()
Definition MapVector.h:69
std::pair< iterator, bool > insert(const std::pair< KeyT, ValueT > &KV)
Definition MapVector.h:126
size_type size() const
Definition MapVector.h:58
size_type count(const KeyT &Key) const
Definition MapVector.h:152
ModulePass class - This class is used to implement unstructured interprocedural optimizations and ana...
Definition Pass.h:255
A Module instance is used to store all the information related to an LLVM module.
Definition Module.h:67
@ Warning
Emits a warning if two values disagree.
Definition Module.h:124
A tuple of MDNodes.
Definition Metadata.h:1755
LLVM_ABI void eraseFromParent()
Drop all references and remove the node from parent module.
LLVM_ABI MDNode * getOperand(unsigned i) const
LLVM_ABI unsigned getNumOperands() const
LLVM_ABI void clearOperands()
Drop all references to this node's operands.
iterator_range< op_iterator > operands()
Definition Metadata.h:1851
LLVM_ABI void addOperand(MDNode *M)
This class manages callbacks registration, as well as provides a way for PassInstrumentation to pass ...
Pass interface - Implemented by all 'passes'.
Definition Pass.h:99
A set of analyses that are preserved following a run of a transformation pass.
Definition Analysis.h:112
static PreservedAnalyses all()
Construct a special preserved set that preserves all passes.
Definition Analysis.h:118
PreservedAnalyses & preserveSet()
Mark an analysis set as preserved.
Definition Analysis.h:151
PreservedAnalyses & preserve()
Mark an analysis as preserved.
Definition Analysis.h:132
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Represent a constant reference to a string, i.e.
Definition StringRef.h:56
constexpr bool empty() const
Check if the string is empty.
Definition StringRef.h:141
The instances of the Type class are immutable: once they are created, they are never changed.
Definition Type.h:46
static LLVM_ABI IntegerType * getInt32Ty(LLVMContext &C)
Definition Type.cpp:309
bool isVoidTy() const
Return true if this is 'void'.
Definition Type.h:141
static ConstantAsMetadata * getConstant(Value *C)
Definition Metadata.h:481
LLVM Value Representation.
Definition Value.h:75
Type * getType() const
All values are typed, get the type of this value.
Definition Value.h:255
bool use_empty() const
Definition Value.h:346
static LLVM_ABI raw_ostream & warning()
Convenience method for printing "warning: " to stderr.
Definition WithColor.cpp:86
int getNumOccurrences() const
A range adaptor for a pair of iterators.
An Array is a JSON array, which contains heterogeneous JSON values.
Definition JSON.h:166
bool empty() const
Definition JSON.h:543
void push_back(const Value &E)
Definition JSON.h:548
An Object is a JSON object, which maps strings to heterogenous JSON values.
Definition JSON.h:98
std::pair< iterator, bool > insert(KV E)
Definition JSON.h:640
A Value is an JSON value of unknown type.
Definition JSON.h:291
A raw_ostream that writes to a file descriptor.
void close()
Manually flush the stream and close the file.
Expected< sys::fs::FileLocker > lock()
Locks the underlying file.
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition raw_ostream.h:53
A raw_ostream that writes to an std::string.
Changed
ValuesClass values(OptsTy... Options)
Helper to build a ValuesClass by forwarding a variable number of arguments as an initializer list to ...
initializer< Ty > init(const Ty &Val)
std::enable_if_t< detail::IsValidPointer< X, Y >::value, X * > extract(Y &&MD)
Extract a Value from Metadata.
Definition Metadata.h:668
@ OF_TextWithCRLF
The file should be opened in text mode and use a carriage linefeed '\r '.
Definition FileSystem.h:804
@ OF_Append
The file should be opened in append mode.
Definition FileSystem.h:807
This is an optimization pass for GlobalISel generic memory operations.
T any_cast(const Any &Value)
Definition Any.h:137
FormattedString right_justify(StringRef Str, unsigned Width)
right_justify - add spaces before string so total output is Width characters.
Definition Format.h:122
decltype(auto) dyn_cast(const From &Val)
dyn_cast<X> - Return the argument parameter cast to the specified type.
Definition Casting.h:643
iterator_range< T > make_range(T x, T y)
Convenience function for iterating over sub-ranges.
InnerAnalysisManagerProxy< FunctionAnalysisManager, Module > FunctionAnalysisManagerModuleProxy
Provide the FunctionAnalysisManager to Module proxy.
std::string utostr(uint64_t X, bool isNeg=false)
LLVM_ABI bool stripDebugifyMetadata(Module &M)
Strip out all of the metadata and debug info inserted by debugify.
Definition Debugify.cpp:352
LLVM_ABI void exportDebugifyStats(StringRef Path, const DebugifyStatsMap &Map)
LLVM_ABI bool applyDebugifyMetadata(Module &M, iterator_range< Module::iterator > Functions, StringRef Banner, std::function< bool(DIBuilder &, Function &)> ApplyToMF)
Add synthesized debug information to a module.
LLVM_ABI bool collectDebugInfoMetadata(Module &M, iterator_range< Module::iterator > Functions, DebugInfoPerPass &DebugInfoBeforePass, StringRef Banner, StringRef NameOfWrappedPass)
Collect original debug information before a pass.
Definition Debugify.cpp:412
auto formatv(bool Validate, const char *Fmt, Ts &&...Vals)
LLVM_ABI bool checkDebugInfoMetadata(Module &M, iterator_range< Module::iterator > Functions, DebugInfoPerPass &DebugInfoBeforePass, StringRef Banner, StringRef NameOfWrappedPass, StringRef OrigDIVerifyBugsReportFilePath)
Check original debug information after a pass.
Definition Debugify.cpp:619
LLVM_ABI raw_ostream & dbgs()
dbgs() - This returns a reference to a raw_ostream for debugging messages.
Definition Debug.cpp:209
LLVM_ABI bool isSpecialPass(StringRef PassID, const std::vector< StringRef > &Specials)
LLVM_ABI raw_ostream & nulls()
This returns a reference to a raw_ostream which simply discards output.
bool isa(const From &Val)
isa<X> - Return true if the parameter to the template is an instance of one of the template type argu...
Definition Casting.h:547
LLVM_ATTRIBUTE_VISIBILITY_DEFAULT AnalysisKey InnerAnalysisManagerProxy< AnalysisManagerT, IRUnitT, ExtraArgTs... >::Key
LLVM_ABI raw_fd_ostream & errs()
This returns a reference to a raw_ostream for standard error.
LLVM_ABI bool StripDebugInfo(Module &M)
Strip debug info in the module if it exists.
decltype(auto) cast(const From &Val)
cast<X> - Return the argument parameter cast to the specified type.
Definition Casting.h:559
bool is_contained(R &&Range, const E &Element)
Returns true if Element is found in Range.
Definition STLExtras.h:1947
bool to_integer(StringRef S, N &Num, unsigned Base=0)
Convert the string S to an integer of the specified type using the radix Base. If Base is 0,...
static auto filterDbgVars(iterator_range< simple_ilist< DbgRecord >::iterator > R)
Filter the DbgRecord range to DbgVariableRecord types only and downcast.
@ DEBUG_METADATA_VERSION
Definition Metadata.h:54
AnalysisManager< Module > ModuleAnalysisManager
Convenience typedef for the Module analysis manager.
Definition MIRParser.h:39
#define N
Used to track the Debug Info Metadata information.
Definition Debugify.h:37
DebugFnMap DIFunctions
Definition Debugify.h:39
DebugVarMap DIVariables
Definition Debugify.h:44
WeakInstValueMap InstToDelete
Definition Debugify.h:42
Track how much debugify information (in the synthetic mode only) has been lost.
Definition Debugify.h:132
RegisterPass<t> template - This template class is used to notify the system that a Pass is available ...
Definition PassSupport.h:89