UEFI shim loader
C C++ Other
Latest commit 4990d3f Feb 22, 2017 @vathpela vathpela Make shim_version live in a special aligned section.
This makes it so two builds of the same .deb on different hosts won't
have wildly different file offsets.

Signed-off-by: Peter Jones <pjones@redhat.com>
Permalink
Failed to load latest commit information.
Cryptlib Update the CryptLib Nov 30, 2016
include Add HTTP and IpConfig headers Sep 6, 2016
lib More incorrect unsigned vs signed fixups from yours truly. Jun 29, 2015
.gitignore Add ident-like blobs to shim.efi for version checking. Oct 3, 2013
COPYRIGHT Add copyright file Jul 9, 2012
Makefile Make shim_version live in a special aligned section. Feb 23, 2017
MokManager.c MokManager: list Extended Key Usage OIDs Sep 21, 2016
MokVars.txt Add support for disabling db for verification Oct 2, 2013
PasswordCrypt.c additional bounds-checking on section sizes Apr 11, 2014
PasswordCrypt.h MokManager: support Tradition DES hash Sep 26, 2013
README Replace build instructions in README with something not completely wr… Jul 21, 2014
README.fallback Improve BOOT${ARCH}.CSV support. Sep 6, 2016
TODO Update for Josh's changes. Oct 2, 2013
cert.S Add support for 32-bit ARM Aug 12, 2014
crypt_blowfish.c MokManager: support blowfish-based crypt() hash Sep 26, 2013
crypt_blowfish.h MokManager: support blowfish-based crypt() hash Sep 26, 2013
elf_aarch64_efi.lds Make shim_version live in a special aligned section. Feb 23, 2017
elf_arm_efi.lds Make shim_version live in a special aligned section. Feb 23, 2017
elf_ia32_efi.lds Make shim_version live in a special aligned section. Feb 23, 2017
elf_ia64_efi.lds Make shim_version live in a special aligned section. Feb 23, 2017
elf_x86_64_efi.lds Make shim_version live in a special aligned section. Feb 23, 2017
fallback.c Improve BOOT${ARCH}.CSV support. Sep 6, 2016
hexdump.h Add a utility hexdump() call we can use when we need it. Nov 17, 2015
httpboot.c Add the optional HTTPBoot support Sep 6, 2016
httpboot.h Add the optional HTTPBoot support Sep 6, 2016
make-certs Sign MokManager with a locally-generated key Nov 26, 2012
netboot.c Make translate_slashes() public Sep 6, 2016
netboot.h netboot.h: fix build error on 32-bit systems Nov 12, 2013
replacements.c Ensure that apps launched by shim get correct BS->Exit() behavior Jun 11, 2015
replacements.h Ensure that apps launched by shim get correct BS->Exit() behavior Jun 11, 2015
shim.c Also just check for access denied anyway. Feb 6, 2017
shim.h Ensure that apps launched by shim get correct BS->Exit() behavior Jun 11, 2015
testplan.txt Another testplan error. Oct 2, 2014
tpm.c shim/tpm: correct the definition of the capability structure version 1.0 Feb 6, 2017
tpm.h shim/tpm: the EFI_TCG2_BOOT_SERVICE_CAPABILITY structure shouldn't be… Feb 6, 2017
ucs2.h Don't test for the 0 character on the wrong half of the UCS2-LE char. Nov 17, 2015
version.c.in Make shim_version live in a special aligned section. Feb 23, 2017
version.h Add ident-like blobs to shim.efi for version checking. Oct 3, 2013

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 DER-encoded public certificate in a file such as
pub.cer and build with "make VENDOR_CERT_FILE=pub.cer".