lib/Transforms/IPO/DeadArgumentElimination.cpp

   1 //===-- DeadArgumentElimination.cpp - Eliminate dead arguments ------------===//
   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 deletes dead arguments from internal functions.  Dead argument
  11 // elimination removes arguments which are directly dead, as well as arguments
  12 // only passed into function calls as dead arguments of other functions.  This
  13 // pass also deletes dead return values in a similar way.
  14 //
  15 // This pass is often useful as a cleanup pass to run after aggressive
  16 // interprocedural passes, which add possibly-dead arguments or return values.
  17 //
  18 //===----------------------------------------------------------------------===//
  19
  20 #define DEBUG_TYPE "deadargelim"
  21 #include "llvm/Transforms/IPO.h"
  22 #include "llvm/ADT/DenseMap.h"
  23 #include "llvm/ADT/SmallVector.h"
  24 #include "llvm/ADT/Statistic.h"
  25 #include "llvm/ADT/StringExtras.h"
  26 #include "llvm/DIBuilder.h"
  27 #include "llvm/DebugInfo.h"
  28 #include "llvm/IR/CallingConv.h"
  29 #include "llvm/IR/Constant.h"
  30 #include "llvm/IR/DerivedTypes.h"
  31 #include "llvm/IR/Instructions.h"
  32 #include "llvm/IR/IntrinsicInst.h"
  33 #include "llvm/IR/LLVMContext.h"
  34 #include "llvm/IR/Module.h"
  35 #include "llvm/Pass.h"
  36 #include "llvm/Support/CallSite.h"
  37 #include "llvm/Support/Debug.h"
  38 #include "llvm/Support/raw_ostream.h"
  39 #include <map>
  40 #include <set>
  41 using namespace llvm;
  42
  43 STATISTIC(NumArgumentsEliminated, "Number of unread args removed");
  44 STATISTIC(NumRetValsEliminated  , "Number of unused return values removed");
  45 STATISTIC(NumArgumentsReplacedWithUndef,
  46           "Number of unread args replaced with undef");
  47 namespace {
  48   /// DAE - The dead argument elimination pass.
  49   ///
  50   class DAE : public ModulePass {
  51   public:
  52
  53     /// Struct that represents (part of) either a return value or a function
  54     /// argument.  Used so that arguments and return values can be used
  55     /// interchangeably.
  56     struct RetOrArg {
  57       RetOrArg(const Function *F, unsigned Idx, bool IsArg) : F(F), Idx(Idx),
  58                IsArg(IsArg) {}
  59       const Function *F;
  60       unsigned Idx;
  61       bool IsArg;
  62
  63       /// Make RetOrArg comparable, so we can put it into a map.
  64       bool operator<(const RetOrArg &O) const {
  65         if (F != O.F)
  66           return F < O.F;
  67         else if (Idx != O.Idx)
  68           return Idx < O.Idx;
  69         else
  70           return IsArg < O.IsArg;
  71       }
  72
  73       /// Make RetOrArg comparable, so we can easily iterate the multimap.
  74       bool operator==(const RetOrArg &O) const {
  75         return F == O.F && Idx == O.Idx && IsArg == O.IsArg;
  76       }
  77
  78       std::string getDescription() const {
  79         return std::string((IsArg ? "Argument #" : "Return value #"))
  80                + utostr(Idx) + " of function " + F->getName().str();
  81       }
  82     };
  83
  84     /// Liveness enum - During our initial pass over the program, we determine
  85     /// that things are either alive or maybe alive. We don't mark anything
  86     /// explicitly dead (even if we know they are), since anything not alive
  87     /// with no registered uses (in Uses) will never be marked alive and will
  88     /// thus become dead in the end.
  89     enum Liveness { Live, MaybeLive };
  90
  91     /// Convenience wrapper
  92     RetOrArg CreateRet(const Function *F, unsigned Idx) {
  93       return RetOrArg(F, Idx, false);
  94     }
  95     /// Convenience wrapper
  96     RetOrArg CreateArg(const Function *F, unsigned Idx) {
  97       return RetOrArg(F, Idx, true);
  98     }
  99
 100     typedef std::multimap<RetOrArg, RetOrArg> UseMap;
 101     /// This maps a return value or argument to any MaybeLive return values or
 102     /// arguments it uses. This allows the MaybeLive values to be marked live
 103     /// when any of its users is marked live.
 104     /// For example (indices are left out for clarity):
 105     ///  - Uses[ret F] = ret G
 106     ///    This means that F calls G, and F returns the value returned by G.
 107     ///  - Uses[arg F] = ret G
 108     ///    This means that some function calls G and passes its result as an
 109     ///    argument to F.
 110     ///  - Uses[ret F] = arg F
 111     ///    This means that F returns one of its own arguments.
 112     ///  - Uses[arg F] = arg G
 113     ///    This means that G calls F and passes one of its own (G's) arguments
 114     ///    directly to F.
 115     UseMap Uses;
 116
 117     typedef std::set<RetOrArg> LiveSet;
 118     typedef std::set<const Function*> LiveFuncSet;
 119
 120     /// This set contains all values that have been determined to be live.
 121     LiveSet LiveValues;
 122     /// This set contains all values that are cannot be changed in any way.
 123     LiveFuncSet LiveFunctions;
 124
 125     typedef SmallVector<RetOrArg, 5> UseVector;
 126
 127     // Map each LLVM function to corresponding metadata with debug info. If
 128     // the function is replaced with another one, we should patch the pointer
 129     // to LLVM function in metadata.
 130     // As the code generation for module is finished (and DIBuilder is
 131     // finalized) we assume that subprogram descriptors won't be changed, and
 132     // they are stored in map for short duration anyway.
 133     typedef DenseMap<Function*, DISubprogram> FunctionDIMap;
 134     FunctionDIMap FunctionDIs;
 135
 136   protected:
 137     // DAH uses this to specify a different ID.
 138     explicit DAE(char &ID) : ModulePass(ID) {}
 139
 140   public:
 141     static char ID; // Pass identification, replacement for typeid
 142     DAE() : ModulePass(ID) {
 143       initializeDAEPass(*PassRegistry::getPassRegistry());
 144     }
 145
 146     bool runOnModule(Module &M);
 147
 148     virtual bool ShouldHackArguments() const { return false; }
 149
 150   private:
 151     Liveness MarkIfNotLive(RetOrArg Use, UseVector &MaybeLiveUses);
 152     Liveness SurveyUse(Value::const_use_iterator U, UseVector &MaybeLiveUses,
 153                        unsigned RetValNum = 0);
 154     Liveness SurveyUses(const Value *V, UseVector &MaybeLiveUses);
 155
 156     void CollectFunctionDIs(Module &M);
 157     void SurveyFunction(const Function &F);
 158     void MarkValue(const RetOrArg &RA, Liveness L,
 159                    const UseVector &MaybeLiveUses);
 160     void MarkLive(const RetOrArg &RA);
 161     void MarkLive(const Function &F);
 162     void PropagateLiveness(const RetOrArg &RA);
 163     bool RemoveDeadStuffFromFunction(Function *F);
 164     bool DeleteDeadVarargs(Function &Fn);
 165     bool RemoveDeadArgumentsFromCallers(Function &Fn);
 166   };
 167 }
 168
 169
 170 char DAE::ID = 0;
 171 INITIALIZE_PASS(DAE, "deadargelim", "Dead Argument Elimination", false, false)
 172
 173 namespace {
 174   /// DAH - DeadArgumentHacking pass - Same as dead argument elimination, but
 175   /// deletes arguments to functions which are external.  This is only for use
 176   /// by bugpoint.
 177   struct DAH : public DAE {
 178     static char ID;
 179     DAH() : DAE(ID) {}
 180
 181     virtual bool ShouldHackArguments() const { return true; }
 182   };
 183 }
 184
 185 char DAH::ID = 0;
 186 INITIALIZE_PASS(DAH, "deadarghaX0r",
 187                 "Dead Argument Hacking (BUGPOINT USE ONLY; DO NOT USE)",
 188                 false, false)
 189
 190 /// createDeadArgEliminationPass - This pass removes arguments from functions
 191 /// which are not used by the body of the function.
 192 ///
 193 ModulePass *llvm::createDeadArgEliminationPass() { return new DAE(); }
 194 ModulePass *llvm::createDeadArgHackingPass() { return new DAH(); }
 195
 196 /// CollectFunctionDIs - Map each function in the module to its debug info
 197 /// descriptor.
 198 void DAE::CollectFunctionDIs(Module &M) {
 199   FunctionDIs.clear();
 200
 201   for (Module::named_metadata_iterator I = M.named_metadata_begin(),
 202        E = M.named_metadata_end(); I != E; ++I) {
 203     NamedMDNode &NMD = *I;
 204     for (unsigned MDIndex = 0, MDNum = NMD.getNumOperands();
 205          MDIndex < MDNum; ++MDIndex) {
 206       MDNode *Node = NMD.getOperand(MDIndex);
 207       if (!DIDescriptor(Node).isCompileUnit())
 208         continue;
 209       DICompileUnit CU(Node);
 210       const DIArray &SPs = CU.getSubprograms();
 211       for (unsigned SPIndex = 0, SPNum = SPs.getNumElements();
 212            SPIndex < SPNum; ++SPIndex) {
 213         DISubprogram SP(SPs.getElement(SPIndex));
 214         if (!SP.Verify())
 215           continue;
 216         if (Function *F = SP.getFunction())
 217           FunctionDIs[F] = SP;
 218       }
 219     }
 220   }
 221 }
 222
 223 /// DeleteDeadVarargs - If this is an function that takes a ... list, and if
 224 /// llvm.vastart is never called, the varargs list is dead for the function.
 225 bool DAE::DeleteDeadVarargs(Function &Fn) {
 226   assert(Fn.getFunctionType()->isVarArg() && "Function isn't varargs!");
 227   if (Fn.isDeclaration() || !Fn.hasLocalLinkage()) return false;
 228
 229   // Ensure that the function is only directly called.
 230   if (Fn.hasAddressTaken())
 231     return false;
 232
 233   // Okay, we know we can transform this function if safe.  Scan its body
 234   // looking for calls to llvm.vastart.
 235   for (Function::iterator BB = Fn.begin(), E = Fn.end(); BB != E; ++BB) {
 236     for (BasicBlock::iterator I = BB->begin(), E = BB->end(); I != E; ++I) {
 237       if (IntrinsicInst *II = dyn_cast<IntrinsicInst>(I)) {
 238         if (II->getIntrinsicID() == Intrinsic::vastart)
 239           return false;
 240       }
 241     }
 242   }
 243
 244   // If we get here, there are no calls to llvm.vastart in the function body,
 245   // remove the "..." and adjust all the calls.
 246
 247   // Start by computing a new prototype for the function, which is the same as
 248   // the old function, but doesn't have isVarArg set.
 249   FunctionType *FTy = Fn.getFunctionType();
 250
 251   std::vector<Type*> Params(FTy->param_begin(), FTy->param_end());
 252   FunctionType *NFTy = FunctionType::get(FTy->getReturnType(),
 253                                                 Params, false);
 254   unsigned NumArgs = Params.size();
 255
 256   // Create the new function body and insert it into the module...
 257   Function *NF = Function::Create(NFTy, Fn.getLinkage());
 258   NF->copyAttributesFrom(&Fn);
 259   Fn.getParent()->getFunctionList().insert(&Fn, NF);
 260   NF->takeName(&Fn);
 261
 262   // Loop over all of the callers of the function, transforming the call sites
 263   // to pass in a smaller number of arguments into the new function.
 264   //
 265   std::vector<Value*> Args;
 266   while (!Fn.use_empty()) {
 267     CallSite CS(Fn.use_back());
 268     Instruction *Call = CS.getInstruction();
 269
 270     // Pass all the same arguments.
 271     Args.assign(CS.arg_begin(), CS.arg_begin() + NumArgs);
 272
 273     // Drop any attributes that were on the vararg arguments.
 274     AttributeSet PAL = CS.getAttributes();
 275     if (!PAL.isEmpty() && PAL.getSlotIndex(PAL.getNumSlots() - 1) > NumArgs) {
 276       SmallVector<AttributeSet, 8> AttributesVec;
 277       for (unsigned i = 0; PAL.getSlotIndex(i) <= NumArgs; ++i)
 278         AttributesVec.push_back(PAL.getSlotAttributes(i));
 279       if (PAL.hasAttributes(AttributeSet::FunctionIndex))
 280         AttributesVec.push_back(AttributeSet::get(Fn.getContext(),
 281                                                   PAL.getFnAttributes()));
 282       PAL = AttributeSet::get(Fn.getContext(), AttributesVec);
 283     }
 284
 285     Instruction *New;
 286     if (InvokeInst *II = dyn_cast<InvokeInst>(Call)) {
 287       New = InvokeInst::Create(NF, II->getNormalDest(), II->getUnwindDest(),
 288                                Args, "", Call);
 289       cast<InvokeInst>(New)->setCallingConv(CS.getCallingConv());
 290       cast<InvokeInst>(New)->setAttributes(PAL);
 291     } else {
 292       New = CallInst::Create(NF, Args, "", Call);
 293       cast<CallInst>(New)->setCallingConv(CS.getCallingConv());
 294       cast<CallInst>(New)->setAttributes(PAL);
 295       if (cast<CallInst>(Call)->isTailCall())
 296         cast<CallInst>(New)->setTailCall();
 297     }
 298     New->setDebugLoc(Call->getDebugLoc());
 299
 300     Args.clear();
 301
 302     if (!Call->use_empty())
 303       Call->replaceAllUsesWith(New);
 304
 305     New->takeName(Call);
 306
 307     // Finally, remove the old call from the program, reducing the use-count of
 308     // F.
 309     Call->eraseFromParent();
 310   }
 311
 312   // Since we have now created the new function, splice the body of the old
 313   // function right into the new function, leaving the old rotting hulk of the
 314   // function empty.
 315   NF->getBasicBlockList().splice(NF->begin(), Fn.getBasicBlockList());
 316
 317   // Loop over the argument list, transferring uses of the old arguments over to
 318   // the new arguments, also transferring over the names as well.  While we're at
 319   // it, remove the dead arguments from the DeadArguments list.
 320   //
 321   for (Function::arg_iterator I = Fn.arg_begin(), E = Fn.arg_end(),
 322        I2 = NF->arg_begin(); I != E; ++I, ++I2) {
 323     // Move the name and users over to the new version.
 324     I->replaceAllUsesWith(I2);
 325     I2->takeName(I);
 326   }
 327
 328   // Patch the pointer to LLVM function in debug info descriptor.
 329   FunctionDIMap::iterator DI = FunctionDIs.find(&Fn);
 330   if (DI != FunctionDIs.end())
 331     DI->second.replaceFunction(NF);
 332
 333   // Finally, nuke the old function.
 334   Fn.eraseFromParent();
 335   return true;
 336 }
 337
 338 /// RemoveDeadArgumentsFromCallers - Checks if the given function has any
 339 /// arguments that are unused, and changes the caller parameters to be undefined
 340 /// instead.
 341 bool DAE::RemoveDeadArgumentsFromCallers(Function &Fn)
 342 {
 343   if (Fn.isDeclaration() || Fn.mayBeOverridden())
 344     return false;
 345
 346   // Functions with local linkage should already have been handled, except the
 347   // fragile (variadic) ones which we can improve here.
 348   if (Fn.hasLocalLinkage() && !Fn.getFunctionType()->isVarArg())
 349     return false;
 350
 351   if (Fn.use_empty())
 352     return false;
 353
 354   SmallVector<unsigned, 8> UnusedArgs;
 355   for (Function::arg_iterator I = Fn.arg_begin(), E = Fn.arg_end();
 356        I != E; ++I) {
 357     Argument *Arg = I;
 358
 359     if (Arg->use_empty() && !Arg->hasByValAttr())
 360       UnusedArgs.push_back(Arg->getArgNo());
 361   }
 362
 363   if (UnusedArgs.empty())
 364     return false;
 365
 366   bool Changed = false;
 367
 368   for (Function::use_iterator I = Fn.use_begin(), E = Fn.use_end();
 369        I != E; ++I) {
 370     CallSite CS(*I);
 371     if (!CS || !CS.isCallee(I))
 372       continue;
 373
 374     // Now go through all unused args and replace them with "undef".
 375     for (unsigned I = 0, E = UnusedArgs.size(); I != E; ++I) {
 376       unsigned ArgNo = UnusedArgs[I];
 377
 378       Value *Arg = CS.getArgument(ArgNo);
 379       CS.setArgument(ArgNo, UndefValue::get(Arg->getType()));
 380       ++NumArgumentsReplacedWithUndef;
 381       Changed = true;
 382     }
 383   }
 384
 385   return Changed;
 386 }
 387
 388 /// Convenience function that returns the number of return values. It returns 0
 389 /// for void functions and 1 for functions not returning a struct. It returns
 390 /// the number of struct elements for functions returning a struct.
 391 static unsigned NumRetVals(const Function *F) {
 392   if (F->getReturnType()->isVoidTy())
 393     return 0;
 394   else if (StructType *STy = dyn_cast<StructType>(F->getReturnType()))
 395     return STy->getNumElements();
 396   else
 397     return 1;
 398 }
 399
 400 /// MarkIfNotLive - This checks Use for liveness in LiveValues. If Use is not
 401 /// live, it adds Use to the MaybeLiveUses argument. Returns the determined
 402 /// liveness of Use.
 403 DAE::Liveness DAE::MarkIfNotLive(RetOrArg Use, UseVector &MaybeLiveUses) {
 404   // We're live if our use or its Function is already marked as live.
 405   if (LiveFunctions.count(Use.F) || LiveValues.count(Use))
 406     return Live;
 407
 408   // We're maybe live otherwise, but remember that we must become live if
 409   // Use becomes live.
 410   MaybeLiveUses.push_back(Use);
 411   return MaybeLive;
 412 }
 413
 414
 415 /// SurveyUse - This looks at a single use of an argument or return value
 416 /// and determines if it should be alive or not. Adds this use to MaybeLiveUses
 417 /// if it causes the used value to become MaybeLive.
 418 ///
 419 /// RetValNum is the return value number to use when this use is used in a
 420 /// return instruction. This is used in the recursion, you should always leave
 421 /// it at 0.
 422 DAE::Liveness DAE::SurveyUse(Value::const_use_iterator U,
 423                              UseVector &MaybeLiveUses, unsigned RetValNum) {
 424     const User *V = *U;
 425     if (const ReturnInst *RI = dyn_cast<ReturnInst>(V)) {
 426       // The value is returned from a function. It's only live when the
 427       // function's return value is live. We use RetValNum here, for the case
 428       // that U is really a use of an insertvalue instruction that uses the
 429       // original Use.
 430       RetOrArg Use = CreateRet(RI->getParent()->getParent(), RetValNum);
 431       // We might be live, depending on the liveness of Use.
 432       return MarkIfNotLive(Use, MaybeLiveUses);
 433     }
 434     if (const InsertValueInst *IV = dyn_cast<InsertValueInst>(V)) {
 435       if (U.getOperandNo() != InsertValueInst::getAggregateOperandIndex()
 436           && IV->hasIndices())
 437         // The use we are examining is inserted into an aggregate. Our liveness
 438         // depends on all uses of that aggregate, but if it is used as a return
 439         // value, only index at which we were inserted counts.
 440         RetValNum = *IV->idx_begin();
 441
 442       // Note that if we are used as the aggregate operand to the insertvalue,
 443       // we don't change RetValNum, but do survey all our uses.
 444
 445       Liveness Result = MaybeLive;
 446       for (Value::const_use_iterator I = IV->use_begin(),
 447            E = V->use_end(); I != E; ++I) {
 448         Result = SurveyUse(I, MaybeLiveUses, RetValNum);
 449         if (Result == Live)
 450           break;
 451       }
 452       return Result;
 453     }
 454
 455     if (ImmutableCallSite CS = V) {
 456       const Function *F = CS.getCalledFunction();
 457       if (F) {
 458         // Used in a direct call.
 459
 460         // Find the argument number. We know for sure that this use is an
 461         // argument, since if it was the function argument this would be an
 462         // indirect call and the we know can't be looking at a value of the
 463         // label type (for the invoke instruction).
 464         unsigned ArgNo = CS.getArgumentNo(U);
 465
 466         if (ArgNo >= F->getFunctionType()->getNumParams())
 467           // The value is passed in through a vararg! Must be live.
 468           return Live;
 469
 470         assert(CS.getArgument(ArgNo)
 471                == CS->getOperand(U.getOperandNo())
 472                && "Argument is not where we expected it");
 473
 474         // Value passed to a normal call. It's only live when the corresponding
 475         // argument to the called function turns out live.
 476         RetOrArg Use = CreateArg(F, ArgNo);
 477         return MarkIfNotLive(Use, MaybeLiveUses);
 478       }
 479     }
 480     // Used in any other way? Value must be live.
 481     return Live;
 482 }
 483
 484 /// SurveyUses - This looks at all the uses of the given value
 485 /// Returns the Liveness deduced from the uses of this value.
 486 ///
 487 /// Adds all uses that cause the result to be MaybeLive to MaybeLiveRetUses. If
 488 /// the result is Live, MaybeLiveUses might be modified but its content should
 489 /// be ignored (since it might not be complete).
 490 DAE::Liveness DAE::SurveyUses(const Value *V, UseVector &MaybeLiveUses) {
 491   // Assume it's dead (which will only hold if there are no uses at all..).
 492   Liveness Result = MaybeLive;
 493   // Check each use.
 494   for (Value::const_use_iterator I = V->use_begin(),
 495        E = V->use_end(); I != E; ++I) {
 496     Result = SurveyUse(I, MaybeLiveUses);
 497     if (Result == Live)
 498       break;
 499   }
 500   return Result;
 501 }
 502
 503 // SurveyFunction - This performs the initial survey of the specified function,
 504 // checking out whether or not it uses any of its incoming arguments or whether
 505 // any callers use the return value.  This fills in the LiveValues set and Uses
 506 // map.
 507 //
 508 // We consider arguments of non-internal functions to be intrinsically alive as
 509 // well as arguments to functions which have their "address taken".
 510 //
 511 void DAE::SurveyFunction(const Function &F) {
 512   unsigned RetCount = NumRetVals(&F);
 513   // Assume all return values are dead
 514   typedef SmallVector<Liveness, 5> RetVals;
 515   RetVals RetValLiveness(RetCount, MaybeLive);
 516
 517   typedef SmallVector<UseVector, 5> RetUses;
 518   // These vectors map each return value to the uses that make it MaybeLive, so
 519   // we can add those to the Uses map if the return value really turns out to be
 520   // MaybeLive. Initialized to a list of RetCount empty lists.
 521   RetUses MaybeLiveRetUses(RetCount);
 522
 523   for (Function::const_iterator BB = F.begin(), E = F.end(); BB != E; ++BB)
 524     if (const ReturnInst *RI = dyn_cast<ReturnInst>(BB->getTerminator()))
 525       if (RI->getNumOperands() != 0 && RI->getOperand(0)->getType()
 526           != F.getFunctionType()->getReturnType()) {
 527         // We don't support old style multiple return values.
 528         MarkLive(F);
 529         return;
 530       }
 531
 532   if (!F.hasLocalLinkage() && (!ShouldHackArguments() || F.isIntrinsic())) {
 533     MarkLive(F);
 534     return;
 535   }
 536
 537   DEBUG(dbgs() << "DAE - Inspecting callers for fn: " << F.getName() << "\n");
 538   // Keep track of the number of live retvals, so we can skip checks once all
 539   // of them turn out to be live.
 540   unsigned NumLiveRetVals = 0;
 541   Type *STy = dyn_cast<StructType>(F.getReturnType());
 542   // Loop all uses of the function.
 543   for (Value::const_use_iterator I = F.use_begin(), E = F.use_end();
 544        I != E; ++I) {
 545     // If the function is PASSED IN as an argument, its address has been
 546     // taken.
 547     ImmutableCallSite CS(*I);
 548     if (!CS || !CS.isCallee(I)) {
 549       MarkLive(F);
 550       return;
 551     }
 552
 553     // If this use is anything other than a call site, the function is alive.
 554     const Instruction *TheCall = CS.getInstruction();
 555     if (!TheCall) {   // Not a direct call site?
 556       MarkLive(F);
 557       return;
 558     }
 559
 560     // If we end up here, we are looking at a direct call to our function.
 561
 562     // Now, check how our return value(s) is/are used in this caller. Don't
 563     // bother checking return values if all of them are live already.
 564     if (NumLiveRetVals != RetCount) {
 565       if (STy) {
 566         // Check all uses of the return value.
 567         for (Value::const_use_iterator I = TheCall->use_begin(),
 568              E = TheCall->use_end(); I != E; ++I) {
 569           const ExtractValueInst *Ext = dyn_cast<ExtractValueInst>(*I);
 570           if (Ext && Ext->hasIndices()) {
 571             // This use uses a part of our return value, survey the uses of
 572             // that part and store the results for this index only.
 573             unsigned Idx = *Ext->idx_begin();
 574             if (RetValLiveness[Idx] != Live) {
 575               RetValLiveness[Idx] = SurveyUses(Ext, MaybeLiveRetUses[Idx]);
 576               if (RetValLiveness[Idx] == Live)
 577                 NumLiveRetVals++;
 578             }
 579           } else {
 580             // Used by something else than extractvalue. Mark all return
 581             // values as live.
 582             for (unsigned i = 0; i != RetCount; ++i )
 583               RetValLiveness[i] = Live;
 584             NumLiveRetVals = RetCount;
 585             break;
 586           }
 587         }
 588       } else {
 589         // Single return value
 590         RetValLiveness[0] = SurveyUses(TheCall, MaybeLiveRetUses[0]);
 591         if (RetValLiveness[0] == Live)
 592           NumLiveRetVals = RetCount;
 593       }
 594     }
 595   }
 596
 597   // Now we've inspected all callers, record the liveness of our return values.
 598   for (unsigned i = 0; i != RetCount; ++i)
 599     MarkValue(CreateRet(&F, i), RetValLiveness[i], MaybeLiveRetUses[i]);
 600
 601   DEBUG(dbgs() << "DAE - Inspecting args for fn: " << F.getName() << "\n");
 602
 603   // Now, check all of our arguments.
 604   unsigned i = 0;
 605   UseVector MaybeLiveArgUses;
 606   for (Function::const_arg_iterator AI = F.arg_begin(),
 607        E = F.arg_end(); AI != E; ++AI, ++i) {
 608     Liveness Result;
 609     if (F.getFunctionType()->isVarArg()) {
 610       // Variadic functions will already have a va_arg function expanded inside
 611       // them, making them potentially very sensitive to ABI changes resulting
 612       // from removing arguments entirely, so don't. For example AArch64 handles
 613       // register and stack HFAs very differently, and this is reflected in the
 614       // IR which has already been generated.
 615       Result = Live;
 616     } else {
 617       // See what the effect of this use is (recording any uses that cause
 618       // MaybeLive in MaybeLiveArgUses).
 619       Result = SurveyUses(AI, MaybeLiveArgUses);
 620     }
 621
 622     // Mark the result.
 623     MarkValue(CreateArg(&F, i), Result, MaybeLiveArgUses);
 624     // Clear the vector again for the next iteration.
 625     MaybeLiveArgUses.clear();
 626   }
 627 }
 628
 629 /// MarkValue - This function marks the liveness of RA depending on L. If L is
 630 /// MaybeLive, it also takes all uses in MaybeLiveUses and records them in Uses,
 631 /// such that RA will be marked live if any use in MaybeLiveUses gets marked
 632 /// live later on.
 633 void DAE::MarkValue(const RetOrArg &RA, Liveness L,
 634                     const UseVector &MaybeLiveUses) {
 635   switch (L) {
 636     case Live: MarkLive(RA); break;
 637     case MaybeLive:
 638     {
 639       // Note any uses of this value, so this return value can be
 640       // marked live whenever one of the uses becomes live.
 641       for (UseVector::const_iterator UI = MaybeLiveUses.begin(),
 642            UE = MaybeLiveUses.end(); UI != UE; ++UI)
 643         Uses.insert(std::make_pair(*UI, RA));
 644       break;
 645     }
 646   }
 647 }
 648
 649 /// MarkLive - Mark the given Function as alive, meaning that it cannot be
 650 /// changed in any way. Additionally,
 651 /// mark any values that are used as this function's parameters or by its return
 652 /// values (according to Uses) live as well.
 653 void DAE::MarkLive(const Function &F) {
 654   DEBUG(dbgs() << "DAE - Intrinsically live fn: " << F.getName() << "\n");
 655   // Mark the function as live.
 656   LiveFunctions.insert(&F);
 657   // Mark all arguments as live.
 658   for (unsigned i = 0, e = F.arg_size(); i != e; ++i)
 659     PropagateLiveness(CreateArg(&F, i));
 660   // Mark all return values as live.
 661   for (unsigned i = 0, e = NumRetVals(&F); i != e; ++i)
 662     PropagateLiveness(CreateRet(&F, i));
 663 }
 664
 665 /// MarkLive - Mark the given return value or argument as live. Additionally,
 666 /// mark any values that are used by this value (according to Uses) live as
 667 /// well.
 668 void DAE::MarkLive(const RetOrArg &RA) {
 669   if (LiveFunctions.count(RA.F))
 670     return; // Function was already marked Live.
 671
 672   if (!LiveValues.insert(RA).second)
 673     return; // We were already marked Live.
 674
 675   DEBUG(dbgs() << "DAE - Marking " << RA.getDescription() << " live\n");
 676   PropagateLiveness(RA);
 677 }
 678
 679 /// PropagateLiveness - Given that RA is a live value, propagate it's liveness
 680 /// to any other values it uses (according to Uses).
 681 void DAE::PropagateLiveness(const RetOrArg &RA) {
 682   // We don't use upper_bound (or equal_range) here, because our recursive call
 683   // to ourselves is likely to cause the upper_bound (which is the first value
 684   // not belonging to RA) to become erased and the iterator invalidated.
 685   UseMap::iterator Begin = Uses.lower_bound(RA);
 686   UseMap::iterator E = Uses.end();
 687   UseMap::iterator I;
 688   for (I = Begin; I != E && I->first == RA; ++I)
 689     MarkLive(I->second);
 690
 691   // Erase RA from the Uses map (from the lower bound to wherever we ended up
 692   // after the loop).
 693   Uses.erase(Begin, I);
 694 }
 695
 696 // RemoveDeadStuffFromFunction - Remove any arguments and return values from F
 697 // that are not in LiveValues. Transform the function and all of the callees of
 698 // the function to not have these arguments and return values.
 699 //
 700 bool DAE::RemoveDeadStuffFromFunction(Function *F) {
 701   // Don't modify fully live functions
 702   if (LiveFunctions.count(F))
 703     return false;
 704
 705   // Start by computing a new prototype for the function, which is the same as
 706   // the old function, but has fewer arguments and a different return type.
 707   FunctionType *FTy = F->getFunctionType();
 708   std::vector<Type*> Params;
 709
 710   // Set up to build a new list of parameter attributes.
 711   SmallVector<AttributeSet, 8> AttributesVec;
 712   const AttributeSet &PAL = F->getAttributes();
 713
 714   // Find out the new return value.
 715   Type *RetTy = FTy->getReturnType();
 716   Type *NRetTy = NULL;
 717   unsigned RetCount = NumRetVals(F);
 718
 719   // -1 means unused, other numbers are the new index
 720   SmallVector<int, 5> NewRetIdxs(RetCount, -1);
 721   std::vector<Type*> RetTypes;
 722   if (RetTy->isVoidTy()) {
 723     NRetTy = RetTy;
 724   } else {
 725     StructType *STy = dyn_cast<StructType>(RetTy);
 726     if (STy)
 727       // Look at each of the original return values individually.
 728       for (unsigned i = 0; i != RetCount; ++i) {
 729         RetOrArg Ret = CreateRet(F, i);
 730         if (LiveValues.erase(Ret)) {
 731           RetTypes.push_back(STy->getElementType(i));
 732           NewRetIdxs[i] = RetTypes.size() - 1;
 733         } else {
 734           ++NumRetValsEliminated;
 735           DEBUG(dbgs() << "DAE - Removing return value " << i << " from "
 736                 << F->getName() << "\n");
 737         }
 738       }
 739     else
 740       // We used to return a single value.
 741       if (LiveValues.erase(CreateRet(F, 0))) {
 742         RetTypes.push_back(RetTy);
 743         NewRetIdxs[0] = 0;
 744       } else {
 745         DEBUG(dbgs() << "DAE - Removing return value from " << F->getName()
 746               << "\n");
 747         ++NumRetValsEliminated;
 748       }
 749     if (RetTypes.size() > 1)
 750       // More than one return type? Return a struct with them. Also, if we used
 751       // to return a struct and didn't change the number of return values,
 752       // return a struct again. This prevents changing {something} into
 753       // something and {} into void.
 754       // Make the new struct packed if we used to return a packed struct
 755       // already.
 756       NRetTy = StructType::get(STy->getContext(), RetTypes, STy->isPacked());
 757     else if (RetTypes.size() == 1)
 758       // One return type? Just a simple value then, but only if we didn't use to
 759       // return a struct with that simple value before.
 760       NRetTy = RetTypes.front();
 761     else if (RetTypes.size() == 0)
 762       // No return types? Make it void, but only if we didn't use to return {}.
 763       NRetTy = Type::getVoidTy(F->getContext());
 764   }
 765
 766   assert(NRetTy && "No new return type found?");
 767
 768   // The existing function return attributes.
 769   AttributeSet RAttrs = PAL.getRetAttributes();
 770
 771   // Remove any incompatible attributes, but only if we removed all return
 772   // values. Otherwise, ensure that we don't have any conflicting attributes
 773   // here. Currently, this should not be possible, but special handling might be
 774   // required when new return value attributes are added.
 775   if (NRetTy->isVoidTy())
 776     RAttrs =
 777       AttributeSet::get(NRetTy->getContext(), AttributeSet::ReturnIndex,
 778                         AttrBuilder(RAttrs, AttributeSet::ReturnIndex).
 779          removeAttributes(AttributeFuncs::
 780                           typeIncompatible(NRetTy, AttributeSet::ReturnIndex),
 781                           AttributeSet::ReturnIndex));
 782   else
 783     assert(!AttrBuilder(RAttrs, AttributeSet::ReturnIndex).
 784              hasAttributes(AttributeFuncs::
 785                            typeIncompatible(NRetTy, AttributeSet::ReturnIndex),
 786                            AttributeSet::ReturnIndex) &&
 787            "Return attributes no longer compatible?");
 788
 789   if (RAttrs.hasAttributes(AttributeSet::ReturnIndex))
 790     AttributesVec.push_back(AttributeSet::get(NRetTy->getContext(), RAttrs));
 791
 792   // Remember which arguments are still alive.
 793   SmallVector<bool, 10> ArgAlive(FTy->getNumParams(), false);
 794   // Construct the new parameter list from non-dead arguments. Also construct
 795   // a new set of parameter attributes to correspond. Skip the first parameter
 796   // attribute, since that belongs to the return value.
 797   unsigned i = 0;
 798   for (Function::arg_iterator I = F->arg_begin(), E = F->arg_end();
 799        I != E; ++I, ++i) {
 800     RetOrArg Arg = CreateArg(F, i);
 801     if (LiveValues.erase(Arg)) {
 802       Params.push_back(I->getType());
 803       ArgAlive[i] = true;
 804
 805       // Get the original parameter attributes (skipping the first one, that is
 806       // for the return value.
 807       if (PAL.hasAttributes(i + 1)) {
 808         AttrBuilder B(PAL, i + 1);
 809         AttributesVec.
 810           push_back(AttributeSet::get(F->getContext(), Params.size(), B));
 811       }
 812     } else {
 813       ++NumArgumentsEliminated;
 814       DEBUG(dbgs() << "DAE - Removing argument " << i << " (" << I->getName()
 815             << ") from " << F->getName() << "\n");
 816     }
 817   }
 818
 819   if (PAL.hasAttributes(AttributeSet::FunctionIndex))
 820     AttributesVec.push_back(AttributeSet::get(F->getContext(),
 821                                               PAL.getFnAttributes()));
 822
 823   // Reconstruct the AttributesList based on the vector we constructed.
 824   AttributeSet NewPAL = AttributeSet::get(F->getContext(), AttributesVec);
 825
 826   // Create the new function type based on the recomputed parameters.
 827   FunctionType *NFTy = FunctionType::get(NRetTy, Params, FTy->isVarArg());
 828
 829   // No change?
 830   if (NFTy == FTy)
 831     return false;
 832
 833   // Create the new function body and insert it into the module...
 834   Function *NF = Function::Create(NFTy, F->getLinkage());
 835   NF->copyAttributesFrom(F);
 836   NF->setAttributes(NewPAL);
 837   // Insert the new function before the old function, so we won't be processing
 838   // it again.
 839   F->getParent()->getFunctionList().insert(F, NF);
 840   NF->takeName(F);
 841
 842   // Loop over all of the callers of the function, transforming the call sites
 843   // to pass in a smaller number of arguments into the new function.
 844   //
 845   std::vector<Value*> Args;
 846   while (!F->use_empty()) {
 847     CallSite CS(F->use_back());
 848     Instruction *Call = CS.getInstruction();
 849
 850     AttributesVec.clear();
 851     const AttributeSet &CallPAL = CS.getAttributes();
 852
 853     // The call return attributes.
 854     AttributeSet RAttrs = CallPAL.getRetAttributes();
 855
 856     // Adjust in case the function was changed to return void.
 857     RAttrs =
 858       AttributeSet::get(NF->getContext(), AttributeSet::ReturnIndex,
 859                         AttrBuilder(RAttrs, AttributeSet::ReturnIndex).
 860         removeAttributes(AttributeFuncs::
 861                          typeIncompatible(NF->getReturnType(),
 862                                           AttributeSet::ReturnIndex),
 863                          AttributeSet::ReturnIndex));
 864     if (RAttrs.hasAttributes(AttributeSet::ReturnIndex))
 865       AttributesVec.push_back(AttributeSet::get(NF->getContext(), RAttrs));
 866
 867     // Declare these outside of the loops, so we can reuse them for the second
 868     // loop, which loops the varargs.
 869     CallSite::arg_iterator I = CS.arg_begin();
 870     unsigned i = 0;
 871     // Loop over those operands, corresponding to the normal arguments to the
 872     // original function, and add those that are still alive.
 873     for (unsigned e = FTy->getNumParams(); i != e; ++I, ++i)
 874       if (ArgAlive[i]) {
 875         Args.push_back(*I);
 876         // Get original parameter attributes, but skip return attributes.
 877         if (CallPAL.hasAttributes(i + 1)) {
 878           AttrBuilder B(CallPAL, i + 1);
 879           AttributesVec.
 880             push_back(AttributeSet::get(F->getContext(), Args.size(), B));
 881         }
 882       }
 883
 884     // Push any varargs arguments on the list. Don't forget their attributes.
 885     for (CallSite::arg_iterator E = CS.arg_end(); I != E; ++I, ++i) {
 886       Args.push_back(*I);
 887       if (CallPAL.hasAttributes(i + 1)) {
 888         AttrBuilder B(CallPAL, i + 1);
 889         AttributesVec.
 890           push_back(AttributeSet::get(F->getContext(), Args.size(), B));
 891       }
 892     }
 893
 894     if (CallPAL.hasAttributes(AttributeSet::FunctionIndex))
 895       AttributesVec.push_back(AttributeSet::get(Call->getContext(),
 896                                                 CallPAL.getFnAttributes()));
 897
 898     // Reconstruct the AttributesList based on the vector we constructed.
 899     AttributeSet NewCallPAL = AttributeSet::get(F->getContext(), AttributesVec);
 900
 901     Instruction *New;
 902     if (InvokeInst *II = dyn_cast<InvokeInst>(Call)) {
 903       New = InvokeInst::Create(NF, II->getNormalDest(), II->getUnwindDest(),
 904                                Args, "", Call);
 905       cast<InvokeInst>(New)->setCallingConv(CS.getCallingConv());
 906       cast<InvokeInst>(New)->setAttributes(NewCallPAL);
 907     } else {
 908       New = CallInst::Create(NF, Args, "", Call);
 909       cast<CallInst>(New)->setCallingConv(CS.getCallingConv());
 910       cast<CallInst>(New)->setAttributes(NewCallPAL);
 911       if (cast<CallInst>(Call)->isTailCall())
 912         cast<CallInst>(New)->setTailCall();
 913     }
 914     New->setDebugLoc(Call->getDebugLoc());
 915
 916     Args.clear();
 917
 918     if (!Call->use_empty()) {
 919       if (New->getType() == Call->getType()) {
 920         // Return type not changed? Just replace users then.
 921         Call->replaceAllUsesWith(New);
 922         New->takeName(Call);
 923       } else if (New->getType()->isVoidTy()) {
 924         // Our return value has uses, but they will get removed later on.
 925         // Replace by null for now.
 926         if (!Call->getType()->isX86_MMXTy())
 927           Call->replaceAllUsesWith(Constant::getNullValue(Call->getType()));
 928       } else {
 929         assert(RetTy->isStructTy() &&
 930                "Return type changed, but not into a void. The old return type"
 931                " must have been a struct!");
 932         Instruction *InsertPt = Call;
 933         if (InvokeInst *II = dyn_cast<InvokeInst>(Call)) {
 934           BasicBlock::iterator IP = II->getNormalDest()->begin();
 935           while (isa<PHINode>(IP)) ++IP;
 936           InsertPt = IP;
 937         }
 938
 939         // We used to return a struct. Instead of doing smart stuff with all the
 940         // uses of this struct, we will just rebuild it using
 941         // extract/insertvalue chaining and let instcombine clean that up.
 942         //
 943         // Start out building up our return value from undef
 944         Value *RetVal = UndefValue::get(RetTy);
 945         for (unsigned i = 0; i != RetCount; ++i)
 946           if (NewRetIdxs[i] != -1) {
 947             Value *V;
 948             if (RetTypes.size() > 1)
 949               // We are still returning a struct, so extract the value from our
 950               // return value
 951               V = ExtractValueInst::Create(New, NewRetIdxs[i], "newret",
 952                                            InsertPt);
 953             else
 954               // We are now returning a single element, so just insert that
 955               V = New;
 956             // Insert the value at the old position
 957             RetVal = InsertValueInst::Create(RetVal, V, i, "oldret", InsertPt);
 958           }
 959         // Now, replace all uses of the old call instruction with the return
 960         // struct we built
 961         Call->replaceAllUsesWith(RetVal);
 962         New->takeName(Call);
 963       }
 964     }
 965
 966     // Finally, remove the old call from the program, reducing the use-count of
 967     // F.
 968     Call->eraseFromParent();
 969   }
 970
 971   // Since we have now created the new function, splice the body of the old
 972   // function right into the new function, leaving the old rotting hulk of the
 973   // function empty.
 974   NF->getBasicBlockList().splice(NF->begin(), F->getBasicBlockList());
 975
 976   // Loop over the argument list, transferring uses of the old arguments over to
 977   // the new arguments, also transferring over the names as well.
 978   i = 0;
 979   for (Function::arg_iterator I = F->arg_begin(), E = F->arg_end(),
 980        I2 = NF->arg_begin(); I != E; ++I, ++i)
 981     if (ArgAlive[i]) {
 982       // If this is a live argument, move the name and users over to the new
 983       // version.
 984       I->replaceAllUsesWith(I2);
 985       I2->takeName(I);
 986       ++I2;
 987     } else {
 988       // If this argument is dead, replace any uses of it with null constants
 989       // (these are guaranteed to become unused later on).
 990       if (!I->getType()->isX86_MMXTy())
 991         I->replaceAllUsesWith(Constant::getNullValue(I->getType()));
 992     }
 993
 994   // If we change the return value of the function we must rewrite any return
 995   // instructions.  Check this now.
 996   if (F->getReturnType() != NF->getReturnType())
 997     for (Function::iterator BB = NF->begin(), E = NF->end(); BB != E; ++BB)
 998       if (ReturnInst *RI = dyn_cast<ReturnInst>(BB->getTerminator())) {
 999         Value *RetVal;
1000
1001         if (NFTy->getReturnType()->isVoidTy()) {
1002           RetVal = 0;
1003         } else {
1004           assert (RetTy->isStructTy());
1005           // The original return value was a struct, insert
1006           // extractvalue/insertvalue chains to extract only the values we need
1007           // to return and insert them into our new result.
1008           // This does generate messy code, but we'll let it to instcombine to
1009           // clean that up.
1010           Value *OldRet = RI->getOperand(0);
1011           // Start out building up our return value from undef
1012           RetVal = UndefValue::get(NRetTy);
1013           for (unsigned i = 0; i != RetCount; ++i)
1014             if (NewRetIdxs[i] != -1) {
1015               ExtractValueInst *EV = ExtractValueInst::Create(OldRet, i,
1016                                                               "oldret", RI);
1017               if (RetTypes.size() > 1) {
1018                 // We're still returning a struct, so reinsert the value into
1019                 // our new return value at the new index
1020
1021                 RetVal = InsertValueInst::Create(RetVal, EV, NewRetIdxs[i],
1022                                                  "newret", RI);
1023               } else {
1024                 // We are now only returning a simple value, so just return the
1025                 // extracted value.
1026                 RetVal = EV;
1027               }
1028             }
1029         }
1030         // Replace the return instruction with one returning the new return
1031         // value (possibly 0 if we became void).
1032         ReturnInst::Create(F->getContext(), RetVal, RI);
1033         BB->getInstList().erase(RI);
1034       }
1035
1036   // Patch the pointer to LLVM function in debug info descriptor.
1037   FunctionDIMap::iterator DI = FunctionDIs.find(F);
1038   if (DI != FunctionDIs.end())
1039     DI->second.replaceFunction(NF);
1040
1041   // Now that the old function is dead, delete it.
1042   F->eraseFromParent();
1043
1044   return true;
1045 }
1046
1047 bool DAE::runOnModule(Module &M) {
1048   bool Changed = false;
1049
1050   // Collect debug info descriptors for functions.
1051   CollectFunctionDIs(M);
1052
1053   // First pass: Do a simple check to see if any functions can have their "..."
1054   // removed.  We can do this if they never call va_start.  This loop cannot be
1055   // fused with the next loop, because deleting a function invalidates
1056   // information computed while surveying other functions.
1057   DEBUG(dbgs() << "DAE - Deleting dead varargs\n");
1058   for (Module::iterator I = M.begin(), E = M.end(); I != E; ) {
1059     Function &F = *I++;
1060     if (F.getFunctionType()->isVarArg())
1061       Changed |= DeleteDeadVarargs(F);
1062   }
1063
1064   // Second phase:loop through the module, determining which arguments are live.
1065   // We assume all arguments are dead unless proven otherwise (allowing us to
1066   // determine that dead arguments passed into recursive functions are dead).
1067   //
1068   DEBUG(dbgs() << "DAE - Determining liveness\n");
1069   for (Module::iterator I = M.begin(), E = M.end(); I != E; ++I)
1070     SurveyFunction(*I);
1071
1072   // Now, remove all dead arguments and return values from each function in
1073   // turn.
1074   for (Module::iterator I = M.begin(), E = M.end(); I != E; ) {
1075     // Increment now, because the function will probably get removed (ie.
1076     // replaced by a new one).
1077     Function *F = I++;
1078     Changed |= RemoveDeadStuffFromFunction(F);
1079   }
1080
1081   // Finally, look for any unused parameters in functions with non-local
1082   // linkage and replace the passed in parameters with undef.
1083   for (Module::iterator I = M.begin(), E = M.end(); I != E; ++I) {
1084     Function& F = *I;
1085
1086     Changed |= RemoveDeadArgumentsFromCallers(F);
1087   }
1088
1089   return Changed;
1090 }