Analysis providing profile information. More...

#include "llvm/Analysis/ProfileSummaryInfo.h"

Public Member Functions
	ProfileSummaryInfo (const Module &M)

	ProfileSummaryInfo (ProfileSummaryInfo &&Arg)=default

void	refresh ()
	If no summary is present, attempt to refresh. More...

bool	hasProfileSummary () const
	Returns true if profile summary is available. More...

bool	hasSampleProfile () const
	Returns true if module `M` has sample profile. More...

bool	hasInstrumentationProfile () const
	Returns true if module `M` has instrumentation profile. More...

bool	hasCSInstrumentationProfile () const
	Returns true if module `M` has context sensitive instrumentation profile. More...

bool	invalidate (Module &, const PreservedAnalyses &, ModuleAnalysisManager::Invalidator &)
	Handle the invalidation of this information. More...

Optional< uint64_t >	getProfileCount (const CallBase &CallInst, BlockFrequencyInfo *BFI, bool AllowSynthetic=false) const
	Returns the profile count for `CallInst`. More...

bool	hasPartialSampleProfile () const
	Returns true if module `M` has partial-profile sample profile. More...

bool	hasHugeWorkingSetSize () const
	Returns true if the working set size of the code is considered huge. More...

bool	hasLargeWorkingSetSize () const
	Returns true if the working set size of the code is considered large. More...

bool	isFunctionEntryHot (const Function *F) const
	Returns true if `F` has hot function entry. More...

bool	isFunctionHotInCallGraph (const Function *F, BlockFrequencyInfo &BFI) const
	Returns true if `F` contains hot code. More...

bool	isFunctionEntryCold (const Function *F) const
	Returns true if `F` has cold function entry. More...

bool	isFunctionColdInCallGraph (const Function *F, BlockFrequencyInfo &BFI) const
	Returns true if `F` contains only cold code. More...

bool	isFunctionHotnessUnknown (const Function &F) const
	Returns true if the hotness of `F` is unknown. More...

bool	isFunctionHotInCallGraphNthPercentile (int PercentileCutoff, const Function *F, BlockFrequencyInfo &BFI) const
	Returns true if `F` contains hot code with regard to a given hot percentile cutoff value. More...

bool	isFunctionColdInCallGraphNthPercentile (int PercentileCutoff, const Function *F, BlockFrequencyInfo &BFI) const
	Returns true if `F` contains cold code with regard to a given cold percentile cutoff value. More...

bool	isHotCount (uint64_t C) const
	Returns true if count `C` is considered hot. More...

bool	isColdCount (uint64_t C) const
	Returns true if count `C` is considered cold. More...

bool	isHotCountNthPercentile (int PercentileCutoff, uint64_t C) const
	Returns true if count `C` is considered hot with regard to a given hot percentile cutoff value. More...

bool	isColdCountNthPercentile (int PercentileCutoff, uint64_t C) const
	Returns true if count `C` is considered cold with regard to a given cold percentile cutoff value. More...

bool	isHotBlock (const BasicBlock BB, BlockFrequencyInfo BFI) const
	Returns true if BasicBlock `BB` is considered hot. More...

bool	isColdBlock (const BasicBlock BB, BlockFrequencyInfo BFI) const
	Returns true if BasicBlock `BB` is considered cold. More...

bool	isHotBlockNthPercentile (int PercentileCutoff, const BasicBlock BB, BlockFrequencyInfo BFI) const
	Returns true if BasicBlock `BB` is considered hot with regard to a given hot percentile cutoff value. More...

bool	isColdBlockNthPercentile (int PercentileCutoff, const BasicBlock BB, BlockFrequencyInfo BFI) const
	Returns true if BasicBlock `BB` is considered cold with regard to a given cold percentile cutoff value. More...

bool	isHotCallSite (const CallBase &CB, BlockFrequencyInfo *BFI) const
	Returns true if the call site `CB` is considered hot. More...

bool	isColdCallSite (const CallBase &CB, BlockFrequencyInfo *BFI) const
	Returns true if call site `CB` is considered cold. More...

uint64_t	getOrCompHotCountThreshold () const
	Returns HotCountThreshold if set. More...

uint64_t	getOrCompColdCountThreshold () const
	Returns ColdCountThreshold if set. More...

uint64_t	getHotCountThreshold () const
	Returns HotCountThreshold if set. More...

uint64_t	getColdCountThreshold () const
	Returns ColdCountThreshold if set. More...

Detailed Description

Analysis providing profile information.

This is an immutable analysis pass that provides ability to query global (program-level) profile information. The main APIs are isHotCount and isColdCount that tells whether a given profile count is considered hot/cold based on the profile summary. This also provides convenience methods to check whether a function is hot or cold.

Definition at line 39 of file ProfileSummaryInfo.h.

Constructor & Destructor Documentation

◆ ProfileSummaryInfo() [1/2]

llvm::ProfileSummaryInfo::ProfileSummaryInfo ( const Module & M )

inline

Definition at line 61 of file ProfileSummaryInfo.h.

References M, and refresh().

◆ ProfileSummaryInfo() [2/2]

llvm::ProfileSummaryInfo::ProfileSummaryInfo ( ProfileSummaryInfo && Arg )

default

Member Function Documentation

◆ getColdCountThreshold()

uint64_t llvm::ProfileSummaryInfo::getColdCountThreshold ( ) const

inline

Returns ColdCountThreshold if set.

Definition at line 176 of file ProfileSummaryInfo.h.

References llvm::Optional< T >::value_or().

◆ getHotCountThreshold()

uint64_t llvm::ProfileSummaryInfo::getHotCountThreshold ( ) const

inline

Returns HotCountThreshold if set.

Definition at line 172 of file ProfileSummaryInfo.h.

References llvm::Optional< T >::value_or().

◆ getOrCompColdCountThreshold()

uint64_t ProfileSummaryInfo::getOrCompColdCountThreshold ( ) const

Returns ColdCountThreshold if set.

Recompute HotCountThreshold if not set.

Definition at line 321 of file ProfileSummaryInfo.cpp.

References llvm::Optional< T >::value_or().

Referenced by annotateAllFunctions().

◆ getOrCompHotCountThreshold()

uint64_t ProfileSummaryInfo::getOrCompHotCountThreshold ( ) const

Returns HotCountThreshold if set.

Recompute HotCountThreshold if not set.

Definition at line 317 of file ProfileSummaryInfo.cpp.

References UINT64_MAX, and llvm::Optional< T >::value_or().

Referenced by annotateAllFunctions().

◆ getProfileCount()

Optional< uint64_t > ProfileSummaryInfo::getProfileCount	(	const CallBase &	CallInst,
		BlockFrequencyInfo *	BFI,
		bool	AllowSynthetic = `false`
	)		const

Returns the profile count for CallInst.

Definition at line 76 of file ProfileSummaryInfo.cpp.

References assert(), llvm::AMDGPUISD::BFI, hasSampleProfile(), and llvm::None.

Referenced by computeFunctionSummary(), isColdCallSite(), isFunctionColdInCallGraph(), isFunctionHotInCallGraph(), isHotCallSite(), and updateCallProfile().

◆ hasCSInstrumentationProfile()

bool llvm::ProfileSummaryInfo::hasCSInstrumentationProfile ( ) const

inline

Returns true if module M has context sensitive instrumentation profile.

Definition at line 83 of file ProfileSummaryInfo.h.

References hasProfileSummary(), and llvm::ProfileSummary::PSK_CSInstr.

◆ hasHugeWorkingSetSize()

bool ProfileSummaryInfo::hasHugeWorkingSetSize ( ) const

Returns true if the working set size of the code is considered huge.

Definition at line 281 of file ProfileSummaryInfo.cpp.

References llvm::Optional< T >::value().

◆ hasInstrumentationProfile()

bool llvm::ProfileSummaryInfo::hasInstrumentationProfile ( ) const

inline

Returns true if module M has instrumentation profile.

Definition at line 77 of file ProfileSummaryInfo.h.

References hasProfileSummary(), and llvm::ProfileSummary::PSK_Instr.

Referenced by llvm::isPGSOColdCodeOnly().

◆ hasLargeWorkingSetSize()

bool ProfileSummaryInfo::hasLargeWorkingSetSize ( ) const

Returns true if the working set size of the code is considered large.

Definition at line 285 of file ProfileSummaryInfo.cpp.

References llvm::Optional< T >::value().

Referenced by llvm::isPGSOColdCodeOnly().

◆ hasPartialSampleProfile()

bool ProfileSummaryInfo::hasPartialSampleProfile ( ) const

Returns true if module M has partial-profile sample profile.

Definition at line 374 of file ProfileSummaryInfo.cpp.

References hasProfileSummary(), PartialProfile, and llvm::ProfileSummary::PSK_Sample.

Referenced by isFunctionHotnessUnknown(), and llvm::isPGSOColdCodeOnly().

◆ hasProfileSummary()

bool llvm::ProfileSummaryInfo::hasProfileSummary ( ) const

inline

Returns true if profile summary is available.

Definition at line 68 of file ProfileSummaryInfo.h.

Referenced by hasCSInstrumentationProfile(), hasInstrumentationProfile(), hasPartialSampleProfile(), hasSampleProfile(), isFunctionColdInCallGraph(), isFunctionEntryCold(), isFunctionEntryHot(), isFunctionHotInCallGraph(), refresh(), llvm::InstructionCombiningPass::runOnFunction(), llvm::InstructionSelect::runOnMachineFunction(), shouldApply(), llvm::shouldFuncOptimizeForSizeImpl(), llvm::shouldOptimizeForSizeImpl(), and unswitchLoop().

◆ hasSampleProfile()

bool llvm::ProfileSummaryInfo::hasSampleProfile ( ) const

inline

Returns true if module M has sample profile.

Definition at line 71 of file ProfileSummaryInfo.h.

References hasProfileSummary(), and llvm::ProfileSummary::PSK_Sample.

Referenced by getProfileCount(), isColdCallSite(), isFunctionColdInCallGraph(), isFunctionHotInCallGraph(), llvm::isPGSOColdCodeOnly(), llvm::shouldFuncOptimizeForSizeImpl(), and llvm::shouldOptimizeForSizeImpl().

◆ invalidate()

bool llvm::ProfileSummaryInfo::invalidate	(	Module &	,
		const PreservedAnalyses &	,
		ModuleAnalysisManager::Invalidator &
	)

inline

Handle the invalidation of this information.

When used as a result of ProfileSummaryAnalysis this method will be called when the module this was computed for changes. Since profile summary is immutable after it is annotated on the module, we return false here.

Definition at line 94 of file ProfileSummaryInfo.h.

◆ isColdBlock()

bool ProfileSummaryInfo::isColdBlock	(	const BasicBlock *	BB,
		BlockFrequencyInfo *	BFI
	)		const

Returns true if BasicBlock BB is considered cold.

Definition at line 331 of file ProfileSummaryInfo.cpp.

References BB, llvm::AMDGPUISD::BFI, and isColdCount().

Referenced by isFunctionColdInCallGraph().

◆ isColdBlockNthPercentile()

bool ProfileSummaryInfo::isColdBlockNthPercentile	(	int	PercentileCutoff,
		const BasicBlock *	BB,
		BlockFrequencyInfo *	BFI
	)		const

Returns true if BasicBlock BB is considered cold with regard to a given cold percentile cutoff value.

PercentileCutoff is encoded as a 6 digit decimal fixed point number, where the first two digits are the whole part. E.g. 995000 for 99.5 percentile.

Definition at line 352 of file ProfileSummaryInfo.cpp.

References BB, llvm::AMDGPUISD::BFI, and PercentileCutoff.

◆ isColdCallSite()

bool ProfileSummaryInfo::isColdCallSite	(	const CallBase &	CB,
		BlockFrequencyInfo *	BFI
	)		const

Returns true if call site CB is considered cold.

Definition at line 363 of file ProfileSummaryInfo.cpp.

References llvm::AMDGPUISD::BFI, llvm::CallBase::getCaller(), getProfileCount(), llvm::Function::hasProfileData(), hasSampleProfile(), and isColdCount().

◆ isColdCount()

bool ProfileSummaryInfo::isColdCount ( uint64_t C ) const

Returns true if count C is considered cold.

Definition at line 293 of file ProfileSummaryInfo.cpp.

References llvm::Optional< T >::value().

Referenced by llvm::sampleprofutil::callsiteIsHot(), getHotness(), isColdBlock(), isColdCallSite(), isFunctionColdInCallGraph(), and isFunctionEntryCold().

◆ isColdCountNthPercentile()

bool ProfileSummaryInfo::isColdCountNthPercentile	(	int	PercentileCutoff,
		uint64_t	C
	)		const

Returns true if count C is considered cold with regard to a given cold percentile cutoff value.

PercentileCutoff is encoded as a 6 digit decimal fixed point number, where the first two digits are the whole part. E.g. 995000 for 99.5 percentile.

Definition at line 312 of file ProfileSummaryInfo.cpp.

References PercentileCutoff.

Referenced by isColdBlock().

◆ isFunctionColdInCallGraph()

bool ProfileSummaryInfo::isFunctionColdInCallGraph	(	const Function *	F,
		BlockFrequencyInfo &	BFI
	)		const

Returns true if F contains only cold code.

Returns true if the function only contains cold code.

This means that the function entry and blocks are all cold, and (in the case of Sample PGO) the total call edge count is cold. If it returns false, it either means it is not cold or it is unknown (for example, no profile data is available).

Definition at line 142 of file ProfileSummaryInfo.cpp.

References BB, llvm::AMDGPUISD::BFI, F, getProfileCount(), hasProfileSummary(), hasSampleProfile(), I, isColdBlock(), and isColdCount().

Referenced by unswitchLoop().

◆ isFunctionColdInCallGraphNthPercentile()

bool ProfileSummaryInfo::isFunctionColdInCallGraphNthPercentile	(	int	PercentileCutoff,
		const Function *	F,
		BlockFrequencyInfo &	BFI
	)		const

Returns true if F contains cold code with regard to a given cold percentile cutoff value.

Definition at line 212 of file ProfileSummaryInfo.cpp.

References llvm::AMDGPUISD::BFI, F, and PercentileCutoff.

◆ isFunctionEntryCold()

bool ProfileSummaryInfo::isFunctionEntryCold ( const Function * F ) const

Returns true if F has cold function entry.

Returns true if the function's entry is a cold.

If it returns false, it either means it is not cold or it is unknown whether it is cold or not (for example, no profile data is available).

Definition at line 221 of file ProfileSummaryInfo.cpp.

References llvm::CallingConv::Cold, F, hasProfileSummary(), and isColdCount().

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

◆ isFunctionEntryHot()

bool ProfileSummaryInfo::isFunctionEntryHot ( const Function * F ) const

Returns true if F has hot function entry.

Returns true if the function's entry is hot.

If it returns false, it either means it is not hot or it is unknown whether it is hot or not (for example, no profile data is available).

Definition at line 98 of file ProfileSummaryInfo.cpp.

References F, hasProfileSummary(), and isHotCount().

Referenced by llvm::ProfileSummaryPrinterPass::run(), and shouldApply().

◆ isFunctionHotInCallGraph()

bool ProfileSummaryInfo::isFunctionHotInCallGraph	(	const Function *	F,
		BlockFrequencyInfo &	BFI
	)		const

Returns true if F contains hot code.

Returns true if the function contains hot code.

This can include a hot function entry count, hot basic block, or (in the case of Sample PGO) hot total call edge count. If it returns false, it either means it is not hot or it is unknown (for example, no profile data is available).

Definition at line 113 of file ProfileSummaryInfo.cpp.

References BB, llvm::AMDGPUISD::BFI, F, getProfileCount(), hasProfileSummary(), hasSampleProfile(), I, isHotBlock(), and isHotCount().