llvm::sampleprof::SampleProfileNameTable Class Reference

Sample-based profile reader. More...

#include "llvm/ProfileData/SampleProfReader.h"

Inheritance diagram for llvm::sampleprof::SampleProfileNameTable:

Classes
class	iterator

Public Types
using	const_iterator = iterator

Public Member Functions
	SampleProfileNameTable ()=default
	SampleProfileNameTable (const SampleProfileNameTable &)=delete
	SampleProfileNameTable (SampleProfileNameTable &&)=delete
SampleProfileNameTable &	operator= (const SampleProfileNameTable &)=delete
SampleProfileNameTable &	operator= (SampleProfileNameTable &&)=delete
virtual	~SampleProfileNameTable ()=default
virtual size_t	size () const =0
bool	empty () const
virtual FunctionId	operator[] (size_t Idx) const =0
iterator	begin () const
iterator	end () const

Detailed Description

Sample-based profile reader.

Each profile contains sample counts for all the functions executed. Inside each function, statements are annotated with the collected samples on all the instructions associated with that statement.

For this to produce meaningful data, the program needs to be compiled with some debug information (at minimum, line numbers: -gline-tables-only). Otherwise, it will be impossible to match IR instructions to the line numbers collected by the profiler.

From the profile file, we are interested in collecting the following information:

• A list of functions included in the profile (mangled names).
• For each function F:
  1. The total number of samples collected in F.
  2. The samples collected at each line in F. To provide some protection against source code shuffling, line numbers should be relative to the start of the function.

The reader supports two file formats: text and binary. The text format is useful for debugging and testing, while the binary format is more compact and I/O efficient. They can both be used interchangeably. Manages the sample profile name table, supporting both an eagerly loaded std::vector of FunctionId objects and lazy-loaded MD5 hashes read directly from the memory-mapped buffer. It enforces the exclusivity of these two formats and provides a unified read-only container interface.

Definition at line 353 of file SampleProfReader.h.

Member Typedef Documentation

const_iterator

using llvm::sampleprof::SampleProfileNameTable::const_iterator = iterator

Definition at line 384 of file SampleProfReader.h.

Constructor & Destructor Documentation

SampleProfileNameTable() [1/3]

llvm::sampleprof::SampleProfileNameTable::SampleProfileNameTable ( )

default

Referenced by llvm::sampleprof::SampleProfileNameTable::iterator::iterator(), operator=(), operator=(), SampleProfileNameTable(), and SampleProfileNameTable().

SampleProfileNameTable() [2/3]

llvm::sampleprof::SampleProfileNameTable::SampleProfileNameTable ( const SampleProfileNameTable & )

delete

References SampleProfileNameTable().

SampleProfileNameTable() [3/3]

llvm::sampleprof::SampleProfileNameTable::SampleProfileNameTable ( SampleProfileNameTable && )

delete

References SampleProfileNameTable().

~SampleProfileNameTable()

virtual llvm::sampleprof::SampleProfileNameTable::~SampleProfileNameTable ( )

virtualdefault

Member Function Documentation

begin()

iterator llvm::sampleprof::SampleProfileNameTable::begin ( ) const

inline

Definition at line 397 of file SampleProfReader.h.

empty()

bool llvm::sampleprof::SampleProfileNameTable::empty ( ) const

inline

Definition at line 394 of file SampleProfReader.h.

References size().

end()

iterator llvm::sampleprof::SampleProfileNameTable::end ( ) const

inline

Definition at line 398 of file SampleProfReader.h.

References size().

operator=() [1/2]

SampleProfileNameTable & llvm::sampleprof::SampleProfileNameTable::operator= ( const SampleProfileNameTable & )

delete

References SampleProfileNameTable().

operator=() [2/2]

SampleProfileNameTable & llvm::sampleprof::SampleProfileNameTable::operator= ( SampleProfileNameTable && )

delete

References SampleProfileNameTable().

operator[]()

virtual FunctionId llvm::sampleprof::SampleProfileNameTable::operator[] ( size_t Idx ) const

pure virtual

Implemented in llvm::sampleprof::EagerSampleProfileNameTable, and llvm::sampleprof::LazySampleProfileNameTable.

size()

virtual size_t llvm::sampleprof::SampleProfileNameTable::size ( ) const

pure virtual

Implemented in llvm::sampleprof::EagerSampleProfileNameTable, and llvm::sampleprof::LazySampleProfileNameTable.

Referenced by empty(), end(), and llvm::sampleprof::SampleProfileNameTable::iterator::operator*().

---

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

• include/llvm/ProfileData/SampleProfReader.h