LLVM  15.0.0git
Public Member Functions | Static Public Member Functions | List of all members
llvm::TextInstrProfReader Class Reference

Reader for the simple text based instrprof format. More...

#include "llvm/ProfileData/InstrProfReader.h"

Inheritance diagram for llvm::TextInstrProfReader:
Inheritance graph
[legend]
Collaboration diagram for llvm::TextInstrProfReader:
Collaboration graph
[legend]

Public Member Functions

 TextInstrProfReader (std::unique_ptr< MemoryBuffer > DataBuffer_)
 
 TextInstrProfReader (const TextInstrProfReader &)=delete
 
TextInstrProfReaderoperator= (const TextInstrProfReader &)=delete
 
bool isIRLevelProfile () const override
 
bool hasCSIRLevelProfile () const override
 
bool instrEntryBBEnabled () const override
 
bool hasSingleByteCoverage () const override
 Return true if the profile has single byte counters representing coverage. More...
 
bool functionEntryOnly () const override
 Return true if the profile only instruments function entries. More...
 
InstrProfKind getProfileKind () const override
 Returns a BitsetEnum describing the attributes of the profile. More...
 
Error readHeader () override
 Read the header. More...
 
Error readNextRecord (NamedInstrProfRecord &Record) override
 Read a single record. More...
 
InstrProfSymtabgetSymtab () override
 Return the PGO symtab. 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 &Buffer)
 Return true if the given buffer is in text instrprof format. More...
 
- 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< InstrProfSymtabSymtab
 

Detailed Description

Reader for the simple text based instrprof format.

This format is a simple text format that's suitable for test data. Records are separated by one or more blank lines, and record fields are separated by new lines.

Each record consists of a function name, a function hash, a number of counters, and then each counter value, in that order.

Definition at line 195 of file InstrProfReader.h.

Constructor & Destructor Documentation

◆ TextInstrProfReader() [1/2]

llvm::TextInstrProfReader::TextInstrProfReader ( std::unique_ptr< MemoryBuffer DataBuffer_)
inline

Definition at line 207 of file InstrProfReader.h.

◆ TextInstrProfReader() [2/2]

llvm::TextInstrProfReader::TextInstrProfReader ( const TextInstrProfReader )
delete

Member Function Documentation

◆ functionEntryOnly()

bool llvm::TextInstrProfReader::functionEntryOnly ( ) const
inlineoverridevirtual

Return true if the profile only instruments function entries.

Implements llvm::InstrProfReader.

Definition at line 232 of file InstrProfReader.h.

References llvm::FunctionEntryOnly.

◆ getProfileKind()

InstrProfKind llvm::TextInstrProfReader::getProfileKind ( ) const
inlineoverridevirtual

Returns a BitsetEnum describing the attributes of the profile.

To check individual attributes prefer using the helpers above.

Implements llvm::InstrProfReader.

Definition at line 236 of file InstrProfReader.h.

◆ getSymtab()

InstrProfSymtab& llvm::TextInstrProfReader::getSymtab ( )
inlineoverridevirtual

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 244 of file InstrProfReader.h.

References assert(), and llvm::InstrProfReader::Symtab.

◆ hasCSIRLevelProfile()

bool llvm::TextInstrProfReader::hasCSIRLevelProfile ( ) const
inlineoverridevirtual

Implements llvm::InstrProfReader.

Definition at line 219 of file InstrProfReader.h.

References llvm::ContextSensitive.

◆ hasFormat()

bool TextInstrProfReader::hasFormat ( const MemoryBuffer Buffer)
static

Return true if the given buffer is in text instrprof format.

Definition at line 158 of file InstrProfReader.cpp.

References llvm::all_of(), llvm::StringRef::begin(), c, llvm::count(), llvm::MemoryBuffer::getBufferSize(), llvm::MemoryBuffer::getBufferStart(), and llvm::min().

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

◆ hasSingleByteCoverage()

bool llvm::TextInstrProfReader::hasSingleByteCoverage ( ) const
inlineoverridevirtual

Return true if the profile has single byte counters representing coverage.

Implements llvm::InstrProfReader.

Definition at line 228 of file InstrProfReader.h.

References llvm::SingleByteCoverage.

◆ instrEntryBBEnabled()

bool llvm::TextInstrProfReader::instrEntryBBEnabled ( ) const
inlineoverridevirtual

Implements llvm::InstrProfReader.

Definition at line 223 of file InstrProfReader.h.

References llvm::FunctionEntryInstrumentation.

◆ isIRLevelProfile()

bool llvm::TextInstrProfReader::isIRLevelProfile ( ) const
inlineoverridevirtual

Implements llvm::InstrProfReader.

Definition at line 215 of file InstrProfReader.h.

References llvm::IRInstrumentation.

◆ operator=()

TextInstrProfReader& llvm::TextInstrProfReader::operator= ( const TextInstrProfReader )
delete

◆ readHeader()

Error TextInstrProfReader::readHeader ( )
overridevirtual

◆ readNextRecord()

Error TextInstrProfReader::readNextRecord ( NamedInstrProfRecord Record)
overridevirtual

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