Home

Awesome

bootloader

Docs Build Status Join the chat at https://rust-osdev.zulipchat.com

An experimental x86_64 bootloader that works on both BIOS and UEFI systems. Written in Rust and some inline assembly, buildable on all platforms without additional build-time dependencies (just some rustup components).

Requirements

You need a nightly Rust compiler with the llvm-tools-preview component, which can be installed through rustup component add llvm-tools-preview.

Usage

To use this crate, you need to adjust your kernel to be bootable first. Then you can create a bootable disk image from your compiled kernel. These steps are explained in detail below.

If you're already using an older version of the bootloader crate, follow our migration guides.

Kernel

To make your kernel compatible with bootloader:

Booting

To combine your kernel with a bootloader and create a bootable disk image, follow these steps:

See our disk image creation template for a more detailed example.

Architecture

This project is split into three separate entities:

License

Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.