Skip to content

Commit

Permalink
Add where to set uefi variables
Browse files Browse the repository at this point in the history
Follow up to Slack discussion, the file the variables `UEFI_SIGN_ENABLE`
`and UEFI_SIGN_KEYDIR` are set in was mentioned, as well as an
admonition mentioning the case where this is not required.

QA steps: ran build and checked rendered HTML, ran linter. No issues
found.

No related ticket, quick fix.

Signed-off-by: Katrina Prosise <[email protected]>
  • Loading branch information
kprosise committed Oct 16, 2024
1 parent 90c27b4 commit c3680fb
Showing 1 changed file with 9 additions and 2 deletions.
11 changes: 9 additions & 2 deletions source/reference-manual/security/secure-boot-uefi.rst
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ The most commonly found modes are:
**Standard Mode**

Signature and hash checks are enforced on boot time executables.
Microsoft KEK and DB certificates usually available.
Microsoft KEK and DB certificates are usually available.
System vendors may include their own KEK and/or DB certificates.

**User/Custom Mode**
Expand Down Expand Up @@ -123,7 +123,8 @@ Custom keys can be added to the ``lmp-manifest`` repo directory ``factory-keys/u
Enabling UEFI Secure Boot Usage in LmP
--------------------------------------

The signing process in LmP is controlled by the following Yocto Project variables:
The signing process in LmP is controlled by the following Yocto Project variables,
set in ``meta-subscriber-overrides/conf/machine/include/lmp-factory-custom.inc``:

* ``UEFI_SIGN_KEYDIR``
* Path for the directory containing the DB private key (``DB.key`` and ``DB.crt``),
Expand All @@ -132,6 +133,12 @@ The signing process in LmP is controlled by the following Yocto Project variable
* ``UEFI_SIGN_ENABLE``
* If set to ``1`` the systemd-boot bootloader and Linux kernel binaries will be signed by with the DB key (``DB.key`` at ``UEFI_SIGN_KEYDIR``)


.. tip::

Setting these may not be required in cases where they are inherited from ``meta-lmp-bsp``.
This can be seen in ``meta-lmp/meta-lmp-bsp/conf/machine/include/lmp-machine-custom.inc``

.. _ref-secure-boot-uefi-provisioning:

UEFI Secure Boot Provisioning
Expand Down

0 comments on commit c3680fb

Please sign in to comment.