ilobilo/ilobilix
1
0
Fork 0
mirror of https://github.com/ilobilix/ilobilix.git synced 2026-05-29 18:34:41 +04:00
Code Issues Activity
Ilobilix OS
144 commits 3 branches 0 tags 1.8 MiB
Find a file
Exact
ilobilo 499014445e
 bump kernel commit
2026-05-27 19:21:12 +04:00
base-files bump kernel commit 2026-05-08 21:09:49 +04:00
kernel@526f20d518 bump kernel commit 2026-05-27 19:21:12 +04:00
screenshots bump kernel commit 2026-04-18 20:22:10 +04:00
support bump kernel commit 2026-05-07 23:04:46 +04:00
.gitignore bump kernel commit 2026-05-06 02:49:41 +04:00
.gitmodules use void linux sysroot 2026-05-04 23:16:31 +04:00
GNUmakefile bump kernel commit 2026-05-27 19:21:12 +04:00
LICENSE set up basic build-system 2025-11-15 22:20:23 +04:00
README.md build a disk image 2026-05-24 23:14:07 +04:00

README.md

Ilobilix

Monolithic Hobby OS in modern C++ 23 utilising modules where possible. It has support for custom loadable kernel modules. Its userspace aims to be ABI compatible with GNU/Linux.

Contributors are welcome! Feel free to open issues or submit pull requests.

Note

This repo contains files needed to build and run the OS. Kernel source code is located in ilobilix/kernel

License: EUPL v1.2

x86_64

Building And Running

  • Make sure you are running an up-to-date Linux system and have following programs installed:
    • clang (21+)
    • clang-scan-deps (clang-tools-extra)
    • lld
    • llvm
    • make
    • cmake
    • ninja
    • mtools
    • sgdisk
    • xorriso (for iso)
    • qemu-system
    • curl
    • tar
  • Clone this repository:
    • git clone https://github.com/ilobilix/ilobilix --recursive
  • Build Ilobilix:
    • make
  • Run the OS in QEMU:
    • make run
    • You can exit QEMU in the terminal with: ctrl+a x

Configurable Environment Variables

Note

Default values are enclosed in <>

Shared Options

  • ILOBILIX_ARCH=[<x86_64>|aarch64]

Build-Only Options

  • ILOBILIX_BUILD_TYPE=[Release|<ReleaseDbg>|Debug]
  • ILOBILIX_LTO=[ON|<OFF>] (Requires 'Release' build type)
  • ILOBILIX_LIMINE_MP=[<ON>|OFF]
  • ILOBILIX_UBSAN=[ON|<OFF>]
  • ILOBILIX_VOID_ROOTFS_DATE=<20250202>
  • ILOBILIX_VOID_INSTALL=<empty> (additional packages)
  • ILOBILIX_VOID_REMOVE=<empty>
  • ILOBILIX_SYSROOT_DIR=<unset>

Run-Only Options

  • QEMU_SMP=<6>
  • QEMU_ACCEL=[<ON>|OFF]
  • QEMU_LOG=[ON|<OFF>]
  • QEMU_GDB=[ON|<OFF>]

Directory Structure

ilobilix/
├── kernel/                # Ilobilix kernel repository
├──── kernel/kernel/       # ─ Kernel source code
├──── kernel/modules/      # ─ Loadable kernel modules
├── base-files/            # Customisations applied on top of the Void rootfs
├──── base-files/overlay/  # ─ Files copied onto the sysroot
├──── base-files/append/   # ─ Files that are appended to the ones in the sysroot
├── support/               # Various files for the build system

Notable Projects Used:

Known Bugs

  • mp booting not working on aarch64
  • unconfirmed: sometimes sleeping thread doesn't wake up on bare metal
  • unconfirmed: slab allocator memory mapping breaks on that one laptop