gioser

sergio/takana

> Una distribución Linux construida con un laboratorio funcional y hermético en el > sótano, y una terminal mutable, clásica y anárquica en el piso de arriba — diseñada > desde el suelo para que una IA programadora entienda, modifique y co…

TOML 1463Shell 159Markdown 91Rust 853029 Definitions

⎇ 3df94f3936e8ce8a4816f5b966e22fd65fe3832d recipes/rust.toml TOML · 117 lines · 6.2 KB History raw

SDD 31: el compilador de Rust — el escalón 2 construyendo, y los cinco muros del camino 3df94f393 · Sergio ·

1# rust 1.97.0 DESDE FUENTE — el paso 2 de los tres, y el que hace que el compilador sea nuestro.
2#
3# ══ LA CADENA, Y POR QUÉ ESTE ES EL SEGUNDO ESCALÓN ════════════════════════════════════════════
4#   1. `rust-toolchain-bin` — el tarball oficial, `foreign`, sellado tal cual. Desbloqueó que una
5#      caja takana compile Rust (probado: `rustc 1.97.0` y un binario que corre). Es el escalón.
6#   2. **esto** — rustc construido acá, con `llvm21` del corpus y con el (1) como **stage0**. Un
7#      prebuilt ajeno sirve exactamente para esto: ser el escalón que permite dejar de necesitarlo.
8#   3. La cadena `mrustc → 1.90 → 1.91.0 → 1.91.1` del selfhost, que quita hasta ese escalón.
9#
10# ⚠ **`local-rebuild = true` NO es un detalle.** El bootstrap de rustc espera que el stage0 sea el
11# compilador ANTERIOR (o el beta de esta versión); acá el stage0 es **1.97.0 construyendo 1.97.0**, y
12# sin esa opción x.py aborta por «stage0 compiler version mismatch». Es el modo que usan las distros
13# para reconstruir la misma versión con la misma versión.
14#
15# ⚠ **El LLVM es EXTERNO y tiene que ser ≥21**, medido en el propio bootstrap:
16# `panic!("bad LLVM version: {version}, need >=21")`. Por eso existe `llvm21` y por eso `llvm18` —que
17# ya estaba sellado— no servía: lo usa mesa, que no soporta 21. Ver `recipes/llvm21.toml`.
18#
19# ⚠ Sin red: el tarball `-src` trae `vendor/` con todas las deps de cargo. Es la única forma de que
20# esto construya dentro del sandbox, que no tiene red después del fetch.
21name    = "rust"
22version = "1.97.0"
23license = "MIT OR Apache-2.0"
24
25[source]
26tarball = "https://static.rust-lang.org/dist/rustc-1.97.0-src.tar.xz"
27sha256  = "de002ee301c1b7422b0a7b09d7c4cb4924cd3224e6cfb24f065dad786dd3ed12"
28
29[build]
30compiler = "zig-cc"
31target   = "x86_64-linux-musl"
32link     = "dynamic"
33flags    = []
34
35[deps]
36# `rust-toolchain-bin` es el STAGE0: el compilador con el que arranca el build. `llvm21` aporta el
37# `llvm-config` y las librerías. `cmake`/`samurai`/`pkgconf` los pide el propio bootstrap aunque el
38# LLVM venga hecho (compila algunas cosas nativas: `compiler-rt` para los sanitizers, jemalloc…).
39# ⚠ EL STAGE0 **NO** ES `rust-toolchain-bin`, Y ESO SE APRENDIÓ CHOCANDO. El toolchain musl oficial
40# de rust-lang está compilado con `crt-static = true`, y un rustc así **no puede producir
41# proc-macros** — que son dylibs. El primer intento murió en el primer minuto:
42#
43#     error: cannot produce proc-macro for `clap_derive v4.5.18` as the target
44#            `x86_64-unknown-linux-musl` does not support these crate types
45#
46# …compilando el PROPIO bootstrap de rustc, que usa `clap` con derive. O sea: el prebuilt oficial
47# sirve para compilar programas (probado: un binario que corre) y **no** para arrancar el build de
48# rustc. El stage0 es el `rustc` del LAB, que Alpine construye con soporte de dylib.
49#
50# Y por eso abajo va `crt-static = false` para el host: sin eso, el rustc que salga de acá heredaría
51# el mismo defecto y no podría compilar ni una receta del corpus que use `derive`.
52build = ["llvm21", "cmake", "samurai", "python3", "pkgconf", "curl"]
53
54[build.phases]
55# El fichero de configuración de x.py se llama `bootstrap.toml` desde 1.8x; se escribe también
56# `config.toml` porque el nombre viejo sigue siendo el que busca media documentación, y un fichero
57# de más no cuesta nada mientras el de verdad esté.
58configure = '''
59cat > bootstrap.toml <<'CFG'
60profile = "dist"
61change-id = "ignore"
62
63[build]
64# ⚠⚠ EL TRIPLE ES EL DE ALPINE, `x86_64-alpine-linux-musl`, Y NO EL CANÓNICO. Cuesta dos fallos
65# seguidos entenderlo:
66#   · Sin decir `build`, x.py detecta el del `cc` del sandbox (el de Alpine) y entonces una sección
67#     `[target.x86_64-alpine-linux-musl]` **no aplica a nada**: ignora el `llvm-config` externo y se
68#     pone a construir LLVM él solo — se vio porque entró en `/src/build/x86_64-alpine-linux-musl/`.
69#   · Y al forzar el canónico, el stage0 del LAB **no tiene la std de ese triple**:
70#     `error[E0463]: can't find crate for std`. Alpine RENOMBRA el triple, y su rustc sólo trae la
71#     std del suyo.
72# Así que se usa el de Alpine en todas partes, que además es el triple con el que ya se compila todo
73# el corpus. Es el mismo camino que toma el APKBUILD de rust de Alpine.
74build = "x86_64-alpine-linux-musl"
75docs = false
76extended = true
77tools = ["cargo"]
78local-rebuild = true
79# Hay que NOMBRAR el stage0 aunque ya esté en el PATH: sin estas dos líneas, x.py se salta el
80# compilador local y va a DESCARGAR el toolchain de `static.rust-lang.org` — que en un sandbox sin
81# red muere con un `RuntimeError: failed verification` en `download_toolchain()`, un mensaje que no
82# menciona ni la red ni el stage0. Estas rutas son las del LAB, no las del prebuilt (ver arriba).
83rustc = "/usr/bin/rustc"
84cargo = "/usr/bin/cargo"
85target = ["x86_64-alpine-linux-musl"]
86host = ["x86_64-alpine-linux-musl"]
87vendor = true
88
89[llvm]
90download-ci-llvm = false
91link-shared = false
92
93[rust]
94channel = "stable"
95codegen-tests = false
96deny-warnings = false
97musl-root = "/usr"
98
99[target.x86_64-alpine-linux-musl]
100llvm-config = "/usr/bin/llvm-config"
101# `false` a propósito: habilita dylibs, y sin dylibs no hay PROC-MACROS. Un rustc con
102# `crt-static = true` no puede compilar `serde_derive`, `clap_derive` ni ninguna de las 44 recetas
103# `cargo-*` del corpus que usan `derive`.
104crt-static = false
105CFG
106cp bootstrap.toml config.toml
107# La versión del stage0 se COMPRUEBA, no se asume: `local-rebuild` sólo es correcto si el compilador
108# de arranque es exactamente esta versión, y si alguien mueve el pin de `rust-toolchain-bin` esto
109# tiene que fallar acá y no tres horas después.
110rustc --version | grep -q '1[.]97[.]0' || { echo "stage0 NO es 1.97.0: $(rustc --version)" >&2; exit 1; }
111llvm-config --version
112'''
113# `CC`/`CXX` de GCC para los build scripts nativos (jemalloc, compiler-rt): con el wrapper de zig,
114# cmake declara el compilador «broken» en su prueba de ABI. Mismo motivo por el que `llvm21` y
115# `cmake` usan g++ en vez de zig.
116compile = "export CC=gcc CXX=g++ AR=ar RANLIB=ranlib && python3 x.py build --stage 2"
117install = "export CC=gcc CXX=g++ AR=ar RANLIB=ranlib && DESTDIR=/out python3 x.py install --stage 2"