id pattern cause fix rule source lsocket-symbol-referencing (^|[^-=\w])undefined (symbol|reference)?[^\n]*\b(__xnet_)?(socket|connect|getaddrinfo|freeaddrinfo|gai_strerror|gethostbyname)\b|^\s*(__xnet_)?(socket|connect|getaddrinfo|freeaddrinfo|gai_strerror|gethostbyname)\s+\S+\.(o|so[.0-9]*|a)\s*$ illumos keeps socket(), connect(), getaddrinfo(), freeaddrinfo() and gai_strerror() in libsocket, and gethostbyname() in libnsl, not in libc, so a Linux link line leaves them undefined. The illumos link editor lists each one on its own row under an "Undefined first referenced symbol in file" header. Link -lsocket -lnsl: in a recipe ./configure LIBS="-lsocket -lnsl"; upstream, add the check to configure.ac (AX_LIB_SOCKET_NSL). Check with elfdump -d | grep libsocket. link-lsocket-lnsl.md [rule link-lsocket-lnsl](https://solnix.io/skills/solnix/rules/link-lsocket-lnsl.md); [docs/aarch64-native-openssl-fix.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/aarch64-native-openssl-fix.md) (solnix 5a8e5ce), Exact failure (the Undefined / first referenced table) cannot-find-lsocket-lnsl cannot find -l(socket|nsl)\b The linker searched for libsocket or libnsl and did not find it. In a SPARCv9 cross build of bash, man2html (a CC_FOR_BUILD host tool) got the target's -lnsl in LIBS_FOR_BUILD, and the host linker has no such library. For a host-side tool, link it without the target's libraries (bash: man2html built host-side with empty LIBS). [docs/progress.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/progress.md) (solnix 5a8e5ce), SPARCv9 cross wave 7, bash -fno-common (man2html leaked target -lnsl into LIBS_FOR_BUILD: host ld "cannot find -lnsl") lsendfile-not-found library -lsendfile: not found|^\s*sendfilev?\s+\S+\.(o|so[.0-9]*|a)\s*$ sendfile() is in libsendfile, not libc, on illumos; a link without -lsendfile leaves it undefined, and "library -lsendfile: not found" meant the platform -L/lib/amd64 was missing from the link line. Add -lsendfile (in a recipe overlay: NIX_LDFLAGS = (o.NIX_LDFLAGS or "") + " -lsendfile";) and make sure -L/lib/amd64 is on the link line. api-sendfile-proc-pthreads-libc.md [rule api-sendfile-proc-pthreads-libc](https://solnix.io/skills/solnix/rules/api-sendfile-proc-pthreads-libc.md) version-script-unrecognized unrecognized option '?-?-version-script The illumos link editor does not take GNU --version-script. Drop the --version-script flag from the link when nothing needs the version names (what the build team's shims do), or rewrite the script as a version 2 mapfile and link with -Wl,-M,mapfile-vers. link-mapfiles-and-lari.md [rule link-mapfiles-and-lari](https://solnix.io/skills/solnix/rules/link-mapfiles-and-lari.md) patchelf-127 patchelf[^\n]*(not found|exited 127|command not found)|addDriverRunpath[^\n]*127 patchelf does not work on illumos: a setup hook or build step that calls it exits 127 (the addDriverRunpath setup hook did). Drop the hook or step that calls patchelf in the recipe; set the runpath at link time with -Wl,-R, instead, and inspect with elfdump -d and elfedit. link-runpath-origin.md [rule link-runpath-origin](https://solnix.io/skills/solnix/rules/link-runpath-origin.md); [docs/design-desktop-and-local-ai.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/design-desktop-and-local-ai.md) (solnix 5a8e5ce), drop addDriverRunpath (its patchelf setup-hook is 127 on illumos) ldso-open-failed ld\.so\.1: [^\n]*: fatal: [^\n]*: open failed The runtime linker found no file for a NEEDED library in the directories it searched. One cause in Solnix builds: the object's RUNPATH does not name the library's directory (a mk-src-pkg dependency installed to lib/ when the RUNPATH names lib/amd64). Check with elfdump -d (NEEDED, RUNPATH) and env -i /usr/bin/ldd: each NEEDED must map to /nix/store. If the RUNPATH misses the directory, link with -Wl,-R,/lib (mk-src-pkg adds lib/amd64; a dependency that installs to lib/ needs -Wl,-R,/lib). Do not set LD_LIBRARY_PATH or crle. link-runpath-origin.md [rule link-runpath-origin](https://solnix.io/skills/solnix/rules/link-runpath-origin.md); [docs/llvm-illumos.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/llvm-illumos.md) (solnix 5a8e5ce), Build hosts (libLLVM.so.23.1: open failed) gcc14-implicit-declaration error: [^\n]*\[-W(implicit-function-declaration|implicit-int|int-conversion|incompatible-pointer-types|return-mismatch|declaration-missing-parameter-type)\] gcc 14 makes these diagnostics errors. In a source file the build stops; inside configure a probe fails the same way, and configure may then silently drop a feature or pick the wrong branch. In a source file: fix the code as Porting to GCC 14 says for that diagnostic (for an implicit function declaration, include the header that declares it). If the line came from a configure probe (config.log), configure again with CC="gcc -fpermissive" and diff config.h against the first run, then fix the cause in the recipe (the header or feature macro, or pin the cache variable) and add a build check. build-gcc14-implicit-declarations.md [rule build-gcc14-implicit-declarations](https://solnix.io/skills/solnix/rules/build-gcc14-implicit-declarations.md); [Porting to GCC 14](https://gcc.gnu.org/gcc-14/porting_to.html) Certain warnings are now errors (each diagnostic's section) endian-probe-big checking endianness\.\.\. big|WORDS_BIGENDIAN=1 On x86_64-solaris and aarch64-solaris the endianness probe's test program failed to build (BYTE_ORDER is in , not , and gcc 14 rejects the run test's exit() without ), and the probe read the failure as big endian. Choose the order from the target in the recipe: ac_cv_c_bigendian=no (tcl), gnupg_cv_c_endian=little (gnupg) on x86_64 and aarch64; add a build check that fails on a wrong order (gnupg's t-rmd160, tcl's puts [expr {0.1}]). build-endianness-probe-trap.md [rule build-endianness-probe-trap](https://solnix.io/skills/solnix/rules/build-endianness-probe-trap.md) endian-no-endianness-found No endianness found gnupg built with --disable-endian-check: config.h then falls back to __LITTLE_ENDIAN__, which illumos gcc 14 does not define, so the build stops at this #error. Do not pass --disable-endian-check; pin the order instead (gnupg_cv_c_endian=little on x86_64 and aarch64). build-endianness-probe-trap.md [rule build-endianness-probe-trap](https://solnix.io/skills/solnix/rules/build-endianness-probe-trap.md); [handoff: from-builder-20261104T173111-gnupg-uid-hash-rows/README.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261104T173111-gnupg-uid-hash-rows/README.md) config-guess-unknown cannot guess build type An old bundled config.guess or config.sub does not know *-solaris2.11. Pass the triple to configure in the recipe's build step: --build=x86_64-pc-solaris2.11 --host=x86_64-pc-solaris2.11 on x86_64, --build=aarch64-unknown-solaris2.11 on aarch64. build-autotools-cmake-meson.md [rule build-autotools-cmake-meson](https://solnix.io/skills/solnix/rules/build-autotools-cmake-meson.md); [docs/aarch64-dixa-qemu-pg-buildfarm.md](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/docs/aarch64-dixa-qemu-pg-buildfarm.md) (solnix 5a8e5ce), ./configure --build=aarch64-unknown-solaris2.11 unsupported-platform-error #\s*error[^\n]*(Unsupported|unknown|not supported)[^\n]*\b(platform|OS|operating system)\b The source has no branch for illumos, so it reaches its #error. Add __sun arms to the source (and check that the branch they take is right: libdrm's __sun took the BSD branch with wrong ioctl numbers). build-autotools-cmake-meson.md [rule build-autotools-cmake-meson](https://solnix.io/skills/solnix/rules/build-autotools-cmake-meson.md) kqueue-missing sys/event\.h: No such file illumos has no kqueue (entr needs sys/event.h, BSD-only), so a kqueue-only backend does not build. Build the project's epoll or event-ports backend, or write an event-ports one (port_create, port_associate, port_get); see the rule for the re-association trap. api-event-ports-vs-epoll.md [rule api-event-ports-vs-epoll](https://solnix.io/skills/solnix/rules/api-event-ports-vs-epoll.md) wrong-elf-class ld\.so\.1: [^\n]*wrong ELF class: ELFCLASS64 At run time (ld.so.1): a 64-bit-only library preloaded with plain LD_PRELOAD breaks the 32-bit base tools. Do not export a 64-bit-only library in plain LD_PRELOAD in a login profile (PS-3 measured that it breaks the 32-bit base tools); preload it only for the 64-bit program you debug (see the rule). debug-libumem-leaks.md [rule debug-libumem-leaks](https://solnix.io/skills/solnix/rules/debug-libumem-leaks.md) shebang-outside-store FAIL B9\b[^\n]*#!|#!\s*/usr/xpg4/bin/sh Publish gate check B9 fails an executable whose #! names a path outside the store other than /bin/sh, /usr/bin/sh or /usr/bin/env (xz and libgpg-error hardcode #!/usr/xpg4/bin/sh on solaris*). Fix the #! in the recipe so it names /bin/sh, /usr/bin/sh, /usr/bin/env or a store path (the aarch64 xz and libgpg-error recipes were fixed this way). shell-xpg4-vs-gnu.md [rule shell-xpg4-vs-gnu](https://solnix.io/skills/solnix/rules/shell-xpg4-vs-gnu.md) gate-runpath-not-store FAIL runpath: .*DT_RUNPATH entry .* is not under /nix/store solnix.io's publish gate refuses an ELF whose RUNPATH names a directory that is not under /nix/store or $ORIGIN. Link with store RUNPATHs only (-Wl,-R,/lib; no -R/usr/lib/amd64). A changed recipe builds a new out: ask for its row (the cache takes only an out the served recipes.tsv lists), then submit that out. link-runpath-origin.md [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) Example rejections; [rule link-runpath-origin](https://solnix.io/skills/solnix/rules/link-runpath-origin.md); [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) submitted StorePath is not a known recipes.tsv out; [rule recipe-write-a-solnix-recipe](https://solnix.io/skills/solnix/rules/recipe-write-a-solnix-recipe.md) gate-build-host-string FAIL build-host: The publish gate found a build host's name in the NAR (here /BUILDINFO naming an EC2 host). A NAR in the cache must not contain the hostname, DNS domain or username of the build host. Pin those facts to fixed neutral values in the recipe, as nixpkgs does for perl. A changed recipe builds a new out: ask for its row (the cache takes only an out the served recipes.tsv lists), then submit that out. [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) Example rejections; [handoff: 20261031-policy-no-build-host-pii-perl-rebuild-prune.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261031-policy-no-build-host-pii-perl-rebuild-prune.md) The policy; [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) submitted StorePath is not a known recipes.tsv out; [rule recipe-write-a-solnix-recipe](https://solnix.io/skills/solnix/rules/recipe-write-a-solnix-recipe.md) submit-not-recipes-out submitted StorePath is not a known recipes\.tsv out solnix.io accepts a submission only for an out the served recipes.tsv lists. Ask for the row first (a recipe row for that out, served by infra), then submit the out it names. recipe-write-a-solnix-recipe.md [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) Example rejections; [rule recipe-write-a-solnix-recipe](https://solnix.io/skills/solnix/rules/recipe-write-a-solnix-recipe.md) gate-b7-not-executable FAIL B7-exec Gate check B7: a regular file directly in bin/ or sbin/ without the executable flag. libtool 2.5.4's bin/libtool was 0444 because the build-tool de-bake in mk-src-pkg (sed ... > f.btfix && mv) dropped the mode. Rewrite the file in place so its mode is kept (as mk-src-pkg's aarch64 path does: sed ... > "$W/btfix" && cat "$W/btfix" > "$f"; the build team fixed it for x86_64 in wave6). A changed recipe builds a new out: ask for its row (the cache takes only an out the served recipes.tsv lists), then submit that out. [handoff: 20261103-content-gate-b6-b7-b13.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-content-gate-b6-b7-b13.md) B7; [handoff: from-builder-20261102T162123-reply-toolchain-trials.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261102T162123-reply-toolchain-trials.md) libtool 0444; [pkgs/illumos/mk-src-pkg.nix](https://codeberg.org/solnix/solnix/src/commit/5a8e5ce75a33086d7be4410149847bdf7501b8fc/pkgs/illumos/mk-src-pkg.nix) (solnix 5a8e5ce), the build-tool de-bake; [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) submitted StorePath is not a known recipes.tsv out; [rule recipe-write-a-solnix-recipe](https://solnix.io/skills/solnix/rules/recipe-write-a-solnix-recipe.md) gate-b17-man-stub unable to create a proper manual page|Creating a stub man page instead|help2man stub man page A man page that is a help2man "OOPS" stub. In gnused 4.9 the page is regenerated in every build; with no perl on the build PATH (checking for perl... no) configure picks doc/dummy-man, which finds the shipped page removed and writes the stub. The build team's gate check B17-man-stub fails it. Put perl on the build PATH in the recipe (the gnused fix, wave6 bd14fc7), so the real page is generated. [handoff: from-builder-20261105T012731-gnused-real-man-page-rows/README.md](https://codeberg.org/solnix/solnix-infra/src/commit/807157bf3453500cc1b383643513239455e27ca7/docs/handoff/from-builder-20261105T012731-gnused-real-man-page-rows/README.md) The bug; Our side, so it doesn't come back; [handoff: 20261104-help2man-oops-stub-pages.md](https://codeberg.org/solnix/solnix-infra/src/commit/807157bf3453500cc1b383643513239455e27ca7/docs/handoff/20261104-help2man-oops-stub-pages.md) cmake-found-host-zlib Found ZLIB: /usr/lib/libz\.so CMake found the host's zlib in /usr/lib, outside the store. mk-src-pkg exports CMAKE_PREFIX_PATH joined with ;, which cmake splits on : as an environment variable, so the list names no directory and find_package falls through to /usr (libgit2 1.7.2 on aarch64). Name the store library explicitly in the recipe (libgit2: ZLIB_INCLUDE_DIR and ZLIB_LIBRARY) and add CMAKE_IGNORE_PREFIX_PATH=/;/usr;/usr/local;/opt; fail the build if CMakeCache.txt has a found path under /usr, /lib or /opt. [handoff: from-builder-20261104T013637-a64s-b1-aarch64-nix-libgit2/README.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261104T013637-a64s-b1-aarch64-nix-libgit2/README.md) The fix; [handoff: from-builder-20261103T170201-hosts-publishing-addendum.md](https://codeberg.org/solnix/solnix-infra/src/commit/807157bf3453500cc1b383643513239455e27ca7/docs/handoff/from-builder-20261103T170201-hosts-publishing-addendum.md) One a64h out refused by our gate stale-nixbld-build-dir cannot remove '/var/tmp/(srcpkg|cargo|go|rust|gccsrc)-[0-9a-f]+': Permission denied A build that ran as another nixbld user left its fixed build dir (here /var/tmp/srcpkg-, mode 0700; the drv-keyed kinds are srcpkg, cargo, go, rust and gccsrc) behind, and the next build of the same drv, as a different nixbld user, cannot remove it. Move the stale dir aside (no process of its owner running), then rebuild. The build team's builder fix treats this message as a host problem and retries (in current main). [handoff: from-builder-20261105T004841-reply-openssl-cleared.md](https://codeberg.org/solnix/solnix-infra/src/commit/807157bf3453500cc1b383643513239455e27ca7/docs/handoff/from-builder-20261105T004841-reply-openssl-cleared.md) The cause (reproduced); The builder bug; [handoff: 20261105-maintainer-decisions-lixu-B-window-b2.md](https://codeberg.org/solnix/solnix-infra/src/commit/807157bf3453500cc1b383643513239455e27ca7/docs/handoff/20261105-maintainer-decisions-lixu-B-window-b2.md) 3 (current main has the stale-dir fix); [handoff: from-builder-20261103T035251-gate2-client-checks.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261103T035251-gate2-client-checks.md) B8 (the drv-keyed /var/tmp/{srcpkg,cargo,go,rust,gccsrc}-<16 hex>) gate-b8-build-dir FAIL B8 Gate check B8: a host- or run-specific build directory string in the output (/tmp/nix-build-*, a mktemp-suffixed /var/tmp/-, a build account's home); cargo bin/* from atuin, bat, dua, eza and uv had /tmp/nix-build-*. Remap the build path in the recipe so the output names the prefix-mapped /build/ (only INFO) instead. A changed recipe builds a new out: ask for its row (the cache takes only an out the served recipes.tsv lists), then submit that out. [handoff: 20261104-content-gate-b8-b16.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261104-content-gate-b8-b16.md) B8; [handoff: from-builder-20261103T035251-gate2-client-checks.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261103T035251-gate2-client-checks.md) B8; [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) submitted StorePath is not a known recipes.tsv out; [rule recipe-write-a-solnix-recipe](https://solnix.io/skills/solnix/rules/recipe-write-a-solnix-recipe.md) gate-b13-host-path FAIL B13 Gate check B13: a host path (/usr/gnu/, /opt/ooce, /opt/nixboot, /usr/gcc/, /var/tmp/big) in the output, such as diffutils' /usr/gnu/bin/pr or libtool's NM="/usr/gnu/bin/nm". Remove the host path in the recipe (diffutils now names coreutils' pr in the store). A changed recipe builds a new out: ask for its row (the cache takes only an out the served recipes.tsv lists), then submit that out. [handoff: from-builder-20261103T035251-gate2-client-checks.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261103T035251-gate2-client-checks.md) B13; [handoff: 20261103-content-gate-b6-b7-b13.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-content-gate-b6-b7-b13.md) B13; [handoff: from-builder-20261102T021941-wave5-t2c-rows/README.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261102T021941-wave5-t2c-rows/README.md) diffutils; [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) submitted StorePath is not a known recipes.tsv out; [rule recipe-write-a-solnix-recipe](https://solnix.io/skills/solnix/rules/recipe-write-a-solnix-recipe.md) gate-b6-host-symlink FAIL B6|-> /usr/bin/nawk Gate check B6: a symlink that resolves outside the out and the store, dangles, or loops (quilt's compat/awk -> /usr/bin/nawk). Point the link at a store path or inside the out in the recipe. A changed recipe builds a new out: ask for its row (the cache takes only an out the served recipes.tsv lists), then submit that out. [handoff: from-builder-20261103T035251-gate2-client-checks.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/from-builder-20261103T035251-gate2-client-checks.md) B6; [handoff: 20261103-content-gate-b6-b7-b13.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-content-gate-b6-b7-b13.md) B6; [handoff: 20261103-v2b-live.md](https://codeberg.org/solnix/solnix-infra/src/commit/c2ecf4535e0fc32261bbfb2414bc7961a73fa6ca/docs/handoff/20261103-v2b-live.md) submitted StorePath is not a known recipes.tsv out; [rule recipe-write-a-solnix-recipe](https://solnix.io/skills/solnix/rules/recipe-write-a-solnix-recipe.md)