Getting started

This is a ready to go template for x86_64 hobby OS development using bazel as a build system.

It provides the following components:

musl as a LIBC
limine as a UEFI/BIOS bootloader
ia32 for all the definitions from the Intel Manual
liballoc as a simple malloc implementation (You still have to implement your own low level memory allocator!)

This template was tested successfully on:

Ubuntu 22.04 LTS
MacBook Pro M1 (Ventura 13.4)

Setting up the environment

We use Nix to guarantee a deterministic and reproducible build environment.

$ nix-shell

Build

On macOS

Update .bazelrc with your locally installed macOS SDK version. You can list your installed SDKs with:

$ xcrun --sdk macosx --show-sdk-path

# output example:
/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX13.3.sdk

In this example, make sure you have:

build:macos --macos_sdk_version=13.3

In your .bazelrc

Then use the --config macos when you invoke bazelisk build like so:

$ bazelisk build --config macos //:compdb //:boot_iso

On Linux

Use the --config linux when you invoke bazel build like so:

$ bazelisk build --config linux //:compdb //:boot_iso

Bazel Targets

The //:compdb target generates the compilation_commands.json file.

The //:boot_iso target generates the bootable ISO image.

Run

$ qemu-system-x86_64 -M q35 -m 2G -cdrom ./bazel-bin/barebones.iso -boot d