# Waterfox 6.7.1.1 (Gecko 153.1.0) — el PRIMER FORK, y la prueba de la tesis del reúso. # # ══ QUÉ HEREDA, QUE ES CASI TODO ═══════════════════════════════════════════════════════════════ # Waterfox es un fork de Gecko con árbol completo propio, así que consume EXACTAMENTE la misma # plataforma que Firefox —gtk3, nodejs, clang18, cbindgen, y las variantes `-shared` del corpus— y # los MISMOS seis muros ya resueltos. Ninguno se vuelve a pagar: # 1. sin `--enable-linker` el sondeo de Mozilla no reconoce a zig (y con gcc ya no aplica). # 2. `compiler = "gcc"` `flags.configure` EXIGE un `NEEDED …libc++`; zig enlaza libc++ # estática para musl. Es negativa de upstream, no una perilla. # 3. `RUST_TARGET` contrato del parche `fix-rust-target` de Alpine, no un bug. # 4. checksums vendorizados cargo verifica cada fichero; los parches de musl los rompen. # 5. `strip_debug` sin él el artefacto se va a varios GB. # 6. hermético `--disable-bootstrap` + `MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE`. # **Las diferencias reales con `recipes/firefox.toml` son TRES: la fuente, el branding y la versión.** # Si aparece una cuarta, conviene preguntarse si no debería estar en las dos. # # ══ LA BASE ES 153.1.0 Y LOS PARCHES SON DE 154 ════════════════════════════════════════════════ # `config/milestone.txt` de este tag dice 153.1.0: una release POR DEBAJO de la de Firefox. Los once # parches de musl se reutilizan igual porque el código que tocan (LFS64, time64, prctl, el sandbox) # se mueve poco entre releases — pero es una apuesta explícita, no un hecho: si `patch` falla, falla # TEMPRANO, antes de compilar nada, y el arreglo es rebasar el parche que se queje. # # ══ ACÁ SÍ VA BRANDING OFICIAL, Y NO ES INCOHERENCIA ═══════════════════════════════════════════ # `recipes/firefox.toml` va con branding SIN MARCA a propósito, porque poner el nombre y el logo de # Firefox sobre un binario parcheado entra en la política de marcas de Mozilla (la historia de # Iceweasel). Acá es al revés: `browser/branding/official` es **la marca del propio Waterfox**, que # BrowserWorks distribuye en su árbol para que se construya así. Usar su branding es lo que quieren; # lo que no se puede es usar el de Mozilla. # ══ APARCADA 2026-09-05 — Y NO POR LOS PARCHES ═════════════════════════════════════════════════ # Primer intento en el worker: murió en CUATRO SEGUNDOS, no en las cuatro horas que temíamos, y por # algo que este comentario no preveía: # # FATAL ERROR PROCESSING MOZBUILD FILE /src/waterfox/browser/moz.build # The underlying problem is we referenced a path that does not exist. That path is: # /src/waterfox/browser/locales/moz.build # # O sea: los once parches de musl **sí agarraron** —la apuesta de reusar los de 154 sobre un árbol # 153.1.0 no es lo que falló— y lo que falta es un TROZO DEL ÁRBOL. `browser/locales` no está en el # clon. Sospechoso número uno: el `--filter=blob:none` + cómo BrowserWorks compone su repo (locales # como submódulo o generado), no la receta. # # Se aparca a propósito: la prioridad pasó a `firefox` con la cadena de optimización y a `atuq` # (SDD 26). Cuando se retome, el primer paso es mirar si `browser/locales` existe en el commit # pineado — un minuto de `git ls-tree`, no un build. # ══ ⚠ TRES COSAS MEDIDAS EN EL ARTEFACTO — SON DECISIÓN, NO BUG ═══════════════════════════════ # # 0) ⚠ SALE A LA RED AL ARRANCAR, SOLO. Visto CORRIENDO el artefacto (2026-09-08), no leyendo: # # [WaterfoxBlocker] Failed to update list: https://easylist.to/easylist/easylist.txt # [WaterfoxBlocker] Failed to update list: https://easylist.to/easylist/easyprivacy.txt # # Waterfox trae su propio bloqueador y **descarga sus listas al primer arranque, sin que nadie se # lo pida**. Acá falla porque el sandbox no tiene red; en una imagen real sería una conexión no # solicitada. Esta distro apagó la telemetría de firefox exactamente por esto, así que la # coherencia pide decidirlo — no apagarlo de paso. Ninguna inspección estática lo habría mostrado. # # Del `application.ini` del artefacto `b3:e65c0221` (2026-09-06), leído del sellado, no de la doc: # # Vendor=BrowserWorks Name=Firefox RemotingName=firefox-default # Profile=Waterfox ID={ec8030f7-c20a-464f-9b0e-13a3a9e97384} # # 1) EL BRANDING «OFICIAL» DE ESTE COMMIT ES EL DE MOZILLA, NO EL DE WATERFOX. El comentario de # más abajo dice que `browser/branding/official` es «la marca del propio Waterfox»; en ESTE # commit no lo es. Comprobado en el árbol: `branding/official/configure.sh` pone # `MOZ_APP_DISPLAYNAME=Firefox`, y `brand.ftl` da `-brand-short-name = Firefox` y # `-brand-full-name = Mozilla Firefox`. El `ID` es además el ID canónico de Firefox. O sea que # hoy esto sella un binario parcheado que se presenta como «Mozilla Firefox» — justo lo que # `firefox.toml` evita a propósito yendo SIN marca (la historia de Iceweasel). La salida # probable es `unofficial`, pero es una decisión de política de marcas, no una perilla técnica, # y por eso se deja escrita en vez de cambiada. # # 2) ✅ RESUELTA 2026-09-08 — la colisión de rutas con `firefox`. El artefacto instalaba en # `usr/lib/firefox/` y `usr/bin/firefox`, las MISMAS rutas que la receta `firefox`. Se renombra # a `waterfox` en el install y se le pone lanzador: ver el bloque del install para por qué # renombrar es seguro (Firefox es reubicable) y por qué NO se tocó `MOZ_APP_NAME` (arrastra el # branding, que es la decisión 1, aún abierta). Verificado corriéndolo: arranca y renderiza. # name = "waterfox" version = "6.7.1.1" license = "MPL-2.0" [source] # Por COMMIT y no por el `tarball_url` de GitHub: ése es un `/archive/`-style que la forja genera al # vuelo y cuyo sha256 cambia (ADR 0006). El tag `6.7.1.1` es LIGERO —una sola ref en `ls-remote`, sin # `^{}`— ⇒ este sha ES el commit. takana clona con `--filter=blob:none`, así que un árbol Gecko # entero no trae la historia: sólo los blobs de este commit. repo = "https://github.com/BrowserWorks/Waterfox.git" commit = "fd6662f3abfe6161e88b1b9cb4c70a963bdb345a" # Los once de musl del APKBUILD de Alpine (community/firefox). NO se traen los suyos de ppc64le, # loongarch ni Android: no aplican a x86_64 y cada parche que no hace falta es una forma más de que # un rebase falle sin motivo. patches = [ "firefox-patches/lfs64.patch", "firefox-patches/time64.patch", "firefox-patches/musl-no-linux-prctl.patch", "firefox-patches/fix-fortify-system-wrappers.patch", "firefox-patches/fix-rust-target.patch", "firefox-patches/sandbox-sched_setscheduler.patch", "firefox-patches/abseil-cpp.patch", "firefox-patches/glean-stub.patch", "firefox-patches/rust-lto-thin.patch", "firefox-patches/wasip1.patch", "firefox-patches/widevine.patch", # PROPIO de waterfox, no heredado de firefox: su `branding-common.mozbuild` instala cinco iconos # y su `package-manifest.in` exige ocho. Los tres que faltan (22, 24, 256) están en el árbol; lo # que falta es la línea que los instala. Rotura sólo de Linux — ver la cabecera del parche. "waterfox-patches/branding-icons-gtk.patch", ] [build] # ══ `gcc` Y NO `zig-cc` — TRES MUROS DE UNA VEZ ════════════════════════════════════════════════ # El resto del corpus va con zig-cc y esta receta es una EXCEPCIÓN consciente, del mismo tipo que la # que el repo ya mantiene para el kernel y cmake (ADR 0011). Se llegó acá por eliminación, no por # comodidad — con zig-cc el configure de Firefox murió tres veces seguidas: # # 1. «Could not use lld as linker» — zig se identifica como `zig ld 0.16.0` y el sondeo de Mozilla # clasifica por esa cadena buscando «LLD»/«GNU ld»/«GNU gold». # 2. «Cannot find ar» — zig trae `ar` como SUBCOMANDO y `check_prog` busca un ejecutable. # 3. **«Firefox does not support linking statically with libstdc++»** — y éste no es un flag: # `flags.configure:79` compila un C++ mínimo, lo pasa por `llvm-objdump --private-headers` y # exige encontrar un `NEEDED …libc++`. zig enlaza libc++ ESTÁTICA para musl, así que ese NEEDED # no existe nunca. No hay perilla que apagar; es una negativa de upstream. # # El gcc del lab (15.2.0, con `libstdc++` COMPARTIDA) satisface los tres: `NEEDED libstdc++.so.6`, # un `ar` de verdad y un linker que se anuncia como «GNU ld». # # ⚠ EL PRECIO, ESCRITO: **el lab NO entra en `hash_inputs`**, así que un Firefox construido con el # gcc del lab queda más expuesto a la deriva del rootfs que uno con zig-cc — dos labs con gcc # distinto pueden sellar bytes distintos sin que el store lo note. Es la misma deuda que ya cargan el # kernel y las otras recetas `compiler=gcc`, y la razón por la que conviene no ampliar esta lista sin # haber agotado antes el camino de zig. compiler = "gcc" target = "x86_64-linux-musl" link = "dynamic" flags = [] # ══ `strip_debug`: SIN ESTO EL ARTEFACTO SERÍA INMANEJABLE ═════════════════════════════════════ # Medido en el `nodejs` que acaba de sellar sin strip: su binario pesa **984 MB, de los cuales # `.debug_info` son 497 MB y `.debug_line` otros 43** — más de la mitad del artefacto es información # de depuración. Firefox es varias veces V8, así que sin strip su artefacto entraría en varios GB, y # el store no es sólo disco: se sincroniza hub↔worker y se respalda. # # Es además el hallazgo del SDD 23: el 79% del contenido binario del store era `.debug_*`, y quitarlo # hace que artefactos que no reproducían PASEN a reproducir, porque lo que difería eran las rutas del # árbol de build embebidas en esas secciones. # # Entra en `hash_inputs` A PROPÓSITO (cambia el contenido del artefacto), y usa `zig objcopy`, que # siempre está en el sandbox ⇒ no agrega una dep de build. strip_debug = true [build.phases] configure = ''' export MOZBUILD_STATE_PATH="$PWD/.mozbuild" export MOZ_BUILD_DATE="$(date -u -d "@${SOURCE_DATE_EPOCH:-1}" +%Y%m%d%H%M%S)" # ver el guardián del install export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system export MOZ_NOSPAM=1 # ── RUST_TARGET: lo EXIGE el parche de Alpine, no Firefox ───────────────────────────────────── # `fix-rust-target.patch` REEMPLAZA la autodetección del triple de Rust por un # `os.environ['RUST_TARGET']` pelado. Sin la variable, configure muere con # `KeyError: 'RUST_TARGET'` — que se lee como un bug de Firefox y es en realidad el contrato del # parche: el APKBUILD de Alpine lo exporta como `$CTARGET` y acá hay que hacer lo propio. # El valor NO se adivina: sale de `ls .dev-fs/alpine/usr/lib/rustlib/` en el lab, que es # `x86_64-alpine-linux-musl` — el rustc del sandbox es el de Alpine, no el del host (el del host es # `x86_64-unknown-linux-gnu` y usarlo produciría un cross-compile silencioso). export RUST_TARGET=x86_64-alpine-linux-musl # ── LOS PARCHES ROMPEN EL CHECKSUM DE LOS CRATES VENDORIZADOS ───────────────────────────────── # `error: the listed checksum of third_party/rust/zeitstempel/src/unix.rs has changed`. Los crates # de Rust vienen VENDORIZADOS en el tarball y cargo verifica el sha de CADA fichero contra # `.cargo-checksum.json`; en cuanto un parche de musl toca uno, el build muere. Cargo no ofrece # ninguna forma de recalcularlo, así que la salida —la misma del APKBUILD de Alpine— es vaciar la # lista de ficheros del manifiesto, dejando el checksum del paquete. # # Son los CINCO crates que tocan los parches, no uno: el error los va destapando de a uno y buscarlos # por prueba y error costaría cinco vueltas de configure. for c in audio_thread_priority cc zeitstempel wgpu-hal alsa; do f="third_party/rust/$c/.cargo-checksum.json" [ -f "$f" ] || { echo "FALTA $f — ¿upstream movió el crate?" >&2; exit 1; } sed -i 's/\("files":{\)[^}]*/\1/' "$f" done cat > .mozconfig <<'MOZ' ac_add_options --prefix=/usr ac_add_options --enable-application=browser ac_add_options --enable-default-toolkit=cairo-gtk3-wayland ac_add_options --enable-release ac_add_options --enable-optimize ac_add_options --enable-hardening ac_add_options --enable-official-branding ac_add_options --with-libclang-path=/usr/lib ac_add_options --disable-bootstrap ac_add_options --disable-jemalloc ac_add_options --disable-crashreporter ac_add_options --disable-updater ac_add_options --disable-tests ac_add_options --disable-debug ac_add_options --disable-debug-symbols ac_add_options --disable-strip ac_add_options --disable-install-strip ac_add_options --disable-cargo-incremental ac_add_options --without-wasm-sandboxed-libraries ac_add_options --enable-alsa ac_add_options --enable-pulseaudio ac_add_options --enable-dbus ac_add_options --enable-ffmpeg mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir MOZ ./mach configure ''' # `mach build` respeta -jN; la cuenta es la misma que en nodejs.toml y por el mismo motivo: un número # fijo ataría el ArtifactHash a la RAM de quien escribió la receta. # ⚠ OJO con el techo: dentro del sandbox `/proc/meminfo` NO muestra la memoria del contenedor sino la # del host (medido en el LXC: 186 GiB en vez de 16), así que en un contenedor esta cuenta se degrada # a `nproc`. Es un tope, no una garantía. compile = ''' export RUST_TARGET=x86_64-alpine-linux-musl # ver la nota en la fase configure export MOZBUILD_STATE_PATH="$PWD/.mozbuild" export MOZ_BUILD_DATE="$(date -u -d "@${SOURCE_DATE_EPOCH:-1}" +%Y%m%d%H%M%S)" # ver el guardián del install export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system export MOZ_NOSPAM=1 gib=$(awk "/MemTotal/{printf \"%d\", \$2/1024/1024}" /proc/meminfo) j=$(( gib / 3 )); [ "$j" -lt 1 ] && j=1 n=$(nproc); [ "$j" -gt "$n" ] && j=$n echo "mach build -j$j (MemTotal ${gib} GiB, nproc $n)" ./mach build -j"$j" && exit 0 # ── EL ENLACE FALLA Y `mach` SE TRAGA EL MENSAJE DEL LINKER ─────────────────────────────────── # Medido dos veces (2026-09-06, 03:20 y 04:08): el build llega al minuto ~36 y muere enlazando # `libxul.so` con # # E collect2: error: ld returned 1 exit status # # y NADA delante. Entre la línea que anuncia el enlace y el `collect2` no hay ni un renglón en el # log, ni `undefined reference`, ni `cannot find -l`, ni `DSO missing`. No es OOM (13 G libres, swap # sin tocar) ni disco (37%). El filtro de salida de `mach` clasifica y descarta, y lo que descarta es # justo el diagnóstico. # # Así que si `mach` falla se REHACE el mismo objetivo llamando a gmake directo, sin el filtro de por # medio, y se deja hablar al linker. No cambia lo que se construye: es el mismo target sobre el mismo # objdir, sólo que sin nadie tapándole la boca. Si el enlace ahora pasa (porque el fallo fuera del # propio `mach`), igual salimos con error: esta rama existe para diagnosticar, no para aprobar. echo "=== mach falló; rehago el enlace SIN su filtro para ver qué dice ld ===" gmake -C objdir/toolkit/library/build V=1 2>&1 | tail -60 echo "=== fin del reintento ===" exit 1 ''' install = ''' export RUST_TARGET=x86_64-alpine-linux-musl # ver la nota en la fase configure export MOZBUILD_STATE_PATH="$PWD/.mozbuild" export MOZ_BUILD_DATE="$(date -u -d "@${SOURCE_DATE_EPOCH:-1}" +%Y%m%d%H%M%S)" # ver el guardián del install export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system DESTDIR=/out ./mach install # ── RENOMBRAR A `waterfox`: RESUELVE LA COLISIÓN **Y** EL ARRANQUE ──────────────────────────── # `mach install` deja el árbol en `usr/lib/firefox` y un symlink `usr/bin/firefox`, o sea LAS # MISMAS RUTAS que la receta `firefox`. Hasta hoy no rompía nada porque ninguna imagen lleva las # dos, pero es una colisión esperando: overlayfs fusiona y gana una en silencio. # # Se renombra en vez de tocar `MOZ_APP_NAME` porque **Firefox es REUBICABLE**: localiza `omni.ja` y # compañía relativo a su propio binario, que es lo que hace que sus tarballs funcionen desde # cualquier directorio. Mover el árbol entero es seguro; cambiar `MOZ_APP_NAME` exigiría tocar # `confvars.sh` del árbol y arrastra el branding, que es la decisión que esta receta deja abierta # más arriba y que no se toma de paso. mv /out/usr/lib/firefox /out/usr/lib/waterfox rm -f /out/usr/bin/firefox # ── EL LANZADOR: SIN ESTO EL ARTEFACTO NO ARRANCA ──────────────────────────────────────────── # Mismo fallo que tenía `firefox` hasta el 2026-09-07 y que se midió sobre el sellado: el binario # NO trae `RUNPATH` (verificado: 0 entradas) y el cierre no publica `ld-musl-x86_64.path`, así que # las librerías que viven JUNTO al binario —`libnspr4.so`, `libmozsandbox.so`— no las encuentra # nadie y muere con «Couldn't load XPCOM». El `LD_LIBRARY_PATH` es además lo que necesitan los # procesos HIJOS: el navegador lanza uno por pestaña. cat > /out/usr/bin/waterfox <<'LANZA' #!/bin/sh LD_LIBRARY_PATH="/usr/lib/waterfox${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}" export LD_LIBRARY_PATH exec /usr/lib/waterfox/waterfox "$@" LANZA chmod 755 /out/usr/bin/waterfox # El binario interno se llama `firefox` (viene del MOZ_APP_NAME del árbol, que no se toca): se le # pone un nombre propio al lado para que el lanzador no mienta sobre a qué apunta. [ -f /out/usr/lib/waterfox/waterfox ] || ln -s firefox /out/usr/lib/waterfox/waterfox # ── GUARDIÁN: QUE EL BuildID NO SEA UNA FECHA ──────────────────────────────────────────────── # Copiado de `firefox.toml`, y no por simetría: SIN ESTO YA SELLÓ MAL. El artefacto # `b3:e65c0221` del 2026-09-06 salió con `BuildID=20260906062042` —la hora del build— o sea que # NO REPRODUCE. Y selló en VERDE: el ArtifactHash es input-addressed y no se mueve por esto, así # que `build-state.json` lo contaba como bueno. Es exactamente el modo de fallo que el comentario # de firefox describe, ocurriendo en la receta de al lado por no haber copiado las cuatro líneas. esperado="$(date -u -d "@${SOURCE_DATE_EPOCH:-1}" +%Y%m%d%H%M%S)" real="$(sed -n 's/^BuildID=//p' /out/usr/lib/waterfox/application.ini)" if [ "$real" != "$esperado" ]; then echo "guardián: BuildID=$real y esperaba $esperado — el artefacto NO reproduce." >&2 echo " Revisá que MOZ_BUILD_DATE se exporte en TODAS las fases." >&2 exit 1 fi echo "guardián: BuildID = $real (determinista, de SOURCE_DATE_EPOCH)" # ── GUARDIÁN: NI UNA RUTA `firefox` EN EL ARTEFACTO ────────────────────────────────────────── # Si `mach install` cambia de layout y algo vuelve a aterrizar en `usr/lib/firefox`, la colisión # regresa en silencio: dos artefactos distintos publicando el mismo fichero, y en la imagen gana # uno sin que nada lo diga. test ! -e /out/usr/lib/firefox && test ! -e /out/usr/bin/firefox || { echo "!! quedaron rutas 'firefox' en el artefacto — colisiona con la receta firefox" >&2 ls -la /out/usr/lib /out/usr/bin >&2; exit 1; } test -x /out/usr/bin/waterfox || { echo "!! no se creó el lanzador" >&2; exit 1; } echo "guardián: instalado como waterfox, sin rutas 'firefox' que colisionen" ''' [deps] # ⚠ DEP DE EJECUCIÓN, NO DE BUILD — Y NO ES DECORACIÓN (2026-09-06). # Este artefacto declara `NEEDED libstdc++.so.6` / `libgcc_s.so.1`, y hasta hoy NADIE en el corpus # las proveía: sólo existían en `.dev-fs/alpine`, o sea en el LAB. El binario sellaba, REPRODUCÍA # bit a bit, pasaba todos los guardianes… y no arrancaba fuera del lab. Se descubrió corriendo # `atuq` bajo un sway headless, no leyendo el grafo. # `runtime` NO entra en el ArtifactHash (igual que `license`), así que declararlo NO re-hashea: # lo que cambia es la CLAUSURA, que es lo que se hidrata en la imagen. Lo vigila # `scripts/vigia-sonames.py`, que corre en el latido y deja `docs/state/sonames.txt`. runtime = ["gcc-libs"] build = [ "python3", "pkgconf", "nasm", "make", "cmake", # la plataforma Gecko, compartida con Waterfox y Zen "nodejs", "cbindgen", "clang18", "llvm18", # ⚠ LAS VARIANTES `-shared`, Y NO ES SIMETRÍA CON FIREFOX: ES EL FALLO QUE MATABA EL ENLACE. # Con las estáticas, `libcairo.a` entra al enlace de `libxul.so` por el `-lcairo` que arrastra el # `.pc` de gtk3, y sus objetos CHOCAN con el cairo BUNDLEADO del propio árbol de Gecko: # # ld: /usr/lib/libcairo.a(cairo-ft-font.c.o): multiple definition of `_cairo_ft_to_cairo_error'; # gfx/cairo/cairo/src/cairo-ft-font.o: first defined here # # …y así decenas de símbolos. Con la variante compartida, `-lcairo` resuelve a `libcairo.so` y los # símbolos bundleados se quedan donde tienen que quedarse. Las cuatro van juntas por lo que ya # dice `firefox.toml`: declarar las ESTÁTICAS junto a un `gtk3` que trae las compartidas son dos # artefactos peleando por el mismo `.pc`. Van las dos listas al mismo sitio o ninguna. "gtk3", "atk", "gdk-pixbuf-shared", "pango-shared", "cairo-shared", "libepoxy", "glib-shared", "pcre2-shared", "libffi-shared", "zlib-shared", "harfbuzz-shared", "fribidi", "freetype-shared", "fontconfig-shared", "pixman", "libpng-shared", "libjpeg-turbo-shared", "wayland", "wayland-protocols", "libxkbcommon", "mesa", "libdrm", "dbus", "pipewire", "pulseaudio", "alsa-lib", "libxml2-shared", "linux-headers", ]