Struct Container10dHeader 

#[repr(C)]
pub struct Container10dHeader {
    pub magic: [u8; 4],
    pub version: u16,
    pub flags: u16,
    pub axis_roles: [u8; 10],
    pub pad0: [u8; 2],
    pub metric_descriptor: MetricCompletenessDescriptor,
    pub header_crc32c: u32,
    pub section_table_offset: u32,
    pub section_count: u32,
}

The normative .10d v1 header — 64 bytes, repr(C), naturally aligned.

Field layout (offsets):

offset  size  field
0       4     magic
4       2     version
6       2     flags
8       10    axis_roles          (one AxisRole u8 per AXIS_ORDER axis)
18      2     pad0                (must be zero — aligns metric_descriptor to 4)
20      32    metric_descriptor   (4 x MetricBranchDescriptor, 8 bytes each)
52      4     header_crc32c       (spec-reserved in P0.1; P0.3 wires shared CRC-32C)
56      4     section_table_offset (byte offset from file start; 0 = no table)
60      4     section_count        (number of SectionDescriptor rows; 0 = no table)

The section_table_offset + section_count fields at offsets 56–63 were the reserved[8] field in the initial P0.1 landing; P0.2 defines their meaning within v1 (the POD layout is unchanged — only a reserved field’s semantics are now specified). See the P0.2 progress-log entry.

Fields

magic: [u8; 4]

version: u16

flags: u16

axis_roles: [u8; 10]

pad0: [u8; 2]

metric_descriptor: MetricCompletenessDescriptor

header_crc32c: u32

section_table_offset: u32

Byte offset of the section table from the start of the file. 0 means no section table (a bare header — section_count must also be 0). Otherwise must be >= HEADER_BYTE_SIZE and within the file.

section_count: u32

Number of SectionDescriptor rows in the section table. 0 means no table (a bare header — section_table_offset must also be 0). Must be <= MAX_SECTION_COUNT.

Implementations

impl Container10dHeader

pub fn proposed() -> Self

The proposed (not-yet-frozen) v1 header: Option A axis-role taxonomy + option (b) metric-completeness descriptor (the documented limitation matching current full_distance reality) + default-disposition-Refuse flag set. CRC left zero (P0.3 wires the shared CRC-32C).

pub fn encode(&self, out: &mut [u8; 64])

Encode the header into a caller-supplied 64-byte buffer (little-endian where applicable; the POD is already LE-friendly). Zero-alloc.

pub fn encode_to_vec64(&self) -> [u8; 64]

Encode into a freshly-owned 64-byte array. Convenience for tests and writers that are not on a zero-heap hot path.

pub fn parse(data: &[u8]) -> Result<Container10dHeader, HeaderParseError>

Parse and validate a 64-byte header. Runs every P0.1 acceptance gate: bad magic, unknown version, non-zero structural padding, undefined axis role, metric-completeness divergence from full_distance reality, and (P0.2) a consistent section-table pointer.

Trait Implementations

impl Clone for Container10dHeader

fn clone(&self) -> Container10dHeader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Container10dHeader

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

Formats the value using the given formatter.

impl Default for Container10dHeader

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Container10dHeader

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

fn zeroed() -> Self

Calls zeroed.

impl Copy for Container10dHeader

impl Eq for Container10dHeader

impl Pod for Container10dHeader

impl StructuralPartialEq for Container10dHeader