andrius
/
stage0-uefi
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
UEFI port of stage0
79 Commits 1 Branch 0 Tags 707 KiB
Assembly 83.5%
C 11.6%
Shell 3.6%
Makefile 1.3%
Go to file
Andrius Štikonas 32deb0ffaf hex0: Implement various improvements: 
* Make sure to close all protocols before exit.
 * Use more sophisticated command line argument processing
   that pushes command line arguments onto stack.
 * Switch to more readable M1 defines.
 		2022-09-10 23:57:31 +01:00
Development hex0: Implement various improvements: 2022-09-10 23:57:31 +01:00
LICENSES Add high level prototype for hex0. 2022-07-06 17:53:13 +01:00
amd64 hex0: Implement various improvements: 2022-09-10 23:57:31 +01:00
bootstrap-seeds@b69ef1bc84 Fix kaem when receiving non-zero exit code. 2022-08-20 02:22:34 +01:00
.gitignore Add Makefile for creating images and launching qemu. 2022-08-07 11:38:45 +01:00
.gitmodules Add Makefile for creating images and launching qemu. 2022-08-07 11:38:45 +01:00
Makefile hex.S: Fix a bug where store label was called rather than jumped into. 2022-08-20 23:11:30 +01:00
README.md Fix wording in readme. 2022-08-28 00:57:20 +01:00
kaem.amd64 Add Makefile for creating images and launching qemu. 2022-08-07 11:38:45 +01:00

README.md

stage0-uefi

This is a port of stage0-posix (https://github.com/oriansj/stage0-posix) to UEFI.

Usage

make build/disk.img will create bootable images with stage0-uefi. You can use dd to write them on bootable media.

make qemu will create disk image and launch it in QEMU. To test this in QEMU, you need to provide some QEMU compatible UEFI implementation. In particular, you can use Tianocore's OVMF. make qemu is looking for it in a few paths where distros tend to install it. If not you can specify it via make qemu OVMF_IMG=/path/to/OVMF_CODE.fd

Minimal images

It is possible to create images without kaem-optional-seed.efi that contain only hex0-seed.efi. Those are a bit less automated but if your UEFI implementation lets you pass command line arguments, you can recreate kaem using just hex0.

  • make MINIMAL=1 qemu.
  • Open UEFI settings (often F2 but it varies from system to system).
  • Go to Add Boot option and pick appropriate boot volume that contains hex0-seed.efi.
  • Pick \bootstrap-seeds\UEFI\amd64\hex0-seed.efi.
  • Description can be anything, say kaem-seed.
  • Optional Data has to be hex0 amd64\kaem-minimal.hex0 EFI\BOOT\BOOTX64.efi.
  • Save boot entry and boot it. This will build kaem-minimal and exit.
  • Now boot normally from bootable media.