Struct SectorContentsMap 

pub struct SectorContentsMap { /* private fields */ }

Map of sector contents.

Abstraction on top of bitfields that allow making sense of sector contents that contain encoded (meaning erasure coded and encoded with existing PoSpace proof) chunks used at the same time both in records (before writing to plot) and s-buckets (written into the plot) format

Implementations

impl SectorContentsMap

pub fn new(pieces_in_sector: u16) -> Self

Create new sector contents map initialized with zeroes to store data for pieces_in_sector records

pub fn from_bytes( bytes: &[u8], pieces_in_sector: u16, ) -> Result<Self, SectorContentsMapFromBytesError>

Reconstruct sector contents map from bytes.

Returns error if length of the vector doesn’t match Self::encoded_size() for pieces_in_sector.

pub const fn encoded_size(pieces_in_sector: u16) -> usize

Size of sector contents map when encoded and stored in the plot for specified number of pieces in sector

pub fn encode_into( &self, output: &mut [u8], ) -> Result<(), SectorContentsMapEncodeIntoError>

Encode internal contents into output

pub fn iter_record_chunks_used(&self) -> &[SingleRecordBitArray]

Iterate over individual record chunks (s-buckets) that were used

pub fn iter_record_chunks_used_mut(&mut self) -> &mut [SingleRecordBitArray]

Iterate mutably over individual record chunks (s-buckets) that were used

pub fn s_bucket_sizes(&self) -> Box<[u16; 65536]>

Returns sizes of each s-bucket

pub fn iter_record_chunk_to_plot( &self, piece_offset: PieceOffset, ) -> impl Iterator<Item = (SBucket, usize)> + '_

Creates an iterator of (s_bucket, chunk_location), where s_bucket is the position of the chunk in the erasure coded record and chunk_location is the offset of the chunk in the plot (across all s-buckets).

pub fn par_iter_record_chunk_to_plot( &self, piece_offset: PieceOffset, ) -> impl IndexedParallelIterator<Item = Option<usize>> + '_

Creates an iterator of Option<chunk_offset>, where each entry corresponds s-bucket/position of the chunk in the erasure coded record, chunk_offset is the offset of the chunk in the corresponding s-bucket.

Similar to Self::iter_record_chunk_to_plot(), but runs in parallel, returns entries for all s-buckets and offsets are within corresponding s-buckets rather than the whole plot.

pub fn iter_s_bucket_piece_offsets( &self, s_bucket: SBucket, ) -> Result<impl Iterator<Item = PieceOffset> + '_, SectorContentsMapIterationError>

Creates an iterator of piece offsets to which corresponding chunks belong.

Returns error if s_bucket is outside of [Record::NUM_S_BUCKETS] range.

pub fn iter_s_bucket_used_record_chunks_used( &self, s_bucket: SBucket, ) -> Result<impl Iterator<Item = bool> + '_, SectorContentsMapIterationError>

Iterate over chunks of s-bucket indicating if record chunk is used at corresponding position.

Panics

Panics if s_bucket is outside of [Record::NUM_S_BUCKETS] range.

Trait Implementations

impl Clone for SectorContentsMap

fn clone(&self) -> SectorContentsMap

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SectorContentsMap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for SectorContentsMap

fn eq(&self, other: &SectorContentsMap) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SectorContentsMap

impl StructuralPartialEq for SectorContentsMap