Struct WalSegment 

pub struct WalSegment { /* private fields */ }

Fixed-size memory-mapped WAL segment

WalSegment provides atomic write operations with thread-safe write pointer management and integrity validation through checksums.

Implementations

impl WalSegment

pub fn create( segment_id: u64, file_path: PathBuf, capacity: usize, ) -> Result<Self, ShardexError>

Create a new WAL segment with the specified ID and capacity

pub fn open(file_path: PathBuf) -> Result<Self, ShardexError>

Open an existing WAL segment

pub fn id(&self) -> u64

Get the segment ID

pub fn write_pointer(&self) -> usize

Get current write pointer position

pub fn capacity(&self) -> usize

Get total segment capacity

pub fn remaining_space(&self) -> usize

Get remaining space in bytes

pub fn is_full(&self) -> bool

Check if segment is full

pub fn append(&self, data: &[u8]) -> Result<usize, ShardexError>

Append data to the segment atomically with record header

pub fn append_transaction( &self, transaction: &WalTransaction, ) -> Result<usize, ShardexError>

Append a WAL transaction to the segment

pub fn sync(&self) -> Result<(), ShardexError>

Sync segment to disk

pub fn read_segment_data(&self) -> Result<Vec<u8>, ShardexError>

Get a copy of the segment data for reading (used during replay)

pub fn read_range( &self, start: usize, length: usize, ) -> Result<Vec<u8>, ShardexError>

Read a specific range of data from the segment

pub fn validate_integrity(&self) -> Result<(), ShardexError>

Validate segment integrity