xref: /llvm-project-15.0.7/llvm/tools/opt/opt.cpp (revision 6edc3fe5)
1 //===- opt.cpp - The LLVM Modular Optimizer -------------------------------===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // Optimizations may be specified an arbitrary number of times on the command
10 // line, They are run in the order specified.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "BreakpointPrinter.h"
15 #include "NewPMDriver.h"
16 #include "PassPrinters.h"
17 #include "llvm/ADT/Triple.h"
18 #include "llvm/Analysis/CallGraph.h"
19 #include "llvm/Analysis/CallGraphSCCPass.h"
20 #include "llvm/Analysis/LoopPass.h"
21 #include "llvm/Analysis/RegionPass.h"
22 #include "llvm/Analysis/TargetLibraryInfo.h"
23 #include "llvm/Analysis/TargetTransformInfo.h"
24 #include "llvm/AsmParser/Parser.h"
25 #include "llvm/CodeGen/CommandFlags.h"
26 #include "llvm/CodeGen/TargetPassConfig.h"
27 #include "llvm/Config/llvm-config.h"
28 #include "llvm/IR/DataLayout.h"
29 #include "llvm/IR/DebugInfo.h"
30 #include "llvm/IR/LLVMContext.h"
31 #include "llvm/IR/LLVMRemarkStreamer.h"
32 #include "llvm/IR/LegacyPassManager.h"
33 #include "llvm/IR/LegacyPassNameParser.h"
34 #include "llvm/IR/Module.h"
35 #include "llvm/IR/Verifier.h"
36 #include "llvm/IRReader/IRReader.h"
37 #include "llvm/InitializePasses.h"
38 #include "llvm/LinkAllIR.h"
39 #include "llvm/LinkAllPasses.h"
40 #include "llvm/MC/SubtargetFeature.h"
41 #include "llvm/Remarks/HotnessThresholdParser.h"
42 #include "llvm/Support/Debug.h"
43 #include "llvm/Support/FileSystem.h"
44 #include "llvm/Support/Host.h"
45 #include "llvm/Support/InitLLVM.h"
46 #include "llvm/Support/PluginLoader.h"
47 #include "llvm/Support/SourceMgr.h"
48 #include "llvm/Support/SystemUtils.h"
49 #include "llvm/Support/TargetRegistry.h"
50 #include "llvm/Support/TargetSelect.h"
51 #include "llvm/Support/ToolOutputFile.h"
52 #include "llvm/Support/YAMLTraits.h"
53 #include "llvm/Target/TargetMachine.h"
54 #include "llvm/Transforms/Coroutines.h"
55 #include "llvm/Transforms/IPO/AlwaysInliner.h"
56 #include "llvm/Transforms/IPO/PassManagerBuilder.h"
57 #include "llvm/Transforms/IPO/WholeProgramDevirt.h"
58 #include "llvm/Transforms/Utils/Cloning.h"
59 #include "llvm/Transforms/Utils/Debugify.h"
60 #include <algorithm>
61 #include <memory>
62 using namespace llvm;
63 using namespace opt_tool;
64 
65 static codegen::RegisterCodeGenFlags CFG;
66 
67 // The OptimizationList is automatically populated with registered Passes by the
68 // PassNameParser.
69 //
70 static cl::list<const PassInfo*, bool, PassNameParser>
71 PassList(cl::desc("Optimizations available:"));
72 
73 static cl::opt<bool> EnableNewPassManager(
74     "enable-new-pm", cl::desc("Enable the new pass manager"), cl::init(false));
75 
76 // This flag specifies a textual description of the optimization pass pipeline
77 // to run over the module. This flag switches opt to use the new pass manager
78 // infrastructure, completely disabling all of the flags specific to the old
79 // pass management.
80 static cl::opt<std::string> PassPipeline(
81     "passes",
82     cl::desc("A textual description of the pass pipeline for optimizing"),
83     cl::Hidden);
84 
85 // Other command line options...
86 //
87 static cl::opt<std::string>
88 InputFilename(cl::Positional, cl::desc("<input bitcode file>"),
89     cl::init("-"), cl::value_desc("filename"));
90 
91 static cl::opt<std::string>
92 OutputFilename("o", cl::desc("Override output filename"),
93                cl::value_desc("filename"));
94 
95 static cl::opt<bool>
96 Force("f", cl::desc("Enable binary output on terminals"));
97 
98 static cl::opt<bool>
99 PrintEachXForm("p", cl::desc("Print module after each transformation"));
100 
101 static cl::opt<bool>
102 NoOutput("disable-output",
103          cl::desc("Do not write result bitcode file"), cl::Hidden);
104 
105 static cl::opt<bool>
106 OutputAssembly("S", cl::desc("Write output as LLVM assembly"));
107 
108 static cl::opt<bool>
109     OutputThinLTOBC("thinlto-bc",
110                     cl::desc("Write output as ThinLTO-ready bitcode"));
111 
112 static cl::opt<bool>
113     SplitLTOUnit("thinlto-split-lto-unit",
114                  cl::desc("Enable splitting of a ThinLTO LTOUnit"));
115 
116 static cl::opt<std::string> ThinLinkBitcodeFile(
117     "thin-link-bitcode-file", cl::value_desc("filename"),
118     cl::desc(
119         "A file in which to write minimized bitcode for the thin link only"));
120 
121 static cl::opt<bool>
122 NoVerify("disable-verify", cl::desc("Do not run the verifier"), cl::Hidden);
123 
124 static cl::opt<bool> NoUpgradeDebugInfo("disable-upgrade-debug-info",
125                                         cl::desc("Generate invalid output"),
126                                         cl::ReallyHidden);
127 
128 static cl::opt<bool> VerifyEach("verify-each",
129                                 cl::desc("Verify after each transform"));
130 
131 static cl::opt<bool>
132     DisableDITypeMap("disable-debug-info-type-map",
133                      cl::desc("Don't use a uniquing type map for debug info"));
134 
135 static cl::opt<bool>
136 StripDebug("strip-debug",
137            cl::desc("Strip debugger symbol info from translation unit"));
138 
139 static cl::opt<bool>
140     StripNamedMetadata("strip-named-metadata",
141                        cl::desc("Strip module-level named metadata"));
142 
143 static cl::opt<bool> DisableInline("disable-inlining",
144                                    cl::desc("Do not run the inliner pass"));
145 
146 static cl::opt<bool>
147 DisableOptimizations("disable-opt",
148                      cl::desc("Do not run any optimization passes"));
149 
150 static cl::opt<bool>
151 StandardLinkOpts("std-link-opts",
152                  cl::desc("Include the standard link time optimizations"));
153 
154 static cl::opt<bool>
155 OptLevelO0("O0",
156   cl::desc("Optimization level 0. Similar to clang -O0"));
157 
158 static cl::opt<bool>
159 OptLevelO1("O1",
160            cl::desc("Optimization level 1. Similar to clang -O1"));
161 
162 static cl::opt<bool>
163 OptLevelO2("O2",
164            cl::desc("Optimization level 2. Similar to clang -O2"));
165 
166 static cl::opt<bool>
167 OptLevelOs("Os",
168            cl::desc("Like -O2 with extra optimizations for size. Similar to clang -Os"));
169 
170 static cl::opt<bool>
171 OptLevelOz("Oz",
172            cl::desc("Like -Os but reduces code size further. Similar to clang -Oz"));
173 
174 static cl::opt<bool>
175 OptLevelO3("O3",
176            cl::desc("Optimization level 3. Similar to clang -O3"));
177 
178 static cl::opt<unsigned>
179 CodeGenOptLevel("codegen-opt-level",
180                 cl::desc("Override optimization level for codegen hooks"));
181 
182 static cl::opt<std::string>
183 TargetTriple("mtriple", cl::desc("Override target triple for module"));
184 
185 cl::opt<bool> DisableLoopUnrolling(
186     "disable-loop-unrolling",
187     cl::desc("Disable loop unrolling in all relevant passes"), cl::init(false));
188 
189 static cl::opt<bool> EmitSummaryIndex("module-summary",
190                                       cl::desc("Emit module summary index"),
191                                       cl::init(false));
192 
193 static cl::opt<bool> EmitModuleHash("module-hash", cl::desc("Emit module hash"),
194                                     cl::init(false));
195 
196 static cl::opt<bool>
197 DisableSimplifyLibCalls("disable-simplify-libcalls",
198                         cl::desc("Disable simplify-libcalls"));
199 
200 static cl::list<std::string>
201 DisableBuiltins("disable-builtin",
202                 cl::desc("Disable specific target library builtin function"),
203                 cl::ZeroOrMore);
204 
205 static cl::opt<bool>
206 AnalyzeOnly("analyze", cl::desc("Only perform analysis, no optimization"));
207 
208 static cl::opt<bool> EnableDebugify(
209     "enable-debugify",
210     cl::desc(
211         "Start the pipeline with debugify and end it with check-debugify"));
212 
213 static cl::opt<bool>
214 PrintBreakpoints("print-breakpoints-for-testing",
215                  cl::desc("Print select breakpoints location for testing"));
216 
217 static cl::opt<std::string> ClDataLayout("data-layout",
218                                          cl::desc("data layout string to use"),
219                                          cl::value_desc("layout-string"),
220                                          cl::init(""));
221 
222 static cl::opt<bool> PreserveBitcodeUseListOrder(
223     "preserve-bc-uselistorder",
224     cl::desc("Preserve use-list order when writing LLVM bitcode."),
225     cl::init(true), cl::Hidden);
226 
227 static cl::opt<bool> PreserveAssemblyUseListOrder(
228     "preserve-ll-uselistorder",
229     cl::desc("Preserve use-list order when writing LLVM assembly."),
230     cl::init(false), cl::Hidden);
231 
232 static cl::opt<bool>
233     RunTwice("run-twice",
234              cl::desc("Run all passes twice, re-using the same pass manager."),
235              cl::init(false), cl::Hidden);
236 
237 static cl::opt<bool> DiscardValueNames(
238     "discard-value-names",
239     cl::desc("Discard names from Value (other than GlobalValue)."),
240     cl::init(false), cl::Hidden);
241 
242 static cl::opt<bool> Coroutines(
243   "enable-coroutines",
244   cl::desc("Enable coroutine passes."),
245   cl::init(false), cl::Hidden);
246 
247 static cl::opt<bool> TimeTrace(
248     "time-trace",
249     cl::desc("Record time trace"));
250 
251 static cl::opt<unsigned> TimeTraceGranularity(
252     "time-trace-granularity",
253     cl::desc("Minimum time granularity (in microseconds) traced by time profiler"),
254     cl::init(500), cl::Hidden);
255 
256 static cl::opt<std::string>
257     TimeTraceFile("time-trace-file",
258                     cl::desc("Specify time trace file destination"),
259                     cl::value_desc("filename"));
260 
261 static cl::opt<bool> RemarksWithHotness(
262     "pass-remarks-with-hotness",
263     cl::desc("With PGO, include profile count in optimization remarks"),
264     cl::Hidden);
265 
266 static cl::opt<Optional<uint64_t>, false, remarks::HotnessThresholdParser>
267     RemarksHotnessThreshold(
268         "pass-remarks-hotness-threshold",
269         cl::desc("Minimum profile count required for "
270                  "an optimization remark to be output. "
271                  "Use 'auto' to apply the threshold from profile summary."),
272         cl::value_desc("N or 'auto'"), cl::init(0), cl::Hidden);
273 
274 static cl::opt<std::string>
275     RemarksFilename("pass-remarks-output",
276                     cl::desc("Output filename for pass remarks"),
277                     cl::value_desc("filename"));
278 
279 static cl::opt<std::string>
280     RemarksPasses("pass-remarks-filter",
281                   cl::desc("Only record optimization remarks from passes whose "
282                            "names match the given regular expression"),
283                   cl::value_desc("regex"));
284 
285 static cl::opt<std::string> RemarksFormat(
286     "pass-remarks-format",
287     cl::desc("The format used for serializing remarks (default: YAML)"),
288     cl::value_desc("format"), cl::init("yaml"));
289 
290 cl::opt<PGOKind>
291     PGOKindFlag("pgo-kind", cl::init(NoPGO), cl::Hidden,
292                 cl::desc("The kind of profile guided optimization"),
293                 cl::values(clEnumValN(NoPGO, "nopgo", "Do not use PGO."),
294                            clEnumValN(InstrGen, "pgo-instr-gen-pipeline",
295                                       "Instrument the IR to generate profile."),
296                            clEnumValN(InstrUse, "pgo-instr-use-pipeline",
297                                       "Use instrumented profile to guide PGO."),
298                            clEnumValN(SampleUse, "pgo-sample-use-pipeline",
299                                       "Use sampled profile to guide PGO.")));
300 cl::opt<std::string> ProfileFile("profile-file",
301                                  cl::desc("Path to the profile."), cl::Hidden);
302 
303 cl::opt<CSPGOKind> CSPGOKindFlag(
304     "cspgo-kind", cl::init(NoCSPGO), cl::Hidden,
305     cl::desc("The kind of context sensitive profile guided optimization"),
306     cl::values(
307         clEnumValN(NoCSPGO, "nocspgo", "Do not use CSPGO."),
308         clEnumValN(
309             CSInstrGen, "cspgo-instr-gen-pipeline",
310             "Instrument (context sensitive) the IR to generate profile."),
311         clEnumValN(
312             CSInstrUse, "cspgo-instr-use-pipeline",
313             "Use instrumented (context sensitive) profile to guide PGO.")));
314 cl::opt<std::string> CSProfileGenFile(
315     "cs-profilegen-file",
316     cl::desc("Path to the instrumented context sensitive profile."),
317     cl::Hidden);
318 
319 static inline void addPass(legacy::PassManagerBase &PM, Pass *P) {
320   // Add the pass to the pass manager...
321   PM.add(P);
322 
323   // If we are verifying all of the intermediate steps, add the verifier...
324   if (VerifyEach)
325     PM.add(createVerifierPass());
326 }
327 
328 /// This routine adds optimization passes based on selected optimization level,
329 /// OptLevel.
330 ///
331 /// OptLevel - Optimization Level
332 static void AddOptimizationPasses(legacy::PassManagerBase &MPM,
333                                   legacy::FunctionPassManager &FPM,
334                                   TargetMachine *TM, unsigned OptLevel,
335                                   unsigned SizeLevel) {
336   if (!NoVerify || VerifyEach)
337     FPM.add(createVerifierPass()); // Verify that input is correct
338 
339   PassManagerBuilder Builder;
340   Builder.OptLevel = OptLevel;
341   Builder.SizeLevel = SizeLevel;
342 
343   if (DisableInline) {
344     // No inlining pass
345   } else if (OptLevel > 1) {
346     Builder.Inliner = createFunctionInliningPass(OptLevel, SizeLevel, false);
347   } else {
348     Builder.Inliner = createAlwaysInlinerLegacyPass();
349   }
350   Builder.DisableUnrollLoops = (DisableLoopUnrolling.getNumOccurrences() > 0) ?
351                                DisableLoopUnrolling : OptLevel == 0;
352 
353   Builder.LoopVectorize = OptLevel > 1 && SizeLevel < 2;
354 
355   Builder.SLPVectorize = OptLevel > 1 && SizeLevel < 2;
356 
357   if (TM)
358     TM->adjustPassManager(Builder);
359 
360   if (Coroutines)
361     addCoroutinePassesToExtensionPoints(Builder);
362 
363   switch (PGOKindFlag) {
364   case InstrGen:
365     Builder.EnablePGOInstrGen = true;
366     Builder.PGOInstrGen = ProfileFile;
367     break;
368   case InstrUse:
369     Builder.PGOInstrUse = ProfileFile;
370     break;
371   case SampleUse:
372     Builder.PGOSampleUse = ProfileFile;
373     break;
374   default:
375     break;
376   }
377 
378   switch (CSPGOKindFlag) {
379   case CSInstrGen:
380     Builder.EnablePGOCSInstrGen = true;
381     break;
382   case CSInstrUse:
383     Builder.EnablePGOCSInstrUse = true;
384     break;
385   default:
386     break;
387   }
388 
389   Builder.populateFunctionPassManager(FPM);
390   Builder.populateModulePassManager(MPM);
391 }
392 
393 static void AddStandardLinkPasses(legacy::PassManagerBase &PM) {
394   PassManagerBuilder Builder;
395   Builder.VerifyInput = true;
396   if (DisableOptimizations)
397     Builder.OptLevel = 0;
398 
399   if (!DisableInline)
400     Builder.Inliner = createFunctionInliningPass();
401   Builder.populateLTOPassManager(PM);
402 }
403 
404 //===----------------------------------------------------------------------===//
405 // CodeGen-related helper functions.
406 //
407 
408 static CodeGenOpt::Level GetCodeGenOptLevel() {
409   if (CodeGenOptLevel.getNumOccurrences())
410     return static_cast<CodeGenOpt::Level>(unsigned(CodeGenOptLevel));
411   if (OptLevelO1)
412     return CodeGenOpt::Less;
413   if (OptLevelO2)
414     return CodeGenOpt::Default;
415   if (OptLevelO3)
416     return CodeGenOpt::Aggressive;
417   return CodeGenOpt::None;
418 }
419 
420 // Returns the TargetMachine instance or zero if no triple is provided.
421 static TargetMachine* GetTargetMachine(Triple TheTriple, StringRef CPUStr,
422                                        StringRef FeaturesStr,
423                                        const TargetOptions &Options) {
424   std::string Error;
425   const Target *TheTarget =
426       TargetRegistry::lookupTarget(codegen::getMArch(), TheTriple, Error);
427   // Some modules don't specify a triple, and this is okay.
428   if (!TheTarget) {
429     return nullptr;
430   }
431 
432   return TheTarget->createTargetMachine(
433       TheTriple.getTriple(), codegen::getCPUStr(), codegen::getFeaturesStr(),
434       Options, codegen::getExplicitRelocModel(),
435       codegen::getExplicitCodeModel(), GetCodeGenOptLevel());
436 }
437 
438 #ifdef BUILD_EXAMPLES
439 void initializeExampleIRTransforms(llvm::PassRegistry &Registry);
440 #endif
441 
442 struct TimeTracerRAII {
443   TimeTracerRAII(StringRef ProgramName) {
444     if (TimeTrace)
445       timeTraceProfilerInitialize(TimeTraceGranularity, ProgramName);
446   }
447   ~TimeTracerRAII() {
448     if (TimeTrace) {
449       if (auto E = timeTraceProfilerWrite(TimeTraceFile, OutputFilename)) {
450         handleAllErrors(std::move(E), [&](const StringError &SE) {
451           errs() << SE.getMessage() << "\n";
452         });
453         return;
454       }
455       timeTraceProfilerCleanup();
456     }
457   }
458 };
459 
460 // For use in NPM transition. Currently this contains most codegen-specific
461 // passes. Remove passes from here when porting to the NPM.
462 // TODO: use a codegen version of PassRegistry.def/PassBuilder::is*Pass() once
463 // it exists.
464 static bool shouldPinPassToLegacyPM(StringRef Pass) {
465   std::vector<StringRef> PassNameExactToIgnore = {
466       "nvvm-reflect",
467       "nvvm-intr-range",
468       "amdgpu-simplifylib",
469       "amdgpu-usenative",
470       "amdgpu-promote-alloca",
471       "amdgpu-promote-alloca-to-vector",
472       "amdgpu-lower-kernel-attributes",
473       "amdgpu-propagate-attributes-early",
474       "amdgpu-propagate-attributes-late",
475       "amdgpu-unify-metadata",
476       "amdgpu-printf-runtime-binding",
477       "amdgpu-always-inline"};
478   for (const auto &P : PassNameExactToIgnore)
479     if (Pass == P)
480       return false;
481 
482   std::vector<StringRef> PassNamePrefix = {
483       "x86-",  "xcore-", "wasm-",    "systemz-", "ppc-",   "nvvm-",   "nvptx-",
484       "mips-", "lanai-", "hexagon-", "bpf-",     "avr-",   "thumb2-", "arm-",
485       "si-",   "gcn-",   "amdgpu-",  "aarch64-", "amdgcn-"};
486   std::vector<StringRef> PassNameContain = {"ehprepare"};
487   std::vector<StringRef> PassNameExact = {"safe-stack",
488                                           "cost-model",
489                                           "codegenprepare",
490                                           "interleaved-load-combine",
491                                           "unreachableblockelim",
492                                           "verify-safepoint-ir",
493                                           "divergence",
494                                           "atomic-expand",
495                                           "hardware-loops",
496                                           "type-promotion",
497                                           "mve-tail-predication",
498                                           "interleaved-access",
499                                           "global-merge",
500                                           "pre-isel-intrinsic-lowering",
501                                           "expand-reductions",
502                                           "indirectbr-expand",
503                                           "generic-to-nvvm",
504                                           "expandmemcmp",
505                                           "loop-reduce",
506                                           "lower-amx-type"};
507   for (const auto &P : PassNamePrefix)
508     if (Pass.startswith(P))
509       return true;
510   for (const auto &P : PassNameContain)
511     if (Pass.contains(P))
512       return true;
513   for (const auto &P : PassNameExact)
514     if (Pass == P)
515       return true;
516   return false;
517 }
518 
519 // For use in NPM transition.
520 static bool shouldForceLegacyPM() {
521   for (const auto &P : PassList) {
522     StringRef Arg = P->getPassArgument();
523     if (shouldPinPassToLegacyPM(Arg))
524       return true;
525   }
526   return false;
527 }
528 
529 //===----------------------------------------------------------------------===//
530 // main for opt
531 //
532 int main(int argc, char **argv) {
533   InitLLVM X(argc, argv);
534 
535   // Enable debug stream buffering.
536   EnableDebugBuffering = true;
537 
538   LLVMContext Context;
539 
540   InitializeAllTargets();
541   InitializeAllTargetMCs();
542   InitializeAllAsmPrinters();
543   InitializeAllAsmParsers();
544 
545   // Initialize passes
546   PassRegistry &Registry = *PassRegistry::getPassRegistry();
547   initializeCore(Registry);
548   initializeCoroutines(Registry);
549   initializeScalarOpts(Registry);
550   initializeObjCARCOpts(Registry);
551   initializeVectorization(Registry);
552   initializeIPO(Registry);
553   initializeAnalysis(Registry);
554   initializeTransformUtils(Registry);
555   initializeInstCombine(Registry);
556   initializeAggressiveInstCombine(Registry);
557   initializeInstrumentation(Registry);
558   initializeTarget(Registry);
559   // For codegen passes, only passes that do IR to IR transformation are
560   // supported.
561   initializeExpandMemCmpPassPass(Registry);
562   initializeScalarizeMaskedMemIntrinLegacyPassPass(Registry);
563   initializeCodeGenPreparePass(Registry);
564   initializeAtomicExpandPass(Registry);
565   initializeRewriteSymbolsLegacyPassPass(Registry);
566   initializeWinEHPreparePass(Registry);
567   initializeDwarfEHPrepareLegacyPassPass(Registry);
568   initializeSafeStackLegacyPassPass(Registry);
569   initializeSjLjEHPreparePass(Registry);
570   initializePreISelIntrinsicLoweringLegacyPassPass(Registry);
571   initializeGlobalMergePass(Registry);
572   initializeIndirectBrExpandPassPass(Registry);
573   initializeInterleavedLoadCombinePass(Registry);
574   initializeInterleavedAccessPass(Registry);
575   initializeEntryExitInstrumenterPass(Registry);
576   initializePostInlineEntryExitInstrumenterPass(Registry);
577   initializeUnreachableBlockElimLegacyPassPass(Registry);
578   initializeExpandReductionsPass(Registry);
579   initializeWasmEHPreparePass(Registry);
580   initializeWriteBitcodePassPass(Registry);
581   initializeHardwareLoopsPass(Registry);
582   initializeTypePromotionPass(Registry);
583 
584 #ifdef BUILD_EXAMPLES
585   initializeExampleIRTransforms(Registry);
586 #endif
587 
588   cl::ParseCommandLineOptions(argc, argv,
589     "llvm .bc -> .bc modular optimizer and analysis printer\n");
590 
591   if (AnalyzeOnly && NoOutput) {
592     errs() << argv[0] << ": analyze mode conflicts with no-output mode.\n";
593     return 1;
594   }
595 
596   TimeTracerRAII TimeTracer(argv[0]);
597 
598   SMDiagnostic Err;
599 
600   Context.setDiscardValueNames(DiscardValueNames);
601   if (!DisableDITypeMap)
602     Context.enableDebugTypeODRUniquing();
603 
604   Expected<std::unique_ptr<ToolOutputFile>> RemarksFileOrErr =
605       setupLLVMOptimizationRemarks(Context, RemarksFilename, RemarksPasses,
606                                    RemarksFormat, RemarksWithHotness,
607                                    RemarksHotnessThreshold);
608   if (Error E = RemarksFileOrErr.takeError()) {
609     errs() << toString(std::move(E)) << '\n';
610     return 1;
611   }
612   std::unique_ptr<ToolOutputFile> RemarksFile = std::move(*RemarksFileOrErr);
613 
614   // Load the input module...
615   auto SetDataLayout = [](StringRef) -> Optional<std::string> {
616     if (ClDataLayout.empty())
617       return None;
618     return ClDataLayout;
619   };
620   std::unique_ptr<Module> M;
621   if (NoUpgradeDebugInfo)
622     M = parseAssemblyFileWithIndexNoUpgradeDebugInfo(
623             InputFilename, Err, Context, nullptr, SetDataLayout)
624             .Mod;
625   else
626     M = parseIRFile(InputFilename, Err, Context, SetDataLayout);
627 
628   if (!M) {
629     Err.print(argv[0], errs());
630     return 1;
631   }
632 
633   // Strip debug info before running the verifier.
634   if (StripDebug)
635     StripDebugInfo(*M);
636 
637   // Erase module-level named metadata, if requested.
638   if (StripNamedMetadata) {
639     while (!M->named_metadata_empty()) {
640       NamedMDNode *NMD = &*M->named_metadata_begin();
641       M->eraseNamedMetadata(NMD);
642     }
643   }
644 
645   // If we are supposed to override the target triple or data layout, do so now.
646   if (!TargetTriple.empty())
647     M->setTargetTriple(Triple::normalize(TargetTriple));
648 
649   // Immediately run the verifier to catch any problems before starting up the
650   // pass pipelines.  Otherwise we can crash on broken code during
651   // doInitialization().
652   if (!NoVerify && verifyModule(*M, &errs())) {
653     errs() << argv[0] << ": " << InputFilename
654            << ": error: input module is broken!\n";
655     return 1;
656   }
657 
658   // Enable testing of whole program devirtualization on this module by invoking
659   // the facility for updating public visibility to linkage unit visibility when
660   // specified by an internal option. This is normally done during LTO which is
661   // not performed via opt.
662   updateVCallVisibilityInModule(*M,
663                                 /* WholeProgramVisibilityEnabledInLTO */ false);
664 
665   // Figure out what stream we are supposed to write to...
666   std::unique_ptr<ToolOutputFile> Out;
667   std::unique_ptr<ToolOutputFile> ThinLinkOut;
668   if (NoOutput) {
669     if (!OutputFilename.empty())
670       errs() << "WARNING: The -o (output filename) option is ignored when\n"
671                 "the --disable-output option is used.\n";
672   } else {
673     // Default to standard output.
674     if (OutputFilename.empty())
675       OutputFilename = "-";
676 
677     std::error_code EC;
678     sys::fs::OpenFlags Flags = OutputAssembly ? sys::fs::OF_Text
679                                               : sys::fs::OF_None;
680     Out.reset(new ToolOutputFile(OutputFilename, EC, Flags));
681     if (EC) {
682       errs() << EC.message() << '\n';
683       return 1;
684     }
685 
686     if (!ThinLinkBitcodeFile.empty()) {
687       ThinLinkOut.reset(
688           new ToolOutputFile(ThinLinkBitcodeFile, EC, sys::fs::OF_None));
689       if (EC) {
690         errs() << EC.message() << '\n';
691         return 1;
692       }
693     }
694   }
695 
696   Triple ModuleTriple(M->getTargetTriple());
697   std::string CPUStr, FeaturesStr;
698   TargetMachine *Machine = nullptr;
699   const TargetOptions Options =
700       codegen::InitTargetOptionsFromCodeGenFlags(ModuleTriple);
701 
702   if (ModuleTriple.getArch()) {
703     CPUStr = codegen::getCPUStr();
704     FeaturesStr = codegen::getFeaturesStr();
705     Machine = GetTargetMachine(ModuleTriple, CPUStr, FeaturesStr, Options);
706   } else if (ModuleTriple.getArchName() != "unknown" &&
707              ModuleTriple.getArchName() != "") {
708     errs() << argv[0] << ": unrecognized architecture '"
709            << ModuleTriple.getArchName() << "' provided.\n";
710     return 1;
711   }
712 
713   std::unique_ptr<TargetMachine> TM(Machine);
714 
715   // Override function attributes based on CPUStr, FeaturesStr, and command line
716   // flags.
717   codegen::setFunctionAttributes(CPUStr, FeaturesStr, *M);
718 
719   // If the output is set to be emitted to standard out, and standard out is a
720   // console, print out a warning message and refuse to do it.  We don't
721   // impress anyone by spewing tons of binary goo to a terminal.
722   if (!Force && !NoOutput && !AnalyzeOnly && !OutputAssembly)
723     if (CheckBitcodeOutputToConsole(Out->os()))
724       NoOutput = true;
725 
726   if (OutputThinLTOBC)
727     M->addModuleFlag(Module::Error, "EnableSplitLTOUnit", SplitLTOUnit);
728 
729   // Add an appropriate TargetLibraryInfo pass for the module's triple.
730   TargetLibraryInfoImpl TLII(ModuleTriple);
731 
732   // The -disable-simplify-libcalls flag actually disables all builtin optzns.
733   if (DisableSimplifyLibCalls)
734     TLII.disableAllFunctions();
735   else {
736     // Disable individual builtin functions in TargetLibraryInfo.
737     LibFunc F;
738     for (auto &FuncName : DisableBuiltins)
739       if (TLII.getLibFunc(FuncName, F))
740         TLII.setUnavailable(F);
741       else {
742         errs() << argv[0] << ": cannot disable nonexistent builtin function "
743                << FuncName << '\n';
744         return 1;
745       }
746   }
747 
748   // If `-passes=` is specified, use NPM.
749   // If `-enable-new-pm` is specified and there are no codegen passes, use NPM.
750   // e.g. `-enable-new-pm -sroa` will use NPM.
751   // but `-enable-new-pm -codegenprepare` will still revert to legacy PM.
752   if ((EnableNewPassManager && !shouldForceLegacyPM()) ||
753       PassPipeline.getNumOccurrences() > 0) {
754     if (AnalyzeOnly) {
755       errs() << "Cannot specify -analyze under new pass manager\n";
756       return 1;
757     }
758     if (PassPipeline.getNumOccurrences() > 0 && PassList.size() > 0) {
759       errs()
760           << "Cannot specify passes via both -foo-pass and --passes=foo-pass\n";
761       return 1;
762     }
763     SmallVector<StringRef, 4> Passes;
764     if (OptLevelO0)
765       Passes.push_back("default<O0>");
766     if (OptLevelO1)
767       Passes.push_back("default<O1>");
768     if (OptLevelO2)
769       Passes.push_back("default<O2>");
770     if (OptLevelO3)
771       Passes.push_back("default<O3>");
772     if (OptLevelOs)
773       Passes.push_back("default<Os>");
774     if (OptLevelOz)
775       Passes.push_back("default<Oz>");
776     for (const auto &P : PassList)
777       Passes.push_back(P->getPassArgument());
778     OutputKind OK = OK_NoOutput;
779     if (!NoOutput)
780       OK = OutputAssembly
781                ? OK_OutputAssembly
782                : (OutputThinLTOBC ? OK_OutputThinLTOBitcode : OK_OutputBitcode);
783 
784     VerifierKind VK = VK_VerifyInAndOut;
785     if (NoVerify)
786       VK = VK_NoVerifier;
787     else if (VerifyEach)
788       VK = VK_VerifyEachPass;
789 
790     // The user has asked to use the new pass manager and provided a pipeline
791     // string. Hand off the rest of the functionality to the new code for that
792     // layer.
793     return runPassPipeline(argv[0], *M, TM.get(), &TLII, Out.get(),
794                            ThinLinkOut.get(), RemarksFile.get(), PassPipeline,
795                            Passes, OK, VK, PreserveAssemblyUseListOrder,
796                            PreserveBitcodeUseListOrder, EmitSummaryIndex,
797                            EmitModuleHash, EnableDebugify, Coroutines)
798                ? 0
799                : 1;
800   }
801 
802   // Create a PassManager to hold and optimize the collection of passes we are
803   // about to build. If the -debugify-each option is set, wrap each pass with
804   // the (-check)-debugify passes.
805   DebugifyCustomPassManager Passes;
806   if (DebugifyEach)
807     Passes.enableDebugifyEach();
808 
809   bool AddOneTimeDebugifyPasses = EnableDebugify && !DebugifyEach;
810 
811   Passes.add(new TargetLibraryInfoWrapperPass(TLII));
812 
813   // Add internal analysis passes from the target machine.
814   Passes.add(createTargetTransformInfoWrapperPass(TM ? TM->getTargetIRAnalysis()
815                                                      : TargetIRAnalysis()));
816 
817   if (AddOneTimeDebugifyPasses)
818     Passes.add(createDebugifyModulePass());
819 
820   std::unique_ptr<legacy::FunctionPassManager> FPasses;
821   if (OptLevelO0 || OptLevelO1 || OptLevelO2 || OptLevelOs || OptLevelOz ||
822       OptLevelO3) {
823     FPasses.reset(new legacy::FunctionPassManager(M.get()));
824     FPasses->add(createTargetTransformInfoWrapperPass(
825         TM ? TM->getTargetIRAnalysis() : TargetIRAnalysis()));
826   }
827 
828   if (PrintBreakpoints) {
829     // Default to standard output.
830     if (!Out) {
831       if (OutputFilename.empty())
832         OutputFilename = "-";
833 
834       std::error_code EC;
835       Out = std::make_unique<ToolOutputFile>(OutputFilename, EC,
836                                               sys::fs::OF_None);
837       if (EC) {
838         errs() << EC.message() << '\n';
839         return 1;
840       }
841     }
842     Passes.add(createBreakpointPrinter(Out->os()));
843     NoOutput = true;
844   }
845 
846   if (TM) {
847     // FIXME: We should dyn_cast this when supported.
848     auto &LTM = static_cast<LLVMTargetMachine &>(*TM);
849     Pass *TPC = LTM.createPassConfig(Passes);
850     Passes.add(TPC);
851   }
852 
853   // Create a new optimization pass for each one specified on the command line
854   for (unsigned i = 0; i < PassList.size(); ++i) {
855     if (StandardLinkOpts &&
856         StandardLinkOpts.getPosition() < PassList.getPosition(i)) {
857       AddStandardLinkPasses(Passes);
858       StandardLinkOpts = false;
859     }
860 
861     if (OptLevelO0 && OptLevelO0.getPosition() < PassList.getPosition(i)) {
862       AddOptimizationPasses(Passes, *FPasses, TM.get(), 0, 0);
863       OptLevelO0 = false;
864     }
865 
866     if (OptLevelO1 && OptLevelO1.getPosition() < PassList.getPosition(i)) {
867       AddOptimizationPasses(Passes, *FPasses, TM.get(), 1, 0);
868       OptLevelO1 = false;
869     }
870 
871     if (OptLevelO2 && OptLevelO2.getPosition() < PassList.getPosition(i)) {
872       AddOptimizationPasses(Passes, *FPasses, TM.get(), 2, 0);
873       OptLevelO2 = false;
874     }
875 
876     if (OptLevelOs && OptLevelOs.getPosition() < PassList.getPosition(i)) {
877       AddOptimizationPasses(Passes, *FPasses, TM.get(), 2, 1);
878       OptLevelOs = false;
879     }
880 
881     if (OptLevelOz && OptLevelOz.getPosition() < PassList.getPosition(i)) {
882       AddOptimizationPasses(Passes, *FPasses, TM.get(), 2, 2);
883       OptLevelOz = false;
884     }
885 
886     if (OptLevelO3 && OptLevelO3.getPosition() < PassList.getPosition(i)) {
887       AddOptimizationPasses(Passes, *FPasses, TM.get(), 3, 0);
888       OptLevelO3 = false;
889     }
890 
891     const PassInfo *PassInf = PassList[i];
892     Pass *P = nullptr;
893     if (PassInf->getNormalCtor())
894       P = PassInf->getNormalCtor()();
895     else
896       errs() << argv[0] << ": cannot create pass: "
897              << PassInf->getPassName() << "\n";
898     if (P) {
899       PassKind Kind = P->getPassKind();
900       addPass(Passes, P);
901 
902       if (AnalyzeOnly) {
903         switch (Kind) {
904         case PT_Region:
905           Passes.add(createRegionPassPrinter(PassInf, Out->os()));
906           break;
907         case PT_Loop:
908           Passes.add(createLoopPassPrinter(PassInf, Out->os()));
909           break;
910         case PT_Function:
911           Passes.add(createFunctionPassPrinter(PassInf, Out->os()));
912           break;
913         case PT_CallGraphSCC:
914           Passes.add(createCallGraphPassPrinter(PassInf, Out->os()));
915           break;
916         default:
917           Passes.add(createModulePassPrinter(PassInf, Out->os()));
918           break;
919         }
920       }
921     }
922 
923     if (PrintEachXForm)
924       Passes.add(
925           createPrintModulePass(errs(), "", PreserveAssemblyUseListOrder));
926   }
927 
928   if (StandardLinkOpts) {
929     AddStandardLinkPasses(Passes);
930     StandardLinkOpts = false;
931   }
932 
933   if (OptLevelO0)
934     AddOptimizationPasses(Passes, *FPasses, TM.get(), 0, 0);
935 
936   if (OptLevelO1)
937     AddOptimizationPasses(Passes, *FPasses, TM.get(), 1, 0);
938 
939   if (OptLevelO2)
940     AddOptimizationPasses(Passes, *FPasses, TM.get(), 2, 0);
941 
942   if (OptLevelOs)
943     AddOptimizationPasses(Passes, *FPasses, TM.get(), 2, 1);
944 
945   if (OptLevelOz)
946     AddOptimizationPasses(Passes, *FPasses, TM.get(), 2, 2);
947 
948   if (OptLevelO3)
949     AddOptimizationPasses(Passes, *FPasses, TM.get(), 3, 0);
950 
951   if (FPasses) {
952     FPasses->doInitialization();
953     for (Function &F : *M)
954       FPasses->run(F);
955     FPasses->doFinalization();
956   }
957 
958   // Check that the module is well formed on completion of optimization
959   if (!NoVerify && !VerifyEach)
960     Passes.add(createVerifierPass());
961 
962   if (AddOneTimeDebugifyPasses)
963     Passes.add(createCheckDebugifyModulePass(false));
964 
965   // In run twice mode, we want to make sure the output is bit-by-bit
966   // equivalent if we run the pass manager again, so setup two buffers and
967   // a stream to write to them. Note that llc does something similar and it
968   // may be worth to abstract this out in the future.
969   SmallVector<char, 0> Buffer;
970   SmallVector<char, 0> FirstRunBuffer;
971   std::unique_ptr<raw_svector_ostream> BOS;
972   raw_ostream *OS = nullptr;
973 
974   const bool ShouldEmitOutput = !NoOutput && !AnalyzeOnly;
975 
976   // Write bitcode or assembly to the output as the last step...
977   if (ShouldEmitOutput || RunTwice) {
978     assert(Out);
979     OS = &Out->os();
980     if (RunTwice) {
981       BOS = std::make_unique<raw_svector_ostream>(Buffer);
982       OS = BOS.get();
983     }
984     if (OutputAssembly) {
985       if (EmitSummaryIndex)
986         report_fatal_error("Text output is incompatible with -module-summary");
987       if (EmitModuleHash)
988         report_fatal_error("Text output is incompatible with -module-hash");
989       Passes.add(createPrintModulePass(*OS, "", PreserveAssemblyUseListOrder));
990     } else if (OutputThinLTOBC)
991       Passes.add(createWriteThinLTOBitcodePass(
992           *OS, ThinLinkOut ? &ThinLinkOut->os() : nullptr));
993     else
994       Passes.add(createBitcodeWriterPass(*OS, PreserveBitcodeUseListOrder,
995                                          EmitSummaryIndex, EmitModuleHash));
996   }
997 
998   // Before executing passes, print the final values of the LLVM options.
999   cl::PrintOptionValues();
1000 
1001   if (!RunTwice) {
1002     // Now that we have all of the passes ready, run them.
1003     Passes.run(*M);
1004   } else {
1005     // If requested, run all passes twice with the same pass manager to catch
1006     // bugs caused by persistent state in the passes.
1007     std::unique_ptr<Module> M2(CloneModule(*M));
1008     // Run all passes on the original module first, so the second run processes
1009     // the clone to catch CloneModule bugs.
1010     Passes.run(*M);
1011     FirstRunBuffer = Buffer;
1012     Buffer.clear();
1013 
1014     Passes.run(*M2);
1015 
1016     // Compare the two outputs and make sure they're the same
1017     assert(Out);
1018     if (Buffer.size() != FirstRunBuffer.size() ||
1019         (memcmp(Buffer.data(), FirstRunBuffer.data(), Buffer.size()) != 0)) {
1020       errs()
1021           << "Running the pass manager twice changed the output.\n"
1022              "Writing the result of the second run to the specified output.\n"
1023              "To generate the one-run comparison binary, just run without\n"
1024              "the compile-twice option\n";
1025       if (ShouldEmitOutput) {
1026         Out->os() << BOS->str();
1027         Out->keep();
1028       }
1029       if (RemarksFile)
1030         RemarksFile->keep();
1031       return 1;
1032     }
1033     if (ShouldEmitOutput)
1034       Out->os() << BOS->str();
1035   }
1036 
1037   if (DebugifyEach && !DebugifyExport.empty())
1038     exportDebugifyStats(DebugifyExport, Passes.getDebugifyStatsMap());
1039 
1040   // Declare success.
1041   if (!NoOutput || PrintBreakpoints)
1042     Out->keep();
1043 
1044   if (RemarksFile)
1045     RemarksFile->keep();
1046 
1047   if (ThinLinkOut)
1048     ThinLinkOut->keep();
1049 
1050   return 0;
1051 }
1052