mirror of
https://git.sr.ht/~nabijaczleweli/tzpfms
synced 2025-04-19 09:47:35 +03:00
90 lines
1.8 KiB
Groff
90 lines
1.8 KiB
Groff
.\" SPDX-License-Identifier: MIT
|
|
.
|
|
.Dd March 11, 2024
|
|
.ds doc-volume-operating-system
|
|
.Dt ZFS-TPM1X-CLEAR-KEY 8
|
|
.Os tzpfms 0.4.1-1-gfd16dbb
|
|
.
|
|
.Sh NAME
|
|
.Nm zfs-tpm1x-clear-key
|
|
.Nd rewrap ZFS dataset key in passsword and clear tzpfms TPM1.X metadata
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Ar dataset
|
|
.
|
|
.Sh DESCRIPTION
|
|
After verifying
|
|
.Ar dataset
|
|
was encrypted with the
|
|
.Nm tzpfms
|
|
.Sy TPM1.X
|
|
backend:
|
|
.Bl -enum -compact -offset 2n -width 2n
|
|
.It
|
|
performs the equivalent of
|
|
.Nm zfs Cm change-key Fl o Li keylocation=prompt Fl o Li keyformat=passphrase Ar dataset ,
|
|
.It
|
|
removes the
|
|
.Li xyz.nabijaczleweli:tzpfms.\& Ns Brq Li backend , key
|
|
properties from
|
|
.Ar dataset .
|
|
.El
|
|
.Pp
|
|
See
|
|
.Xr zfs-tpm1x-change-key 8
|
|
for a detailed description.
|
|
.
|
|
.\" SPDX-License-Identifier: MIT
|
|
.
|
|
.Sh TPM1.X back-end configuration
|
|
.Ss TPM selection
|
|
The
|
|
.Nm tzpfms
|
|
suite connects to a local
|
|
.Xr tcsd 8
|
|
process
|
|
.Pq at Pa localhost:30003
|
|
by default.
|
|
Use the environment variable
|
|
.Ev TZPFMS_TPM1X
|
|
to specify a remote TCS hostname.
|
|
.Pp
|
|
The TrouSerS
|
|
.Xr tcsd 8
|
|
daemon will try
|
|
.Pa /dev/tpm0 ,
|
|
then
|
|
.Pa /udev/tpm0 ,
|
|
then
|
|
.Pa /dev/tpm ;
|
|
by occupying one of the earlier ones with, for example, shell redirection, a later one can be selected.
|
|
.
|
|
.Ss See also
|
|
The TrouSerS project page at
|
|
.Lk https:/\&/sourceforge.net/projects/trousers .
|
|
.Pp
|
|
The TPM 1.2 main specification index at
|
|
.Lk https:/\&/trustedcomputinggroup.org/resource/tpm-main-specification .
|
|
.
|
|
.\" SPDX-License-Identifier: MIT
|
|
.
|
|
.Sh SPECIAL THANKS
|
|
To all who support further development, in particular:
|
|
.Bl -bullet -offset 4n -compact -width "@"
|
|
.It
|
|
ThePhD
|
|
.It
|
|
Embark Studios
|
|
.It
|
|
Jasper Bekkers
|
|
.It
|
|
EvModder
|
|
.El
|
|
.
|
|
.Sh REPORTING BUGS
|
|
.Lk https:/\&/todo.sr.ht/\(tinabijaczleweli/tzpfms
|
|
.Pp
|
|
.Mt \(tinabijaczleweli/tzpfms@lists.sr.ht ,
|
|
archived at
|
|
.Lk https:/\&/lists.sr.ht/\(tinabijaczleweli/tzpfms .
|