x86/efi/README.md

1 # Build kvm-unit-tests and run under UEFI
5 This dir provides code to build kvm-unit-tests test cases and run them under
12 - [UEFI firmware](https://github.com/tianocore/edk2): to run test cases in QEMU
14 ### Build  subsection
16 To build:
18     ./configure --enable-efi
35 ### Code from GNU-EFI
38 [GNU-EFI](https://sourceforge.net/projects/gnu-efi/):
39    - crt0-efi-x86_64.S: startup code of an EFI application
40    - elf_x86_64_efi.lds: linker script to build an EFI application
41    - reloc_x86_64.c: position independent x86_64 ELF shared object relocator
44 runtime addresses. To build such relocatable binaries, GNU-EFI utilizes the
45 above-mentioned files in its build process:
47    1. build an ELF shared object and link it using linker script
49    2. link the shared object with self-relocator `reloc_x86_64.c` that applies
51    3. link the entry point code `crt0-efi-x86_64.S` that invokes self-relocator
55 More details can be found in `GNU-EFI/README.gnuefi`, section "Building
58 kvm-unit-tests follows a similar build process, but does not link with GNU-EFI
60 ### Startup code for kvm-unit-tests in UEFI
62 This dir also contains kvm-unit-tests startup code in UEFI:
63    - efistart64.S: startup code for kvm-unit-tests in UEFI