Skip to content

Commit

Permalink
Document that both MOK files must exist
Browse files Browse the repository at this point in the history
... or dkms will overwrite them both.

In the future we might consider changing this to an error if only one of
the two is available, but for now document the current behaviour.

Closes: #366
Signed-off-by: Emil Velikov <emil.velikov@collabora.com>
  • Loading branch information
evelikov-work authored and scaronni committed Nov 29, 2023
1 parent 749b219 commit 6435222
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 0 deletions.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,6 +109,8 @@ Ubuntu `update-secureboot-policy` set the configuration file as follows:
mok_signing_key="/var/lib/shim-signed/mok/MOK.priv"
mok_certificate="/var/lib/shim-signed/mok/MOK.der"
```
NOTE: If any of the files specified by `mok_signing_key` and
`mok_certificate` are non-existant, dkms will re-create both files.

The paths specified in `mok_signing_key`, `mok_certificate` and `sign_file` can
use the variable `${kernelver}` to represent the target kernel version.
Expand Down
4 changes: 4 additions & 0 deletions dkms.8.in
Original file line number Diff line number Diff line change
Expand Up @@ -787,6 +787,10 @@ can be used in path to represent the target kernel version. The path for the bin
Location of the key and certificate files used for Secure boot. The variable
.B $kernelver
can be used in path to represent the target kernel version.

NOTE: If any of the files specified by $mok_signing_key and
$mok_certificate are non-existant, dkms will re-create both files.

.I mok_signing_key
can also be a "pkcs11:..." string for PKCS#11 engine, as long as the sign_file program supports it.
.TP
Expand Down
4 changes: 4 additions & 0 deletions dkms_framework.conf
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,10 @@

# Location of the key and certificate files used for Secure boot. $kernelver
# can be used in path to represent the target kernel version.
#
# NOTE: If any of the files specified by `mok_signing_key` and
# `mok_certificate` are non-existant, dkms will re-create both files.
#
# mok_signing_key can also be a "pkcs11:..." string for PKCS#11 engine, as
# long as the sign_file program supports it.
# (default: /var/lib/dkms):
Expand Down

0 comments on commit 6435222

Please sign in to comment.