sergio/takana

1# dwarves 1.30 (pahole) — la llave que destraba sched-ext (plan-jaula-juegos T1.2, diferido
2# con causa verificada): en 6.16.12 SCHED_CLASS_EXT depende de DEBUG_INFO_BTF, y generar BTF
3# exige pahole en las build-deps del kernel. Sin esta receta, sched-ext (los schedulers scx
4# de juego: scx_lavd, scx_bpfland) queda fuera del kernel propio para siempre.
5#
6# OJO REPRO: meter pahole en el kernel no es sólo declarar la dep — BTF mete la versión de
7# pahole en el juego de la bit-repro (pahole-skew entre builders cambia el .BTF). El análisis
8# está pendiente en el plan; ESTA receta sólo pone la herramienta en el catálogo para poder
9# hacerlo. El kernel NO la declara todavía.
10#
11# libbpf EMBEBIDO (-DLIBBPF_EMBEDDED=ON, el default del tarball que vendorea libbpf): evita
12# una receta libbpf aparte hoy; si libbpf entra al catálogo por otro frente, se despega.
13#
14# ── 🧱 EL MURO REAL, MEDIDO EN EL WORKER 2026-08-07 (antes se creía que era el rootfs) ──────────
15# Falla en `configure` con:
16#     CMake Error at cmake/modules/FindDWARF.cmake:93 (message):
17#       Could NOT find some ELF and DWARF libraries, please install the missing packages
18# NO es que falte cmake ni que el rootfs del worker esté flaco: cmake corre perfectamente. Lo que
19# falta es **libdw**. Nuestro artefacto de `elfutils` entrega SÓLO libelf (`libelf.a/.so`, `libelf.h`,
20# `gelf.h`) — sin `libdw`, sin `dwarf.h` — y eso es DELIBERADO: su cabecera dice que libdw/libdwfl
21# arrastran argp/obstack/fts, «lo verdaderamente difícil en musl». Aquella receta existe para el
22# `objtool` del kernel, que sólo necesita libelf.
23#
24# ⚠ Y NO se arregla ampliando `elfutils`: de él cuelgan `linux`, `linux-generic`, `linux-metal` y
25# `linux-metal-dual`, o sea **el kernel que ya reproduce bit a bit**. Tocarlo re-hashea ese baseline
26# validado a cambio de una herramienta que hoy nadie pide. El camino correcto es una receta APARTE
27# —`elfutils-libdw`— igual que el patrón de las sombras `-shared`: deja intacto lo sellado y paga el
28# coste de musl una sola vez, donde se necesita.
29#
30# ⇒ CLASIFICACIÓN HONESTA: esto NO es «una receta en deuda» sino un frente propio, con muro conocido
31# (portar libdw a musl) y sin urgencia: ningún perfil de `targets.toml` pide dwarves, y el kernel
32# desactiva `DEBUG_INFO_BTF` explícitamente «para evitar pahole, ausente del toolchain». Se
33# desbloquea cuando se quiera sched-ext, no antes.
34#
35# BLOQUEADA (intento real en worker 2026-07-17): el cmake no halla libdw/dwarf.h porque el
36# artefacto sellado de elfutils sólo empaqueta LIBELF (headers + .a/.so — lo que kbuild
37# necesita), no libdw. Y elfutils.toml es INTOCABLE: es build-dep de los kernels sellados
38# (linux.toml load-bearing del selfhost-verify). Destrabar = receta variante
39# `elfutils-libdw` (elfutils completo, que en musl arrastra shims argp/fts/obstack — los
40# parches de Alpine) que SÓLO dwarves consuma. Es un sub-proyecto de la cola clib, no un
41# retoque de flags. sha256 del tarball verificado (fedorapeople 2026-07-17).
42
43# ── FRENTE libdw/musl, cerrado el 2026-08-27 ───────────────────────────────────────────────────
44# dwarves necesita TRES cosas que musl no da y que el corpus no tenía:
45#   · `libdw` + `dwarf.h`  → `elfutils-libdw` (variante; la canónica sólo hace libelf porque de ella
46#                            cuelgan los cuatro kernels y no se le puede mover el hash).
47#   · `libargp`            → `argp-standalone`  (`find_package(argp REQUIRED)` en su CMakeLists).
48#   · `libobstack`         → `musl-obstack`     (`find_package(obstack REQUIRED)`).
49#
50# Los dos `find_package` son REQUIRED y sus `Find*.cmake` hacen `find_library(NAMES argp/obstack)`
51# sobre /usr/lib. En glibc no hacen falta (van dentro de la libc) y por eso el proyecto no los
52# empaqueta; en musl son librerías aparte. Se les pasa la ruta explícita con
53# `-DARGP_LIBRARY=`/`-DOBSTACK_LIBRARY=` para no depender del orden de búsqueda de cmake.
54#
55# `-DCMAKE_C_STANDARD_LIBRARIES='-llzma -lbz2'`: libdw descomprime secciones de debug comprimidas
56# (`.debug_*` en xz/bzip2) y referencia `lzma_code`/`BZ2_bzDecompress`. El `FindDWARF.cmake` de
57# dwarves pone en `DWARF_LIBRARIES` sólo libdw y libelf, así que esas dos no entran por ahí y hay
58# que añadirlas al link de todos los ejecutables. Misma familia de fallo que appstream/cargo-deb.
59#
60name    = "dwarves"
61version = "1.30"
62license = "GPL-2.0-only"
63
64[source]
65tarball = "https://fedorapeople.org/~acme/dwarves/dwarves-1.30.tar.xz"
66sha256  = "1c89f47dc4f127c4b9d3fb46c8386a40be45c36ef82e8df472418de9423fc5bb"
67
68[build]
69compiler = "zig-cc"
70target   = "x86_64-linux-musl"
71link     = "static"
72
73[deps]
74build = ["make", "cmake", "elfutils-libdw", "argp-standalone", "musl-obstack", "zlib", "xz", "bzip2"]
75
76# `DWARF_LIBRARY`/`ELF_LIBRARY` por ruta `.a` + `CMAKE_EXE_LINKER_FLAGS=-static` (audit 2026-08-31):
77# la receta decía `link = "static"` y los DIEZ ejecutables salían DINÁMICOS contra cinco librerías.
78# Dos causas encadenadas: (1) `FindDWARF.cmake` resuelve libdw/libelf con `find_library`, que
79# prefiere `.so` — y `elfutils-libdw` empaqueta libelf en las dos formas — así que metía
80# `/usr/lib/libelf.so` en la línea de enlace, y ante un `.so` en la línea el wrapper del lab TIRA el
81# `-static` inyectado (`sandbox.rs:597`); (2) sin `-static`, `-lz`/`-llzma`/`-lbz2` resolvían a las
82# `.so` DEL ROOTFS de Alpine y no a los artefactos de `zlib`/`xz`/`bzip2` —que sólo traen `.a`—:
83# tres entradas no declaradas.
84#
85# ⚠ `-DCMAKE_FIND_LIBRARY_SUFFIXES=.a` NO sirve y se probó: `Platform/Linux.cmake` lo asigna como
86# variable NORMAL al correr `project()`, y una normal TAPA a la del caché ⇒ el `-D` es inerte. La
87# palanca que sí funciona es la que esta misma receta ya usa para argp/obstack: dar la ruta `.a`
88# explícita a cada variable que el `Find*.cmake` correspondiente consulta.
89#
90# Y son TRES, no dos: `find_package(ZLIB REQUIRED)` (CMakeLists:52) metía `/usr/lib/libz.so` —la
91# del ROOTFS— en la línea, y con eso basta para que el wrapper tire el `-static` aunque libdw y
92# libelf ya fueran `.a`. Se vio leyendo `build/CMakeFiles/pahole.dir/link.txt`, que es donde cmake
93# deja la línea de enlace literal: **el `-static` estaba puesto y lo quitaban después**. Ése es el
94# sitio donde mirar la próxima vez que `link = "static"` no pegue en un proyecto cmake.
95#
96# Esto NO es cosmético: el día que se encienda `DEBUG_INFO_BTF` (SDD 25 H7), pahole corre DENTRO
97# del sandbox del build del kernel, y un pahole dinámico fallaría ahí diciendo que no está.
98[build.phases]
99# ⚠ **`CMAKE_LINK_DEPENDS_USE_LINKER=OFF`: EL LINKER DE ZIG SE CAE CON `--dependency-file`.**
100#
101# Esta receta estaba SELLADA y llevaba tiempo sin construir. Se destapó el 2026-09-12 al arreglar los
102# symlinks de `bzip2`: su hash se movió, dwarves cayó a deuda, y al reconstruirla:
103#
104#     [ 71%] Linking C executable codiff
105#     Error running link command: Segmentation fault
106#
107# **No lo rompió el cambio de bzip2 y se puede probar**: el `libbz2.a` y el `bzlib.h` nuevos son
108# byte-idénticos a los viejos (`cmp -s`); lo único que cambió fueron cuatro destinos de symlink. El
109# artefacto sellado tapaba una rotura que ya existía — el lab rueda desde Alpine edge y zig subió.
110#
111# **La causa se aisló bisecando la línea de enlace**, no suponiendo. Con el `link.txt` que cmake deja
112# en `build/CMakeFiles/codiff.dir/`, rehecho a mano FUERA de takana y del sandbox:
113#
114#     tal cual                        → exit 139 (SIGSEGV)
115#     quitando `-static`              → exit 139   ⇒ no es el enlace estático
116#     quitando `--dependency-file`    → **exit 0** ⇒ ES ESO
117#
118# `-Xlinker --dependency-file=…` lo emite CMake ≥3.27 para que el LINKER calcule las dependencias de
119# enlace, y el `lld` de zig 0.16.0 **segfaultea** al procesarlo. `CMAKE_LINK_DEPENDS_USE_LINKER=OFF`
120# es la palanca que upstream expone justo para apagarlo (cmake del corpus: 3.31.6 ⇒ la soporta).
121#
122# ⚠ **Y NO ES UN PROBLEMA DE DWARVES**: es de *cualquier* proyecto CMake construido con zig en este
123# corpus. El mismo crash mató a los tres `protoc-gen-upb*` de protobuf el día anterior, y allá se
124# esquivó con `compiler = "gcc"` sin conocer la causa. Ésta es la causa, y el arreglo bueno — porque
125# deja la receta en el toolchain por defecto del proyecto en vez de escapar del él.
126configure = """
127cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr -D__LIB=lib \
128  -DCMAKE_LINK_DEPENDS_USE_LINKER=OFF \
129  -DBUILD_SHARED_LIBS=OFF -DLIBBPF_EMBEDDED=ON \
130  -DARGP_LIBRARY=/usr/lib/libargp.a -DOBSTACK_LIBRARY=/usr/lib/libobstack.a -DCMAKE_C_STANDARD_LIBRARIES='-llzma -lbz2' -DCMAKE_C_FLAGS='-O2 -fno-sanitize=undefined' \
131  -DDWARF_LIBRARY=/usr/lib/libdw.a -DELF_LIBRARY=/usr/lib/libelf.a -DZLIB_LIBRARY=/usr/lib/libz.a -DCMAKE_EXE_LINKER_FLAGS='-static'
132"""
133compile = "make -C build -j\"$(nproc)\""
134install = "make -C build install DESTDIR=/out"