LLVM 20.0.0git
Public Member Functions | Static Public Member Functions | List of all members
llvm::msf::MSFBuilder Class Reference

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

Public Member Functions

Error setBlockMapAddr (uint32_t Addr)
 Request the block map to be at a specific block address.
 
Error setDirectoryBlocksHint (ArrayRef< uint32_t > DirBlocks)
 
void setFreePageMap (uint32_t Fpm)
 
void setUnknown1 (uint32_t Unk1)
 
Expected< uint32_taddStream (uint32_t Size, ArrayRef< uint32_t > Blocks)
 Add a stream to the MSF file with the given size, occupying the given list of blocks.
 
Expected< uint32_taddStream (uint32_t Size)
 Add a stream to the MSF file with the given size, occupying any available blocks that the builder decides to use.
 
Error setStreamSize (uint32_t Idx, uint32_t Size)
 Update the size of an existing stream.
 
uint32_t getNumStreams () const
 Get the total number of streams in the MSF layout.
 
uint32_t getStreamSize (uint32_t StreamIdx) const
 Get the size of a stream by index.
 
ArrayRef< uint32_tgetStreamBlocks (uint32_t StreamIdx) const
 Get the list of blocks allocated to a particular stream.
 
uint32_t getNumUsedBlocks () const
 Get the total number of blocks that will be allocated to actual data in this MSF file.
 
uint32_t getNumFreeBlocks () const
 Get the total number of blocks that exist in the MSF file but are not allocated to any valid data.
 
uint32_t getTotalBlockCount () const
 Get the total number of blocks in the MSF file.
 
bool isBlockFree (uint32_t Idx) const
 Check whether a particular block is allocated or free.
 
Expected< MSFLayoutgenerateLayout ()
 Finalize the layout and build the headers and structures that describe the MSF layout and can be written directly to the MSF file.
 
Expected< FileBufferByteStreamcommit (StringRef Path, MSFLayout &Layout)
 Write the MSF layout to the underlying file.
 
BumpPtrAllocatorgetAllocator ()
 

Static Public Member Functions

static Expected< MSFBuildercreate (BumpPtrAllocator &Allocator, uint32_t BlockSize, uint32_t MinBlockCount=0, bool CanGrow=true)
 Create a new MSFBuilder.
 

Detailed Description

Definition at line 27 of file MSFBuilder.h.

Member Function Documentation

◆ addStream() [1/2]

Expected< uint32_t > MSFBuilder::addStream ( uint32_t  Size)

Add a stream to the MSF file with the given size, occupying any available blocks that the builder decides to use.

This is useful when building a new PDB file from scratch and you don't care what blocks a stream occupies but you just want it to work.

Definition at line 183 of file MSFBuilder.cpp.

References llvm::msf::bytesToBlocks(), and Size.

◆ addStream() [2/2]

Expected< uint32_t > MSFBuilder::addStream ( uint32_t  Size,
ArrayRef< uint32_t Blocks 
)

Add a stream to the MSF file with the given size, occupying the given list of blocks.

This is useful when reading a MSF file and you want a particular stream to occupy the original set of blocks. If the given blocks are already allocated, or if the number of blocks specified is incorrect for the given stream size, this function will return an Error.

Definition at line 156 of file MSFBuilder.cpp.

References llvm::Block, Blocks, llvm::msf::bytesToBlocks(), llvm::msf::invalid_format, llvm::BitVector::reset(), llvm::BitVector::resize(), llvm::BitVector::size(), Size, llvm::BitVector::test(), and llvm::msf::unspecified.

Referenced by llvm::pdb::DbiModuleDescriptorBuilder::finalizeMsfLayout(), llvm::pdb::DbiStreamBuilder::finalizeMsfLayout(), llvm::pdb::GSIStreamBuilder::finalizeMsfLayout(), and llvm::pdb::TpiStreamBuilder::finalizeMsfLayout().

◆ commit()

Expected< FileBufferByteStream > MSFBuilder::commit ( StringRef  Path,
MSFLayout Layout 
)

◆ create()

Expected< MSFBuilder > MSFBuilder::create ( BumpPtrAllocator Allocator,
uint32_t  BlockSize,
uint32_t  MinBlockCount = 0,
bool  CanGrow = true 
)
static

Create a new MSFBuilder.

Parameters
BlockSizeThe internal block size used by the PDB file. See isValidBlockSize() for a list of valid block sizes.
MinBlockCountCauses the builder to reserve up front space for at least MinBlockCount blocks. This is useful when using MSFBuilder to read an existing MSF that you want to write back out later. The original MSF file's SuperBlock contains the exact number of blocks used by the file, so is a good hint as to how many blocks the new MSF file will contain. Furthermore, it is actually necessary in this case. To preserve stability of the file's layout, it is helpful to try to keep all streams mapped to their original block numbers. To ensure that this is possible, space for all blocks must be allocated beforehand so that streams can be assigned to them.
CanGrowIf true, any operation which results in an attempt to locate a free block when all available blocks have been exhausted will allocate a new block, thereby growing the size of the final MSF file. When false, any such attempt will result in an error. This is especially useful in testing scenarios when you know your test isn't going to do anything to increase the size of the file, so having an Error returned if it were to happen would catch a programming error
Returns
an llvm::Error representing whether the operation succeeded or failed. Currently the only way this can fail is if an invalid block size is specified, or MinBlockCount does not leave enough room for the mandatory reserved blocks required by an MSF file.

Definition at line 51 of file MSFBuilder.cpp.

References Allocator, llvm::msf::getMinimumBlockCount(), llvm::msf::invalid_format, and llvm::msf::isValidBlockSize().

Referenced by llvm::pdb::PDBFileBuilder::initialize().

◆ generateLayout()

Expected< MSFLayout > MSFBuilder::generateLayout ( )

◆ getAllocator()

BumpPtrAllocator & llvm::msf::MSFBuilder::getAllocator ( )
inline

◆ getNumFreeBlocks()

uint32_t MSFBuilder::getNumFreeBlocks ( ) const

Get the total number of blocks that exist in the MSF file but are not allocated to any valid data.

Definition at line 150 of file MSFBuilder.cpp.

References llvm::BitVector::count().

Referenced by getNumUsedBlocks().

◆ getNumStreams()

uint32_t MSFBuilder::getNumStreams ( ) const

Get the total number of streams in the MSF layout.

This should return 1 for every call to addStream.

Definition at line 225 of file MSFBuilder.cpp.

◆ getNumUsedBlocks()

uint32_t MSFBuilder::getNumUsedBlocks ( ) const

Get the total number of blocks that will be allocated to actual data in this MSF file.

Definition at line 146 of file MSFBuilder.cpp.

References getNumFreeBlocks(), and getTotalBlockCount().

◆ getStreamBlocks()

ArrayRef< uint32_t > MSFBuilder::getStreamBlocks ( uint32_t  StreamIdx) const

Get the list of blocks allocated to a particular stream.

Definition at line 231 of file MSFBuilder.cpp.

◆ getStreamSize()

uint32_t MSFBuilder::getStreamSize ( uint32_t  StreamIdx) const

Get the size of a stream by index.

Definition at line 227 of file MSFBuilder.cpp.

Referenced by setStreamSize().

◆ getTotalBlockCount()

uint32_t MSFBuilder::getTotalBlockCount ( ) const

Get the total number of blocks in the MSF file.

In practice this is equal to getNumUsedBlocks() + getNumFreeBlocks().

Definition at line 152 of file MSFBuilder.cpp.

References llvm::BitVector::size().

Referenced by getNumUsedBlocks().

◆ isBlockFree()

bool MSFBuilder::isBlockFree ( uint32_t  Idx) const

Check whether a particular block is allocated or free.

Definition at line 154 of file MSFBuilder.cpp.

References Idx.

Referenced by setBlockMapAddr(), and setDirectoryBlocksHint().

◆ setBlockMapAddr()

Error MSFBuilder::setBlockMapAddr ( uint32_t  Addr)

Request the block map to be at a specific block address.

This is useful when editing a MSF and you want the layout to be as stable as possible.

Definition at line 63 of file MSFBuilder.cpp.

References Addr, llvm::msf::block_in_use, llvm::msf::insufficient_buffer, isBlockFree(), llvm::BitVector::resize(), llvm::BitVector::size(), and llvm::Error::success().

◆ setDirectoryBlocksHint()

Error MSFBuilder::setDirectoryBlocksHint ( ArrayRef< uint32_t DirBlocks)

Definition at line 88 of file MSFBuilder.cpp.

References B, isBlockFree(), llvm::Error::success(), and llvm::msf::unspecified.

◆ setFreePageMap()

void MSFBuilder::setFreePageMap ( uint32_t  Fpm)

Definition at line 84 of file MSFBuilder.cpp.

◆ setStreamSize()

Error MSFBuilder::setStreamSize ( uint32_t  Idx,
uint32_t  Size 
)

Update the size of an existing stream.

This will allocate or deallocate blocks as needed to match the requested size. This can fail if CanGrow was set to false when initializing the MSFBuilder.

Definition at line 193 of file MSFBuilder.cpp.

References llvm::append_range(), llvm::msf::bytesToBlocks(), getStreamSize(), Idx, P, Size, and llvm::Error::success().

Referenced by llvm::pdb::DbiStreamBuilder::finalizeMsfLayout(), llvm::pdb::InfoStreamBuilder::finalizeMsfLayout(), and llvm::pdb::TpiStreamBuilder::finalizeMsfLayout().

◆ setUnknown1()

void MSFBuilder::setUnknown1 ( uint32_t  Unk1)

Definition at line 86 of file MSFBuilder.cpp.


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