LLVM 20.0.0git
Macros | Enumerations | Functions | Variables
LoopDeletion.cpp File Reference
#include "llvm/Transforms/Scalar/LoopDeletion.h"
#include "llvm/ADT/SmallVector.h"
#include "llvm/ADT/Statistic.h"
#include "llvm/Analysis/CFG.h"
#include "llvm/Analysis/InstructionSimplify.h"
#include "llvm/Analysis/LoopIterator.h"
#include "llvm/Analysis/LoopPass.h"
#include "llvm/Analysis/MemorySSA.h"
#include "llvm/Analysis/OptimizationRemarkEmitter.h"
#include "llvm/Analysis/ScalarEvolution.h"
#include "llvm/IR/Dominators.h"
#include "llvm/IR/PatternMatch.h"
#include "llvm/Transforms/Scalar/LoopPassManager.h"
#include "llvm/Transforms/Utils/LoopUtils.h"

Go to the source code of this file.

Macros

#define DEBUG_TYPE   "loop-delete"
 

Enumerations

enum class  LoopDeletionResult { Unmodified , Modified , Deleted }
 

Functions

 STATISTIC (NumDeleted, "Number of loops deleted")
 
 STATISTIC (NumBackedgesBroken, "Number of loops for which we managed to break the backedge")
 
static LoopDeletionResult merge (LoopDeletionResult A, LoopDeletionResult B)
 
static bool isLoopDead (Loop *L, ScalarEvolution &SE, SmallVectorImpl< BasicBlock * > &ExitingBlocks, BasicBlock *ExitBlock, bool &Changed, BasicBlock *Preheader, LoopInfo &LI)
 Determines if a loop is dead.
 
static bool isLoopNeverExecuted (Loop *L)
 This function returns true if there is no viable path from the entry block to the header of L.
 
static ValuegetValueOnFirstIteration (Value *V, DenseMap< Value *, Value * > &FirstIterValue, const SimplifyQuery &SQ)
 
static bool canProveExitOnFirstIteration (Loop *L, DominatorTree &DT, LoopInfo &LI)
 
static LoopDeletionResult breakBackedgeIfNotTaken (Loop *L, DominatorTree &DT, ScalarEvolution &SE, LoopInfo &LI, MemorySSA *MSSA, OptimizationRemarkEmitter &ORE)
 If we can prove the backedge is untaken, remove it.
 
static LoopDeletionResult deleteLoopIfDead (Loop *L, DominatorTree &DT, ScalarEvolution &SE, LoopInfo &LI, MemorySSA *MSSA, OptimizationRemarkEmitter &ORE)
 Remove a loop if it is dead.
 

Variables

static cl::opt< boolEnableSymbolicExecution ("loop-deletion-enable-symbolic-execution", cl::Hidden, cl::init(true), cl::desc("Break backedge through symbolic execution of 1st iteration " "attempting to prove that the backedge is never taken"))
 

Macro Definition Documentation

◆ DEBUG_TYPE

#define DEBUG_TYPE   "loop-delete"

Definition at line 34 of file LoopDeletion.cpp.

Enumeration Type Documentation

◆ LoopDeletionResult

enum class LoopDeletionResult
strong
Enumerator
Unmodified 
Modified 
Deleted 

Definition at line 45 of file LoopDeletion.cpp.

Function Documentation

◆ breakBackedgeIfNotTaken()

static LoopDeletionResult breakBackedgeIfNotTaken ( Loop L,
DominatorTree DT,
ScalarEvolution SE,
LoopInfo LI,
MemorySSA MSSA,
OptimizationRemarkEmitter ORE 
)
static

If we can prove the backedge is untaken, remove it.

This destroys the loop, but leaves the (now trivially loop invariant) control flow and side effects (if any) in place.

Definition at line 399 of file LoopDeletion.cpp.

References assert(), llvm::breakLoopBackedge(), canProveExitOnFirstIteration(), Deleted, llvm::ScalarEvolution::getBackedgeTakenCount(), llvm::ScalarEvolution::getConstantMaxBackedgeTakenCount(), llvm::ScalarEvolution::isKnownNonZero(), llvm::SCEV::isZero(), and Unmodified.

Referenced by llvm::LoopDeletionPass::run().

◆ canProveExitOnFirstIteration()

static bool canProveExitOnFirstIteration ( Loop L,
DominatorTree DT,
LoopInfo LI 
)
static

◆ deleteLoopIfDead()

static LoopDeletionResult deleteLoopIfDead ( Loop L,
DominatorTree DT,
ScalarEvolution SE,
LoopInfo LI,
MemorySSA MSSA,
OptimizationRemarkEmitter ORE 
)
static

Remove a loop if it is dead.

A loop is considered dead either if it does not impact the observable behavior of the program other than finite running time, or if it is required to make progress by an attribute such as 'mustprogress' or 'llvm.loop.mustprogress' and does not make any. This may remove infinite loops that have been required to make progress.

This entire process relies pretty heavily on LoopSimplify form and LCSSA in order to make various safety checks work.

Returns
true if any changes were made. This may mutate the loop even if it is unable to delete it due to hoisting trivially loop invariant instructions out of the loop.

Definition at line 436 of file LoopDeletion.cpp.

References assert(), llvm::dbgs(), DEBUG_TYPE, Deleted, llvm::deleteDeadLoop(), llvm::OptimizationRemarkEmitter::emit(), llvm::ScalarEvolution::forgetLoop(), llvm::PoisonValue::get(), llvm::BasicBlock::isEHPad(), isLoopDead(), isLoopNeverExecuted(), LLVM_DEBUG, Modified, P, llvm::BasicBlock::phis(), and Unmodified.

Referenced by llvm::LoopDeletionPass::run().

◆ getValueOnFirstIteration()

static Value * getValueOnFirstIteration ( Value V,
DenseMap< Value *, Value * > &  FirstIterValue,
const SimplifyQuery SQ 
)
static

◆ isLoopDead()

static bool isLoopDead ( Loop L,
ScalarEvolution SE,
SmallVectorImpl< BasicBlock * > &  ExitingBlocks,
BasicBlock ExitBlock,
bool Changed,
BasicBlock Preheader,
LoopInfo LI 
)
static

◆ isLoopNeverExecuted()

static bool isLoopNeverExecuted ( Loop L)
static

This function returns true if there is no viable path from the entry block to the header of L.

Right now, it only does a local search to save compile time.

Definition at line 147 of file LoopDeletion.cpp.

References assert(), Cond, llvm::PatternMatch::m_Br(), llvm::PatternMatch::m_ConstantInt(), llvm::PatternMatch::match(), llvm::pred_empty(), llvm::predecessors(), and std::swap().

Referenced by deleteLoopIfDead().

◆ merge()

static LoopDeletionResult merge ( LoopDeletionResult  A,
LoopDeletionResult  B 
)
static

Definition at line 51 of file LoopDeletion.cpp.

References A, B, Deleted, Modified, and Unmodified.

Referenced by llvm::LoopDeletionPass::run(), and llvm::simple_ilist< T, Options >::sort().

◆ STATISTIC() [1/2]

STATISTIC ( NumBackedgesBroken  ,
"Number of loops for which we managed to break the backedge"   
)

◆ STATISTIC() [2/2]

STATISTIC ( NumDeleted  ,
"Number of loops deleted"   
)

Variable Documentation

◆ EnableSymbolicExecution

cl::opt< bool > EnableSymbolicExecution("loop-deletion-enable-symbolic-execution", cl::Hidden, cl::init(true), cl::desc("Break backedge through symbolic execution of 1st iteration " "attempting to prove that the backedge is never taken")) ( "loop-deletion-enable-symbolic-execution"  ,
cl::Hidden  ,
cl::init(true ,
cl::desc("Break backedge through symbolic execution of 1st iteration " "attempting to prove that the backedge is never taken")   
)
static