docs(v4): the stick's identity partition starts at 500 MiB

Captain Bob, 2026-10-26: "64 megabytes does not need to be an engraved in
stone size ... start maybe 500 megabytes." Sizes are set in kernel/Makefile
and are not fixed by the formats.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
rajames
2026-10-26 19:46:48 -04:00
co-authored by Claude Opus 5.5
parent 7f297f4e99
commit f9a313f44b
+5 -3
View File
@@ -84,9 +84,11 @@ gains the partitions below). Three partitions:
subsystem) runs unchanged on the partition device. subsystem) runs unchanged on the partition device.
- **Raw identity drives stay accepted:** a device with no valid GPT is read as today (the minted - **Raw identity drives stay accepted:** a device with no valid GPT is read as today (the minted
scratch pair in `disk/zuse-scratch/`, any v3 identity drive). scratch pair in `disk/zuse-scratch/`, any v3 identity drive).
- **Sizes (my call):** the image is a fixed size and does not grow to fill a bigger stick. - **Sizes:** the image is a fixed size and does not grow to fill a bigger stick. Partition sizes are
Partition sizes are set at build time: ESP 64 MiB, identity 64 MiB (today's identity drive set at build time, in one place, `kernel/Makefile`, and are not fixed by the formats: ESP 64 MiB,
size), Artemis the rest of a 2 GiB image. Changeable in one place, `kernel/Makefile`. identity 500 MiB to start (Captain Bob, 2026-10-26: "64 megabytes does not need to be an engraved
in stone size ... start maybe 500 megabytes"; the identity format records its own size,
`homeblocks_sig_t.metadata_devblocks`), Artemis the rest of a 2 GiB image (my call).
- **The Artemis partition is formatted when the image is built (my call),** not on first boot: - **The Artemis partition is formatted when the image is built (my call),** not on first boot:
the image builder writes its `STFR` volume header and its `artemis_sig_t` genesis signature, the image builder writes its `STFR` volume header and its `artemis_sig_t` genesis signature,
so the kernel never meets a blank Artemis on a stick and never has to decide whether a disk may so the kernel never meets a blank Artemis on a stick and never has to decide whether a disk may