Serialize the remarks to LLVM bitstream. More...

#include "llvm/Remarks/BitstreamRemarkSerializer.h"

Collaboration diagram for llvm::remarks::BitstreamRemarkSerializerHelper:

[legend]

Public Member Functions
	BitstreamRemarkSerializerHelper (BitstreamRemarkContainerType ContainerType)

	BitstreamRemarkSerializerHelper (const BitstreamRemarkSerializerHelper &)=delete

BitstreamRemarkSerializerHelper &	operator= (const BitstreamRemarkSerializerHelper &)=delete

	BitstreamRemarkSerializerHelper (BitstreamRemarkSerializerHelper &&)=delete

BitstreamRemarkSerializerHelper &	operator= (BitstreamRemarkSerializerHelper &&)=delete

void	setupBlockInfo ()
	Set up the necessary block info entries according to the container type. More...

void	setupMetaBlockInfo ()
	Set up the block info for the metadata block. More...

void	setupMetaRemarkVersion ()
	The remark version in the metadata block. More...

void	emitMetaRemarkVersion (uint64_t RemarkVersion)

void	setupMetaStrTab ()
	The strtab in the metadata block. More...

void	emitMetaStrTab (const StringTable &StrTab)

void	setupMetaExternalFile ()
	The external file in the metadata block. More...

void	emitMetaExternalFile (StringRef Filename)

void	setupRemarkBlockInfo ()
	The block info for the remarks block. More...

void	emitMetaBlock (uint64_t ContainerVersion, Optional< uint64_t > RemarkVersion, Optional< const StringTable * > StrTab=None, Optional< StringRef > Filename=None)
	Emit the metadata for the remarks. More...

void	emitRemarkBlock (const Remark &Remark, StringTable &StrTab)
	Emit a remark block. The string table is required. More...

void	flushToStream (raw_ostream &OS)
	Finalize the writing to `OS`. More...

StringRef	getBuffer ()
	Finalize the writing to a buffer. More...

Public Attributes
SmallVector< char, 1024 >	Encoded
	Buffer used for encoding the bitstream before writing it to the final stream. More...

SmallVector< uint64_t, 64 >	R
	Buffer used to construct records and pass to the bitstream writer. More...

BitstreamWriter	Bitstream
	The Bitstream writer. More...

BitstreamRemarkContainerType	ContainerType
	The type of the container we are serializing. More...

uint64_t	RecordMetaContainerInfoAbbrevID = 0
	Abbrev IDs initialized in the block info block. More...

uint64_t	RecordMetaRemarkVersionAbbrevID = 0

uint64_t	RecordMetaStrTabAbbrevID = 0

uint64_t	RecordMetaExternalFileAbbrevID = 0

uint64_t	RecordRemarkHeaderAbbrevID = 0

uint64_t	RecordRemarkDebugLocAbbrevID = 0

uint64_t	RecordRemarkHotnessAbbrevID = 0

uint64_t	RecordRemarkArgWithDebugLocAbbrevID = 0

uint64_t	RecordRemarkArgWithoutDebugLocAbbrevID = 0

Detailed Description

Serialize the remarks to LLVM bitstream.

This class provides ways to emit remarks in the LLVM bitstream format and its associated metadata.

The separate model: Separate meta: | Container info | String table | External file

Separate remarks: | Container info | Remark version | Remark0 | Remark1 | Remark2 | ...
The standalone model: | Container info | String table | Remark version | Remark0 | Remark1 | Remark2 | ...

Definition at line 50 of file BitstreamRemarkSerializer.h.

Constructor & Destructor Documentation

◆ BitstreamRemarkSerializerHelper() [1/3]

BitstreamRemarkSerializerHelper::BitstreamRemarkSerializerHelper ( BitstreamRemarkContainerType ContainerType )

Definition at line 20 of file BitstreamRemarkSerializer.cpp.

References llvm::remarks::Bitstream.

◆ BitstreamRemarkSerializerHelper() [2/3]

llvm::remarks::BitstreamRemarkSerializerHelper::BitstreamRemarkSerializerHelper ( const BitstreamRemarkSerializerHelper & )

delete

◆ BitstreamRemarkSerializerHelper() [3/3]

llvm::remarks::BitstreamRemarkSerializerHelper::BitstreamRemarkSerializerHelper ( BitstreamRemarkSerializerHelper && )

delete

Member Function Documentation

◆ emitMetaBlock()

void BitstreamRemarkSerializerHelper::emitMetaBlock	(	uint64_t	ContainerVersion,
		Optional< uint64_t >	RemarkVersion,
		Optional< const StringTable * >	StrTab = `None`,
		Optional< StringRef >	Filename = `None`
	)

Emit the metadata for the remarks.

Definition at line 233 of file BitstreamRemarkSerializer.cpp.

References assert(), Bitstream, llvm::SmallVectorImpl< T >::clear(), ContainerType, emitMetaExternalFile(), emitMetaRemarkVersion(), emitMetaStrTab(), llvm::BitstreamWriter::EmitRecordWithAbbrev(), llvm::BitstreamWriter::EnterSubblock(), llvm::BitstreamWriter::ExitBlock(), llvm::remarks::META_BLOCK_ID, llvm::None, R, llvm::remarks::RECORD_META_CONTAINER_INFO, RecordMetaContainerInfoAbbrevID, llvm::remarks::SeparateRemarksFile, llvm::remarks::SeparateRemarksMeta, and llvm::remarks::Standalone.

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

◆ emitMetaExternalFile()

void BitstreamRemarkSerializerHelper::emitMetaExternalFile ( StringRef Filename )

Definition at line 117 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::SmallVectorImpl< T >::clear(), llvm::BitstreamWriter::EmitRecordWithBlob(), R, llvm::remarks::RECORD_META_EXTERNAL_FILE, and RecordMetaExternalFileAbbrevID.

Referenced by emitMetaBlock().

◆ emitMetaRemarkVersion()

void BitstreamRemarkSerializerHelper::emitMetaRemarkVersion ( uint64_t RemarkVersion )

Definition at line 74 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::SmallVectorImpl< T >::clear(), llvm::BitstreamWriter::EmitRecordWithAbbrev(), R, llvm::remarks::RECORD_META_REMARK_VERSION, and RecordMetaRemarkVersionAbbrevID.

Referenced by emitMetaBlock().

◆ emitMetaStrTab()

void BitstreamRemarkSerializerHelper::emitMetaStrTab ( const StringTable & StrTab )

Definition at line 93 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::SmallVectorImpl< T >::clear(), llvm::BitstreamWriter::EmitRecordWithBlob(), R, llvm::remarks::RECORD_META_STRTAB, RecordMetaStrTabAbbrevID, llvm::remarks::StringTable::serialize(), and llvm::raw_string_ostream::str().

Referenced by emitMetaBlock().

◆ emitRemarkBlock()

void BitstreamRemarkSerializerHelper::emitRemarkBlock	(	const Remark &	Remark,
		StringTable &	StrTab
	)

Emit a remark block. The string table is required.

Definition at line 268 of file BitstreamRemarkSerializer.cpp.

References llvm::remarks::StringTable::add(), Arg, llvm::remarks::Remark::Args, Bitstream, llvm::SmallVectorImpl< T >::clear(), llvm::BitstreamWriter::EmitRecordWithAbbrev(), llvm::BitstreamWriter::EnterSubblock(), llvm::BitstreamWriter::ExitBlock(), llvm::remarks::Remark::FunctionName, llvm::remarks::Remark::Hotness, llvm::remarks::Remark::Loc, llvm::None, llvm::remarks::Remark::PassName, R, llvm::remarks::RECORD_REMARK_ARG_WITH_DEBUGLOC, llvm::remarks::RECORD_REMARK_ARG_WITHOUT_DEBUGLOC, llvm::remarks::RECORD_REMARK_DEBUG_LOC, llvm::remarks::RECORD_REMARK_HEADER, llvm::remarks::RECORD_REMARK_HOTNESS, RecordRemarkArgWithDebugLocAbbrevID, RecordRemarkArgWithoutDebugLocAbbrevID, RecordRemarkDebugLocAbbrevID, RecordRemarkHeaderAbbrevID, RecordRemarkHotnessAbbrevID, llvm::remarks::REMARK_BLOCK_ID, llvm::remarks::Remark::RemarkName, and llvm::remarks::Remark::RemarkType.

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

◆ flushToStream()

void BitstreamRemarkSerializerHelper::flushToStream ( raw_ostream & OS )

Finalize the writing to OS.

Definition at line 318 of file BitstreamRemarkSerializer.cpp.

References llvm::SmallVectorImpl< T >::clear(), Encoded, and llvm::raw_ostream::write().

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

◆ getBuffer()

StringRef BitstreamRemarkSerializerHelper::getBuffer ( )

Finalize the writing to a buffer.

The contents of the buffer remain valid for the lifetime of the object. Any call to any other function in this class will invalidate the buffer.

Definition at line 323 of file BitstreamRemarkSerializer.cpp.

References Encoded.

◆ operator=() [1/2]

BitstreamRemarkSerializerHelper& llvm::remarks::BitstreamRemarkSerializerHelper::operator= ( BitstreamRemarkSerializerHelper && )

delete

◆ operator=() [2/2]

BitstreamRemarkSerializerHelper& llvm::remarks::BitstreamRemarkSerializerHelper::operator= ( const BitstreamRemarkSerializerHelper & )

delete

◆ setupBlockInfo()

void BitstreamRemarkSerializerHelper::setupBlockInfo ( )

Set up the necessary block info entries according to the container type.

Definition at line 196 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::remarks::ContainerMagic(), ContainerType, llvm::BitstreamWriter::Emit(), llvm::BitstreamWriter::EnterBlockInfoBlock(), llvm::BitstreamWriter::ExitBlock(), llvm::remarks::SeparateRemarksFile, llvm::remarks::SeparateRemarksMeta, setupMetaBlockInfo(), setupMetaExternalFile(), setupMetaRemarkVersion(), setupMetaStrTab(), setupRemarkBlockInfo(), and llvm::remarks::Standalone.

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

◆ setupMetaBlockInfo()

void BitstreamRemarkSerializerHelper::setupMetaBlockInfo ( )

Set up the block info for the metadata block.

Definition at line 47 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::BitstreamWriter::EmitBlockInfoAbbrev(), llvm::BitCodeAbbrevOp::Fixed, initBlock(), llvm::remarks::META_BLOCK_ID, llvm::remarks::MetaBlockName, llvm::remarks::MetaContainerInfoName, R, llvm::remarks::RECORD_META_CONTAINER_INFO, RecordMetaContainerInfoAbbrevID, and setRecordName().

Referenced by setupBlockInfo().

◆ setupMetaExternalFile()

void BitstreamRemarkSerializerHelper::setupMetaExternalFile ( )

The external file in the metadata block.

Definition at line 107 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::BitCodeAbbrevOp::Blob, llvm::BitstreamWriter::EmitBlockInfoAbbrev(), llvm::remarks::META_BLOCK_ID, llvm::remarks::MetaExternalFileName, R, llvm::remarks::RECORD_META_EXTERNAL_FILE, RecordMetaExternalFileAbbrevID, and setRecordName().

Referenced by setupBlockInfo().

◆ setupMetaRemarkVersion()

void BitstreamRemarkSerializerHelper::setupMetaRemarkVersion ( )

The remark version in the metadata block.

Definition at line 63 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::BitstreamWriter::EmitBlockInfoAbbrev(), llvm::BitCodeAbbrevOp::Fixed, llvm::remarks::META_BLOCK_ID, llvm::remarks::MetaRemarkVersionName, R, llvm::remarks::RECORD_META_REMARK_VERSION, RecordMetaRemarkVersionAbbrevID, and setRecordName().

Referenced by setupBlockInfo().

◆ setupMetaStrTab()

void BitstreamRemarkSerializerHelper::setupMetaStrTab ( )

The strtab in the metadata block.

Definition at line 83 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::BitCodeAbbrevOp::Blob, llvm::BitstreamWriter::EmitBlockInfoAbbrev(), llvm::remarks::META_BLOCK_ID, llvm::remarks::MetaStrTabName, R, llvm::remarks::RECORD_META_STRTAB, RecordMetaStrTabAbbrevID, and setRecordName().

Referenced by setupBlockInfo().

◆ setupRemarkBlockInfo()

void BitstreamRemarkSerializerHelper::setupRemarkBlockInfo ( )

The block info for the remarks block.

Definition at line 124 of file BitstreamRemarkSerializer.cpp.

References Bitstream, llvm::BitstreamWriter::EmitBlockInfoAbbrev(), llvm::BitCodeAbbrevOp::Fixed, initBlock(), R, llvm::remarks::RECORD_REMARK_ARG_WITH_DEBUGLOC, llvm::remarks::RECORD_REMARK_ARG_WITHOUT_DEBUGLOC, llvm::remarks::RECORD_REMARK_DEBUG_LOC, llvm::remarks::RECORD_REMARK_HEADER, llvm::remarks::RECORD_REMARK_HOTNESS, RecordRemarkArgWithDebugLocAbbrevID, RecordRemarkArgWithoutDebugLocAbbrevID, RecordRemarkDebugLocAbbrevID, RecordRemarkHeaderAbbrevID, RecordRemarkHotnessAbbrevID, llvm::remarks::REMARK_BLOCK_ID, llvm::remarks::RemarkArgWithDebugLocName, llvm::remarks::RemarkArgWithoutDebugLocName, llvm::remarks::RemarkBlockName, llvm::remarks::RemarkDebugLocName, llvm::remarks::RemarkHeaderName, llvm::remarks::RemarkHotnessName, setRecordName(), and llvm::BitCodeAbbrevOp::VBR.

Referenced by setupBlockInfo().

Member Data Documentation

◆ Bitstream

BitstreamWriter llvm::remarks::BitstreamRemarkSerializerHelper::Bitstream

The Bitstream writer.

Definition at line 57 of file BitstreamRemarkSerializer.h.

Referenced by emitMetaBlock(), emitMetaExternalFile(), emitMetaRemarkVersion(), emitMetaStrTab(), emitRemarkBlock(), setupBlockInfo(), setupMetaBlockInfo(), setupMetaExternalFile(), setupMetaRemarkVersion(), setupMetaStrTab(), and setupRemarkBlockInfo().

◆ ContainerType

BitstreamRemarkContainerType llvm::remarks::BitstreamRemarkSerializerHelper::ContainerType

The type of the container we are serializing.

Definition at line 59 of file BitstreamRemarkSerializer.h.

Referenced by llvm::remarks::BitstreamRemarkSerializer::emit(), emitMetaBlock(), llvm::remarks::BitstreamRemarkSerializer::metaSerializer(), and setupBlockInfo().

◆ Encoded

SmallVector<char, 1024> llvm::remarks::BitstreamRemarkSerializerHelper::Encoded

Buffer used for encoding the bitstream before writing it to the final stream.

Definition at line 53 of file BitstreamRemarkSerializer.h.

Referenced by flushToStream(), and getBuffer().

◆ R

SmallVector<uint64_t, 64> llvm::remarks::BitstreamRemarkSerializerHelper::R

Buffer used to construct records and pass to the bitstream writer.

Definition at line 55 of file BitstreamRemarkSerializer.h.

Referenced by emitMetaBlock(), emitMetaExternalFile(), emitMetaRemarkVersion(), emitMetaStrTab(), emitRemarkBlock(), setupMetaBlockInfo(), setupMetaExternalFile(), setupMetaRemarkVersion(), setupMetaStrTab(), and setupRemarkBlockInfo().

◆ RecordMetaContainerInfoAbbrevID

uint64_t llvm::remarks::BitstreamRemarkSerializerHelper::RecordMetaContainerInfoAbbrevID = 0

Abbrev IDs initialized in the block info block.

Note: depending on the container type, some IDs might be uninitialized. Warning: When adding more abbrev IDs, make sure to update the BlockCodeSize (in the call to EnterSubblock).

Definition at line 65 of file BitstreamRemarkSerializer.h.

Referenced by emitMetaBlock(), and setupMetaBlockInfo().