Skip to content

Latest commit

 

History

History
39 lines (25 loc) · 1.2 KB

README.md

File metadata and controls

39 lines (25 loc) · 1.2 KB

stubby

Stubby is a project that aims to explore and experiment with UEFI firmware and its features. It is based on another one of my projects called newt_stub.

Features

  • Stubby can boot from UEFI and print some basic information on the screen.
  • Stubby can interact with UEFI protocols and services, such as memory allocation, file system access, and graphics output.
  • Stubby can load and execute other EFI applications, such as the shell or the bootloader.

Requirements

  • Linux, macOS or WSL
  • A Rust compiler and cargo toolchain.
  • A QEMU emulator and OVMF firmware.
  • A GNU Make1 utility.

Usage

To build and run stubby, use the following command:

make run-debug

This will compile the stubby binary, create a virtual disk image2 with the EFI application, and launch QEMU with OVMF.

To clean up the generated files, use the following command:

make clean

License

Stubby is licensed under the MIT license. See the LICENSE file for more details.

Footnotes

  1. Please only use GNU Make, BSD Make (and by extention 'Apple Make') have issues with the Makefile

  2. Currently binaries are dumped into a folder and QEMU 'mounts' that folder as a FAT filesystem