MappedBlockStream represents data stored in an MSF file into chunks of a particular size (called the Block Size), and whose chunks may not be necessarily contiguous. More...

#include "llvm/DebugInfo/MSF/MappedBlockStream.h"

Inheritance diagram for llvm::msf::MappedBlockStream:

[legend]

Collaboration diagram for llvm::msf::MappedBlockStream:

[legend]

Public Member Functions
support::endianness	getEndian () const override

Error	readBytes (uint32_t Offset, uint32_t Size, ArrayRef< uint8_t > &Buffer) override
	Given an offset into the stream and a number of bytes, attempt to read the bytes and set the output ArrayRef to point to data owned by the stream. More...

Error	readLongestContiguousChunk (uint32_t Offset, ArrayRef< uint8_t > &Buffer) override
	Given an offset into the stream, read as much as possible without copying any data. More...

uint32_t	getLength () override
	Return the number of bytes of data in this stream. More...

BumpPtrAllocator &	getAllocator ()

void	invalidateCache ()

uint32_t	getBlockSize () const

uint32_t	getNumBlocks () const

uint32_t	getStreamLength () const

Public Member Functions inherited from llvm::BinaryStream
virtual	~BinaryStream ()=default

virtual BinaryStreamFlags	getFlags () const
	Return the properties of this stream. More...

Static Public Member Functions
static std::unique_ptr< MappedBlockStream >	createStream (uint32_t BlockSize, const MSFStreamLayout &Layout, BinaryStreamRef MsfData, BumpPtrAllocator &Allocator)

static std::unique_ptr< MappedBlockStream >	createIndexedStream (const MSFLayout &Layout, BinaryStreamRef MsfData, uint32_t StreamIndex, BumpPtrAllocator &Allocator)

static std::unique_ptr< MappedBlockStream >	createFpmStream (const MSFLayout &Layout, BinaryStreamRef MsfData, BumpPtrAllocator &Allocator)

static std::unique_ptr< MappedBlockStream >	createDirectoryStream (const MSFLayout &Layout, BinaryStreamRef MsfData, BumpPtrAllocator &Allocator)

Protected Member Functions
	MappedBlockStream (uint32_t BlockSize, const MSFStreamLayout &StreamLayout, BinaryStreamRef MsfData, BumpPtrAllocator &Allocator)

Protected Member Functions inherited from llvm::BinaryStream
Error	checkOffsetForRead (uint32_t Offset, uint32_t DataSize)

Friends
class	WritableMappedBlockStream

Detailed Description

MappedBlockStream represents data stored in an MSF file into chunks of a particular size (called the Block Size), and whose chunks may not be necessarily contiguous.

The arrangement of these chunks MSF the file is described by some other metadata contained within the MSF file. In the case of a standard MSF Stream, the layout of the stream's blocks is described by the MSF "directory", but in the case of the directory itself, the layout is described by an array at a fixed location within the MSF. MappedBlockStream provides methods for reading from and writing to one of these streams transparently, as if it were a contiguous sequence of bytes.

Definition at line 39 of file MappedBlockStream.h.

Constructor & Destructor Documentation

◆ MappedBlockStream()

MappedBlockStream::MappedBlockStream	(	uint32_t	BlockSize,
		const MSFStreamLayout &	StreamLayout,
		BinaryStreamRef	MsfData,
		BumpPtrAllocator &	Allocator
	)

protected

Definition at line 45 of file MappedBlockStream.cpp.

Referenced by getStreamLength().

Member Function Documentation

◆ createDirectoryStream()

std::unique_ptr< MappedBlockStream > MappedBlockStream::createDirectoryStream	(	const MSFLayout &	Layout,
		BinaryStreamRef	MsfData,
		BumpPtrAllocator &	Allocator
	)

static

Definition at line 71 of file MappedBlockStream.cpp.

References llvm::msf::MSFStreamLayout::Blocks, llvm::msf::SuperBlock::BlockSize, createStream(), llvm::msf::MSFLayout::DirectoryBlocks, llvm::msf::MSFStreamLayout::Length, llvm::msf::SuperBlock::NumDirectoryBytes, and llvm::msf::MSFLayout::SB.

◆ createFpmStream()

std::unique_ptr< MappedBlockStream > MappedBlockStream::createFpmStream	(	const MSFLayout &	Layout,
		BinaryStreamRef	MsfData,
		BumpPtrAllocator &	Allocator
	)

static

Definition at line 81 of file MappedBlockStream.cpp.

References llvm::msf::SuperBlock::BlockSize, createStream(), llvm::msf::getFpmStreamLayout(), and llvm::msf::MSFLayout::SB.

◆ createIndexedStream()

std::unique_ptr< MappedBlockStream > MappedBlockStream::createIndexedStream	(	const MSFLayout &	Layout,
		BinaryStreamRef	MsfData,
		uint32_t	StreamIndex,
		BumpPtrAllocator &	Allocator
	)

static

Definition at line 59 of file MappedBlockStream.cpp.

References assert(), llvm::msf::MSFStreamLayout::Blocks, llvm::msf::SuperBlock::BlockSize, llvm::msf::MSFLayout::SB, llvm::msf::MSFLayout::StreamMap, and llvm::msf::MSFLayout::StreamSizes.

◆ createStream()

std::unique_ptr< MappedBlockStream > MappedBlockStream::createStream	(	uint32_t	BlockSize,
		const MSFStreamLayout &	Layout,
		BinaryStreamRef	MsfData,
		BumpPtrAllocator &	Allocator
	)