Overview

The v1 of the Stone format is the version currently employed by AerynOS, and is the first revision of our format.

Tip

The contents below extend the version-agnostic components of the Stone format. Readers are encouraged to read the Stone format overview first.

v1 revolves around the concept of records.
A payload contains one or more records, all of the same type, which specified in the payload’s sub-header; the record’s type describes the information it carries.
Records within a payload may be compressed as a whole archive (not individually) using Zstandard.
With the exception of the Content record, all records have a fixed size determined by their type, or have a preamble that reveals the final size. The Content record is unique in that it spans the entire payload and must be the only record it contains.

%%{
  init: {
    'treemap': {
       'showValues': false
    }
  }
}%%
treemap-beta
"Payload 1"
    "Header": 32
    "Records"
      "Record 1": 8
      "Record 3": 8
      "Record 2": 8
      "Record 4": 8
"Payload 2"
    "Header": 32
    "Records"
      "Record 1": 8
      "Record 2": 8
"…": 47

Header The header of the Stone v1 format

Payload's sub-header The content of Payload's sub-header

Attribute The format of the Attribute record