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]

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

Error	readBytes (uint64_t Offset, uint64_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.

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

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

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 llvm::endianness	getEndian () const =0

virtual Error	readBytes (uint64_t Offset, uint64_t Size, ArrayRef< uint8_t > &Buffer)=0
	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.

virtual Error	readLongestContiguousChunk (uint64_t Offset, ArrayRef< uint8_t > &Buffer)=0
	Given an offset into the stream, read as much as possible without copying any data.

virtual uint64_t	getLength ()=0
	Return the number of bytes of data in this stream.

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

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 (uint64_t Offset, uint64_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 37 of file MappedBlockStream.h.

Constructor & Destructor Documentation

◆ MappedBlockStream()

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

protected

Definition at line 43 of file MappedBlockStream.cpp.

References Allocator.

Member Function Documentation

◆ createDirectoryStream()

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

static

Definition at line 69 of file MappedBlockStream.cpp.

References Allocator, 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.

Referenced by llvm::pdb::PDBFile::parseStreamData().

◆ createFpmStream()

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

static

Definition at line 79 of file MappedBlockStream.cpp.

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

Referenced by llvm::pdb::PDBFile::parseFileHeaders().

◆ createIndexedStream()

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

static

Definition at line 57 of file MappedBlockStream.cpp.

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

Referenced by llvm::pdb::PDBFile::createIndexedStream().

◆ createStream()

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