• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 //===-- llvm/CodeGen/AsmPrinter/DbgValueHistoryCalculator.cpp -------------===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "DbgValueHistoryCalculator.h"
11 #include "llvm/ADT/BitVector.h"
12 #include "llvm/ADT/SmallVector.h"
13 #include "llvm/CodeGen/MachineBasicBlock.h"
14 #include "llvm/CodeGen/MachineFunction.h"
15 #include "llvm/IR/DebugInfo.h"
16 #include "llvm/Support/Debug.h"
17 #include "llvm/Support/raw_ostream.h"
18 #include "llvm/Target/TargetLowering.h"
19 #include "llvm/Target/TargetRegisterInfo.h"
20 #include "llvm/Target/TargetSubtargetInfo.h"
21 #include <algorithm>
22 #include <map>
23 using namespace llvm;
24 
25 #define DEBUG_TYPE "dwarfdebug"
26 
27 // \brief If @MI is a DBG_VALUE with debug value described by a
28 // defined register, returns the number of this register.
29 // In the other case, returns 0.
isDescribedByReg(const MachineInstr & MI)30 static unsigned isDescribedByReg(const MachineInstr &MI) {
31   assert(MI.isDebugValue());
32   assert(MI.getNumOperands() == 4);
33   // If location of variable is described using a register (directly or
34   // indirecltly), this register is always a first operand.
35   return MI.getOperand(0).isReg() ? MI.getOperand(0).getReg() : 0;
36 }
37 
startInstrRange(InlinedVariable Var,const MachineInstr & MI)38 void DbgValueHistoryMap::startInstrRange(InlinedVariable Var,
39                                          const MachineInstr &MI) {
40   // Instruction range should start with a DBG_VALUE instruction for the
41   // variable.
42   assert(MI.isDebugValue() && "not a DBG_VALUE");
43   auto &Ranges = VarInstrRanges[Var];
44   if (!Ranges.empty() && Ranges.back().second == nullptr &&
45       Ranges.back().first->isIdenticalTo(MI)) {
46     DEBUG(dbgs() << "Coalescing identical DBG_VALUE entries:\n"
47                  << "\t" << Ranges.back().first << "\t" << MI << "\n");
48     return;
49   }
50   Ranges.push_back(std::make_pair(&MI, nullptr));
51 }
52 
endInstrRange(InlinedVariable Var,const MachineInstr & MI)53 void DbgValueHistoryMap::endInstrRange(InlinedVariable Var,
54                                        const MachineInstr &MI) {
55   auto &Ranges = VarInstrRanges[Var];
56   // Verify that the current instruction range is not yet closed.
57   assert(!Ranges.empty() && Ranges.back().second == nullptr);
58   // For now, instruction ranges are not allowed to cross basic block
59   // boundaries.
60   assert(Ranges.back().first->getParent() == MI.getParent());
61   Ranges.back().second = &MI;
62 }
63 
getRegisterForVar(InlinedVariable Var) const64 unsigned DbgValueHistoryMap::getRegisterForVar(InlinedVariable Var) const {
65   const auto &I = VarInstrRanges.find(Var);
66   if (I == VarInstrRanges.end())
67     return 0;
68   const auto &Ranges = I->second;
69   if (Ranges.empty() || Ranges.back().second != nullptr)
70     return 0;
71   return isDescribedByReg(*Ranges.back().first);
72 }
73 
74 namespace {
75 // Maps physreg numbers to the variables they describe.
76 typedef DbgValueHistoryMap::InlinedVariable InlinedVariable;
77 typedef std::map<unsigned, SmallVector<InlinedVariable, 1>> RegDescribedVarsMap;
78 }
79 
80 // \brief Claim that @Var is not described by @RegNo anymore.
dropRegDescribedVar(RegDescribedVarsMap & RegVars,unsigned RegNo,InlinedVariable Var)81 static void dropRegDescribedVar(RegDescribedVarsMap &RegVars, unsigned RegNo,
82                                 InlinedVariable Var) {
83   const auto &I = RegVars.find(RegNo);
84   assert(RegNo != 0U && I != RegVars.end());
85   auto &VarSet = I->second;
86   const auto &VarPos = std::find(VarSet.begin(), VarSet.end(), Var);
87   assert(VarPos != VarSet.end());
88   VarSet.erase(VarPos);
89   // Don't keep empty sets in a map to keep it as small as possible.
90   if (VarSet.empty())
91     RegVars.erase(I);
92 }
93 
94 // \brief Claim that @Var is now described by @RegNo.
addRegDescribedVar(RegDescribedVarsMap & RegVars,unsigned RegNo,InlinedVariable Var)95 static void addRegDescribedVar(RegDescribedVarsMap &RegVars, unsigned RegNo,
96                                InlinedVariable Var) {
97   assert(RegNo != 0U);
98   auto &VarSet = RegVars[RegNo];
99   assert(std::find(VarSet.begin(), VarSet.end(), Var) == VarSet.end());
100   VarSet.push_back(Var);
101 }
102 
103 // \brief Terminate the location range for variables described by register at
104 // @I by inserting @ClobberingInstr to their history.
clobberRegisterUses(RegDescribedVarsMap & RegVars,RegDescribedVarsMap::iterator I,DbgValueHistoryMap & HistMap,const MachineInstr & ClobberingInstr)105 static void clobberRegisterUses(RegDescribedVarsMap &RegVars,
106                                 RegDescribedVarsMap::iterator I,
107                                 DbgValueHistoryMap &HistMap,
108                                 const MachineInstr &ClobberingInstr) {
109   // Iterate over all variables described by this register and add this
110   // instruction to their history, clobbering it.
111   for (const auto &Var : I->second)
112     HistMap.endInstrRange(Var, ClobberingInstr);
113   RegVars.erase(I);
114 }
115 
116 // \brief Terminate the location range for variables described by register
117 // @RegNo by inserting @ClobberingInstr to their history.
clobberRegisterUses(RegDescribedVarsMap & RegVars,unsigned RegNo,DbgValueHistoryMap & HistMap,const MachineInstr & ClobberingInstr)118 static void clobberRegisterUses(RegDescribedVarsMap &RegVars, unsigned RegNo,
119                                 DbgValueHistoryMap &HistMap,
120                                 const MachineInstr &ClobberingInstr) {
121   const auto &I = RegVars.find(RegNo);
122   if (I == RegVars.end())
123     return;
124   clobberRegisterUses(RegVars, I, HistMap, ClobberingInstr);
125 }
126 
127 // \brief Returns the first instruction in @MBB which corresponds to
128 // the function epilogue, or nullptr if @MBB doesn't contain an epilogue.
getFirstEpilogueInst(const MachineBasicBlock & MBB)129 static const MachineInstr *getFirstEpilogueInst(const MachineBasicBlock &MBB) {
130   auto LastMI = MBB.getLastNonDebugInstr();
131   if (LastMI == MBB.end() || !LastMI->isReturn())
132     return nullptr;
133   // Assume that epilogue starts with instruction having the same debug location
134   // as the return instruction.
135   DebugLoc LastLoc = LastMI->getDebugLoc();
136   auto Res = LastMI;
137   for (MachineBasicBlock::const_reverse_iterator I(std::next(LastMI)),
138        E = MBB.rend();
139        I != E; ++I) {
140     if (I->getDebugLoc() != LastLoc)
141       return &*Res;
142     Res = &*I;
143   }
144   // If all instructions have the same debug location, assume whole MBB is
145   // an epilogue.
146   return &*MBB.begin();
147 }
148 
149 // \brief Collect registers that are modified in the function body (their
150 // contents is changed outside of the prologue and epilogue).
collectChangingRegs(const MachineFunction * MF,const TargetRegisterInfo * TRI,BitVector & Regs)151 static void collectChangingRegs(const MachineFunction *MF,
152                                 const TargetRegisterInfo *TRI,
153                                 BitVector &Regs) {
154   for (const auto &MBB : *MF) {
155     auto FirstEpilogueInst = getFirstEpilogueInst(MBB);
156 
157     for (const auto &MI : MBB) {
158       // Avoid looking at prologue or epilogue instructions.
159       if (&MI == FirstEpilogueInst)
160         break;
161       if (MI.getFlag(MachineInstr::FrameSetup))
162         continue;
163 
164       // Look for register defs and register masks. Register masks are
165       // typically on calls and they clobber everything not in the mask.
166       for (const MachineOperand &MO : MI.operands()) {
167         if (MO.isReg() && MO.isDef() && MO.getReg()) {
168           for (MCRegAliasIterator AI(MO.getReg(), TRI, true); AI.isValid();
169                ++AI)
170             Regs.set(*AI);
171         } else if (MO.isRegMask()) {
172           Regs.setBitsNotInMask(MO.getRegMask());
173         }
174       }
175     }
176   }
177 }
178 
calculateDbgValueHistory(const MachineFunction * MF,const TargetRegisterInfo * TRI,DbgValueHistoryMap & Result)179 void llvm::calculateDbgValueHistory(const MachineFunction *MF,
180                                     const TargetRegisterInfo *TRI,
181                                     DbgValueHistoryMap &Result) {
182   BitVector ChangingRegs(TRI->getNumRegs());
183   collectChangingRegs(MF, TRI, ChangingRegs);
184 
185   const TargetLowering *TLI = MF->getSubtarget().getTargetLowering();
186   unsigned SP = TLI->getStackPointerRegisterToSaveRestore();
187   RegDescribedVarsMap RegVars;
188   for (const auto &MBB : *MF) {
189     for (const auto &MI : MBB) {
190       if (!MI.isDebugValue()) {
191         // Not a DBG_VALUE instruction. It may clobber registers which describe
192         // some variables.
193         for (const MachineOperand &MO : MI.operands()) {
194           if (MO.isReg() && MO.isDef() && MO.getReg()) {
195             // If this is a register def operand, it may end a debug value
196             // range.
197             for (MCRegAliasIterator AI(MO.getReg(), TRI, true); AI.isValid();
198                  ++AI)
199               if (ChangingRegs.test(*AI))
200                 clobberRegisterUses(RegVars, *AI, Result, MI);
201           } else if (MO.isRegMask()) {
202             // If this is a register mask operand, clobber all debug values in
203             // non-CSRs.
204             for (int I = ChangingRegs.find_first(); I != -1;
205                  I = ChangingRegs.find_next(I)) {
206               // Don't consider SP to be clobbered by register masks.
207               if (unsigned(I) != SP && TRI->isPhysicalRegister(I) &&
208                   MO.clobbersPhysReg(I)) {
209                 clobberRegisterUses(RegVars, I, Result, MI);
210               }
211             }
212           }
213         }
214         continue;
215       }
216 
217       assert(MI.getNumOperands() > 1 && "Invalid DBG_VALUE instruction!");
218       // Use the base variable (without any DW_OP_piece expressions)
219       // as index into History. The full variables including the
220       // piece expressions are attached to the MI.
221       const DILocalVariable *RawVar = MI.getDebugVariable();
222       assert(RawVar->isValidLocationForIntrinsic(MI.getDebugLoc()) &&
223              "Expected inlined-at fields to agree");
224       InlinedVariable Var(RawVar, MI.getDebugLoc()->getInlinedAt());
225 
226       if (unsigned PrevReg = Result.getRegisterForVar(Var))
227         dropRegDescribedVar(RegVars, PrevReg, Var);
228 
229       Result.startInstrRange(Var, MI);
230 
231       if (unsigned NewReg = isDescribedByReg(MI))
232         addRegDescribedVar(RegVars, NewReg, Var);
233     }
234 
235     // Make sure locations for register-described variables are valid only
236     // until the end of the basic block (unless it's the last basic block, in
237     // which case let their liveness run off to the end of the function).
238     if (!MBB.empty() && &MBB != &MF->back()) {
239       for (auto I = RegVars.begin(), E = RegVars.end(); I != E;) {
240         auto CurElem = I++; // CurElem can be erased below.
241         if (ChangingRegs.test(CurElem->first))
242           clobberRegisterUses(RegVars, CurElem, Result, MBB.back());
243       }
244     }
245   }
246 }
247