Reader for the indexed binary instrprof format. More...

#include "llvm/ProfileData/InstrProfReader.h"

Inheritance diagram for llvm::IndexedInstrProfReader:

Collaboration diagram for llvm::IndexedInstrProfReader:

Public Member Functions
	IndexedInstrProfReader (std::unique_ptr< MemoryBuffer > DataBuffer, std::unique_ptr< MemoryBuffer > RemappingBuffer=nullptr)

	IndexedInstrProfReader (const IndexedInstrProfReader &)=delete

IndexedInstrProfReader &	operator= (const IndexedInstrProfReader &)=delete

uint64_t	getVersion () const
	Return the profile version. More...

bool	isIRLevelProfile () const override

bool	hasCSIRLevelProfile () const override

bool	instrEntryBBEnabled () const override

Error	readHeader () override
	Read the file header. More...

Error	readNextRecord (NamedInstrProfRecord &Record) override
	Read a single record. More...

Expected< InstrProfRecord >	getInstrProfRecord (StringRef FuncName, uint64_t FuncHash)
	Return the NamedInstrProfRecord associated with FuncName and FuncHash. More...

Error	getFunctionCounts (StringRef FuncName, uint64_t FuncHash, std::vector< uint64_t > &Counts)
	Fill Counts with the profile data for the given function name. More...

uint64_t	getMaximumFunctionCount (bool UseCS)
	Return the maximum of all known function counts. More...

void	setValueProfDataEndianness (support::endianness Endianness)

InstrProfSymtab &	getSymtab () override
	Return the PGO symtab. More...

ProfileSummary &	getSummary (bool UseCS)
	Return the profile summary. More...

Public Member Functions inherited from llvm::InstrProfReader
	InstrProfReader ()=default

virtual	~InstrProfReader ()=default

virtual Error	printBinaryIds (raw_ostream &OS)
	Print binary ids on stream OS. More...

InstrProfIterator	begin ()
	Iterator over profile data. More...

InstrProfIterator	end ()

virtual bool	useDebugInfoCorrelate () const
	Return true if we must provide debug info to create PGO profiles. More...

void	accumulateCounts (CountSumOrPercent &Sum, bool IsCS)
	Compute the sum of counts and return in Sum. More...

bool	isEOF ()
	Return true if the reader has finished reading the profile data. More...

bool	hasError ()
	Return true if the reader encountered an error reading profiling data. More...

Error	getError ()
	Get the current error. More...

Static Public Member Functions
static bool	hasFormat (const MemoryBuffer &DataBuffer)
	Return true if the given buffer is in an indexed instrprof format. More...

static Expected< std::unique_ptr< IndexedInstrProfReader > >	create (const Twine &Path, const Twine &RemappingPath="")
	Factory method to create an indexed reader. More...

static Expected< std::unique_ptr< IndexedInstrProfReader > >	create (std::unique_ptr< MemoryBuffer > Buffer, std::unique_ptr< MemoryBuffer > RemappingBuffer=nullptr)

Static Public Member Functions inherited from llvm::InstrProfReader
static Expected< std::unique_ptr< InstrProfReader > >	create (const Twine &Path, const InstrProfCorrelator *Correlator=nullptr)
	Factory method to create an appropriately typed reader for the given instrprof file. More...

static Expected< std::unique_ptr< InstrProfReader > >	create (std::unique_ptr< MemoryBuffer > Buffer, const InstrProfCorrelator *Correlator=nullptr)

Additional Inherited Members
Protected Member Functions inherited from llvm::InstrProfReader
Error	error (instrprof_error Err, const std::string &ErrMsg="")
	Set the current error and return same. More...

Error	error (Error &&E)

Error	success ()
	Clear the current error and return a successful one. More...

Protected Attributes inherited from llvm::InstrProfReader
std::unique_ptr< InstrProfSymtab >	Symtab

Detailed Description

Reader for the indexed binary instrprof format.

Definition at line 483 of file InstrProfReader.h.

Constructor & Destructor Documentation

◆ IndexedInstrProfReader() [1/2]

llvm::IndexedInstrProfReader::IndexedInstrProfReader	(	std::unique_ptr< MemoryBuffer >	DataBuffer,
		std::unique_ptr< MemoryBuffer >	RemappingBuffer = `nullptr`
	)

inline

Definition at line 507 of file InstrProfReader.h.

◆ IndexedInstrProfReader() [2/2]

llvm::IndexedInstrProfReader::IndexedInstrProfReader ( const IndexedInstrProfReader & )

delete

Member Function Documentation

◆ create() [1/2]

Expected< std::unique_ptr< IndexedInstrProfReader > > IndexedInstrProfReader::create	(	const Twine &	Path,
		const Twine &	RemappingPath = `""`
	)

static

Factory method to create an indexed reader.

Definition at line 95 of file InstrProfReader.cpp.

References E, move, setupMemoryBuffer(), and llvm::Twine::str().

Referenced by annotateAllFunctions(), and llvm::coverage::CoverageMapping::load().

◆ create() [2/2]

Expected< std::unique_ptr< IndexedInstrProfReader > > IndexedInstrProfReader::create	(	std::unique_ptr< MemoryBuffer >	Buffer,
		std::unique_ptr< MemoryBuffer >	RemappingBuffer = `nullptr`
	)

static

Definition at line 116 of file InstrProfReader.cpp.

References llvm::bad_magic, E, hasFormat(), initializeReader(), llvm::max(), move, and llvm::too_large.

◆ getFunctionCounts()

Error IndexedInstrProfReader::getFunctionCounts	(	StringRef	FuncName,
		uint64_t	FuncHash,
		std::vector< uint64_t > &	Counts
	)

Fill Counts with the profile data for the given function name.

Definition at line 990 of file InstrProfReader.cpp.

References E, error, and move.

◆ getInstrProfRecord()

Expected< InstrProfRecord > IndexedInstrProfReader::getInstrProfRecord	(	StringRef	FuncName,
		uint64_t	FuncHash
	)

Return the NamedInstrProfRecord associated with FuncName and FuncHash.

Definition at line 975 of file InstrProfReader.cpp.

References llvm::Data.

◆ getMaximumFunctionCount()

uint64_t llvm::IndexedInstrProfReader::getMaximumFunctionCount ( bool UseCS )

inline

Return the maximum of all known function counts.

UseCS indicates whether to use the context-sensitive count.

Definition at line 544 of file InstrProfReader.h.

References assert().

◆ getSummary()

ProfileSummary& llvm::IndexedInstrProfReader::getSummary ( bool UseCS )

inline

Return the profile summary.

UseCS indicates whether to use the context-sensitive summary.

Definition at line 574 of file InstrProfReader.h.

References assert().

◆ getSymtab()

InstrProfSymtab & IndexedInstrProfReader::getSymtab ( )

overridevirtual

Return the PGO symtab.

There are three different readers: Raw, Text, and Indexed profile readers. The first two types of readers are used only by llvm-profdata tool, while the indexed profile reader is also used by llvm-cov tool and the compiler ( backend or frontend). Since creating PGO symtab can create significant runtime and memory overhead (as it touches data for the whole program), InstrProfSymtab for the indexed profile reader should be created on demand and it is recommended to be only used for dumping purpose with llvm-proftool, not with the compiler.

Implements llvm::InstrProfReader.

Definition at line 961 of file InstrProfReader.cpp.

References llvm::consumeError(), E, error, Index, move, and llvm::InstrProfError::take().

◆ getVersion()

uint64_t llvm::IndexedInstrProfReader::getVersion ( ) const

inline

Return the profile version.

Definition at line 516 of file InstrProfReader.h.

References Index.

◆ hasCSIRLevelProfile()

bool llvm::IndexedInstrProfReader::hasCSIRLevelProfile ( ) const

inlineoverridevirtual

Implements llvm::InstrProfReader.

Definition at line 518 of file InstrProfReader.h.

References Index.

◆ hasFormat()

bool IndexedInstrProfReader::hasFormat ( const MemoryBuffer & DataBuffer )

static

Return true if the given buffer is in an indexed instrprof format.

Definition at line 839 of file InstrProfReader.cpp.

References llvm::MemoryBuffer::getBufferSize(), llvm::MemoryBuffer::getBufferStart(), llvm::msf::Magic, llvm::IndexedInstrProf::Magic, and support().

Referenced by llvm::InstrProfReader::create(), and create().

◆ instrEntryBBEnabled()

bool llvm::IndexedInstrProfReader::instrEntryBBEnabled ( ) const

inlineoverridevirtual

Implements llvm::InstrProfReader.

Definition at line 522 of file InstrProfReader.h.

References Index.

◆ isIRLevelProfile()

bool llvm::IndexedInstrProfReader::isIRLevelProfile ( ) const

inlineoverridevirtual

Implements llvm::InstrProfReader.

Definition at line 517 of file InstrProfReader.h.

References Index.

◆ operator=()

IndexedInstrProfReader& llvm::IndexedInstrProfReader::operator= ( const IndexedInstrProfReader & )

delete

◆ readHeader()

Error IndexedInstrProfReader::readHeader ( )

overridevirtual

Read the file header.

Implements llvm::InstrProfReader.

Definition at line 904 of file InstrProfReader.cpp.

References support().

◆ readNextRecord()

Error IndexedInstrProfReader::readNextRecord ( NamedInstrProfRecord & Record )

overridevirtual

Read a single record.

Implements llvm::InstrProfReader.

Definition at line 1001 of file InstrProfReader.cpp.

References llvm::Data, E, error, Index, and move.

◆ setValueProfDataEndianness()

void llvm::IndexedInstrProfReader::setValueProfDataEndianness ( support::endianness Endianness )

inline

Definition at line 563 of file InstrProfReader.h.

References llvm::msgpack::Endianness, and Index.

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

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

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ IndexedInstrProfReader() [1/2]

◆ IndexedInstrProfReader() [2/2]

Member Function Documentation

◆ create() [1/2]

◆ create() [2/2]

◆ getFunctionCounts()

◆ getInstrProfRecord()

◆ getMaximumFunctionCount()

◆ getSummary()

◆ getSymtab()

◆ getVersion()

◆ hasCSIRLevelProfile()

◆ hasFormat()

◆ instrEntryBBEnabled()

◆ isIRLevelProfile()

◆ operator=()

◆ readHeader()

◆ readNextRecord()

◆ setValueProfDataEndianness()