lib/CodeGen/SimpleRegisterCoalescing.h

   1 //===-- SimpleRegisterCoalescing.h - Register Coalescing --------*- C++ -*-===//
   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 // This file implements a simple register copy coalescing phase.
  11 //
  12 //===----------------------------------------------------------------------===//
  13
  14 #ifndef LLVM_CODEGEN_SIMPLE_REGISTER_COALESCING_H
  15 #define LLVM_CODEGEN_SIMPLE_REGISTER_COALESCING_H
  16
  17 #include "llvm/CodeGen/MachineFunctionPass.h"
  18 #include "llvm/CodeGen/LiveIntervalAnalysis.h"
  19 #include "llvm/CodeGen/RegisterCoalescer.h"
  20 #include "llvm/ADT/BitVector.h"
  21
  22 namespace llvm {
  23   class SimpleRegisterCoalescing;
  24   class LiveVariables;
  25   class TargetRegisterInfo;
  26   class TargetInstrInfo;
  27   class VirtRegMap;
  28   class MachineLoopInfo;
  29
  30   /// CopyRec - Representation for copy instructions in coalescer queue.
  31   ///
  32   struct CopyRec {
  33     MachineInstr *MI;
  34     unsigned LoopDepth;
  35     CopyRec(MachineInstr *mi, unsigned depth)
  36       : MI(mi), LoopDepth(depth) {};
  37   };
  38
  39   class SimpleRegisterCoalescing : public MachineFunctionPass,
  40                                    public RegisterCoalescer {
  41     MachineFunction* mf_;
  42     MachineRegisterInfo* mri_;
  43     const TargetMachine* tm_;
  44     const TargetRegisterInfo* tri_;
  45     const TargetInstrInfo* tii_;
  46     LiveIntervals *li_;
  47     const MachineLoopInfo* loopInfo;
  48     AliasAnalysis *AA;
  49
  50     BitVector allocatableRegs_;
  51     DenseMap<const TargetRegisterClass*, BitVector> allocatableRCRegs_;
  52
  53     /// JoinedCopies - Keep track of copies eliminated due to coalescing.
  54     ///
  55     SmallPtrSet<MachineInstr*, 32> JoinedCopies;
  56
  57     /// ReMatCopies - Keep track of copies eliminated due to remat.
  58     ///
  59     SmallPtrSet<MachineInstr*, 32> ReMatCopies;
  60
  61     /// ReMatDefs - Keep track of definition instructions which have
  62     /// been remat'ed.
  63     SmallPtrSet<MachineInstr*, 8> ReMatDefs;
  64
  65   public:
  66     static char ID; // Pass identifcation, replacement for typeid
  67     SimpleRegisterCoalescing() : MachineFunctionPass(&ID) {}
  68
  69     struct InstrSlots {
  70       enum {
  71         LOAD  = 0,
  72         USE   = 1,
  73         DEF   = 2,
  74         STORE = 3,
  75         NUM   = 4
  76       };
  77     };
  78
  79     virtual void getAnalysisUsage(AnalysisUsage &AU) const;
  80     virtual void releaseMemory();
  81
  82     /// runOnMachineFunction - pass entry point
  83     virtual bool runOnMachineFunction(MachineFunction&);
  84
  85     bool coalesceFunction(MachineFunction &mf, RegallocQuery &) {
  86       // This runs as an independent pass, so don't do anything.
  87       return false;
  88     };
  89
  90     /// print - Implement the dump method.
  91     virtual void print(raw_ostream &O, const Module* = 0) const;
  92
  93   private:
  94     /// joinIntervals - join compatible live intervals
  95     void joinIntervals();
  96
  97     /// CopyCoalesceInMBB - Coalesce copies in the specified MBB, putting
  98     /// copies that cannot yet be coalesced into the "TryAgain" list.
  99     void CopyCoalesceInMBB(MachineBasicBlock *MBB,
 100                            std::vector<CopyRec> &TryAgain);
 101
 102     /// JoinCopy - Attempt to join intervals corresponding to SrcReg/DstReg,
 103     /// which are the src/dst of the copy instruction CopyMI.  This returns true
 104     /// if the copy was successfully coalesced away. If it is not currently
 105     /// possible to coalesce this interval, but it may be possible if other
 106     /// things get coalesced, then it returns true by reference in 'Again'.
 107     bool JoinCopy(CopyRec &TheCopy, bool &Again);
 108
 109     /// JoinIntervals - Attempt to join these two intervals.  On failure, this
 110     /// returns false.  Otherwise, if one of the intervals being joined is a
 111     /// physreg, this method always canonicalizes DestInt to be it.  The output
 112     /// "SrcInt" will not have been modified, so we can use this information
 113     /// below to update aliases.
 114     bool JoinIntervals(LiveInterval &LHS, LiveInterval &RHS, bool &Swapped);
 115
 116     /// SimpleJoin - Attempt to join the specified interval into this one. The
 117     /// caller of this method must guarantee that the RHS only contains a single
 118     /// value number and that the RHS is not defined by a copy from this
 119     /// interval.  This returns false if the intervals are not joinable, or it
 120     /// joins them and returns true.
 121     bool SimpleJoin(LiveInterval &LHS, LiveInterval &RHS);
 122
 123     /// Return true if the two specified registers belong to different register
 124     /// classes.  The registers may be either phys or virt regs.
 125     bool differingRegisterClasses(unsigned RegA, unsigned RegB) const;
 126
 127     /// AdjustCopiesBackFrom - We found a non-trivially-coalescable copy. If
 128     /// the source value number is defined by a copy from the destination reg
 129     /// see if we can merge these two destination reg valno# into a single
 130     /// value number, eliminating a copy.
 131     bool AdjustCopiesBackFrom(LiveInterval &IntA, LiveInterval &IntB,
 132                               MachineInstr *CopyMI);
 133
 134     /// HasOtherReachingDefs - Return true if there are definitions of IntB
 135     /// other than BValNo val# that can reach uses of AValno val# of IntA.
 136     bool HasOtherReachingDefs(LiveInterval &IntA, LiveInterval &IntB,
 137                               VNInfo *AValNo, VNInfo *BValNo);
 138
 139     /// RemoveCopyByCommutingDef - We found a non-trivially-coalescable copy.
 140     /// If the source value number is defined by a commutable instruction and
 141     /// its other operand is coalesced to the copy dest register, see if we
 142     /// can transform the copy into a noop by commuting the definition.
 143     bool RemoveCopyByCommutingDef(LiveInterval &IntA, LiveInterval &IntB,
 144                                   MachineInstr *CopyMI);
 145
 146     /// TrimLiveIntervalToLastUse - If there is a last use in the same basic
 147     /// block as the copy instruction, trim the ive interval to the last use
 148     /// and return true.
 149     bool TrimLiveIntervalToLastUse(SlotIndex CopyIdx,
 150                                    MachineBasicBlock *CopyMBB,
 151                                    LiveInterval &li, const LiveRange *LR);
 152
 153     /// ReMaterializeTrivialDef - If the source of a copy is defined by a trivial
 154     /// computation, replace the copy by rematerialize the definition.
 155     bool ReMaterializeTrivialDef(LiveInterval &SrcInt, unsigned DstReg,
 156                                  unsigned DstSubIdx, MachineInstr *CopyMI);
 157
 158     /// CanCoalesceWithImpDef - Returns true if the specified copy instruction
 159     /// from an implicit def to another register can be coalesced away.
 160     bool CanCoalesceWithImpDef(MachineInstr *CopyMI,
 161                                LiveInterval &li, LiveInterval &ImpLi) const;
 162
 163     /// TurnCopiesFromValNoToImpDefs - The specified value# is defined by an
 164     /// implicit_def and it is being removed. Turn all copies from this value#
 165     /// into implicit_defs.
 166     void TurnCopiesFromValNoToImpDefs(LiveInterval &li, VNInfo *VNI);
 167
 168     /// isWinToJoinVRWithSrcPhysReg - Return true if it's worth while to join a
 169     /// a virtual destination register with physical source register.
 170     bool isWinToJoinVRWithSrcPhysReg(MachineInstr *CopyMI,
 171                                     MachineBasicBlock *CopyMBB,
 172                                     LiveInterval &DstInt, LiveInterval &SrcInt);
 173
 174     /// isWinToJoinVRWithDstPhysReg - Return true if it's worth while to join a
 175     /// copy from a virtual source register to a physical destination register.
 176     bool isWinToJoinVRWithDstPhysReg(MachineInstr *CopyMI,
 177                                     MachineBasicBlock *CopyMBB,
 178                                     LiveInterval &DstInt, LiveInterval &SrcInt);
 179
 180     /// isWinToJoinCrossClass - Return true if it's profitable to coalesce
 181     /// two virtual registers from different register classes.
 182     bool isWinToJoinCrossClass(unsigned LargeReg, unsigned SmallReg,
 183                                unsigned Threshold);
 184
 185     /// HasIncompatibleSubRegDefUse - If we are trying to coalesce a virtual
 186     /// register with a physical register, check if any of the virtual register
 187     /// operand is a sub-register use or def. If so, make sure it won't result
 188     /// in an illegal extract_subreg or insert_subreg instruction.
 189     bool HasIncompatibleSubRegDefUse(MachineInstr *CopyMI,
 190                                      unsigned VirtReg, unsigned PhysReg);
 191
 192     /// CanJoinExtractSubRegToPhysReg - Return true if it's possible to coalesce
 193     /// an extract_subreg where dst is a physical register, e.g.
 194     /// cl = EXTRACT_SUBREG reg1024, 1
 195     bool CanJoinExtractSubRegToPhysReg(unsigned DstReg, unsigned SrcReg,
 196                                        unsigned SubIdx, unsigned &RealDstReg);
 197
 198     /// CanJoinInsertSubRegToPhysReg - Return true if it's possible to coalesce
 199     /// an insert_subreg where src is a physical register, e.g.
 200     /// reg1024 = INSERT_SUBREG reg1024, c1, 0
 201     bool CanJoinInsertSubRegToPhysReg(unsigned DstReg, unsigned SrcReg,
 202                                       unsigned SubIdx, unsigned &RealDstReg);
 203
 204     /// ValueLiveAt - Return true if the LiveRange pointed to by the given
 205     /// iterator, or any subsequent range with the same value number,
 206     /// is live at the given point.
 207     bool ValueLiveAt(LiveInterval::iterator LRItr, LiveInterval::iterator LREnd,
 208                      SlotIndex defPoint) const;
 209
 210     /// RangeIsDefinedByCopyFromReg - Return true if the specified live range of
 211     /// the specified live interval is defined by a copy from the specified
 212     /// register.
 213     bool RangeIsDefinedByCopyFromReg(LiveInterval &li, LiveRange *LR,
 214                                      unsigned Reg);
 215
 216     /// UpdateRegDefsUses - Replace all defs and uses of SrcReg to DstReg and
 217     /// update the subregister number if it is not zero. If DstReg is a
 218     /// physical register and the existing subregister number of the def / use
 219     /// being updated is not zero, make sure to set it to the correct physical
 220     /// subregister.
 221     void UpdateRegDefsUses(unsigned SrcReg, unsigned DstReg, unsigned SubIdx);
 222
 223     /// RemoveUnnecessaryKills - Remove kill markers that are no longer accurate
 224     /// due to live range lengthening as the result of coalescing.
 225     void RemoveUnnecessaryKills(unsigned Reg, LiveInterval &LI);
 226
 227     /// ShortenDeadCopyLiveRange - Shorten a live range defined by a dead copy.
 228     /// Return true if live interval is removed.
 229     bool ShortenDeadCopyLiveRange(LiveInterval &li, MachineInstr *CopyMI);
 230
 231     /// ShortenDeadCopyLiveRange - Shorten a live range as it's artificially
 232     /// extended by a dead copy. Mark the last use (if any) of the val# as kill
 233     /// as ends the live range there. If there isn't another use, then this
 234     /// live range is dead. Return true if live interval is removed.
 235     bool ShortenDeadCopySrcLiveRange(LiveInterval &li, MachineInstr *CopyMI);
 236
 237     /// RemoveDeadDef - If a def of a live interval is now determined dead,
 238     /// remove the val# it defines. If the live interval becomes empty, remove
 239     /// it as well.
 240     bool RemoveDeadDef(LiveInterval &li, MachineInstr *DefMI);
 241
 242     /// lastRegisterUse - Returns the last use of the specific register between
 243     /// cycles Start and End or NULL if there are no uses.
 244     MachineOperand *lastRegisterUse(SlotIndex Start, SlotIndex End,
 245                                     unsigned Reg, SlotIndex &LastUseIdx) const;
 246
 247     void printRegName(unsigned reg) const;
 248   };
 249
 250 } // End llvm namespace
 251
 252 #endif