GitHub - pg83/solo: Portable Linux binaries, solved

The complete example is in bin/vulkan, and the Vulkan program itself is in main.cpp. How it works ┌──────────────────── fully static executable ────────────────────┐ │ │ │ application → embedded Vulkan loader → SoLo dlopen/dlsym │ │ ├─ x86-64 ELF mapper │ │ └─ glibc ABI → musl │ │ │ │ └───────────────────────────────────────────┬─────────────────────┘ │ maps at runtime ▼ system Mesa/Vulkan ICD.so + DSOs elf_loader.cpp maps ELF segments, walks DT_NEEDED, resolves versioned symbols, applies x86-64 relocations, supports ELF TLS and TLSDESC, materializes IFUNCs, applies RELRO, and runs initializers. Dependencies that are themselves ELF DSOs are loaded recursively. glibc is deliberately not loaded. Imports such as malloc@GLIBC_2.2.5 are resolved by glibc_shim.cpp to ABI-correct adapters over the process's existing musl runtime. Unsupported glibc functions have unique generated stubs that fail loudly with the exact symbol and version if they are ever called, instead of silently corrupting the process. Because musl sizes its synchronization objects to the glibc ABI of each architecture, the bridge does not shadow them: a pthread_mutex_t a driver creates is used in place. A lock is therefore one lock for both the loaded DSO and the static executable that may share it, and glibc's static recursive and error-check initializers are adopted on first use. Before loading a DSO from disk, SoLo checks its static provider registry. This lets an application satisfy a dependency—Wayland, for example—with functions already linked into the executable. LD_LIBRARY_PATH and DL_ELF_LIBRARY_PATH are honored for libraries outside the standard system directories. The interesting pieces are small enough to read: lib/dlfcn.cpp — dlopen, dlsym, errors, and static providers lib/elf_loader.cpp — ELF mapping, symbols, relocations, and TLS lib/glibc_shim.cpp — implemented glibc ABI adapters lib/glibc_stubs.cpp — explicit fallbacks for the rest of the ABI Use it as a library The default target builds the standalone archive: ./build The published ./dlfcn symlink points to the resulting libdlfcn.a. Include lib/dlfcn.h, link the archive into a musl-static application, and ordinary dlopen()/dlsym() calls are redirected to SoLo. The source tree is intentionally self-contained and suitable for copying into another static build graph. Reproduce the experiment ./build test # load an Arch glibc DSO closure in the smoke test ./build vulkan_test # build the static demo and verify a native Lavapipe PNG CI performs the native build and test on Alpine/musl with GCC, Fedora with GCC, and Ubuntu with Clang. The Vulkan test installs each distribution's own Lavapipe package; it does not run the driver from an Arch sysroot. Every build input for the standalone Vulkan executable is vendored under bin/vulkan. build.py compiles those sources directly: upstream CMake, Meson, configure, and Make build systems are not invoked.