seed: Use the installed emulator for bootstrapping
64ff370db390eb4825024818322defd34de601fd7c0f78117e1d34ec5453c44c
The installed emulator runs the compiler throughout the seed history, so the historical emulator mapping is no longer needed. Assisted-by: Codex:gpt-6
1 parent
6a702faf
seed/README
+1 -25
| 43 | 43 | text, read-only data, and read-write data. |
|
| 44 | 44 | seed/radiance.rv64.git Full Git tree ID of the source commit that |
|
| 45 | 45 | was compiled to produce this seed. |
|
| 46 | 46 | seed/update Tool that finds the fixed point and |
|
| 47 | 47 | updates the seed. |
|
| 48 | - | seed/emulators Emulator commit that runs the compiler built |
|
| 49 | - | from each seed source tree. |
|
| 50 | 48 | ||
| 51 | 49 | ||
| 52 | 50 | EVERYDAY DEVELOPMENT |
|
| 53 | 51 | ||
| 54 | 52 | Most compiler work -- bug fixes, optimizations, new standard library |
| 207 | 205 | seed is the fixed point reached from `radiance.s0`, the bootstrapping |
|
| 208 | 206 | compiler at its commit 7834d3a. |
|
| 209 | 207 | ||
| 210 | 208 | To verify the whole chain, build the first seed with `--from-s0`. |
|
| 211 | 209 | Then, for each later seed commit in order, check out its parent, run |
|
| 212 | - | `seed/update --seed <previous seed>` with the emulators that |
|
| 213 | - | `seed/emulators` names (see below), and compare the result with the |
|
| 210 | + | `seed/update --seed <previous seed>`, and compare the result with the |
|
| 214 | 211 | seed that the seed commit checks in. |
|
| 215 | 212 | ||
| 216 | 213 | Breaking changes |
|
| 217 | 214 | ||
| 218 | 215 | A change that the previous seed cannot compile is staged. First the |
| 220 | 217 | follows. Then the compiler's own source moves to the new form, and |
|
| 221 | 218 | finally a commit requires it. The ownership rewrite instead follows a |
|
| 222 | 219 | bridge commit, "Bootstrap ownership syntax", which extends the |
|
| 223 | 220 | previous compiler just enough to compile the rewrite. |
|
| 224 | 221 | ||
| 225 | - | Emulators |
|
| 226 | - | ||
| 227 | - | The seed image format and host interface changed over time, so |
|
| 228 | - | different seeds run on different commits of the emulator. |
|
| 229 | - | `seed/emulators` gives, for each seed source tree, the emulator |
|
| 230 | - | commit that runs compilers built from that tree: |
|
| 231 | - | ||
| 232 | - | <seed source tree> <emulator commit> |
|
| 233 | - | ||
| 234 | - | A compiler runs on the emulator of the tree that built it. When the |
|
| 235 | - | image format or host interface changes, the first stage of a seed |
|
| 236 | - | update runs the previous seed on its emulator, and later stages run |
|
| 237 | - | on the new one. `seed/update` uses one emulator, so for such a seed, |
|
| 238 | - | build the first stage yourself: |
|
| 239 | - | ||
| 240 | - | RAD_EMULATOR=<previous emulator> make bin/radiance.rv64.dev |
|
| 241 | - | RAD_EMULATOR=<new emulator> seed/update --seed bin/radiance.rv64.dev |
|
| 242 | - | ||
| 243 | - | When you update the seed, add a line for its source tree, the ID that |
|
| 244 | - | `seed/update` writes to `seed/radiance.rv64.git`, and the emulator |
|
| 245 | - | commit that runs the new seed. |
|
| 246 | 222 | ||
| 247 | 223 | ||
| 248 | 224 | TROUBLESHOOTING |
|
| 249 | 225 | ||
| 250 | 226 | "No fixed point reached after N stages" |
seed/emulators
deleted
+0 -27
| 1 | - | # Emulator commit that runs the compiler built from each seed source tree. |
|
| 2 | - | # One line per seed, in history order: source tree, emulator commit. |
|
| 3 | - | 2f8daf197dc1e5942908278b184575b3e47c1d04f77c7a5d9c678fc32e5426e6 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 4 | - | 97a0b1b94a1e8c2bb2b6c85cc166d307b7bd74d966b08f8cea828d2fe42cbfa7 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 5 | - | bacf9561dadcac0334dd3acb4515f44ce87d82cbcd300957f7e83b0bea3a3b94 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 6 | - | ab336db3567c634b5582c9b539d6915400ecb66eb49d4ea7c47653391b9184ad 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 7 | - | b4f5c16072626d496f8bf6452c309a75c474bdbd87fe68ffdc35ef429e6caca7 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 8 | - | fc24bde316e1c1784c5545344acd61df3d9a34196f7b25f3f4f915c2f69c4be9 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 9 | - | a0c9ab81c14eab067d1cd8a1150a3fecd8413136a9ab390453cd7c5ee393b35a 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 10 | - | 79fd0b036ed056a30d49b1c1c1fe4cd58c0ebd1abb43d23fb928a7025cd977d5 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 11 | - | dbff2ca7b2f4a1e31ca14453be2cb9b2558decfc9b0d46f77cc77d925d24067f 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 12 | - | 45ecb7fab60cf80dbed4796b1008ef6ab54c88de6a2ae54678dc35c44885e64b 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 13 | - | 87fbb28f6d727d5894cff3dc16187b2c56b18a4b6fc99a84b0e440a97dde03ae 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 14 | - | f7cbb68a5a845e7ed95c78c225900cdc08753c9b5cf81c6bf3997fa55acfc927 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 15 | - | 30d107f2b5bca00fe9ecf97e44fc92c5716d74c8527e9a03c2af255ed7def8ad 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 16 | - | a44684634d40fd27c130ff8c6a46b204e18ca55147921894e4cd820916b93ec2 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 17 | - | 867edd324bef4c7132641d1bd2f06d9cba7ffd688650d26abfa07b8916fe01ec 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 18 | - | 7af0c5e24f3b67136f27f5a261b696eb6ce482798f5162e650063a935634348c 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 19 | - | f8dbdfe3e1bfe72e6061740e05596b554d8bbaf537110bbf5ea5216495a6037c 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 20 | - | a07dbae68b995f9602ef47cd3c7aba68149676f43da4c20a47fcd430ff684b5d 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 21 | - | e6981272c54718370b40b301e822897876b1d5ad4dcc104db6096cf1c79ae927 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 22 | - | 1d06b7cb9ea82eb3ca31edc29ddb076de3a77654d4ffb30678f41a5c81adeb22 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 23 | - | cb02cf9981476f9aad308125e7d4086abf9261448b33f5359ff807ec79abdffa 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 24 | - | 0ba4857a931e06a3123a41253559cc45976cb4d17a9e46ebc84ccc2e87941daa 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 25 | - | e9231f251c2fb025d885e633ba769793c27790a097071685a08d71f1c7ef8d85 92cdb0c5293447964be053214fac403b49193ac3ec07c902576346ebaa205535 |
|
| 26 | - | db68bd728b5426857c3b8ad5230b6dbb02433add2d286044e0bd946b6805f097 4db56f55927810527a31ca73d68ffbd0f2799b8ccae7330b161c3fcb040bc36e |
|
| 27 | - | 71178f37518b593d5f451245567b757f9ad798455ed0cb60a8696dd1ce5d0f90 e76b614c356a89ad71fc7253f63624b0c7e6bbabca8040c54db541f30e364309 |