LLVM: llvm::CodeMetrics Struct Reference

LLVM 20.0.0git

Utility to calculate the size and a few similar metrics for a set of basic blocks. More...

#include "llvm/Analysis/CodeMetrics.h"

Public Member Functions
void	analyzeBasicBlock (const BasicBlock BB, const TargetTransformInfo &TTI, const SmallPtrSetImpl< const Value > &EphValues, bool PrepareForLTO=false, const Loop *L=nullptr)
	Add information about a block to the current state.

Static Public Member Functions
static void	collectEphemeralValues (const Loop L, AssumptionCache AC, SmallPtrSetImpl< const Value * > &EphValues)
	Collect a loop's ephemeral values (those used only by an assume or similar intrinsics in the loop).

static void	collectEphemeralValues (const Function L, AssumptionCache AC, SmallPtrSetImpl< const Value * > &EphValues)
	Collect a functions's ephemeral values (those used only by an assume or similar intrinsics in the function).

Public Attributes
bool	exposesReturnsTwice = false
	True if this function contains a call to setjmp or other functions with attribute "returns twice" without having the attribute itself.

bool	isRecursive = false
	True if this function calls itself.

bool	notDuplicatable = false
	True if this function cannot be duplicated.

ConvergenceKind	Convergence = ConvergenceKind::None
	The kind of convergence specified in this function.

bool	usesDynamicAlloca = false
	True if this function calls alloca (in the C sense).

InstructionCost	NumInsts = 0
	Code size cost of the analyzed blocks.

unsigned	NumBlocks = false
	Number of analyzed blocks.

DenseMap< const BasicBlock *, InstructionCost >	NumBBInsts
	Keeps track of basic block code size estimates.

unsigned	NumCalls = false
	Keep track of the number of calls to 'big' functions.

unsigned	NumInlineCandidates = 0
	The number of calls to internal functions with a single caller.

unsigned	NumVectorInsts = 0
	How many instructions produce vector values.

unsigned	NumRets = 0
	How many 'ret' instructions the blocks contain.

Detailed Description

Utility to calculate the size and a few similar metrics for a set of basic blocks.

Definition at line 33 of file CodeMetrics.h.

Member Function Documentation

◆ analyzeBasicBlock()

void CodeMetrics::analyzeBasicBlock	(	const BasicBlock *	BB,
		const TargetTransformInfo &	TTI,
		const SmallPtrSetImpl< const Value * > &	EphValues,
		bool	PrepareForLTO = `false`,
		const Loop *	L = `nullptr`
	)

Add information about a block to the current state.

Fill in the current structure with information gleaned from the specified block.

Definition at line 129 of file CodeMetrics.cpp.

References assert(), llvm::Controlled, Convergence, llvm::SmallPtrSetImpl< PtrType >::count(), llvm::dbgs(), llvm::ExtendedLoop, extendsConvergenceOutsideLoop(), F, llvm::TargetTransformInfo::getInstructionCost(), llvm::BasicBlock::getParent(), llvm::BasicBlock::getTerminator(), I, llvm::TargetTransformInfo::isLoweredToCall(), isRecursive, LLVM_DEBUG, llvm::None, notDuplicatable, NumBBInsts, NumBlocks, NumCalls, NumInlineCandidates, NumInsts, NumRets, NumVectorInsts, llvm::TargetTransformInfo::TCK_CodeSize, llvm::Uncontrolled, and usesDynamicAlloca.

◆ collectEphemeralValues() [1/2]

void CodeMetrics::collectEphemeralValues	(	const Function *	L,
		AssumptionCache *	AC,
		SmallPtrSetImpl< const Value * > &	EphValues
	)

static

Collect a functions's ephemeral values (those used only by an assume or similar intrinsics in the function).

Definition at line 95 of file CodeMetrics.cpp.

References appendSpeculatableOperands(), assert(), llvm::AssumptionCache::assumptions(), completeEphemeralValues(), F, I, and llvm::SmallPtrSetImpl< PtrType >::insert().

◆ collectEphemeralValues() [2/2]

void CodeMetrics::collectEphemeralValues	(	const Loop *	L,
		AssumptionCache *	AC,
		SmallPtrSetImpl< const Value * > &	EphValues
	)

static

Collect a loop's ephemeral values (those used only by an assume or similar intrinsics in the loop).

Definition at line 71 of file CodeMetrics.cpp.

References appendSpeculatableOperands(), llvm::AssumptionCache::assumptions(), completeEphemeralValues(), I, and llvm::SmallPtrSetImpl< PtrType >::insert().

Referenced by llvm::slpvectorizer::BoUpSLP::BoUpSLP(), llvm::LoopVectorizationCostModel::collectValuesToIgnore(), computeHeuristicUnrollFactor(), findBestNonTrivialUnswitchCandidate(), llvm::PPCTTIImpl::isHardwareLoopProfitable(), llvm::IVUsers::IVUsers(), llvm::FunctionSpecializer::run(), tryToUnrollAndJamLoop(), and tryToUnrollLoop().

Member Data Documentation

◆ Convergence

ConvergenceKind llvm::CodeMetrics::Convergence = ConvergenceKind::None

The kind of convergence specified in this function.

Definition at line 48 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ exposesReturnsTwice

bool llvm::CodeMetrics::exposesReturnsTwice = false

True if this function contains a call to setjmp or other functions with attribute "returns twice" without having the attribute itself.

Definition at line 36 of file CodeMetrics.h.

◆ isRecursive

bool llvm::CodeMetrics::isRecursive = false

True if this function calls itself.

Definition at line 39 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ notDuplicatable

bool llvm::CodeMetrics::notDuplicatable = false

True if this function cannot be duplicated.

True if this function contains one or more indirect branches, or it contains one or more 'noduplicate' instructions.

Definition at line 45 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ NumBBInsts

DenseMap<const BasicBlock *, InstructionCost> llvm::CodeMetrics::NumBBInsts

Keeps track of basic block code size estimates.

Definition at line 60 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ NumBlocks

unsigned llvm::CodeMetrics::NumBlocks = false

Number of analyzed blocks.

Definition at line 57 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ NumCalls

unsigned llvm::CodeMetrics::NumCalls = false

Keep track of the number of calls to 'big' functions.

Definition at line 63 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ NumInlineCandidates

unsigned llvm::CodeMetrics::NumInlineCandidates = 0

The number of calls to internal functions with a single caller.

These are likely targets for future inlining, likely exposed by interleaved devirtualization.

Definition at line 69 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ NumInsts

InstructionCost llvm::CodeMetrics::NumInsts = 0

Code size cost of the analyzed blocks.

Definition at line 54 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ NumRets

unsigned llvm::CodeMetrics::NumRets = 0

How many 'ret' instructions the blocks contain.

Definition at line 77 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ NumVectorInsts

unsigned llvm::CodeMetrics::NumVectorInsts = 0

How many instructions produce vector values.

The inliner is more aggressive with inlining vector kernels.

Definition at line 74 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

◆ usesDynamicAlloca

bool llvm::CodeMetrics::usesDynamicAlloca = false

True if this function calls alloca (in the C sense).

Definition at line 51 of file CodeMetrics.h.

Referenced by analyzeBasicBlock().

The documentation for this struct was generated from the following files:

include/llvm/Analysis/CodeMetrics.h
lib/Analysis/CodeMetrics.cpp