Classes
struct	Argument
	A key-value pair with a debug location that is used to display the remarks at the right place in the source. More...

struct	BitstreamMetaParserHelper
	Helper to parse a META_BLOCK for a bitstream remark container. More...

struct	BitstreamMetaSerializer
	Serializer of metadata for bitstream remarks. More...

struct	BitstreamParserHelper
	Helper to parse any bitstream remark container. More...

struct	BitstreamRemarkParser
	Parses and holds the state of the latest parsed remark. More...

struct	BitstreamRemarkParserHelper
	Helper to parse a REMARK_BLOCK for a bitstream remark container. More...

struct	BitstreamRemarkSerializer
	Implementation of the remark serializer using LLVM bitstream. More...

struct	BitstreamRemarkSerializerHelper
	Serialize the remarks to LLVM bitstream. More...

class	EndOfFileError

class	HotnessThresholdParser

struct	MetaSerializer
	This is the base class for a remark metadata serializer. More...

struct	ParsedStringTable
	In-memory representation of the string table parsed from a buffer (e.g. More...

struct	Remark
	A remark type used for both emission and parsing. More...

struct	RemarkLinker

struct	RemarkLocation
	The debug location used to track a remark back to the source file. More...

struct	RemarkParser
	Parser used to parse a raw buffer to remarks::Remark objects. More...

struct	RemarkSerializer
	This is the base class for a remark serializer. More...

class	RemarkStreamer

struct	StringTable
	The string table used for serializing remarks. More...

struct	YAMLMetaSerializer

class	YAMLParseError

struct	YAMLRemarkParser
	Regular YAML to Remark parser. More...

struct	YAMLRemarkSerializer
	Serialize the remarks to YAML. More...

struct	YAMLStrTabMetaSerializer

struct	YAMLStrTabRemarkParser
	YAML with a string table to Remark parser. More...

struct	YAMLStrTabRemarkSerializer
	Serialize the remarks to YAML using a string table. More...

Enumerations
enum class	BitstreamRemarkContainerType { SeparateRemarksMeta , SeparateRemarksFile , Standalone , First = SeparateRemarksMeta , Last = Standalone }
	Type of the remark container. More...

enum	BlockIDs { META_BLOCK_ID = bitc::FIRST_APPLICATION_BLOCKID , REMARK_BLOCK_ID }
	The possible blocks that will be encountered in a bitstream remark container. More...

enum	RecordIDs { RECORD_META_CONTAINER_INFO = 1 , RECORD_META_REMARK_VERSION , RECORD_META_STRTAB , RECORD_META_EXTERNAL_FILE , RECORD_REMARK_HEADER , RECORD_REMARK_DEBUG_LOC , RECORD_REMARK_HOTNESS , RECORD_REMARK_ARG_WITH_DEBUGLOC , RECORD_REMARK_ARG_WITHOUT_DEBUGLOC , RECORD_FIRST = RECORD_META_CONTAINER_INFO , RECORD_LAST = RECORD_REMARK_ARG_WITHOUT_DEBUGLOC }
	The possible records that can be encountered in the previously described blocks. More...

enum class	Type { Unknown , Passed , Missed , Analysis , AnalysisFPCommute , AnalysisAliasing , Failure , First = Unknown , Last = Failure }
	The type of the remark. More...

enum class	Format { Unknown , YAML , YAMLStrTab , Bitstream }
	The format used for serializing/deserializing remarks. More...

enum class	SerializerMode { Separate , Standalone }

Functions
constexpr StringLiteral	ContainerMagic ("RMRK")
	The magic number used for identifying remark blocks.

Expected< std::optional< uint64_t > >	parseHotnessThresholdOption (StringRef Arg)

template<typename T >
bool	operator< (const std::optional< T > &LHS, const std::optional< T > &RHS)
	Comparison operators for Remark objects and dependent objects.

bool	operator== (const RemarkLocation &LHS, const RemarkLocation &RHS)

bool	operator!= (const RemarkLocation &LHS, const RemarkLocation &RHS)

bool	operator< (const RemarkLocation &LHS, const RemarkLocation &RHS)

bool	operator== (const Argument &LHS, const Argument &RHS)

bool	operator!= (const Argument &LHS, const Argument &RHS)

bool	operator< (const Argument &LHS, const Argument &RHS)

bool	operator== (const Remark &LHS, const Remark &RHS)

bool	operator!= (const Remark &LHS, const Remark &RHS)

bool	operator< (const Remark &LHS, const Remark &RHS)

constexpr StringLiteral	Magic ("REMARKS")

Expected< Format >	parseFormat (StringRef FormatStr)
	Parse and validate a string for the remark format.

Expected< Format >	magicToFormat (StringRef Magic)
	Parse and validate a magic number to a remark format.

Expected< std::optional< StringRef > >	getRemarksSectionContents (const object::ObjectFile &Obj)
	Returns a buffer with the contents of the remarks section depending on the format of the file.

Expected< std::unique_ptr< RemarkParser > >	createRemarkParser (Format ParserFormat, StringRef Buf)

Expected< std::unique_ptr< RemarkParser > >	createRemarkParser (Format ParserFormat, StringRef Buf, ParsedStringTable StrTab)

Expected< std::unique_ptr< RemarkParser > >	createRemarkParserFromMeta (Format ParserFormat, StringRef Buf, std::optional< ParsedStringTable > StrTab=std::nullopt, std::optional< StringRef > ExternalFilePrependPath=std::nullopt)

Expected< std::unique_ptr< RemarkSerializer > >	createRemarkSerializer (Format RemarksFormat, SerializerMode Mode, raw_ostream &OS)
	Create a remark serializer.

Expected< std::unique_ptr< RemarkSerializer > >	createRemarkSerializer (Format RemarksFormat, SerializerMode Mode, raw_ostream &OS, remarks::StringTable StrTab)
	Create a remark serializer that uses a pre-filled string table.

Expected< std::unique_ptr< BitstreamRemarkParser > >	createBitstreamParserFromMeta (StringRef Buf, std::optional< ParsedStringTable > StrTab=std::nullopt, std::optional< StringRef > ExternalFilePrependPath=std::nullopt)

Expected< std::unique_ptr< YAMLRemarkParser > >	createYAMLParserFromMeta (StringRef Buf, std::optional< ParsedStringTable > StrTab=std::nullopt, std::optional< StringRef > ExternalFilePrependPath=std::nullopt)

Variables
constexpr uint64_t	CurrentContainerVersion = 0
	The current version of the remark container.

constexpr StringRef	MetaBlockName = StringRef("Meta", 4)

constexpr StringRef	RemarkBlockName = StringRef("Remark", 6)

constexpr StringRef	MetaContainerInfoName = StringRef("Container info", 14)

constexpr StringRef	MetaRemarkVersionName = StringRef("Remark version", 14)

constexpr StringRef	MetaStrTabName = StringRef("String table", 12)

constexpr StringRef	MetaExternalFileName = StringRef("External File", 13)

constexpr StringRef	RemarkHeaderName = StringRef("Remark header", 13)

constexpr StringRef	RemarkDebugLocName = StringRef("Remark debug location", 21)

constexpr StringRef	RemarkHotnessName = StringRef("Remark hotness", 14)

constexpr StringRef	RemarkArgWithDebugLocName

constexpr StringRef	RemarkArgWithoutDebugLocName = StringRef("Argument", 8)

constexpr uint64_t	CurrentRemarkVersion = 0
	The current version of the remark entry.

Enumeration Type Documentation

◆ BitstreamRemarkContainerType

enum class llvm::remarks::BitstreamRemarkContainerType

strong

Type of the remark container.

The remark container has two modes:

separate: the metadata is separate from the remarks and points to the auxiliary file that contains the remarks.
standalone: the metadata and the remarks are emitted together.

Enumerator
SeparateRemarksMeta	The metadata emitted separately. This will contain the following: Container version and type String table External file
SeparateRemarksFile	The remarks emitted separately. This will contain the following: Container version and type Remark version
Standalone	Everything is emitted together. This will contain the following: Container version and type Remark version String table
First
Last

Definition at line 35 of file BitstreamRemarkContainer.h.

◆ BlockIDs

enum llvm::remarks::BlockIDs

The possible blocks that will be encountered in a bitstream remark container.

Enumerator

META_BLOCK_ID

The metadata block is mandatory.

It should always come after the BLOCKINFO_BLOCK, and contains metadata that should be used when parsing REMARK_BLOCKs. There should always be only one META_BLOCK.

REMARK_BLOCK_ID

One remark entry is represented using a REMARK_BLOCK.

There can be multiple REMARK_BLOCKs in the same file.

Definition at line 59 of file BitstreamRemarkContainer.h.

◆ Format

enum class llvm::remarks::Format

strong

The format used for serializing/deserializing remarks.

Enumerator
Unknown
YAML
YAMLStrTab
Bitstream

Definition at line 25 of file RemarkFormat.h.

◆ RecordIDs

enum llvm::remarks::RecordIDs

The possible records that can be encountered in the previously described blocks.

Enumerator
RECORD_META_CONTAINER_INFO
RECORD_META_REMARK_VERSION
RECORD_META_STRTAB
RECORD_META_EXTERNAL_FILE
RECORD_REMARK_HEADER
RECORD_REMARK_DEBUG_LOC
RECORD_REMARK_HOTNESS
RECORD_REMARK_ARG_WITH_DEBUGLOC
RECORD_REMARK_ARG_WITHOUT_DEBUGLOC
RECORD_FIRST
RECORD_LAST

Definition at line 75 of file BitstreamRemarkContainer.h.

◆ SerializerMode

enum class llvm::remarks::SerializerMode

strong

Enumerator
Separate
Standalone

Definition at line 28 of file RemarkSerializer.h.

◆ Type

enum class llvm::remarks::Type

strong

The type of the remark.

Enumerator
Unknown
Passed
Missed
Analysis
AnalysisFPCommute
AnalysisAliasing
Failure
First
Last

Definition at line 54 of file Remark.h.

Function Documentation

◆ ContainerMagic()

constexpr StringLiteral llvm::remarks::ContainerMagic ( "RMRK" )

constexpr

The magic number used for identifying remark blocks.

Referenced by magicToFormat(), llvm::remarks::BitstreamRemarkSerializerHelper::setupBlockInfo(), and validateMagicNumber().

◆ createBitstreamParserFromMeta()

Expected< std::unique_ptr< BitstreamRemarkParser > > llvm::remarks::createBitstreamParserFromMeta	(	StringRef	Buf,
		std::optional< ParsedStringTable >	StrTab = `std::nullopt`,
		std::optional< StringRef >	ExternalFilePrependPath = `std::nullopt`
	)

Definition at line 310 of file BitstreamRemarkParser.cpp.

References E, llvm::remarks::BitstreamParserHelper::parseMagic(), and validateMagicNumber().

Referenced by createRemarkParserFromMeta().

◆ createRemarkParser() [1/2]

Expected< std::unique_ptr< RemarkParser > > llvm::remarks::createRemarkParser	(	Format	ParserFormat,
		StringRef	Buf
	)

Definition at line 52 of file RemarkParser.cpp.

References Bitstream, llvm::createStringError(), llvm_unreachable, Unknown, YAML, and YAMLStrTab.

◆ createRemarkParser() [2/2]

Expected< std::unique_ptr< RemarkParser > > llvm::remarks::createRemarkParser	(	Format	ParserFormat,
		StringRef	Buf,
		ParsedStringTable	StrTab
	)

Definition at line 70 of file RemarkParser.cpp.

References Bitstream, llvm::createStringError(), llvm_unreachable, Unknown, YAML, and YAMLStrTab.

◆ createRemarkParserFromMeta()

Expected< std::unique_ptr< RemarkParser > > llvm::remarks::createRemarkParserFromMeta	(	Format	ParserFormat,
		StringRef	Buf,
		std::optional< ParsedStringTable >	StrTab = `std::nullopt`,
		std::optional< StringRef >	ExternalFilePrependPath = `std::nullopt`
	)

Definition at line 89 of file RemarkParser.cpp.

References Bitstream, createBitstreamParserFromMeta(), llvm::createStringError(), createYAMLParserFromMeta(), llvm_unreachable, Unknown, YAML, and YAMLStrTab.

Referenced by llvm::remarks::RemarkLinker::link().

◆ createRemarkSerializer() [1/2]

Expected< std::unique_ptr< RemarkSerializer > > llvm::remarks::createRemarkSerializer	(	Format	RemarksFormat,
		SerializerMode	Mode,
		raw_ostream &	OS
	)

Create a remark serializer.

Definition at line 21 of file RemarkSerializer.cpp.

References llvm::createStringError(), llvm_unreachable, OS, and llvm::RemarksFormat.

Referenced by llvm::remarks::RemarkLinker::serialize(), and llvm::setupLLVMOptimizationRemarks().

◆ createRemarkSerializer() [2/2]

Expected< std::unique_ptr< RemarkSerializer > > llvm::remarks::createRemarkSerializer	(	Format	RemarksFormat,
		SerializerMode	Mode,
		raw_ostream &	OS,
		remarks::StringTable	StrTab
	)

Create a remark serializer that uses a pre-filled string table.

Definition at line 38 of file RemarkSerializer.cpp.

References llvm::createStringError(), llvm_unreachable, OS, and llvm::RemarksFormat.

◆ createYAMLParserFromMeta()

Expected< std::unique_ptr< YAMLRemarkParser > > llvm::remarks::createYAMLParserFromMeta	(	StringRef	Buf,
		std::optional< ParsedStringTable >	StrTab = `std::nullopt`,
		std::optional< StringRef >	ExternalFilePrependPath = `std::nullopt`
	)

Definition at line 111 of file YAMLRemarkParser.cpp.

References llvm::sys::path::append(), llvm::createFileError(), llvm::createStringError(), llvm::ErrorOr< T >::getError(), llvm::MemoryBuffer::getFile(), parseMagic(), parseStrTab(), parseStrTabSize(), parseVersion(), llvm::StringRef::startswith(), and llvm::Expected< T >::takeError().

Referenced by createRemarkParserFromMeta().

◆ getRemarksSectionContents()

Expected< std::optional< StringRef > > llvm::remarks::getRemarksSectionContents ( const object::ObjectFile & Obj )

Returns a buffer with the contents of the remarks section depending on the format of the file.

If the section doesn't exist, this returns an empty optional.

Definition at line 39 of file RemarkLinker.cpp.

References getRemarksSectionName(), llvm::object::ObjectFile::sections(), and llvm::Expected< T >::takeError().

Referenced by llvm::remarks::RemarkLinker::link().

◆ Magic()

constexpr StringLiteral llvm::remarks::Magic ( "REMARKS" )

constexpr

Referenced by emitMagic(), magicToFormat(), and parseMagic().

◆ magicToFormat()

Expected< Format > llvm::remarks::magicToFormat ( StringRef Magic )

Parse and validate a magic number to a remark format.

Definition at line 35 of file RemarkFormat.cpp.

References ContainerMagic(), llvm::createStringError(), llvm::StringRef::data(), llvm::StringSwitch< T, R >::Default(), Magic(), and llvm::StringSwitch< T, R >::StartsWith().

Referenced by llvm::remarks::RemarkLinker::link().

◆ operator!=() [1/3]

bool llvm::remarks::operator!=	(	const Argument &	LHS,
		const Argument &	RHS
	)

inline

Definition at line 147 of file Remark.h.

References LHS, and RHS.

◆ operator!=() [2/3]

bool llvm::remarks::operator!=	(	const Remark &	LHS,
		const Remark &	RHS
	)

inline

Definition at line 163 of file Remark.h.

References LHS, and RHS.

◆ operator!=() [3/3]

bool llvm::remarks::operator!=	(	const RemarkLocation &	LHS,
		const RemarkLocation &	RHS
	)

inline

Definition at line 134 of file Remark.h.

References LHS, and RHS.

◆ operator<() [1/4]

bool llvm::remarks::operator<	(	const Argument &	LHS,
		const Argument &	RHS
	)

inline

Definition at line 151 of file Remark.h.

References LHS, and RHS.

◆ operator<() [2/4]

bool llvm::remarks::operator<	(	const Remark &	LHS,
		const Remark &	RHS
	)

inline

Definition at line 167 of file Remark.h.

References LHS, and RHS.

◆ operator<() [3/4]

bool llvm::remarks::operator<	(	const RemarkLocation &	LHS,
		const RemarkLocation &	RHS
	)

inline

Definition at line 138 of file Remark.h.

References LHS, and RHS.

◆ operator<() [4/4]

template<typename T >

bool llvm::remarks::operator<	(	const std::optional< T > &	LHS,
		const std::optional< T > &	RHS
	)

Comparison operators for Remark objects and dependent objects.

Definition at line 115 of file Remark.h.

References LHS, and RHS.

◆ operator==() [1/3]

bool llvm::remarks::operator==	(	const Argument &	LHS,
		const Argument &	RHS
	)

inline

Definition at line 143 of file Remark.h.

References LHS, and RHS.

◆ operator==() [2/3]

bool llvm::remarks::operator==	(	const Remark &	LHS,
		const Remark &	RHS
	)

inline

Definition at line 156 of file Remark.h.

References LHS, and RHS.

◆ operator==() [3/3]

bool llvm::remarks::operator==	(	const RemarkLocation &	LHS,
		const RemarkLocation &	RHS
	)

inline

Definition at line 128 of file Remark.h.

References LHS, and RHS.

◆ parseFormat()

Expected< Format > llvm::remarks::parseFormat ( StringRef FormatStr )

Parse and validate a string for the remark format.

Definition at line 20 of file RemarkFormat.cpp.

References llvm::StringSwitch< T, R >::Case(), llvm::StringSwitch< T, R >::Cases(), llvm::createStringError(), llvm::StringRef::data(), and llvm::StringSwitch< T, R >::Default().

Referenced by llvm::setupLLVMOptimizationRemarks().

◆ parseHotnessThresholdOption()

Expected< std::optional< uint64_t > > llvm::remarks::parseHotnessThresholdOption ( StringRef Arg )

inline

Definition at line 31 of file HotnessThresholdParser.h.

References Arg, llvm::createStringError(), and llvm::inconvertibleErrorCode().

Referenced by llvm::remarks::HotnessThresholdParser::parse().

Variable Documentation

◆ CurrentContainerVersion

constexpr uint64_t llvm::remarks::CurrentContainerVersion = 0

constexpr

The current version of the remark container.

Note: this is different from the version of the remark entry.

Definition at line 26 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamMetaSerializer::emit().

◆ CurrentRemarkVersion

constexpr uint64_t llvm::remarks::CurrentRemarkVersion = 0

constexpr

The current version of the remark entry.

Definition at line 27 of file Remark.h.

Referenced by llvm::remarks::BitstreamMetaSerializer::emit(), emitVersion(), and parseVersion().

◆ MetaBlockName

constexpr StringRef llvm::remarks::MetaBlockName = StringRef("Meta", 4)

constexpr

Definition at line 70 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupMetaBlockInfo().

◆ MetaContainerInfoName

constexpr StringRef llvm::remarks::MetaContainerInfoName = StringRef("Container info", 14)

constexpr

Definition at line 92 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupMetaBlockInfo().

◆ MetaExternalFileName

constexpr StringRef llvm::remarks::MetaExternalFileName = StringRef("External File", 13)

constexpr

Definition at line 95 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupMetaExternalFile().

◆ MetaRemarkVersionName

constexpr StringRef llvm::remarks::MetaRemarkVersionName = StringRef("Remark version", 14)

constexpr

Definition at line 93 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupMetaRemarkVersion().

◆ MetaStrTabName

constexpr StringRef llvm::remarks::MetaStrTabName = StringRef("String table", 12)

constexpr

Definition at line 94 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupMetaStrTab().

◆ RemarkArgWithDebugLocName

constexpr StringRef llvm::remarks::RemarkArgWithDebugLocName

constexpr

Initial value:

=

StringRef("Argument with debug location", 28)

Definition at line 99 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupRemarkBlockInfo().

◆ RemarkArgWithoutDebugLocName

constexpr StringRef llvm::remarks::RemarkArgWithoutDebugLocName = StringRef("Argument", 8)

constexpr

Definition at line 101 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupRemarkBlockInfo().

◆ RemarkBlockName

constexpr StringRef llvm::remarks::RemarkBlockName = StringRef("Remark", 6)

constexpr

Definition at line 71 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupRemarkBlockInfo().

◆ RemarkDebugLocName

constexpr StringRef llvm::remarks::RemarkDebugLocName = StringRef("Remark debug location", 21)

constexpr

Definition at line 97 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupRemarkBlockInfo().

◆ RemarkHeaderName

constexpr StringRef llvm::remarks::RemarkHeaderName = StringRef("Remark header", 13)

constexpr

Definition at line 96 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupRemarkBlockInfo().

◆ RemarkHotnessName

constexpr StringRef llvm::remarks::RemarkHotnessName = StringRef("Remark hotness", 14)

constexpr

Definition at line 98 of file BitstreamRemarkContainer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializerHelper::setupRemarkBlockInfo().

Classes

Enumerations

Functions

Variables

Enumeration Type Documentation

◆ BitstreamRemarkContainerType

◆ BlockIDs

◆ Format

◆ RecordIDs

◆ SerializerMode

◆ Type

Function Documentation

◆ ContainerMagic()

◆ createBitstreamParserFromMeta()

◆ createRemarkParser() [1/2]

◆ createRemarkParser() [2/2]

◆ createRemarkParserFromMeta()

◆ createRemarkSerializer() [1/2]

◆ createRemarkSerializer() [2/2]

◆ createYAMLParserFromMeta()

◆ getRemarksSectionContents()

◆ Magic()

◆ magicToFormat()

◆ operator!=() [1/3]

◆ operator!=() [2/3]

◆ operator!=() [3/3]

◆ operator<() [1/4]

◆ operator<() [2/4]

◆ operator<() [3/4]

◆ operator<() [4/4]

◆ operator==() [1/3]

◆ operator==() [2/3]

◆ operator==() [3/3]

◆ parseFormat()

◆ parseHotnessThresholdOption()

Variable Documentation

◆ CurrentContainerVersion

◆ CurrentRemarkVersion

◆ MetaBlockName

◆ MetaContainerInfoName

◆ MetaExternalFileName

◆ MetaRemarkVersionName

◆ MetaStrTabName

◆ RemarkArgWithDebugLocName

◆ RemarkArgWithoutDebugLocName

◆ RemarkBlockName

◆ RemarkDebugLocName

◆ RemarkHeaderName

◆ RemarkHotnessName