diff --git a/docs/v4.0.0/ARTIFACT.md b/docs/v4.0.0/ARTIFACT.md index 4d174e1e..1dc7ff42 100644 --- a/docs/v4.0.0/ARTIFACT.md +++ b/docs/v4.0.0/ARTIFACT.md @@ -95,12 +95,16 @@ Each hash is SHA-512 (choice 2). | Unit | Field | |---|---| -| 0 | the code cell, as an offset, and in the top 3 bits the slot whose branch field holds the address (0–3) | +| 0 | the code cell, as an offset, and in the top 3 bits the slot whose branch field holds the address (0–3), or 7 for the whole cell | | 1 | what it points to: `0xFFFFFFFF` for internal, so the base is added; otherwise the import's index | Placement (`ABI.md` §5) patches each relocation's branch field. It refuses a patched address beyond that slot's reach: 27, 22, 17 or 12 bits (`iword.h`). +**Slot 7, the whole cell** (ruled 2026-11-19, "Slot 7 = whole cell", step 3's design §6.1). The cell holds +an address as a value: an `&NAME` literal, or a dictionary link. Placement adds the base, or puts in the +import's address, to the whole cell, which reaches all of a node. Slots 4–6 are unused. + ## 6. Verification (18 units, ADR §5) | Units | Field | @@ -118,7 +122,8 @@ about the format: - every string pool offset on a counted string, or, for a capabilities list, on a unit holding its count *n* followed by *n* units, each a `KERNEL-WORD` number; - every export's entry inside the code; -- every relocation's cell inside the code, its slot one that holds a branch, its import index below I; +- every relocation's cell inside the code, its slot 0–3 one that holds a branch or 7, its import index + below I; - every reserved unit 0. ## 8. Open, for ruling one at a time diff --git a/docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md b/docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md index 2f99c5d1..17e67f53 100644 --- a/docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md +++ b/docs/v4.0.0/plans/2026-11-19-f18-artifact-build.md @@ -92,7 +92,8 @@ ADR step 8 asks. The boot gains nothing. ## 6. For ruling, one at a time -1. **Address literals.** `ARTIFACT.md` §5's relocation covers branch fields only (a slot, 0–3). The +1. ~~Address literals~~ **Ruled 2026-11-19: "Slot 7 = whole cell"**, recorded in `ARTIFACT.md` §5 and §7. + As asked: `ARTIFACT.md` §5's relocation covers branch fields only (a slot, 0–3). The system's source also holds addresses in whole cells: the `&NAME` literals (31 in `capsules/v4/sys`), and the dictionary's links. One fix is a slot value of 7 meaning "the whole cell". The top 3 bits allow 0–7, so the record keeps its size.