lib/CodeGen/RegAllocLinearScan.cpp

   1 //===-- RegAllocLinearScan.cpp - Linear Scan register allocator -----------===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file was developed by the LLVM research group and is distributed under
   6 // the University of Illinois Open Source License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  10 // This file implements a linear scan register allocator.
  11 //
  12 //===----------------------------------------------------------------------===//
  13
  14 #define DEBUG_TYPE "regalloc"
  15 #include "llvm/Function.h"
  16 #include "llvm/CodeGen/MachineFunctionPass.h"
  17 #include "llvm/CodeGen/MachineInstr.h"
  18 #include "llvm/CodeGen/Passes.h"
  19 #include "llvm/CodeGen/SSARegMap.h"
  20 #include "llvm/Target/MRegisterInfo.h"
  21 #include "llvm/Target/TargetMachine.h"
  22 #include "Support/Debug.h"
  23 #include "Support/Statistic.h"
  24 #include "Support/STLExtras.h"
  25 #include "LiveIntervalAnalysis.h"
  26 #include "PhysRegTracker.h"
  27 #include "VirtRegMap.h"
  28 #include <algorithm>
  29 #include <cmath>
  30 #include <set>
  31 #include <queue>
  32
  33 using namespace llvm;
  34
  35 namespace {
  36
  37   Statistic<double> efficiency
  38   ("regalloc", "Ratio of intervals processed over total intervals");
  39
  40   static unsigned numIterations = 0;
  41   static unsigned numIntervals = 0;
  42
  43   class RA : public MachineFunctionPass {
  44   private:
  45     MachineFunction* mf_;
  46     const TargetMachine* tm_;
  47     const MRegisterInfo* mri_;
  48     LiveIntervals* li_;
  49     typedef std::vector<LiveInterval*> IntervalPtrs;
  50     IntervalPtrs handled_, fixed_, active_, inactive_;
  51     typedef std::priority_queue<LiveInterval*,
  52                                 IntervalPtrs,
  53                                 greater_ptr<LiveInterval> > IntervalHeap;
  54     IntervalHeap unhandled_;
  55     std::auto_ptr<PhysRegTracker> prt_;
  56     std::auto_ptr<VirtRegMap> vrm_;
  57     std::auto_ptr<Spiller> spiller_;
  58
  59     typedef std::vector<float> SpillWeights;
  60     SpillWeights spillWeights_;
  61
  62   public:
  63     virtual const char* getPassName() const {
  64       return "Linear Scan Register Allocator";
  65     }
  66
  67     virtual void getAnalysisUsage(AnalysisUsage &AU) const {
  68       AU.addRequired<LiveIntervals>();
  69       MachineFunctionPass::getAnalysisUsage(AU);
  70     }
  71
  72     /// runOnMachineFunction - register allocate the whole function
  73     bool runOnMachineFunction(MachineFunction&);
  74
  75     void releaseMemory();
  76
  77   private:
  78     /// linearScan - the linear scan algorithm
  79     void linearScan();
  80
  81     /// initIntervalSets - initializa the four interval sets:
  82     /// unhandled, fixed, active and inactive
  83     void initIntervalSets();
  84
  85     /// processActiveIntervals - expire old intervals and move
  86     /// non-overlapping ones to the incative list
  87     void processActiveIntervals(LiveInterval* cur);
  88
  89     /// processInactiveIntervals - expire old intervals and move
  90     /// overlapping ones to the active list
  91     void processInactiveIntervals(LiveInterval* cur);
  92
  93     /// updateSpillWeights - updates the spill weights of the
  94     /// specifed physical register and its weight
  95     void updateSpillWeights(unsigned reg, SpillWeights::value_type weight);
  96
  97     /// assignRegOrStackSlotAtInterval - assign a register if one
  98     /// is available, or spill.
  99     void assignRegOrStackSlotAtInterval(LiveInterval* cur);
 100
 101     ///
 102     /// register handling helpers
 103     ///
 104
 105     /// getFreePhysReg - return a free physical register for this
 106     /// virtual register interval if we have one, otherwise return
 107     /// 0
 108     unsigned getFreePhysReg(LiveInterval* cur);
 109
 110     /// assignVirt2StackSlot - assigns this virtual register to a
 111     /// stack slot. returns the stack slot
 112     int assignVirt2StackSlot(unsigned virtReg);
 113
 114     template <typename ItTy>
 115     void printIntervals(const char* const str, ItTy i, ItTy e) const {
 116       if (str) std::cerr << str << " intervals:\n";
 117       for (; i != e; ++i) {
 118         std::cerr << "\t" << **i << " -> ";
 119         unsigned reg = (*i)->reg;
 120         if (MRegisterInfo::isVirtualRegister(reg)) {
 121           reg = vrm_->getPhys(reg);
 122         }
 123         std::cerr << mri_->getName(reg) << '\n';
 124       }
 125     }
 126   };
 127 }
 128
 129 void RA::releaseMemory()
 130 {
 131   while (!unhandled_.empty()) unhandled_.pop();
 132   fixed_.clear();
 133   active_.clear();
 134   inactive_.clear();
 135   handled_.clear();
 136 }
 137
 138 bool RA::runOnMachineFunction(MachineFunction &fn) {
 139   mf_ = &fn;
 140   tm_ = &fn.getTarget();
 141   mri_ = tm_->getRegisterInfo();
 142   li_ = &getAnalysis<LiveIntervals>();
 143   if (!prt_.get()) prt_.reset(new PhysRegTracker(*mri_));
 144   vrm_.reset(new VirtRegMap(*mf_));
 145   if (!spiller_.get()) spiller_.reset(createSpiller());
 146
 147   initIntervalSets();
 148
 149   linearScan();
 150
 151   spiller_->runOnMachineFunction(*mf_, *vrm_);
 152
 153   return true;
 154 }
 155
 156 void RA::linearScan()
 157 {
 158   // linear scan algorithm
 159   DEBUG(std::cerr << "********** LINEAR SCAN **********\n");
 160   DEBUG(std::cerr << "********** Function: "
 161         << mf_->getFunction()->getName() << '\n');
 162
 163   // DEBUG(printIntervals("unhandled", unhandled_.begin(), unhandled_.end()));
 164   DEBUG(printIntervals("fixed", fixed_.begin(), fixed_.end()));
 165   DEBUG(printIntervals("active", active_.begin(), active_.end()));
 166   DEBUG(printIntervals("inactive", inactive_.begin(), inactive_.end()));
 167
 168   while (!unhandled_.empty()) {
 169     // pick the interval with the earliest start point
 170     LiveInterval* cur = unhandled_.top();
 171     unhandled_.pop();
 172     ++numIterations;
 173     DEBUG(std::cerr << "\n*** CURRENT ***: " << *cur << '\n');
 174
 175     processActiveIntervals(cur);
 176     processInactiveIntervals(cur);
 177
 178     // if this register is fixed we are done
 179     if (MRegisterInfo::isPhysicalRegister(cur->reg)) {
 180       prt_->addRegUse(cur->reg);
 181       active_.push_back(cur);
 182       handled_.push_back(cur);
 183     }
 184     // otherwise we are allocating a virtual register. try to find
 185     // a free physical register or spill an interval in order to
 186     // assign it one (we could spill the current though).
 187     else {
 188       assignRegOrStackSlotAtInterval(cur);
 189     }
 190
 191     DEBUG(printIntervals("active", active_.begin(), active_.end()));
 192     DEBUG(printIntervals("inactive", inactive_.begin(), inactive_.end()));
 193   }
 194   numIntervals += li_->getNumIntervals();
 195   efficiency = double(numIterations) / double(numIntervals);
 196
 197   // expire any remaining active intervals
 198   for (IntervalPtrs::reverse_iterator
 199          i = active_.rbegin(); i != active_.rend(); ) {
 200     unsigned reg = (*i)->reg;
 201     DEBUG(std::cerr << "\tinterval " << **i << " expired\n");
 202     if (MRegisterInfo::isVirtualRegister(reg))
 203       reg = vrm_->getPhys(reg);
 204     prt_->delRegUse(reg);
 205     i = IntervalPtrs::reverse_iterator(active_.erase(i.base()-1));
 206   }
 207
 208   // expire any remaining inactive intervals
 209   for (IntervalPtrs::reverse_iterator
 210          i = inactive_.rbegin(); i != inactive_.rend(); ) {
 211     DEBUG(std::cerr << "\tinterval " << **i << " expired\n");
 212     i = IntervalPtrs::reverse_iterator(inactive_.erase(i.base()-1));
 213   }
 214
 215   DEBUG(std::cerr << *vrm_);
 216 }
 217
 218 void RA::initIntervalSets()
 219 {
 220   assert(unhandled_.empty() && fixed_.empty() &&
 221          active_.empty() && inactive_.empty() &&
 222          "interval sets should be empty on initialization");
 223
 224   for (LiveIntervals::iterator i = li_->begin(), e = li_->end(); i != e; ++i){
 225     unhandled_.push(&i->second);
 226     if (MRegisterInfo::isPhysicalRegister(i->second.reg))
 227       fixed_.push_back(&i->second);
 228   }
 229 }
 230
 231 void RA::processActiveIntervals(IntervalPtrs::value_type cur)
 232 {
 233   DEBUG(std::cerr << "\tprocessing active intervals:\n");
 234   IntervalPtrs::iterator ii = active_.begin(), ie = active_.end();
 235   while (ii != ie) {
 236     LiveInterval* i = *ii;
 237     unsigned reg = i->reg;
 238
 239     // remove expired intervals
 240     if (i->expiredAt(cur->start())) {
 241       DEBUG(std::cerr << "\t\tinterval " << *i << " expired\n");
 242       if (MRegisterInfo::isVirtualRegister(reg))
 243         reg = vrm_->getPhys(reg);
 244       prt_->delRegUse(reg);
 245       // swap with last element and move end iterator back one position
 246       std::iter_swap(ii, --ie);
 247     }
 248     // move inactive intervals to inactive list
 249     else if (!i->liveAt(cur->start())) {
 250       DEBUG(std::cerr << "\t\tinterval " << *i << " inactive\n");
 251       if (MRegisterInfo::isVirtualRegister(reg))
 252         reg = vrm_->getPhys(reg);
 253       prt_->delRegUse(reg);
 254       // add to inactive
 255       inactive_.push_back(i);
 256       // swap with last element and move end iterator back one postion
 257       std::iter_swap(ii, --ie);
 258     }
 259     else {
 260       ++ii;
 261     }
 262   }
 263   active_.erase(ie, active_.end());
 264 }
 265
 266 void RA::processInactiveIntervals(IntervalPtrs::value_type cur)
 267 {
 268   DEBUG(std::cerr << "\tprocessing inactive intervals:\n");
 269   IntervalPtrs::iterator ii = inactive_.begin(), ie = inactive_.end();
 270   while (ii != ie) {
 271     LiveInterval* i = *ii;
 272     unsigned reg = i->reg;
 273
 274     // remove expired intervals
 275     if (i->expiredAt(cur->start())) {
 276       DEBUG(std::cerr << "\t\tinterval " << *i << " expired\n");
 277       // swap with last element and move end iterator back one position
 278       std::iter_swap(ii, --ie);
 279     }
 280     // move re-activated intervals in active list
 281     else if (i->liveAt(cur->start())) {
 282       DEBUG(std::cerr << "\t\tinterval " << *i << " active\n");
 283       if (MRegisterInfo::isVirtualRegister(reg))
 284         reg = vrm_->getPhys(reg);
 285       prt_->addRegUse(reg);
 286       // add to active
 287       active_.push_back(i);
 288       // swap with last element and move end iterator back one position
 289       std::iter_swap(ii, --ie);
 290     }
 291     else {
 292       ++ii;
 293     }
 294   }
 295   inactive_.erase(ie, inactive_.end());
 296 }
 297
 298 void RA::updateSpillWeights(unsigned reg, SpillWeights::value_type weight)
 299 {
 300   spillWeights_[reg] += weight;
 301   for (const unsigned* as = mri_->getAliasSet(reg); *as; ++as)
 302     spillWeights_[*as] += weight;
 303 }
 304
 305 void RA::assignRegOrStackSlotAtInterval(LiveInterval* cur)
 306 {
 307   DEBUG(std::cerr << "\tallocating current interval: ");
 308
 309   PhysRegTracker backupPrt = *prt_;
 310
 311   spillWeights_.assign(mri_->getNumRegs(), 0.0);
 312
 313   // for each interval in active update spill weights
 314   for (IntervalPtrs::const_iterator i = active_.begin(), e = active_.end();
 315        i != e; ++i) {
 316     unsigned reg = (*i)->reg;
 317     if (MRegisterInfo::isVirtualRegister(reg))
 318       reg = vrm_->getPhys(reg);
 319     updateSpillWeights(reg, (*i)->weight);
 320   }
 321
 322   // for every interval in inactive we overlap with, mark the
 323   // register as not free and update spill weights
 324   for (IntervalPtrs::const_iterator i = inactive_.begin(),
 325          e = inactive_.end(); i != e; ++i) {
 326     if (cur->overlaps(**i)) {
 327       unsigned reg = (*i)->reg;
 328       if (MRegisterInfo::isVirtualRegister(reg))
 329         reg = vrm_->getPhys(reg);
 330       prt_->addRegUse(reg);
 331       updateSpillWeights(reg, (*i)->weight);
 332     }
 333   }
 334
 335   // for every interval in fixed we overlap with,
 336   // mark the register as not free and update spill weights
 337   for (IntervalPtrs::const_iterator i = fixed_.begin(),
 338          e = fixed_.end(); i != e; ++i) {
 339     if (cur->overlaps(**i)) {
 340       unsigned reg = (*i)->reg;
 341       prt_->addRegUse(reg);
 342       updateSpillWeights(reg, (*i)->weight);
 343     }
 344   }
 345
 346   unsigned physReg = getFreePhysReg(cur);
 347   // restore the physical register tracker
 348   *prt_ = backupPrt;
 349   // if we find a free register, we are done: assign this virtual to
 350   // the free physical register and add this interval to the active
 351   // list.
 352   if (physReg) {
 353     DEBUG(std::cerr <<  mri_->getName(physReg) << '\n');
 354     vrm_->assignVirt2Phys(cur->reg, physReg);
 355     prt_->addRegUse(physReg);
 356     active_.push_back(cur);
 357     handled_.push_back(cur);
 358     return;
 359   }
 360   DEBUG(std::cerr << "no free registers\n");
 361
 362   DEBUG(std::cerr << "\tassigning stack slot at interval "<< *cur << ":\n");
 363
 364   float minWeight = HUGE_VAL;
 365   unsigned minReg = 0;
 366   const TargetRegisterClass* rc = mf_->getSSARegMap()->getRegClass(cur->reg);
 367   for (TargetRegisterClass::iterator i = rc->allocation_order_begin(*mf_);
 368        i != rc->allocation_order_end(*mf_); ++i) {
 369     unsigned reg = *i;
 370     if (minWeight > spillWeights_[reg]) {
 371       minWeight = spillWeights_[reg];
 372       minReg = reg;
 373     }
 374   }
 375   DEBUG(std::cerr << "\t\tregister with min weight: "
 376         << mri_->getName(minReg) << " (" << minWeight << ")\n");
 377
 378   // if the current has the minimum weight, we need to spill it and
 379   // add any added intervals back to unhandled, and restart
 380   // linearscan.
 381   if (cur->weight <= minWeight) {
 382     DEBUG(std::cerr << "\t\t\tspilling(c): " << *cur << '\n';);
 383     int slot = vrm_->assignVirt2StackSlot(cur->reg);
 384     std::vector<LiveInterval*> added =
 385       li_->addIntervalsForSpills(*cur, *vrm_, slot);
 386     if (added.empty())
 387       return;  // Early exit if all spills were folded.
 388
 389     // Merge added with unhandled.  Note that we know that
 390     // addIntervalsForSpills returns intervals sorted by their starting
 391     // point.
 392     for (unsigned i = 0, e = added.size(); i != e; ++i)
 393       unhandled_.push(added[i]);
 394     return;
 395   }
 396
 397   // push the current interval back to unhandled since we are going
 398   // to re-run at least this iteration. Since we didn't modify it it
 399   // should go back right in the front of the list
 400   unhandled_.push(cur);
 401
 402   // otherwise we spill all intervals aliasing the register with
 403   // minimum weight, rollback to the interval with the earliest
 404   // start point and let the linear scan algorithm run again
 405   std::vector<LiveInterval*> added;
 406   assert(MRegisterInfo::isPhysicalRegister(minReg) &&
 407          "did not choose a register to spill?");
 408   std::vector<bool> toSpill(mri_->getNumRegs(), false);
 409   // we are going to spill minReg and all its aliases
 410   toSpill[minReg] = true;
 411   for (const unsigned* as = mri_->getAliasSet(minReg); *as; ++as)
 412     toSpill[*as] = true;
 413
 414   // the earliest start of a spilled interval indicates up to where
 415   // in handled we need to roll back
 416   unsigned earliestStart = cur->start();
 417
 418   // set of spilled vregs (used later to rollback properly)
 419   std::set<unsigned> spilled;
 420
 421   // spill live intervals of virtual regs mapped to the physical
 422   // register we want to clear (and its aliases). we only spill
 423   // those that overlap with the current interval as the rest do not
 424   // affect its allocation. we also keep track of the earliest start
 425   // of all spilled live intervals since this will mark our rollback
 426   // point
 427   for (IntervalPtrs::iterator
 428          i = active_.begin(); i != active_.end(); ++i) {
 429     unsigned reg = (*i)->reg;
 430     if (MRegisterInfo::isVirtualRegister(reg) &&
 431         toSpill[vrm_->getPhys(reg)] &&
 432         cur->overlaps(**i)) {
 433       DEBUG(std::cerr << "\t\t\tspilling(a): " << **i << '\n');
 434       earliestStart = std::min(earliestStart, (*i)->start());
 435       int slot = vrm_->assignVirt2StackSlot((*i)->reg);
 436       std::vector<LiveInterval*> newIs =
 437         li_->addIntervalsForSpills(**i, *vrm_, slot);
 438       std::copy(newIs.begin(), newIs.end(), std::back_inserter(added));
 439       spilled.insert(reg);
 440     }
 441   }
 442   for (IntervalPtrs::iterator
 443          i = inactive_.begin(); i != inactive_.end(); ++i) {
 444     unsigned reg = (*i)->reg;
 445     if (MRegisterInfo::isVirtualRegister(reg) &&
 446         toSpill[vrm_->getPhys(reg)] &&
 447         cur->overlaps(**i)) {
 448       DEBUG(std::cerr << "\t\t\tspilling(i): " << **i << '\n');
 449       earliestStart = std::min(earliestStart, (*i)->start());
 450       int slot = vrm_->assignVirt2StackSlot((*i)->reg);
 451       std::vector<LiveInterval*> newIs =
 452         li_->addIntervalsForSpills(**i, *vrm_, slot);
 453       std::copy(newIs.begin(), newIs.end(), std::back_inserter(added));
 454       spilled.insert(reg);
 455     }
 456   }
 457
 458   DEBUG(std::cerr << "\t\trolling back to: " << earliestStart << '\n');
 459   // scan handled in reverse order up to the earliaset start of a
 460   // spilled live interval and undo each one, restoring the state of
 461   // unhandled
 462   while (!handled_.empty()) {
 463     LiveInterval* i = handled_.back();
 464     // if this interval starts before t we are done
 465     if (i->start() < earliestStart)
 466       break;
 467     DEBUG(std::cerr << "\t\t\tundo changes for: " << *i << '\n');
 468     handled_.pop_back();
 469     // when undoing a live interval allocation we must know if it
 470     // is active or inactive to properly update the PhysRegTracker
 471     // and the VirtRegMap
 472     IntervalPtrs::iterator it;
 473     if ((it = find(active_.begin(), active_.end(), i)) != active_.end()) {
 474       active_.erase(it);
 475       if (MRegisterInfo::isPhysicalRegister(i->reg)) {
 476         prt_->delRegUse(i->reg);
 477         unhandled_.push(i);
 478       }
 479       else {
 480         if (!spilled.count(i->reg))
 481           unhandled_.push(i);
 482         prt_->delRegUse(vrm_->getPhys(i->reg));
 483         vrm_->clearVirt(i->reg);
 484       }
 485     }
 486     else if ((it = find(inactive_.begin(), inactive_.end(), i)) != inactive_.end()) {
 487       inactive_.erase(it);
 488       if (MRegisterInfo::isPhysicalRegister(i->reg))
 489         unhandled_.push(i);
 490       else {
 491         if (!spilled.count(i->reg))
 492           unhandled_.push(i);
 493         vrm_->clearVirt(i->reg);
 494       }
 495     }
 496     else {
 497       if (MRegisterInfo::isVirtualRegister(i->reg))
 498         vrm_->clearVirt(i->reg);
 499       unhandled_.push(i);
 500     }
 501   }
 502
 503   // scan the rest and undo each interval that expired after t and
 504   // insert it in active (the next iteration of the algorithm will
 505   // put it in inactive if required)
 506   IntervalPtrs::iterator i = handled_.begin(), e = handled_.end();
 507   for (; i != e; ++i) {
 508     if (!(*i)->expiredAt(earliestStart) && (*i)->expiredAt(cur->start())) {
 509       DEBUG(std::cerr << "\t\t\tundo changes for: " << **i << '\n');
 510       active_.push_back(*i);
 511       if (MRegisterInfo::isPhysicalRegister((*i)->reg))
 512         prt_->addRegUse((*i)->reg);
 513       else
 514         prt_->addRegUse(vrm_->getPhys((*i)->reg));
 515     }
 516   }
 517
 518   std::sort(added.begin(), added.end(), less_ptr<LiveInterval>());
 519   // merge added with unhandled
 520   for (unsigned i = 0, e = added.size(); i != e; ++i)
 521     unhandled_.push(added[i]);
 522 }
 523
 524 unsigned RA::getFreePhysReg(LiveInterval* cur)
 525 {
 526   const TargetRegisterClass* rc = mf_->getSSARegMap()->getRegClass(cur->reg);
 527
 528   for (TargetRegisterClass::iterator i = rc->allocation_order_begin(*mf_);
 529        i != rc->allocation_order_end(*mf_); ++i) {
 530     unsigned reg = *i;
 531     if (prt_->isRegAvail(reg))
 532       return reg;
 533   }
 534   return 0;
 535 }
 536
 537 FunctionPass* llvm::createLinearScanRegisterAllocator() {
 538   return new RA();
 539 }