19#include "llvm/Config/llvm-config.h"
33#if LLVM_ENABLE_DEBUGLOC_TRACKING_ORIGIN
41#define DEBUG_TYPE "debugify"
50 cl::desc(
"Suppress verbose debugify output"));
53 "debugify-func-limit",
54 cl::desc(
"Set max number of processed functions per pass."),
63 "debugify-level",
cl::desc(
"Kind of debug info to add"),
65 clEnumValN(Level::LocationsAndVariables,
"location+variables",
66 "Locations and Variables")),
67 cl::init(Level::LocationsAndVariables));
71#if LLVM_ENABLE_DEBUGLOC_TRACKING_ORIGIN
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"),
84 llvm::DebugLocOriginCollectionEnabled =
false;
87 if (EnableOriginStacktraces.
size() == 1 &&
88 EnableOriginStacktraces[0].
empty()) {
89 llvm::DebugLocOriginCollectionEnabled =
true;
92 llvm::DebugLocOriginCollectionEnabled =
95static void unsetDebugLocOriginCollection() {
96 llvm::DebugLocOriginCollectionEnabled =
false;
101static SymbolizedAddressMap SymbolizedAddrs;
102static AddressSet UnsymbolizedAddrs;
107 if (!UnsymbolizedAddrs.empty()) {
108 sys::symbolizeAddresses(UnsymbolizedAddrs, SymbolizedAddrs);
109 UnsymbolizedAddrs.clear();
111 const DbgLocOrigin::StackTracesTy &OriginStackTraces =
112 I->getDebugLoc().getOriginStackTraces();
115 for (
size_t TraceIdx = 0; TraceIdx < OriginStackTraces.size(); ++TraceIdx) {
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]]) {
125 std::log10(
Depth) + 2)
126 <<
' ' << SymbolizedFrame <<
'\n';
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);
146static void unsetDebugLocOriginCollection() {}
149 "enable-origin-stacktraces",
150 cl::desc(
"Collect DebugLoc origin stacktraces; requires "
151 "LLVM_ENABLE_DEBUGLOC_COVERAGE_TRACKING=COVERAGE_AND_ORIGIN"),
155 "without LLVM_ENABLE_DEBUGLOC_COVERAGE_TRACKING="
156 "COVERAGE_AND_ORIGIN\n";
163 return Ty->isSized() ? M.getDataLayout().getTypeAllocSizeInBits(Ty) : 0;
167 return F.isDeclaration() || !
F.hasExactDefinition();
187 if (M.getNamedMetadata(
"llvm.dbg.cu")) {
188 dbg() << Banner <<
"Skipping module with debug info\n";
198 auto getCachedDIType = [&](
Type *Ty) ->
DIType * {
208 unsigned NextLine = 1;
209 unsigned NextVar = 1;
212 "debugify",
true,
"", 0);
216 if (isFunctionSkipped(
F))
219 bool InsertedDbgVal =
false;
222 DISubprogram::SPFlagDefinition | DISubprogram::SPFlagOptimized;
223 if (
F.hasPrivateLinkage() ||
F.hasInternalLinkage())
224 SPFlags |= DISubprogram::SPFlagLocalToUnit;
226 SPType, NextLine, DINode::FlagZero, SPFlags,
227 nullptr,
nullptr,
nullptr,
nullptr,
"",
236 Value *V = &TemplateInst;
238 V = ConstantInt::get(Int32Ty, 0);
241 getCachedDIType(V->getType()),
249 uint64_t AtomGroup = ApplyAtomGroups ? NextLine : 0;
250 uint8_t AtomRank = ApplyAtomGroups ? 1 : 0;
253 AtomGroup, AtomRank));
256 if (DebugifyLevel < Level::LocationsAndVariables)
265 Instruction *LastInst = findTerminatingInstruction(BB);
266 assert(LastInst &&
"Expected basic block with a terminator");
271 assert(InsertPt != BB.end() &&
"Expected to find an insertion point");
274 InsertPt.setHeadBit(
false);
277 for (
Instruction *
I = &*BB.begin();
I != LastInst;
I =
I->getNextNode()) {
279 if (
I->getType()->isVoidTy())
285 InsertPt = std::next(
I->getIterator());
287 insertDbgVal(*
I, InsertPt);
288 InsertedDbgVal =
true;
296 if (DebugifyLevel == Level::LocationsAndVariables && !InsertedDbgVal) {
297 auto *
Term = findTerminatingInstruction(
F.getEntryBlock());
298 insertDbgVal(*Term,
Term->getIterator());
306 NamedMDNode *NMD = M.getOrInsertNamedMetadata(
"llvm.debugify");
307 auto addDebugifyOperand = [&](
unsigned N) {
311 addDebugifyOperand(NextLine - 1);
312 addDebugifyOperand(NextVar - 1);
314 "llvm.debugify should have exactly 2 operands!");
317 StringRef DIVersionKey =
"Debug Info Version";
318 if (!M.getModuleFlag(DIVersionKey))
327 setDebugLocOriginCollectionForPass(NameOfWrappedPass);
329 auto FuncIt =
F.getIterator();
332 "FunctionDebugify: ",
nullptr);
333 assert(DebugInfoBeforePass &&
"Missing debug info metadata");
335 "FunctionDebugify (original debuginfo)",
342 setDebugLocOriginCollectionForPass(NameOfWrappedPass);
345 "ModuleDebugify: ",
nullptr);
346 assert(DebugInfoBeforePass &&
"Missing debug info metadata");
348 "ModuleDebugify (original debuginfo)",
356 NamedMDNode *DebugifyMD = M.getNamedMetadata(
"llvm.debugify");
358 M.eraseNamedMetadata(DebugifyMD);
362 if (
auto *MIRDebugifyMD = M.getNamedMetadata(
"llvm.mir.debugify")) {
363 M.eraseNamedMetadata(MIRDebugifyMD);
375 "Not all debug info stripped?");
387 for (
MDNode *Flag : Flags) {
389 if (
Key->getString() ==
"Debug Info Version") {
404#if LLVM_ENABLE_DEBUGLOC_TRACKING_COVERAGE
405 DebugLocKind Kind =
I.getDebugLoc().getKind();
406 return Loc || Kind != DebugLocKind::Normal;
417 LLVM_DEBUG(
dbgs() << Banner <<
": (before) " << NameOfWrappedPass <<
'\n');
419 if (!M.getNamedMetadata(
"llvm.dbg.cu")) {
420 dbg() << Banner <<
": Skipping module without debug info\n";
431 if (isFunctionSkipped(
F))
435 if (++FunctionsCnt >= DebugifyFunctionsLimit)
438 auto *SP =
F.getSubprogram();
442 for (
const MDNode *DN : SP->getRetainedNodes()) {
448 if (DebugifyLevel > Level::Locations) {
459 if (DbgVar->getDebugLoc().getInlinedAt())
462 if (DbgVar->isKillLocation())
465 auto *Var = DbgVar->getVariable();
469 HandleDbgVariable(&DVR);
482 StringRef FileNameFromCU,
bool ShouldWriteIntoJSON,
484 bool Preserved =
true;
485 for (
const auto &
F : DIFunctionsAfter) {
488 auto SPIt = DIFunctionsBefore.
find(
F.first);
489 if (SPIt == DIFunctionsBefore.
end()) {
490 if (ShouldWriteIntoJSON)
492 {
"name",
F.first->getName()},
493 {
"action",
"not-generate"}}));
495 dbg() <<
"ERROR: " << NameOfWrappedPass
496 <<
" did not generate DISubprogram for " <<
F.first->getName()
497 <<
" from " << FileNameFromCU <<
'\n';
500 auto SP = SPIt->second;
505 if (ShouldWriteIntoJSON)
507 {
"name",
F.first->getName()},
508 {
"action",
"drop"}}));
510 dbg() <<
"ERROR: " << NameOfWrappedPass <<
" dropped DISubprogram of "
511 <<
F.first->getName() <<
" from " << FileNameFromCU <<
'\n';
522 bool ShouldWriteIntoJSON,
528 collectStackAddresses(
I);
529 auto FnName = Instr->getFunction()->getName();
530 auto BB = Instr->getParent();
531 auto BBName = BB->hasName() ? BB->getName() :
"no-name";
534 auto CreateJSONBugEntry = [&](
const char *Action) {
536 {
"metadata",
"DILocation"},
537 {
"fn-name", FnName.str()},
538 {
"bb-name", BBName.str()},
542#if LLVM_ENABLE_DEBUGLOC_TRACKING_ORIGIN
543 if (!Instr->getDebugLoc().getOriginStackTraces().empty())
544 BugEntry.
insert({
"origin", symbolizeStackTrace(Instr)});
549 if (ShouldWriteIntoJSON)
550 CreateJSONBugEntry(
"not-generate");
552 dbg() <<
"WARNING: " << NameOfWrappedPass
553 <<
" did not generate DILocation for " << *Instr <<
" (BB: " << BBName
554 <<
", Fn: " << FnName <<
", File: " << FileNameFromCU <<
")\n";
563 bool Preserved =
true;
564 for (
const auto &V : DIVarsBefore) {
565 auto VarIt = DIVarsAfter.
find(V.first);
566 if (VarIt == DIVarsAfter.
end())
569 unsigned NumOfDbgValsAfter = VarIt->second;
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"}}));
579 dbg() <<
"WARNING: " << NameOfWrappedPass
580 <<
" drops dbg.value()/dbg.declare() for " << V.first->getName()
582 <<
"function " << V.first->getScope()->getSubprogram()->getName()
583 <<
" (file " << FileNameFromCU <<
")\n";
599 errs() <<
"Could not open file: " << EC.message() <<
", "
600 << OrigDIVerifyBugsReportFilePath <<
'\n';
604 if (
auto L = OS_FILE.
lock()) {
605 OS_FILE <<
"{\"file\":\"" << FileNameFromCU <<
"\", ";
608 NameOfWrappedPass !=
"" ? NameOfWrappedPass :
"no-name";
609 OS_FILE <<
"\"pass\":\"" <<
PassName <<
"\", ";
612 OS_FILE <<
"\"bugs\": " << BugsToPrint;
623 StringRef OrigDIVerifyBugsReportFilePath) {
624 LLVM_DEBUG(
dbgs() << Banner <<
": (after) " << NameOfWrappedPass <<
'\n');
625 unsetDebugLocOriginCollection();
627 if (!M.getNamedMetadata(
"llvm.dbg.cu")) {
628 dbg() << Banner <<
": Skipping module without debug info\n";
635 bool ShouldWriteIntoJSON = !OrigDIVerifyBugsReportFilePath.
empty();
643 bool ResultForInsts =
true;
647 if (isFunctionSkipped(
F))
655 auto *SP =
F.getSubprogram();
660 for (
const MDNode *DN : SP->getRetainedNodes()) {
675 if (DebugifyLevel > Level::Locations) {
680 if (DbgVar->getDebugLoc().getInlinedAt())
683 if (DbgVar->isKillLocation())
686 auto *Var = DbgVar->getVariable();
690 HandleDbgVariable(&DVR);
697 I, NameOfWrappedPass, FileNameFromCU, ShouldWriteIntoJSON, Bugs);
700 ResultForInsts &= InstResult;
705 auto DIFunctionsBefore = DebugInfoBeforePass.
DIFunctions;
706 auto DIFunctionsAfter = DebugInfoAfterPass.
DIFunctions;
710 auto DIVarsBefore = DebugInfoBeforePass.
DIVariables;
714 checkFunctions(DIFunctionsBefore, DIFunctionsAfter, NameOfWrappedPass,
715 FileNameFromCU, ShouldWriteIntoJSON, Bugs);
717 bool ResultForVars =
checkVars(DIVarsBefore, DIVarsAfter, NameOfWrappedPass,
718 FileNameFromCU, ShouldWriteIntoJSON, Bugs);
720 bool Result = ResultForFunc && ResultForInsts && ResultForVars;
722 StringRef ResultBanner = NameOfWrappedPass !=
"" ? NameOfWrappedPass : Banner;
723 if (ShouldWriteIntoJSON && !Bugs.
empty())
724 writeJSON(OrigDIVerifyBugsReportFilePath, FileNameFromCU, NameOfWrappedPass,
728 dbg() << ResultBanner <<
": PASS\n";
730 dbg() << ResultBanner <<
": FAIL\n";
735 DebugInfoBeforePass = DebugInfoAfterPass;
743template <
typename DbgValTy>
744bool diagnoseMisSizedDbgValue(
Module &M, DbgValTy *DbgVal) {
753 if (DbgVal->getExpression()->getNumElements())
756 Value *V = DbgVal->getVariableLocationOp(0);
760 Type *Ty = V->getType();
761 uint64_t ValueOperandSize = getAllocSizeInBits(M, Ty);
762 std::optional<uint64_t> DbgVarSize = DbgVal->getFragmentSizeInBits();
763 if (!ValueOperandSize || !DbgVarSize)
766 bool HasBadSize =
false;
767 if (Ty->isIntegerTy()) {
768 auto Signedness = DbgVal->getVariable()->getSignedness();
770 HasBadSize = ValueOperandSize < *DbgVarSize;
772 HasBadSize = ValueOperandSize != *DbgVarSize;
776 dbg() <<
"ERROR: dbg.value operand has size " << ValueOperandSize
777 <<
", but its variable has size " << *DbgVarSize <<
": ";
778 DbgVal->print(dbg());
784bool checkDebugifyMetadata(
Module &M,
789 NamedMDNode *NMD = M.getNamedMetadata(
"llvm.debugify");
790 unsetDebugLocOriginCollection();
792 dbg() << Banner <<
": Skipping module without debugify metadata\n";
796 auto getDebugifyOperand = [&](
unsigned Idx) ->
unsigned {
801 "llvm.debugify should have exactly 2 operands!");
802 unsigned OriginalNumLines = getDebugifyOperand(0);
803 unsigned OriginalNumVars = getDebugifyOperand(1);
804 bool HasErrors =
false;
808 if (StatsMap && !NameOfWrappedPass.
empty())
809 Stats = &StatsMap->operator[](NameOfWrappedPass);
811 BitVector MissingLines{OriginalNumLines,
true};
812 BitVector MissingVars{OriginalNumVars,
true};
814 if (isFunctionSkipped(
F))
819 auto DL =
I.getDebugLoc();
820 if (
DL &&
DL.getLine() != 0) {
821 MissingLines.
reset(
DL.getLine() - 1);
826 dbg() <<
"WARNING: Instruction with empty DebugLoc in function ";
827 dbg() <<
F.getName() <<
" --";
834 auto CheckForMisSized = [&](
auto *DbgVal) {
836 (void)
to_integer(DbgVal->getVariable()->getName(), Var, 10);
837 assert(Var <= OriginalNumVars &&
"Unexpected name for DILocalVariable");
838 bool HasBadSize = diagnoseMisSizedDbgValue(M, DbgVal);
840 MissingVars.
reset(Var - 1);
841 HasErrors |= HasBadSize;
845 if (DVR.isDbgValue() || DVR.isDbgAssign())
846 CheckForMisSized(&DVR);
851 for (
unsigned Idx : MissingLines.
set_bits())
852 dbg() <<
"WARNING: Missing line " << Idx + 1 <<
"\n";
854 for (
unsigned Idx : MissingVars.
set_bits())
855 dbg() <<
"WARNING: Missing variable " << Idx + 1 <<
"\n";
859 Stats->NumDbgLocsExpected += OriginalNumLines;
860 Stats->NumDbgLocsMissing += MissingLines.
count();
861 Stats->NumDbgValuesExpected += OriginalNumVars;
862 Stats->NumDbgValuesMissing += MissingVars.
count();
866 if (!NameOfWrappedPass.
empty())
867 dbg() <<
" [" << NameOfWrappedPass <<
"]";
868 dbg() <<
": " << (HasErrors ?
"FAIL" :
"PASS") <<
'\n';
880struct DebugifyModulePass :
public ModulePass {
881 bool runOnModule(
Module &M)
override {
883 applyDebugify(M, Mode, DebugInfoBeforePass, NameOfWrappedPass);
888 StringRef NameOfWrappedPass =
"",
889 DebugInfoPerPass *DebugInfoBeforePass =
nullptr)
890 : ModulePass(ID), NameOfWrappedPass(NameOfWrappedPass),
891 DebugInfoBeforePass(DebugInfoBeforePass), Mode(Mode) {}
893 void getAnalysisUsage(AnalysisUsage &AU)
const override {
900 StringRef NameOfWrappedPass;
901 DebugInfoPerPass *DebugInfoBeforePass;
914 DebugifyFunctionPass(
916 StringRef NameOfWrappedPass =
"",
917 DebugInfoPerPass *DebugInfoBeforePass =
nullptr)
918 : FunctionPass(ID), NameOfWrappedPass(NameOfWrappedPass),
919 DebugInfoBeforePass(DebugInfoBeforePass), Mode(Mode) {}
921 void getAnalysisUsage(AnalysisUsage &AU)
const override {
928 StringRef NameOfWrappedPass;
929 DebugInfoPerPass *DebugInfoBeforePass;
935struct CheckDebugifyModulePass :
public ModulePass {
936 bool runOnModule(
Module &M)
override {
939 Result = checkDebugifyMetadata(M,
M.functions(), NameOfWrappedPass,
940 "CheckModuleDebugify", Strip, StatsMap);
943 M,
M.functions(), *DebugInfoBeforePass,
944 "CheckModuleDebugify (original debuginfo)", NameOfWrappedPass,
945 OrigDIVerifyBugsReportFilePath);
950 CheckDebugifyModulePass(
951 bool Strip =
false, StringRef NameOfWrappedPass =
"",
954 DebugInfoPerPass *DebugInfoBeforePass =
nullptr,
955 StringRef OrigDIVerifyBugsReportFilePath =
"")
956 : ModulePass(ID), NameOfWrappedPass(NameOfWrappedPass),
957 OrigDIVerifyBugsReportFilePath(OrigDIVerifyBugsReportFilePath),
958 StatsMap(StatsMap), DebugInfoBeforePass(DebugInfoBeforePass), Mode(Mode),
961 void getAnalysisUsage(AnalysisUsage &AU)
const override {
968 StringRef NameOfWrappedPass;
969 StringRef OrigDIVerifyBugsReportFilePath;
971 DebugInfoPerPass *DebugInfoBeforePass;
981 auto FuncIt =
F.getIterator();
985 NameOfWrappedPass,
"CheckFunctionDebugify",
989 M,
make_range(FuncIt, std::next(FuncIt)), *DebugInfoBeforePass,
990 "CheckFunctionDebugify (original debuginfo)", NameOfWrappedPass,
991 OrigDIVerifyBugsReportFilePath);
996 CheckDebugifyFunctionPass(
997 bool Strip =
false, StringRef NameOfWrappedPass =
"",
1000 DebugInfoPerPass *DebugInfoBeforePass =
nullptr,
1001 StringRef OrigDIVerifyBugsReportFilePath =
"")
1002 : FunctionPass(ID), NameOfWrappedPass(NameOfWrappedPass),
1003 OrigDIVerifyBugsReportFilePath(OrigDIVerifyBugsReportFilePath),
1004 StatsMap(StatsMap), DebugInfoBeforePass(DebugInfoBeforePass), Mode(Mode),
1007 void getAnalysisUsage(AnalysisUsage &AU)
const override {
1014 StringRef NameOfWrappedPass;
1015 StringRef OrigDIVerifyBugsReportFilePath;
1017 DebugInfoPerPass *DebugInfoBeforePass;
1028 errs() <<
"Could not open file: " << EC.message() <<
", " << Path <<
'\n';
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) {
1039 OS <<
Pass <<
',' <<
Stats.NumDbgValuesMissing <<
','
1040 <<
Stats.NumDbgLocsMissing <<
',' <<
Stats.getMissingValueRatio() <<
','
1041 <<
Stats.getEmptyLocationRatio() <<
'\n';
1049 return new DebugifyModulePass();
1051 return new DebugifyModulePass(
Mode, NameOfWrappedPass, DebugInfoBeforePass);
1059 return new DebugifyFunctionPass();
1061 return new DebugifyFunctionPass(
Mode, NameOfWrappedPass, DebugInfoBeforePass);
1068 return ApplyToMF(DIB,
F, AM);
1071 "ModuleDebugify: ", ApplyToMFWrapper);
1077 "ModuleDebugify (original debuginfo)",
1091 StringRef OrigDIVerifyBugsReportFilePath) {
1093 return new CheckDebugifyModulePass(Strip, NameOfWrappedPass, StatsMap);
1095 return new CheckDebugifyModulePass(
false, NameOfWrappedPass,
nullptr,
Mode,
1096 DebugInfoBeforePass,
1097 OrigDIVerifyBugsReportFilePath);
1103 StringRef OrigDIVerifyBugsReportFilePath) {
1105 return new CheckDebugifyFunctionPass(Strip, NameOfWrappedPass, StatsMap);
1107 return new CheckDebugifyFunctionPass(
false, NameOfWrappedPass,
nullptr,
Mode,
1108 DebugInfoBeforePass,
1109 OrigDIVerifyBugsReportFilePath);
1115 checkDebugifyMetadata(M, M.functions(), NameOfWrappedPass,
1116 "CheckModuleDebugify", Strip, StatsMap);
1119 M, M.functions(), *DebugInfoBeforePass,
1120 "CheckModuleDebugify (original debuginfo)", NameOfWrappedPass,
1121 OrigDIVerifyBugsReportFilePath);
1128 "AnalysisManagerProxy",
"PrintFunctionPass",
1129 "PrintModulePass",
"BitcodeWriterPass",
1130 "ThinLTOBitcodeWriterPass",
"VerifierPass"});
1149 MAM.invalidate(M, PA);
1152 PIC.registerAfterPassCallback(
1161 auto It =
F.getIterator();
1163 checkDebugifyMetadata(M,
make_range(It, std::next(It)),
P,
1164 "CheckFunctionDebugify",
true,
1168 *DebugInfoBeforePass,
1169 "CheckModuleDebugify (original debuginfo)",
1170 P, OrigDIVerifyBugsReportFilePath);
1177 checkDebugifyMetadata(M, M.functions(),
P,
"CheckModuleDebugify",
1181 "CheckModuleDebugify (original debuginfo)",
1182 P, OrigDIVerifyBugsReportFilePath);
1183 MAM.invalidate(M, PA);
1188char DebugifyModulePass::ID = 0;
1190 "Attach debug info to everything");
1192char CheckDebugifyModulePass::ID = 0;
1194 CDM(
"check-debugify",
"Check debug info from -debugify");
1196char DebugifyFunctionPass::ID = 0;
1198 "Attach debug info to a function");
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)
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="")
static bool checkInstructionCoverage(Instruction &I, StringRef NameOfWrappedPass, StringRef FileNameFromCU, bool ShouldWriteIntoJSON, llvm::json::Array &Bugs)
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)
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)
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)
DebugifyMode
Used to check whether we track synthetic or original debug info.
llvm::MapVector< const llvm::Function *, const llvm::DISubprogram * > DebugFnMap
llvm::MapVector< llvm::StringRef, DebugifyStatistics > DebugifyStatsMap
Map pass names to a per-pass DebugifyStatistics instance.
llvm::MapVector< const llvm::DILocalVariable *, unsigned > DebugVarMap
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
block placement Basic Block Placement Stats
Machine Check Debug Module
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")))
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.
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...
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.
BitVector & reset()
Reset all bits in the bitvector.
size_type count() const
Returns the number of bits which are set.
iterator_range< const_set_bits_iterator > set_bits() const
Represents analyses that only rely on functions' control flow.
LLVM_ABI void finalize()
Construct any deferred debug info descriptors.
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.
Record of a variable value-assignment, aka a non instruction representation of the dbg....
DILocation * get() const
Get the underlying DILocation.
static DebugLoc getUnknown()
LLVM_ABI void registerCallbacks(PassInstrumentationCallbacks &PIC, ModuleAnalysisManager &MAM)
FunctionPass class - This class is used to implement most global optimizations.
const Function & getFunction() const
void eraseFromParent()
eraseFromParent - This method unlinks 'this' from the containing module and deletes it.
LLVM_ABI bool isDeclaration() const
Return true if the primary definition of this global value is outside of the current translation unit...
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.
const MDOperand & getOperand(unsigned I) const
static MDTuple * get(LLVMContext &Context, ArrayRef< Metadata * > MDs)
iterator find(const KeyT &Key)
std::pair< iterator, bool > insert(const std::pair< KeyT, ValueT > &KV)
size_type count(const KeyT &Key) const
ModulePass class - This class is used to implement unstructured interprocedural optimizations and ana...
A Module instance is used to store all the information related to an LLVM module.
@ Warning
Emits a warning if two values disagree.
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()
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'.
A set of analyses that are preserved following a run of a transformation pass.
static PreservedAnalyses all()
Construct a special preserved set that preserves all passes.
PreservedAnalyses & preserveSet()
Mark an analysis set as preserved.
PreservedAnalyses & preserve()
Mark an analysis as preserved.
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.
constexpr bool empty() const
Check if the string is empty.
The instances of the Type class are immutable: once they are created, they are never changed.
static LLVM_ABI IntegerType * getInt32Ty(LLVMContext &C)
bool isVoidTy() const
Return true if this is 'void'.
LLVM Value Representation.
Type * getType() const
All values are typed, get the type of this value.
static LLVM_ABI raw_ostream & warning()
Convenience method for printing "warning: " to stderr.
int getNumOccurrences() const
A range adaptor for a pair of iterators.
An Array is a JSON array, which contains heterogeneous JSON values.
void push_back(const Value &E)
An Object is a JSON object, which maps strings to heterogenous JSON values.
std::pair< iterator, bool > insert(KV E)
A Value is an JSON value of unknown type.
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.
A raw_ostream that writes to an std::string.
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.
@ OF_TextWithCRLF
The file should be opened in text mode and use a carriage linefeed '\r '.
@ OF_Append
The file should be opened in append mode.
This is an optimization pass for GlobalISel generic memory operations.
T any_cast(const Any &Value)
FormattedString right_justify(StringRef Str, unsigned Width)
right_justify - add spaces before string so total output is Width characters.
decltype(auto) dyn_cast(const From &Val)
dyn_cast<X> - Return the argument parameter cast to the specified type.
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.
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.
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.
LLVM_ABI raw_ostream & dbgs()
dbgs() - This returns a reference to a raw_ostream for debugging messages.
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...
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.
bool is_contained(R &&Range, const E &Element)
Returns true if Element is found in Range.
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.
AnalysisManager< Module > ModuleAnalysisManager
Convenience typedef for the Module analysis manager.
Used to track the Debug Info Metadata information.
WeakInstValueMap InstToDelete
Track how much debugify information (in the synthetic mode only) has been lost.
RegisterPass<t> template - This template class is used to notify the system that a Pass is available ...