LLVM  8.0.1
WebAssemblyRegColoring.cpp
Go to the documentation of this file.
1 //===-- WebAssemblyRegColoring.cpp - Register coloring --------------------===//
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 /// \file
11 /// This file implements a virtual register coloring pass.
12 ///
13 /// WebAssembly doesn't have a fixed number of registers, but it is still
14 /// desirable to minimize the total number of registers used in each function.
15 ///
16 /// This code is modeled after lib/CodeGen/StackSlotColoring.cpp.
17 ///
18 //===----------------------------------------------------------------------===//
19 
20 #include "WebAssembly.h"
25 #include "llvm/CodeGen/Passes.h"
26 #include "llvm/Support/Debug.h"
28 using namespace llvm;
29 
30 #define DEBUG_TYPE "wasm-reg-coloring"
31 
32 namespace {
33 class WebAssemblyRegColoring final : public MachineFunctionPass {
34 public:
35  static char ID; // Pass identification, replacement for typeid
36  WebAssemblyRegColoring() : MachineFunctionPass(ID) {}
37 
38  StringRef getPassName() const override {
39  return "WebAssembly Register Coloring";
40  }
41 
42  void getAnalysisUsage(AnalysisUsage &AU) const override {
43  AU.setPreservesCFG();
49  }
50 
51  bool runOnMachineFunction(MachineFunction &MF) override;
52 
53 private:
54 };
55 } // end anonymous namespace
56 
58 INITIALIZE_PASS(WebAssemblyRegColoring, DEBUG_TYPE,
59  "Minimize number of registers used", false, false)
60 
62  return new WebAssemblyRegColoring();
63 }
64 
65 // Compute the total spill weight for VReg.
67  const MachineBlockFrequencyInfo *MBFI,
68  unsigned VReg) {
69  float weight = 0.0f;
70  for (MachineOperand &MO : MRI->reg_nodbg_operands(VReg))
71  weight += LiveIntervals::getSpillWeight(MO.isDef(), MO.isUse(), MBFI,
72  *MO.getParent());
73  return weight;
74 }
75 
76 bool WebAssemblyRegColoring::runOnMachineFunction(MachineFunction &MF) {
77  LLVM_DEBUG({
78  dbgs() << "********** Register Coloring **********\n"
79  << "********** Function: " << MF.getName() << '\n';
80  });
81 
82  // If there are calls to setjmp or sigsetjmp, don't perform coloring. Virtual
83  // registers could be modified before the longjmp is executed, resulting in
84  // the wrong value being used afterwards. (See <rdar://problem/8007500>.)
85  // TODO: Does WebAssembly need to care about setjmp for register coloring?
86  if (MF.exposesReturnsTwice())
87  return false;
88 
90  LiveIntervals *Liveness = &getAnalysis<LiveIntervals>();
91  const MachineBlockFrequencyInfo *MBFI =
92  &getAnalysis<MachineBlockFrequencyInfo>();
94 
95  // Gather all register intervals into a list and sort them.
96  unsigned NumVRegs = MRI->getNumVirtRegs();
97  SmallVector<LiveInterval *, 0> SortedIntervals;
98  SortedIntervals.reserve(NumVRegs);
99 
100  LLVM_DEBUG(dbgs() << "Interesting register intervals:\n");
101  for (unsigned i = 0; i < NumVRegs; ++i) {
102  unsigned VReg = TargetRegisterInfo::index2VirtReg(i);
103  if (MFI.isVRegStackified(VReg))
104  continue;
105  // Skip unused registers, which can use $drop.
106  if (MRI->use_empty(VReg))
107  continue;
108 
109  LiveInterval *LI = &Liveness->getInterval(VReg);
110  assert(LI->weight == 0.0f);
111  LI->weight = computeWeight(MRI, MBFI, VReg);
112  LLVM_DEBUG(LI->dump());
113  SortedIntervals.push_back(LI);
114  }
115  LLVM_DEBUG(dbgs() << '\n');
116 
117  // Sort them to put arguments first (since we don't want to rename live-in
118  // registers), by weight next, and then by position.
119  // TODO: Investigate more intelligent sorting heuristics. For starters, we
120  // should try to coalesce adjacent live intervals before non-adjacent ones.
121  llvm::sort(SortedIntervals, [MRI](LiveInterval *LHS, LiveInterval *RHS) {
122  if (MRI->isLiveIn(LHS->reg) != MRI->isLiveIn(RHS->reg))
123  return MRI->isLiveIn(LHS->reg);
124  if (LHS->weight != RHS->weight)
125  return LHS->weight > RHS->weight;
126  if (LHS->empty() || RHS->empty())
127  return !LHS->empty() && RHS->empty();
128  return *LHS < *RHS;
129  });
130 
131  LLVM_DEBUG(dbgs() << "Coloring register intervals:\n");
132  SmallVector<unsigned, 16> SlotMapping(SortedIntervals.size(), -1u);
134  SortedIntervals.size());
135  BitVector UsedColors(SortedIntervals.size());
136  bool Changed = false;
137  for (size_t i = 0, e = SortedIntervals.size(); i < e; ++i) {
138  LiveInterval *LI = SortedIntervals[i];
139  unsigned Old = LI->reg;
140  size_t Color = i;
141  const TargetRegisterClass *RC = MRI->getRegClass(Old);
142 
143  // Check if it's possible to reuse any of the used colors.
144  if (!MRI->isLiveIn(Old))
145  for (unsigned C : UsedColors.set_bits()) {
146  if (MRI->getRegClass(SortedIntervals[C]->reg) != RC)
147  continue;
148  for (LiveInterval *OtherLI : Assignments[C])
149  if (!OtherLI->empty() && OtherLI->overlaps(*LI))
150  goto continue_outer;
151  Color = C;
152  break;
153  continue_outer:;
154  }
155 
156  unsigned New = SortedIntervals[Color]->reg;
157  SlotMapping[i] = New;
158  Changed |= Old != New;
159  UsedColors.set(Color);
160  Assignments[Color].push_back(LI);
161  LLVM_DEBUG(
162  dbgs() << "Assigning vreg" << TargetRegisterInfo::virtReg2Index(LI->reg)
163  << " to vreg" << TargetRegisterInfo::virtReg2Index(New) << "\n");
164  }
165  if (!Changed)
166  return false;
167 
168  // Rewrite register operands.
169  for (size_t i = 0, e = SortedIntervals.size(); i < e; ++i) {
170  unsigned Old = SortedIntervals[i]->reg;
171  unsigned New = SlotMapping[i];
172  if (Old != New)
173  MRI->replaceRegWith(Old, New);
174  }
175  return true;
176 }
uint64_t CallInst * C
bool empty() const
Definition: LiveInterval.h:370
AnalysisUsage & addPreserved()
Add the specified Pass class to the set of analyses preserved by this pass.
const unsigned reg
Definition: LiveInterval.h:667
const TargetRegisterClass * getRegClass(unsigned Reg) const
Return the register class of the specified virtual register.
static float getSpillWeight(bool isDef, bool isUse, const MachineBlockFrequencyInfo *MBFI, const MachineInstr &MI)
Calculate the spill weight to assign to a single instruction.
static unsigned virtReg2Index(unsigned Reg)
Convert a virtual register number to a 0-based index.
This class represents lattice values for constants.
Definition: AllocatorList.h:24
static unsigned index2VirtReg(unsigned Index)
Convert a 0-based index to a virtual register number.
char & MachineDominatorsID
MachineDominators - This pass is a machine dominators analysis pass.
LiveInterval - This class represents the liveness of a register, or stack slot.
Definition: LiveInterval.h:638
iterator_range< reg_nodbg_iterator > reg_nodbg_operands(unsigned Reg) const
static float computeWeight(const MachineRegisterInfo *MRI, const MachineBlockFrequencyInfo *MBFI, unsigned VReg)
MachineBlockFrequencyInfo pass uses BlockFrequencyInfoImpl implementation to estimate machine basic b...
INITIALIZE_PASS(WebAssemblyRegColoring, DEBUG_TYPE, "Minimize number of registers used", false, false) FunctionPass *llvm
void reserve(size_type N)
Definition: SmallVector.h:376
This file contains the entry points for global functions defined in the LLVM WebAssembly back-end...
AnalysisUsage & addRequired()
MachineFunctionPass - This class adapts the FunctionPass interface to allow convenient creation of pa...
FunctionPass * createWebAssemblyRegColoring()
AnalysisUsage & addPreservedID(const void *ID)
StringRef getName() const
getName - Return the name of the corresponding LLVM function.
unsigned const MachineRegisterInfo * MRI
void getAnalysisUsage(AnalysisUsage &AU) const override
getAnalysisUsage - Subclasses that override getAnalysisUsage must call this.
Represent the analysis usage information of a pass.
Ty * getInfo()
getInfo - Keep track of various per-function pieces of information for backends that would like to do...
FunctionPass class - This class is used to implement most global optimizations.
Definition: Pass.h:285
unsigned getNumVirtRegs() const
getNumVirtRegs - Return the number of virtual registers created.
size_t size() const
Definition: SmallVector.h:53
void sort(IteratorTy Start, IteratorTy End)
Definition: STLExtras.h:1116
Color
A "color", which is either even or odd.
MachineOperand class - Representation of each machine instruction operand.
This is a &#39;vector&#39; (really, a variable-sized array), optimized for the case when the array is small...
Definition: SmallVector.h:847
void setPreservesCFG()
This function should be called by the pass, iff they do not:
Definition: Pass.cpp:286
LiveInterval & getInterval(unsigned Reg)
raw_ostream & dbgs()
dbgs() - This returns a reference to a raw_ostream for debugging messages.
Definition: Debug.cpp:133
bool use_empty(unsigned RegNo) const
use_empty - Return true if there are no instructions using the specified register.
This struct contains the mappings from the slot numbers to unnamed metadata nodes, global values and types.
Definition: SlotMapping.h:33
void replaceRegWith(unsigned FromReg, unsigned ToReg)
replaceRegWith - Replace all instances of FromReg with ToReg in the machine function.
MachineRegisterInfo - Keep track of information for virtual and physical registers, including vreg register classes, use/def chains for registers, etc.
bool isLiveIn(unsigned Reg) const
This class is derived from MachineFunctionInfo and contains private WebAssembly-specific information ...
MachineRegisterInfo & getRegInfo()
getRegInfo - Return information about the registers currently in use.
bool exposesReturnsTwice() const
exposesReturnsTwice - Returns true if the function calls setjmp or any other similar functions with a...
This file declares WebAssembly-specific per-machine-function information.
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
#define DEBUG_TYPE
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:49
#define LLVM_DEBUG(X)
Definition: Debug.h:123