Home | History | Annotate | Download | only in CodeGen
      1 //===---- LiveRangeCalc.cpp - Calculate live ranges -----------------------===//
      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 // Implementation of the LiveRangeCalc class.
     11 //
     12 //===----------------------------------------------------------------------===//
     13 
     14 #define DEBUG_TYPE "regalloc"
     15 #include "LiveRangeCalc.h"
     16 #include "llvm/CodeGen/MachineDominators.h"
     17 #include "llvm/CodeGen/MachineRegisterInfo.h"
     18 
     19 using namespace llvm;
     20 
     21 void LiveRangeCalc::reset(const MachineFunction *mf,
     22                           SlotIndexes *SI,
     23                           MachineDominatorTree *MDT,
     24                           VNInfo::Allocator *VNIA) {
     25   MF = mf;
     26   MRI = &MF->getRegInfo();
     27   Indexes = SI;
     28   DomTree = MDT;
     29   Alloc = VNIA;
     30 
     31   unsigned N = MF->getNumBlockIDs();
     32   Seen.clear();
     33   Seen.resize(N);
     34   LiveOut.resize(N);
     35   LiveIn.clear();
     36 }
     37 
     38 
     39 void LiveRangeCalc::createDeadDefs(LiveInterval *LI, unsigned Reg) {
     40   assert(MRI && Indexes && "call reset() first");
     41 
     42   // Visit all def operands. If the same instruction has multiple defs of Reg,
     43   // LI->createDeadDef() will deduplicate.
     44   for (MachineRegisterInfo::def_iterator
     45        I = MRI->def_begin(Reg), E = MRI->def_end(); I != E; ++I) {
     46     const MachineInstr *MI = &*I;
     47     // Find the corresponding slot index.
     48     SlotIndex Idx;
     49     if (MI->isPHI())
     50       // PHI defs begin at the basic block start index.
     51       Idx = Indexes->getMBBStartIdx(MI->getParent());
     52     else
     53       // Instructions are either normal 'r', or early clobber 'e'.
     54       Idx = Indexes->getInstructionIndex(MI)
     55         .getRegSlot(I.getOperand().isEarlyClobber());
     56 
     57     // Create the def in LI. This may find an existing def.
     58     LI->createDeadDef(Idx, *Alloc);
     59   }
     60 }
     61 
     62 
     63 void LiveRangeCalc::extendToUses(LiveInterval *LI, unsigned Reg) {
     64   assert(MRI && Indexes && "call reset() first");
     65 
     66   // Visit all operands that read Reg. This may include partial defs.
     67   for (MachineRegisterInfo::reg_nodbg_iterator I = MRI->reg_nodbg_begin(Reg),
     68        E = MRI->reg_nodbg_end(); I != E; ++I) {
     69     MachineOperand &MO = I.getOperand();
     70     // Clear all kill flags. They will be reinserted after register allocation
     71     // by LiveIntervalAnalysis::addKillFlags().
     72     if (MO.isUse())
     73       MO.setIsKill(false);
     74     if (!MO.readsReg())
     75       continue;
     76     // MI is reading Reg. We may have visited MI before if it happens to be
     77     // reading Reg multiple times. That is OK, extend() is idempotent.
     78     const MachineInstr *MI = &*I;
     79 
     80     // Find the SlotIndex being read.
     81     SlotIndex Idx;
     82     if (MI->isPHI()) {
     83       assert(!MO.isDef() && "Cannot handle PHI def of partial register.");
     84       // PHI operands are paired: (Reg, PredMBB).
     85       // Extend the live range to be live-out from PredMBB.
     86       Idx = Indexes->getMBBEndIdx(MI->getOperand(I.getOperandNo()+1).getMBB());
     87     } else {
     88       // This is a normal instruction.
     89       Idx = Indexes->getInstructionIndex(MI).getRegSlot();
     90       // Check for early-clobber redefs.
     91       unsigned DefIdx;
     92       if (MO.isDef()) {
     93         if (MO.isEarlyClobber())
     94           Idx = Idx.getRegSlot(true);
     95       } else if (MI->isRegTiedToDefOperand(I.getOperandNo(), &DefIdx)) {
     96         // FIXME: This would be a lot easier if tied early-clobber uses also
     97         // had an early-clobber flag.
     98         if (MI->getOperand(DefIdx).isEarlyClobber())
     99           Idx = Idx.getRegSlot(true);
    100       }
    101     }
    102     extend(LI, Idx, Reg);
    103   }
    104 }
    105 
    106 
    107 // Transfer information from the LiveIn vector to the live ranges.
    108 void LiveRangeCalc::updateLiveIns() {
    109   LiveRangeUpdater Updater;
    110   for (SmallVectorImpl<LiveInBlock>::iterator I = LiveIn.begin(),
    111          E = LiveIn.end(); I != E; ++I) {
    112     if (!I->DomNode)
    113       continue;
    114     MachineBasicBlock *MBB = I->DomNode->getBlock();
    115     assert(I->Value && "No live-in value found");
    116     SlotIndex Start, End;
    117     tie(Start, End) = Indexes->getMBBRange(MBB);
    118 
    119     if (I->Kill.isValid())
    120       // Value is killed inside this block.
    121       End = I->Kill;
    122     else {
    123       // The value is live-through, update LiveOut as well.
    124       // Defer the Domtree lookup until it is needed.
    125       assert(Seen.test(MBB->getNumber()));
    126       LiveOut[MBB] = LiveOutPair(I->Value, (MachineDomTreeNode *)0);
    127     }
    128     Updater.setDest(I->LI);
    129     Updater.add(Start, End, I->Value);
    130   }
    131   LiveIn.clear();
    132 }
    133 
    134 
    135 void LiveRangeCalc::extend(LiveInterval *LI,
    136                            SlotIndex Kill,
    137                            unsigned PhysReg) {
    138   assert(LI && "Missing live range");
    139   assert(Kill.isValid() && "Invalid SlotIndex");
    140   assert(Indexes && "Missing SlotIndexes");
    141   assert(DomTree && "Missing dominator tree");
    142 
    143   MachineBasicBlock *KillMBB = Indexes->getMBBFromIndex(Kill.getPrevSlot());
    144   assert(KillMBB && "No MBB at Kill");
    145 
    146   // Is there a def in the same MBB we can extend?
    147   if (LI->extendInBlock(Indexes->getMBBStartIdx(KillMBB), Kill))
    148     return;
    149 
    150   // Find the single reaching def, or determine if Kill is jointly dominated by
    151   // multiple values, and we may need to create even more phi-defs to preserve
    152   // VNInfo SSA form.  Perform a search for all predecessor blocks where we
    153   // know the dominating VNInfo.
    154   if (findReachingDefs(LI, KillMBB, Kill, PhysReg))
    155     return;
    156 
    157   // When there were multiple different values, we may need new PHIs.
    158   calculateValues();
    159 }
    160 
    161 
    162 // This function is called by a client after using the low-level API to add
    163 // live-out and live-in blocks.  The unique value optimization is not
    164 // available, SplitEditor::transferValues handles that case directly anyway.
    165 void LiveRangeCalc::calculateValues() {
    166   assert(Indexes && "Missing SlotIndexes");
    167   assert(DomTree && "Missing dominator tree");
    168   updateSSA();
    169   updateLiveIns();
    170 }
    171 
    172 
    173 bool LiveRangeCalc::findReachingDefs(LiveInterval *LI,
    174                                      MachineBasicBlock *KillMBB,
    175                                      SlotIndex Kill,
    176                                      unsigned PhysReg) {
    177   unsigned KillMBBNum = KillMBB->getNumber();
    178 
    179   // Block numbers where LI should be live-in.
    180   SmallVector<unsigned, 16> WorkList(1, KillMBBNum);
    181 
    182   // Remember if we have seen more than one value.
    183   bool UniqueVNI = true;
    184   VNInfo *TheVNI = 0;
    185 
    186   // Using Seen as a visited set, perform a BFS for all reaching defs.
    187   for (unsigned i = 0; i != WorkList.size(); ++i) {
    188     MachineBasicBlock *MBB = MF->getBlockNumbered(WorkList[i]);
    189 
    190 #ifndef NDEBUG
    191     if (MBB->pred_empty()) {
    192       MBB->getParent()->verify();
    193       llvm_unreachable("Use not jointly dominated by defs.");
    194     }
    195 
    196     if (TargetRegisterInfo::isPhysicalRegister(PhysReg) &&
    197         !MBB->isLiveIn(PhysReg)) {
    198       MBB->getParent()->verify();
    199       errs() << "The register needs to be live in to BB#" << MBB->getNumber()
    200              << ", but is missing from the live-in list.\n";
    201       llvm_unreachable("Invalid global physical register");
    202     }
    203 #endif
    204 
    205     for (MachineBasicBlock::pred_iterator PI = MBB->pred_begin(),
    206            PE = MBB->pred_end(); PI != PE; ++PI) {
    207        MachineBasicBlock *Pred = *PI;
    208 
    209        // Is this a known live-out block?
    210        if (Seen.test(Pred->getNumber())) {
    211          if (VNInfo *VNI = LiveOut[Pred].first) {
    212            if (TheVNI && TheVNI != VNI)
    213              UniqueVNI = false;
    214            TheVNI = VNI;
    215          }
    216          continue;
    217        }
    218 
    219        SlotIndex Start, End;
    220        tie(Start, End) = Indexes->getMBBRange(Pred);
    221 
    222        // First time we see Pred.  Try to determine the live-out value, but set
    223        // it as null if Pred is live-through with an unknown value.
    224        VNInfo *VNI = LI->extendInBlock(Start, End);
    225        setLiveOutValue(Pred, VNI);
    226        if (VNI) {
    227          if (TheVNI && TheVNI != VNI)
    228            UniqueVNI = false;
    229          TheVNI = VNI;
    230          continue;
    231        }
    232 
    233        // No, we need a live-in value for Pred as well
    234        if (Pred != KillMBB)
    235           WorkList.push_back(Pred->getNumber());
    236        else
    237           // Loopback to KillMBB, so value is really live through.
    238          Kill = SlotIndex();
    239     }
    240   }
    241 
    242   LiveIn.clear();
    243 
    244   // Both updateSSA() and LiveRangeUpdater benefit from ordered blocks, but
    245   // neither require it. Skip the sorting overhead for small updates.
    246   if (WorkList.size() > 4)
    247     array_pod_sort(WorkList.begin(), WorkList.end());
    248 
    249   // If a unique reaching def was found, blit in the live ranges immediately.
    250   if (UniqueVNI) {
    251     LiveRangeUpdater Updater(LI);
    252     for (SmallVectorImpl<unsigned>::const_iterator
    253          I = WorkList.begin(), E = WorkList.end(); I != E; ++I) {
    254        SlotIndex Start, End;
    255        tie(Start, End) = Indexes->getMBBRange(*I);
    256        // Trim the live range in KillMBB.
    257        if (*I == KillMBBNum && Kill.isValid())
    258          End = Kill;
    259        else
    260          LiveOut[MF->getBlockNumbered(*I)] =
    261            LiveOutPair(TheVNI, (MachineDomTreeNode *)0);
    262        Updater.add(Start, End, TheVNI);
    263     }
    264     return true;
    265   }
    266 
    267   // Multiple values were found, so transfer the work list to the LiveIn array
    268   // where UpdateSSA will use it as a work list.
    269   LiveIn.reserve(WorkList.size());
    270   for (SmallVectorImpl<unsigned>::const_iterator
    271        I = WorkList.begin(), E = WorkList.end(); I != E; ++I) {
    272     MachineBasicBlock *MBB = MF->getBlockNumbered(*I);
    273     addLiveInBlock(LI, DomTree->getNode(MBB));
    274     if (MBB == KillMBB)
    275       LiveIn.back().Kill = Kill;
    276   }
    277 
    278   return false;
    279 }
    280 
    281 
    282 // This is essentially the same iterative algorithm that SSAUpdater uses,
    283 // except we already have a dominator tree, so we don't have to recompute it.
    284 void LiveRangeCalc::updateSSA() {
    285   assert(Indexes && "Missing SlotIndexes");
    286   assert(DomTree && "Missing dominator tree");
    287 
    288   // Interate until convergence.
    289   unsigned Changes;
    290   do {
    291     Changes = 0;
    292     // Propagate live-out values down the dominator tree, inserting phi-defs
    293     // when necessary.
    294     for (SmallVectorImpl<LiveInBlock>::iterator I = LiveIn.begin(),
    295            E = LiveIn.end(); I != E; ++I) {
    296       MachineDomTreeNode *Node = I->DomNode;
    297       // Skip block if the live-in value has already been determined.
    298       if (!Node)
    299         continue;
    300       MachineBasicBlock *MBB = Node->getBlock();
    301       MachineDomTreeNode *IDom = Node->getIDom();
    302       LiveOutPair IDomValue;
    303 
    304       // We need a live-in value to a block with no immediate dominator?
    305       // This is probably an unreachable block that has survived somehow.
    306       bool needPHI = !IDom || !Seen.test(IDom->getBlock()->getNumber());
    307 
    308       // IDom dominates all of our predecessors, but it may not be their
    309       // immediate dominator. Check if any of them have live-out values that are
    310       // properly dominated by IDom. If so, we need a phi-def here.
    311       if (!needPHI) {
    312         IDomValue = LiveOut[IDom->getBlock()];
    313 
    314         // Cache the DomTree node that defined the value.
    315         if (IDomValue.first && !IDomValue.second)
    316           LiveOut[IDom->getBlock()].second = IDomValue.second =
    317             DomTree->getNode(Indexes->getMBBFromIndex(IDomValue.first->def));
    318 
    319         for (MachineBasicBlock::pred_iterator PI = MBB->pred_begin(),
    320                PE = MBB->pred_end(); PI != PE; ++PI) {
    321           LiveOutPair &Value = LiveOut[*PI];
    322           if (!Value.first || Value.first == IDomValue.first)
    323             continue;
    324 
    325           // Cache the DomTree node that defined the value.
    326           if (!Value.second)
    327             Value.second =
    328               DomTree->getNode(Indexes->getMBBFromIndex(Value.first->def));
    329 
    330           // This predecessor is carrying something other than IDomValue.
    331           // It could be because IDomValue hasn't propagated yet, or it could be
    332           // because MBB is in the dominance frontier of that value.
    333           if (DomTree->dominates(IDom, Value.second)) {
    334             needPHI = true;
    335             break;
    336           }
    337         }
    338       }
    339 
    340       // The value may be live-through even if Kill is set, as can happen when
    341       // we are called from extendRange. In that case LiveOutSeen is true, and
    342       // LiveOut indicates a foreign or missing value.
    343       LiveOutPair &LOP = LiveOut[MBB];
    344 
    345       // Create a phi-def if required.
    346       if (needPHI) {
    347         ++Changes;
    348         assert(Alloc && "Need VNInfo allocator to create PHI-defs");
    349         SlotIndex Start, End;
    350         tie(Start, End) = Indexes->getMBBRange(MBB);
    351         VNInfo *VNI = I->LI->getNextValue(Start, *Alloc);
    352         I->Value = VNI;
    353         // This block is done, we know the final value.
    354         I->DomNode = 0;
    355 
    356         // Add liveness since updateLiveIns now skips this node.
    357         if (I->Kill.isValid())
    358           I->LI->addRange(LiveRange(Start, I->Kill, VNI));
    359         else {
    360           I->LI->addRange(LiveRange(Start, End, VNI));
    361           LOP = LiveOutPair(VNI, Node);
    362         }
    363       } else if (IDomValue.first) {
    364         // No phi-def here. Remember incoming value.
    365         I->Value = IDomValue.first;
    366 
    367         // If the IDomValue is killed in the block, don't propagate through.
    368         if (I->Kill.isValid())
    369           continue;
    370 
    371         // Propagate IDomValue if it isn't killed:
    372         // MBB is live-out and doesn't define its own value.
    373         if (LOP.first == IDomValue.first)
    374           continue;
    375         ++Changes;
    376         LOP = IDomValue;
    377       }
    378     }
    379   } while (Changes);
    380 }
    381