-// $Id$ -*-c++-*-
-//***************************************************************************
-// File:
-// MachineFrameInfo.h
-//
-// Purpose:
-// Interface to layout of stack frame on target machine.
-//
-// History:
-// 11/6/01 - Vikram Adve - Created
-//**************************************************************************/
+//===-- llvm/Target/TargetFrameInfo.h ---------------------------*- C++ -*-===//
+//
+// The LLVM Compiler Infrastructure
+//
+// This file was developed by the LLVM research group and is distributed under
+// the University of Illinois Open Source License. See LICENSE.TXT for details.
+//
+//===----------------------------------------------------------------------===//
+//
+// Interface to describe the layout of a stack frame on the target machine.
+//
+//===----------------------------------------------------------------------===//
-#ifndef LLVM_CODEGEN_FRAMEINFO_H
-#define LLVM_CODEGEN_FRAMEINFO_H
+#ifndef LLVM_TARGET_TARGETFRAMEINFO_H
+#define LLVM_TARGET_TARGETFRAMEINFO_H
-#include "Support/NonCopyable.h"
-#include <vector>
+#include <utility>
+namespace llvm {
-//************************* Forward Declarations **************************/
+class MachineFunction;
-class MachineCodeForMethod;
+/// Information about stack frame layout on the target. It holds the direction
+/// of stack growth, the known stack alignment on entry to each function, and
+/// the offset to the locals area.
+///
+/// The offset to the local area is the offset from the stack pointer on
+/// function entry to the first location where function data (local variables,
+/// spill locations) can be stored.
+class TargetFrameInfo {
+public:
+ enum StackDirection {
+ StackGrowsUp, // Adding to the stack increases the stack address
+ StackGrowsDown // Adding to the stack decreases the stack address
+ };
+private:
+ StackDirection StackDir;
+ unsigned StackAlignment;
+ int LocalAreaOffset;
+public:
+ TargetFrameInfo(StackDirection D, unsigned StackAl, int LAO)
+ : StackDir(D), StackAlignment(StackAl), LocalAreaOffset(LAO) {}
+ virtual ~TargetFrameInfo();
-//*************************** External Classes ****************************/
+ // These methods return information that describes the abstract stack layout
+ // of the target machine.
+ /// getStackGrowthDirection - Return the direction the stack grows
+ ///
+ StackDirection getStackGrowthDirection() const { return StackDir; }
-class MachineFrameInfo : public NonCopyableV {
-public:
- const TargetMachine& target;
-
-public:
- /*ctor*/ MachineFrameInfo(const TargetMachine& tgt) : target(tgt) {}
-
- //
- // These methods provide constant parameters of the frame layout.
- //
- virtual int getStackFrameSizeAlignment () const = 0;
- virtual int getMinStackFrameSize () const = 0;
- virtual int getNumFixedOutgoingArgs () const = 0;
- virtual int getSizeOfEachArgOnStack () const = 0;
- virtual bool argsOnStackHaveFixedSize () const = 0;
-
- //
- // These methods compute offsets using the frame contents for a
- // particular method. The frame contents are obtained from the
- // MachineCodeInfoForMethod object for the given method.
- //
- virtual int getFirstIncomingArgOffset (MachineCodeForMethod& mcInfo,
- bool& pos) const=0;
- virtual int getFirstOutgoingArgOffset (MachineCodeForMethod& mcInfo,
- bool& pos) const=0;
- virtual int getFirstOptionalOutgoingArgOffset (MachineCodeForMethod&,
- bool& pos) const=0;
- virtual int getFirstAutomaticVarOffset (MachineCodeForMethod& mcInfo,
- bool& pos) const=0;
- virtual int getRegSpillAreaOffset (MachineCodeForMethod& mcInfo,
- bool& pos) const=0;
- virtual int getTmpAreaOffset (MachineCodeForMethod& mcInfo,
- bool& pos) const=0;
- virtual int getDynamicAreaOffset (MachineCodeForMethod& mcInfo,
- bool& pos) const=0;
+ /// getStackAlignment - This method returns the number of bytes that the stack
+ /// pointer must be aligned to. Typically, this is the largest alignment for
+ /// any data object in the target.
+ ///
+ unsigned getStackAlignment() const { return StackAlignment; }
+ /// getOffsetOfLocalArea - This method returns the offset of the local area
+ /// from the stack pointer on entrance to a function.
+ ///
+ int getOffsetOfLocalArea() const { return LocalAreaOffset; }
+
+ /// getCalleeSaveSpillSlots - This method returns a pointer to an array of
+ /// pairs, that contains an entry for each callee save register that must be
+ /// spilled to a particular stack location if it is spilled.
+ ///
+ /// Each entry in this array contains a <register,offset> pair, indicating the
+ /// fixed offset from the incoming stack pointer that each register should be
+ /// spilled at. If a register is not listed here, the code generator is
+ /// allowed to spill it anywhere it chooses.
+ ///
+ virtual const std::pair<unsigned, int> *
+ getCalleeSaveSpillSlots(unsigned &NumEntries) const {
+ NumEntries = 0;
+ return 0;
+ }
+
+ //===--------------------------------------------------------------------===//
+ // These methods provide details of the stack frame used by Sparc, thus they
+ // are Sparc specific.
+ //===--------------------------------------------------------------------===//
+
+ // This method adjusts a stack offset to meet alignment rules of target.
+ virtual int adjustAlignment(int unalignedOffset, bool growUp,
+ unsigned align) const;
+
+ // These methods compute offsets using the frame contents for a particular
+ // function. The frame contents are obtained from the MachineFunction object
+ // for the given function. The rest must be implemented by the
+ // machine-specific subclass.
//
- // These methods specify the base register used for each stack area
- // (generally FP or SP)
- //
- virtual int getIncomingArgBaseRegNum() const=0;
- virtual int getOutgoingArgBaseRegNum() const=0;
- virtual int getOptionalOutgoingArgBaseRegNum() const=0;
- virtual int getAutomaticVarBaseRegNum() const=0;
- virtual int getRegSpillAreaBaseRegNum() const=0;
- virtual int getDynamicAreaBaseRegNum() const=0;
+ virtual int getIncomingArgOffset(MachineFunction& mcInfo,
+ unsigned argNum) const;
+ virtual int getOutgoingArgOffset(MachineFunction& mcInfo,
+ unsigned argNum) const;
+ virtual int getFirstAutomaticVarOffset(MachineFunction& mcInfo,
+ bool& growUp) const;
+ virtual int getRegSpillAreaOffset(MachineFunction& mcInfo,
+ bool& growUp) const;
+ virtual int getTmpAreaOffset(MachineFunction& mcInfo, bool& growUp) const;
+ virtual int getDynamicAreaOffset(MachineFunction& mcInfo, bool& growUp) const;
};
+} // End llvm namespace
+
#endif