Sergio
c0a25cef22
Ayer estas dos huyeron a `compiler = "gcc"` para esquivar un crash del linker en los tres
`protoc-gen-upb*`. **Esquivé el fallo sin conocer su causa, y salió caro:** al mover sólo protobuf, el
link murió con `undefined reference to std::__1::basic_string<…>` —el `__1` de libc++— porque abseil
seguía en zig, así que hubo que arrastrar las dos fuera del toolchain por defecto.
La causa apareció al día siguiente en `dwarves`, bisecando la línea de enlace real:
tal cual → exit 139 (SIGSEGV)
quitando `-static` → exit 139 ⇒ no es el enlace estático
quitando `--dependency-file` → **exit 0** ⇒ ES ESO
El `lld` de zig 0.16.0 segfaultea con el `--dependency-file` que CMake ≥3.27 mete en la línea de
enlace. Con `-DCMAKE_LINK_DEPENDS_USE_LINKER=OFF` **los cuatro binarios de protobuf enlazan con zig**,
incluidos los tres plugins que se caían.
Esto es, además, la validación de la causa raíz en un proyecto INDEPENDIENTE de dwarves: dos
proyectos sin relación, mismo síntoma, misma perilla, los dos arreglados.
Con el escape se va también el `-static-libstdc++`, que sólo hacía falta porque g++ enlaza contra la
libstdc++ de GNU. Comprobado sobre el artefacto: el único NEEDED de `protoc` es `libc.so`, que provee
`musl-shared`.
Verificado de punta a punta, no por el código de salida: `protoc --version` → `libprotoc 36.1`, y un
`.proto` compila a `m.pb.h`/`m.pb.cc` **y** a `p/m.pb.go` pasando por `protoc-gen-go` — o sea que la
cadena plugin↔driver que abrí anteayer sigue entera. Las dos REPRODUCEN bit a bit.
Se deja escrito el camino completo en las recetas, diagnóstico corto incluido, porque la lección no
es la perilla: es que **un escape que funciona sin explicar el fallo se paga después**, y acá se pagó
con dos recetas fuera del toolchain por defecto y un choque de runtimes de C++ que sólo apareció
porque el escape era parcial.
94 lines
6.2 KiB
TOML
94 lines
6.2 KiB
TOML
# protobuf 36.1 — **`protoc`**, el compilador de `.proto`. Es el hueco que se ve solo al mirar el
|
|
# catálogo: `recipes/protoc-gen-go.toml` está SELLADO y es **inerte**, porque un plugin de protoc no
|
|
# hace nada sin protoc; y cualquier servicio gRPC necesita `protoc` en tiempo de build — empezando
|
|
# por `qdrant`, que el censo del servidor de origen encontró corriendo como binario suelto (de los
|
|
# que se pierden al apagar la máquina vieja) y cuyo `build.rs` lo invoca vía prost/tonic.
|
|
#
|
|
# **La dep de abseil no se vendoriza ni se descarga: se declara.** El tarball de release de protobuf
|
|
# NO trae abseil adentro (comprobado: cero entradas bajo `third_party/abseil-cpp/`), y su
|
|
# `cmake/abseil-cpp.cmake` tiene un fallback que hace `FetchContent` desde GitHub. Ese fallback en
|
|
# este lab es una trampa doble: el sandbox está OFFLINE, así que fallaría igual — pero fallaría
|
|
# hablando de red y no de dependencias — y si algún día no estuviera offline, metería una fuente sin
|
|
# pinear en un build que se supone reproducible. `protobuf_LOCAL_DEPENDENCIES_ONLY=ON` apaga el
|
|
# fallback ⇒ si abseil no está, el error dice *«Cannot find abseil-cpp dependency»*, que es lo que
|
|
# uno necesita leer. `recipes/abseil-cpp.toml` está pineada a la versión exacta que este protobuf
|
|
# declara.
|
|
#
|
|
# `-Dprotobuf_BUILD_TESTS=OFF`: la suite arrastra googletest, que es otra dep que no hace falta para
|
|
# producir un `protoc`. `-Dprotobuf_BUILD_SHARED_LIBS=OFF` deja `protoc` monolítico salvo por la libc.
|
|
#
|
|
# ⚠ **`compiler = "zig-cc"` Y `-static-libstdc++`: DOS MUROS, Y EL SEGUNDO ESCONDÍA AL PRIMERO.**
|
|
#
|
|
# 1. **`zig c++` SE CAE AL ENLAZAR los tres plugins `protoc-gen-upb*`** — `Error running link
|
|
# command: Segmentation fault`, no un error de símbolos. Se aisló FUERA de takana y fuera del
|
|
# sandbox: rehaciendo a mano el link de `protoc-gen-upb` con el `zig` del lab, sobre los mismos
|
|
# `.o` y las mismas `.a`, `zig c++` vuelve a segfaultear. No es presión de memoria (corrió solo) y
|
|
# no es el `-Wl,-rpath,::::::::::::::` que CMake emite —se probó sin él y cae igual—. Con `g++` y
|
|
# el `ld` de GNU los cuatro binarios enlazan. `protobuf_BUILD_LIBUPB=OFF` **no** es escapatoria:
|
|
# se probó, queda `OFF` en el `CMakeCache` y los plugins se construyen igual.
|
|
#
|
|
# 2. **abseil y protobuf TIENEN QUE COMPARTIR RUNTIME DE C++.** Al pasar sólo protobuf a `gcc`, con
|
|
# abseil todavía construida por `zig-cc`, el link murió con
|
|
# `undefined reference to std::__1::basic_string<…>::assign(char const*, unsigned long)`. El `__1`
|
|
# es el namespace inline de **libc++** (la que trae zig); g++ usa **libstdc++ de GNU**, con otro
|
|
# mangling para los mismos tipos. El error habla de `std::string` y no nombra a abseil ni una vez.
|
|
# Por eso `recipes/abseil-cpp.toml` también lleva `compiler = "gcc"`, y **cambiar una sin la otra
|
|
# vuelve a romper**.
|
|
#
|
|
# ⚠⚠ **ACTUALIZACIÓN 2026-09-12: LA CAUSA ERA OTRA, Y LA RECETA VOLVIÓ A `zig-cc`.** Lo de arriba
|
|
# describe lo que se midió el día 11 y sigue siendo cierto como SÍNTOMA, pero el diagnóstico se
|
|
# quedó corto: el crash no es «zig no puede con estos plugins». Apareció otra vez en `dwarves` y ahí
|
|
# se bisecó la línea de enlace real (`build/CMakeFiles/<target>.dir/link.txt`, rehecha a mano fuera
|
|
# del sandbox):
|
|
#
|
|
# tal cual → exit 139 (SIGSEGV)
|
|
# quitando `-static` → exit 139 ⇒ no es el enlace estático
|
|
# quitando `--dependency-file` → **exit 0** ⇒ ES ESO
|
|
#
|
|
# `-Xlinker --dependency-file=…` lo emite CMake ≥3.27 y el `lld` de zig 0.16.0 segfaultea
|
|
# procesándolo. Con `-DCMAKE_LINK_DEPENDS_USE_LINKER=OFF` los cuatro binarios enlazan con zig, así
|
|
# que **el escape a gcc sobra** — y con él se va también el `-static-libstdc++`, que sólo hacía falta
|
|
# porque g++ enlaza contra la libstdc++ de GNU. abseil vuelve a `zig-cc` en el mismo movimiento: el
|
|
# runtime de C++ de las dos tiene que coincidir, y eso no cambió.
|
|
#
|
|
# Se deja escrito el camino entero, con el diagnóstico corto incluido, porque la lección no es la
|
|
# perilla: es que **esquivar un fallo sin conocer su causa funciona y cuesta caro después** — dos
|
|
# recetas fuera del toolchain por defecto y un choque de runtimes de C++ que apareció sólo porque el
|
|
# escape era parcial.
|
|
#
|
|
# **Ya NO hace falta `-static-libstdc++`**: lo llevaba mientras la receta iba con `g++`, que enlaza
|
|
# contra la libstdc++ de GNU y habría dejado a `protoc` pidiendo `libstdc++.so.6`, una soname que
|
|
# sólo vive en el LAB ([[needed-colgante-libstdcxx]]). Con `zig-cc` la libc++ va estática de fábrica.
|
|
# Comprobado sobre el artefacto: el único NEEDED de `protoc` es `libc.so`, que provee `musl-shared`.
|
|
#
|
|
# Lo que sale, verificado corriéndolo y no por el código de salida: `protoc` (13,3 M) más los tres
|
|
# plugins de upb, y un `.proto` de prueba se compila a `.pb.h`/`.pb.cc` de verdad.
|
|
#
|
|
# `CMAKE_INSTALL_LIBDIR=lib` por lo de siempre: el lab usa `/usr/lib`, no `/usr/lib64`, o los `.pc` y
|
|
# los `.cmake` quedan donde ningún consumidor los busca.
|
|
#
|
|
# ⚠ **La versión de protobuf ES contrato de generación, no sólo de API.** `protoc` decide qué código
|
|
# emite, y el `.pb.cc`/`.pb.go` generado tiene que casar con la librería runtime que el consumidor
|
|
# enlace. Subirla no es actualizar una herramienta: es mover el formato de lo que sale.
|
|
name = "protobuf"
|
|
version = "36.1"
|
|
license = "BSD-3-Clause"
|
|
|
|
[source]
|
|
tarball = "https://github.com/protocolbuffers/protobuf/releases/download/v36.1/protobuf-36.1.tar.gz"
|
|
sha256 = "dc74fa582f559cbd31614ddfefb4868f43c919d7184bde514bb47f90c6025eb8"
|
|
|
|
[build]
|
|
compiler = "zig-cc"
|
|
target = "x86_64-linux-musl"
|
|
link = "dynamic"
|
|
flags = []
|
|
|
|
[build.phases]
|
|
configure = "cmake -S . -B build -DCMAKE_LINK_DEPENDS_USE_LINKER=OFF -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_STANDARD=17 -DBUILD_SHARED_LIBS=OFF -DCMAKE_POSITION_INDEPENDENT_CODE=ON -Dprotobuf_BUILD_TESTS=OFF -Dprotobuf_BUILD_SHARED_LIBS=OFF -Dprotobuf_LOCAL_DEPENDENCIES_ONLY=ON -Dprotobuf_ABSL_PROVIDER=package"
|
|
compile = 'cmake --build build -j"$(nproc)"'
|
|
install = "DESTDIR=/out cmake --install build"
|
|
|
|
[deps]
|
|
build = ["binutils", "busybox", "make", "cmake", "abseil-cpp", "zlib"]
|