Florian La Roche 4e89862706 board/pc/genimage-efi.cfg: align the rootfs to start at 16MB offset from start of the image 3 years ago
..
genimage-bios.cfg 4e4545246f configs/pc_x86_64_{bios, efi}_defconfig: new samples 8 years ago
genimage-efi.cfg 4e89862706 board/pc/genimage-efi.cfg: align the rootfs to start at 16MB offset from start of the image 3 years ago
grub-bios.cfg 6fab243237 configs/pc: refactor to use genimage and grub.cfg 6 years ago
grub-efi.cfg 3468ef16fa configs/pc_x86_64_efi: use genimage GPT partition table support 4 years ago
linux.config c79f5a8876 board/pc: use frame pointer unwinder in linux.config 5 years ago
post-build.sh afcdf9f5c5 board/pc/post-build.sh: fix typo in grub boot.img path 4 years ago
post-image-efi.sh 3b1d9f74c7 board/pc/post-image-efi.sh: fail on any error 4 years ago
readme.txt 79b8540d62 board/pc: drop unused grub-efi.cfg file 5 years ago

readme.txt

Bare PC sample config
=====================

1. Build

First select the appropriate target you want.

For BIOS-based boot strategy:

$ make pc_x86_64_bios_defconfig

For EFI-based boot strategy on a GPT-partitioned disk:

$ make pc_x86_64_efi_defconfig

Add any additional packages required and build:

$ make

2. Write the pendrive

The build process will create a pendrive image called sdcard.img in
output/images.

Write the image to a pendrive:

$ dd if=output/images/disk.img of=/dev/sdc; sync

Once it's done insert it into the target PC and boot.

Remember that if said PC has another boot device you might need to
select this alternative for it to boot.

In the case of EFI boot you might need to disable Secure Boot from
the setup as well.

3. Enjoy

Emulation in qemu (BIOS)
========================

1. Edit grub-bios.cfg

Since the driver will show up in the virtual machine as /dev/vda,
change board/pc/grub-bios.cfg to use root=/dev/vda2 instead of
root=/dev/sda2. Then rebuild grub2 and the image.

2. Run the emulation with:

qemu-system-x86_64 \
-M pc \
-drive file=output/images/disk.img,if=virtio,format=raw \
-net nic,model=virtio \
-net user


Emulation in qemu (UEFI)
========================

Run the emulation with:

qemu-system-x86_64 \
-M pc \
-bios \
-drive file=output/images/disk.img,if=virtio,format=raw \
-net nic,model=virtio \
-net user

Note that needs to point to a valid x86_64 UEFI
firmware image for qemu. It may be provided by your distribution as a
edk2 or OVMF package, in path such as
/usr/share/edk2/ovmf/OVMF_CODE.fd .