Add a short README.
This commit is contained in:
parent
f552c166df
commit
217ea25487
5
Makefile
5
Makefile
|
@ -2,7 +2,6 @@
|
|||
#
|
||||
# SPDX-License-Identifier: GPL-3.0-or-later
|
||||
|
||||
targets = kaem-minimal hex0
|
||||
ESP_SIZE_MIB = 50
|
||||
QEMU = qemu-system-x86_64
|
||||
QEMU_KVM = -enable-kvm
|
||||
|
@ -47,7 +46,11 @@ rootfs:
|
|||
|
||||
mkdir -p $(rootfs_dir)/bootstrap-seeds/UEFI/
|
||||
rsync -av bootstrap-seeds/UEFI/ $(rootfs_dir)/bootstrap-seeds/UEFI/
|
||||
ifndef MINIMAL
|
||||
mv $(rootfs_dir)/bootstrap-seeds/UEFI/amd64/kaem-optional-seed.efi $(boot_dir)/BOOTX64.efi
|
||||
else
|
||||
rm $(rootfs_dir)/bootstrap-seeds/UEFI/amd64/kaem-optional-seed.efi
|
||||
endif
|
||||
|
||||
clean:
|
||||
rm -rf $(build_dir)
|
||||
|
|
|
@ -0,0 +1,22 @@
|
|||
# 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 to 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.
|
Loading…
Reference in New Issue