Debian Codegraph @

upstream/debian-unstable/man8/systemd-tpm2-swtpm.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-TPM2\-SWTPM\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-tpm2-swtpm.service"
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-swtpm.service, systemd-tpm2-swtpm \- Provide a fallback software TPM
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-tpm2\-swtpm\&.service
27 .PP
28 /usr/lib/systemd/systemd\-tpm2\-swtpm
29 .SH "DESCRIPTION"
30 .PP
31 The
32 systemd\-tpm2\-swtpm\&.service
33 provides fallback software TPM functionality, intended for use in environments where a discrete or firmware TPM ("hardware TPM") is not available\&. It is pulled into the boot process by
34 \fBsystemd-tpm2-generator\fR(8)
35 if a hardware TPM is not available, and the system is configured to provide a software TPM in that case\&.
36 .PP
37 Note that a software TPM provides only very weak security properties compared to a hardware TPM, and hence should only be used as a fallback mechanism if a hardware TPM is not available but TPM semantics are desired\&. This service ultimately wraps
38 \fBswtpm\fR(8)\&.
39 .PP
40 If the boot secret
41 /\&.extra/boot\-secret
42 (in the initrd) or
43 /run/systemd/stub/boot\-secret
44 (on the host) is available the software TPM NVRAM storage is encrypted with this key\&. See
45 \fBsystemd-stub\fR(7)
46 for details\&.
47 .PP
48 The TPM NVRAM storage is placed on the EFI System Partition as it needs to be accessible during very early boot\-up, in particular before the root file system is decrypted and mounted\&.
49 .SH "SEE ALSO"
50 .PP
51 \fBsystemd\fR(1), \fBsystemd-tpm2-generator\fR(8), \fBswtpm\fR(8), \fBsystemd-stub\fR(7)