Profiling information for a single function. More...

#include "llvm/ProfileData/InstrProf.h"

Inheritance diagram for llvm::InstrProfRecord:

Collaboration diagram for llvm::InstrProfRecord:

Public Member Functions
	InstrProfRecord ()=default

	InstrProfRecord (std::vector< uint64_t > Counts)

	InstrProfRecord (InstrProfRecord &&)=default

	InstrProfRecord (const InstrProfRecord &RHS)

InstrProfRecord &	operator= (InstrProfRecord &&)=default

InstrProfRecord &	operator= (const InstrProfRecord &RHS)

uint32_t	getNumValueKinds () const
	Return the number of value profile kinds with non-zero number of profile sites. More...

uint32_t	getNumValueSites (uint32_t ValueKind) const
	Return the number of instrumented sites for ValueKind. More...

uint32_t	getNumValueData (uint32_t ValueKind) const
	Return the total number of ValueData for ValueKind. More...

uint32_t	getNumValueDataForSite (uint32_t ValueKind, uint32_t Site) const
	Return the number of value data collected for ValueKind at profiling site: Site. More...

std::unique_ptr< InstrProfValueData[]>	getValueForSite (uint32_t ValueKind, uint32_t Site, uint64_t *TotalC=nullptr) const
	Return the array of profiled values at `Site`. More...

uint64_t	getValueForSite (InstrProfValueData Dest[], uint32_t ValueKind, uint32_t Site) const
	Get the target value/counts of kind `ValueKind` collected at site `Site` and store the result in array `Dest`. More...

void	reserveSites (uint32_t ValueKind, uint32_t NumValueSites)
	Reserve space for NumValueSites sites. More...

void	addValueData (uint32_t ValueKind, uint32_t Site, InstrProfValueData VData, uint32_t N, InstrProfSymtab SymTab)
	Add ValueData for ValueKind at value Site. More...

void	merge (InstrProfRecord &Other, uint64_t Weight, function_ref< void(instrprof_error)> Warn)
	Merge the counts in `Other` into this one. More...

void	scale (uint64_t Weight, function_ref< void(instrprof_error)> Warn)
	Scale up profile counts (including value profile data) by `Weight`. More...

void	sortValueData ()
	Sort value profile data (per site) by count. More...

void	Clear ()
	Clear value data entries and edge counters. More...

void	clearValueData ()
	Clear value data entries. More...

void	accumuateCounts (CountSumOrPercent &Sum) const
	Compute the sums of all counts and store in Sum. More...

void	overlap (InstrProfRecord &Other, OverlapStats &Overlap, OverlapStats &FuncLevelOverlap, uint64_t ValueCutoff)
	Compute the overlap b/w this IntrprofRecord and Other. More...

void	overlapValueProfData (uint32_t ValueKind, InstrProfRecord &Src, OverlapStats &Overlap, OverlapStats &FuncLevelOverlap)
	Compute the overlap of value profile counts. More...

Public Attributes
std::vector< uint64_t >	Counts

Detailed Description

Profiling information for a single function.

Definition at line 689 of file InstrProf.h.

Constructor & Destructor Documentation

◆ InstrProfRecord() [1/4]

llvm::InstrProfRecord::InstrProfRecord ( )

default

◆ InstrProfRecord() [2/4]

llvm::InstrProfRecord::InstrProfRecord ( std::vector< uint64_t > Counts )

inline

Definition at line 693 of file InstrProf.h.

◆ InstrProfRecord() [3/4]

llvm::InstrProfRecord::InstrProfRecord ( InstrProfRecord && )

default

◆ InstrProfRecord() [4/4]

llvm::InstrProfRecord::InstrProfRecord ( const InstrProfRecord & RHS )

inline

Definition at line 695 of file InstrProf.h.

Member Function Documentation

◆ accumuateCounts()

void llvm::InstrProfRecord::accumuateCounts ( CountSumOrPercent & Sum ) const

Compute the sums of all counts and store in Sum.

Definition at line 482 of file InstrProf.cpp.

References llvm::CountSumOrPercent::CountSum, E, F(), I, llvm::CountSumOrPercent::NumEntries, and llvm::CountSumOrPercent::ValueCounts.

◆ addValueData()

void llvm::InstrProfRecord::addValueData	(	uint32_t	ValueKind,
		uint32_t	Site,
		InstrProfValueData *	VData,
		uint32_t	N,
		InstrProfSymtab *	SymTab
	)

Add ValueData for ValueKind at value Site.

Definition at line 708 of file InstrProf.cpp.

References I, and N.

Referenced by llvm::TextInstrProfReader::readHeader().

◆ Clear()

void llvm::InstrProfRecord::Clear ( )

inline

Clear value data entries and edge counters.

Definition at line 766 of file InstrProf.h.

Referenced by llvm::TextInstrProfReader::readNextRecord().

◆ clearValueData()

void llvm::InstrProfRecord::clearValueData ( )

inline

Clear value data entries.

Definition at line 772 of file InstrProf.h.

References llvm_unreachable, llvm::makeMutableArrayRef(), and llvm::None.

◆ getNumValueData()

uint32_t llvm::InstrProfRecord::getNumValueData ( uint32_t ValueKind ) const

inline

Return the total number of ValueData for ValueKind.

Definition at line 873 of file InstrProf.h.

References N.

◆ getNumValueDataForSite()

uint32_t llvm::InstrProfRecord::getNumValueDataForSite	(	uint32_t	ValueKind,
		uint32_t	Site
	)		const

inline

Return the number of value data collected for ValueKind at profiling site: Site.

Definition at line 884 of file InstrProf.h.

Referenced by llvm::annotateValueSite(), and llvm::InstrProfWriter::writeRecordInText().

◆ getNumValueKinds()

uint32_t llvm::InstrProfRecord::getNumValueKinds ( ) const

inline

Return the number of value profile kinds with non-zero number of profile sites.

Definition at line 866 of file InstrProf.h.

References llvm::empty().

Referenced by llvm::InstrProfWriter::writeRecordInText().

◆ getNumValueSites()

uint32_t llvm::InstrProfRecord::getNumValueSites ( uint32_t ValueKind ) const

inline

Return the number of instrumented sites for ValueKind.

Definition at line 880 of file InstrProf.h.

Referenced by overlap(), overlapValueProfData(), llvm::InstrProfValueSiteRecord::scale(), and llvm::InstrProfWriter::writeRecordInText().

◆ getValueForSite() [1/2]

std::unique_ptr< InstrProfValueData[]> llvm::InstrProfRecord::getValueForSite	(	uint32_t	ValueKind,
		uint32_t	Site,
		uint64_t *	TotalC = `nullptr`
	)		const

inline

Return the array of profiled values at Site.

If TotalC is not null, the total count of all target values at this site will be stored in *TotalC.

Definition at line 890 of file InstrProf.h.

References llvm::NVPTXISD::Dummy, and N.

Referenced by llvm::annotateValueSite(), and llvm::InstrProfWriter::writeRecordInText().

◆ getValueForSite() [2/2]

uint64_t llvm::InstrProfRecord::getValueForSite	(	InstrProfValueData	Dest[],
		uint32_t	ValueKind,
		uint32_t	Site
	)		const

inline

Get the target value/counts of kind ValueKind collected at site Site and store the result in array Dest.

Return the total counts of all target values at this site.

Definition at line 906 of file InstrProf.h.

References I, and llvm::SaturatingAdd().

◆ merge()

void llvm::InstrProfRecord::merge	(	InstrProfRecord &	Other,
		uint64_t	Weight,
		function_ref< void(instrprof_error)>	Warn
	)

Merge the counts in Other into this one.

Optionally scale merged counts by Weight.

Definition at line 656 of file InstrProf.cpp.

References llvm::count_mismatch, llvm::counter_overflow, Counts, E, I, and llvm::SaturatingMultiplyAdd().

Referenced by llvm::InstrProfWriter::overlapRecord().

◆ operator=() [1/2]

InstrProfRecord& llvm::InstrProfRecord::operator= ( InstrProfRecord && )

default

◆ operator=() [2/2]

InstrProfRecord& llvm::InstrProfRecord::operator= ( const InstrProfRecord & RHS )

inline

Definition at line 701 of file InstrProf.h.

References Counts, N, Other, and scale().

◆ overlap()

void llvm::InstrProfRecord::overlap	(	InstrProfRecord &	Other,
		OverlapStats &	Overlap,
		OverlapStats &	FuncLevelOverlap,
		uint64_t	ValueCutoff
	)

Compute the overlap b/w this IntrprofRecord and Other.

Definition at line 551 of file InstrProf.cpp.

References llvm::OverlapStats::addOneMismatch(), assert(), llvm::OverlapStats::Base, Counts, llvm::CountSumOrPercent::CountSum, E, getNumValueSites(), I, llvm::max(), llvm::CountSumOrPercent::NumEntries, llvm::OverlapStats::Overlap, llvm::OverlapStats::score(), llvm::OverlapStats::Test, and llvm::OverlapStats::Valid.

Referenced by llvm::InstrProfWriter::overlapRecord().

◆ overlapValueProfData()

void llvm::InstrProfRecord::overlapValueProfData	(	uint32_t	ValueKind,
		InstrProfRecord &	Src,
		OverlapStats &	Overlap,
		OverlapStats &	FuncLevelOverlap
	)

Compute the overlap of value profile counts.

Definition at line 533 of file InstrProf.cpp.

References assert(), getNumValueSites(), and I.

◆ reserveSites()

void llvm::InstrProfRecord::reserveSites	(	uint32_t	ValueKind,
		uint32_t	NumValueSites
	)

inline

Reserve space for NumValueSites sites.

Definition at line 920 of file InstrProf.h.

Referenced by llvm::TextInstrProfReader::readHeader().

◆ scale()

void llvm::InstrProfRecord::scale	(	uint64_t	Weight,
		function_ref< void(instrprof_error)>	Warn
	)

Scale up profile counts (including value profile data) by Weight.

Definition at line 684 of file InstrProf.cpp.

References llvm::counter_overflow, llvm::InstrProfSymtab::getFunctionHashFromAddress(), and llvm::SaturatingMultiply().

Referenced by llvm::InstrProfWriter::overlapRecord().

◆ sortValueData()

void llvm::InstrProfRecord::sortValueData ( )

inline

Sort value profile data (per site) by count.

Definition at line 759 of file InstrProf.h.

Referenced by llvm::InstrProfWriter::overlapRecord().

Member Data Documentation

◆ Counts

std::vector<uint64_t> llvm::InstrProfRecord::Counts

Definition at line 690 of file InstrProf.h.

Referenced by llvm::InstrProfSummaryBuilder::addRecord(), llvm::InstrProfRecordWriterTrait::EmitData(), llvm::InstrProfRecordWriterTrait::EmitKeyDataLength(), merge(), llvm::InstrProfWriter::mergeRecordsFromWriter(), operator=(), overlap(), llvm::TextInstrProfReader::readNextRecord(), and llvm::InstrProfWriter::writeRecordInText().

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

include/llvm/ProfileData/InstrProf.h
lib/ProfileData/InstrProf.cpp

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ InstrProfRecord() [1/4]

◆ InstrProfRecord() [2/4]

◆ InstrProfRecord() [3/4]

◆ InstrProfRecord() [4/4]

Member Function Documentation

◆ accumuateCounts()

◆ addValueData()

◆ Clear()

◆ clearValueData()

◆ getNumValueData()

◆ getNumValueDataForSite()

◆ getNumValueKinds()

◆ getNumValueSites()

◆ getValueForSite() [1/2]

◆ getValueForSite() [2/2]

◆ merge()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ overlap()

◆ overlapValueProfData()

◆ reserveSites()

◆ scale()

◆ sortValueData()

Member Data Documentation

◆ Counts