1 //===-- llvm/Support/PasaMangerBuilder.h - Build Standard Pass --*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file defines the PassManagerBuilder class, which is used to set up a
11 // "standard" optimization sequence suitable for languages like C and C++.
13 // These are implemented as inline functions so that we do not have to worry
16 //===----------------------------------------------------------------------===//
18 #ifndef LLVM_SUPPORT_PASSMANAGERBUILDER_H
19 #define LLVM_SUPPORT_PASSMANAGERBUILDER_H
21 #include "llvm/PassManager.h"
22 #include "llvm/DefaultPasses.h"
23 #include "llvm/Analysis/Passes.h"
24 #include "llvm/Analysis/Verifier.h"
25 #include "llvm/Target/TargetLibraryInfo.h"
26 #include "llvm/Transforms/Scalar.h"
27 #include "llvm/Transforms/IPO.h"
31 /// PassManagerBuilder - This class is used to set up a standard optimization
32 /// sequence for languages like C and C++, allowing some APIs to customize the
33 /// pass sequence in various ways. A simple example of using it would be:
35 /// OptimizerBuilder Builder;
36 /// Builder.setOptimizationLevel(2);
37 /// Builder.populateFunctionPassManager(FPM);
38 /// Builder.populateModulePassManager(MPM);
40 /// In addition to setting up the basic passes, PassManagerBuilder allows
41 /// frontends to vend a plugin API, where plugins are allowed to add extensions
42 /// to the default pass manager. They do this by specifying where in the pass
43 /// pipeline they want to be added, along with a callback function that adds
44 /// the pass(es). For example, a plugin that wanted to add a loop optimization
45 /// could do something like this:
47 /// static void addMyLoopPass(const PMBuilder &Builder, PassManagerBase &PM) {
48 /// if (Builder.getOptLevel() > 2 && Builder.getOptSizeLevel() == 0)
49 /// PM.add(createMyAwesomePass());
52 /// Builder.addExtension(PassManagerBuilder::EP_LoopOptimizerEnd,
55 class PassManagerBuilder {
58 /// Extensions are passed the builder itself (so they can see how it is
59 /// configured) as well as the pass manager to add stuff to.
60 typedef void (*ExtensionFn)(const PassManagerBuilder &Builder,
62 enum ExtensionPointTy {
63 /// EP_EarlyAsPossible - This extension point allows adding passes before
64 /// any other transformations, allowing them to see the code as it is coming
65 /// out of the frontend.
68 /// EP_LoopOptimizerEnd - This extension point allows adding loop passes to
69 /// the end of the loop optimizer.
73 /// The Optimization Level - Specify the basic optimization level.
74 /// 0 = -O0, 1 = -O1, 2 = -O2, 3 = -O3
77 /// SizeLevel - How much we're optimizing for size.
78 /// 0 = none, 1 = -Os, 2 = -Oz
81 /// LibraryInfo - Specifies information about the runtime library for the
82 /// optimizer. If this is non-null, it is added to both the function and
83 /// per-module pass pipeline.
84 TargetLibraryInfo *LibraryInfo;
86 /// Inliner - Specifies the inliner to use. If this is non-null, it is
87 /// added to the per-module passes.
90 bool DisableSimplifyLibCalls;
91 bool DisableUnitAtATime;
92 bool DisableUnrollLoops;
95 /// ExtensionList - This is list of all of the extensions that are registered.
96 std::vector<std::pair<ExtensionPointTy, ExtensionFn> > Extensions;
99 PassManagerBuilder() {
104 DisableSimplifyLibCalls = false;
105 DisableUnitAtATime = false;
106 DisableUnrollLoops = false;
109 ~PassManagerBuilder() {
114 void addExtension(ExtensionPointTy Ty, ExtensionFn Fn) {
115 Extensions.push_back(std::make_pair(Ty, Fn));
119 void addExtensionsToPM(ExtensionPointTy ETy, PassManagerBase &PM) const {
120 for (unsigned i = 0, e = Extensions.size(); i != e; ++i)
121 if (Extensions[i].first == ETy)
122 Extensions[i].second(*this, PM);
125 void addInitialAliasAnalysisPasses(PassManagerBase &PM) const {
126 // Add TypeBasedAliasAnalysis before BasicAliasAnalysis so that
127 // BasicAliasAnalysis wins if they disagree. This is intended to help
128 // support "obvious" type-punning idioms.
129 PM.add(createTypeBasedAliasAnalysisPass());
130 PM.add(createBasicAliasAnalysisPass());
134 /// populateFunctionPassManager - This fills in the function pass manager,
135 /// which is expected to be run on each function immediately as it is
136 /// generated. The idea is to reduce the size of the IR in memory.
137 void populateFunctionPassManager(FunctionPassManager &FPM) {
138 addExtensionsToPM(EP_EarlyAsPossible, FPM);
140 // Add LibraryInfo if we have some.
141 if (LibraryInfo) FPM.add(new TargetLibraryInfo(*LibraryInfo));
143 if (OptLevel == 0) return;
145 addInitialAliasAnalysisPasses(FPM);
147 FPM.add(createCFGSimplificationPass());
148 FPM.add(createScalarReplAggregatesPass());
149 FPM.add(createEarlyCSEPass());
152 /// populateModulePassManager - This sets up the primary pass manager.
153 void populateModulePassManager(PassManagerBase &MPM) {
154 // If all optimizations are disabled, just run the always-inline pass.
163 // Add LibraryInfo if we have some.
164 if (LibraryInfo) MPM.add(new TargetLibraryInfo(*LibraryInfo));
166 addInitialAliasAnalysisPasses(MPM);
168 if (!DisableUnitAtATime) {
169 MPM.add(createGlobalOptimizerPass()); // Optimize out global vars
171 MPM.add(createIPSCCPPass()); // IP SCCP
172 MPM.add(createDeadArgEliminationPass()); // Dead argument elimination
174 MPM.add(createInstructionCombiningPass());// Clean up after IPCP & DAE
175 MPM.add(createCFGSimplificationPass()); // Clean up after IPCP & DAE
178 // Start of CallGraph SCC passes.
179 if (!DisableUnitAtATime)
180 MPM.add(createPruneEHPass()); // Remove dead EH info
185 if (!DisableUnitAtATime)
186 MPM.add(createFunctionAttrsPass()); // Set readonly/readnone attrs
188 MPM.add(createArgumentPromotionPass()); // Scalarize uninlined fn args
190 // Start of function pass.
191 // Break up aggregate allocas, using SSAUpdater.
192 MPM.add(createScalarReplAggregatesPass(-1, false));
193 MPM.add(createEarlyCSEPass()); // Catch trivial redundancies
194 if (!DisableSimplifyLibCalls)
195 MPM.add(createSimplifyLibCallsPass()); // Library Call Optimizations
196 MPM.add(createJumpThreadingPass()); // Thread jumps.
197 MPM.add(createCorrelatedValuePropagationPass()); // Propagate conditionals
198 MPM.add(createCFGSimplificationPass()); // Merge & remove BBs
199 MPM.add(createInstructionCombiningPass()); // Combine silly seq's
201 MPM.add(createTailCallEliminationPass()); // Eliminate tail calls
202 MPM.add(createCFGSimplificationPass()); // Merge & remove BBs
203 MPM.add(createReassociatePass()); // Reassociate expressions
204 MPM.add(createLoopRotatePass()); // Rotate Loop
205 MPM.add(createLICMPass()); // Hoist loop invariants
206 MPM.add(createLoopUnswitchPass(SizeLevel || OptLevel < 3));
207 MPM.add(createInstructionCombiningPass());
208 MPM.add(createIndVarSimplifyPass()); // Canonicalize indvars
209 MPM.add(createLoopIdiomPass()); // Recognize idioms like memset.
210 MPM.add(createLoopDeletionPass()); // Delete dead loops
211 if (!DisableUnrollLoops)
212 MPM.add(createLoopUnrollPass()); // Unroll small loops
213 addExtensionsToPM(EP_LoopOptimizerEnd, MPM);
216 MPM.add(createGVNPass()); // Remove redundancies
217 MPM.add(createMemCpyOptPass()); // Remove memcpy / form memset
218 MPM.add(createSCCPPass()); // Constant prop with SCCP
220 // Run instcombine after redundancy elimination to exploit opportunities
221 // opened up by them.
222 MPM.add(createInstructionCombiningPass());
223 MPM.add(createJumpThreadingPass()); // Thread jumps
224 MPM.add(createCorrelatedValuePropagationPass());
225 MPM.add(createDeadStoreEliminationPass()); // Delete dead stores
226 MPM.add(createAggressiveDCEPass()); // Delete dead instructions
227 MPM.add(createCFGSimplificationPass()); // Merge & remove BBs
228 MPM.add(createInstructionCombiningPass()); // Clean up after everything.
230 if (!DisableUnitAtATime) {
231 MPM.add(createStripDeadPrototypesPass()); // Get rid of dead prototypes
232 MPM.add(createDeadTypeEliminationPass()); // Eliminate dead types
234 // GlobalOpt already deletes dead functions and globals, at -O3 try a
235 // late pass of GlobalDCE. It is capable of deleting dead cycles.
237 MPM.add(createGlobalDCEPass()); // Remove dead fns and globals.
240 MPM.add(createConstantMergePass()); // Merge dup global constants
246 } // end namespace llvm