ilobilix icon indicating copy to clipboard operation
ilobilix copied to clipboard

Published 20 hours ago • verified publisher icon ilobilo
→

Metadata

Second attempt at making an os

Ilobilix

Second attempt at making an OS

LICENSE

Building and Running

Make sure you have following programs installed:

  • meson
  • ninja
  • clang/clang++ (version >= 17)
  • lld
  • llvm
  • xorriso
  • tar
  • xbstrap
  • qemu-system-x86_64
  • qemu-system-aarch64

Note: you may need more tools to build the sysroot, such as flex, bison, automake, autoconf, texinfo, gmp, mpc, mpfr etc

On debian based systems, I recommend installing llvm, clang and lld from here: https://apt.llvm.org
If you are on a up-to-date Debian based system (Ubuntu, linux mint, Pop_os!, etc) you can install most of them with this command:
sudo apt install clang lld llvm xorriso tar qemu-system-x86 qemu-system-arm
For meson, ninja and xbstrap, first make sure you have python and python-pip installed and then run:
python -m pip install meson ninja xbstrap

Follow these steps to build and run the os:

  1. Clone this repo with:
    git clone --depth=1 https://github.com/ilobilo/ilobilix

  2. Currently you have to manually build the sysroot:

  • Set the architecture in boostrap.yml
  • mkdir build-sysroot
  • pushd build-sysroot
  • xbstrap init ..
  • xbstrap install base
  • If symlink named sysroot does not exist in ilobilix source that links to build-sysroot/system-root, then create it with:
    ln -s $BUILD_SYSROOT_DIR$/system-root $KERNEL_DIR$/sysroot
    For example:
    ln -s build-sysroot/system-root ../sysroot
  • popd

  1. Set up the build system:
    meson setup builddir --cross-file cross-files/meson-kernel-clang-(x86_64/aarch64)(-ccache).cross-file -Doptions=values

  2. Build and run the kernel:
    ninja -C builddir <see Ninja Targets>

Ninja Targets

Target Name Description
run_bios Run with legacy BIOS (only on x86_64)
run_bios_debug Same but with debugging enabled
run_uefi Run with UEFI
run_uefi_debug Same but with debugging enabled
norun Do not run the OS

Notes:

  • run_(bios/uefi)_debug: Runs QEMU with -d int and -monitor telnet:127.0.0.1:12345. If gdb option is enabled, adds -s -S
  • If target is not specified and architecture supports bios mode, run_bios will be used, otherwise run_uefi.

Options

Project options Default Value Description
kernel_cflags Extra c compiler arguments for kernel
kernel_cxxflags Extra cpp compiler arguments for kernel
modules_cflags Extra c compiler arguments for modules
modules_cxxflags Extra cpp compiler arguments for modules
kernel_ubsan false Enable ubsanitizer in kernel
modules_ubsan false Enable ubsanitizer in modules
5lvl_paging false Enable 5 level paging in kernel
syscall_debug false Print syscall log in serial console
gdb false Add -s -S to QEMU when debugging
noaccel false Disable QEMU accelerators
vnc false Start QEMU VNC server on 127.0.0.1:5901

Discord Server

https://discord.gg/fM5GK3RpS7

Resources and Projects:

  • meson: https://mesonbuild.com
  • osdev wiki: https://wiki.osdev.org
  • osdev discord server: https://discord.gg/RnCtsqD
  • managarm: https://github.com/managarm/managarm
  • tart: https://github.com/qookei/tart
  • toaruOS: https://github.com/klange/toaruos
  • LemonOS: https://github.com/LemonOSProject/LemonOS
  • Sigma: https://github.com/sigma-os/Sigma
  • Luna: https://github.com/thomtl/Luna
  • vinix: https://github.com/vlang/vinix
  • lyre: https://github.com/lyre-os/lyre
  • limine: https://github.com/limine-bootloader/limine
  • unifont: https://ftp.gnu.org/gnu/unifont/unifont-14.0.02
  • uACPI: https://github.com/UltraOS/uACPI
  • frigg: https://github.com/managarm/frigg
  • mlibc: https://github.com/managarm/mlibc
  • magic_enum: https://github.com/Neargye/magic_enum
  • frozen: https://github.com/serge-sans-paille/frozen
  • fmt: https://github.com/fmtlib/fmt
  • printf: https://github.com/eyalroz/printf
  • cwalk: https://github.com/likle/cwalk
  • hashmap: https://github.com/ilobilo/parallel-hashmap
  • smart_ptr: https://github.com/ilobilo/smart_ptr
  • veque: https://github.com/ilobilo/veque
  • terminal: https://github.com/ilobilo/limine-terminal
  • demangler: https://github.com/ilobilo/demangler
  • ilar: https://github.com/ilobilo/ilar
  • ovmf: https://github.com/ilobilo/ovmf-binaries
  • compiler-rt: https://github.com/ilobilo/compiler-rt-builtins
  • libstdc++: https://github.com/ilobilo/libstdcxx-headers

TODO

  • [x] Serial
  • [x] GDT
  • [x] IDT
  • [x] TSS
  • [x] PCI
  • [x] PCIe
  • [x] MSI
  • [x] MSI-X
  • [x] Modules x86_64
  • [ ] Modules aarch64
  • [x] DTB
  • [x] PS/2
  • [x] PMM
  • [x] VMM (5 and 4 level)
  • [x] Heap
  • [x] ACPI
  • [x] LAPIC
  • [x] IOAPIC
  • [x] uACPI
  • [x] VFS
  • [x] TMPFS
  • [x] DEVTMPFS
  • [ ] PROCFS
  • [ ] SYSFS
  • [x] USTAR
  • [x] ILAR
  • [ ] AHCI
  • [x] NVME
  • [ ] Block Device Interface
  • [ ] EchFS
  • [ ] EXT2
  • [ ] FAT32
  • [x] HPET
  • [x] PIT
  • [x] RTC
  • [x] LAPIC Timer
  • [ ] Generic Timer
  • [x] SMP
  • [x] Scheduler x86_64
  • [ ] Scheduler aarch64
  • [x] System calls x86_64
  • [ ] System calls aarch64
  • [ ] Permissions
  • [x] MMAP
  • [x] FDs
  • [x] CDEV
  • [x] FBDEV
  • [x] TTY
  • [ ] PTY
  • [x] ELF
  • [x] Userspace
  • [ ] Signals
  • [x] mlibc
  • [x] RTL8139
  • [ ] RTL8169
  • [x] E1000 (100E 153A and 10EA)
  • [x] Ethernet
  • [x] ARP
  • [x] IPv4
  • [x] ICMPv4
  • [ ] TCP
  • [ ] UDP

Packages

  • libiconv
  • libintl
  • zlib
  • file
  • ncurses
  • readline
  • bash
  • coreutils
  • nano

← Metadata

26
Stars
2
Forks
Watchers

Owner

verified publisher icon ilobilo

Metadata

Second attempt at making an os

Back