sergio/takana

1#!/bin/sh
2# instalador-initramfs.sh — empaqueta el instalador ENTERO en un initramfs que corre en RAM.
3#
4# ── PARA QUÉ ───────────────────────────────────────────────────────────────────────────────────
5# Es lo que hace posible reemplazar el Linux que está corriendo **sin un USB**: se salta a este
6# initramfs por `kexec` (`takana kernel kexec --jump`, ADR 0017), el sistema viejo muere en el salto
7# y su disco queda libre ⇒ recién entonces su raíz se puede formatear. El mismo initramfs sirve
8# arrancado por QEMU o por un medio cualquiera; el salto es sólo una forma de llegar.
9#
10# ── POR QUÉ EL PAYLOAD VIAJA ADENTRO Y NO EN EL DISCO ──────────────────────────────────────────
11# Porque el disco es justamente lo que se va a formatear. Dejar el rootfs en la partición destino y
12# formatearla después es morderse la cola; dejarlo en otra partición ata la instalación a que exista
13# esa otra partición. En RAM no depende de nada: el precio es que el initramfs pesa lo que pese el
14# rootfs, y por eso el script COMPRUEBA que entre en la memoria de la máquina antes de armarlo.
15#
16# Uso:
17#   ROOTFS=<product-rootfs> scripts/instalador-initramfs.sh --root-part /dev/nvme0n1p2 --esp /dev/nvme0n1p1
18#   # o sin destino fijo: lo decide el instalador al arrancar (--use-free-space)
19#
20# Salida: work/takana-instalador.cpio.gz  (+ el `takana kernel kexec` que lo salta, impreso al final)
21set -eu
22ROOT="$(cd "$(dirname "$0")/.." && pwd)"; cd "$ROOT"
23
24# Los argumentos son OPCIONALES a propósito. Un initramfs con el destino horneado sirve para UNA
25# máquina y hay que rehacerlo para la siguiente — eso no es un instalador, es un apaño. Sin
26# argumentos, el mismo fichero arranca en cualquier máquina y decide allí: lee la cmdline del kernel
27# (`takana.root=`, `takana.esp=`, `takana.free`) y, si no hay nada, muestra el censo del terreno y
28# pregunta. Lo que se pase acá queda sólo como VALOR POR DEFECTO.
29ARGS_INSTALADOR=""
30while [ $# -gt 0 ]; do ARGS_INSTALADOR="$ARGS_INSTALADOR $1"; shift; done
31
32OUT="${OUT:-work/takana-instalador.cpio.gz}"
33STAGE="${STAGE:-work/.instalador-initramfs-stage}"
34IRD_TREE="${IRD_TREE:-work/.instalador-initramfs-tree}"
35KERNEL="${KERNEL:-$(ls -dt store/*-linux-metal/boot/bzImage /store/*-linux-metal/boot/bzImage 2>/dev/null | head -1)}"
36[ -n "${KERNEL:-}" ] && [ -r "$KERNEL" ] || { echo "no encuentro un bzImage de linux-metal (set KERNEL=)" >&2; exit 1; }
37
38. "$(dirname "$0")/lib/herramientas-desde-store.sh"
39MKE2FS=$(herramienta e2fsprogs sbin/mke2fs mke2fs)  || exit 1
40SFDISK=$(herramienta util-linux sbin/sfdisk sfdisk) || exit 1
41MMD=$(herramienta    mtools usr/bin/mmd   mmd)      || exit 1
42MCOPY=$(herramienta  mtools usr/bin/mcopy mcopy)    || exit 1
43MDIR=$(herramienta   mtools usr/bin/mdir  mdir)     || exit 1
44CPIO=$(herramienta   libarchive usr/bin/bsdcpio cpio) || exit 1
45GZIP=$(herramienta   gzip bin/gzip gzip)            || exit 1
46
47# ── 1) el stage (rootfs a instalar + initramfs de pivote) lo arma el script validado ───────────
48echo "==> stage del sistema a instalar"
49STAGE_ONLY=1 KEEP_STORE=1 STAGE="$STAGE" ./scripts/install-image-efi.sh
50[ -d "$STAGE/root" ] && [ -r "$STAGE/initramfs.cpio.gz" ] || { echo "el stage no quedó completo" >&2; exit 1; }
51
52# ── 2) ¿entra en la RAM de esta máquina? ───────────────────────────────────────────────────────
53# Un initramfs vive ENTERO en memoria, y el kernel no lo avisa con elegancia: se queda sin RAM al
54# desempaquetar y el arranque muere sin un mensaje que diga por qué. Medirlo antes es la diferencia
55# entre «no entra, usá el USB» y un cuelgue mudo en la máquina del usuario.
56# ⚠ **Esta guarda es del camino en RAM, y sólo de ése.** Con `TREE_ONLY=1` el árbol se va a
57# escribir en el ext4 de un USB, donde no hay ningún límite de memoria: aplicarla ahí rechazaba la
58# variante `full` por no caber en la RAM de una máquina que no es la que va a instalar. Medido el
59# 2026-09-23 armando las tres variantes.
60#
61# ⚠ Y hay un segundo defecto, que se deja anotado y no barrido: mide la RAM de **esta** máquina, no
62# la de aquella donde se va a instalar. Acá acierta por casualidad —el hub tiene 7,6 GiB, parecido a
63# un portátil—, pero construir en una caja grande dejaría pasar una imagen que allá no arranca.
64if [ -n "${TREE_ONLY:-}" ]; then
65    echo "    (TREE_ONLY: el árbol va a un disco, no a RAM — la guarda de memoria no aplica)"
66else
67_mib_payload=$(du -sm "$STAGE/root" | cut -f1)
68_mib_ram=$(( $(awk '/^MemTotal:/ {print $2}' /proc/meminfo) / 1024 ))
69echo "    payload ${_mib_payload} MiB · RAM de esta máquina ${_mib_ram} MiB"
70if [ "$(( _mib_payload * 100 / _mib_ram ))" -gt 40 ]; then
71    echo "instalador-initramfs: el payload es más del 40 % de la RAM ($_mib_payload de $_mib_ram MiB)." >&2
72    echo "                      En RAM van el initramfs comprimido Y su contenido desempaquetado." >&2
73    echo "                      Este camino no sirve para este rootfs: instalá desde un medio." >&2
74    exit 1
75fi
76fi
77
78# ── 3) el árbol del initramfs ──────────────────────────────────────────────────────────────────
79echo "==> árbol del initramfs-instalador"
80# `/tmp` y `/run` NO son decorativos: el censo del terreno escribe ahí su fichero de trabajo, y sin
81# ellos el instalador fallaba diciendo «no veo ningún disco» con once discos delante.
82rm -rf "$IRD_TREE"; mkdir -p "$IRD_TREE/bin" "$IRD_TREE/dev" "$IRD_TREE/proc" "$IRD_TREE/sys" \
83    "$IRD_TREE/tmp" "$IRD_TREE/run" "$IRD_TREE/instalador/lib" "$IRD_TREE/payload"
84BUSYBOX="${BUSYBOX:-$STAGE/root/bin/busybox}"
85[ -r "$BUSYBOX" ] || { echo "no encuentro busybox estático en $BUSYBOX" >&2; exit 1; }
86cp "$BUSYBOX" "$IRD_TREE/bin/busybox"; chmod 0755 "$IRD_TREE/bin/busybox"
87# ⚠ `id` estaba fuera de esta lista y el instalador eligió la rama EQUIVOCADA por eso: sin `id -u`
88# concluyó «no soy root» y se fue a `unshare`, que tampoco existía. Los applets que el instalador usa
89# se enumeran acá y su ausencia ya no es silenciosa (el script aborta si le falta `id`).
90for a in sh mount umount mkdir echo sleep ls cat sed awk grep cut tr basename dirname readlink \
91         find sync reboot dmesg blkid setsid tee du wc head tail sort printf test sha256sum \
92         id sh chmod rm cp mv stat findfs; do
93    ln -sf busybox "$IRD_TREE/bin/$a"
94done
95# Las herramientas de disco NO salen de busybox: son las SELLADAS del corpus, estáticas musl. Dentro
96# del initramfs no hay store del que resolverlas por hash, así que viajan copiadas y el instalador
97# las recibe por `TOOL_<binario>` — el override que existe exactamente para esto.
98for t in "$MKE2FS" "$SFDISK" "$MMD" "$MCOPY" "$MDIR"; do
99    cp "$t" "$IRD_TREE/bin/$(basename "$t")"; chmod 0755 "$IRD_TREE/bin/$(basename "$t")"
100done
101TAKANA_MUSL="${TAKANA_MUSL:-$ROOT/target/x86_64-unknown-linux-musl/release/takana}"
102[ -x "$TAKANA_MUSL" ] || TAKANA_MUSL="$ROOT/target/release/takana"
103cp "$TAKANA_MUSL" "$IRD_TREE/bin/takana"; chmod 0755 "$IRD_TREE/bin/takana"
104cp scripts/takana-install-partition.sh "$IRD_TREE/instalador/"
105cp scripts/lib/herramientas-desde-store.sh "$IRD_TREE/instalador/lib/"
106cp "$KERNEL" "$IRD_TREE/payload/bzImage"
107mkdir -p "$IRD_TREE/payload/stage"
108cp -a "$STAGE/root" "$IRD_TREE/payload/stage/root"
109
110# ── SIN SÍMBOLOS DE DEPURACIÓN ────────────────────────────────────────────────────────────────
111# ⚠ **Casi todo el peso de lo que se publica son símbolos, no funciones.** Medido: `ssh` pesa
112# 19,3 MiB y 5,3 stripeado —el 72 %—, y un rootfs de escritorio entero baja de 1348 a 891 MiB. Con
113# binarios estáticos cada uno lleva su propia copia de todo, así que el multiplicador es grande.
114#
115# ⚠ **Y esto NO contradice al SDD 23**, que dice —con razón— que `strip` posterior no sirve: eso
116# vale para el STORE, donde el `ArtifactHash` es de ENTRADA y quedaría apuntando a un contenido que
117# un rebuild ya no reproduce. Acá se stripea una COPIA que no es un artefacto: no se sella, nadie
118# verifica su hash contra una receta, y el store conserva los símbolos intactos para quien depure.
119# `strip` es determinista, así que la imagen sigue siendo reproducible.
120#
121# `SIN_STRIP=1` lo apaga (para depurar la imagen misma, que es el único caso donde estorba).
122if [ -z "${SIN_STRIP:-}" ]; then
123    STRIP=$(herramienta binutils usr/bin/strip strip) || exit 1
124    _sr="$IRD_TREE/payload/stage/root"
125    # ⚠ GUARDA: si la copia compartiera inodo con el store, stripear MUTARÍA EL STORE — y con él
126    # todos los artefactos que enlazan a ese fichero, en silencio y para siempre. `cp -a` copia
127    # contenido y no enlaza al origen, pero eso es una propiedad del comando de arriba y no de este
128    # bloque: si alguien lo cambia a `cp -al` por rapidez, esto tiene que gritar antes de tocar nada.
129    _muestra=$(find "$_sr" -type f -perm /111 -size +64k -print -quit 2>/dev/null)
130    if [ -n "$_muestra" ] && [ "$(stat -c %h "$_muestra" 2>/dev/null || echo 1)" -gt 1 ]; then
131        _ino=$(stat -c %i "$_muestra")
132        if find "$STAGE/root" -inum "$_ino" -print -quit 2>/dev/null | grep -q .; then
133            echo "instalador-initramfs: el árbol a stripear COMPARTE INODOS con el stage." >&2
134            echo "                      Stripear mutaría el store. Abortado sin tocar nada." >&2
135            exit 1
136        fi
137    fi
138    _antes=$(du -sm "$_sr" | cut -f1)
139    # Ejecutables y bibliotecas: un `.so` puede no tener el bit de ejecución y pesa lo mismo.
140    find "$_sr" -type f \( -perm /111 -o -name '*.so' -o -name '*.so.*' \) \
141        -exec "$STRIP" --strip-unneeded {} + 2>/dev/null || true
142    _despues=$(du -sm "$_sr" | cut -f1)
143    _pct=0; [ "${_antes:-0}" -gt 0 ] && _pct=$(( (_antes - _despues) * 100 / _antes ))
144    echo "==> sin símbolos de depuración: ${_antes} → ${_despues} MiB (${_pct} % menos)"
145    echo "    (el store los conserva: lo que se stripea es esta copia, que no es un artefacto)"
146fi
147cp "$STAGE/initramfs.cpio.gz" "$IRD_TREE/payload/stage/initramfs.cpio.gz"
148printf '%s\n' "$ARGS_INSTALADOR" > "$IRD_TREE/instalador/args"
149
150# ── 4) /init — lo que corre cuando el kernel nuevo toma el control ─────────────────────────────
151cat > "$IRD_TREE/init" <<'INIT'
152#!/bin/busybox sh
153# PID 1 del instalador. No pivota a ningún disco: instala y reinicia.
154export PATH=/bin
155mount -t proc     proc /proc 2>/dev/null || true
156mount -t sysfs    sys  /sys  2>/dev/null || true
157mount -t devtmpfs dev  /dev  2>/dev/null || true
158# ⚠ El log va a tty0 **y** al serial, por lo mismo que el initramfs de pivote: el cmdline horneado
159# deja /dev/console en ttyS0 y en un metal sin puerto serie todo esto sería invisible.
160# El log va SÓLO a los devices: el stdout de PID 1 ya es /dev/console (= ttyS0 por el cmdline
161# horneado), así que un `echo` suelto duplicaba cada línea en el serial.
162log() { for d in /dev/tty0 /dev/ttyS0; do echo "$*" > "$d" 2>/dev/null || true; done; }
163rescate() {
164    log "TAKANA-INSTALADOR-FALLO: $*"
165    log "  bloques visibles: $(ls /dev/sd* /dev/nvme* /dev/vd* /dev/mmcblk* 2>/dev/null | tr '\n' ' ')"
166    log "  shell de rescate en tty1 — probá: blkid ; dmesg | tail -30"
167    setsid -c sh -c 'exec /bin/sh </dev/tty1 >/dev/tty1 2>&1' >/dev/null 2>&1 &
168    exec sh
169}
170# efivarfs: sin esto el instalador concluye «esta máquina no arrancó por UEFI» y NO registra la
171# entrada de arranque — en una máquina que sí arrancó por UEFI. Es el mismo diagnóstico falso que ya
172# costó una vuelta en el `/sbin/init` del rootfs: `switch_root` y un initramfs fresco no arrastran
173# /sys, y sin sysfs el directorio no existe. Tras un kexec los servicios EFI de runtime siguen ahí,
174# así que acá esto es lo único que falta.
175if [ -d /sys/firmware/efi ]; then
176    mkdir -p /sys/firmware/efi/efivars 2>/dev/null || true
177    mount -t efivarfs efivarfs /sys/firmware/efi/efivars 2>/dev/null || true
178fi
179# ── ¿POR DÓNDE SE LLEGÓ? ──────────────────────────────────────────────────────────────────────
180# Lo dice el pivote del medio, que exporta `TAKANA_MEDIO=1` antes de su `switch_root` — y el
181# entorno sobrevive al exec. No es un detalle: la diferencia cambia QUÉ ES LA RAÍZ VIVA (por el
182# salto, el sistema del usuario; por el medio, el propio USB) y con eso qué se ofrece formatear.
183#
184# ⚠ **La primera versión miraba `rdinit=` en /proc/cmdline y estaba MAL.** Con `CONFIG_CMDLINE_BOOL`
185# y sin `CONFIG_CMDLINE_OVERRIDE`, el cmdline horneado del kernel se CONCATENA con el que pasa quien
186# lo arranca: `rdinit=` aparece SIEMPRE, también tras un kexec, así que el instalador se creía en un
187# medio estando en el salto. Medido el 2026-09-23 — y el síntoma fue benigno de casualidad (un
188# mensaje raro), pero la consecuencia real era que la raíz viva del usuario habría quedado marcada
189# «es el MEDIO desde el que arrancaste» y NO SE HABRÍA PODIDO ELEGIR, que es justo el caso que el
190# salto existe para resolver.
191MEDIO="${TAKANA_MEDIO:-}"
192if [ -n "$MEDIO" ]; then
193    log "TAKANA-INSTALADOR: arrancado desde el MEDIO de instalación. Ningún disco de esta máquina está en uso."
194else
195    log "TAKANA-INSTALADOR: arrancado en RAM. El sistema viejo YA NO CORRE: su disco está libre."
196fi
197[ -d /sys/firmware/efi/efivars ] && log "TAKANA-INSTALADOR: firmware UEFI visible (efivarfs montado)" \
198    || log "TAKANA-INSTALADOR: sin efivarfs ⇒ no se registrará entrada NVRAM (BIOS, o kernel sin EFI)"
199
200# Los discos tardan en enumerar (USB y NVMe sobre todo). Misma espera larga que el pivote, y por el
201# mismo motivo: en QEMU aparecen al instante y la carrera sólo se ve en metal.
202# ⚠ Esto era `ls /dev/nvme* /dev/sd* /dev/vd* … && break` y **esperaba los 60 s completos incluso
203# con el disco presente**: `ls` sale ≠ 0 si CUALQUIERA de sus argumentos no existe, y los globs sin
204# coincidencia quedan literales. O sea que bastaba con no tener NVMe para que un disco virtio ya
205# enumerado no contara. Medido en QEMU: 60 s de «esperando discos» con /dev/vda ahí desde el
206# segundo uno. En metal eso se lee como un arranque colgado.
207i=0
208while [ "$i" -lt 60 ]; do
209    hay=""
210    for d in /dev/vd? /dev/sd? /dev/nvme?n? /dev/mmcblk?; do [ -b "$d" ] && hay=1; done
211    [ -n "$hay" ] && break
212    i=$(( i + 1 )); [ $(( i % 5 )) -eq 0 ] && log "TAKANA-INSTALADOR: esperando discos… ${i}s"
213    sleep 1
214done
215
216cd /instalador
217# ── De dónde sale QUÉ instalar, en orden de precedencia ───────────────────────────────────────
218#   1. la CMDLINE del kernel  (`takana.root=PARTUUID=… takana.esp=… takana.free takana.yes`)
219#   2. los valores por defecto horneados al armar el initramfs, si los hubo
220#   3. NADA ⇒ modo interactivo: el censo del terreno y una pregunta
221# El 1 es lo que hace que este mismo initramfs sirva en cualquier máquina: quien salta por kexec
222# pasa la elección por la cmdline, y quien arranca de un USB la edita en el menú del loader.
223ARGS=""; YES=""; CONSOLA_PEDIDA=""
224for _w in $(cat /proc/cmdline 2>/dev/null); do
225    case "$_w" in
226        takana.root=*) ARGS="$ARGS --root-part ${_w#takana.root=}" ;;
227        takana.esp=*)  ARGS="$ARGS --esp ${_w#takana.esp=}" ;;
228        takana.disk=*) ARGS="$ARGS --disk ${_w#takana.disk=}" ;;
229        takana.free)   ARGS="$ARGS --use-free-space" ;;
230        takana.keep=*) ARGS="$ARGS --keep ${_w#takana.keep=}" ;;
231        takana.yes)    YES=1 ;;
232        takana.console=*) CONSOLA_PEDIDA="${_w#takana.console=}" ;;
233    esac
234done
235# ── DÓNDE SE PREGUNTA ─────────────────────────────────────────────────────────────────────────
236# ⚠ `/dev/console` es la ÚLTIMA `console=` del cmdline, y **el cmdline HORNEADO del kernel pone
237# `tty0` PRIMERO y `ttyS0` último** ⇒ arrancado de un USB, `/dev/console` es el SERIAL. En un
238# portátil sin puerto serie eso significa que el censo y la pregunta salen por un sitio que no
239# existe: pantalla muerta y un instalador que parece colgado esperando una tecla que nadie puede
240# escribir. Por el salto el cmdline lo ponemos nosotros y `tty0` va último, pero por USB no se
241# puede elegir sin recompilar el kernel.
242#
243# Regla: si hay una VT de verdad, se pregunta en la PANTALLA. Y se dice en voz alta por los dos
244# lados, porque el caso contrario —una máquina sin monitor, administrada por serie— existe y tiene
245# que poder corregirlo sin adivinar: `takana.console=/dev/ttyS0` en la cmdline.
246# ⚠ Y no alcanza con que `tty0` EXISTA: con `console=tty0` en el cmdline el kernel lo registra
247# igual en una máquina sin pantalla, con el driver `dummy` detrás — o sea un dispositivo que acepta
248# todo lo que le escribas y no lo muestra en ningún lado. La pregunta se iría a un agujero. Lo que
249# distingue una pantalla de verdad es el vtconsole: `dummy device` contra `frame buffer device` o
250# `VGA+`. Medido en QEMU, que da las dos según se le pida `-vga std` o `-vga none`.
251hay_pantalla() {
252    for _v in /sys/class/vtconsole/vtcon*/name; do
253        [ -r "$_v" ] || continue
254        grep -qi 'dummy' "$_v" || return 0
255    done
256    return 1
257}
258CONSOLA=/dev/console
259if [ -n "$CONSOLA_PEDIDA" ]; then
260    CONSOLA="$CONSOLA_PEDIDA"
261elif [ -c /dev/tty0 ] && hay_pantalla; then
262    CONSOLA=/dev/tty0
263fi
264[ -z "$ARGS" ] && [ -s /instalador/args ] && ARGS=$(cat /instalador/args)
265log "TAKANA-INSTALADOR: takana-install-partition.sh ${ARGS:-(sin parámetros ⇒ interactivo)}"
266# Las herramientas viajan en /bin: el instalador las toma por TOOL_<binario> en vez de buscarlas en
267# un store que acá no existe. STAGE_LISTO dice que el árbol ya vino armado.
268export TOOL_mke2fs=/bin/mke2fs TOOL_sfdisk=/bin/sfdisk TOOL_mmd=/bin/mmd \
269       TOOL_mcopy=/bin/mcopy TOOL_mdir=/bin/mdir
270export STAGE=/payload/stage STAGE_LISTO=1 KERNEL=/payload/bzImage HAMMER=/bin/takana
271# El instalador necesita saberlo para clasificar bien la raíz viva: por el salto es el sistema del
272# usuario (se puede reemplazar); por el medio es el propio USB (no se toca nunca).
273[ -n "$MEDIO" ] && export TAKANA_MEDIO=1
274# ⚠ **El estado de un PIPE es el del ÚLTIMO comando, no el del primero.** Esto era
275# `if sh instalador… | tee …; then OK else rescate fi` y el `if` evaluaba el `tee`, que siempre sale
276# 0 ⇒ **el instalador falló, no formateó NADA, y esta pantalla dijo «instalado»**. Medido en QEMU el
277# 2026-09-23, y es el modo de fallo más caro posible: el usuario reinicia confiando y se queda sin
278# sistema. El estado del instalador se guarda aparte y se lee después; el pipe ya no decide nada.
279# shellcheck disable=SC2086
280# `< /dev/null`: nada de esto debe leer del teclado —las confirmaciones ya van por `--yes`— y si
281# algo lo intenta tiene que FALLAR, no quedarse esperando en una consola que nadie está mirando.
282# Desatendido SÓLO si la cmdline lo autorizó con `takana.yes`. Si hay parámetros pero nadie dijo
283# que sí, se entra igual por la rama interactiva: preguntar y que nadie conteste es un cuelgue, pero
284# formatear sin que nadie lo haya pedido es peor.
285if [ -n "$ARGS" ] && [ -n "$YES" ]; then
286    { sh /instalador/takana-install-partition.sh $ARGS --yes < /dev/null; echo $? > /rc; } 2>&1 | tee /dev/tty0 > /dev/ttyS0
287else
288    # Interactivo: la consola del kernel es la pantalla (tty0 va ÚLTIMO en la cmdline del salto),
289    # así que entrada y salida van ahí y el instalador ve una terminal de verdad — sin eso su
290    # `[ -t 0 ]` sale falso y se niega a preguntar.
291    log "TAKANA-INSTALADOR: el censo y la pregunta salen por $CONSOLA"
292    log "TAKANA-INSTALADOR: si estás mirando esto por el puerto serie y la pregunta no aparece acá,"
293    log "                   rearrancá con  takana.console=/dev/ttyS0  en la cmdline."
294    sh /instalador/takana-install-partition.sh $ARGS < "$CONSOLA" > "$CONSOLA" 2>&1
295    echo $? > /rc
296fi
297if [ "$(cat /rc 2>/dev/null || echo 1)" = "0" ]; then
298    log "TAKANA-INSTALADOR-OK: instalado. Reiniciando en 10 s (sacá el medio si lo hubiera)."
299    sync; sleep 10; reboot -f
300else
301    rescate "el instalador salió con error — NADA se reinicia solo, mirá el log de arriba"
302fi
303INIT
304chmod +x "$IRD_TREE/init"
305
306# ── 5) empaquetar ──────────────────────────────────────────────────────────────────────────────
307mkdir -p "$(dirname "$OUT")"
308# `TREE_ONLY=1` corta acá: el ÁRBOL es la pieza, y tiene dos medios. Comprimido en un cpio viaja
309# por kexec y dentro del `.run`; escrito en un ext4 es el USB, que existe para las máquinas donde el
310# salto no se puede. Duplicar el armado del árbol en el script del USB sería tener dos instaladores
311# que se parecen — y el que se olvide de actualizar es el que alguien va a arrancar.
312if [ -n "${TREE_ONLY:-}" ]; then
313    echo "==> TREE_ONLY: árbol listo en $IRD_TREE — no se comprime"
314    exit 0
315fi
316( cd "$IRD_TREE" && find . -print0 | "$CPIO" --null -o -H newc --owner=root:root 2>/dev/null | "$GZIP" -1 ) > "$OUT"
317echo "==> $OUT: $(du -h "$OUT" | cut -f1)"
318echo
319echo "Este initramfs NO lleva ninguna máquina horneada: decide al arrancar."
320echo "  · sin parámetros                  ⇒ censo del terreno + pregunta (sirve en cualquier máquina)"
321echo "  · takana.root=PARTUUID=…          ⇒ destino por identidad estable"
322echo "  · takana.free takana.disk=/dev/…  ⇒ instalar al lado, en espacio sin asignar"
323echo "  · takana.keep=PARTUUID=…:/home    ⇒ conservar ese /home sin formatearlo"
324echo "  · takana.yes                      ⇒ sin preguntar (sólo junto a lo de arriba)"
325echo
326echo "Para SALTAR a él sin pasar por el firmware (el userspace de esta máquina muere ACÁ), lo normal
327es NO tocar esto y usar el verbo, que comprueba, avisa y arma la cmdline solo (ADR 0021):
328  sudo takana metal check      # ¿se puede?
329  sudo takana metal survey     # el terreno
330  sudo takana metal install    # el viaje entero
331El motor a la vista, por si hace falta:
332  sudo takana kernel kexec <linux-metal> --initrd work/instalador-salida/takana-instalador.cpio.gz \
333       --cmdline 'console=ttyS0,115200 console=tty0' --jump   # tty0 ÚLTIMO = la pantalla
334
335Para probarlo SIN saltar (y sin riesgo), en QEMU:"
336echo "  qemu-system-x86_64 -m 4096 -kernel $KERNEL -initrd $OUT \\"
337echo "       -append 'console=ttyS0' -drive file=<disco.img>,format=raw -nographic"