ARTIFACT.md: relocation slot 7, the whole cell (step 3 §6.1 ruled)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017RzZgrf7V7Zk2iczBXDRbm
This commit is contained in:
Claude
2026-11-19 16:26:29 +00:00
parent 16b8fddaef
commit 1961348e15
2 changed files with 9 additions and 3 deletions
+7 -2
View File
@@ -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
@@ -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.