mirror of
https://github.com/RPCS3/llvm-mirror.git
synced 2024-10-19 02:52:53 +02:00
9d65c3131d
to run methods, both for transform passes and analysis passes.
This also allows the analysis manager to use a different set of extra
arguments from the pass manager where useful. Consider passes over
analysis produced units of IR like SCCs of the call graph or loops.
Passes of this nature will often want to refer to the analysis result
that was used to compute their IR units (the call graph or LoopInfo).
And for transformations, they may want to communicate special update
information to the outer pass manager. With this change, it becomes
possible to have a run method for a loop pass that looks more like:
PreservedAnalyses run(Loop &L, AnalysisManager<Loop, LoopInfo> &AM,
LoopInfo &LI, LoopUpdateRecord &UR);
And to query the analysis manager like:
AM.getResult<MyLoopAnalysis>(L, LI);
This makes accessing the known-available analyses convenient and clear,
and it makes passing customized data structures around easy.
My initial use case is going to be in updating the pass manager layers
when the analysis units of IR change. But there are more use cases here
such as having a layer that lets inner passes signal whether certain
additional passes should be run because of particular simplifications
made. Two desires for this have come up in the past: triggering
additional optimization after successfully unrolling loops, and
triggering additional inlining after collapsing indirect calls to direct
calls.
Despite adding this layer of generic extensibility, the *only* change to
existing, simple usage are for places where we forward declare the
AnalysisManager template. We really shouldn't be doing this because of
the fragility exposed here, but currently it makes coping with the
legacy PM code easier.
Differential Revision: http://reviews.llvm.org/D21462
llvm-svn: 279227
96 lines
3.2 KiB
C++
96 lines
3.2 KiB
C++
//===- IRPrintingPasses.h - Passes to print out IR constructs ---*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
/// \file
|
|
///
|
|
/// This file defines passes to print out IR in various granularities. The
|
|
/// PrintModulePass pass simply prints out the entire module when it is
|
|
/// executed. The PrintFunctionPass class is designed to be pipelined with
|
|
/// other FunctionPass's, and prints out the functions of the module as they
|
|
/// are processed.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLVM_IR_IRPRINTINGPASSES_H
|
|
#define LLVM_IR_IRPRINTINGPASSES_H
|
|
|
|
#include "llvm/ADT/StringRef.h"
|
|
#include <string>
|
|
|
|
namespace llvm {
|
|
class BasicBlockPass;
|
|
class Function;
|
|
class FunctionPass;
|
|
class Module;
|
|
class ModulePass;
|
|
class PreservedAnalyses;
|
|
class raw_ostream;
|
|
template <typename IRUnitT, typename... ExtraArgTs> class AnalysisManager;
|
|
|
|
/// \brief Create and return a pass that writes the module to the specified
|
|
/// \c raw_ostream.
|
|
ModulePass *createPrintModulePass(raw_ostream &OS,
|
|
const std::string &Banner = "",
|
|
bool ShouldPreserveUseListOrder = false);
|
|
|
|
/// \brief Create and return a pass that prints functions to the specified
|
|
/// \c raw_ostream as they are processed.
|
|
FunctionPass *createPrintFunctionPass(raw_ostream &OS,
|
|
const std::string &Banner = "");
|
|
|
|
/// \brief Create and return a pass that writes the BB to the specified
|
|
/// \c raw_ostream.
|
|
BasicBlockPass *createPrintBasicBlockPass(raw_ostream &OS,
|
|
const std::string &Banner = "");
|
|
|
|
/// Print out a name of an LLVM value without any prefixes.
|
|
///
|
|
/// The name is surrounded with ""'s and escaped if it has any special or
|
|
/// non-printable characters in it.
|
|
void printLLVMNameWithoutPrefix(raw_ostream &OS, StringRef Name);
|
|
|
|
/// \brief Pass for printing a Module as LLVM's text IR assembly.
|
|
///
|
|
/// Note: This pass is for use with the new pass manager. Use the create...Pass
|
|
/// functions above to create passes for use with the legacy pass manager.
|
|
class PrintModulePass {
|
|
raw_ostream &OS;
|
|
std::string Banner;
|
|
bool ShouldPreserveUseListOrder;
|
|
|
|
public:
|
|
PrintModulePass();
|
|
PrintModulePass(raw_ostream &OS, const std::string &Banner = "",
|
|
bool ShouldPreserveUseListOrder = false);
|
|
|
|
PreservedAnalyses run(Module &M, AnalysisManager<Module> &);
|
|
|
|
static StringRef name() { return "PrintModulePass"; }
|
|
};
|
|
|
|
/// \brief Pass for printing a Function as LLVM's text IR assembly.
|
|
///
|
|
/// Note: This pass is for use with the new pass manager. Use the create...Pass
|
|
/// functions above to create passes for use with the legacy pass manager.
|
|
class PrintFunctionPass {
|
|
raw_ostream &OS;
|
|
std::string Banner;
|
|
|
|
public:
|
|
PrintFunctionPass();
|
|
PrintFunctionPass(raw_ostream &OS, const std::string &Banner = "");
|
|
|
|
PreservedAnalyses run(Function &F, AnalysisManager<Function> &);
|
|
|
|
static StringRef name() { return "PrintFunctionPass"; }
|
|
};
|
|
|
|
} // End llvm namespace
|
|
|
|
#endif
|