proxmox-mirrors/efi-boot-shim
1
0
Fork 0
mirror of https://git.proxmox.com/git/efi-boot-shim synced 2025-07-26 19:54:23 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
156 Commits 1 Branch 3 Tags 11 MiB
C 97.8%
Makefile 0.8%
Shell 0.7%
Assembly 0.7%
eb9f7f1c23
Go to file
Peter Jones eb9f7f1c23 Add a fallback loader for when shim is invoked as BOOTX64.EFI 
If shim is invoked as \EFI\BOOT\BOOT*.EFI and a file exists named
\EFI\BOOT\FALLBACK.EFI, try it instead of our second stage.  So don't
put fallback.efi on your install media in \EFI\BOOT, because that won't
do whatever it is you're hoping for, unless you're hoping not to start
the installer.

So here's the process for using this:
in /EFI/fedora/ (or whichever directory you happen to own), you put:
  shim.efi
  grub.efi
  boot.csv - format is: shim.efi,Nice Label,cmdline arguments,comments
           - filenames refer only to files in this directory, with no
	     leading characters such as L"./" or L"/EFI/fedora/"
           - note that while this is CSV, the character encoding is
	     UCS-2

and if /EFI/BOOT/BOOTX64.EFI doesn't already exist, then in /EFI/BOOT:
  shim.efi as BOOTX64.EFI
  fallback.efi

Signed-off-by: Peter Jones <pjones@redhat.com>
2013-04-30 09:46:22 -04:00
Cryptlib Remove temp file checked in by accident 2012-07-09 10:38:30 -04:00
cert.S Fix data alignment on vendor_cert so we don't wind up with padding. 2012-09-06 16:43:30 -04:00
COPYRIGHT Add copyright file 2012-07-09 11:03:12 -04:00
dbx.S Initialize the size of vendor dbx as 0 2012-10-30 10:35:36 -04:00
fallback.c Add a fallback loader for when shim is invoked as BOOTX64.EFI 2013-04-30 09:46:22 -04:00
make-certs Sign MokManager with a locally-generated key 2012-11-26 13:43:50 -05:00
Makefile Add a fallback loader for when shim is invoked as BOOTX64.EFI 2013-04-30 09:46:22 -04:00
MokManager.c Make sure the menu shows when the callback fails 2013-01-03 12:20:30 +08:00
MokVars.txt Add documentation of the Mok variables 2012-10-30 16:14:02 -04:00
netboot.c Don't fail if there's no network devices 2012-11-01 16:03:24 -04:00
netboot.h Add draft version of Neil's netboot code 2012-10-12 20:14:14 -04:00
PeImage.h dos2unix PeImage.h 2012-09-06 12:01:43 -04:00
README Add basic documentation 2012-07-28 00:42:43 -04:00
shim.c Adopt the UEFI shell style LoadOptions 2013-04-30 09:45:45 -04:00
shim.h Switch to using db format for MokList and MokNew 2012-10-12 19:55:20 -04:00
signature.h Switch to using db format for MokList and MokNew 2012-10-12 19:55:20 -04:00
TODO Update TODO 2012-07-09 10:39:14 -04:00
ucs2.h Add StrCSpn() 2013-04-30 09:46:22 -04:00

README 

shim is a trivial EFI application that, when run, attempts to open and
execute another application. It will initially attempt to do this via the
standard EFI LoadImage() and StartImage() calls. If these fail (because secure
boot is enabled and the binary is not signed with an appropriate key, for
instance) it will then validate the binary against a built-in certificate. If
this succeeds and if the binary or signing key are not blacklisted then shim
will relocate and execute the binary.

shim will also install a protocol which permits the second-stage bootloader
to perform similar binary validation. This protocol has a GUID as described
in the shim.h header file and provides a single entry point. On 64-bit systems
this entry point expects to be called with SysV ABI rather than MSABI, and
so calls to it should not be wrapped.

To use shim, simply place a hex dump of the public certificate in cert.h
and build it with make.