![]() Some versions of gnu-efi have a typo, in which "EFI_WARN_UNKNOWN_GLYPH" is accidentally "EFI_WARN_UNKOWN_GLYPH". Work around that, so that we can use the not-silly one in console.c's list of error and warning messages. This is a backport from devel for: commit 5f62b22ccd636d326b3229a2b196118701c6f3f7 Author: Peter Jones <pjones@redhat.com> Date: Mon Aug 26 16:12:05 2019 -0400 Signed-off-by: Peter Jones <pjones@redhat.com> |
||
---|---|---|
.github/workflows | ||
Cryptlib | ||
data | ||
include | ||
lib | ||
.clang-format | ||
.gitignore | ||
buildid.c | ||
BUILDING | ||
cert.S | ||
COPYRIGHT | ||
crypt_blowfish.c | ||
elf_aarch64_efi.lds | ||
elf_arm_efi.lds | ||
elf_ia32_efi.lds | ||
elf_ia64_efi.lds | ||
elf_x86_64_efi.lds | ||
errlog.c | ||
fallback.c | ||
httpboot.c | ||
make-certs | ||
Make.coverity | ||
Make.defaults | ||
Make.rules | ||
Make.scan-build | ||
Makefile | ||
model.c | ||
mok.c | ||
MokManager.c | ||
MokVars.txt | ||
netboot.c | ||
PasswordCrypt.c | ||
pe.c | ||
README.fallback | ||
README.md | ||
README.tpm | ||
replacements.c | ||
sbat.c | ||
SBAT.example.md | ||
SBAT.md | ||
shim.c | ||
shim.h | ||
testplan.txt | ||
TODO | ||
tpm.c | ||
version.c.in | ||
version.h |
shim, a first-stage UEFI bootloader
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, so calls to it should not be wrapped.
On systems with a TPM chip enabled and supported by the system firmware, shim will extend various PCRs with the digests of the targets it is loading. A full list is in the file README.tpm .
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
.
There are a couple of build options, and a couple of ways to customize the build, described in BUILDING.