blob: 7b154be8c5b9a904b9c6a7cd26a047693d6cad12 [file] [log] [blame]
Chris Lattner946b2552004-04-18 05:20:17 +00001//===-- LoopUnroll.cpp - Loop unroller pass -------------------------------===//
Misha Brukmanb1c93172005-04-21 23:48:37 +00002//
Chris Lattner946b2552004-04-18 05:20:17 +00003// The LLVM Compiler Infrastructure
4//
Chris Lattnerf3ebc3f2007-12-29 20:36:04 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Misha Brukmanb1c93172005-04-21 23:48:37 +00007//
Chris Lattner946b2552004-04-18 05:20:17 +00008//===----------------------------------------------------------------------===//
9//
10// This pass implements a simple loop unroller. It works best when loops have
11// been canonicalized by the -indvars pass, allowing it to determine the trip
12// counts of loops easily.
Chris Lattner946b2552004-04-18 05:20:17 +000013//===----------------------------------------------------------------------===//
14
Sean Silvae3c18a52016-07-19 23:54:23 +000015#include "llvm/Transforms/Scalar/LoopUnrollPass.h"
Chandler Carruth3b057b32015-02-13 03:57:40 +000016#include "llvm/ADT/SetVector.h"
Chandler Carruth66b31302015-01-04 12:03:27 +000017#include "llvm/Analysis/AssumptionCache.h"
Chris Lattner679572e2011-01-02 07:35:53 +000018#include "llvm/Analysis/CodeMetrics.h"
Dehao Chend55bc4c2016-05-05 00:54:54 +000019#include "llvm/Analysis/GlobalsModRef.h"
Benjamin Kramer799003b2015-03-23 19:32:43 +000020#include "llvm/Analysis/InstructionSimplify.h"
Chandler Carruthed0881b2012-12-03 16:50:05 +000021#include "llvm/Analysis/LoopPass.h"
Sean Silvae3c18a52016-07-19 23:54:23 +000022#include "llvm/Analysis/LoopPassManager.h"
Michael Zolotukhin1da4afd2016-02-08 23:03:59 +000023#include "llvm/Analysis/LoopUnrollAnalyzer.h"
Adam Nemet12937c32016-07-29 19:29:47 +000024#include "llvm/Analysis/OptimizationDiagnosticInfo.h"
Dan Gohman0141c132010-07-26 18:11:16 +000025#include "llvm/Analysis/ScalarEvolution.h"
Michael Zolotukhina9aadd22015-02-05 02:34:00 +000026#include "llvm/Analysis/ScalarEvolutionExpressions.h"
Chandler Carruthbb9caa92013-01-21 13:04:33 +000027#include "llvm/Analysis/TargetTransformInfo.h"
Chandler Carruth9fb823b2013-01-02 11:36:10 +000028#include "llvm/IR/DataLayout.h"
Chandler Carruth5ad5f152014-01-13 09:26:24 +000029#include "llvm/IR/Dominators.h"
Benjamin Kramer799003b2015-03-23 19:32:43 +000030#include "llvm/IR/InstVisitor.h"
Chandler Carruth9fb823b2013-01-02 11:36:10 +000031#include "llvm/IR/IntrinsicInst.h"
Eli Benderskyff903242014-06-16 23:53:02 +000032#include "llvm/IR/Metadata.h"
Reid Spencer7c16caa2004-09-01 22:55:40 +000033#include "llvm/Support/CommandLine.h"
34#include "llvm/Support/Debug.h"
Daniel Dunbar0dd5e1e2009-07-25 00:23:56 +000035#include "llvm/Support/raw_ostream.h"
Dehao Chend55bc4c2016-05-05 00:54:54 +000036#include "llvm/Transforms/Scalar.h"
Chandler Carruth31088a92016-02-19 10:45:18 +000037#include "llvm/Transforms/Utils/LoopUtils.h"
Dan Gohman3dc2d922008-05-14 00:24:14 +000038#include "llvm/Transforms/Utils/UnrollLoop.h"
Duncan Sands67933e62008-05-16 09:30:00 +000039#include <climits>
Benjamin Kramer82de7d32016-05-27 14:27:24 +000040#include <utility>
Chris Lattner946b2552004-04-18 05:20:17 +000041
Dan Gohman3dc2d922008-05-14 00:24:14 +000042using namespace llvm;
Chris Lattner946b2552004-04-18 05:20:17 +000043
Chandler Carruth964daaa2014-04-22 02:55:47 +000044#define DEBUG_TYPE "loop-unroll"
45
Dan Gohmand78c4002008-05-13 00:00:25 +000046static cl::opt<unsigned>
Justin Bognera1dd4932016-01-12 00:55:26 +000047 UnrollThreshold("unroll-threshold", cl::Hidden,
Chandler Carruth9dabd142015-06-05 17:01:43 +000048 cl::desc("The baseline cost threshold for loop unrolling"));
49
50static cl::opt<unsigned> UnrollPercentDynamicCostSavedThreshold(
Michael Zolotukhin8f7a2422016-05-24 23:00:05 +000051 "unroll-percent-dynamic-cost-saved-threshold", cl::init(50), cl::Hidden,
Chandler Carruth9dabd142015-06-05 17:01:43 +000052 cl::desc("The percentage of estimated dynamic cost which must be saved by "
53 "unrolling to allow unrolling up to the max threshold."));
54
55static cl::opt<unsigned> UnrollDynamicCostSavingsDiscount(
Michael Zolotukhin8f7a2422016-05-24 23:00:05 +000056 "unroll-dynamic-cost-savings-discount", cl::init(100), cl::Hidden,
Chandler Carruth9dabd142015-06-05 17:01:43 +000057 cl::desc("This is the amount discounted from the total unroll cost when "
58 "the unrolled form has a high dynamic cost savings (triggered by "
59 "the '-unroll-perecent-dynamic-cost-saved-threshold' flag)."));
Dan Gohmand78c4002008-05-13 00:00:25 +000060
Michael Zolotukhina9aadd22015-02-05 02:34:00 +000061static cl::opt<unsigned> UnrollMaxIterationsCountToAnalyze(
Michael Zolotukhin8f7a2422016-05-24 23:00:05 +000062 "unroll-max-iteration-count-to-analyze", cl::init(10), cl::Hidden,
Michael Zolotukhina9aadd22015-02-05 02:34:00 +000063 cl::desc("Don't allow loop unrolling to simulate more than this number of"
64 "iterations when checking full unroll profitability"));
65
Dehao Chend55bc4c2016-05-05 00:54:54 +000066static cl::opt<unsigned> UnrollCount(
67 "unroll-count", cl::Hidden,
68 cl::desc("Use this unroll count for all loops including those with "
69 "unroll_count pragma values, for testing purposes"));
Dan Gohmand78c4002008-05-13 00:00:25 +000070
Dehao Chend55bc4c2016-05-05 00:54:54 +000071static cl::opt<unsigned> UnrollMaxCount(
72 "unroll-max-count", cl::Hidden,
73 cl::desc("Set the max unroll count for partial and runtime unrolling, for"
74 "testing purposes"));
Fiona Glaser045afc42016-04-06 16:57:25 +000075
Dehao Chend55bc4c2016-05-05 00:54:54 +000076static cl::opt<unsigned> UnrollFullMaxCount(
77 "unroll-full-max-count", cl::Hidden,
78 cl::desc(
79 "Set the max unroll count for full unrolling, for testing purposes"));
Fiona Glaser045afc42016-04-06 16:57:25 +000080
Matthijs Kooijman98b5c162008-07-29 13:21:23 +000081static cl::opt<bool>
Dehao Chend55bc4c2016-05-05 00:54:54 +000082 UnrollAllowPartial("unroll-allow-partial", cl::Hidden,
83 cl::desc("Allows loops to be partially unrolled until "
84 "-unroll-threshold loop size is reached."));
Matthijs Kooijman98b5c162008-07-29 13:21:23 +000085
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +000086static cl::opt<bool> UnrollAllowRemainder(
87 "unroll-allow-remainder", cl::Hidden,
88 cl::desc("Allow generation of a loop remainder (extra iterations) "
89 "when unrolling a loop."));
90
Andrew Trickd04d15292011-12-09 06:19:40 +000091static cl::opt<bool>
Dehao Chend55bc4c2016-05-05 00:54:54 +000092 UnrollRuntime("unroll-runtime", cl::ZeroOrMore, cl::Hidden,
93 cl::desc("Unroll loops with run-time trip counts"));
Andrew Trickd04d15292011-12-09 06:19:40 +000094
Haicheng Wu1ef17e92016-10-12 21:29:38 +000095static cl::opt<unsigned> UnrollMaxUpperBound(
96 "unroll-max-upperbound", cl::init(8), cl::Hidden,
97 cl::desc(
98 "The max of trip count upper bound that is considered in unrolling"));
99
Dehao Chend55bc4c2016-05-05 00:54:54 +0000100static cl::opt<unsigned> PragmaUnrollThreshold(
101 "pragma-unroll-threshold", cl::init(16 * 1024), cl::Hidden,
102 cl::desc("Unrolled size limit for loops with an unroll(full) or "
103 "unroll_count pragma."));
Justin Bognera1dd4932016-01-12 00:55:26 +0000104
Dehao Chen41d72a82016-11-17 01:17:02 +0000105static cl::opt<unsigned> FlatLoopTripCountThreshold(
106 "flat-loop-tripcount-threshold", cl::init(5), cl::Hidden,
107 cl::desc("If the runtime tripcount for the loop is lower than the "
108 "threshold, the loop is considered as flat and will be less "
109 "aggressively unrolled."));
110
Justin Bognera1dd4932016-01-12 00:55:26 +0000111/// A magic value for use with the Threshold parameter to indicate
112/// that the loop unroll should be performed regardless of how much
113/// code expansion would result.
114static const unsigned NoThreshold = UINT_MAX;
115
Justin Bognera1dd4932016-01-12 00:55:26 +0000116/// Gather the various unrolling parameters based on the defaults, compiler
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000117/// flags, TTI overrides and user specified parameters.
Justin Bognera1dd4932016-01-12 00:55:26 +0000118static TargetTransformInfo::UnrollingPreferences gatherUnrollingPreferences(
119 Loop *L, const TargetTransformInfo &TTI, Optional<unsigned> UserThreshold,
120 Optional<unsigned> UserCount, Optional<bool> UserAllowPartial,
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000121 Optional<bool> UserRuntime, Optional<bool> UserUpperBound) {
Justin Bognera1dd4932016-01-12 00:55:26 +0000122 TargetTransformInfo::UnrollingPreferences UP;
123
124 // Set up the defaults
125 UP.Threshold = 150;
Michael Zolotukhin58564982016-06-03 00:16:46 +0000126 UP.PercentDynamicCostSavedThreshold = 50;
127 UP.DynamicCostSavingsDiscount = 100;
Hans Wennborg719b26b2016-05-10 21:45:55 +0000128 UP.OptSizeThreshold = 0;
Justin Bognera1dd4932016-01-12 00:55:26 +0000129 UP.PartialThreshold = UP.Threshold;
Hans Wennborg719b26b2016-05-10 21:45:55 +0000130 UP.PartialOptSizeThreshold = 0;
Justin Bognera1dd4932016-01-12 00:55:26 +0000131 UP.Count = 0;
Jonas Paulsson58c5a7f2016-09-28 09:41:38 +0000132 UP.DefaultUnrollRuntimeCount = 8;
Justin Bognera1dd4932016-01-12 00:55:26 +0000133 UP.MaxCount = UINT_MAX;
Fiona Glaser045afc42016-04-06 16:57:25 +0000134 UP.FullUnrollMaxCount = UINT_MAX;
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000135 UP.BEInsns = 2;
Justin Bognera1dd4932016-01-12 00:55:26 +0000136 UP.Partial = false;
137 UP.Runtime = false;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000138 UP.AllowRemainder = true;
Justin Bognera1dd4932016-01-12 00:55:26 +0000139 UP.AllowExpensiveTripCount = false;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000140 UP.Force = false;
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000141 UP.UpperBound = false;
Justin Bognera1dd4932016-01-12 00:55:26 +0000142
143 // Override with any target specific settings
144 TTI.getUnrollingPreferences(L, UP);
145
146 // Apply size attributes
147 if (L->getHeader()->getParent()->optForSize()) {
148 UP.Threshold = UP.OptSizeThreshold;
149 UP.PartialThreshold = UP.PartialOptSizeThreshold;
150 }
151
Justin Bognera1dd4932016-01-12 00:55:26 +0000152 // Apply any user values specified by cl::opt
153 if (UnrollThreshold.getNumOccurrences() > 0) {
154 UP.Threshold = UnrollThreshold;
155 UP.PartialThreshold = UnrollThreshold;
156 }
157 if (UnrollPercentDynamicCostSavedThreshold.getNumOccurrences() > 0)
158 UP.PercentDynamicCostSavedThreshold =
159 UnrollPercentDynamicCostSavedThreshold;
160 if (UnrollDynamicCostSavingsDiscount.getNumOccurrences() > 0)
161 UP.DynamicCostSavingsDiscount = UnrollDynamicCostSavingsDiscount;
Fiona Glaser045afc42016-04-06 16:57:25 +0000162 if (UnrollMaxCount.getNumOccurrences() > 0)
163 UP.MaxCount = UnrollMaxCount;
164 if (UnrollFullMaxCount.getNumOccurrences() > 0)
165 UP.FullUnrollMaxCount = UnrollFullMaxCount;
Justin Bognera1dd4932016-01-12 00:55:26 +0000166 if (UnrollAllowPartial.getNumOccurrences() > 0)
167 UP.Partial = UnrollAllowPartial;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000168 if (UnrollAllowRemainder.getNumOccurrences() > 0)
169 UP.AllowRemainder = UnrollAllowRemainder;
Justin Bognera1dd4932016-01-12 00:55:26 +0000170 if (UnrollRuntime.getNumOccurrences() > 0)
171 UP.Runtime = UnrollRuntime;
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000172 if (UnrollMaxUpperBound == 0)
173 UP.UpperBound = false;
Justin Bognera1dd4932016-01-12 00:55:26 +0000174
175 // Apply user values provided by argument
176 if (UserThreshold.hasValue()) {
177 UP.Threshold = *UserThreshold;
178 UP.PartialThreshold = *UserThreshold;
179 }
180 if (UserCount.hasValue())
181 UP.Count = *UserCount;
182 if (UserAllowPartial.hasValue())
183 UP.Partial = *UserAllowPartial;
184 if (UserRuntime.hasValue())
185 UP.Runtime = *UserRuntime;
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000186 if (UserUpperBound.hasValue())
187 UP.UpperBound = *UserUpperBound;
Justin Bognera1dd4932016-01-12 00:55:26 +0000188
Justin Bognera1dd4932016-01-12 00:55:26 +0000189 return UP;
190}
191
Chris Lattner79a42ac2006-12-19 21:40:18 +0000192namespace {
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000193/// A struct to densely store the state of an instruction after unrolling at
194/// each iteration.
195///
196/// This is designed to work like a tuple of <Instruction *, int> for the
197/// purposes of hashing and lookup, but to be able to associate two boolean
198/// states with each key.
199struct UnrolledInstState {
200 Instruction *I;
201 int Iteration : 30;
202 unsigned IsFree : 1;
203 unsigned IsCounted : 1;
204};
205
206/// Hashing and equality testing for a set of the instruction states.
207struct UnrolledInstStateKeyInfo {
208 typedef DenseMapInfo<Instruction *> PtrInfo;
209 typedef DenseMapInfo<std::pair<Instruction *, int>> PairInfo;
210 static inline UnrolledInstState getEmptyKey() {
211 return {PtrInfo::getEmptyKey(), 0, 0, 0};
212 }
213 static inline UnrolledInstState getTombstoneKey() {
214 return {PtrInfo::getTombstoneKey(), 0, 0, 0};
215 }
216 static inline unsigned getHashValue(const UnrolledInstState &S) {
217 return PairInfo::getHashValue({S.I, S.Iteration});
218 }
219 static inline bool isEqual(const UnrolledInstState &LHS,
220 const UnrolledInstState &RHS) {
221 return PairInfo::isEqual({LHS.I, LHS.Iteration}, {RHS.I, RHS.Iteration});
222 }
223};
224}
225
226namespace {
Chandler Carruth02156082015-05-22 17:41:35 +0000227struct EstimatedUnrollCost {
Chandler Carruth9dabd142015-06-05 17:01:43 +0000228 /// \brief The estimated cost after unrolling.
Chandler Carruthb2fda0d2015-08-05 18:46:21 +0000229 int UnrolledCost;
Chandler Carruth302a1332015-02-13 02:10:56 +0000230
Chandler Carruth9dabd142015-06-05 17:01:43 +0000231 /// \brief The estimated dynamic cost of executing the instructions in the
232 /// rolled form.
Chandler Carruthb2fda0d2015-08-05 18:46:21 +0000233 int RolledDynamicCost;
Chandler Carruth02156082015-05-22 17:41:35 +0000234};
235}
Michael Zolotukhina9aadd22015-02-05 02:34:00 +0000236
Chandler Carruth02156082015-05-22 17:41:35 +0000237/// \brief Figure out if the loop is worth full unrolling.
238///
239/// Complete loop unrolling can make some loads constant, and we need to know
240/// if that would expose any further optimization opportunities. This routine
Michael Zolotukhinc4e4f332015-06-11 22:17:39 +0000241/// estimates this optimization. It computes cost of unrolled loop
242/// (UnrolledCost) and dynamic cost of the original loop (RolledDynamicCost). By
243/// dynamic cost we mean that we won't count costs of blocks that are known not
244/// to be executed (i.e. if we have a branch in the loop and we know that at the
245/// given iteration its condition would be resolved to true, we won't add up the
246/// cost of the 'false'-block).
247/// \returns Optional value, holding the RolledDynamicCost and UnrolledCost. If
248/// the analysis failed (no benefits expected from the unrolling, or the loop is
249/// too big to analyze), the returned value is None.
Benjamin Kramerfcdb1c12015-08-20 09:57:22 +0000250static Optional<EstimatedUnrollCost>
Chandler Carruth87adb7a2015-08-03 20:32:27 +0000251analyzeLoopUnrollCost(const Loop *L, unsigned TripCount, DominatorTree &DT,
252 ScalarEvolution &SE, const TargetTransformInfo &TTI,
Chandler Carruthb2fda0d2015-08-05 18:46:21 +0000253 int MaxUnrolledLoopSize) {
Chandler Carruth02156082015-05-22 17:41:35 +0000254 // We want to be able to scale offsets by the trip count and add more offsets
255 // to them without checking for overflows, and we already don't want to
256 // analyze *massive* trip counts, so we force the max to be reasonably small.
257 assert(UnrollMaxIterationsCountToAnalyze < (INT_MAX / 2) &&
258 "The unroll iterations max is too large!");
Michael Zolotukhina9aadd22015-02-05 02:34:00 +0000259
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000260 // Only analyze inner loops. We can't properly estimate cost of nested loops
261 // and we won't visit inner loops again anyway.
262 if (!L->empty())
263 return None;
264
Chandler Carruth02156082015-05-22 17:41:35 +0000265 // Don't simulate loops with a big or unknown tripcount
266 if (!UnrollMaxIterationsCountToAnalyze || !TripCount ||
267 TripCount > UnrollMaxIterationsCountToAnalyze)
268 return None;
Chandler Carrutha6ae8772015-05-12 23:32:56 +0000269
Chandler Carruth02156082015-05-22 17:41:35 +0000270 SmallSetVector<BasicBlock *, 16> BBWorklist;
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000271 SmallSetVector<std::pair<BasicBlock *, BasicBlock *>, 4> ExitWorklist;
Chandler Carruth02156082015-05-22 17:41:35 +0000272 DenseMap<Value *, Constant *> SimplifiedValues;
Chandler Carruth87adb7a2015-08-03 20:32:27 +0000273 SmallVector<std::pair<Value *, Constant *>, 4> SimplifiedInputValues;
Chandler Carruth3b057b32015-02-13 03:57:40 +0000274
Chandler Carruth9dabd142015-06-05 17:01:43 +0000275 // The estimated cost of the unrolled form of the loop. We try to estimate
276 // this by simplifying as much as we can while computing the estimate.
Chandler Carruthb2fda0d2015-08-05 18:46:21 +0000277 int UnrolledCost = 0;
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000278
Chandler Carruth9dabd142015-06-05 17:01:43 +0000279 // We also track the estimated dynamic (that is, actually executed) cost in
280 // the rolled form. This helps identify cases when the savings from unrolling
281 // aren't just exposing dead control flows, but actual reduced dynamic
282 // instructions due to the simplifications which we expect to occur after
283 // unrolling.
Chandler Carruthb2fda0d2015-08-05 18:46:21 +0000284 int RolledDynamicCost = 0;
Chandler Carruth8c863752015-02-13 03:48:38 +0000285
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000286 // We track the simplification of each instruction in each iteration. We use
287 // this to recursively merge costs into the unrolled cost on-demand so that
288 // we don't count the cost of any dead code. This is essentially a map from
289 // <instruction, int> to <bool, bool>, but stored as a densely packed struct.
290 DenseSet<UnrolledInstState, UnrolledInstStateKeyInfo> InstCostMap;
291
292 // A small worklist used to accumulate cost of instructions from each
293 // observable and reached root in the loop.
294 SmallVector<Instruction *, 16> CostWorklist;
295
296 // PHI-used worklist used between iterations while accumulating cost.
297 SmallVector<Instruction *, 4> PHIUsedList;
298
299 // Helper function to accumulate cost for instructions in the loop.
300 auto AddCostRecursively = [&](Instruction &RootI, int Iteration) {
301 assert(Iteration >= 0 && "Cannot have a negative iteration!");
302 assert(CostWorklist.empty() && "Must start with an empty cost list");
303 assert(PHIUsedList.empty() && "Must start with an empty phi used list");
304 CostWorklist.push_back(&RootI);
305 for (;; --Iteration) {
306 do {
307 Instruction *I = CostWorklist.pop_back_val();
308
309 // InstCostMap only uses I and Iteration as a key, the other two values
310 // don't matter here.
311 auto CostIter = InstCostMap.find({I, Iteration, 0, 0});
312 if (CostIter == InstCostMap.end())
313 // If an input to a PHI node comes from a dead path through the loop
314 // we may have no cost data for it here. What that actually means is
315 // that it is free.
316 continue;
317 auto &Cost = *CostIter;
318 if (Cost.IsCounted)
319 // Already counted this instruction.
320 continue;
321
322 // Mark that we are counting the cost of this instruction now.
323 Cost.IsCounted = true;
324
325 // If this is a PHI node in the loop header, just add it to the PHI set.
326 if (auto *PhiI = dyn_cast<PHINode>(I))
327 if (PhiI->getParent() == L->getHeader()) {
328 assert(Cost.IsFree && "Loop PHIs shouldn't be evaluated as they "
329 "inherently simplify during unrolling.");
330 if (Iteration == 0)
331 continue;
332
333 // Push the incoming value from the backedge into the PHI used list
334 // if it is an in-loop instruction. We'll use this to populate the
335 // cost worklist for the next iteration (as we count backwards).
336 if (auto *OpI = dyn_cast<Instruction>(
337 PhiI->getIncomingValueForBlock(L->getLoopLatch())))
338 if (L->contains(OpI))
339 PHIUsedList.push_back(OpI);
340 continue;
341 }
342
343 // First accumulate the cost of this instruction.
344 if (!Cost.IsFree) {
345 UnrolledCost += TTI.getUserCost(I);
346 DEBUG(dbgs() << "Adding cost of instruction (iteration " << Iteration
347 << "): ");
348 DEBUG(I->dump());
349 }
350
351 // We must count the cost of every operand which is not free,
352 // recursively. If we reach a loop PHI node, simply add it to the set
353 // to be considered on the next iteration (backwards!).
354 for (Value *Op : I->operands()) {
355 // Check whether this operand is free due to being a constant or
356 // outside the loop.
357 auto *OpI = dyn_cast<Instruction>(Op);
358 if (!OpI || !L->contains(OpI))
359 continue;
360
361 // Otherwise accumulate its cost.
362 CostWorklist.push_back(OpI);
363 }
364 } while (!CostWorklist.empty());
365
366 if (PHIUsedList.empty())
367 // We've exhausted the search.
368 break;
369
370 assert(Iteration > 0 &&
371 "Cannot track PHI-used values past the first iteration!");
372 CostWorklist.append(PHIUsedList.begin(), PHIUsedList.end());
373 PHIUsedList.clear();
374 }
375 };
376
Chandler Carruth87adb7a2015-08-03 20:32:27 +0000377 // Ensure that we don't violate the loop structure invariants relied on by
378 // this analysis.
379 assert(L->isLoopSimplifyForm() && "Must put loop into normal form first.");
380 assert(L->isLCSSAForm(DT) &&
381 "Must have loops in LCSSA form to track live-out values.");
382
Michael Zolotukhin80d13ba2015-07-28 20:07:29 +0000383 DEBUG(dbgs() << "Starting LoopUnroll profitability analysis...\n");
384
Chandler Carruth02156082015-05-22 17:41:35 +0000385 // Simulate execution of each iteration of the loop counting instructions,
386 // which would be simplified.
387 // Since the same load will take different values on different iterations,
388 // we literally have to go through all loop's iterations.
389 for (unsigned Iteration = 0; Iteration < TripCount; ++Iteration) {
Michael Zolotukhin80d13ba2015-07-28 20:07:29 +0000390 DEBUG(dbgs() << " Analyzing iteration " << Iteration << "\n");
Chandler Carruth87adb7a2015-08-03 20:32:27 +0000391
392 // Prepare for the iteration by collecting any simplified entry or backedge
393 // inputs.
394 for (Instruction &I : *L->getHeader()) {
395 auto *PHI = dyn_cast<PHINode>(&I);
396 if (!PHI)
397 break;
398
399 // The loop header PHI nodes must have exactly two input: one from the
400 // loop preheader and one from the loop latch.
401 assert(
402 PHI->getNumIncomingValues() == 2 &&
403 "Must have an incoming value only for the preheader and the latch.");
404
405 Value *V = PHI->getIncomingValueForBlock(
406 Iteration == 0 ? L->getLoopPreheader() : L->getLoopLatch());
407 Constant *C = dyn_cast<Constant>(V);
408 if (Iteration != 0 && !C)
409 C = SimplifiedValues.lookup(V);
410 if (C)
411 SimplifiedInputValues.push_back({PHI, C});
412 }
413
414 // Now clear and re-populate the map for the next iteration.
Chandler Carruth02156082015-05-22 17:41:35 +0000415 SimplifiedValues.clear();
Chandler Carruth87adb7a2015-08-03 20:32:27 +0000416 while (!SimplifiedInputValues.empty())
417 SimplifiedValues.insert(SimplifiedInputValues.pop_back_val());
418
Michael Zolotukhin9f520eb2016-02-26 02:57:05 +0000419 UnrolledInstAnalyzer Analyzer(Iteration, SimplifiedValues, SE, L);
Chandler Carruthf174a152015-05-22 02:47:29 +0000420
Chandler Carruth02156082015-05-22 17:41:35 +0000421 BBWorklist.clear();
422 BBWorklist.insert(L->getHeader());
423 // Note that we *must not* cache the size, this loop grows the worklist.
424 for (unsigned Idx = 0; Idx != BBWorklist.size(); ++Idx) {
425 BasicBlock *BB = BBWorklist[Idx];
Chandler Carruthf174a152015-05-22 02:47:29 +0000426
Chandler Carruth02156082015-05-22 17:41:35 +0000427 // Visit all instructions in the given basic block and try to simplify
428 // it. We don't change the actual IR, just count optimization
429 // opportunities.
430 for (Instruction &I : *BB) {
Dehao Chen977853b2016-09-30 18:30:04 +0000431 if (isa<DbgInfoIntrinsic>(I))
432 continue;
433
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000434 // Track this instruction's expected baseline cost when executing the
435 // rolled loop form.
436 RolledDynamicCost += TTI.getUserCost(&I);
Chandler Carruth17a04962015-02-13 03:49:41 +0000437
Chandler Carruth02156082015-05-22 17:41:35 +0000438 // Visit the instruction to analyze its loop cost after unrolling,
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000439 // and if the visitor returns true, mark the instruction as free after
440 // unrolling and continue.
441 bool IsFree = Analyzer.visit(I);
442 bool Inserted = InstCostMap.insert({&I, (int)Iteration,
443 (unsigned)IsFree,
444 /*IsCounted*/ false}).second;
445 (void)Inserted;
446 assert(Inserted && "Cannot have a state for an unvisited instruction!");
Chandler Carruth9dabd142015-06-05 17:01:43 +0000447
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000448 if (IsFree)
449 continue;
450
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000451 // Can't properly model a cost of a call.
452 // FIXME: With a proper cost model we should be able to do it.
453 if(isa<CallInst>(&I))
454 return None;
Chandler Carruth02156082015-05-22 17:41:35 +0000455
Haicheng Wue7877632016-08-17 22:42:58 +0000456 // If the instruction might have a side-effect recursively account for
457 // the cost of it and all the instructions leading up to it.
458 if (I.mayHaveSideEffects())
459 AddCostRecursively(I, Iteration);
460
Chandler Carruth02156082015-05-22 17:41:35 +0000461 // If unrolled body turns out to be too big, bail out.
Michael Zolotukhin80d13ba2015-07-28 20:07:29 +0000462 if (UnrolledCost > MaxUnrolledLoopSize) {
463 DEBUG(dbgs() << " Exceeded threshold.. exiting.\n"
464 << " UnrolledCost: " << UnrolledCost
465 << ", MaxUnrolledLoopSize: " << MaxUnrolledLoopSize
466 << "\n");
Chandler Carruth02156082015-05-22 17:41:35 +0000467 return None;
Michael Zolotukhin80d13ba2015-07-28 20:07:29 +0000468 }
Michael Zolotukhina9aadd22015-02-05 02:34:00 +0000469 }
Chandler Carruth415f4122015-02-13 02:17:39 +0000470
Michael Zolotukhin57776b82015-07-24 01:53:04 +0000471 TerminatorInst *TI = BB->getTerminator();
472
473 // Add in the live successors by first checking whether we have terminator
474 // that may be simplified based on the values simplified by this call.
Michael Zolotukhin1ecdeda2016-05-26 21:42:51 +0000475 BasicBlock *KnownSucc = nullptr;
Michael Zolotukhin57776b82015-07-24 01:53:04 +0000476 if (BranchInst *BI = dyn_cast<BranchInst>(TI)) {
477 if (BI->isConditional()) {
478 if (Constant *SimpleCond =
479 SimplifiedValues.lookup(BI->getCondition())) {
Michael Zolotukhin3a7d55b2015-07-29 18:10:29 +0000480 // Just take the first successor if condition is undef
481 if (isa<UndefValue>(SimpleCond))
Michael Zolotukhin1ecdeda2016-05-26 21:42:51 +0000482 KnownSucc = BI->getSuccessor(0);
483 else if (ConstantInt *SimpleCondVal =
484 dyn_cast<ConstantInt>(SimpleCond))
485 KnownSucc = BI->getSuccessor(SimpleCondVal->isZero() ? 1 : 0);
Michael Zolotukhin57776b82015-07-24 01:53:04 +0000486 }
487 }
488 } else if (SwitchInst *SI = dyn_cast<SwitchInst>(TI)) {
489 if (Constant *SimpleCond =
490 SimplifiedValues.lookup(SI->getCondition())) {
Michael Zolotukhin3a7d55b2015-07-29 18:10:29 +0000491 // Just take the first successor if condition is undef
492 if (isa<UndefValue>(SimpleCond))
Michael Zolotukhin1ecdeda2016-05-26 21:42:51 +0000493 KnownSucc = SI->getSuccessor(0);
494 else if (ConstantInt *SimpleCondVal =
495 dyn_cast<ConstantInt>(SimpleCond))
496 KnownSucc = SI->findCaseValue(SimpleCondVal).getCaseSuccessor();
Michael Zolotukhin57776b82015-07-24 01:53:04 +0000497 }
498 }
Michael Zolotukhin1ecdeda2016-05-26 21:42:51 +0000499 if (KnownSucc) {
500 if (L->contains(KnownSucc))
501 BBWorklist.insert(KnownSucc);
502 else
503 ExitWorklist.insert({BB, KnownSucc});
504 continue;
505 }
Michael Zolotukhin57776b82015-07-24 01:53:04 +0000506
Chandler Carruth02156082015-05-22 17:41:35 +0000507 // Add BB's successors to the worklist.
508 for (BasicBlock *Succ : successors(BB))
509 if (L->contains(Succ))
510 BBWorklist.insert(Succ);
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000511 else
512 ExitWorklist.insert({BB, Succ});
Michael Zolotukhind2268a72016-05-18 21:20:12 +0000513 AddCostRecursively(*TI, Iteration);
Michael Zolotukhina9aadd22015-02-05 02:34:00 +0000514 }
Chandler Carruth02156082015-05-22 17:41:35 +0000515
516 // If we found no optimization opportunities on the first iteration, we
517 // won't find them on later ones too.
Michael Zolotukhin80d13ba2015-07-28 20:07:29 +0000518 if (UnrolledCost == RolledDynamicCost) {
519 DEBUG(dbgs() << " No opportunities found.. exiting.\n"
520 << " UnrolledCost: " << UnrolledCost << "\n");
Chandler Carruth02156082015-05-22 17:41:35 +0000521 return None;
Michael Zolotukhin80d13ba2015-07-28 20:07:29 +0000522 }
Michael Zolotukhina9aadd22015-02-05 02:34:00 +0000523 }
Michael Zolotukhin963a6d92016-05-13 21:23:25 +0000524
525 while (!ExitWorklist.empty()) {
526 BasicBlock *ExitingBB, *ExitBB;
527 std::tie(ExitingBB, ExitBB) = ExitWorklist.pop_back_val();
528
529 for (Instruction &I : *ExitBB) {
530 auto *PN = dyn_cast<PHINode>(&I);
531 if (!PN)
532 break;
533
534 Value *Op = PN->getIncomingValueForBlock(ExitingBB);
535 if (auto *OpI = dyn_cast<Instruction>(Op))
536 if (L->contains(OpI))
537 AddCostRecursively(*OpI, TripCount - 1);
538 }
539 }
540
Michael Zolotukhin80d13ba2015-07-28 20:07:29 +0000541 DEBUG(dbgs() << "Analysis finished:\n"
542 << "UnrolledCost: " << UnrolledCost << ", "
543 << "RolledDynamicCost: " << RolledDynamicCost << "\n");
Chandler Carruth9dabd142015-06-05 17:01:43 +0000544 return {{UnrolledCost, RolledDynamicCost}};
Chandler Carruth02156082015-05-22 17:41:35 +0000545}
Michael Zolotukhina9aadd22015-02-05 02:34:00 +0000546
Dan Gohman49d08a52007-05-08 15:14:19 +0000547/// ApproximateLoopSize - Approximate the size of the loop.
Andrew Trickf7656012011-10-01 01:39:05 +0000548static unsigned ApproximateLoopSize(const Loop *L, unsigned &NumCalls,
Justin Lebar6827de12016-03-14 23:15:34 +0000549 bool &NotDuplicatable, bool &Convergent,
Hal Finkel57f03dd2014-09-07 13:49:57 +0000550 const TargetTransformInfo &TTI,
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000551 AssumptionCache *AC, unsigned BEInsns) {
Hal Finkel57f03dd2014-09-07 13:49:57 +0000552 SmallPtrSet<const Value *, 32> EphValues;
Chandler Carruth66b31302015-01-04 12:03:27 +0000553 CodeMetrics::collectEphemeralValues(L, AC, EphValues);
Hal Finkel57f03dd2014-09-07 13:49:57 +0000554
Dan Gohman969e83a2009-10-31 14:54:17 +0000555 CodeMetrics Metrics;
Sanjay Patel5c967232016-03-08 19:06:12 +0000556 for (BasicBlock *BB : L->blocks())
557 Metrics.analyzeBasicBlock(BB, TTI, EphValues);
Owen Anderson04cf3fd2010-09-09 20:32:23 +0000558 NumCalls = Metrics.NumInlineCandidates;
James Molloy4f6fb952012-12-20 16:04:27 +0000559 NotDuplicatable = Metrics.notDuplicatable;
Justin Lebar6827de12016-03-14 23:15:34 +0000560 Convergent = Metrics.convergent;
Andrew Trick279e7a62011-07-23 00:29:16 +0000561
Owen Anderson62ea1b72010-09-09 19:07:31 +0000562 unsigned LoopSize = Metrics.NumInsts;
Andrew Trick279e7a62011-07-23 00:29:16 +0000563
Owen Anderson62ea1b72010-09-09 19:07:31 +0000564 // Don't allow an estimate of size zero. This would allows unrolling of loops
565 // with huge iteration counts, which is a compile time problem even if it's
Hal Finkel38dd5902015-01-10 00:30:55 +0000566 // not a problem for code quality. Also, the code using this size may assume
567 // that each loop has at least three instructions (likely a conditional
568 // branch, a comparison feeding that branch, and some kind of loop increment
569 // feeding that comparison instruction).
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000570 LoopSize = std::max(LoopSize, BEInsns + 1);
Andrew Trick279e7a62011-07-23 00:29:16 +0000571
Owen Anderson62ea1b72010-09-09 19:07:31 +0000572 return LoopSize;
Chris Lattner946b2552004-04-18 05:20:17 +0000573}
574
Mark Heffernane6b4ba12014-07-23 17:31:37 +0000575// Returns the loop hint metadata node with the given name (for example,
576// "llvm.loop.unroll.count"). If no such metadata node exists, then nullptr is
577// returned.
Jingyue Wu49a766e2015-02-02 20:41:11 +0000578static MDNode *GetUnrollMetadataForLoop(const Loop *L, StringRef Name) {
579 if (MDNode *LoopID = L->getLoopID())
580 return GetUnrollMetadata(LoopID, Name);
581 return nullptr;
Eli Benderskyff903242014-06-16 23:53:02 +0000582}
583
Mark Heffernane6b4ba12014-07-23 17:31:37 +0000584// Returns true if the loop has an unroll(full) pragma.
585static bool HasUnrollFullPragma(const Loop *L) {
Jingyue Wu0220df02015-02-01 02:27:45 +0000586 return GetUnrollMetadataForLoop(L, "llvm.loop.unroll.full");
Eli Benderskyff903242014-06-16 23:53:02 +0000587}
588
Mark Heffernan89391542015-08-10 17:28:08 +0000589// Returns true if the loop has an unroll(enable) pragma. This metadata is used
590// for both "#pragma unroll" and "#pragma clang loop unroll(enable)" directives.
591static bool HasUnrollEnablePragma(const Loop *L) {
592 return GetUnrollMetadataForLoop(L, "llvm.loop.unroll.enable");
593}
594
Eli Benderskyff903242014-06-16 23:53:02 +0000595// Returns true if the loop has an unroll(disable) pragma.
596static bool HasUnrollDisablePragma(const Loop *L) {
Jingyue Wu0220df02015-02-01 02:27:45 +0000597 return GetUnrollMetadataForLoop(L, "llvm.loop.unroll.disable");
Eli Benderskyff903242014-06-16 23:53:02 +0000598}
599
Kevin Qin715b01e2015-03-09 06:14:18 +0000600// Returns true if the loop has an runtime unroll(disable) pragma.
601static bool HasRuntimeUnrollDisablePragma(const Loop *L) {
602 return GetUnrollMetadataForLoop(L, "llvm.loop.unroll.runtime.disable");
603}
604
Eli Benderskyff903242014-06-16 23:53:02 +0000605// If loop has an unroll_count pragma return the (necessarily
606// positive) value from the pragma. Otherwise return 0.
607static unsigned UnrollCountPragmaValue(const Loop *L) {
Jingyue Wu49a766e2015-02-02 20:41:11 +0000608 MDNode *MD = GetUnrollMetadataForLoop(L, "llvm.loop.unroll.count");
Mark Heffernane6b4ba12014-07-23 17:31:37 +0000609 if (MD) {
610 assert(MD->getNumOperands() == 2 &&
611 "Unroll count hint metadata should have two operands.");
Duncan P. N. Exon Smith5bf8fef2014-12-09 18:38:53 +0000612 unsigned Count =
613 mdconst::extract<ConstantInt>(MD->getOperand(1))->getZExtValue();
Eli Benderskyff903242014-06-16 23:53:02 +0000614 assert(Count >= 1 && "Unroll count must be positive.");
615 return Count;
616 }
617 return 0;
618}
619
Mark Heffernan053a6862014-07-18 21:04:33 +0000620// Remove existing unroll metadata and add unroll disable metadata to
621// indicate the loop has already been unrolled. This prevents a loop
622// from being unrolled more than is directed by a pragma if the loop
623// unrolling pass is run more than once (which it generally is).
624static void SetLoopAlreadyUnrolled(Loop *L) {
625 MDNode *LoopID = L->getLoopID();
Mark Heffernan053a6862014-07-18 21:04:33 +0000626 // First remove any existing loop unrolling metadata.
Duncan P. N. Exon Smith5bf8fef2014-12-09 18:38:53 +0000627 SmallVector<Metadata *, 4> MDs;
Mark Heffernan053a6862014-07-18 21:04:33 +0000628 // Reserve first location for self reference to the LoopID metadata node.
Duncan P. N. Exon Smith5bf8fef2014-12-09 18:38:53 +0000629 MDs.push_back(nullptr);
Evgeny Stupachenko3e2f3892016-06-08 20:21:24 +0000630
631 if (LoopID) {
632 for (unsigned i = 1, ie = LoopID->getNumOperands(); i < ie; ++i) {
633 bool IsUnrollMetadata = false;
634 MDNode *MD = dyn_cast<MDNode>(LoopID->getOperand(i));
635 if (MD) {
636 const MDString *S = dyn_cast<MDString>(MD->getOperand(0));
637 IsUnrollMetadata = S && S->getString().startswith("llvm.loop.unroll.");
638 }
639 if (!IsUnrollMetadata)
640 MDs.push_back(LoopID->getOperand(i));
Mark Heffernan053a6862014-07-18 21:04:33 +0000641 }
Mark Heffernan053a6862014-07-18 21:04:33 +0000642 }
643
644 // Add unroll(disable) metadata to disable future unrolling.
645 LLVMContext &Context = L->getHeader()->getContext();
Duncan P. N. Exon Smith5bf8fef2014-12-09 18:38:53 +0000646 SmallVector<Metadata *, 1> DisableOperands;
Mark Heffernane6b4ba12014-07-23 17:31:37 +0000647 DisableOperands.push_back(MDString::get(Context, "llvm.loop.unroll.disable"));
Mark Heffernanf3764da2014-07-18 21:29:41 +0000648 MDNode *DisableNode = MDNode::get(Context, DisableOperands);
Duncan P. N. Exon Smith5bf8fef2014-12-09 18:38:53 +0000649 MDs.push_back(DisableNode);
Mark Heffernan053a6862014-07-18 21:04:33 +0000650
Duncan P. N. Exon Smith5bf8fef2014-12-09 18:38:53 +0000651 MDNode *NewLoopID = MDNode::get(Context, MDs);
Mark Heffernan053a6862014-07-18 21:04:33 +0000652 // Set operand 0 to refer to the loop id itself.
653 NewLoopID->replaceOperandWith(0, NewLoopID);
654 L->setLoopID(NewLoopID);
Mark Heffernan053a6862014-07-18 21:04:33 +0000655}
656
Justin Bogner921b04e2016-01-12 01:06:32 +0000657static bool canUnrollCompletely(Loop *L, unsigned Threshold,
658 unsigned PercentDynamicCostSavedThreshold,
659 unsigned DynamicCostSavingsDiscount,
660 uint64_t UnrolledCost,
661 uint64_t RolledDynamicCost) {
Michael Zolotukhin8c681712015-05-12 17:20:03 +0000662 if (Threshold == NoThreshold) {
663 DEBUG(dbgs() << " Can fully unroll, because no threshold is set.\n");
664 return true;
665 }
666
Chandler Carruth9dabd142015-06-05 17:01:43 +0000667 if (UnrolledCost <= Threshold) {
668 DEBUG(dbgs() << " Can fully unroll, because unrolled cost: "
Haicheng Wu109f4f32016-09-07 21:30:16 +0000669 << UnrolledCost << "<=" << Threshold << "\n");
Michael Zolotukhin8c681712015-05-12 17:20:03 +0000670 return true;
671 }
672
Chandler Carruth9dabd142015-06-05 17:01:43 +0000673 assert(UnrolledCost && "UnrolledCost can't be 0 at this point.");
674 assert(RolledDynamicCost >= UnrolledCost &&
675 "Cannot have a higher unrolled cost than a rolled cost!");
Michael Zolotukhin8c681712015-05-12 17:20:03 +0000676
Chandler Carruth9dabd142015-06-05 17:01:43 +0000677 // Compute the percentage of the dynamic cost in the rolled form that is
678 // saved when unrolled. If unrolling dramatically reduces the estimated
679 // dynamic cost of the loop, we use a higher threshold to allow more
680 // unrolling.
681 unsigned PercentDynamicCostSaved =
682 (uint64_t)(RolledDynamicCost - UnrolledCost) * 100ull / RolledDynamicCost;
683
684 if (PercentDynamicCostSaved >= PercentDynamicCostSavedThreshold &&
685 (int64_t)UnrolledCost - (int64_t)DynamicCostSavingsDiscount <=
686 (int64_t)Threshold) {
687 DEBUG(dbgs() << " Can fully unroll, because unrolling will reduce the "
Dehao Chend55bc4c2016-05-05 00:54:54 +0000688 "expected dynamic cost by "
689 << PercentDynamicCostSaved << "% (threshold: "
690 << PercentDynamicCostSavedThreshold << "%)\n"
Chandler Carruth9dabd142015-06-05 17:01:43 +0000691 << " and the unrolled cost (" << UnrolledCost
692 << ") is less than the max threshold ("
693 << DynamicCostSavingsDiscount << ").\n");
Michael Zolotukhin8c681712015-05-12 17:20:03 +0000694 return true;
695 }
696
697 DEBUG(dbgs() << " Too large to fully unroll:\n");
Chandler Carruth9dabd142015-06-05 17:01:43 +0000698 DEBUG(dbgs() << " Threshold: " << Threshold << "\n");
699 DEBUG(dbgs() << " Max threshold: " << DynamicCostSavingsDiscount << "\n");
700 DEBUG(dbgs() << " Percent cost saved threshold: "
701 << PercentDynamicCostSavedThreshold << "%\n");
702 DEBUG(dbgs() << " Unrolled cost: " << UnrolledCost << "\n");
703 DEBUG(dbgs() << " Rolled dynamic cost: " << RolledDynamicCost << "\n");
704 DEBUG(dbgs() << " Percent cost saved: " << PercentDynamicCostSaved
705 << "\n");
Michael Zolotukhin8c681712015-05-12 17:20:03 +0000706 return false;
707}
708
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000709// Returns loop size estimation for unrolled loop.
710static uint64_t getUnrolledLoopSize(
711 unsigned LoopSize,
712 TargetTransformInfo::UnrollingPreferences &UP) {
713 assert(LoopSize >= UP.BEInsns && "LoopSize should not be less than BEInsns!");
714 return (uint64_t)(LoopSize - UP.BEInsns) * UP.Count + UP.BEInsns;
715}
716
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000717// Returns true if unroll count was set explicitly.
718// Calculates unroll count and writes it to UP.Count.
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000719static bool computeUnrollCount(
720 Loop *L, const TargetTransformInfo &TTI, DominatorTree &DT, LoopInfo *LI,
721 ScalarEvolution *SE, OptimizationRemarkEmitter *ORE, unsigned &TripCount,
722 unsigned MaxTripCount, unsigned &TripMultiple, unsigned LoopSize,
723 TargetTransformInfo::UnrollingPreferences &UP, bool &UseUpperBound) {
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000724 // Check for explicit Count.
725 // 1st priority is unroll count set by "unroll-count" option.
726 bool UserUnrollCount = UnrollCount.getNumOccurrences() > 0;
727 if (UserUnrollCount) {
728 UP.Count = UnrollCount;
729 UP.AllowExpensiveTripCount = true;
730 UP.Force = true;
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000731 if (UP.AllowRemainder && getUnrolledLoopSize(LoopSize, UP) < UP.Threshold)
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000732 return true;
733 }
734
735 // 2nd priority is unroll count set by pragma.
736 unsigned PragmaCount = UnrollCountPragmaValue(L);
737 if (PragmaCount > 0) {
738 UP.Count = PragmaCount;
739 UP.Runtime = true;
740 UP.AllowExpensiveTripCount = true;
741 UP.Force = true;
742 if (UP.AllowRemainder &&
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000743 getUnrolledLoopSize(LoopSize, UP) < PragmaUnrollThreshold)
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000744 return true;
745 }
746 bool PragmaFullUnroll = HasUnrollFullPragma(L);
747 if (PragmaFullUnroll && TripCount != 0) {
748 UP.Count = TripCount;
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000749 if (getUnrolledLoopSize(LoopSize, UP) < PragmaUnrollThreshold)
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000750 return false;
751 }
752
753 bool PragmaEnableUnroll = HasUnrollEnablePragma(L);
754 bool ExplicitUnroll = PragmaCount > 0 || PragmaFullUnroll ||
755 PragmaEnableUnroll || UserUnrollCount;
756
Dehao Chen41d72a82016-11-17 01:17:02 +0000757 // Check if the runtime trip count is too small when profile is available.
758 if (L->getHeader()->getParent()->getEntryCount() && TripCount == 0) {
759 if (auto ProfileTripCount = getLoopEstimatedTripCount(L)) {
760 if (*ProfileTripCount < FlatLoopTripCountThreshold)
761 return false;
762 else
763 UP.AllowExpensiveTripCount = true;
764 }
765 }
766
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000767 if (ExplicitUnroll && TripCount != 0) {
768 // If the loop has an unrolling pragma, we want to be more aggressive with
769 // unrolling limits. Set thresholds to at least the PragmaThreshold value
770 // which is larger than the default limits.
771 UP.Threshold = std::max<unsigned>(UP.Threshold, PragmaUnrollThreshold);
772 UP.PartialThreshold =
773 std::max<unsigned>(UP.PartialThreshold, PragmaUnrollThreshold);
774 }
775
776 // 3rd priority is full unroll count.
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000777 // Full unroll makes sense only when TripCount or its upper bound could be
778 // statically calculated.
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000779 // Also we need to check if we exceed FullUnrollMaxCount.
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000780 // If using the upper bound to unroll, TripMultiple should be set to 1 because
781 // we do not know when loop may exit.
782 // MaxTripCount and ExactTripCount cannot both be non zero since we only
783 // compute the former when the latter is zero.
784 unsigned ExactTripCount = TripCount;
785 assert((ExactTripCount == 0 || MaxTripCount == 0) &&
786 "ExtractTripCound and MaxTripCount cannot both be non zero.");
787 unsigned FullUnrollTripCount = ExactTripCount ? ExactTripCount : MaxTripCount;
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000788 UP.Count = FullUnrollTripCount;
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000789 if (FullUnrollTripCount && FullUnrollTripCount <= UP.FullUnrollMaxCount) {
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000790 // When computing the unrolled size, note that BEInsns are not replicated
791 // like the rest of the loop body.
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000792 if (canUnrollCompletely(L, UP.Threshold, 100, UP.DynamicCostSavingsDiscount,
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000793 getUnrolledLoopSize(LoopSize, UP),
794 getUnrolledLoopSize(LoopSize, UP))) {
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000795 UseUpperBound = (MaxTripCount == FullUnrollTripCount);
796 TripCount = FullUnrollTripCount;
797 TripMultiple = UP.UpperBound ? 1 : TripMultiple;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000798 return ExplicitUnroll;
799 } else {
800 // The loop isn't that small, but we still can fully unroll it if that
801 // helps to remove a significant number of instructions.
802 // To check that, run additional analysis on the loop.
803 if (Optional<EstimatedUnrollCost> Cost = analyzeLoopUnrollCost(
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000804 L, FullUnrollTripCount, DT, *SE, TTI,
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000805 UP.Threshold + UP.DynamicCostSavingsDiscount))
806 if (canUnrollCompletely(L, UP.Threshold,
807 UP.PercentDynamicCostSavedThreshold,
808 UP.DynamicCostSavingsDiscount,
809 Cost->UnrolledCost, Cost->RolledDynamicCost)) {
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000810 UseUpperBound = (MaxTripCount == FullUnrollTripCount);
811 TripCount = FullUnrollTripCount;
812 TripMultiple = UP.UpperBound ? 1 : TripMultiple;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000813 return ExplicitUnroll;
814 }
815 }
816 }
817
818 // 4rd priority is partial unrolling.
819 // Try partial unroll only when TripCount could be staticaly calculated.
820 if (TripCount) {
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000821 UP.Partial |= ExplicitUnroll;
822 if (!UP.Partial) {
823 DEBUG(dbgs() << " will not try to unroll partially because "
824 << "-unroll-allow-partial not given\n");
825 UP.Count = 0;
826 return false;
827 }
Haicheng Wu430b3e42016-10-27 18:40:02 +0000828 if (UP.Count == 0)
829 UP.Count = TripCount;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000830 if (UP.PartialThreshold != NoThreshold) {
831 // Reduce unroll count to be modulo of TripCount for partial unrolling.
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000832 if (getUnrolledLoopSize(LoopSize, UP) > UP.PartialThreshold)
833 UP.Count =
834 (std::max(UP.PartialThreshold, UP.BEInsns + 1) - UP.BEInsns) /
835 (LoopSize - UP.BEInsns);
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000836 if (UP.Count > UP.MaxCount)
837 UP.Count = UP.MaxCount;
838 while (UP.Count != 0 && TripCount % UP.Count != 0)
839 UP.Count--;
840 if (UP.AllowRemainder && UP.Count <= 1) {
841 // If there is no Count that is modulo of TripCount, set Count to
842 // largest power-of-two factor that satisfies the threshold limit.
843 // As we'll create fixup loop, do the type of unrolling only if
844 // remainder loop is allowed.
Jonas Paulsson58c5a7f2016-09-28 09:41:38 +0000845 UP.Count = UP.DefaultUnrollRuntimeCount;
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000846 while (UP.Count != 0 &&
847 getUnrolledLoopSize(LoopSize, UP) > UP.PartialThreshold)
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000848 UP.Count >>= 1;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000849 }
850 if (UP.Count < 2) {
851 if (PragmaEnableUnroll)
Adam Nemetf57cc622016-09-30 03:44:16 +0000852 ORE->emit(
853 OptimizationRemarkMissed(DEBUG_TYPE, "UnrollAsDirectedTooLarge",
854 L->getStartLoc(), L->getHeader())
855 << "Unable to unroll loop as directed by unroll(enable) pragma "
856 "because unrolled size is too large.");
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000857 UP.Count = 0;
858 }
859 } else {
860 UP.Count = TripCount;
861 }
862 if ((PragmaFullUnroll || PragmaEnableUnroll) && TripCount &&
863 UP.Count != TripCount)
Adam Nemetf57cc622016-09-30 03:44:16 +0000864 ORE->emit(
865 OptimizationRemarkMissed(DEBUG_TYPE, "FullUnrollAsDirectedTooLarge",
866 L->getStartLoc(), L->getHeader())
867 << "Unable to fully unroll loop as directed by unroll pragma because "
868 "unrolled size is too large.");
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000869 return ExplicitUnroll;
870 }
871 assert(TripCount == 0 &&
872 "All cases when TripCount is constant should be covered here.");
873 if (PragmaFullUnroll)
Adam Nemetf57cc622016-09-30 03:44:16 +0000874 ORE->emit(
875 OptimizationRemarkMissed(DEBUG_TYPE,
876 "CantFullUnrollAsDirectedRuntimeTripCount",
877 L->getStartLoc(), L->getHeader())
878 << "Unable to fully unroll loop as directed by unroll(full) pragma "
879 "because loop has a runtime trip count.");
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000880
881 // 5th priority is runtime unrolling.
882 // Don't unroll a runtime trip count loop when it is disabled.
883 if (HasRuntimeUnrollDisablePragma(L)) {
884 UP.Count = 0;
885 return false;
886 }
887 // Reduce count based on the type of unrolling and the threshold values.
888 UP.Runtime |= PragmaEnableUnroll || PragmaCount > 0 || UserUnrollCount;
889 if (!UP.Runtime) {
890 DEBUG(dbgs() << " will not try to unroll loop with runtime trip count "
891 << "-unroll-runtime not given\n");
892 UP.Count = 0;
893 return false;
894 }
895 if (UP.Count == 0)
Jonas Paulsson58c5a7f2016-09-28 09:41:38 +0000896 UP.Count = UP.DefaultUnrollRuntimeCount;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000897
898 // Reduce unroll count to be the largest power-of-two factor of
899 // the original count which satisfies the threshold limit.
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000900 while (UP.Count != 0 &&
901 getUnrolledLoopSize(LoopSize, UP) > UP.PartialThreshold)
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000902 UP.Count >>= 1;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000903
Evgeny Stupachenkob7875222016-05-28 00:14:58 +0000904#ifndef NDEBUG
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000905 unsigned OrigCount = UP.Count;
Evgeny Stupachenkob7875222016-05-28 00:14:58 +0000906#endif
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000907
908 if (!UP.AllowRemainder && UP.Count != 0 && (TripMultiple % UP.Count) != 0) {
909 while (UP.Count != 0 && TripMultiple % UP.Count != 0)
910 UP.Count >>= 1;
911 DEBUG(dbgs() << "Remainder loop is restricted (that could architecture "
912 "specific or because the loop contains a convergent "
913 "instruction), so unroll count must divide the trip "
914 "multiple, "
915 << TripMultiple << ". Reducing unroll count from "
916 << OrigCount << " to " << UP.Count << ".\n");
Adam Nemetf57cc622016-09-30 03:44:16 +0000917 using namespace ore;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000918 if (PragmaCount > 0 && !UP.AllowRemainder)
Adam Nemetf57cc622016-09-30 03:44:16 +0000919 ORE->emit(
920 OptimizationRemarkMissed(DEBUG_TYPE,
921 "DifferentUnrollCountFromDirected",
922 L->getStartLoc(), L->getHeader())
923 << "Unable to unroll loop the number of times directed by "
924 "unroll_count pragma because remainder loop is restricted "
925 "(that could architecture specific or because the loop "
926 "contains a convergent instruction) and so must have an unroll "
927 "count that divides the loop trip multiple of "
928 << NV("TripMultiple", TripMultiple) << ". Unrolling instead "
929 << NV("UnrollCount", UP.Count) << " time(s).");
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000930 }
931
932 if (UP.Count > UP.MaxCount)
933 UP.Count = UP.MaxCount;
934 DEBUG(dbgs() << " partially unrolling with count: " << UP.Count << "\n");
935 if (UP.Count < 2)
936 UP.Count = 0;
937 return ExplicitUnroll;
938}
939
Justin Bognerb8d82ab2016-01-12 05:21:37 +0000940static bool tryToUnrollLoop(Loop *L, DominatorTree &DT, LoopInfo *LI,
941 ScalarEvolution *SE, const TargetTransformInfo &TTI,
Adam Nemet12937c32016-07-29 19:29:47 +0000942 AssumptionCache &AC, OptimizationRemarkEmitter &ORE,
943 bool PreserveLCSSA,
Justin Bognerb8d82ab2016-01-12 05:21:37 +0000944 Optional<unsigned> ProvidedCount,
945 Optional<unsigned> ProvidedThreshold,
946 Optional<bool> ProvidedAllowPartial,
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000947 Optional<bool> ProvidedRuntime,
948 Optional<bool> ProvidedUpperBound) {
Evgeny Stupachenkob7875222016-05-28 00:14:58 +0000949 DEBUG(dbgs() << "Loop Unroll: F[" << L->getHeader()->getParent()->getName()
950 << "] Loop %" << L->getHeader()->getName() << "\n");
Eli Benderskyff903242014-06-16 23:53:02 +0000951 if (HasUnrollDisablePragma(L)) {
952 return false;
953 }
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000954
955 unsigned NumInlineCandidates;
956 bool NotDuplicatable;
957 bool Convergent;
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000958 TargetTransformInfo::UnrollingPreferences UP = gatherUnrollingPreferences(
959 L, TTI, ProvidedThreshold, ProvidedCount, ProvidedAllowPartial,
960 ProvidedRuntime, ProvidedUpperBound);
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000961 unsigned LoopSize = ApproximateLoopSize(
Evgeny Stupachenkoc2698cd2016-11-09 19:56:39 +0000962 L, NumInlineCandidates, NotDuplicatable, Convergent, TTI, &AC, UP.BEInsns);
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000963 DEBUG(dbgs() << " Loop Size = " << LoopSize << "\n");
964 if (NotDuplicatable) {
965 DEBUG(dbgs() << " Not unrolling loop which contains non-duplicatable"
966 << " instructions.\n");
967 return false;
968 }
969 if (NumInlineCandidates != 0) {
970 DEBUG(dbgs() << " Not unrolling loop with inlinable calls.\n");
971 return false;
972 }
David Majnemer4a697c32016-06-15 00:19:56 +0000973 if (!L->isLoopSimplifyForm()) {
974 DEBUG(
975 dbgs() << " Not unrolling loop which is not in loop-simplify form.\n");
976 return false;
977 }
Andrew Trick279e7a62011-07-23 00:29:16 +0000978
Andrew Trick2b6860f2011-08-11 23:36:16 +0000979 // Find trip count and trip multiple if count is not available
980 unsigned TripCount = 0;
Haicheng Wu1ef17e92016-10-12 21:29:38 +0000981 unsigned MaxTripCount = 0;
Andrew Trick1cabe542011-07-23 00:33:05 +0000982 unsigned TripMultiple = 1;
Chandler Carruth6666c272014-10-11 00:12:11 +0000983 // If there are multiple exiting blocks but one of them is the latch, use the
984 // latch for the trip count estimation. Otherwise insist on a single exiting
985 // block for the trip count estimation.
986 BasicBlock *ExitingBlock = L->getLoopLatch();
987 if (!ExitingBlock || !L->isLoopExiting(ExitingBlock))
988 ExitingBlock = L->getExitingBlock();
989 if (ExitingBlock) {
990 TripCount = SE->getSmallConstantTripCount(L, ExitingBlock);
991 TripMultiple = SE->getSmallConstantTripMultiple(L, ExitingBlock);
Andrew Trick2b6860f2011-08-11 23:36:16 +0000992 }
Hal Finkel8f2e7002013-09-11 19:25:43 +0000993
Michael Zolotukhinbd63d432016-08-23 23:13:15 +0000994 // Exit early if unrolling is disabled.
995 if (UP.Threshold == 0 && (!UP.Partial || UP.PartialThreshold == 0))
996 return false;
997
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +0000998 // If the loop contains a convergent operation, the prelude we'd add
999 // to do the first few instructions before we hit the unrolled loop
1000 // is unsafe -- it adds a control-flow dependency to the convergent
1001 // operation. Therefore restrict remainder loop (try unrollig without).
1002 //
1003 // TODO: This is quite conservative. In practice, convergent_op()
1004 // is likely to be called unconditionally in the loop. In this
1005 // case, the program would be ill-formed (on most architectures)
1006 // unless n were the same on all threads in a thread group.
1007 // Assuming n is the same on all threads, any kind of unrolling is
1008 // safe. But currently llvm's notion of convergence isn't powerful
1009 // enough to express this.
1010 if (Convergent)
1011 UP.AllowRemainder = false;
Eli Benderskydc6de2c2014-06-12 18:05:39 +00001012
John Brawn84b21832016-10-21 11:08:48 +00001013 // Try to find the trip count upper bound if we cannot find the exact trip
1014 // count.
1015 bool MaxOrZero = false;
1016 if (!TripCount) {
1017 MaxTripCount = SE->getSmallConstantMaxTripCount(L);
1018 MaxOrZero = SE->isBackedgeTakenCountMaxOrZero(L);
1019 // We can unroll by the upper bound amount if it's generally allowed or if
1020 // we know that the loop is executed either the upper bound or zero times.
1021 // (MaxOrZero unrolling keeps only the first loop test, so the number of
1022 // loop tests remains the same compared to the non-unrolled version, whereas
1023 // the generic upper bound unrolling keeps all but the last loop test so the
1024 // number of loop tests goes up which may end up being worse on targets with
1025 // constriained branch predictor resources so is controlled by an option.)
1026 // In addition we only unroll small upper bounds.
1027 if (!(UP.UpperBound || MaxOrZero) || MaxTripCount > UnrollMaxUpperBound) {
1028 MaxTripCount = 0;
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001029 }
1030 }
1031
1032 // computeUnrollCount() decides whether it is beneficial to use upper bound to
1033 // fully unroll the loop.
1034 bool UseUpperBound = false;
1035 bool IsCountSetExplicitly =
1036 computeUnrollCount(L, TTI, DT, LI, SE, &ORE, TripCount, MaxTripCount,
1037 TripMultiple, LoopSize, UP, UseUpperBound);
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +00001038 if (!UP.Count)
Eli Benderskyff903242014-06-16 23:53:02 +00001039 return false;
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +00001040 // Unroll factor (Count) must be less or equal to TripCount.
1041 if (TripCount && UP.Count > TripCount)
1042 UP.Count = TripCount;
Dan Gohman2980d9d2007-05-11 20:53:41 +00001043
Dan Gohman3dc2d922008-05-14 00:24:14 +00001044 // Unroll the loop.
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +00001045 if (!UnrollLoop(L, UP.Count, TripCount, UP.Force, UP.Runtime,
John Brawn84b21832016-10-21 11:08:48 +00001046 UP.AllowExpensiveTripCount, UseUpperBound, MaxOrZero,
1047 TripMultiple, LI, SE, &DT, &AC, &ORE, PreserveLCSSA))
Dan Gohman3dc2d922008-05-14 00:24:14 +00001048 return false;
Dan Gohman2980d9d2007-05-11 20:53:41 +00001049
Evgeny Stupachenkoea2aef42016-05-27 23:15:06 +00001050 // If loop has an unroll count pragma or unrolled by explicitly set count
1051 // mark loop as unrolled to prevent unrolling beyond that requested.
1052 if (IsCountSetExplicitly)
David L Kreitzer8d441eb2016-03-25 14:24:52 +00001053 SetLoopAlreadyUnrolled(L);
Chris Lattner946b2552004-04-18 05:20:17 +00001054 return true;
1055}
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001056
1057namespace {
1058class LoopUnroll : public LoopPass {
1059public:
1060 static char ID; // Pass ID, replacement for typeid
1061 LoopUnroll(Optional<unsigned> Threshold = None,
1062 Optional<unsigned> Count = None,
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001063 Optional<bool> AllowPartial = None, Optional<bool> Runtime = None,
1064 Optional<bool> UpperBound = None)
Benjamin Kramer82de7d32016-05-27 14:27:24 +00001065 : LoopPass(ID), ProvidedCount(std::move(Count)),
1066 ProvidedThreshold(Threshold), ProvidedAllowPartial(AllowPartial),
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001067 ProvidedRuntime(Runtime), ProvidedUpperBound(UpperBound) {
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001068 initializeLoopUnrollPass(*PassRegistry::getPassRegistry());
1069 }
1070
1071 Optional<unsigned> ProvidedCount;
1072 Optional<unsigned> ProvidedThreshold;
1073 Optional<bool> ProvidedAllowPartial;
1074 Optional<bool> ProvidedRuntime;
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001075 Optional<bool> ProvidedUpperBound;
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001076
1077 bool runOnLoop(Loop *L, LPPassManager &) override {
Andrew Kayloraa641a52016-04-22 22:06:11 +00001078 if (skipLoop(L))
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001079 return false;
1080
1081 Function &F = *L->getHeader()->getParent();
1082
1083 auto &DT = getAnalysis<DominatorTreeWrapperPass>().getDomTree();
1084 LoopInfo *LI = &getAnalysis<LoopInfoWrapperPass>().getLoopInfo();
1085 ScalarEvolution *SE = &getAnalysis<ScalarEvolutionWrapperPass>().getSE();
1086 const TargetTransformInfo &TTI =
1087 getAnalysis<TargetTransformInfoWrapperPass>().getTTI(F);
1088 auto &AC = getAnalysis<AssumptionCacheTracker>().getAssumptionCache(F);
Adam Nemet4f155b62016-08-26 15:58:34 +00001089 // For the old PM, we can't use OptimizationRemarkEmitter as an analysis
1090 // pass. Function analyses need to be preserved across loop transformations
1091 // but ORE cannot be preserved (see comment before the pass definition).
1092 OptimizationRemarkEmitter ORE(&F);
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001093 bool PreserveLCSSA = mustPreserveAnalysisID(LCSSAID);
1094
Adam Nemet12937c32016-07-29 19:29:47 +00001095 return tryToUnrollLoop(L, DT, LI, SE, TTI, AC, ORE, PreserveLCSSA,
1096 ProvidedCount, ProvidedThreshold,
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001097 ProvidedAllowPartial, ProvidedRuntime,
1098 ProvidedUpperBound);
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001099 }
1100
1101 /// This transformation requires natural loop information & requires that
1102 /// loop preheaders be inserted into the CFG...
1103 ///
1104 void getAnalysisUsage(AnalysisUsage &AU) const override {
1105 AU.addRequired<AssumptionCacheTracker>();
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001106 AU.addRequired<TargetTransformInfoWrapperPass>();
Chandler Carruth31088a92016-02-19 10:45:18 +00001107 // FIXME: Loop passes are required to preserve domtree, and for now we just
1108 // recreate dom info if anything gets unrolled.
1109 getLoopAnalysisUsage(AU);
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001110 }
1111};
1112}
1113
1114char LoopUnroll::ID = 0;
1115INITIALIZE_PASS_BEGIN(LoopUnroll, "loop-unroll", "Unroll loops", false, false)
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001116INITIALIZE_PASS_DEPENDENCY(AssumptionCacheTracker)
Chandler Carruth31088a92016-02-19 10:45:18 +00001117INITIALIZE_PASS_DEPENDENCY(LoopPass)
1118INITIALIZE_PASS_DEPENDENCY(TargetTransformInfoWrapperPass)
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001119INITIALIZE_PASS_END(LoopUnroll, "loop-unroll", "Unroll loops", false, false)
1120
1121Pass *llvm::createLoopUnrollPass(int Threshold, int Count, int AllowPartial,
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001122 int Runtime, int UpperBound) {
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001123 // TODO: It would make more sense for this function to take the optionals
1124 // directly, but that's dangerous since it would silently break out of tree
1125 // callers.
1126 return new LoopUnroll(Threshold == -1 ? None : Optional<unsigned>(Threshold),
1127 Count == -1 ? None : Optional<unsigned>(Count),
1128 AllowPartial == -1 ? None
1129 : Optional<bool>(AllowPartial),
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001130 Runtime == -1 ? None : Optional<bool>(Runtime),
1131 UpperBound == -1 ? None : Optional<bool>(UpperBound));
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001132}
1133
1134Pass *llvm::createSimpleLoopUnrollPass() {
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001135 return llvm::createLoopUnrollPass(-1, -1, 0, 0, 0);
Justin Bognerb8d82ab2016-01-12 05:21:37 +00001136}
Sean Silvae3c18a52016-07-19 23:54:23 +00001137
Sean Silva0746f3b2016-08-09 00:28:52 +00001138PreservedAnalyses LoopUnrollPass::run(Loop &L, LoopAnalysisManager &AM) {
Sean Silvae3c18a52016-07-19 23:54:23 +00001139 const auto &FAM =
1140 AM.getResult<FunctionAnalysisManagerLoopProxy>(L).getManager();
1141 Function *F = L.getHeader()->getParent();
1142
1143
1144 DominatorTree *DT = FAM.getCachedResult<DominatorTreeAnalysis>(*F);
1145 LoopInfo *LI = FAM.getCachedResult<LoopAnalysis>(*F);
1146 ScalarEvolution *SE = FAM.getCachedResult<ScalarEvolutionAnalysis>(*F);
1147 auto *TTI = FAM.getCachedResult<TargetIRAnalysis>(*F);
1148 auto *AC = FAM.getCachedResult<AssumptionAnalysis>(*F);
Adam Nemet12937c32016-07-29 19:29:47 +00001149 auto *ORE = FAM.getCachedResult<OptimizationRemarkEmitterAnalysis>(*F);
Sean Silvae3c18a52016-07-19 23:54:23 +00001150 if (!DT)
Michael Kupersteincffedc42016-10-25 18:31:23 +00001151 report_fatal_error(
1152 "LoopUnrollPass: DominatorTreeAnalysis not cached at a higher level");
Sean Silvae3c18a52016-07-19 23:54:23 +00001153 if (!LI)
Michael Kupersteincffedc42016-10-25 18:31:23 +00001154 report_fatal_error(
1155 "LoopUnrollPass: LoopAnalysis not cached at a higher level");
Sean Silvae3c18a52016-07-19 23:54:23 +00001156 if (!SE)
Michael Kupersteincffedc42016-10-25 18:31:23 +00001157 report_fatal_error(
1158 "LoopUnrollPass: ScalarEvolutionAnalysis not cached at a higher level");
Sean Silvae3c18a52016-07-19 23:54:23 +00001159 if (!TTI)
Michael Kupersteincffedc42016-10-25 18:31:23 +00001160 report_fatal_error(
1161 "LoopUnrollPass: TargetIRAnalysis not cached at a higher level");
Sean Silvae3c18a52016-07-19 23:54:23 +00001162 if (!AC)
Michael Kupersteincffedc42016-10-25 18:31:23 +00001163 report_fatal_error(
1164 "LoopUnrollPass: AssumptionAnalysis not cached at a higher level");
Adam Nemet12937c32016-07-29 19:29:47 +00001165 if (!ORE)
1166 report_fatal_error("LoopUnrollPass: OptimizationRemarkEmitterAnalysis not "
1167 "cached at a higher level");
Sean Silvae3c18a52016-07-19 23:54:23 +00001168
Haicheng Wu1ef17e92016-10-12 21:29:38 +00001169 bool Changed =
1170 tryToUnrollLoop(&L, *DT, LI, SE, *TTI, *AC, *ORE, /*PreserveLCSSA*/ true,
1171 ProvidedCount, ProvidedThreshold, ProvidedAllowPartial,
1172 ProvidedRuntime, ProvidedUpperBound);
Sean Silvae3c18a52016-07-19 23:54:23 +00001173
1174 if (!Changed)
1175 return PreservedAnalyses::all();
1176 return getLoopPassPreservedAnalyses();
1177}