llvm::TargetPassConfig

Target-Independent Code Generator Pass Configuration Options.

Synopsis

Declared in <llvm/CodeGen/TargetPassConfig.h>

class TargetPassConfig
    : public ImmutablePass

Description

This is an ImmutablePass solely for the purpose of exposing CodeGen options to the internals of other CodeGen passes.

Base Classes

NameDescription
ImmutablePassImmutablePass class - This class is used to provide information that does not need to be run. This is useful for things like target information.

Types

NameDescription
StartStopInfo Describes where a limited codegen pipeline starts and stops.

Member Functions

NameDescription
TargetPassConfig [constructor]Constructors
~TargetPassConfig [destructor] [virtual]Destroy the pass configuration and its implementation data.
operator= [deleted]Passes are not assignable.
addCheckDebugPass Add a pass to check synthesized debug info for MIR.
addCodeGenPrepare [virtual]Add pass to prepare the LLVM IR for code generation. This should be done before exception handling preparation passes.
addDebugifyPass Add a pass to add synthesized debug info to the MIR.
addGlobalInstructionSelect [virtual]Install a global instruction selector that constrains generic registers.
addIRPasses [virtual]Add common target configurable passes that perform LLVM IR to IR transforms following machine independent optimization.
addIRTranslator [virtual]This method should install an IR translator pass, which converts from LLVM code to machine instructions with possibly generic opcodes.
addISelPasses Add all passes that lower LLVM IR to machine instructions.
addISelPrepare [virtual]Add common passes that perform LLVM IR to IR transforms in preparation for instruction selection.
addInstSelector [virtual]addInstSelector - This method should install an instruction selector pass, which converts from LLVM code to machine instructions.
addLegalizeMachineIR [virtual]This method should install a legalize pass, which converts the instruction sequence into one that can be selected by the target.
addMachinePasses [virtual]Add the complete, standard set of LLVM CodeGen passes. Fully developed targets will not generally override this.
addMachinePostPasses Add standard passes after a pass that has just been added. For example, the MachineVerifier if it is enabled.
addMachinePrePasses Add standard passes before a pass that's about to be added. For example, the DebugifyMachineModulePass if it is enabled.
addPassesToHandleExceptions Add passes to lower exception handling for the code generator.
addPreGlobalInstructionSelect [virtual]This method may be implemented by targets that want to run passes immediately before the (global) instruction selection.
addPreLegalizeMachineIR [virtual]This method may be implemented by targets that want to run passes immediately before legalization.
addPreRegBankSelect [virtual]This method may be implemented by targets that want to run passes immediately before the register bank selection.
addPrintPass Add a pass to print the machine function if printing is enabled.
addRegBankSelect [virtual]This method should install a register bank selector pass, which assigns register banks to virtual registers without a register class or register banks.
addStripDebugPass Add a pass to remove debug info from the MIR.
addVerifyPass Add a pass to perform basic verification of the machine function if verification is enabled.
assignPassManager [virtual]Find or create a module pass manager on PMS and register this pass.
createPrinterPass [virtual]createPrinterPass - Get a module printer pass.
disablePass Allow the target to disable a specific standard pass by default.
doFinalization [virtual]Perform any cleanup needed after all passes have run.
doInitialization [virtual]Perform any initialization needed before any pass is run.
dump Print this pass's state to stderr for debugging.
dumpPassStructure [virtual]Print the pass nesting structure for -debug-passes=PassStructure.
enablePass Allow the target to enable a specific standard pass by default.
getAnalysis getAnalysis overloads
getAnalysisID getAnalysisID overloads
getAnalysisIfAvailable Get an optional analysis result that may already be available.
getAnalysisUsage [virtual]Declare which analyses this pass requires and preserves.
getAsImmutablePass [virtual]Return this pass as an ImmutablePass.
getAsPMDataManager [virtual]Return this pass as a PMDataManager when it is a nested pass manager.
getCSEConfig [virtual]Returns the CSEConfig object to use for the current optimization level.
getEnableSinkAndFold Return whether MachineSink sinking-and-folding is enabled.
getEnableTailMerge Return whether tail merging is enabled for this target.
getOptLevel Return the codegen optimization level for this configuration.
getOptimizeRegAlloc Return true if the optimized regalloc pipeline is enabled.
getPassArgument Return a nice clean name for a pass corresponding to that used to enable the pass in opt.
getPassID getPassID - Return the PassID number that corresponds to this pass.
getPassKind Return the kind of pass (module, function, loop, etc.).
getPassName [virtual]Return a human-readable name for this pass.
getPassSubstitution Return the pass substituted for StandardID by the target. If no substitution exists, return StandardID.
getPotentialPassManagerType [virtual]Return what kind of Pass Manager can manage this pass.
getResolver Return the analysis resolver installed for this pass.
getTM Get the right type of TargetMachine for this target.
initializePass [virtual]Perform initialization for this immutable pass.
insertPass Insert InsertedPassID pass after TargetPassID pass.
isGlobalISelAbortEnabled Check whether or not GlobalISel should abort on error. When this is disabled, GlobalISel will fall back on SDISel instead of erroring out.
isPassSubstitutedOrOverridden Return true if the pass has been substituted by the target or overridden on the command line.
mustPreserveAnalysisID Report whether the analysis identified by AID must be preserved.
preparePassManager [virtual]Check whether available pass managers are suitable for this pass.
print [virtual]Print the internal state of this pass for analysis dumping.
printAndVerify printAndVerify - Add a pass to dump then verify the machine function, if those steps are enabled.
releaseMemory [virtual]Release memory held by this pass when it is no longer needed.
reportDiagnosticWhenGlobalISelFallback [virtual]Return whether to emit a diagnostic when GlobalISel falls back.
requiresCodeGenSCCOrder Return true if functions must be processed with callees before callers.
runOnModule [virtual]ImmutablePasses are never run.
setDisableVerify Set whether machine IR verification is disabled.
setEnableSinkAndFold Set whether MachineSink may sink and fold into addressing modes.
setEnableTailMerge Set whether tail merging is enabled.
setInitialized Mark this configuration as fully initialized.
setRequiresCodeGenSCCOrder Set whether codegen must process callees before callers.
setResolver Install the analysis resolver used to satisfy this pass's dependencies.
substitutePass Override a standard pipeline pass with a target-specific substitute.
usingDefaultRegAlloc Return true if the default global register allocator is in use and has not be overriden on the command line with '-regalloc=...'
verifyAnalysis [virtual]verifyAnalysis() - This member can be implemented by a analysis pass to check state of analysis information.

Static Member Functions

NameDescription
createPass Construct a new instance of the pass identified by ID.
getLimitedCodeGenPipelineReason If hasLimitedCodeGenPipeline is true, this method returns a string with the name of the options that caused this pipeline to be limited.
getStartStopInfo Returns pass name in -stop-before or -stop-after NOTE: New pass manager migration only
hasLimitedCodeGenPipeline Returns true if one of the -start-after, -start-before, -stop-after or -stop-before options is set.
lookupPassInfo lookupPassInfo overloads
willCompleteCodeGenPipeline Returns true if none of the -stop-before and -stop-after options is set.

Static Data Members

NameDescription
ID Pass identification, replacement for typeinfo.

Protected Member Functions

NameDescription
addBlockPlacement [virtual]Add standard basic block placement passes.
addCoreISelPasses Add the actual instruction selection passes. This does not include preparation passes on IR.
addFastRegAlloc [virtual]addFastRegAlloc - Add the minimum set of target-independent passes that are required for fast register allocation.
addGCPasses [virtual]addGCPasses - Add late codegen passes that analyze code for garbage collection. This should return true if GC info should be printed after these passes.
addILPOpts [virtual]Add out-of-order ILP optimization passes while code is still in SSA form.
addMachineLateOptimization [virtual]Add passes that optimize machine instructions after register allocation.
addMachineSSAOptimization [virtual]addMachineSSAOptimization - Add standard passes that optimize machine instructions in SSA form.
addOptimizedRegAlloc [virtual]addOptimizedRegAlloc - Add passes related to register allocation. CodeGenTargetMachineImpl provides standard regalloc passes for most targets.
addPass addPass overloads
addPostBBSections [virtual]This pass may be implemented by targets that want to run passes immediately after basic block sections are assigned.
addPostFastRegAllocRewrite [virtual]addPostFastRegAllocRewrite - Add passes to the optimized register allocation pipeline after fast register allocation is complete.
addPostRegAlloc [virtual]This method may be implemented by targets that want to run passes after register allocation pass pipeline but before prolog-epilog insertion.
addPostRewrite [virtual]Add passes to be run immediately after virtual registers are rewritten to physical registers.
addPreEmitPass [virtual]This pass may be implemented by targets that want to run passes immediately before machine code is emitted.
addPreEmitPass2 [virtual]Targets may add passes immediately before machine code is emitted in this callback. This is called even later than addPreEmitPass.
addPreISel [virtual]addPreISelPasses - This method should add any "last minute" LLVM->LLVM passes (which are run just before instruction selector).
addPreRegAlloc [virtual]This method may be implemented by targets that want to run passes immediately before register allocation.
addPreRewrite [virtual]Add passes after register allocation but before virtreg rewriting.
addPreSched2 [virtual]This method may be implemented by targets that want to run passes after prolog-epilog insertion and before the second instruction scheduling pass.
addRegAssignAndRewriteFast [virtual]Add core register allocator passes which do the actual register assignment and rewriting.
addRegAssignAndRewriteOptimized [virtual]Add optimized register assignment and rewriting passes.
createRegAllocPass [virtual]addMachinePasses helper to create the target-selected or overriden regalloc pass.
createTargetRegisterAllocator [virtual]createTargetRegisterAllocator - Create the register allocator pass for this target at the current optimization level.
isCustomizedRegAlloc Return true if register allocator is specified by -regalloc=override.
setOpt Assign a target option, verifying that configuration is still mutable.
skipModule Optional passes call this function to check whether the pass should be skipped. This is the case when optimization bisect is over the limit.

Protected Data Members

NameDescription
DisableVerify Whether machine IR verification is disabled for this target.
EnableLoopTermFold Enable LoopTermFold immediately after LSR
EnableSinkAndFold Enable sinking of instructions in MachineSink where a computation can be folded into the addressing mode of a memory load/store instruction or replace a copy.
EnableTailMerge Default setting for -enable-tail-merge on this target.
Impl Internal data structures used by the pass configuration.
Initialized True after all passes have been configured.
RequireCodeGenSCCOrder Require processing of functions such that callees are generated before callers.
TM Target machine whose codegen pipeline is being configured.

Non-Member Functions

NameDescription
getBestSimplifyQueryBuild a SimplifyQuery from analyses currently valid in a pass.
getPassTimerRequest the timer for this legacy-pass-manager's pass instance.
isBitcodeWriterPassCheck whether a pass is a BitcodeWriterPass.
isIRPrintingPassReturn true if a pass is for IR printing.