contrib/llvm/lib/Target/PowerPC/PPCFrameLowering.h

   1 //===-- PPCFrameLowering.h - Define frame lowering for PowerPC --*- 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 //
  11 //===----------------------------------------------------------------------===//
  12
  13 #ifndef LLVM_LIB_TARGET_POWERPC_PPCFRAMELOWERING_H
  14 #define LLVM_LIB_TARGET_POWERPC_PPCFRAMELOWERING_H
  15
  16 #include "PPC.h"
  17 #include "llvm/ADT/STLExtras.h"
  18 #include "llvm/Target/TargetFrameLowering.h"
  19 #include "llvm/Target/TargetMachine.h"
  20
  21 namespace llvm {
  22 class PPCSubtarget;
  23
  24 class PPCFrameLowering: public TargetFrameLowering {
  25   const PPCSubtarget &Subtarget;
  26   const unsigned ReturnSaveOffset;
  27   const unsigned TOCSaveOffset;
  28   const unsigned FramePointerSaveOffset;
  29   const unsigned LinkageSize;
  30   const unsigned BasePointerSaveOffset;
  31
  32   /**
  33    * \brief Find register[s] that can be used in function prologue and epilogue
  34    *
  35    * Find register[s] that can be use as scratch register[s] in function
  36    * prologue and epilogue to save various registers (Link Register, Base
  37    * Pointer, etc.). Prefer R0/R12, if available. Otherwise choose whatever
  38    * register[s] are available.
  39    *
  40    * This method will return true if it is able to find enough unique scratch
  41    * registers (1 or 2 depending on the requirement). If it is unable to find
  42    * enough available registers in the block, it will return false and set
  43    * any passed output parameter that corresponds to a required unique register
  44    * to PPC::NoRegister.
  45    *
  46    * \param[in] MBB The machine basic block to find an available register for
  47    * \param[in] UseAtEnd Specify whether the scratch register will be used at
  48    *                     the end of the basic block (i.e., will the scratch
  49    *                     register kill a register defined in the basic block)
  50    * \param[in] TwoUniqueRegsRequired Specify whether this basic block will
  51    *                                  require two unique scratch registers.
  52    * \param[out] SR1 The scratch register to use
  53    * \param[out] SR2 The second scratch register. If this pointer is not null
  54    *                 the function will attempt to set it to an available
  55    *                 register regardless of whether there is a hard requirement
  56    *                 for two unique scratch registers.
  57    * \return true if the required number of registers was found.
  58    *         false if the required number of scratch register weren't available.
  59    *         If either output parameter refers to a required scratch register
  60    *         that isn't available, it will be set to an invalid value.
  61    */
  62   bool findScratchRegister(MachineBasicBlock *MBB,
  63                            bool UseAtEnd,
  64                            bool TwoUniqueRegsRequired = false,
  65                            unsigned *SR1 = nullptr,
  66                            unsigned *SR2 = nullptr) const;
  67   bool twoUniqueScratchRegsRequired(MachineBasicBlock *MBB) const;
  68
  69   /**
  70    * \brief Create branch instruction for PPC::TCRETURN* (tail call return)
  71    *
  72    * \param[in] MBB that is terminated by PPC::TCRETURN*
  73    */
  74   void createTailCallBranchInstr(MachineBasicBlock &MBB) const;
  75
  76 public:
  77   PPCFrameLowering(const PPCSubtarget &STI);
  78
  79   unsigned determineFrameLayout(MachineFunction &MF,
  80                                 bool UpdateMF = true,
  81                                 bool UseEstimate = false) const;
  82
  83   /// emitProlog/emitEpilog - These methods insert prolog and epilog code into
  84   /// the function.
  85   void emitPrologue(MachineFunction &MF, MachineBasicBlock &MBB) const override;
  86   void emitEpilogue(MachineFunction &MF, MachineBasicBlock &MBB) const override;
  87
  88   bool hasFP(const MachineFunction &MF) const override;
  89   bool needsFP(const MachineFunction &MF) const;
  90   void replaceFPWithRealFP(MachineFunction &MF) const;
  91
  92   void determineCalleeSaves(MachineFunction &MF, BitVector &SavedRegs,
  93                             RegScavenger *RS = nullptr) const override;
  94   void processFunctionBeforeFrameFinalized(MachineFunction &MF,
  95                                      RegScavenger *RS = nullptr) const override;
  96   void addScavengingSpillSlot(MachineFunction &MF, RegScavenger *RS) const;
  97
  98   bool spillCalleeSavedRegisters(MachineBasicBlock &MBB,
  99                                  MachineBasicBlock::iterator MI,
 100                                  const std::vector<CalleeSavedInfo> &CSI,
 101                                  const TargetRegisterInfo *TRI) const override;
 102
 103   MachineBasicBlock::iterator
 104   eliminateCallFramePseudoInstr(MachineFunction &MF, MachineBasicBlock &MBB,
 105                                 MachineBasicBlock::iterator I) const override;
 106
 107   bool restoreCalleeSavedRegisters(MachineBasicBlock &MBB,
 108                                   MachineBasicBlock::iterator MI,
 109                                   const std::vector<CalleeSavedInfo> &CSI,
 110                                   const TargetRegisterInfo *TRI) const override;
 111
 112   /// targetHandlesStackFrameRounding - Returns true if the target is
 113   /// responsible for rounding up the stack frame (probably at emitPrologue
 114   /// time).
 115   bool targetHandlesStackFrameRounding() const override { return true; }
 116
 117   /// getReturnSaveOffset - Return the previous frame offset to save the
 118   /// return address.
 119   unsigned getReturnSaveOffset() const { return ReturnSaveOffset; }
 120
 121   /// getTOCSaveOffset - Return the previous frame offset to save the
 122   /// TOC register -- 64-bit SVR4 ABI only.
 123   unsigned getTOCSaveOffset() const { return TOCSaveOffset; }
 124
 125   /// getFramePointerSaveOffset - Return the previous frame offset to save the
 126   /// frame pointer.
 127   unsigned getFramePointerSaveOffset() const { return FramePointerSaveOffset; }
 128
 129   /// getBasePointerSaveOffset - Return the previous frame offset to save the
 130   /// base pointer.
 131   unsigned getBasePointerSaveOffset() const { return BasePointerSaveOffset; }
 132
 133   /// getLinkageSize - Return the size of the PowerPC ABI linkage area.
 134   ///
 135   unsigned getLinkageSize() const { return LinkageSize; }
 136
 137   const SpillSlot *
 138   getCalleeSavedSpillSlots(unsigned &NumEntries) const override;
 139
 140   bool enableShrinkWrapping(const MachineFunction &MF) const override;
 141
 142   /// Methods used by shrink wrapping to determine if MBB can be used for the
 143   /// function prologue/epilogue.
 144   bool canUseAsPrologue(const MachineBasicBlock &MBB) const override;
 145   bool canUseAsEpilogue(const MachineBasicBlock &MBB) const override;
 146 };
 147 } // End llvm namespace
 148
 149 #endif