Home | History | Annotate | Download | only in Instrumentation
      1 //===- PathProfiling.cpp - Inserts counters for path profiling ------------===//
      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 pass instruments functions for Ball-Larus path profiling.  Ball-Larus
     11 // profiling converts the CFG into a DAG by replacing backedges with edges
     12 // from entry to the start block and from the end block to exit.  The paths
     13 // along the new DAG are enumrated, i.e. each path is given a path number.
     14 // Edges are instrumented to increment the path number register, such that the
     15 // path number register will equal the path number of the path taken at the
     16 // exit.
     17 //
     18 // This file defines classes for building a CFG for use with different stages
     19 // in the Ball-Larus path profiling instrumentation [Ball96].  The
     20 // requirements are formatting the llvm CFG into the Ball-Larus DAG, path
     21 // numbering, finding a spanning tree, moving increments from the spanning
     22 // tree to chords.
     23 //
     24 // Terms:
     25 // DAG            - Directed Acyclic Graph.
     26 // Ball-Larus DAG - A CFG with an entry node, an exit node, and backedges
     27 //                  removed in the following manner.  For every backedge
     28 //                  v->w, insert edge ENTRY->w and edge v->EXIT.
     29 // Path Number    - The number corresponding to a specific path through a
     30 //                  Ball-Larus DAG.
     31 // Spanning Tree  - A subgraph, S, is a spanning tree if S covers all
     32 //                  vertices and is a tree.
     33 // Chord          - An edge not in the spanning tree.
     34 //
     35 // [Ball96]
     36 //  T. Ball and J. R. Larus. "Efficient Path Profiling."
     37 //  International Symposium on Microarchitecture, pages 46-57, 1996.
     38 //  http://portal.acm.org/citation.cfm?id=243857
     39 //
     40 // [Ball94]
     41 //  Thomas Ball.  "Efficiently Counting Program Events with Support for
     42 //  On-line queries."
     43 //  ACM Transactions on Programmmg Languages and Systems, Vol 16, No 5,
     44 //  September 1994, Pages 1399-1410.
     45 //===----------------------------------------------------------------------===//
     46 #define DEBUG_TYPE "insert-path-profiling"
     47 
     48 #include "llvm/DerivedTypes.h"
     49 #include "ProfilingUtils.h"
     50 #include "llvm/Analysis/PathNumbering.h"
     51 #include "llvm/Constants.h"
     52 #include "llvm/DerivedTypes.h"
     53 #include "llvm/InstrTypes.h"
     54 #include "llvm/Instructions.h"
     55 #include "llvm/LLVMContext.h"
     56 #include "llvm/Module.h"
     57 #include "llvm/Pass.h"
     58 #include "llvm/Support/Compiler.h"
     59 #include "llvm/Support/CFG.h"
     60 #include "llvm/Support/CommandLine.h"
     61 #include "llvm/Support/Debug.h"
     62 #include "llvm/Support/TypeBuilder.h"
     63 #include "llvm/Support/raw_ostream.h"
     64 #include "llvm/Transforms/Utils/BasicBlockUtils.h"
     65 #include "llvm/Transforms/Instrumentation.h"
     66 #include <vector>
     67 
     68 #define HASH_THRESHHOLD 100000
     69 
     70 using namespace llvm;
     71 
     72 namespace {
     73 class BLInstrumentationNode;
     74 class BLInstrumentationEdge;
     75 class BLInstrumentationDag;
     76 
     77 // ---------------------------------------------------------------------------
     78 // BLInstrumentationNode extends BallLarusNode with member used by the
     79 // instrumentation algortihms.
     80 // ---------------------------------------------------------------------------
     81 class BLInstrumentationNode : public BallLarusNode {
     82 public:
     83   // Creates a new BLInstrumentationNode from a BasicBlock.
     84   BLInstrumentationNode(BasicBlock* BB);
     85 
     86   // Get/sets the Value corresponding to the pathNumber register,
     87   // constant or phinode.  Used by the instrumentation code to remember
     88   // path number Values.
     89   Value* getStartingPathNumber();
     90   void setStartingPathNumber(Value* pathNumber);
     91 
     92   Value* getEndingPathNumber();
     93   void setEndingPathNumber(Value* pathNumber);
     94 
     95   // Get/set the PHINode Instruction for this node.
     96   PHINode* getPathPHI();
     97   void setPathPHI(PHINode* pathPHI);
     98 
     99 private:
    100 
    101   Value* _startingPathNumber; // The Value for the current pathNumber.
    102   Value* _endingPathNumber; // The Value for the current pathNumber.
    103   PHINode* _pathPHI; // The PHINode for current pathNumber.
    104 };
    105 
    106 // --------------------------------------------------------------------------
    107 // BLInstrumentationEdge extends BallLarusEdge with data about the
    108 // instrumentation that will end up on each edge.
    109 // --------------------------------------------------------------------------
    110 class BLInstrumentationEdge : public BallLarusEdge {
    111 public:
    112   BLInstrumentationEdge(BLInstrumentationNode* source,
    113                         BLInstrumentationNode* target);
    114 
    115   // Sets the target node of this edge.  Required to split edges.
    116   void setTarget(BallLarusNode* node);
    117 
    118   // Get/set whether edge is in the spanning tree.
    119   bool isInSpanningTree() const;
    120   void setIsInSpanningTree(bool isInSpanningTree);
    121 
    122   // Get/ set whether this edge will be instrumented with a path number
    123   // initialization.
    124   bool isInitialization() const;
    125   void setIsInitialization(bool isInitialization);
    126 
    127   // Get/set whether this edge will be instrumented with a path counter
    128   // increment.  Notice this is incrementing the path counter
    129   // corresponding to the path number register.  The path number
    130   // increment is determined by getIncrement().
    131   bool isCounterIncrement() const;
    132   void setIsCounterIncrement(bool isCounterIncrement);
    133 
    134   // Get/set the path number increment that this edge will be instrumented
    135   // with.  This is distinct from the path counter increment and the
    136   // weight.  The counter increment counts the number of executions of
    137   // some path, whereas the path number keeps track of which path number
    138   // the program is on.
    139   long getIncrement() const;
    140   void setIncrement(long increment);
    141 
    142   // Get/set whether the edge has been instrumented.
    143   bool hasInstrumentation();
    144   void setHasInstrumentation(bool hasInstrumentation);
    145 
    146   // Returns the successor number of this edge in the source.
    147   unsigned getSuccessorNumber();
    148 
    149 private:
    150   // The increment that the code will be instrumented with.
    151   long long _increment;
    152 
    153   // Whether this edge is in the spanning tree.
    154   bool _isInSpanningTree;
    155 
    156   // Whether this edge is an initialiation of the path number.
    157   bool _isInitialization;
    158 
    159   // Whether this edge is a path counter increment.
    160   bool _isCounterIncrement;
    161 
    162   // Whether this edge has been instrumented.
    163   bool _hasInstrumentation;
    164 };
    165 
    166 // ---------------------------------------------------------------------------
    167 // BLInstrumentationDag extends BallLarusDag with algorithms that
    168 // determine where instrumentation should be placed.
    169 // ---------------------------------------------------------------------------
    170 class BLInstrumentationDag : public BallLarusDag {
    171 public:
    172   BLInstrumentationDag(Function &F);
    173 
    174   // Returns the Exit->Root edge. This edge is required for creating
    175   // directed cycles in the algorithm for moving instrumentation off of
    176   // the spanning tree
    177   BallLarusEdge* getExitRootEdge();
    178 
    179   // Returns an array of phony edges which mark those nodes
    180   // with function calls
    181   BLEdgeVector getCallPhonyEdges();
    182 
    183   // Gets/sets the path counter array
    184   GlobalVariable* getCounterArray();
    185   void setCounterArray(GlobalVariable* c);
    186 
    187   // Calculates the increments for the chords, thereby removing
    188   // instrumentation from the spanning tree edges. Implementation is based
    189   // on the algorithm in Figure 4 of [Ball94]
    190   void calculateChordIncrements();
    191 
    192   // Updates the state when an edge has been split
    193   void splitUpdate(BLInstrumentationEdge* formerEdge, BasicBlock* newBlock);
    194 
    195   // Calculates a spanning tree of the DAG ignoring cycles.  Whichever
    196   // edges are in the spanning tree will not be instrumented, but this
    197   // implementation does not try to minimize the instrumentation overhead
    198   // by trying to find hot edges.
    199   void calculateSpanningTree();
    200 
    201   // Pushes initialization further down in order to group the first
    202   // increment and initialization.
    203   void pushInitialization();
    204 
    205   // Pushes the path counter increments up in order to group the last path
    206   // number increment.
    207   void pushCounters();
    208 
    209   // Removes phony edges from the successor list of the source, and the
    210   // predecessor list of the target.
    211   void unlinkPhony();
    212 
    213   // Generate dot graph for the function
    214   void generateDotGraph();
    215 
    216 protected:
    217   // BLInstrumentationDag creates BLInstrumentationNode objects in this
    218   // method overriding the creation of BallLarusNode objects.
    219   //
    220   // Allows subclasses to determine which type of Node is created.
    221   // Override this method to produce subclasses of BallLarusNode if
    222   // necessary.
    223   virtual BallLarusNode* createNode(BasicBlock* BB);
    224 
    225   // BLInstrumentationDag create BLInstrumentationEdges.
    226   //
    227   // Allows subclasses to determine which type of Edge is created.
    228   // Override this method to produce subclasses of BallLarusEdge if
    229   // necessary.  Parameters source and target will have been created by
    230   // createNode and can be cast to the subclass of BallLarusNode*
    231   // returned by createNode.
    232   virtual BallLarusEdge* createEdge(
    233     BallLarusNode* source, BallLarusNode* target, unsigned edgeNumber);
    234 
    235 private:
    236   BLEdgeVector _treeEdges; // All edges in the spanning tree.
    237   BLEdgeVector _chordEdges; // All edges not in the spanning tree.
    238   GlobalVariable* _counterArray; // Array to store path counters
    239 
    240   // Removes the edge from the appropriate predecessor and successor lists.
    241   void unlinkEdge(BallLarusEdge* edge);
    242 
    243   // Makes an edge part of the spanning tree.
    244   void makeEdgeSpanning(BLInstrumentationEdge* edge);
    245 
    246   // Pushes initialization and calls itself recursively.
    247   void pushInitializationFromEdge(BLInstrumentationEdge* edge);
    248 
    249   // Pushes path counter increments up recursively.
    250   void pushCountersFromEdge(BLInstrumentationEdge* edge);
    251 
    252   // Depth first algorithm for determining the chord increments.f
    253   void calculateChordIncrementsDfs(
    254     long weight, BallLarusNode* v, BallLarusEdge* e);
    255 
    256   // Determines the relative direction of two edges.
    257   int calculateChordIncrementsDir(BallLarusEdge* e, BallLarusEdge* f);
    258 };
    259 
    260 // ---------------------------------------------------------------------------
    261 // PathProfiler is a module pass which instruments path profiling instructions
    262 // ---------------------------------------------------------------------------
    263 class PathProfiler : public ModulePass {
    264 private:
    265   // Current context for multi threading support.
    266   LLVMContext* Context;
    267 
    268   // Which function are we currently instrumenting
    269   unsigned currentFunctionNumber;
    270 
    271   // The function prototype in the profiling runtime for incrementing a
    272   // single path counter in a hash table.
    273   Constant* llvmIncrementHashFunction;
    274   Constant* llvmDecrementHashFunction;
    275 
    276   // Instruments each function with path profiling.  'main' is instrumented
    277   // with code to save the profile to disk.
    278   bool runOnModule(Module &M);
    279 
    280   // Analyzes the function for Ball-Larus path profiling, and inserts code.
    281   void runOnFunction(std::vector<Constant*> &ftInit, Function &F, Module &M);
    282 
    283   // Creates an increment constant representing incr.
    284   ConstantInt* createIncrementConstant(long incr, int bitsize);
    285 
    286   // Creates an increment constant representing the value in
    287   // edge->getIncrement().
    288   ConstantInt* createIncrementConstant(BLInstrumentationEdge* edge);
    289 
    290   // Finds the insertion point after pathNumber in block.  PathNumber may
    291   // be NULL.
    292   BasicBlock::iterator getInsertionPoint(
    293     BasicBlock* block, Value* pathNumber);
    294 
    295   // Inserts source's pathNumber Value* into target.  Target may or may not
    296   // have multiple predecessors, and may or may not have its phiNode
    297   // initalized.
    298   void pushValueIntoNode(
    299     BLInstrumentationNode* source, BLInstrumentationNode* target);
    300 
    301   // Inserts source's pathNumber Value* into the appropriate slot of
    302   // target's phiNode.
    303   void pushValueIntoPHI(
    304     BLInstrumentationNode* target, BLInstrumentationNode* source);
    305 
    306   // The Value* in node, oldVal,  is updated with a Value* correspodning to
    307   // oldVal + addition.
    308   void insertNumberIncrement(BLInstrumentationNode* node, Value* addition,
    309                              bool atBeginning);
    310 
    311   // Creates a counter increment in the given node.  The Value* in node is
    312   // taken as the index into a hash table.
    313   void insertCounterIncrement(
    314     Value* incValue,
    315     BasicBlock::iterator insertPoint,
    316     BLInstrumentationDag* dag,
    317     bool increment = true);
    318 
    319   // A PHINode is created in the node, and its values initialized to -1U.
    320   void preparePHI(BLInstrumentationNode* node);
    321 
    322   // Inserts instrumentation for the given edge
    323   //
    324   // Pre: The edge's source node has pathNumber set if edge is non zero
    325   // path number increment.
    326   //
    327   // Post: Edge's target node has a pathNumber set to the path number Value
    328   // corresponding to the value of the path register after edge's
    329   // execution.
    330   void insertInstrumentationStartingAt(
    331     BLInstrumentationEdge* edge,
    332     BLInstrumentationDag* dag);
    333 
    334   // If this edge is a critical edge, then inserts a node at this edge.
    335   // This edge becomes the first edge, and a new BallLarusEdge is created.
    336   bool splitCritical(BLInstrumentationEdge* edge, BLInstrumentationDag* dag);
    337 
    338   // Inserts instrumentation according to the marked edges in dag.  Phony
    339   // edges must be unlinked from the DAG, but accessible from the
    340   // backedges.  Dag must have initializations, path number increments, and
    341   // counter increments present.
    342   //
    343   // Counter storage is created here.
    344   void insertInstrumentation( BLInstrumentationDag& dag, Module &M);
    345 
    346 public:
    347   static char ID; // Pass identification, replacement for typeid
    348   PathProfiler() : ModulePass(ID) {
    349     initializePathProfilerPass(*PassRegistry::getPassRegistry());
    350   }
    351 
    352   virtual const char *getPassName() const {
    353     return "Path Profiler";
    354   }
    355 };
    356 } // end anonymous namespace
    357 
    358 // Should we print the dot-graphs
    359 static cl::opt<bool> DotPathDag("path-profile-pathdag", cl::Hidden,
    360         cl::desc("Output the path profiling DAG for each function."));
    361 
    362 // Register the path profiler as a pass
    363 char PathProfiler::ID = 0;
    364 INITIALIZE_PASS(PathProfiler, "insert-path-profiling",
    365                 "Insert instrumentation for Ball-Larus path profiling",
    366                 false, false)
    367 
    368 ModulePass *llvm::createPathProfilerPass() { return new PathProfiler(); }
    369 
    370 namespace llvm {
    371   class PathProfilingFunctionTable {};
    372 
    373   // Type for global array storing references to hashes or arrays
    374   template<bool xcompile> class TypeBuilder<PathProfilingFunctionTable,
    375                                             xcompile> {
    376   public:
    377     static StructType *get(LLVMContext& C) {
    378       return( StructType::get(
    379                 TypeBuilder<types::i<32>, xcompile>::get(C), // type
    380                 TypeBuilder<types::i<32>, xcompile>::get(C), // array size
    381                 TypeBuilder<types::i<8>*, xcompile>::get(C), // array/hash ptr
    382                 NULL));
    383     }
    384   };
    385 
    386   typedef TypeBuilder<PathProfilingFunctionTable, true>
    387   ftEntryTypeBuilder;
    388 
    389   // BallLarusEdge << operator overloading
    390   raw_ostream& operator<<(raw_ostream& os,
    391                           const BLInstrumentationEdge& edge)
    392       LLVM_ATTRIBUTE_USED;
    393   raw_ostream& operator<<(raw_ostream& os,
    394                           const BLInstrumentationEdge& edge) {
    395     os << "[" << edge.getSource()->getName() << " -> "
    396        << edge.getTarget()->getName() << "] init: "
    397        << (edge.isInitialization() ? "yes" : "no")
    398        << " incr:" << edge.getIncrement() << " cinc: "
    399        << (edge.isCounterIncrement() ? "yes" : "no");
    400     return(os);
    401   }
    402 }
    403 
    404 // Creates a new BLInstrumentationNode from a BasicBlock.
    405 BLInstrumentationNode::BLInstrumentationNode(BasicBlock* BB) :
    406   BallLarusNode(BB),
    407   _startingPathNumber(NULL), _endingPathNumber(NULL), _pathPHI(NULL) {}
    408 
    409 // Constructor for BLInstrumentationEdge.
    410 BLInstrumentationEdge::BLInstrumentationEdge(BLInstrumentationNode* source,
    411                                              BLInstrumentationNode* target)
    412   : BallLarusEdge(source, target, 0),
    413     _increment(0), _isInSpanningTree(false), _isInitialization(false),
    414     _isCounterIncrement(false), _hasInstrumentation(false) {}
    415 
    416 // Sets the target node of this edge.  Required to split edges.
    417 void BLInstrumentationEdge::setTarget(BallLarusNode* node) {
    418   _target = node;
    419 }
    420 
    421 // Returns whether this edge is in the spanning tree.
    422 bool BLInstrumentationEdge::isInSpanningTree() const {
    423   return(_isInSpanningTree);
    424 }
    425 
    426 // Sets whether this edge is in the spanning tree.
    427 void BLInstrumentationEdge::setIsInSpanningTree(bool isInSpanningTree) {
    428   _isInSpanningTree = isInSpanningTree;
    429 }
    430 
    431 // Returns whether this edge will be instrumented with a path number
    432 // initialization.
    433 bool BLInstrumentationEdge::isInitialization() const {
    434   return(_isInitialization);
    435 }
    436 
    437 // Sets whether this edge will be instrumented with a path number
    438 // initialization.
    439 void BLInstrumentationEdge::setIsInitialization(bool isInitialization) {
    440   _isInitialization = isInitialization;
    441 }
    442 
    443 // Returns whether this edge will be instrumented with a path counter
    444 // increment.  Notice this is incrementing the path counter
    445 // corresponding to the path number register.  The path number
    446 // increment is determined by getIncrement().
    447 bool BLInstrumentationEdge::isCounterIncrement() const {
    448   return(_isCounterIncrement);
    449 }
    450 
    451 // Sets whether this edge will be instrumented with a path counter
    452 // increment.
    453 void BLInstrumentationEdge::setIsCounterIncrement(bool isCounterIncrement) {
    454   _isCounterIncrement = isCounterIncrement;
    455 }
    456 
    457 // Gets the path number increment that this edge will be instrumented
    458 // with.  This is distinct from the path counter increment and the
    459 // weight.  The counter increment is counts the number of executions of
    460 // some path, whereas the path number keeps track of which path number
    461 // the program is on.
    462 long BLInstrumentationEdge::getIncrement() const {
    463   return(_increment);
    464 }
    465 
    466 // Set whether this edge will be instrumented with a path number
    467 // increment.
    468 void BLInstrumentationEdge::setIncrement(long increment) {
    469   _increment = increment;
    470 }
    471 
    472 // True iff the edge has already been instrumented.
    473 bool BLInstrumentationEdge::hasInstrumentation() {
    474   return(_hasInstrumentation);
    475 }
    476 
    477 // Set whether this edge has been instrumented.
    478 void BLInstrumentationEdge::setHasInstrumentation(bool hasInstrumentation) {
    479   _hasInstrumentation = hasInstrumentation;
    480 }
    481 
    482 // Returns the successor number of this edge in the source.
    483 unsigned BLInstrumentationEdge::getSuccessorNumber() {
    484   BallLarusNode* sourceNode = getSource();
    485   BallLarusNode* targetNode = getTarget();
    486   BasicBlock* source = sourceNode->getBlock();
    487   BasicBlock* target = targetNode->getBlock();
    488 
    489   if(source == NULL || target == NULL)
    490     return(0);
    491 
    492   TerminatorInst* terminator = source->getTerminator();
    493 
    494         unsigned i;
    495   for(i=0; i < terminator->getNumSuccessors(); i++) {
    496     if(terminator->getSuccessor(i) == target)
    497       break;
    498   }
    499 
    500   return(i);
    501 }
    502 
    503 // BLInstrumentationDag constructor initializes a DAG for the given Function.
    504 BLInstrumentationDag::BLInstrumentationDag(Function &F) : BallLarusDag(F),
    505                                                           _counterArray(0) {
    506 }
    507 
    508 // Returns the Exit->Root edge. This edge is required for creating
    509 // directed cycles in the algorithm for moving instrumentation off of
    510 // the spanning tree
    511 BallLarusEdge* BLInstrumentationDag::getExitRootEdge() {
    512   BLEdgeIterator erEdge = getExit()->succBegin();
    513   return(*erEdge);
    514 }
    515 
    516 BLEdgeVector BLInstrumentationDag::getCallPhonyEdges () {
    517   BLEdgeVector callEdges;
    518 
    519   for( BLEdgeIterator edge = _edges.begin(), end = _edges.end();
    520        edge != end; edge++ ) {
    521     if( (*edge)->getType() == BallLarusEdge::CALLEDGE_PHONY )
    522       callEdges.push_back(*edge);
    523   }
    524 
    525   return callEdges;
    526 }
    527 
    528 // Gets the path counter array
    529 GlobalVariable* BLInstrumentationDag::getCounterArray() {
    530   return _counterArray;
    531 }
    532 
    533 void BLInstrumentationDag::setCounterArray(GlobalVariable* c) {
    534   _counterArray = c;
    535 }
    536 
    537 // Calculates the increment for the chords, thereby removing
    538 // instrumentation from the spanning tree edges. Implementation is based on
    539 // the algorithm in Figure 4 of [Ball94]
    540 void BLInstrumentationDag::calculateChordIncrements() {
    541   calculateChordIncrementsDfs(0, getRoot(), NULL);
    542 
    543   BLInstrumentationEdge* chord;
    544   for(BLEdgeIterator chordEdge = _chordEdges.begin(),
    545       end = _chordEdges.end(); chordEdge != end; chordEdge++) {
    546     chord = (BLInstrumentationEdge*) *chordEdge;
    547     chord->setIncrement(chord->getIncrement() + chord->getWeight());
    548   }
    549 }
    550 
    551 // Updates the state when an edge has been split
    552 void BLInstrumentationDag::splitUpdate(BLInstrumentationEdge* formerEdge,
    553                                        BasicBlock* newBlock) {
    554   BallLarusNode* oldTarget = formerEdge->getTarget();
    555   BallLarusNode* newNode = addNode(newBlock);
    556   formerEdge->setTarget(newNode);
    557   newNode->addPredEdge(formerEdge);
    558 
    559   DEBUG(dbgs() << "  Edge split: " << *formerEdge << "\n");
    560 
    561   oldTarget->removePredEdge(formerEdge);
    562   BallLarusEdge* newEdge = addEdge(newNode, oldTarget,0);
    563 
    564   if( formerEdge->getType() == BallLarusEdge::BACKEDGE ||
    565                         formerEdge->getType() == BallLarusEdge::SPLITEDGE) {
    566                 newEdge->setType(formerEdge->getType());
    567     newEdge->setPhonyRoot(formerEdge->getPhonyRoot());
    568     newEdge->setPhonyExit(formerEdge->getPhonyExit());
    569     formerEdge->setType(BallLarusEdge::NORMAL);
    570                 formerEdge->setPhonyRoot(NULL);
    571     formerEdge->setPhonyExit(NULL);
    572   }
    573 }
    574 
    575 // Calculates a spanning tree of the DAG ignoring cycles.  Whichever
    576 // edges are in the spanning tree will not be instrumented, but this
    577 // implementation does not try to minimize the instrumentation overhead
    578 // by trying to find hot edges.
    579 void BLInstrumentationDag::calculateSpanningTree() {
    580   std::stack<BallLarusNode*> dfsStack;
    581 
    582   for(BLNodeIterator nodeIt = _nodes.begin(), end = _nodes.end();
    583       nodeIt != end; nodeIt++) {
    584     (*nodeIt)->setColor(BallLarusNode::WHITE);
    585   }
    586 
    587   dfsStack.push(getRoot());
    588   while(dfsStack.size() > 0) {
    589     BallLarusNode* node = dfsStack.top();
    590     dfsStack.pop();
    591 
    592     if(node->getColor() == BallLarusNode::WHITE)
    593       continue;
    594 
    595     BallLarusNode* nextNode;
    596     bool forward = true;
    597     BLEdgeIterator succEnd = node->succEnd();
    598 
    599     node->setColor(BallLarusNode::WHITE);
    600     // first iterate over successors then predecessors
    601     for(BLEdgeIterator edge = node->succBegin(), predEnd = node->predEnd();
    602         edge != predEnd; edge++) {
    603       if(edge == succEnd) {
    604         edge = node->predBegin();
    605         forward = false;
    606       }
    607 
    608       // Ignore split edges
    609       if ((*edge)->getType() == BallLarusEdge::SPLITEDGE)
    610         continue;
    611 
    612       nextNode = forward? (*edge)->getTarget(): (*edge)->getSource();
    613       if(nextNode->getColor() != BallLarusNode::WHITE) {
    614         nextNode->setColor(BallLarusNode::WHITE);
    615         makeEdgeSpanning((BLInstrumentationEdge*)(*edge));
    616       }
    617     }
    618   }
    619 
    620   for(BLEdgeIterator edge = _edges.begin(), end = _edges.end();
    621       edge != end; edge++) {
    622     BLInstrumentationEdge* instEdge = (BLInstrumentationEdge*) (*edge);
    623       // safe since createEdge is overriden
    624     if(!instEdge->isInSpanningTree() && (*edge)->getType()
    625         != BallLarusEdge::SPLITEDGE)
    626       _chordEdges.push_back(instEdge);
    627   }
    628 }
    629 
    630 // Pushes initialization further down in order to group the first
    631 // increment and initialization.
    632 void BLInstrumentationDag::pushInitialization() {
    633   BLInstrumentationEdge* exitRootEdge =
    634                 (BLInstrumentationEdge*) getExitRootEdge();
    635   exitRootEdge->setIsInitialization(true);
    636   pushInitializationFromEdge(exitRootEdge);
    637 }
    638 
    639 // Pushes the path counter increments up in order to group the last path
    640 // number increment.
    641 void BLInstrumentationDag::pushCounters() {
    642   BLInstrumentationEdge* exitRootEdge =
    643     (BLInstrumentationEdge*) getExitRootEdge();
    644   exitRootEdge->setIsCounterIncrement(true);
    645   pushCountersFromEdge(exitRootEdge);
    646 }
    647 
    648 // Removes phony edges from the successor list of the source, and the
    649 // predecessor list of the target.
    650 void BLInstrumentationDag::unlinkPhony() {
    651   BallLarusEdge* edge;
    652 
    653   for(BLEdgeIterator next = _edges.begin(),
    654       end = _edges.end(); next != end; next++) {
    655     edge = (*next);
    656 
    657     if( edge->getType() == BallLarusEdge::BACKEDGE_PHONY ||
    658         edge->getType() == BallLarusEdge::SPLITEDGE_PHONY ||
    659         edge->getType() == BallLarusEdge::CALLEDGE_PHONY ) {
    660       unlinkEdge(edge);
    661     }
    662   }
    663 }
    664 
    665 // Generate a .dot graph to represent the DAG and pathNumbers
    666 void BLInstrumentationDag::generateDotGraph() {
    667   std::string errorInfo;
    668   std::string functionName = getFunction().getNameStr();
    669   std::string filename = "pathdag." + functionName + ".dot";
    670 
    671   DEBUG (dbgs() << "Writing '" << filename << "'...\n");
    672   raw_fd_ostream dotFile(filename.c_str(), errorInfo);
    673 
    674   if (!errorInfo.empty()) {
    675     errs() << "Error opening '" << filename.c_str() <<"' for writing!";
    676     errs() << "\n";
    677     return;
    678   }
    679 
    680   dotFile << "digraph " << functionName << " {\n";
    681 
    682   for( BLEdgeIterator edge = _edges.begin(), end = _edges.end();
    683        edge != end; edge++) {
    684     std::string sourceName = (*edge)->getSource()->getName();
    685     std::string targetName = (*edge)->getTarget()->getName();
    686 
    687     dotFile << "\t\"" << sourceName.c_str() << "\" -> \""
    688             << targetName.c_str() << "\" ";
    689 
    690     long inc = ((BLInstrumentationEdge*)(*edge))->getIncrement();
    691 
    692     switch( (*edge)->getType() ) {
    693     case BallLarusEdge::NORMAL:
    694       dotFile << "[label=" << inc << "] [color=black];\n";
    695       break;
    696 
    697     case BallLarusEdge::BACKEDGE:
    698       dotFile << "[color=cyan];\n";
    699       break;
    700 
    701     case BallLarusEdge::BACKEDGE_PHONY:
    702       dotFile << "[label=" << inc
    703               << "] [color=blue];\n";
    704       break;
    705 
    706     case BallLarusEdge::SPLITEDGE:
    707       dotFile << "[color=violet];\n";
    708       break;
    709 
    710     case BallLarusEdge::SPLITEDGE_PHONY:
    711       dotFile << "[label=" << inc << "] [color=red];\n";
    712       break;
    713 
    714     case BallLarusEdge::CALLEDGE_PHONY:
    715       dotFile << "[label=" << inc     << "] [color=green];\n";
    716       break;
    717     }
    718   }
    719 
    720   dotFile << "}\n";
    721 }
    722 
    723 // Allows subclasses to determine which type of Node is created.
    724 // Override this method to produce subclasses of BallLarusNode if
    725 // necessary. The destructor of BallLarusDag will call free on each pointer
    726 // created.
    727 BallLarusNode* BLInstrumentationDag::createNode(BasicBlock* BB) {
    728   return( new BLInstrumentationNode(BB) );
    729 }
    730 
    731 // Allows subclasses to determine which type of Edge is created.
    732 // Override this method to produce subclasses of BallLarusEdge if
    733 // necessary. The destructor of BallLarusDag will call free on each pointer
    734 // created.
    735 BallLarusEdge* BLInstrumentationDag::createEdge(BallLarusNode* source,
    736                                                 BallLarusNode* target, unsigned edgeNumber) {
    737   // One can cast from BallLarusNode to BLInstrumentationNode since createNode
    738   // is overriden to produce BLInstrumentationNode.
    739   return( new BLInstrumentationEdge((BLInstrumentationNode*)source,
    740                                     (BLInstrumentationNode*)target) );
    741 }
    742 
    743 // Sets the Value corresponding to the pathNumber register, constant,
    744 // or phinode.  Used by the instrumentation code to remember path
    745 // number Values.
    746 Value* BLInstrumentationNode::getStartingPathNumber(){
    747   return(_startingPathNumber);
    748 }
    749 
    750 // Sets the Value of the pathNumber.  Used by the instrumentation code.
    751 void BLInstrumentationNode::setStartingPathNumber(Value* pathNumber) {
    752   DEBUG(dbgs() << "  SPN-" << getName() << " <-- " << (pathNumber ?
    753                                                        pathNumber->getNameStr() : "unused") << "\n");
    754   _startingPathNumber = pathNumber;
    755 }
    756 
    757 Value* BLInstrumentationNode::getEndingPathNumber(){
    758   return(_endingPathNumber);
    759 }
    760 
    761 void BLInstrumentationNode::setEndingPathNumber(Value* pathNumber) {
    762   DEBUG(dbgs() << "  EPN-" << getName() << " <-- "
    763         << (pathNumber ? pathNumber->getNameStr() : "unused") << "\n");
    764   _endingPathNumber = pathNumber;
    765 }
    766 
    767 // Get the PHINode Instruction for this node.  Used by instrumentation
    768 // code.
    769 PHINode* BLInstrumentationNode::getPathPHI() {
    770   return(_pathPHI);
    771 }
    772 
    773 // Set the PHINode Instruction for this node.  Used by instrumentation
    774 // code.
    775 void BLInstrumentationNode::setPathPHI(PHINode* pathPHI) {
    776   _pathPHI = pathPHI;
    777 }
    778 
    779 // Removes the edge from the appropriate predecessor and successor
    780 // lists.
    781 void BLInstrumentationDag::unlinkEdge(BallLarusEdge* edge) {
    782   if(edge == getExitRootEdge())
    783     DEBUG(dbgs() << " Removing exit->root edge\n");
    784 
    785   edge->getSource()->removeSuccEdge(edge);
    786   edge->getTarget()->removePredEdge(edge);
    787 }
    788 
    789 // Makes an edge part of the spanning tree.
    790 void BLInstrumentationDag::makeEdgeSpanning(BLInstrumentationEdge* edge) {
    791   edge->setIsInSpanningTree(true);
    792   _treeEdges.push_back(edge);
    793 }
    794 
    795 // Pushes initialization and calls itself recursively.
    796 void BLInstrumentationDag::pushInitializationFromEdge(
    797   BLInstrumentationEdge* edge) {
    798   BallLarusNode* target;
    799 
    800   target = edge->getTarget();
    801   if( target->getNumberPredEdges() > 1 || target == getExit() ) {
    802     return;
    803   } else {
    804     for(BLEdgeIterator next = target->succBegin(),
    805           end = target->succEnd(); next != end; next++) {
    806       BLInstrumentationEdge* intoEdge = (BLInstrumentationEdge*) *next;
    807 
    808       // Skip split edges
    809       if (intoEdge->getType() == BallLarusEdge::SPLITEDGE)
    810         continue;
    811 
    812       intoEdge->setIncrement(intoEdge->getIncrement() +
    813                              edge->getIncrement());
    814       intoEdge->setIsInitialization(true);
    815       pushInitializationFromEdge(intoEdge);
    816     }
    817 
    818     edge->setIncrement(0);
    819     edge->setIsInitialization(false);
    820   }
    821 }
    822 
    823 // Pushes path counter increments up recursively.
    824 void BLInstrumentationDag::pushCountersFromEdge(BLInstrumentationEdge* edge) {
    825   BallLarusNode* source;
    826 
    827   source = edge->getSource();
    828   if(source->getNumberSuccEdges() > 1 || source == getRoot()
    829      || edge->isInitialization()) {
    830     return;
    831   } else {
    832     for(BLEdgeIterator previous = source->predBegin(),
    833           end = source->predEnd(); previous != end; previous++) {
    834       BLInstrumentationEdge* fromEdge = (BLInstrumentationEdge*) *previous;
    835 
    836       // Skip split edges
    837       if (fromEdge->getType() == BallLarusEdge::SPLITEDGE)
    838         continue;
    839 
    840       fromEdge->setIncrement(fromEdge->getIncrement() +
    841                              edge->getIncrement());
    842       fromEdge->setIsCounterIncrement(true);
    843       pushCountersFromEdge(fromEdge);
    844     }
    845 
    846     edge->setIncrement(0);
    847     edge->setIsCounterIncrement(false);
    848   }
    849 }
    850 
    851 // Depth first algorithm for determining the chord increments.
    852 void BLInstrumentationDag::calculateChordIncrementsDfs(long weight,
    853                                                        BallLarusNode* v, BallLarusEdge* e) {
    854   BLInstrumentationEdge* f;
    855 
    856   for(BLEdgeIterator treeEdge = _treeEdges.begin(),
    857         end = _treeEdges.end(); treeEdge != end; treeEdge++) {
    858     f = (BLInstrumentationEdge*) *treeEdge;
    859     if(e != f && v == f->getTarget()) {
    860       calculateChordIncrementsDfs(
    861         calculateChordIncrementsDir(e,f)*(weight) +
    862         f->getWeight(), f->getSource(), f);
    863     }
    864     if(e != f && v == f->getSource()) {
    865       calculateChordIncrementsDfs(
    866         calculateChordIncrementsDir(e,f)*(weight) +
    867         f->getWeight(), f->getTarget(), f);
    868     }
    869   }
    870 
    871   for(BLEdgeIterator chordEdge = _chordEdges.begin(),
    872         end = _chordEdges.end(); chordEdge != end; chordEdge++) {
    873     f = (BLInstrumentationEdge*) *chordEdge;
    874     if(v == f->getSource() || v == f->getTarget()) {
    875       f->setIncrement(f->getIncrement() +
    876                       calculateChordIncrementsDir(e,f)*weight);
    877     }
    878   }
    879 }
    880 
    881 // Determines the relative direction of two edges.
    882 int BLInstrumentationDag::calculateChordIncrementsDir(BallLarusEdge* e,
    883                                                       BallLarusEdge* f) {
    884   if( e == NULL)
    885     return(1);
    886   else if(e->getSource() == f->getTarget()
    887           || e->getTarget() == f->getSource())
    888     return(1);
    889 
    890   return(-1);
    891 }
    892 
    893 // Creates an increment constant representing incr.
    894 ConstantInt* PathProfiler::createIncrementConstant(long incr,
    895                                                    int bitsize) {
    896   return(ConstantInt::get(IntegerType::get(*Context, 32), incr));
    897 }
    898 
    899 // Creates an increment constant representing the value in
    900 // edge->getIncrement().
    901 ConstantInt* PathProfiler::createIncrementConstant(
    902   BLInstrumentationEdge* edge) {
    903   return(createIncrementConstant(edge->getIncrement(), 32));
    904 }
    905 
    906 // Finds the insertion point after pathNumber in block.  PathNumber may
    907 // be NULL.
    908 BasicBlock::iterator PathProfiler::getInsertionPoint(BasicBlock* block, Value*
    909                                                      pathNumber) {
    910   if(pathNumber == NULL || isa<ConstantInt>(pathNumber)
    911      || (((Instruction*)(pathNumber))->getParent()) != block) {
    912     return(block->getFirstNonPHI());
    913   } else {
    914     Instruction* pathNumberInst = (Instruction*) (pathNumber);
    915     BasicBlock::iterator insertPoint;
    916     BasicBlock::iterator end = block->end();
    917 
    918     for(insertPoint = block->begin();
    919         insertPoint != end; insertPoint++) {
    920       Instruction* insertInst = &(*insertPoint);
    921 
    922       if(insertInst == pathNumberInst)
    923         return(++insertPoint);
    924     }
    925 
    926     return(insertPoint);
    927   }
    928 }
    929 
    930 // A PHINode is created in the node, and its values initialized to -1U.
    931 void PathProfiler::preparePHI(BLInstrumentationNode* node) {
    932   BasicBlock* block = node->getBlock();
    933   BasicBlock::iterator insertPoint = block->getFirstNonPHI();
    934   pred_iterator PB = pred_begin(node->getBlock()),
    935           PE = pred_end(node->getBlock());
    936   PHINode* phi = PHINode::Create(Type::getInt32Ty(*Context),
    937                                  std::distance(PB, PE), "pathNumber",
    938                                  insertPoint );
    939   node->setPathPHI(phi);
    940   node->setStartingPathNumber(phi);
    941   node->setEndingPathNumber(phi);
    942 
    943   for(pred_iterator predIt = PB; predIt != PE; predIt++) {
    944     BasicBlock* pred = (*predIt);
    945 
    946     if(pred != NULL)
    947       phi->addIncoming(createIncrementConstant((long)-1, 32), pred);
    948   }
    949 }
    950 
    951 // Inserts source's pathNumber Value* into target.  Target may or may not
    952 // have multiple predecessors, and may or may not have its phiNode
    953 // initalized.
    954 void PathProfiler::pushValueIntoNode(BLInstrumentationNode* source,
    955                                      BLInstrumentationNode* target) {
    956   if(target->getBlock() == NULL)
    957     return;
    958 
    959 
    960   if(target->getNumberPredEdges() <= 1) {
    961     assert(target->getStartingPathNumber() == NULL &&
    962            "Target already has path number");
    963     target->setStartingPathNumber(source->getEndingPathNumber());
    964     target->setEndingPathNumber(source->getEndingPathNumber());
    965     DEBUG(dbgs() << "  Passing path number"
    966           << (source->getEndingPathNumber() ? "" : " (null)")
    967           << " value through.\n");
    968   } else {
    969     if(target->getPathPHI() == NULL) {
    970       DEBUG(dbgs() << "  Initializing PHI node for block '"
    971             << target->getName() << "'\n");
    972       preparePHI(target);
    973     }
    974     pushValueIntoPHI(target, source);
    975     DEBUG(dbgs() << "  Passing number value into PHI for block '"
    976           << target->getName() << "'\n");
    977   }
    978 }
    979 
    980 // Inserts source's pathNumber Value* into the appropriate slot of
    981 // target's phiNode.
    982 void PathProfiler::pushValueIntoPHI(BLInstrumentationNode* target,
    983                                     BLInstrumentationNode* source) {
    984   PHINode* phi = target->getPathPHI();
    985   assert(phi != NULL && "  Tried to push value into node with PHI, but node"
    986          " actually had no PHI.");
    987   phi->removeIncomingValue(source->getBlock(), false);
    988   phi->addIncoming(source->getEndingPathNumber(), source->getBlock());
    989 }
    990 
    991 // The Value* in node, oldVal,  is updated with a Value* correspodning to
    992 // oldVal + addition.
    993 void PathProfiler::insertNumberIncrement(BLInstrumentationNode* node,
    994                                          Value* addition, bool atBeginning) {
    995   BasicBlock* block = node->getBlock();
    996   assert(node->getStartingPathNumber() != NULL);
    997   assert(node->getEndingPathNumber() != NULL);
    998 
    999   BasicBlock::iterator insertPoint;
   1000 
   1001   if( atBeginning )
   1002     insertPoint = block->getFirstNonPHI();
   1003   else
   1004     insertPoint = block->getTerminator();
   1005 
   1006   DEBUG(errs() << "  Creating addition instruction.\n");
   1007   Value* newpn = BinaryOperator::Create(Instruction::Add,
   1008                                         node->getStartingPathNumber(),
   1009                                         addition, "pathNumber", insertPoint);
   1010 
   1011   node->setEndingPathNumber(newpn);
   1012 
   1013   if( atBeginning )
   1014     node->setStartingPathNumber(newpn);
   1015 }
   1016 
   1017 // Creates a counter increment in the given node.  The Value* in node is
   1018 // taken as the index into an array or hash table.  The hash table access
   1019 // is a call to the runtime.
   1020 void PathProfiler::insertCounterIncrement(Value* incValue,
   1021                                           BasicBlock::iterator insertPoint,
   1022                                           BLInstrumentationDag* dag,
   1023                                           bool increment) {
   1024   // Counter increment for array
   1025   if( dag->getNumberOfPaths() <= HASH_THRESHHOLD ) {
   1026     // Get pointer to the array location
   1027     std::vector<Value*> gepIndices(2);
   1028     gepIndices[0] = Constant::getNullValue(Type::getInt32Ty(*Context));
   1029     gepIndices[1] = incValue;
   1030 
   1031     GetElementPtrInst* pcPointer =
   1032       GetElementPtrInst::Create(dag->getCounterArray(),
   1033                                 gepIndices.begin(), gepIndices.end(),
   1034                                 "counterInc", insertPoint);
   1035 
   1036     // Load from the array - call it oldPC
   1037     LoadInst* oldPc = new LoadInst(pcPointer, "oldPC", insertPoint);
   1038 
   1039     // Test to see whether adding 1 will overflow the counter
   1040     ICmpInst* isMax = new ICmpInst(insertPoint, CmpInst::ICMP_ULT, oldPc,
   1041                                    createIncrementConstant(0xffffffff, 32),
   1042                                    "isMax");
   1043 
   1044     // Select increment for the path counter based on overflow
   1045     SelectInst* inc =
   1046       SelectInst::Create( isMax, createIncrementConstant(increment?1:-1,32),
   1047                           createIncrementConstant(0,32),
   1048                           "pathInc", insertPoint);
   1049 
   1050     // newPc = oldPc + inc
   1051     BinaryOperator* newPc = BinaryOperator::Create(Instruction::Add,
   1052                                                    oldPc, inc, "newPC",
   1053                                                    insertPoint);
   1054 
   1055     // Store back in to the array
   1056     new StoreInst(newPc, pcPointer, insertPoint);
   1057   } else { // Counter increment for hash
   1058     std::vector<Value*> args(2);
   1059     args[0] = ConstantInt::get(Type::getInt32Ty(*Context),
   1060                                currentFunctionNumber);
   1061     args[1] = incValue;
   1062 
   1063     CallInst::Create(
   1064       increment ? llvmIncrementHashFunction : llvmDecrementHashFunction,
   1065       args, "", insertPoint);
   1066   }
   1067 }
   1068 
   1069 // Inserts instrumentation for the given edge
   1070 //
   1071 // Pre: The edge's source node has pathNumber set if edge is non zero
   1072 // path number increment.
   1073 //
   1074 // Post: Edge's target node has a pathNumber set to the path number Value
   1075 // corresponding to the value of the path register after edge's
   1076 // execution.
   1077 //
   1078 // FIXME: This should be reworked so it's not recursive.
   1079 void PathProfiler::insertInstrumentationStartingAt(BLInstrumentationEdge* edge,
   1080                                                    BLInstrumentationDag* dag) {
   1081   // Mark the edge as instrumented
   1082   edge->setHasInstrumentation(true);
   1083   DEBUG(dbgs() << "\nInstrumenting edge: " << (*edge) << "\n");
   1084 
   1085   // create a new node for this edge's instrumentation
   1086   splitCritical(edge, dag);
   1087 
   1088   BLInstrumentationNode* sourceNode = (BLInstrumentationNode*)edge->getSource();
   1089   BLInstrumentationNode* targetNode = (BLInstrumentationNode*)edge->getTarget();
   1090   BLInstrumentationNode* instrumentNode;
   1091   BLInstrumentationNode* nextSourceNode;
   1092 
   1093   bool atBeginning = false;
   1094 
   1095   // Source node has only 1 successor so any information can be simply
   1096   // inserted in to it without splitting
   1097   if( sourceNode->getBlock() && sourceNode->getNumberSuccEdges() <= 1) {
   1098     DEBUG(dbgs() << "  Potential instructions to be placed in: "
   1099           << sourceNode->getName() << " (at end)\n");
   1100     instrumentNode = sourceNode;
   1101     nextSourceNode = targetNode; // ... since we never made any new nodes
   1102   }
   1103 
   1104   // The target node only has one predecessor, so we can safely insert edge
   1105   // instrumentation into it. If there was splitting, it must have been
   1106   // successful.
   1107   else if( targetNode->getNumberPredEdges() == 1 ) {
   1108     DEBUG(dbgs() << "  Potential instructions to be placed in: "
   1109           << targetNode->getName() << " (at beginning)\n");
   1110     pushValueIntoNode(sourceNode, targetNode);
   1111     instrumentNode = targetNode;
   1112     nextSourceNode = NULL; // ... otherwise we'll just keep splitting
   1113     atBeginning = true;
   1114   }
   1115 
   1116   // Somehow, splitting must have failed.
   1117   else {
   1118     errs() << "Instrumenting could not split a critical edge.\n";
   1119     DEBUG(dbgs() << "  Couldn't split edge " << (*edge) << ".\n");
   1120     return;
   1121   }
   1122 
   1123   // Insert instrumentation if this is a back or split edge
   1124   if( edge->getType() == BallLarusEdge::BACKEDGE ||
   1125       edge->getType() == BallLarusEdge::SPLITEDGE ) {
   1126     BLInstrumentationEdge* top =
   1127       (BLInstrumentationEdge*) edge->getPhonyRoot();
   1128     BLInstrumentationEdge* bottom =
   1129       (BLInstrumentationEdge*) edge->getPhonyExit();
   1130 
   1131     assert( top->isInitialization() && " Top phony edge did not"
   1132             " contain a path number initialization.");
   1133     assert( bottom->isCounterIncrement() && " Bottom phony edge"
   1134             " did not contain a path counter increment.");
   1135 
   1136     // split edge has yet to be initialized
   1137     if( !instrumentNode->getEndingPathNumber() ) {
   1138       instrumentNode->setStartingPathNumber(createIncrementConstant(0,32));
   1139       instrumentNode->setEndingPathNumber(createIncrementConstant(0,32));
   1140     }
   1141 
   1142     BasicBlock::iterator insertPoint = atBeginning ?
   1143       instrumentNode->getBlock()->getFirstNonPHI() :
   1144       instrumentNode->getBlock()->getTerminator();
   1145 
   1146     // add information from the bottom edge, if it exists
   1147     if( bottom->getIncrement() ) {
   1148       Value* newpn =
   1149         BinaryOperator::Create(Instruction::Add,
   1150                                instrumentNode->getStartingPathNumber(),
   1151                                createIncrementConstant(bottom),
   1152                                "pathNumber", insertPoint);
   1153       instrumentNode->setEndingPathNumber(newpn);
   1154     }
   1155 
   1156     insertCounterIncrement(instrumentNode->getEndingPathNumber(),
   1157                            insertPoint, dag);
   1158 
   1159     if( atBeginning )
   1160       instrumentNode->setStartingPathNumber(createIncrementConstant(top));
   1161 
   1162     instrumentNode->setEndingPathNumber(createIncrementConstant(top));
   1163 
   1164     // Check for path counter increments
   1165     if( top->isCounterIncrement() ) {
   1166       insertCounterIncrement(instrumentNode->getEndingPathNumber(),
   1167                              instrumentNode->getBlock()->getTerminator(),dag);
   1168       instrumentNode->setEndingPathNumber(0);
   1169     }
   1170   }
   1171 
   1172   // Insert instrumentation if this is a normal edge
   1173   else {
   1174     BasicBlock::iterator insertPoint = atBeginning ?
   1175       instrumentNode->getBlock()->getFirstNonPHI() :
   1176       instrumentNode->getBlock()->getTerminator();
   1177 
   1178     if( edge->isInitialization() ) { // initialize path number
   1179       instrumentNode->setEndingPathNumber(createIncrementConstant(edge));
   1180     } else if( edge->getIncrement() )       {// increment path number
   1181       Value* newpn =
   1182         BinaryOperator::Create(Instruction::Add,
   1183                                instrumentNode->getStartingPathNumber(),
   1184                                createIncrementConstant(edge),
   1185                                "pathNumber", insertPoint);
   1186       instrumentNode->setEndingPathNumber(newpn);
   1187 
   1188       if( atBeginning )
   1189         instrumentNode->setStartingPathNumber(newpn);
   1190     }
   1191 
   1192     // Check for path counter increments
   1193     if( edge->isCounterIncrement() ) {
   1194       insertCounterIncrement(instrumentNode->getEndingPathNumber(),
   1195                              insertPoint, dag);
   1196       instrumentNode->setEndingPathNumber(0);
   1197     }
   1198   }
   1199 
   1200   // Push it along
   1201   if (nextSourceNode && instrumentNode->getEndingPathNumber())
   1202     pushValueIntoNode(instrumentNode, nextSourceNode);
   1203 
   1204   // Add all the successors
   1205   for( BLEdgeIterator next = targetNode->succBegin(),
   1206          end = targetNode->succEnd(); next != end; next++ ) {
   1207     // So long as it is un-instrumented, add it to the list
   1208     if( !((BLInstrumentationEdge*)(*next))->hasInstrumentation() )
   1209       insertInstrumentationStartingAt((BLInstrumentationEdge*)*next,dag);
   1210     else
   1211       DEBUG(dbgs() << "  Edge " << *(BLInstrumentationEdge*)(*next)
   1212             << " already instrumented.\n");
   1213   }
   1214 }
   1215 
   1216 // Inserts instrumentation according to the marked edges in dag.  Phony edges
   1217 // must be unlinked from the DAG, but accessible from the backedges.  Dag
   1218 // must have initializations, path number increments, and counter increments
   1219 // present.
   1220 //
   1221 // Counter storage is created here.
   1222 void PathProfiler::insertInstrumentation(
   1223   BLInstrumentationDag& dag, Module &M) {
   1224 
   1225   BLInstrumentationEdge* exitRootEdge =
   1226     (BLInstrumentationEdge*) dag.getExitRootEdge();
   1227   insertInstrumentationStartingAt(exitRootEdge, &dag);
   1228 
   1229   // Iterate through each call edge and apply the appropriate hash increment
   1230   // and decrement functions
   1231   BLEdgeVector callEdges = dag.getCallPhonyEdges();
   1232   for( BLEdgeIterator edge = callEdges.begin(),
   1233          end = callEdges.end(); edge != end; edge++ ) {
   1234     BLInstrumentationNode* node =
   1235       (BLInstrumentationNode*)(*edge)->getSource();
   1236     BasicBlock::iterator insertPoint = node->getBlock()->getFirstNonPHI();
   1237 
   1238     // Find the first function call
   1239     while( ((Instruction&)(*insertPoint)).getOpcode() != Instruction::Call )
   1240       insertPoint++;
   1241 
   1242     DEBUG(dbgs() << "\nInstrumenting method call block '"
   1243           << node->getBlock()->getNameStr() << "'\n");
   1244     DEBUG(dbgs() << "   Path number initialized: "
   1245           << ((node->getStartingPathNumber()) ? "yes" : "no") << "\n");
   1246 
   1247     Value* newpn;
   1248     if( node->getStartingPathNumber() ) {
   1249       long inc = ((BLInstrumentationEdge*)(*edge))->getIncrement();
   1250       if ( inc )
   1251         newpn = BinaryOperator::Create(Instruction::Add,
   1252                                        node->getStartingPathNumber(),
   1253                                        createIncrementConstant(inc,32),
   1254                                        "pathNumber", insertPoint);
   1255       else
   1256         newpn = node->getStartingPathNumber();
   1257     } else {
   1258       newpn = (Value*)createIncrementConstant(
   1259         ((BLInstrumentationEdge*)(*edge))->getIncrement(), 32);
   1260     }
   1261 
   1262     insertCounterIncrement(newpn, insertPoint, &dag);
   1263     insertCounterIncrement(newpn, node->getBlock()->getTerminator(),
   1264                            &dag, false);
   1265   }
   1266 }
   1267 
   1268 // Entry point of the module
   1269 void PathProfiler::runOnFunction(std::vector<Constant*> &ftInit,
   1270                                  Function &F, Module &M) {
   1271   // Build DAG from CFG
   1272   BLInstrumentationDag dag = BLInstrumentationDag(F);
   1273   dag.init();
   1274 
   1275   // give each path a unique integer value
   1276   dag.calculatePathNumbers();
   1277 
   1278   // modify path increments to increase the efficiency
   1279   // of instrumentation
   1280   dag.calculateSpanningTree();
   1281   dag.calculateChordIncrements();
   1282   dag.pushInitialization();
   1283   dag.pushCounters();
   1284   dag.unlinkPhony();
   1285 
   1286   // potentially generate .dot graph for the dag
   1287   if (DotPathDag)
   1288     dag.generateDotGraph ();
   1289 
   1290   // Should we store the information in an array or hash
   1291   if( dag.getNumberOfPaths() <= HASH_THRESHHOLD ) {
   1292     Type* t = ArrayType::get(Type::getInt32Ty(*Context),
   1293                                    dag.getNumberOfPaths());
   1294 
   1295     dag.setCounterArray(new GlobalVariable(M, t, false,
   1296                                            GlobalValue::InternalLinkage,
   1297                                            Constant::getNullValue(t), ""));
   1298   }
   1299 
   1300   insertInstrumentation(dag, M);
   1301 
   1302   // Add to global function reference table
   1303   unsigned type;
   1304   Type* voidPtr = TypeBuilder<types::i<8>*, true>::get(*Context);
   1305 
   1306   if( dag.getNumberOfPaths() <= HASH_THRESHHOLD )
   1307     type = ProfilingArray;
   1308   else
   1309     type = ProfilingHash;
   1310 
   1311   std::vector<Constant*> entryArray(3);
   1312   entryArray[0] = createIncrementConstant(type,32);
   1313   entryArray[1] = createIncrementConstant(dag.getNumberOfPaths(),32);
   1314   entryArray[2] = dag.getCounterArray() ?
   1315     ConstantExpr::getBitCast(dag.getCounterArray(), voidPtr) :
   1316     Constant::getNullValue(voidPtr);
   1317 
   1318   StructType* at = ftEntryTypeBuilder::get(*Context);
   1319   ConstantStruct* functionEntry =
   1320     (ConstantStruct*)ConstantStruct::get(at, entryArray);
   1321   ftInit.push_back(functionEntry);
   1322 }
   1323 
   1324 // Output the bitcode if we want to observe instrumentation changess
   1325 #define PRINT_MODULE dbgs() <<                               \
   1326   "\n\n============= MODULE BEGIN ===============\n" << M << \
   1327   "\n============== MODULE END ================\n"
   1328 
   1329 bool PathProfiler::runOnModule(Module &M) {
   1330   Context = &M.getContext();
   1331 
   1332   DEBUG(dbgs()
   1333         << "****************************************\n"
   1334         << "****************************************\n"
   1335         << "**                                    **\n"
   1336         << "**   PATH PROFILING INSTRUMENTATION   **\n"
   1337         << "**                                    **\n"
   1338         << "****************************************\n"
   1339         << "****************************************\n");
   1340 
   1341   // No main, no instrumentation!
   1342   Function *Main = M.getFunction("main");
   1343 
   1344   // Using fortran? ... this kind of works
   1345   if (!Main)
   1346     Main = M.getFunction("MAIN__");
   1347 
   1348   if (!Main) {
   1349     errs() << "WARNING: cannot insert path profiling into a module"
   1350            << " with no main function!\n";
   1351     return false;
   1352   }
   1353 
   1354   llvmIncrementHashFunction = M.getOrInsertFunction(
   1355     "llvm_increment_path_count",
   1356     Type::getVoidTy(*Context), // return type
   1357     Type::getInt32Ty(*Context), // function number
   1358     Type::getInt32Ty(*Context), // path number
   1359     NULL );
   1360 
   1361   llvmDecrementHashFunction = M.getOrInsertFunction(
   1362     "llvm_decrement_path_count",
   1363     Type::getVoidTy(*Context), // return type
   1364     Type::getInt32Ty(*Context), // function number
   1365     Type::getInt32Ty(*Context), // path number
   1366     NULL );
   1367 
   1368   std::vector<Constant*> ftInit;
   1369   unsigned functionNumber = 0;
   1370   for (Module::iterator F = M.begin(), E = M.end(); F != E; F++) {
   1371     if (F->isDeclaration())
   1372       continue;
   1373 
   1374     DEBUG(dbgs() << "Function: " << F->getNameStr() << "\n");
   1375     functionNumber++;
   1376 
   1377     // set function number
   1378     currentFunctionNumber = functionNumber;
   1379     runOnFunction(ftInit, *F, M);
   1380   }
   1381 
   1382   Type *t = ftEntryTypeBuilder::get(*Context);
   1383   ArrayType* ftArrayType = ArrayType::get(t, ftInit.size());
   1384   Constant* ftInitConstant = ConstantArray::get(ftArrayType, ftInit);
   1385 
   1386   DEBUG(dbgs() << " ftArrayType:" << *ftArrayType << "\n");
   1387 
   1388   GlobalVariable* functionTable =
   1389     new GlobalVariable(M, ftArrayType, false, GlobalValue::InternalLinkage,
   1390                        ftInitConstant, "functionPathTable");
   1391   Type *eltType = ftArrayType->getTypeAtIndex((unsigned)0);
   1392   InsertProfilingInitCall(Main, "llvm_start_path_profiling", functionTable,
   1393                           PointerType::getUnqual(eltType));
   1394 
   1395   DEBUG(PRINT_MODULE);
   1396 
   1397   return true;
   1398 }
   1399 
   1400 // If this edge is a critical edge, then inserts a node at this edge.
   1401 // This edge becomes the first edge, and a new BallLarusEdge is created.
   1402 // Returns true if the edge was split
   1403 bool PathProfiler::splitCritical(BLInstrumentationEdge* edge,
   1404                                  BLInstrumentationDag* dag) {
   1405   unsigned succNum = edge->getSuccessorNumber();
   1406   BallLarusNode* sourceNode = edge->getSource();
   1407   BallLarusNode* targetNode = edge->getTarget();
   1408   BasicBlock* sourceBlock = sourceNode->getBlock();
   1409   BasicBlock* targetBlock = targetNode->getBlock();
   1410 
   1411   if(sourceBlock == NULL || targetBlock == NULL
   1412      || sourceNode->getNumberSuccEdges() <= 1
   1413      || targetNode->getNumberPredEdges() == 1 ) {
   1414     return(false);
   1415   }
   1416 
   1417   TerminatorInst* terminator = sourceBlock->getTerminator();
   1418 
   1419   if( SplitCriticalEdge(terminator, succNum, this, false)) {
   1420     BasicBlock* newBlock = terminator->getSuccessor(succNum);
   1421     dag->splitUpdate(edge, newBlock);
   1422     return(true);
   1423   } else
   1424     return(false);
   1425 }
   1426