Preamble

This is an incomplete(!) list of things that I noticed to be missing when trying to build SerenityOS inside SerenityOS (much less successfully building or running).

Generally, building currently only works with Clang as the host compiler (so remember to export CC=clang CXX=clang++), as GCC is not position-independent and will quickly run into memory allocation issues.

The remaining ports that need to be installed can be found here. Remember to symlink bash to /bin/sh, as our Shell is not POSIX-compatible.

Build Instructions

1. Check out serenity-on-serenity-host from https://github.com/timschumi/serenity
2. Build the system and all required ports as listed here
3. Remember to bump SERENITY_RAM_SIZE, 1G is not enough
4. Symlink /bin/sh to bash in your sync-local.sh
5. Clone https://github.com/timschumi/serenity inside Serenity and check out the serenity-on-serenity branch
6. export CC=clang CXX=clang++
7. ./Meta/serenity.sh build i686 Clang for the whole system (includes the toolchain on first run) or ./Toolchain/BuildClang.sh for just the toolchain

TODOs (by descending importance, authors opinion)

Actual blockers

• Kernel of the nested Serenity instance locks up if it tries to enable UMIP
• Implement actual support for SO_REUSEADDR
• Figure out why QEMU rejects the default netdev

Issues with existing workarounds

• Support mounting ext2 images from files
• Figure out why building LLVM using GCC generates a broken atomics.c.o (i.e. _c-suffix is not removed) (needs something like 8844762, should be fixed upstream)

Issues that are insignificant because GCC doesn't work anyways (#14189)

• Port texinfo/makeinfo (and by extension, perl) [binutils]
• _Unwind_Resume is "missing" [GCC]

DONEs (by order of materialization/completion)

• Implement extended header support in tar (more precisely the path extensions for long file names) (#12876)
• Implement selecting specific files for unzip (#12510)
• Implement install -D (#12573)
• Look into curl CA certificate validation without extra flags (#12959)
• Implement RPATH/RUNPATH in the ELF loader (#12631)
• #12956
• Implement a cmp command [binutils] (#13137)
• #12962 [binutils] (Has been worked around for this specific case)
• Implement install -c (no-op?) [binutils] (#13018)
• Linker does not find many symbols size_t mismatch between GCC and LLVM [LLVM] (#12991)
• X86GenDisassemblerTables contains a malformed modRMTable [LLVM] (#13006)
• Make python3 build the _ctypes module [LLVM runtimes]
• Prevent ninja from invalidating all build output on x86_64 (#13581)
• Clang overflows the stack while building itself on x86_64 (#13637)
• Make pick_gcc less annoying when building with Clang (#13677)
• #13816
• Implement ZIP data descriptors (test file) (#14015)
• compiler-rt runtimes experience random missed includes ("di_int: type name requires a specifier or qualifier") while compiling (appears if llvm/llvm-project@19c5cf4 is present in the llvm Port) (#13949)
• Make pls viable as a sudo-replacement (#14414)
• Support mapping files partially in unzip (#14452)
• Port QEMU (including tools) (#13971)
• Implement cp --preserve=... (#14571)
• Implement du -k (#14633)
• CMake doesn't load the SerenityOS platform module when building on Serenity (#14647)
• liblagom-core does not find syscall{1,2,3} (#15768)
• Implement XZ support in tar (tar -xJf) and by extension LibCompress (#17884)

Most of these are currently worked around by additional patches (serenity-on-serenity-host for the modifications on the host, and serenity-on-serenity for the modifications for building), but obviously running patch-less is the target :^)