LLVM  8.0.0svn
Public Member Functions | List of all members
llvm::ProfileSummaryInfo Class Reference

Analysis providing profile information. More...

#include "llvm/Analysis/ProfileSummaryInfo.h"

Public Member Functions

 ProfileSummaryInfo (Module &M)
 
 ProfileSummaryInfo (ProfileSummaryInfo &&Arg)
 
bool hasProfileSummary ()
 Returns true if profile summary is available. More...
 
bool hasSampleProfile ()
 Returns true if module M has sample profile. More...
 
bool hasInstrumentationProfile ()
 Returns true if module M has instrumentation profile. More...
 
bool invalidate (Module &, const PreservedAnalyses &, ModuleAnalysisManager::Invalidator &)
 Handle the invalidation of this information. More...
 
Optional< uint64_t > getProfileCount (const Instruction *CallInst, BlockFrequencyInfo *BFI)
 Returns the profile count for CallInst. More...
 
bool hasHugeWorkingSetSize ()
 Returns true if the working set size of the code is considered huge. More...
 
bool isFunctionEntryHot (const Function *F)
 Returns true if F has hot function entry. More...
 
bool isFunctionHotInCallGraph (const Function *F, BlockFrequencyInfo &BFI)
 Returns true if F contains hot code. More...
 
bool isFunctionEntryCold (const Function *F)
 Returns true if F has cold function entry. More...
 
bool isFunctionColdInCallGraph (const Function *F, BlockFrequencyInfo &BFI)
 Returns true if F contains only cold code. More...
 
bool isHotCount (uint64_t C)
 Returns true if F is a hot function. More...
 
bool isColdCount (uint64_t C)
 Returns true if count C is considered cold. More...
 
bool isHotBB (const BasicBlock *B, BlockFrequencyInfo *BFI)
 Returns true if BasicBlock B is considered hot. More...
 
bool isColdBB (const BasicBlock *B, BlockFrequencyInfo *BFI)
 Returns true if BasicBlock B is considered cold. More...
 
bool isHotCallSite (const CallSite &CS, BlockFrequencyInfo *BFI)
 Returns true if CallSite CS is considered hot. More...
 
bool isColdCallSite (const CallSite &CS, BlockFrequencyInfo *BFI)
 Returns true if Callsite CS is considered cold. More...
 
uint64_t getOrCompHotCountThreshold ()
 Returns HotCountThreshold if set. More...
 
uint64_t getOrCompColdCountThreshold ()
 Returns ColdCountThreshold if set. More...
 
uint64_t getHotCountThreshold ()
 Returns HotCountThreshold if set. More...
 
uint64_t getColdCountThreshold ()
 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 44 of file ProfileSummaryInfo.h.

Constructor & Destructor Documentation

◆ ProfileSummaryInfo() [1/2]

llvm::ProfileSummaryInfo::ProfileSummaryInfo ( Module M)
inline

◆ ProfileSummaryInfo() [2/2]

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

Definition at line 59 of file ProfileSummaryInfo.h.

Member Function Documentation

◆ getColdCountThreshold()

uint64_t llvm::ProfileSummaryInfo::getColdCountThreshold ( )
inline

Returns ColdCountThreshold if set.

Definition at line 124 of file ProfileSummaryInfo.h.

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

◆ getHotCountThreshold()

uint64_t llvm::ProfileSummaryInfo::getHotCountThreshold ( )
inline

Returns HotCountThreshold if set.

Definition at line 120 of file ProfileSummaryInfo.h.

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

◆ getOrCompColdCountThreshold()

uint64_t ProfileSummaryInfo::getOrCompColdCountThreshold ( )

Returns ColdCountThreshold if set.

Recompute HotCountThreshold if not set.

Definition at line 232 of file ProfileSummaryInfo.cpp.

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

Referenced by invalidate().

◆ getOrCompHotCountThreshold()

uint64_t ProfileSummaryInfo::getOrCompHotCountThreshold ( )

Returns HotCountThreshold if set.

Recompute HotCountThreshold if not set.

Definition at line 226 of file ProfileSummaryInfo.cpp.

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

Referenced by callsiteIsHot(), and invalidate().

◆ getProfileCount()

Optional< uint64_t > ProfileSummaryInfo::getProfileCount ( const Instruction CallInst,
BlockFrequencyInfo BFI 
)

◆ hasHugeWorkingSetSize()

bool ProfileSummaryInfo::hasHugeWorkingSetSize ( )

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

Definition at line 208 of file ProfileSummaryInfo.cpp.

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

Referenced by llvm::createCodeGenPreparePass(), invalidate(), and llvm::LoopUnrollPass::run().

◆ hasInstrumentationProfile()

bool llvm::ProfileSummaryInfo::hasInstrumentationProfile ( )
inline

Returns true if module M has instrumentation profile.

Definition at line 72 of file ProfileSummaryInfo.h.

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

◆ hasProfileSummary()

bool llvm::ProfileSummaryInfo::hasProfileSummary ( )
inline

Returns true if profile summary is available.

Definition at line 63 of file ProfileSummaryInfo.h.

Referenced by hasInstrumentationProfile(), hasSampleProfile(), llvm::pgo::promoteIndirectCall(), and shouldApply().

◆ hasSampleProfile()

bool llvm::ProfileSummaryInfo::hasSampleProfile ( )
inline

Returns true if module M has sample profile.

Definition at line 66 of file ProfileSummaryInfo.h.

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

Referenced by getProfileCount(), isColdCallSite(), isFunctionColdInCallGraph(), and isFunctionHotInCallGraph().

◆ 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 83 of file ProfileSummaryInfo.h.

References B, llvm::AMDGPUISD::BFI, C, F(), getOrCompColdCountThreshold(), getOrCompHotCountThreshold(), getProfileCount(), hasHugeWorkingSetSize(), isColdBB(), isColdCallSite(), isColdCount(), isFunctionColdInCallGraph(), isFunctionEntryCold(), isFunctionEntryHot(), isFunctionHotInCallGraph(), isHotBB(), isHotCallSite(), and isHotCount().

◆ isColdBB()

bool ProfileSummaryInfo::isColdBB ( const BasicBlock B,
BlockFrequencyInfo BFI 
)

Returns true if BasicBlock B is considered cold.

Definition at line 243 of file ProfileSummaryInfo.cpp.

References llvm::BlockFrequencyInfo::getBlockProfileCount(), and isColdCount().

Referenced by invalidate(), and isFunctionColdInCallGraph().

◆ isColdCallSite()

bool ProfileSummaryInfo::isColdCallSite ( const CallSite CS,
BlockFrequencyInfo BFI 
)

◆ isColdCount()

bool ProfileSummaryInfo::isColdCount ( uint64_t  C)

Returns true if count C is considered cold.

Definition at line 220 of file ProfileSummaryInfo.cpp.

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

Referenced by getHotness(), invalidate(), isColdBB(), isColdCallSite(), isFunctionColdInCallGraph(), and isFunctionEntryCold().

◆ isFunctionColdInCallGraph()

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

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 152 of file ProfileSummaryInfo.cpp.

References llvm::Function::getEntryCount(), getProfileCount(), hasSampleProfile(), I, isColdBB(), and isColdCount().

Referenced by llvm::createCodeGenPreparePass(), and invalidate().

◆ isFunctionEntryCold()

bool ProfileSummaryInfo::isFunctionEntryCold ( const Function F)

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 179 of file ProfileSummaryInfo.cpp.

References llvm::CallingConv::Cold, llvm::Function::getEntryCount(), getEntryForPercentile(), llvm::Function::hasFnAttribute(), isColdCount(), ProfileSummaryCutoffCold, ProfileSummaryCutoffHot, and ProfileSummaryHugeWorkingSetSizeThreshold.

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

◆ isFunctionEntryHot()

bool ProfileSummaryInfo::isFunctionEntryHot ( const Function F)

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 108 of file ProfileSummaryInfo.cpp.

References llvm::Function::getEntryCount(), and isHotCount().

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

◆ isFunctionHotInCallGraph()

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

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 123 of file ProfileSummaryInfo.cpp.

References llvm::Function::getEntryCount(), getProfileCount(), hasSampleProfile(), I, isHotBB(), and isHotCount().

Referenced by llvm::createCodeGenPreparePass(), and invalidate().

◆ isHotBB()

bool ProfileSummaryInfo::isHotBB ( const BasicBlock B,
BlockFrequencyInfo BFI 
)

Returns true if BasicBlock B is considered hot.

Definition at line 238 of file ProfileSummaryInfo.cpp.

References llvm::BlockFrequencyInfo::getBlockProfileCount(), and isHotCount().

Referenced by invalidate(), and isFunctionHotInCallGraph().

◆ isHotCallSite()

bool ProfileSummaryInfo::isHotCallSite ( const CallSite CS,
BlockFrequencyInfo BFI 
)

◆ isHotCount()

bool ProfileSummaryInfo::isHotCount ( uint64_t  C)

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