lib/Analysis/DataStructure/Steensgaard.cpp

   1 //===- Steensgaard.cpp - Context Insensitive Alias Analysis ---------------===//
   2 //
   3 // This pass uses the data structure graphs to implement a simple context
   4 // insensitive alias analysis.  It does this by computing the local analysis
   5 // graphs for all of the functions, then merging them together into a single big
   6 // graph without cloning.
   7 //
   8 //===----------------------------------------------------------------------===//
   9
  10 #include "llvm/Analysis/DataStructure.h"
  11 #include "llvm/Analysis/DSGraph.h"
  12 #include "llvm/Analysis/AliasAnalysis.h"
  13 #include "llvm/Module.h"
  14 #include "Support/Statistic.h"
  15
  16 namespace {
  17   class Steens : public Pass, public AliasAnalysis {
  18     DSGraph *ResultGraph;
  19     DSGraph *GlobalsGraph;  // FIXME: Eliminate globals graph stuff from DNE
  20   public:
  21     Steens() : ResultGraph(0) {}
  22     ~Steens() { assert(ResultGraph == 0 && "releaseMemory not called?"); }
  23
  24     //------------------------------------------------
  25     // Implement the Pass API
  26     //
  27
  28     // run - Build up the result graph, representing the pointer graph for the
  29     // program.
  30     //
  31     bool run(Module &M);
  32
  33     virtual void releaseMemory() { delete ResultGraph; ResultGraph = 0; }
  34
  35     virtual void getAnalysisUsage(AnalysisUsage &AU) const {
  36       AU.setPreservesAll();                    // Does not transform code...
  37       AU.addRequired<LocalDataStructures>();   // Uses local dsgraph
  38       AU.addRequired<AliasAnalysis>();         // Chains to another AA impl...
  39     }
  40
  41     // print - Implement the Pass::print method...
  42     void print(std::ostream &O, const Module *M) const {
  43       assert(ResultGraph && "Result graph has not yet been computed!");
  44       ResultGraph->writeGraphToFile(O, "steensgaards");
  45     }
  46
  47     //------------------------------------------------
  48     // Implement the AliasAnalysis API
  49     //
  50
  51     // alias - This is the only method here that does anything interesting...
  52     Result alias(const Value *V1, const Value *V2);
  53
  54     /// canCallModify - Not implemented yet: FIXME
  55     ///
  56     Result canCallModify(const CallInst &CI, const Value *Ptr) {
  57       return MayAlias;
  58     }
  59
  60     /// canInvokeModify - Not implemented yet: FIXME
  61     ///
  62     Result canInvokeModify(const InvokeInst &I, const Value *Ptr) {
  63       return MayAlias;
  64     }
  65
  66   private:
  67     void ResolveFunctionCall(Function *F, const DSCallSite &Call,
  68                              DSNodeHandle &RetVal);
  69   };
  70
  71   // Register the pass...
  72   RegisterOpt<Steens> X("steens-aa",
  73                         "Steensgaard's alias analysis (DSGraph based)");
  74
  75   // Register as an implementation of AliasAnalysis
  76   RegisterAnalysisGroup<AliasAnalysis, Steens> Y;
  77 }
  78
  79
  80 /// ResolveFunctionCall - Resolve the actual arguments of a call to function F
  81 /// with the specified call site descriptor.  This function links the arguments
  82 /// and the return value for the call site context-insensitively.
  83 ///
  84 void Steens::ResolveFunctionCall(Function *F, const DSCallSite &Call,
  85                                  DSNodeHandle &RetVal) {
  86   assert(ResultGraph != 0 && "Result graph not allocated!");
  87   hash_map<Value*, DSNodeHandle> &ValMap = ResultGraph->getScalarMap();
  88
  89   // Handle the return value of the function...
  90   if (Call.getRetVal().getNode() && RetVal.getNode())
  91     RetVal.mergeWith(Call.getRetVal());
  92
  93   // Loop over all pointer arguments, resolving them to their provided pointers
  94   unsigned PtrArgIdx = 0;
  95   for (Function::aiterator AI = F->abegin(), AE = F->aend(); AI != AE; ++AI) {
  96     hash_map<Value*, DSNodeHandle>::iterator I = ValMap.find(AI);
  97     if (I != ValMap.end())    // If its a pointer argument...
  98       I->second.mergeWith(Call.getPtrArg(PtrArgIdx++));
  99   }
 100 }
 101
 102
 103 /// run - Build up the result graph, representing the pointer graph for the
 104 /// program.
 105 ///
 106 bool Steens::run(Module &M) {
 107   assert(ResultGraph == 0 && "Result graph already allocated!");
 108   LocalDataStructures &LDS = getAnalysis<LocalDataStructures>();
 109
 110   // Create a new, empty, graph...
 111   ResultGraph = new DSGraph();
 112   GlobalsGraph = new DSGraph();
 113   ResultGraph->setGlobalsGraph(GlobalsGraph);
 114   ResultGraph->setPrintAuxCalls();
 115
 116   // RetValMap - Keep track of the return values for all functions that return
 117   // valid pointers.
 118   //
 119   hash_map<Function*, DSNodeHandle> RetValMap;
 120
 121   // Loop over the rest of the module, merging graphs for non-external functions
 122   // into this graph.
 123   //
 124   unsigned Count = 0;
 125   for (Module::iterator I = M.begin(), E = M.end(); I != E; ++I)
 126     if (!I->isExternal()) {
 127       hash_map<Value*, DSNodeHandle> ValMap;
 128       {  // Scope to free NodeMap memory ASAP
 129         hash_map<const DSNode*, DSNodeHandle> NodeMap;
 130         const DSGraph &FDSG = LDS.getDSGraph(*I);
 131         DSNodeHandle RetNode = ResultGraph->cloneInto(FDSG, ValMap, NodeMap);
 132
 133         // Keep track of the return node of the function's graph if it returns a
 134         // value...
 135         //
 136         if (RetNode.getNode())
 137           RetValMap[I] = RetNode;
 138       }
 139
 140       // Incorporate the inlined Function's ScalarMap into the global
 141       // ScalarMap...
 142       hash_map<Value*, DSNodeHandle> &GVM = ResultGraph->getScalarMap();
 143       for (hash_map<Value*, DSNodeHandle>::iterator I = ValMap.begin(),
 144              E = ValMap.end(); I != E; ++I)
 145         GVM[I->first].mergeWith(I->second);
 146
 147       if ((++Count & 1) == 0)   // Prune nodes out every other time...
 148         ResultGraph->removeTriviallyDeadNodes();
 149     }
 150
 151   // FIXME: Must recalculate and use the Incomplete markers!!
 152
 153   // Now that we have all of the graphs inlined, we can go about eliminating
 154   // call nodes...
 155   //
 156   std::vector<DSCallSite> &Calls =
 157     ResultGraph->getAuxFunctionCalls();
 158   assert(Calls.empty() && "Aux call list is already in use??");
 159
 160   // Start with a copy of the original call sites...
 161   Calls = ResultGraph->getFunctionCalls();
 162
 163   for (unsigned i = 0; i != Calls.size(); ) {
 164     DSCallSite &CurCall = Calls[i];
 165
 166     // Loop over the called functions, eliminating as many as possible...
 167     std::vector<GlobalValue*> CallTargets;
 168     if (CurCall.isDirectCall())
 169       CallTargets.push_back(CurCall.getCalleeFunc());
 170     else
 171       CallTargets = CurCall.getCalleeNode()->getGlobals();
 172
 173     for (unsigned c = 0; c != CallTargets.size(); ) {
 174       // If we can eliminate this function call, do so!
 175       bool Eliminated = false;
 176       if (Function *F = dyn_cast<Function>(CallTargets[c]))
 177         if (!F->isExternal()) {
 178           ResolveFunctionCall(F, CurCall, RetValMap[F]);
 179           Eliminated = true;
 180         }
 181       if (Eliminated) {
 182         CallTargets[c] = CallTargets.back();
 183         CallTargets.pop_back();
 184       } else
 185         ++c;  // Cannot eliminate this call, skip over it...
 186     }
 187
 188     if (CallTargets.empty()) {        // Eliminated all calls?
 189       CurCall = Calls.back();         // Remove entry
 190       Calls.pop_back();
 191     } else
 192       ++i;                            // Skip this call site...
 193   }
 194
 195   // Update the "incomplete" markers on the nodes, ignoring unknownness due to
 196   // incoming arguments...
 197   ResultGraph->maskIncompleteMarkers();
 198   ResultGraph->markIncompleteNodes(DSGraph::IgnoreFormalArgs);
 199
 200   // Remove any nodes that are dead after all of the merging we have done...
 201   // FIXME: We should be able to disable the globals graph for steens!
 202   ResultGraph->removeDeadNodes(DSGraph::KeepUnreachableGlobals);
 203
 204   DEBUG(print(std::cerr, &M));
 205   return false;
 206 }
 207
 208 // alias - This is the only method here that does anything interesting...
 209 AliasAnalysis::Result Steens::alias(const Value *V1, const Value *V2) {
 210   assert(ResultGraph && "Result graph has not been computed yet!");
 211
 212   hash_map<Value*, DSNodeHandle> &GSM = ResultGraph->getScalarMap();
 213
 214   hash_map<Value*, DSNodeHandle>::iterator I = GSM.find(const_cast<Value*>(V1));
 215   if (I != GSM.end() && I->second.getNode()) {
 216     DSNodeHandle &V1H = I->second;
 217     hash_map<Value*, DSNodeHandle>::iterator J=GSM.find(const_cast<Value*>(V2));
 218     if (J != GSM.end() && J->second.getNode()) {
 219       DSNodeHandle &V2H = J->second;
 220       // If the two pointers point to different data structure graph nodes, they
 221       // cannot alias!
 222       if (V1H.getNode() != V2H.getNode())    // FIXME: Handle incompleteness!
 223         return NoAlias;
 224
 225       // FIXME: If the two pointers point to the same node, and the offsets are
 226       // different, and the LinkIndex vector doesn't alias the section, then the
 227       // two pointers do not alias.  We need access size information for the two
 228       // accesses though!
 229       //
 230     }
 231   }
 232
 233   // If we cannot determine alias properties based on our graph, fall back on
 234   // some other AA implementation.
 235   //
 236   return getAnalysis<AliasAnalysis>().alias(V1, V2);
 237 }