Debian Codegraph @

upstream/fedora-44/man1/ukify.1

raw
1 '\" t
2 .TH "UKIFY" "1" "" "systemd 259.5" "ukify"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 ukify \- Combine components into a signed Unified Kernel Image for UEFI systems
24 .SH "SYNOPSIS"
25 .HP \w'\fBukify\fR\ 'u
26 \fBukify\fR [OPTIONS...] build
27 .HP \w'\fBukify\fR\ 'u
28 \fBukify\fR [OPTIONS...] genkey
29 .HP \w'\fBukify\fR\ 'u
30 \fBukify\fR [OPTIONS...] inspect FILE...
31 .SH "DESCRIPTION"
32 .PP
33 \fBukify\fR
34 is a tool whose primary purpose is to combine components (usually a kernel, an initrd, and the
35 \fBsystemd-stub\fR(7)
36 UEFI stub) to create a
37 \m[blue]\fBUAPI\&.5 Unified Kernel Image (UKI)\fR\m[]\&\s-2\u[1]\d\s+2
38 \(em a single PE binary that boots the system\&. When the UKI is executed, the stub extracts and boots the embedded linux kernel\&. The UKI can be started directly by the firmware or through a boot loader\&. When used with
39 \m[blue]\fBqemu\fR\m[]\&\s-2\u[2]\d\s+2, a UKI can also be executed through "direct kernel boot", see example below\&.
40 .PP
41 \fBukify\fR
42 can also be used generate other types of UKI\-like images, in particular extensions\&. See the description of the
43 \fBbuild\fR
44 verb below\&.
45 \fBukify\fR
46 can also generate certificates and keys for SecureBoot and PCR signing, see the description of the
47 \fBgenkey\fR
48 verb below\&.
49 \fBukify\fR
50 can also print detailed information about unified kernel images, see the description of
51 \fBinspect\fR
52 verb below\&.
53 .SH "COMMANDS"
54 .PP
55 The following commands are understood:
56 .SS "build"
57 .PP
58 This command creates a Unified Kernel Image\&. The two primary options that should be specified for the
59 \fBbuild\fR
60 verb are
61 \fILinux=\fR/\fB\-\-linux=\fR, and
62 \fIInitrd=\fR/\fB\-\-initrd=\fR\&.
63 \fIInitrd=\fR
64 accepts multiple whitespace\-separated paths and
65 \fB\-\-initrd=\fR
66 can be specified multiple times\&.
67 .PP
68 Additional sections will be inserted into the UKI, either automatically or only if a specific option is provided\&. See the discussions of
69 \fIMicrocode=\fR/\fB\-\-microcode=\fR,
70 \fICmdline=\fR/\fB\-\-cmdline=\fR,
71 \fIOSRelease=\fR/\fB\-\-os\-release=\fR,
72 \fIDeviceTree=\fR/\fB\-\-devicetree=\fR,
73 \fIDeviceTreeAuto=\fR/\fB\-\-devicetree\-auto=\fR,
74 \fIHWIDs=\fR/\fB\-\-hwids=\fR,
75 \fISplash=\fR/\fB\-\-splash=\fR,
76 \fIPCRPKey=\fR/\fB\-\-pcrpkey=\fR,
77 \fIUname=\fR/\fB\-\-uname=\fR,
78 \fISBAT=\fR/\fB\-\-sbat=\fR, and
79 \fB\-\-section=\fR
80 below\&.
81 .PP
82 \fBukify\fR
83 can also be used to assemble a PE binary that is not executable but contains auxiliary data, for example additional kernel command line entries\&.
84 .PP
85 If PCR signing keys are provided via the
86 \fIPCRPrivateKey=\fR/\fB\-\-pcr\-private\-key=\fR
87 and
88 \fIPCRPublicKey=\fR/\fB\-\-pcr\-public\-key=\fR
89 or
90 \fIPCRCertificate=\fR/\fB\-\-pcr\-certificate=\fR
91 options, PCR values that will be seen after booting with the given kernel, initrd, and other sections, will be calculated, signed, and embedded in the UKI\&.
92 \fBsystemd-measure\fR(1)
93 is used to perform this calculation and signing\&.
94 .PP
95 The calculation of PCR values is done for specific boot phase paths\&. Those can be specified with the
96 \fIPhases=\fR/\fB\-\-phases=\fR
97 option\&. If not specified, the default provided by
98 \fBsystemd\-measure\fR
99 is used\&. It is also possible to specify the
100 \fIPCRPrivateKey=\fR/\fB\-\-pcr\-private\-key=\fR,
101 \fIPCRPublicKey=\fR/\fB\-\-pcr\-public\-key=\fR
102 or
103 \fIPCRCertificate=\fR/\fB\-\-pcr\-certificate=\fR, and
104 \fIPhases=\fR/\fB\-\-phases=\fR
105 arguments more than once\&. Signatures will then be performed with each of the specified keys\&. On the command line, when both
106 \fB\-\-phases=\fR
107 and
108 \fB\-\-pcr\-private\-key=\fR
109 are used, they must be specified the same number of times, and then the n\-th boot phase path set will be signed by the n\-th key\&. This can be used to build different trust policies for different phases of the boot\&. In the config file,
110 \fIPCRPrivateKey=\fR,
111 \fIPCRPublicKey=\fR, and
112 \fIPhases=\fR
113 are grouped into separate sections, describing separate boot phases\&. If one of
114 \fISigningEngine=\fR/\fB\-\-signing\-engine=\fR
115 or
116 \fISigningProvider=\fR/\fB\-\-signing\-provider=\fR
117 is specified, then the private key arguments will be passed verbatim to
118 \fBopenssl\fR(1)
119 as URIs, and the public key arguments will be loaded as X\&.509 certificates, so that signing can be performed with an OpenSSL engine or provider respectively\&.
120 .PP
121 If a SecureBoot signing key is provided via the
122 \fISecureBootPrivateKey=\fR/\fB\-\-secureboot\-private\-key=\fR
123 option, the resulting PE binary will be signed as a whole, allowing the resulting UKI to be trusted by SecureBoot\&. Also see the discussion of automatic enrollment in
124 \fBsystemd-boot\fR(7)\&.
125 .PP
126 If the stub and/or the kernel contain
127 "\&.sbat"
128 sections they will be merged in the UKI so that revocation updates affecting either are considered when the UKI is loaded by Shim\&. For more information on SBAT see
129 \m[blue]\fBShim documentation\fR\m[]\&\s-2\u[3]\d\s+2\&.
130 .SS "genkey"
131 .PP
132 This command creates the keys for PCR signing and the key and certificate used for SecureBoot signing\&. The same configuration options that determine what keys and in which paths will be needed for signing when
133 \fBbuild\fR
134 is used, here determine which keys will be created\&. See the discussion of
135 \fIPCRPrivateKey=\fR/\fB\-\-pcr\-private\-key=\fR,
136 \fIPCRPublicKey=\fR/\fB\-\-pcr\-public\-key=\fR, and
137 \fISecureBootPrivateKey=\fR/\fB\-\-secureboot\-private\-key=\fR
138 below\&.
139 .PP
140 The output files must not exist\&.
141 .SS "inspect"
142 .PP
143 Display information about the sections in a given binary or binaries\&. If
144 \fB\-\-all\fR
145 is given, all sections are shown\&. Otherwise, if
146 \fB\-\-section=\fR
147 option is specified at least once, only those sections are shown\&. Otherwise, well\-known sections that are typically included in an UKI are shown\&. For each section, its name, size, and sha256\-digest is printed\&. For text sections, the contents are printed\&.
148 .PP
149 Also see the description of
150 \fB\-j\fR/\fB\-\-json=\fR
151 and
152 \fB\-\-section=\fR\&.
153 .PP
154 Other tools that may be useful for inspect UKIs:
155 \fBllvm-objdump\fR(1)
156 \fB\-p\fR
157 and
158 \fBpe\-inspect\fR\&.
159 .SH "CONFIGURATION SETTINGS"
160 .PP
161 Settings can appear in configuration files (the syntax with
162 \fISomeSetting=\fR\fI\fIvalue\fR\fR) and on the command line (the syntax with
163 \fB\-\-some\-setting=\fR\fB\fIvalue\fR\fR)\&. For some command line parameters, a single\-letter shortcut is also allowed\&. In the configuration files, the setting must be in the appropriate section, so the descriptions are grouped by section below\&. When the same setting appears in the configuration file and on the command line, generally the command line setting has higher priority and overwrites the config file setting completely\&. If some setting behaves differently, this is described below\&.
164 .PP
165 If no config file is provided via the option
166 \fB\-\-config=\fR\fB\fIPATH\fR\fR,
167 \fBukify\fR
168 will try to look for a default configuration file in the following paths in this order:
169 /etc/systemd/ukify\&.conf,
170 /run/systemd/ukify\&.conf,
171 /usr/local/lib/systemd/ukify\&.conf, and
172 /usr/lib/systemd/ukify\&.conf, and then load the first one found\&.
173 \fBukify\fR
174 will proceed normally if no configuration file is specified and no default one is found\&.
175 .PP
176 The
177 \fILINUX\fR
178 and
179 \fIINITRD\fR
180 positional arguments, or the equivalent
181 \fILinux=\fR
182 and
183 \fIInitrd=\fR
184 settings, are optional\&. If more than one initrd is specified, they will all be combined into a single PE section\&. This is useful to, for example, prepend microcode before the actual initrd\&.
185 .PP
186 The following options and settings are understood:
187 .SS "Command line\-only options"
188 .PP
189 \fB\-\-config=\fR\fB\fIPATH\fR\fR
190 .RS 4
191 Load configuration from the given config file\&. In general, settings specified in the config file have lower precedence than the settings specified via options\&. In cases where the command line option does not fully override the config file setting are explicitly mentioned in the descriptions of individual options\&.
192 .sp
193 Added in version 254\&.
194 .RE
195 .PP
196 \fB\-\-measure\fR, \fB\-\-no\-measure\fR
197 .RS 4
198 Enable or disable a call to
199 \fBsystemd-measure\fR(1)
200 to print pre\-calculated PCR values\&. Defaults to false\&.
201 .sp
202 Added in version 253\&.
203 .RE
204 .PP
205 \fB\-\-policy\-digest\fR, \fB\-\-no\-policy\-digest\fR
206 .RS 4
207 Enable or disable a call to
208 \fBsystemd-measure\fR(1)
209 to print pre\-calculated TPM2 policy digests\&. Useful for offline signing of PCR policies\&. Defaults to false\&.
210 .sp
211 Added in version 258\&.
212 .RE
213 .PP
214 \fB\-\-section=\fR\fB\fINAME\fR\fR\fB:\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR, \fB\-\-section=\fR\fB\fINAME\fR\fR\fB:text|binary\fR\fB[@\fIPATH\fR]\fR
215 .RS 4
216 For all verbs except
217 \fBinspect\fR, the first syntax is used\&. Specify an arbitrary additional section
218 "\fINAME\fR"\&. The argument may be a literal string, or
219 "@"
220 followed by a path name\&. This option may be specified more than once\&. Any sections specified in this fashion will be inserted (in order) before the
221 "\&.linux"
222 section which is always last\&.
223 .sp
224 For the
225 \fBinspect\fR
226 verb, the second syntax is used\&. The section
227 \fINAME\fR
228 will be inspected (if found)\&. If the second argument is
229 "text", the contents will be printed\&. If the third argument is given, the contents will be saved to the file named
230 \fIPATH\fR\&.
231 .sp
232 Note that the name is used as\-is, and if the section name should start with a dot, it must be included in
233 \fINAME\fR\&.
234 .sp
235 Added in version 253\&.
236 .RE
237 .PP
238 \fB\-\-join\-profile=\fR\fB\fIPATH\fR\fR
239 .RS 4
240 Takes a path to an existing PE file containing an additional profile to add to the unified kernel image\&. The profile can be generated beforehand with
241 \fBukify\fR\&. The profile does not need to be signed or contain PCR measurements\&. All UKI PE sections of the specified PE file are copied into the generated UKI\&. This is useful for generating multi\-profile UKIs\&. Note that this only copies PE sections that are defined by the UKI specification, and ignores any other, for example
242 "\&.text"
243 or similar\&.
244 .sp
245 Added in version 257\&.
246 .RE
247 .PP
248 \fB\-\-sign\-profile=\fR\fB\fIID\fR\fR
249 .RS 4
250 Takes a profile ID for which signed PCR measurements should be generated by ukify\&. This option can be used together with
251 \fB\-\-join\-profile=\fR
252 when building the final unified kernel image\&. If not specified, signed PCR measurements will be added for all profiles\&.
253 .sp
254 Added in version 258\&.
255 .RE
256 .PP
257 \fB\-\-join\-pcrsig=\fR\fB\fIPATH\fR\fR, \fB\-\-pcrsig=\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR
258 .RS 4
259 \fB\-\-join\-pcrsig=\fR
260 takes a path to an existing PE file containing a previously built UKI\&.
261 \fB\-\-pcrsig=\fR
262 takes a path to an existing pcrsig JSON blob, or a verbatim inline blob\&. They must be used together, and without specifying any other UKI section parameters\&.
263 \fBukify\fR
264 will attach the pcrsig JSON blob to the UKI\&. This is useful in combination with
265 \fB\-\-policy\-digest\fR
266 to create a UKI and then sign the TPM2 policy digests offline\&.
267 .sp
268 Added in version 258\&.
269 .RE
270 .PP
271 \fB\-\-tools=\fR\fB\fIDIRS\fR\fR
272 .RS 4
273 Specify one or more directories with helper tools\&.
274 \fBukify\fR
275 will look for helper tools in those directories first, and if not found, try to load them from
276 \fI$PATH\fR
277 in the usual fashion\&.
278 .sp
279 Added in version 253\&.
280 .RE
281 .PP
282 \fB\-\-output=\fR\fB\fIFILENAME\fR\fR
283 .RS 4
284 The output filename\&. If not specified, the name of the
285 \fILINUX\fR
286 argument, with the suffix
287 "\&.unsigned\&.efi"
288 or
289 "\&.signed\&.efi"
290 will be used, depending on whether signing for SecureBoot was performed\&.
291 .sp
292 Added in version 253\&.
293 .RE
294 .PP
295 \fB\-\-summary\fR
296 .RS 4
297 Print a summary of loaded config and exit\&. This is useful to check how the options from the configuration file and the command line are combined\&.
298 .sp
299 Added in version 254\&.
300 .RE
301 .PP
302 \fB\-\-all\fR
303 .RS 4
304 Print all sections (with
305 \fBinspect\fR
306 verb)\&.
307 .sp
308 Added in version 255\&.
309 .RE
310 .PP
311 \fB\-\-json\fR
312 .RS 4
313 Generate JSON output (with
314 \fBinspect\fR
315 verb)\&.
316 .sp
317 Added in version 255\&.
318 .RE
319 .PP
320 \fB\-h\fR, \fB\-\-help\fR
321 .RS 4
322 Print a short help text and exit\&.
323 .RE
324 .PP
325 \fB\-\-version\fR
326 .RS 4
327 Print a short version string and exit\&.
328 .RE
329 .SS "[UKI] section"
330 .PP
331 \fILinux=\fR\fI\fILINUX\fR\fR, \fB\-\-linux=\fR\fB\fILINUX\fR\fR
332 .RS 4
333 A path to the kernel binary\&.
334 .sp
335 Added in version 254\&.
336 .RE
337 .PP
338 \fIOSRelease=\fR\fI\fITEXT\fR\fR\fI|\fR\fI\fI@PATH\fR\fR, \fB\-\-os\-release=\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR
339 .RS 4
340 The os\-release description (the
341 "\&.osrel"
342 section)\&. The argument may be a literal string, or
343 "@"
344 followed by a path name\&. If not specified, the
345 \fBos-release\fR(5)
346 file will be picked up from the host system\&. If explicitly set to an empty string, the "\&.osrel" section is omitted from the UKI (this is not recommended in most cases, and causes the resulting artifact to not be recognized as a UKI by other tools like
347 \fBkernel\-install\fR
348 and
349 \fBbootctl\fR)\&.
350 .sp
351 Added in version 253\&.
352 .RE
353 .PP
354 \fICmdline=\fR\fI\fITEXT\fR\fR\fI|\fR\fI\fI@PATH\fR\fR, \fB\-\-cmdline=\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR
355 .RS 4
356 The kernel command line (the
357 "\&.cmdline"
358 section)\&. The argument may be a literal string, or
359 "@"
360 followed by a path name\&. If not specified, no command line will be embedded\&.
361 .sp
362 Added in version 253\&.
363 .RE
364 .PP
365 \fIInitrd=\fR\fI\fIINITRD\fR\fR\fI\&.\&.\&.\fR, \fB\-\-initrd=\fR\fB\fILINUX\fR\fR
366 .RS 4
367 Zero or more initrd paths\&. In the configuration file, items are separated by whitespace\&. The initrds are combined in the order of specification, with the initrds specified in the config file first\&.
368 .sp
369 Added in version 254\&.
370 .RE
371 .PP
372 \fIMicrocode=\fR\fI\fIUCODE\fR\fR, \fB\-\-microcode=\fR\fB\fIUCODE\fR\fR
373 .RS 4
374 Path to initrd containing microcode updates\&. If not specified, the section will not be present\&.
375 .sp
376 Added in version 256\&.
377 .RE
378 .PP
379 \fISplash=\fR\fI\fIPATH\fR\fR, \fB\-\-splash=\fR\fB\fIPATH\fR\fR
380 .RS 4
381 A picture to display during boot (the
382 "\&.splash"
383 section)\&. The argument is a path to a BMP file\&. If not specified, the section will not be present\&.
384 .sp
385 Added in version 253\&.
386 .RE
387 .PP
388 \fIDeviceTree=\fR\fI\fIPATH\fR\fR, \fB\-\-devicetree=\fR\fB\fIPATH\fR\fR
389 .RS 4
390 The devicetree description (the
391 "\&.dtb"
392 section)\&. The argument is a path to a compiled binary DeviceTree file\&. If not specified, the section will not be present\&.
393 .sp
394 Added in version 253\&.
395 .RE
396 .PP
397 \fIDeviceTreeAuto=\fR\fI\fIPATH\fR\fR\fI\&.\&.\&.\fR, \fB\-\-devicetree\-auto=\fR\fB\fIPATH\fR\fR
398 .RS 4
399 Zero or more automatically selectable DeviceTree files\&. In the configuration file, items are separated by whitespace\&. Each DeviceTree will be in a separate
400 "\&.dtbauto"
401 section\&.
402 .sp
403 Added in version 257\&.
404 .RE
405 .PP
406 \fIHWIDs=\fR\fI\fIPATH\fR\fR, \fB\-\-hwids=\fR\fB\fIPATH\fR\fR
407 .RS 4
408 The hardware ID device table (the
409 "\&.hwids"
410 section)\&. The argument is a path to a directory with JSON HWID device description files\&. Each file needs to contain a single JSON object with a
411 "name",
412 "compatible"
413 and
414 "hwids"
415 keys\&. The
416 "name"
417 and
418 "compatible"
419 keys must have string values and the
420 "hwids"
421 key must have a list of strings as value, where the strings must be valid UUIDs that represent CHIDs/HWIDs\&. Example:
422 .sp
423 .if n \{\
424 .RS 4
425 .\}
426 .nf
427 {
428 "type": "devicetree",
429 "name": "Example Laptop 16 Gen 7",
430 "compatible": "example,laptop\-16\-g7",
431 "hwids": [
432 "5dc05bf4\-01f6\-4089\-b464\-a08c47ea9295",
433 "3e3f8f3c\-2003\-46f2\-811c\-85554f7d5952"
434 ]
435 }
436 .fi
437 .if n \{\
438 .RE
439 .\}
440 .sp
441 Here
442 "Example Laptop 16 Gen 7"
443 is the device
444 "name"
445 (as defined by the manufacturer),
446 "example,laptop\-16\-g7"
447 is the
448 "compatible"
449 (as defined by the kernel) and
450 "hwids"
451 is an array of CHIDs/HWIDs (extracted i\&.e\&. from
452 \fBfwupdtool hwids\fR
453 output)\&. If not specified, the section will not be present\&. It is recommended to specify this parameter if automatically selectable DeviceTrees are to be used\&.
454 .sp
455 Added in version 257\&.
456 .RE
457 .PP
458 \fIUname=\fR\fI\fIVERSION\fR\fR, \fB\-\-uname=\fR\fB\fIVERSION\fR\fR
459 .RS 4
460 Specify the kernel version (as in
461 \fBuname \-r\fR, the
462 "\&.uname"
463 section)\&. If not specified, an attempt will be made to extract the version string from the kernel image\&. It is recommended to pass this explicitly if known, because the extraction is based on heuristics and not very reliable\&. If not specified and extraction fails, the section will not be present\&.
464 .sp
465 Added in version 253\&.
466 .RE
467 .PP
468 \fISBAT=\fR\fI\fITEXT\fR\fR\fI|\fR\fI\fI@PATH\fR\fR, \fB\-\-sbat=\fR\fB\fITEXT\fR\fR\fB|\fR\fB\fI@PATH\fR\fR
469 .RS 4
470 SBAT metadata associated with the UKI or addon\&. SBAT policies are useful to revoke whole groups of UKIs or addons with a single, static policy update that does not take space in DBX/MOKX\&. If not specified manually, a default metadata entry consisting of
471 .sp
472 .if n \{\
473 .RS 4
474 .\}
475 .nf
476 uki,1,UKI,uki,1,https://uapi\-group\&.org/specifications/specs/unified_kernel_image/
477 .fi
478 .if n \{\
479 .RE
480 .\}
481 .sp
482 for UKIs and
483 .sp
484 .if n \{\
485 .RS 4
486 .\}
487 .nf
488 uki\-addon,1,UKI Addon,addon,1,https://www\&.freedesktop\&.org/software/systemd/man/latest/systemd\-stub\&.html
489 .fi
490 .if n \{\
491 .RE
492 .\}
493 .sp
494 for addons will be used, to ensure it is always possible to revoke them\&. For more information on SBAT see
495 \m[blue]\fBShim documentation\fR\m[]\&\s-2\u[3]\d\s+2\&.
496 .sp
497 Added in version 254\&.
498 .RE
499 .PP
500 \fIPCRPKey=\fR\fI\fIPATH\fR\fR, \fB\-\-pcrpkey=\fR\fB\fIPATH\fR\fR
501 .RS 4
502 A path to a public key to embed in the
503 "\&.pcrpkey"
504 section\&. If not specified, and there\*(Aqs exactly one
505 \fIPCRPublicKey=\fR/\fB\-\-pcr\-public\-key=\fR
506 or
507 \fIPCRCertificate=\fR/\fB\-\-pcr\-certificate=\fR
508 argument, that key will be used\&. Otherwise, the section will not be present\&.
509 .sp
510 Added in version 253\&.
511 .RE
512 .PP
513 \fIProfile=\fR\fI\fIPATH\fR\fR, \fB\-\-profile=\fR\fB\fIPATH\fR\fR
514 .RS 4
515 A path to a UKI profile to place in an
516 "\&.profile"
517 section\&. This option is useful for creating multi\-profile UKIs, and is typically used in combination with
518 \fB\-\-join\-profile=\fR, to extend the specified UKI with an additional profile\&.
519 .sp
520 Added in version 257\&.
521 .RE
522 .PP
523 \fIPCRBanks=\fR\fI\fIPATH\fR\fR, \fB\-\-pcr\-banks=\fR\fB\fIPATH\fR\fR
524 .RS 4
525 A comma or space\-separated list of PCR banks to sign a policy for\&. If not present, all known banks will be used ("sha1",
526 "sha256",
527 "sha384",
528 "sha512"), which will fail if not supported by the system\&.
529 .sp
530 Added in version 253\&.
531 .RE
532 .PP
533 \fISecureBootSigningTool=\fR\fI\fISIGNER\fR\fR, \fB\-\-signtool=\fR\fB\fISIGNER\fR\fR
534 .RS 4
535 Whether to use
536 "sbsign",
537 "pesign", or
538 "systemd\-sbsign"\&. Depending on this choice, different parameters are required in order to sign an image\&. Defaults to
539 "sbsign"\&.
540 .sp
541 Added in version 254\&.
542 .RE
543 .PP
544 \fISecureBootPrivateKey=\fR\fI\fISB_KEY\fR\fR, \fB\-\-secureboot\-private\-key=\fR\fB\fISB_KEY\fR\fR
545 .RS 4
546 A path to a private key to use for signing of the resulting binary\&. If the
547 \fISigningEngine=\fR/\fB\-\-signing\-engine=\fR
548 or
549 \fISigningProvider=\fR/\fB\-\-signing\-provider=\fR
550 option is used, this may also be an engine or provider specific designation\&. This option is required by
551 \fISecureBootSigningTool=sbsign\fR/\fB\-\-signtool=sbsign\fR
552 and
553 \fISecureBootSigningTool=systemd\-sbsign\fR/\fB\-\-signtool=systemd\-sbsign\fR\&.
554 .sp
555 Added in version 253\&.
556 .RE
557 .PP
558 \fISecureBootCertificate=\fR\fI\fISB_CERT\fR\fR, \fB\-\-secureboot\-certificate=\fR\fB\fISB_CERT\fR\fR
559 .RS 4
560 A path to a certificate to use for signing of the resulting binary\&. If the
561 \fISigningEngine=\fR/\fB\-\-signing\-engine=\fR
562 or
563 \fISigningProvider=\fR/\fB\-\-signing\-provider=\fR
564 option is used, this may also be an engine or provider specific designation\&. This option is required by
565 \fISecureBootSigningTool=sbsign\fR/\fB\-\-signtool=sbsign\fR
566 and
567 \fISecureBootSigningTool=systemd\-sbsign\fR/\fB\-\-signtool=systemd\-sbsign\fR\&.
568 .sp
569 Added in version 253\&.
570 .RE
571 .PP
572 \fISecureBootCertificateDir=\fR\fI\fISB_PATH\fR\fR, \fB\-\-secureboot\-certificate\-dir=\fR\fB\fISB_PATH\fR\fR
573 .RS 4
574 A path to a nss certificate database directory to use for signing of the resulting binary\&. Takes effect when
575 \fISecureBootSigningTool=pesign\fR/\fB\-\-signtool=pesign\fR
576 is used\&. Defaults to
577 /etc/pki/pesign\&.
578 .sp
579 Added in version 254\&.
580 .RE
581 .PP
582 \fISecureBootCertificateName=\fR\fI\fISB_CERTNAME\fR\fR, \fB\-\-secureboot\-certificate\-name=\fR\fB\fISB_CERTNAME\fR\fR
583 .RS 4
584 The name of the nss certificate database entry to use for signing of the resulting binary\&. This option is required by
585 \fISecureBootSigningTool=pesign\fR/\fB\-\-signtool=pesign\fR\&.
586 .sp
587 Added in version 254\&.
588 .RE
589 .PP
590 \fISecureBootCertificateValidity=\fR\fI\fIDAYS\fR\fR, \fB\-\-secureboot\-certificate\-validity=\fR\fB\fIDAYS\fR\fR
591 .RS 4
592 Period of validity (in days) for a certificate created by
593 \fBgenkey\fR\&. Defaults to 3650, i\&.e\&. 10 years\&.
594 .sp
595 Added in version 254\&.
596 .RE
597 .PP
598 \fISigningEngine=\fR\fI\fIENGINE\fR\fR, \fB\-\-signing\-engine=\fR\fB\fIENGINE\fR\fR
599 .RS 4
600 An OpenSSL engine to be used for signing the resulting binary and PCR measurements, see
601 \fBopenssl-engine\fR(1)\&.
602 .sp
603 Added in version 253\&.
604 .RE
605 .PP
606 \fISigningProvider=\fR\fI\fIPROVIDER\fR\fR, \fB\-\-signing\-provider=\fR\fB\fIPROVIDER\fR\fR
607 .RS 4
608 An OpenSSL provider to be used for signing the resulting binary and PCR measurements, see
609 \fBprovider\fR(7)\&. This option can only be used when
610 \fBsystemd\-sbsign\fR
611 is used as the signing tool\&.
612 .sp
613 Added in version 257\&.
614 .RE
615 .PP
616 \fICertificateProvider=\fR\fI\fIPROVIDER\fR\fR, \fB\-\-certificate\-provider=\fR\fB\fIPROVIDER\fR\fR
617 .RS 4
618 An OpenSSL provider to be used for loading the certificate used to sign the resulting binary and PCR measurements, see
619 \fBprovider\fR(7)\&. This option can only be used when
620 \fBsystemd\-sbsign\fR
621 is used as the signing tool\&.
622 .sp
623 Added in version 257\&.
624 .RE
625 .PP
626 \fISignKernel=\fR\fI\fIBOOL\fR\fR, \fB\-\-sign\-kernel\fR, \fB\-\-no\-sign\-kernel\fR
627 .RS 4
628 Override the detection of whether to sign the Linux binary itself before it is embedded in the combined image\&. If not specified, it will be signed if a SecureBoot signing key is provided via the
629 \fISecureBootPrivateKey=\fR/\fB\-\-secureboot\-private\-key=\fR
630 option and the binary has not already been signed\&. If
631 \fISignKernel=\fR/\fB\-\-sign\-kernel\fR
632 is true, and the binary has already been signed, the signature will be appended anyway\&.
633 .sp
634 Added in version 253\&.
635 .RE
636 .SS "[PCRSignature:\fINAME\fR] section"
637 .PP
638 In the config file, those options are grouped by section\&. On the command line, they must be specified in the same order\&. The sections specified in both sources are combined\&.
639 .PP
640 \fIPCRPrivateKey=\fR\fI\fIPATH\fR\fR, \fB\-\-pcr\-private\-key=\fR\fB\fIPATH\fR\fR
641 .RS 4
642 A private key to use for signing PCR policies\&. On the command line, this option may be specified more than once, in which case multiple signatures will be made\&.
643 .sp
644 Added in version 253\&.
645 .RE
646 .PP
647 \fIPCRPublicKey=\fR\fI\fIPATH\fR\fR, \fB\-\-pcr\-public\-key=\fR\fB\fIPATH\fR\fR
648 .RS 4
649 A public key to use for signing PCR policies\&.
650 .sp
651 On the command line, this option may be specified more than once, similarly to the
652 \fB\-\-pcr\-private\-key=\fR
653 option\&. If not present, the public keys will be extracted from the private keys\&. On the command line, if present, this option must be specified the same number of times as the
654 \fB\-\-pcr\-private\-key=\fR
655 option\&. Cannot be specified if
656 \fB\-\-pcr\-certificate=\fR
657 is used\&.
658 .sp
659 Added in version 253\&.
660 .RE
661 .PP
662 \fIPCRCertificate=\fR\fI\fIPATH\fR\fR, \fB\-\-pcr\-certificate=\fR\fB\fIPATH\fR\fR
663 .RS 4
664 An X\&.509 certificate to use for signing PCR policies\&.
665 .sp
666 On the command line, this option may be specified more than once, similarly to the
667 \fB\-\-pcr\-private\-key=\fR
668 option\&. If not present, the public keys will be extracted from the private keys\&. On the command line, if present, this option must be specified the same number of times as the
669 \fB\-\-pcr\-private\-key=\fR
670 option\&. Cannot be specified if
671 \fB\-\-pcr\-public\-key=\fR
672 is used\&.
673 .sp
674 Added in version 258\&.
675 .RE
676 .PP
677 \fIPhases=\fR\fI\fILIST\fR\fR, \fB\-\-phases=\fR\fB\fILIST\fR\fR
678 .RS 4
679 A comma or space\-separated list of colon\-separated phase paths to sign a policy for\&. Each set of boot phase paths will be signed with the corresponding private key\&. If not present, the default of
680 \fBsystemd-measure\fR(1)
681 will be used\&.
682 .sp
683 On the command line, when this argument is present, it must appear the same number of times as the
684 \fB\-\-pcr\-private\-key=\fR
685 option\&.
686 .sp
687 Added in version 253\&.
688 .RE
689 .SH "EXAMPLES"
690 .PP
691 \fBExample\ \&1.\ \&Minimal invocation\fR
692 .sp
693 .if n \{\
694 .RS 4
695 .\}
696 .nf
697 $ ukify build \e
698 \-\-linux=/lib/modules/6\&.0\&.9\-300\&.fc37\&.x86_64/vmlinuz \e
699 \-\-initrd=/some/path/initramfs\-6\&.0\&.9\-300\&.fc37\&.x86_64\&.img \e
700 \-\-cmdline=\*(Aqquiet rw\*(Aq
701 .fi
702 .if n \{\
703 .RE
704 .\}
705 .PP
706 This creates an unsigned UKI
707 \&./vmlinuz\&.unsigned\&.efi\&.
708 .PP
709 \fBExample\ \&2.\ \&Direct kernel boot in a virtual machine\fR
710 .PP
711 When using
712 \m[blue]\fBqemu\fR\m[]\&\s-2\u[2]\d\s+2
713 with
714 \m[blue]\fBOVMF\fR\m[]\&\s-2\u[4]\d\s+2
715 (UEFI Firmware for virtual machines) the
716 \fB\-kernel\fR
717 switch can be used directly with a UKI\&. Example:
718 .PP
719 \fBqemu\-kvm \-drive if=pflash,format=qcow2,readonly=on,file=/usr/share/edk2/ovmf/OVMF_CODE_4M\&.qcow2 \-kernel \fR\fB\&./vmlinuz\&.unsigned\&.efi\fR\fB \fR\fB\fI[ \&.\&.\&. ]\fR\fR\fB \fR
720 .PP
721 (The path to the firmware file might need to be adjusted depending on the distribution\&.) Usually, another
722 \fB\-drive\fR
723 argument would to be used to attach an actual disk image, but this is not required\&.
724 .PP
725 \fBExample\ \&3.\ \&All the bells and whistles\fR
726 .sp
727 .if n \{\
728 .RS 4
729 .\}
730 .nf
731 $ ukify build \e
732 \-\-linux=/lib/modules/6\&.0\&.9\-300\&.fc37\&.x86_64/vmlinuz \e
733 \-\-initrd=early_cpio \e
734 \-\-initrd=/some/path/initramfs\-6\&.0\&.9\-300\&.fc37\&.x86_64\&.img \e
735 \-\-sbat=\*(Aqsbat,1,SBAT Version,sbat,1,https://github\&.com/rhboot/shim/blob/main/SBAT\&.md
736 uki\&.author\&.myimage,1,UKI for System,uki\&.author\&.myimage,1,https://uapi\-group\&.org/specifications/specs/unified_kernel_image/\*(Aq \e
737 \-\-pcr\-private\-key=tpm2\-pcr\-initrd\-private\-key\&.pem \e
738 \-\-pcr\-public\-key=tpm2\-pcr\-initrd\-public\-key\&.pem \e
739 \-\-phases=\*(Aqenter\-initrd\*(Aq \e
740 \-\-pcr\-private\-key=tpm2\-pcr\-private\-key\-system\&.pem \e
741 \-\-pcr\-public\-key=tpm2\-pcr\-public\-key\-system\&.pem \e
742 \-\-phases=\*(Aqenter\-initrd:leave\-initrd enter\-initrd:leave\-initrd:sysinit \e
743 enter\-initrd:leave\-initrd:sysinit:ready\*(Aq \e
744 \-\-pcr\-banks=sha384,sha512 \e
745 \-\-secureboot\-private\-key=secureboot\-private\-key\&.pem \e
746 \-\-secureboot\-certificate=secureboot\-certificate\&.pem \e
747 \-\-sign\-kernel \e
748 \-\-cmdline=\*(Aqquiet rw rhgb\*(Aq
749 .fi
750 .if n \{\
751 .RE
752 .\}
753 .PP
754 This creates a signed UKI
755 \&./vmlinuz\&.signed\&.efi\&. The initrd section contains two concatenated parts,
756 early_cpio
757 and
758 initramfs\-6\&.0\&.9\-300\&.fc37\&.x86_64\&.img\&. The policy embedded in the
759 "\&.pcrsig"
760 section will be signed for the initrd (the
761 \fBenter\-initrd\fR
762 phase) with the key
763 tpm2\-pcr\-initrd\-private\-key\&.pem, and for the main system (phases
764 \fBleave\-initrd\fR,
765 \fBsysinit\fR,
766 \fBready\fR) with the key
767 tpm2\-pcr\-private\-key\-system\&.pem\&. The Linux binary and the resulting combined image will be signed with the SecureBoot key
768 secureboot\-private\-key\&.pem\&.
769 .PP
770 \fBExample\ \&4.\ \&All the bells and whistles, via a config file\fR
771 .PP
772 This is the same as the previous example, but this time the configuration is stored in a file:
773 .sp
774 .if n \{\
775 .RS 4
776 .\}
777 .nf
778 $ cat ukify\&.conf
779 [UKI]
780 Initrd=early_cpio
781 Cmdline=quiet rw rhgb
782
783 SecureBootPrivateKey=secureboot\-private\-key\&.pem
784 SecureBootCertificate=secureboot\-certificate\&.pem
785 SignKernel=yes
786 PCRBanks=sha384,sha512
787
788 [PCRSignature:initrd]
789 PCRPrivateKey=tpm2\-pcr\-initrd\-private\-key\&.pem
790 PCRPublicKey=tpm2\-pcr\-initrd\-public\-key\&.pem
791 Phases=enter\-initrd
792
793 [PCRSignature:system]
794 PCRPrivateKey=tpm2\-pcr\-private\-key\-system\&.pem
795 PCRPublicKey=tpm2\-pcr\-public\-key\-system\&.pem
796 Phases=enter\-initrd:leave\-initrd
797 enter\-initrd:leave\-initrd:sysinit
798 enter\-initrd:leave\-initrd:sysinit:ready
799
800 $ ukify \-c ukify\&.conf build \e
801 \-\-linux=/lib/modules/6\&.0\&.9\-300\&.fc37\&.x86_64/vmlinuz \e
802 \-\-initrd=/some/path/initramfs\-6\&.0\&.9\-300\&.fc37\&.x86_64\&.img
803 .fi
804 .if n \{\
805 .RE
806 .\}
807 .PP
808 One "initrd" (early_cpio) is specified in the config file, and the other initrd (initramfs\-6\&.0\&.9\-300\&.fc37\&.x86_64\&.img) is specified on the command line\&. This may be useful for example when the first initrd contains microcode for the CPU and does not need to be updated when the kernel version changes, unlike the actual initrd\&.
809 .PP
810 \fBExample\ \&5.\ \&Kernel command line PE addon\fR
811 .sp
812 .if n \{\
813 .RS 4
814 .\}
815 .nf
816 ukify build \e
817 \-\-secureboot\-private\-key=secureboot\-private\-key\&.pem \e
818 \-\-secureboot\-certificate=secureboot\-certificate\&.pem \e
819 \-\-cmdline=\*(Aqdebug\*(Aq \e
820 \-\-sbat=\*(Aqsbat,1,SBAT Version,sbat,1,https://github\&.com/rhboot/shim/blob/main/SBAT\&.md
821 uki\-addon\&.author,1,UKI Addon for System,uki\-addon\&.author,1,https://www\&.freedesktop\&.org/software/systemd/man/systemd\-stub\&.html\*(Aq
822 \-\-output=debug\&.addon\&.efi
823 .fi
824 .if n \{\
825 .RE
826 .\}
827 .PP
828 This creates a signed PE binary that contains the additional kernel command line parameter
829 "debug"
830 with SBAT metadata referring to the owner of the addon\&.
831 .PP
832 \fBExample\ \&6.\ \&Decide signing policy, and create certificate and keys\fR
833 .PP
834 First, let\*(Aqs create a configuration file that specifies what signatures shall be made:
835 .sp
836 .if n \{\
837 .RS 4
838 .\}
839 .nf
840 # cat >/etc/kernel/uki\&.conf <<EOF
841 [UKI]
842 SecureBootPrivateKey=/etc/kernel/secureboot\-private\-key\&.pem
843 SecureBootCertificate=/etc/kernel/secureboot\-certificate\&.pem
844
845 [PCRSignature:initrd]
846 Phases=enter\-initrd
847 PCRPrivateKey=/etc/systemd/tpm2\-pcr\-initrd\-private\-key\&.pem
848 PCRPublicKey=/etc/systemd/tpm2\-pcr\-initrd\-public\-key\&.pem
849
850 [PCRSignature:system]
851 Phases=enter\-initrd:leave\-initrd enter\-initrd:leave\-initrd:sysinit
852 enter\-initrd:leave\-initrd:sysinit:ready
853 PCRPrivateKey=/etc/systemd/tpm2\-pcr\-private\-key\-system\&.pem
854 PCRPublicKey=/etc/systemd/tpm2\-pcr\-public\-key\-system\&.pem
855 EOF
856 .fi
857 .if n \{\
858 .RE
859 .\}
860 .PP
861 Next, we can generate the certificate and keys:
862 .sp
863 .if n \{\
864 .RS 4
865 .\}
866 .nf
867 # ukify genkey \-\-config=/etc/kernel/uki\&.conf
868 Writing SecureBoot private key to /etc/kernel/secureboot\-private\-key\&.pem
869 Writing SecureBoot certificate to /etc/kernel/secureboot\-certificate\&.pem
870 Writing private key for PCR signing to /etc/systemd/tpm2\-pcr\-initrd\-private\-key\&.pem
871 Writing public key for PCR signing to /etc/systemd/tpm2\-pcr\-initrd\-public\-key\&.pem
872 Writing private key for PCR signing to /etc/systemd/tpm2\-pcr\-private\-key\-system\&.pem
873 Writing public key for PCR signing to /etc/systemd/tpm2\-pcr\-public\-key\-system\&.pem
874 .fi
875 .if n \{\
876 .RE
877 .\}
878 .PP
879 (Both operations need to be done as root to allow write access to
880 /etc/kernel/\&.)
881 .PP
882 Subsequent invocations using the config file (\fBukify build \-\-config=/etc/kernel/uki\&.conf\fR) will use this certificate and key files\&. Note that the
883 \fBkernel-install\fR(8)
884 plugin
885 60\-ukify\&.install
886 uses
887 /etc/kernel/uki\&.conf
888 by default, so after this file has been created, installations of kernels that create a UKI on the local machine using
889 \fBkernel\-install\fR
890 will perform signing using this config\&.
891 .PP
892 \fBExample\ \&7.\ \&Multi\-Profile UKI\fR
893 .PP
894 First, create a few profiles:
895 .sp
896 .if n \{\
897 .RS 4
898 .\}
899 .nf
900 $ ukify build \e
901 \-\-profile=\*(AqTITLE=Base\*(Aq \e
902 \-\-output=profile0\&.efi
903 .fi
904 .if n \{\
905 .RE
906 .\}
907 .PP
908 Add a second profile (@1):
909 .sp
910 .if n \{\
911 .RS 4
912 .\}
913 .nf
914 $ ukify build \e
915 \-\-profile=\*(AqTITLE=Boot into Storage Target Mode
916 ID=storagetm\*(Aq \e
917 \-\-cmdline=\*(Aqquiet rw rd\&.systemd\&.unit=storage\-target\-mode\&.target\*(Aq \e
918 \-\-output=profile1\&.efi
919 .fi
920 .if n \{\
921 .RE
922 .\}
923 .PP
924 Add a third profile (@2):
925 .sp
926 .if n \{\
927 .RS 4
928 .\}
929 .nf
930 $ ukify build \e
931 \-\-profile=\*(AqTITLE=Factory Reset
932 ID=factory\-reset\*(Aq \e
933 \-\-cmdline=\*(Aqquiet rw systemd\&.unit=factory\-reset\&.target\*(Aq \e
934 \-\-output=profile2\&.efi
935 .fi
936 .if n \{\
937 .RE
938 .\}
939 .PP
940 Then, create a UKI and include all the generated profiles:
941 .sp
942 .if n \{\
943 .RS 4
944 .\}
945 .nf
946 $ ukify build \e
947 \-\-linux=/lib/modules/6\&.0\&.9\-300\&.fc37\&.x86_64/vmlinuz \e
948 \-\-initrd=/some/path/initramfs\-6\&.0\&.9\-300\&.fc37\&.x86_64\&.img \e
949 \-\-cmdline=\*(Aqquiet rw\*(Aq \e
950 \-\-join\-profile=profile0\&.efi \e
951 \-\-join\-profile=profile1\&.efi \e
952 \-\-join\-profile=profile2\&.efi \e
953 \-\-output=base\&.efi
954 .fi
955 .if n \{\
956 .RE
957 .\}
958 .PP
959 The resulting UKI
960 base\-with\-profile\-0\-1\-2\&.efi
961 will now contain three profiles\&.
962 .PP
963 \fBExample\ \&8.\ \&Offline signing of pcrsig section\fR
964 .PP
965 First, create a UKI and save the PCR JSON blob:
966 .sp
967 .if n \{\
968 .RS 4
969 .\}
970 .nf
971 $ ukify build \e
972 \-\-linux=/lib/modules/6\&.0\&.9\-300\&.fc37\&.x86_64/vmlinuz \e
973 \-\-initrd=/some/path/initramfs\-6\&.0\&.9\-300\&.fc37\&.x86_64\&.img \e
974 \-\-cmdline=\*(Aqquiet rw\*(Aq \e
975 \-\-pcr\-public\-key=tpm2\-pcr\-initrd\-public\-key\&.pem \e
976 \-\-policy\-digest \e
977 \-\-json=short \e
978 \-\-output=base\&.efi >base\&.pcrs
979 .fi
980 .if n \{\
981 .RE
982 .\}
983 .PP
984 Then, sign the PCR digests offline and insert them in the JSON blob:
985 .sp
986 .if n \{\
987 .RS 4
988 .\}
989 .nf
990 #!/usr/bin/python3
991 import base64, json, subprocess
992
993 priv_key = \*(Aq/home/zbyszek/src/systemd/tpm2\-pcr\-private\&.pem\*(Aq
994 base_file = \*(Aqbase\&.pcrs\*(Aq
995
996 base = json\&.load(open(base_file))
997
998 for bank,policies in base\&.items():
999 for policy in policies:
1000 pol = base64\&.b16decode(policy[\*(Aqpol\*(Aq]\&.upper())
1001 call = subprocess\&.run([\*(Aqopenssl\*(Aq, \*(Aqdgst\*(Aq, f\*(Aq\-{bank}\*(Aq, \*(Aq\-sign\*(Aq, priv_key],
1002 input=pol,
1003 check=True,
1004 capture_output=True)
1005 sig = base64\&.b64encode(call\&.stdout)\&.decode()
1006 policy[\*(Aqsig\*(Aq] = sig
1007
1008 print(json\&.dumps(base))
1009 .fi
1010 .if n \{\
1011 .RE
1012 .\}
1013 .PP
1014 Finally, attach the updated JSON blob to the UKI:
1015 .sp
1016 .if n \{\
1017 .RS 4
1018 .\}
1019 .nf
1020 $ ukify build \e
1021 \-\-join\-pcrsig=base\&.efi \e
1022 \-\-pcrsig=@base\&.pcrs \e
1023 \-\-json=short \e
1024 \-\-output=base\-signed\&.efi
1025 .fi
1026 .if n \{\
1027 .RE
1028 .\}
1029 .PP
1030 The resulting UKI
1031 base\-signed\&.efi
1032 will now contain the signed PCR digests\&.
1033 .SH "SEE ALSO"
1034 .PP
1035 \fBsystemd\fR(1), \fBsystemd-stub\fR(7), \fBsystemd-boot\fR(7), \fBsystemd-measure\fR(1), \fBsystemd-pcrphase.service\fR(8)
1036 .SH "NOTES"
1037 .IP " 1." 4
1038 UAPI.5 Unified Kernel Image (UKI)
1039 .RS 4
1040 \%https://uapi-group.org/specifications/specs/unified_kernel_image/
1041 .RE
1042 .IP " 2." 4
1043 qemu
1044 .RS 4
1045 \%https://www.qemu.org/docs/master/
1046 .RE
1047 .IP " 3." 4
1048 Shim documentation
1049 .RS 4
1050 \%https://github.com/rhboot/shim/blob/main/SBAT.md
1051 .RE
1052 .IP " 4." 4
1053 OVMF
1054 .RS 4
1055 \%https://www.linux-kvm.org/downloads/lersek/ovmf-whitepaper-c770f8c.txt
1056 .RE