Debian Codegraph @

upstream/debian-unstable/man8/systemd-tpm2-generator.8

raw
1 '\" t
2 .TH "SYSTEMD\-TPM2\-GENERATOR" "8" "" "systemd 261~rc3" "systemd-tpm2-generator"
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 systemd-tpm2-generator \- Generator for inserting TPM2 synchronization point in the boot process
24 .SH "SYNOPSIS"
25 .PP
26 /usr/lib/systemd/system\-generators/systemd\-tpm2\-generator
27 .SH "DESCRIPTION"
28 .PP
29 \fBsystemd\-tpm2\-generator\fR
30 is a generator that adds a
31 \fIWants=\fR
32 dependency from
33 sysinit\&.target
34 to
35 tpm2\&.target
36 when it detects that the firmware discovered a TPM2 device but the OS kernel so far did not\&.
37 tpm2\&.target
38 is supposed to act as synchronization point for all services that require TPM2 device access\&. See
39 \fBsystemd.special\fR(7)
40 for details\&.
41 .PP
42 The
43 \fBsystemd\&.tpm2_wait=\fR
44 kernel command line option may be used to override behaviour of the generator\&. It accepts a boolean value: if true then
45 tpm2\&.target
46 will be added as synchronization point even if the firmware has not detected a TPM2 device\&. If false, the target will not be inserted even if firmware reported a device but the OS kernel does not expose a device for it yet\&. The latter might be useful in environments where a suitable TPM2 driver for the available hardware is not available\&.
47 .PP
48 The
49 \fBsystemd\&.tpm2_software_fallback=\fR
50 kernel command line option (which takes a boolean argument, defaulting to false) may be used to enable an automatic software TPM fallback in case a hardware TPM is not detected and
51 \fBswtpm\fR(8)
52 is available\&. This pulls in the
53 \fBsystemd-tpm2-swtpm.service\fR(8)
54 service\&.
55 .PP
56 \fBsystemd\-tpm2\-generator\fR
57 implements
58 \fBsystemd.generator\fR(7)\&.
59 .SH "SEE ALSO"
60 .PP
61 \fBsystemd\fR(1), \fBsystemd.special\fR(7), \fBkernel-command-line\fR(7), \fBsystemd-tpm2-swtpm.service\fR(8)