Debian Codegraph @

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

raw
1 '\" t
2 .TH "SYSTEMD\-TPM2\-CLEAR\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-tpm2-clear.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-clear.service \- Request that the TPM security chip is cleared on next boot
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-tpm2\-clear\&.service
27 .PP
28 /usr/lib/systemd/systemd\-tpm2\-clear
29 .SH "DESCRIPTION"
30 .PP
31 systemd\-tpm2\-clear\&.service
32 is a service that requests that the TPM is reset by the PC firmware on the next boot\&. It makes use of the TPM Physical Presence Interface (PPI)\&. Note that this service does not immediately execute the clear operation, but simply asks the PC firmware to execute it at next boot, where the user will be asked for confirmation before the operation is done\&.
33 .PP
34 systemd\-tpm2\-clear\&.service
35 is typically hooked into the
36 factory\-reset\&.target
37 unit in order to request the TPM request before an immediate reboot\&. See
38 \m[blue]\fBFactory Reset\fR\m[]\&\s-2\u[1]\d\s+2
39 for more information\&.
40 .SH "OPTIONS"
41 .PP
42 The following options are understood:
43 .PP
44 \fB\-\-graceful\fR
45 .RS 4
46 Exit cleanly and execute no operation if the system does not possess a TPM chip\&.
47 .sp
48 Added in version 258\&.
49 .RE
50 .PP
51 \fB\-h\fR, \fB\-\-help\fR
52 .RS 4
53 Print a short help text and exit\&.
54 .RE
55 .PP
56 \fB\-\-version\fR
57 .RS 4
58 Print a short version string and exit\&.
59 .RE
60 .SH "KERNEL COMMAND LINE"
61 .PP
62 systemd\-tpm2\-clear
63 understands the following kernel command line parameters:
64 .PP
65 \fIsystemd\&.tpm2_allow_clear=\fR
66 .RS 4
67 Takes a boolean argument\&. If false the service will succeed, but instead of requesting the TPM clear operation from the PC firmware it will not execute any operation\&. If not specified defaults to true\&.
68 .sp
69 Added in version 258\&.
70 .RE
71 .SH "SEE ALSO"
72 .PP
73 \fBsystemd\fR(1), \fBsystemd-tpm2-setup.service\fR(8), \fBsystemd-factory-reset-request.service\fR(8)
74 .SH "NOTES"
75 .IP " 1." 4
76 Factory Reset
77 .RS 4
78 \%https://systemd.io/FACTORY_RESET
79 .RE