Basic Rust kernel using Limine

Quentincestino

Last update: Dec 23, 2022

Related tags

Operating systems rust_limine_barebones

Overview

Rust Limine Barebones

This is a small kernel that boots using Limine.

Build

First of all, download Rust ! (I guess you already did it if you are here lol) Then, do the following things

# Installs the nightly toolchain, needed for few things
rustup install nightly
cd rust_limine_barebones
# Sets the nightly toolchain as the version of the project 
rustup override set nightly
# Installs cargo xbuild. Needed to build core for our custom target
cargo install cargo-xbuild

This kernel needs echfs-utils for building the image that we can pass through qemu, you can found this here

Scripts

Because I'm a good guy I made many scripts to help you build the kernel. So in order we have:

build.sh, builds the kernel. As we use Limine we can let it build a typical ELF executable.
build_limine.sh, takes the kernel and pack it with limine in a echfs image.
run_qemu.sh, runs the image generated with build_limine.sh. Now you are ready for many hours of suffering with the x86 arch.
run_update.sh, launchs every scripts in the order of this list. It aswell deletes the previous image. But still be careful about your compile errors, I don't handle these.

The target

Maybe I've put some unused gcc linking args but if you want your target working instantly just basically copy it.

The linking script

Because the #[used] proc macro isn't enough to keep the stivale2hdr alive after linking you need the linker.ld script to keep it breathing. Without this Limine won't boot your kernel because of missing stivale2hdr section.

Limine config

Limine config is pretty simple but if your kernel is making some progress you maybe gonna need a ramfs.

Resources

If you need anything more than what this repo can offer you, here are some links that may be useful:

Comments

License?

Hello!

I'd like to use this as a starting point for my own hobby OS, but I legally can't right now, since you don't have a license listed. Could you set one?

Thank you!

opened by rdrpenguin04 3
Stivale crate repository does not exist

The https://github.com/Andy-Python-Programmer/stivale-rs repository is unavailable, I guess it moved to https://github.com/Andy-Python-Programmer/stivale.

opened by Wafelack 1
Switch to using the published version of stivale-rs
Switch to using the crates.io version of stivale-rs (https://github.com/Andy-Python-Programmer/stivale). The crate has been published as stivale-boot

The crate has been fully rewritten and now supports all of the structures in the stivale specification so, also includes changes to that

Signed By: Anhad Singh
opened by Andy-Python-Programmer 0
The stivale repsitory has been renamed
The stivale repository has been renamed from https://github.com/Andy-Python-Programmer/stivale-rs to https://github.com/Andy-Python-Programmer/stivale

Remove unused use in main.rs

Fixes: #1

Signed By: Anhad Singh
opened by Andy-Python-Programmer 0
Limine bootloader error
Limine bootloader fails to load the elf file generated.

I get the following errors:

On limine latest binary (as of today)

Elf error: Failed to allocate memory ranges

On v2.24:

Elf64: Load Failure

Maybe did you miss any flags? Or is it the fault of limine bootloader?
opened by Narasimha1997 1