Debian Codegraph @

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

raw
1 '\" t
2 .TH "SYSTEMD\-TPM2\-SETUP\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-tpm2-setup.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-setup.service, systemd-tpm2-setup-early.service, systemd-tpm2-setup \- Set up the TPM2 Storage Root Key (SRK) and initialize NvPCRs at boot
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-tpm2\-setup\&.service
27 .PP
28 /usr/lib/systemd/systemd\-tpm2\-setup
29 .SH "DESCRIPTION"
30 .PP
31 systemd\-tpm2\-setup\&.service
32 and
33 systemd\-tpm2\-setup\-early\&.service
34 are services that generate the Storage Root Key (SRK) if it has not been generated yet, and stores it in the TPM\&. If NvPCRs (additional PCR registers in TPM NV Indexes) are defined, these are initialized with the anchoring secret\&.
35 .PP
36 The services will store the public key of the SRK key pair in a PEM file in
37 /run/systemd/tpm2\-srk\-public\-key\&.pem
38 and
39 /var/lib/systemd/tpm2\-srk\-public\-key\&.pem\&. They will also store it in TPM2B_PUBLIC format in
40 /run/systemd/tpm2\-srk\-public\-key\&.tpm2_public
41 and
42 /var/lib/systemd/tpm2\-srk\-public\-key\&.tpm2b_public\&.
43 .PP
44 systemd\-tpm2\-setup\-early\&.service
45 runs very early at boot (possibly in the initrd), and writes the SRK public key to
46 /run/systemd/tpm2\-srk\-public\-key\&.*
47 (as
48 /var/
49 is generally not accessible this early yet), while
50 systemd\-tpm2\-setup\&.service
51 runs during a later boot phase and saves the public key to
52 /var/lib/systemd/tpm2\-srk\-public\-key\&.*\&.
53 .SH "FILES"
54 .PP
55 /run/systemd/tpm2\-srk\-public\-key\&.pem, /run/systemd/tpm2\-srk\-public\-key\&.tpm2b_public
56 .RS 4
57 The SRK public key in PEM and TPM2B_PUBLIC format, written during early boot\&.
58 .sp
59 Added in version 255\&.
60 .RE
61 .PP
62 /var/lib/systemd/tpm2\-srk\-public\-key\&.pem, /var/lib/systemd/tpm2\-srk\-public\-key\&.tpm2_public
63 .RS 4
64 The SRK public key in PEM and TPM2B_PUBLIC format, written during later boot (once
65 /var/
66 is available)\&.
67 .sp
68 Added in version 255\&.
69 .RE
70 .PP
71 /usr/lib/nvpcr/*\&.nvpcr
72 .RS 4
73 Definition files for NvPCRs\&.
74 .sp
75 Added in version 259\&.
76 .RE
77 .PP
78 /run/credentials/@encrypted/nvpcr\-anchor\&.*
79 .RS 4
80 Encrypted NvPCR anchor secret, received into the system via system credentials\&.
81 .sp
82 Added in version 259\&.
83 .RE
84 .PP
85 $BOOT/loader/credentials/nvpcr\-anchor\&.*\&.cred
86 .RS 4
87 Encrypted NvPCR anchor secret, to be picked up by the kernel loader stub, i\&.e\&.
88 \fBsystemd-stub\fR(7)\&.
89 .sp
90 Added in version 259\&.
91 .RE
92 .SH "SEE ALSO"
93 .PP
94 \fBsystemd\fR(1)