proxmox-mirrors/efi-boot-shim
1
0
Fork 0
mirror of https://git.proxmox.com/git/efi-boot-shim synced 2025-08-15 04:07:35 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
756 Commits 1 Branch 3 Tags 11 MiB
C 97.8%
Makefile 0.8%
Shell 0.7%
Assembly 0.7%
8537e0555c
Go to file
Luca Boccassi 8537e0555c Makefile: use fixed build host if SOURCE_DATE_EPOCH is defined 
If SOURCE_DATE_EPOCH is defined then we can be reasonably sure the
user wants the build to be fully reproducible, so use a fixed string.
In case of a cross build, using uname -s -m -p -i o will still report
the host's kernel architecture, which will trip some CIs like
Debian's.

This is a backport from devel of:

  commit 11fd3197d21f94b491ccfc1da6d38b14060e62d7
  Author: Luca Boccassi <bluca@debian.org>
  Date:   Fri Feb 15 21:42:10 2019 +0000

      Makefile: use fixed build host if SOURCE_DATE_EPOCH is defined

      If SOURCE_DATE_EPOCH is defined then we can be reasonably sure the
      user wants the build to be fully reproducible, so use a fixed string.
      In case of a cross build, using uname -s -m -p -i o will still report
      the host's kernel architecture, which will trip some CIs like
      Debian's.

      Signed-off-by: Luca Boccassi <bluca@debian.org>

Signed-off-by: Luca Boccassi <bluca@debian.org>
Signed-off-by: Peter Jones <pjones@redhat.com>
2021-02-16 09:12:48 +01:00
.github/workflows github workflows: add the sbat branch to one PR builds run for 2021-02-05 16:30:57 -05:00
Cryptlib Make openssl accept the right set of KU/EKUs 2020-07-23 22:22:04 -04:00
data Add a .sbat section to EFI binaries 2021-02-12 12:51:32 -05:00
include SPDX: Clarify the attribution for crypt_blowfish 2021-02-16 09:12:48 +01:00
lib SPDX: Clarify the attribution for James's lib/ code 2021-02-16 09:12:48 +01:00
.clang-format Add some linked list primitives. 2021-02-13 12:58:23 -05:00
.gitignore .gitignore: ignore .gdbinit 2021-02-15 17:20:05 -05:00
buildid.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
BUILDING BUILDING: Fix a typo 2021-02-15 17:20:05 -05:00
cert.S Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
COPYRIGHT Add copyright file 2012-07-09 11:03:12 -04:00
crypt_blowfish.c SPDX: Clarify the attribution for crypt_blowfish 2021-02-16 09:12:48 +01:00
elf_aarch64_efi.lds efi bins: add an easy way for vendors to add .sbat data 2021-02-12 19:27:21 +01:00
elf_arm_efi.lds efi bins: add an easy way for vendors to add .sbat data 2021-02-12 19:27:21 +01:00
elf_ia32_efi.lds efi bins: add an easy way for vendors to add .sbat data 2021-02-12 19:27:21 +01:00
elf_ia64_efi.lds efi bins: add an easy way for vendors to add .sbat data 2021-02-12 19:27:21 +01:00
elf_x86_64_efi.lds efi bins: add an easy way for vendors to add .sbat data 2021-02-12 19:27:21 +01:00
errlog.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
fallback.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
httpboot.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
make-certs Use portable shebangs: /bin/bash -> /usr/bin/env bash 2020-07-23 20:53:24 -04:00
Make.coverity Try to make coverity.mk work without cov-build installed. 2021-02-15 17:20:05 -05:00
Make.defaults efi bins: add an easy way for vendors to add .sbat data 2021-02-12 19:27:21 +01:00
Make.rules efi bins: add an easy way for vendors to add .sbat data 2021-02-12 19:27:21 +01:00
Make.scan-build Try to make scan-build.mk work without scan-build installed. 2021-02-15 17:20:05 -05:00
Makefile Makefile: use fixed build host if SOURCE_DATE_EPOCH is defined 2021-02-16 09:12:48 +01:00
model.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
mok.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
MokManager.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
MokVars.txt Add MokListX to MokVars.txt 2017-08-03 11:00:58 -04:00
netboot.c src/netboot.c: remove the execute bit 2021-02-16 09:12:48 +01:00
PasswordCrypt.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
pe.c SBAT: parse a copy of the table that's got a NUL at the end 2021-02-13 11:02:59 -05:00
README.fallback README.fallback: correct the path of BOOT.CSV in layout example 2017-07-24 14:12:31 -04:00
README.md Convert README -> README.md 2021-02-15 17:20:05 -05:00
README.tpm Add support for vendor_db built-in shim authorized list. 2020-07-23 22:22:04 -04:00
replacements.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
sbat.c sbat: make the includes work like everything else. 2021-02-15 18:40:07 +01:00
SBAT.example.md Add an example SBAT workflow document 2021-02-13 11:29:18 -05:00
SBAT.md Add Secure Boot Advanced Targeting (SBAT) specification document 2021-02-13 11:29:18 -05:00
shim.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
shim.h Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
testplan.txt Another testplan error. 2014-10-02 01:01:46 -04:00
TODO Add mm/fb hashing to TODO, put that and related things under 'Reproducible builds' 2021-02-15 17:20:05 -05:00
tpm.c Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
version.c.in Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00
version.h Fix up a bunch of our license statements and add SPDX most places 2021-02-16 09:12:48 +01:00

README.md

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.