basic-os.md

basic-os

A minimal os to showcase the usage of bootloader.

Overview

The top level basic crate defines a workspace.

• The kernel crate is a member of that workspace

  # in Cargo.toml
  [workspace]
  members = ["kernel"]

• An artifact dependency is used add the kernel crate as a build-dependency:

  # in Cargo.toml
  [build-dependencies]
  kernel = { path = "kernel", artifact = "bin", target = "x86_64-unknown-none" }

  Enable the unstable artifact-dependencies feature:

  # .cargo/config.toml
  [unstable]
  bindeps = true

  Experimental features are only available on the nightly channel:

  # rust-toolchain.toml
  [toolchain]
  channel = "nightly"
  components = ["llvm-tools"]
  targets = ["x86_64-unknown-none"]

The basic create combines the kernel with bootloader, creates a bootable disk image and launches them.

• A cargo build script is used to create a bootable disk image (build.rs).
• basic launches the images in QEMU.

See also basic-kernel.md in the kernel subdirectory.

Usage

Install dependencies:

$ sudo apt update && sudo apt install qemu-system-x86

Build:

$ cargo build

Run:

$ cargo run bios

$ cargo run uefi