LLVM API Documentation

Classes | Public Types | Public Member Functions | Static Public Attributes
llvm::SpillPlacement Class Reference

#include <SpillPlacement.h>

Inheritance diagram for llvm::SpillPlacement:
Inheritance graph
[legend]
Collaboration diagram for llvm::SpillPlacement:
Collaboration graph
[legend]

List of all members.

Classes

struct  BlockConstraint
 BlockConstraint - Entry and exit constraints for a basic block. More...
struct  Node

Public Types

enum  BorderConstraint {
  DontCare, PrefReg, PrefSpill, PrefBoth,
  MustSpill
}

Public Member Functions

 SpillPlacement ()
 ~SpillPlacement ()
void prepare (BitVector &RegBundles)
void addConstraints (ArrayRef< BlockConstraint > LiveBlocks)
void addPrefSpill (ArrayRef< unsigned > Blocks, bool Strong)
 addPrefSpill - Same as addConstraints(PrefSpill)
void addLinks (ArrayRef< unsigned > Links)
 addLinks - Add transparent blocks with the given numbers.
bool scanActiveBundles ()
void iterate ()
ArrayRef< unsignedgetRecentPositive ()
bool finish ()
BlockFrequency getBlockFrequency (unsigned Number) const

Static Public Attributes

static char ID = 0

Detailed Description

Definition at line 43 of file SpillPlacement.h.


Member Enumeration Documentation

BorderConstraint - A basic block has separate constraints for entry and exit.

Enumerator:
DontCare 

Block doesn't care / variable not live.

PrefReg 

Block entry/exit prefers a register.

PrefSpill 

Block entry/exit prefers a stack slot.

PrefBoth 

Block entry prefers both register and stack.

MustSpill 

A register is impossible, variable must be spilled.

Definition at line 73 of file SpillPlacement.h.


Constructor & Destructor Documentation

Definition at line 68 of file SpillPlacement.h.

Definition at line 69 of file SpillPlacement.h.


Member Function Documentation

addConstraints - Add constraints and biases. This method may be called more than once to accumulate constraints.

Parameters:
LiveBlocksConstraints for blocks that have the variable live in or live out.

addConstraints - Compute node biases and weights from a set of constraints. Set a bit in NodeMask for each active node.

Definition at line 250 of file SpillPlacement.cpp.

References llvm::SpillPlacement::Node::addBias(), llvm::ArrayRef< T >::begin(), DontCare, llvm::ArrayRef< T >::end(), llvm::EdgeBundles::getBundle(), I, and llvm::ARM_AM::ib.

void SpillPlacement::addPrefSpill ( ArrayRef< unsigned Blocks,
bool  Strong 
)

addPrefSpill - Same as addConstraints(PrefSpill)

addPrefSpill - Add PrefSpill constraints to all blocks listed. This is equivalent to calling addConstraint with identical BlockConstraints with Entry = Exit = PrefSpill, and ChangesValue = false.

Parameters:
BlocksArray of block numbers that prefer to spill in and out.
StrongWhen true, double the negative bias for these blocks.

Definition at line 272 of file SpillPlacement.cpp.

References llvm::SpillPlacement::Node::addBias(), llvm::ArrayRef< T >::begin(), llvm::ArrayRef< T >::end(), llvm::EdgeBundles::getBundle(), I, llvm::ARM_AM::ib, and PrefSpill.

finish - Compute the optimal spill code placement given the constraints. No MustSpill constraints will be violated, and the smallest possible number of PrefX constraints will be violated, weighted by expected execution frequencies. The selected bundles are returned in the bitvector passed to prepare().

Returns:
True if a perfect solution was found, allowing the variable to be in a register through all relevant bundles.

Definition at line 387 of file SpillPlacement.cpp.

References llvm::BitVector::find_first(), llvm::BitVector::find_next(), and llvm::BitVector::reset().

getBlockFrequency - Return the estimated block execution frequency per function invocation.

Definition at line 145 of file SpillPlacement.h.

getRecentPositive - Return an array of bundles that became positive during the previous call to scanActiveBundles or iterate.

Definition at line 132 of file SpillPlacement.h.

iterate - Update the network iteratively until convergence, or new bundles are found.

iterate - Repeatedly update the Hopfield nodes until stability or the maximum number of iterations is reached.

Parameters:
Linked- Numbers of linked nodes that need updating.

Definition at line 329 of file SpillPlacement.cpp.

References llvm::SmallVectorTemplateCommon< T, typename >::begin(), llvm::SmallVectorBase::empty(), llvm::SmallVectorTemplateCommon< T, typename >::end(), I, llvm::SmallVectorImpl< T >::pop_back_val(), llvm::SmallVectorTemplateBase< T, isPodLike >::push_back(), llvm::SmallVectorTemplateCommon< T, typename >::rbegin(), llvm::SmallVectorTemplateCommon< T, typename >::rend(), and llvm::SpillPlacement::Node::update().

void SpillPlacement::prepare ( BitVector RegBundles)

prepare - Reset state and prepare for a new spill placement computation.

Parameters:
RegBundlesBit vector to receive the edge bundles where the variable should be kept in a register. Each bit corresponds to an edge bundle, a set bit means the variable should be kept in a register through the bundle. A clear bit means the variable should be spilled. This vector is retained.

Definition at line 377 of file SpillPlacement.cpp.

References llvm::BitVector::clear(), llvm::SmallVectorImpl< T >::clear(), llvm::EdgeBundles::getNumBundles(), and llvm::BitVector::resize().

scanActiveBundles - Perform an initial scan of all bundles activated by addConstraints and addLinks, updating their state. Add all the bundles that now prefer a register to RecentPositive. Prepare internal data structures for iterate. Return true is there are any positive nodes.

Definition at line 309 of file SpillPlacement.cpp.

References llvm::SmallVectorImpl< T >::clear(), llvm::SmallVectorBase::empty(), llvm::BitVector::find_first(), llvm::BitVector::find_next(), llvm::SmallVectorTemplateBase< T, isPodLike >::push_back(), and llvm::SpillPlacement::Node::update().


Member Data Documentation

char SpillPlacement::ID = 0 [static]

Definition at line 66 of file SpillPlacement.h.


The documentation for this class was generated from the following files: