Struct PersistentHeaderV3 

pub struct PersistentHeaderV3 {

    pub magic: [u8; 8],
    pub version: u32,
    pub flags: u32,
    pub node_count: u64,
    pub edge_count: u64,
    pub schema_version: u32,
    pub reserved: u32,
    pub node_data_offset: u64,
    pub edge_data_offset: u64,
    pub outgoing_cluster_offset: u64,
    pub incoming_cluster_offset: u64,
    pub free_space_offset: u64,
    pub root_index_page: u64,
    pub free_page_list_head: u64,
    pub total_pages: u64,
    pub page_size: u32,
    pub btree_height: u32,
}

V3 Persistent header that is written to disk

This header contains ONLY the fields that must be persisted across file closes. Transaction state and rollback metadata are handled separately in runtime.

Fields

magic: [u8; 8]

Magic number (should be V3_MAGIC)

version: u32

File format version (should be V3_FORMAT_VERSION)

flags: u32

Feature flags bitfield

node_count: u64

Total number of nodes in the file

edge_count: u64

Total number of edges in the file

schema_version: u32

Schema version

reserved: u32

Reserved field (for future use)

node_data_offset: u64

V3: NodeStore’s B+Tree root page ID (value 0 = uninitialized, >= 1 = valid page ID) Note: Field name “node_data_offset” is kept for V2 compatibility, but stores a page ID in V3

edge_data_offset: u64

V3: EdgeStore’s B+Tree root page ID (value 0 = uninitialized, >= 1 = valid page ID) Note: Field name “edge_data_offset” is kept for V2 compatibility, but stores a page ID in V3

outgoing_cluster_offset: u64

Offset where outgoing edge clusters begin (V2 compat, still byte offset)

incoming_cluster_offset: u64

Offset where incoming edge clusters begin (V2 compat, still byte offset)

free_space_offset: u64

Offset where free space management begins (V2 compat, still byte offset)

root_index_page: u64

Root B+Tree index page ID (0 if tree is empty)

free_page_list_head: u64

Head of free page list for page reuse (0 if none)

total_pages: u64

Total number of pages allocated in the file

page_size: u32

Page size in bytes (typically 4096)

btree_height: u32

Current B+Tree height (0 if empty)

Implementations

impl PersistentHeaderV3

pub fn new_v3() -> Self

Create a new persistent header with default V3 values

pub fn to_bytes(&self) -> [u8; 112]

Serialize the header to a byte array

pub fn validate(&self) -> NativeResult<()>

Validate persistent header for consistency

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

Parse a header from a byte slice

pub fn detect_version(bytes: &[u8]) -> NativeResult<u32>

Detect the version of a header from raw bytes

Trait Implementations

impl Clone for PersistentHeaderV3

fn clone(&self) -> PersistentHeaderV3

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PersistentHeaderV3

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

Formats the value using the given formatter.

impl Eq for PersistentHeaderV3

impl PartialEq for PersistentHeaderV3

fn eq(&self, other: &PersistentHeaderV3) -> 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 StructuralPartialEq for PersistentHeaderV3