Contributor: Yug Agarwal (@yug105)
Organization: MetaCall Technologies
Project: Extended Platform and Architecture Support for MetaCall
Project size: Medium (175 hours)
Technologies: C, C++, CMake, POSIX, Bash, GitHub Actions, ELF
Topics: embedded systems, systems programming, build systems, CI/CD, dynamic linking
Synopsis: metacall/gsoc-2026 - Extended Platform and Architecture Support for MetaCall
Contact: yugagarwal105@gmail.com
MetaCall is a polyglot runtime. It loads language runtimes as shared libraries and calls between them, which means it leans on dlopen, PLT/GOT hooking, and whatever the platform's dynamic linker happens to do. That makes it more sensitive to the operating system than most projects.
When I started, MetaCall built and tested on Linux (GCC), Windows (MSVC) and macOS. A few other platforms had bits of support sitting in the core layers, but none of it was tested. No CI, no section in the environment script, no way to know whether it still worked.
Goals:
- Add support for new platforms, with CI to prove it works.
- Keep all platform logic in
tools/metacall-environment.shand none in the CI YAML, so anyone can reproduce a build locally. - Make sure CMake detection and the build actually work on each target.
- Get the test suite running on each platform and fix what it finds.
- Fix
metacall/plthook, which MetaCall's detour layer depends on, for the platforms that need it.
Three passes per platform:
- Add the CI workflow and let it fail. A real failure log beats guessing from the source.
- Add the platform's section to
metacall-environment.shand fix CMake until it builds. - Fix whatever the tests report.
Then move to the next platform. Doing them one at a time kept the PRs small enough to review.
core #617, merged. HP-UX has no dlopen, it uses shl_load, shl_findsym and shl_unload. I added dynlink_impl_hpux.c and its header, wired through dynlink_interface.h, plus PROJECT_OS_HPUX and its own hpux OS family in cmake/Portability.cmake.
This set the pattern for the rest. Dynlink is an interface with one implementation per OS family, so adding a platform means adding an implementation, not #ifdefs.
core #620, open. Bionic's linker differs enough from glibc that the Unix dynlink path needs its own handling. This PR adds that handling. Still open.
plthook #17, merged. plthook's Android CI was broken before I could test the core side, so I fixed that first. Rewrote the test runner as test/android/run_tests.sh, fixed Android.mk and Application.mk, repaired the workflow.
The biggest part of the project.
plthook #19, merged. FreeBSD support in plthook, in plthook_elf.c. FreeBSD's linker exposes its link map differently from glibc, so the ELF walking needed its own path. Added CI alongside it.
plthook-poc #1, merged. FreeBSD and NetBSD in the proof-of-concept harness.
core #762, merged. The FreeBSD CI pipeline. A freebsd-test.yml running a real FreeBSD VM through cross-platform-actions, with the FreeBSD setup added to metacall-environment.sh and nothing platform-specific in the YAML. Getting it to build also needed fixes in cmake/FindNodeJS.cmake and portability_executable_path.c, since FreeBSD gets the running executable's path from a sysctl rather than /proc/self/exe.
core #772, merged. More FreeBSD setup, plus fixes to FindWasmtime.cmake and RustProject.cmake so more loaders build.
plthook #23, merged. Tests passed on FreeBSD at -O0 and -O1 and failed at -O2 and -O3. It was not a FreeBSD bug and not a compiler bug. It was undefined pointer arithmetic in plthook's own code. Making that arithmetic well-defined in plthook_elf.c fixed it at every level.
core #805, merged. FreeBSD CI with sanitizers turned on, which is where the harder failures show up. Included fixes in plthook_detour_impl.c and the WASM test.
plthook #24, merged. Haiku support in plthook, in plthook_elf.c, plus a Haiku workflow. Haiku is BeOS-derived rather than Unix-derived, so there is no /proc, no getconf, and the loader has its own API.
core #833, merged. Haiku CI for core plus the fixes needed to get it building. Three parts:
- A
haiku-test.ymlrunning Haiku r1beta5 across debug, relwithdebinfo and release. - A change in
source/dynlink/CMakeLists.txtselecting theunixdynlink implementation for Haiku. Haiku's OS family isbeos, which would otherwise pick the oldload_add_onbackend, but Haiku does provide a workingdlopen. Special-casing the selection was the right fix, the same way macOS is handled a few lines above. - A fix in
rapid_json_serial_impl.cppmoving the RapidJSON allocator into the document struct, so it dies with the document instead of outliving the plugin that owns it.
core #846, open. MinGW is Windows with a GCC toolchain and a POSIX-ish shell instead of MSVC. Adds a windows-mingw-test.yml and works through what breaks: flags in CompileOptions.cmake and InstallGTest.cmake, log_policy_stream_syslog.c (no syslog under MinGW), metacall_link.c, a guard so the backtrace plugin is skipped where it cannot build, and fixes in the fork and serial tests.
plthook #25. A standalone ThreadSanitizer reproducer for the destructor-after-unload crash, so the bug can be discussed against a small case instead of a full CI log.
| # | Repo | Title | State | Date |
|---|---|---|---|---|
| #846 | core | MinGW / MSYS2 support | Open | Jul 16, 2026 |
| #833 | core | Haiku CI, dynlink selection and RapidJSON allocator fix | Merged | Jul 8, 2026 |
| #24 | plthook | Add Haiku OS support | Merged | Jun 14, 2026 |
| #805 | core | FreeBSD CI with sanitizers | Merged | Jun 10, 2026 |
| # | Repo | Title | State | Date |
|---|---|---|---|---|
| #23 | plthook | Fix undefined behaviour in address arithmetic causing -O2/-O3 failures on FreeBSD | Merged | May 19, 2026 |
| #772 | core | FreeBSD build support, additional loaders | Merged | Apr 18, 2026 |
| #762 | core | Add FreeBSD CI | Merged | Apr 14, 2026 |
| #1 | plthook-poc | FreeBSD and NetBSD support | Merged | Apr 7, 2026 |
| #19 | plthook | FreeBSD support | Merged | Apr 4, 2026 |
| #17 | plthook | Android CI fix | Merged | Mar 2, 2026 |
| #620 | core | Add Android platform support for dynlink module | Open | Jan 22, 2026 |
| #617 | core | Add HP-UX platform support for dynlink module | Merged | Jan 19, 2026 |
Live lists: metacall/core and metacall/plthook.
Supporting a new OS is a way of finding bugs in your own code. plthook passed on FreeBSD at -O0 and failed at -O2. Not a compiler bug: plt_addr_base was a const char * used for address arithmetic, which is undefined behaviour. Changing it to uintptr_t fixed it at every level. Each OS enforces a different subset of the rules, so a port is another checker run over the same code.
Tests come before the fix. My first Android PR to plthook was closed because I had shipped it with no way to tell whether it worked. Everything after that started with CI. Alongside the uintptr_t fix I added -O2 and -O3 to the plthook matrix, so the case that broke now gets run.
A guard that is too broad quietly breaks a platform that worked. I disabled the backtrace plugin with if(MINGW) at project level, and fork safety behind if(WIN32). Both were removed in review. The first belonged in the plugin's own CMakeLists as a per-target setting. The second also covers MSVC, where fork safety works, so it would have regressed a platform that was already correct.
Reproduce in the smallest project that still shows the bug. When my first Haiku PR stalled, the instruction was to implement it in plthook-poc first, to establish whether the failure belonged to MetaCall or to plthook. A crash in a full CI run has too many moving parts to reason about. That is why I wrote the standalone ThreadSanitizer reproducer in plthook #25.
Defend a change with a source, not an assertion. I changed how LIBPATH_ENV was set in plthook's test Makefile and was asked whether that would strip LD_LIBRARY_PATH for every other platform. What got it merged was pointing at Haiku's runtime_loader.cpp, which reads LIBRARY_PATH instead. "It should be fine" would not have.
Two crashes on two operating systems can be the same bug. The FreeBSD Python segfault and the Haiku crash looked unrelated, but both are a destructor running after the shared object holding its code has already been unloaded. Both platforms show it because their linkers unmap sooner than glibc does. Treating it as one bug turned two CI failures into a single question about shutdown ordering.
Platform logic belongs in the environment script, not in CI. Putting pkg install lines straight into freebsd-test.yml works, but then the only way to build on FreeBSD is to push a commit and wait for a VM. Keeping it in tools/metacall-environment.sh means the CI job is a couple of commands anyone can run locally.
Thanks to @viferga, @pkspyder and @Ashpect for the mentorship.