Struct ArenaHeader 

#[repr(C)]
pub struct ArenaHeader {

    pub magic: u64,
    pub version: u32,
    pub flags: u32,
    pub trace_id: TraceId,
    pub config_offset: ArenaOffset,
    pub config_size: u32,
    pub data_offset: ArenaOffset,
    pub write_pos: ArenaOffset,
    pub capacity: u64,
    pub created_at: u64,
    pub schema_hash: u64,
    pub pipeline_version: u32,
    pub _reserved: [u8; 32],
}

Arena file header.

This is stored at the beginning of every arena file and contains metadata needed to interpret the rest of the file.

Fields

magic: u64

Magic number for file identification.

version: u32

Arena format version.

flags: u32

Flags (reserved for future use).

trace_id: TraceId

Trace ID that owns this arena.

config_offset: ArenaOffset

Offset to the pipeline configuration data.

config_size: u32

Size of the pipeline configuration in bytes.

data_offset: ArenaOffset

Offset to the start of the data region.

write_pos: ArenaOffset

Current write position (end of valid data).

capacity: u64

Total capacity of the arena file.

created_at: u64

Creation timestamp (Unix epoch seconds).

schema_hash: u64

Schema version string hash (for compatibility checking).

pipeline_version: u32

Pipeline version number.

_reserved: [u8; 32]

Reserved for alignment and future use.

Implementations

impl ArenaHeader

pub fn new(trace_id: TraceId, capacity: u64) -> Self

Create a new arena header for the given trace.

pub fn validate(&self) -> Result<(), &'static str>

Validate the header.

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

Read header from a byte slice.

pub fn to_bytes(&self) -> Result<Vec<u8>>

Write header to a byte buffer.

pub fn available_space(&self) -> u64

Get available space for data.

Trait Implementations

impl Clone for ArenaHeader

fn clone(&self) -> ArenaHeader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArenaHeader

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

Formats the value using the given formatter.

impl Copy for ArenaHeader