1 //===- IRPrintingPasses.h - Passes to print out IR constructs ---*- C++ -*-===//
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
7 //===----------------------------------------------------------------------===//
10 /// This file defines passes to print out IR in various granularities. The
11 /// PrintModulePass pass simply prints out the entire module when it is
12 /// executed. The PrintFunctionPass class is designed to be pipelined with
13 /// other FunctionPass's, and prints out the functions of the module as they
16 //===----------------------------------------------------------------------===//
18 #ifndef LLVM_IR_IRPRINTINGPASSES_H
19 #define LLVM_IR_IRPRINTINGPASSES_H
21 #include "llvm/ADT/StringRef.h"
30 class PreservedAnalyses;
32 template <typename IRUnitT, typename... ExtraArgTs> class AnalysisManager;
34 /// Create and return a pass that writes the module to the specified
36 ModulePass *createPrintModulePass(raw_ostream &OS,
37 const std::string &Banner = "",
38 bool ShouldPreserveUseListOrder = false);
40 /// Create and return a pass that prints functions to the specified
41 /// \c raw_ostream as they are processed.
42 FunctionPass *createPrintFunctionPass(raw_ostream &OS,
43 const std::string &Banner = "");
45 /// Print out a name of an LLVM value without any prefixes.
47 /// The name is surrounded with ""'s and escaped if it has any special or
48 /// non-printable characters in it.
49 void printLLVMNameWithoutPrefix(raw_ostream &OS, StringRef Name);
51 /// Return true if a pass is for IR printing.
52 bool isIRPrintingPass(Pass *P);
54 /// isFunctionInPrintList - returns true if a function should be printed via
55 // debugging options like -print-after-all/-print-before-all.
56 // Tells if the function IR should be printed by PrinterPass.
57 extern bool isFunctionInPrintList(StringRef FunctionName);
59 /// forcePrintModuleIR - returns true if IR printing passes should
60 // be printing module IR (even for local-pass printers e.g. function-pass)
61 // to provide more context, as enabled by debugging option -print-module-scope
62 // Tells if IR printer should be printing module IR
63 extern bool forcePrintModuleIR();
65 extern bool shouldPrintBeforePass();
66 extern bool shouldPrintBeforePass(StringRef);
67 extern bool shouldPrintAfterPass();
68 extern bool shouldPrintAfterPass(StringRef);
70 /// Pass for printing a Module as LLVM's text IR assembly.
72 /// Note: This pass is for use with the new pass manager. Use the create...Pass
73 /// functions above to create passes for use with the legacy pass manager.
74 class PrintModulePass {
77 bool ShouldPreserveUseListOrder;
81 PrintModulePass(raw_ostream &OS, const std::string &Banner = "",
82 bool ShouldPreserveUseListOrder = false);
84 PreservedAnalyses run(Module &M, AnalysisManager<Module> &);
86 static StringRef name() { return "PrintModulePass"; }
89 /// Pass for printing a Function as LLVM's text IR assembly.
91 /// Note: This pass is for use with the new pass manager. Use the create...Pass
92 /// functions above to create passes for use with the legacy pass manager.
93 class PrintFunctionPass {
99 PrintFunctionPass(raw_ostream &OS, const std::string &Banner = "");
101 PreservedAnalyses run(Function &F, AnalysisManager<Function> &);
103 static StringRef name() { return "PrintFunctionPass"; }
106 } // End llvm namespace