1 //===- IntervalPartition.h - Interval partition Calculation -----*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file contains the declaration of the IntervalPartition class, which
11 // calculates and represents the interval partition of a function, or a
12 // preexisting interval partition.
14 // In this way, the interval partition may be used to reduce a flow graph down
15 // to its degenerate single node interval partition (unless it is irreducible).
17 // TODO: The IntervalPartition class should take a bool parameter that tells
18 // whether it should add the "tails" of an interval to an interval itself or if
19 // they should be represented as distinct intervals.
21 //===----------------------------------------------------------------------===//
23 #ifndef LLVM_INTERVAL_PARTITION_H
24 #define LLVM_INTERVAL_PARTITION_H
26 #include "llvm/Analysis/Interval.h"
27 #include "llvm/Pass.h"
31 //===----------------------------------------------------------------------===//
33 // IntervalPartition - This class builds and holds an "interval partition" for
34 // a function. This partition divides the control flow graph into a set of
35 // maximal intervals, as defined with the properties above. Intuitively, a
36 // BasicBlock is a (possibly nonexistent) loop with a "tail" of non looping
37 // nodes following it.
39 class IntervalPartition : public FunctionPass {
40 typedef std::map<BasicBlock*, Interval*> IntervalMapTy;
41 IntervalMapTy IntervalMap;
43 typedef std::vector<Interval*> IntervalListTy;
44 Interval *RootInterval;
45 std::vector<Interval*> Intervals;
48 static char ID; // Pass identification, replacement for typeid
50 IntervalPartition() : FunctionPass((intptr_t)&ID), RootInterval(0) {}
52 /// isAnalysis - Return true if this pass is implementing an analysis pass.
53 virtual bool isAnalysis() const { return true; }
55 // run - Calculate the interval partition for this function
56 virtual bool runOnFunction(Function &F);
58 // IntervalPartition ctor - Build a reduced interval partition from an
59 // existing interval graph. This takes an additional boolean parameter to
60 // distinguish it from a copy constructor. Always pass in false for now.
62 IntervalPartition(IntervalPartition &I, bool);
64 // Destructor - Free memory
65 ~IntervalPartition() { destroy(); }
67 // print - Show contents in human readable format...
68 virtual void print(std::ostream &O, const Module* = 0) const;
69 void print(std::ostream *O, const Module* M = 0) const {
73 // getRootInterval() - Return the root interval that contains the starting
74 // block of the function.
75 inline Interval *getRootInterval() { return RootInterval; }
77 // isDegeneratePartition() - Returns true if the interval partition contains
78 // a single interval, and thus cannot be simplified anymore.
79 bool isDegeneratePartition() { return Intervals.size() == 1; }
81 // TODO: isIrreducible - look for triangle graph.
83 // getBlockInterval - Return the interval that a basic block exists in.
84 inline Interval *getBlockInterval(BasicBlock *BB) {
85 IntervalMapTy::iterator I = IntervalMap.find(BB);
86 return I != IntervalMap.end() ? I->second : 0;
89 // getAnalysisUsage - Implement the Pass API
90 virtual void getAnalysisUsage(AnalysisUsage &AU) const {
94 // Interface to Intervals vector...
95 const std::vector<Interval*> &getIntervals() const { return Intervals; }
98 // destroy - Reset state back to before function was analyzed
101 // addIntervalToPartition - Add an interval to the internal list of intervals,
102 // and then add mappings from all of the basic blocks in the interval to the
103 // interval itself (in the IntervalMap).
105 void addIntervalToPartition(Interval *I);
107 // updatePredecessors - Interval generation only sets the successor fields of
108 // the interval data structures. After interval generation is complete,
109 // run through all of the intervals and propagate successor info as
112 void updatePredecessors(Interval *Int);
115 } // End llvm namespace