From 63d575615fed82f7bc1718a9a3debc8cf280e0bb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=BD=D0=B0=D0=B1=20autouploader?= Date: Sat, 31 Oct 2020 17:37:42 +0000 Subject: [PATCH] Manpage update by job 332079 --- zfs-tpm-list.8 | 19 ++++++++++++++++--- zfs-tpm-list.8.html | 17 ++++++++++++++--- zfs-tpm-list.8.html_fragment | 17 ++++++++++++++--- zfs-tpm-list.md | 19 ++++++++++++++++--- 4 files changed, 60 insertions(+), 12 deletions(-) diff --git a/zfs-tpm-list.8 b/zfs-tpm-list.8 index 621b114..2c2c331 100644 --- a/zfs-tpm-list.8 +++ b/zfs-tpm-list.8 @@ -4,7 +4,7 @@ .SH "NAME" \fBzfs\-tpm\-list\fR \- print dataset tzpfms metadata .SH "SYNOPSIS" -\fBzfs\-tpm\-list\fR [\-H] [\-r|\-d \fIdepth\fR] [\-a|\-b \fIback\-end\fR] [\fIfilesystem\fR|\fIvolume\fR]… +\fBzfs\-tpm\-list\fR [\-H] [\-r|\-d \fIdepth\fR] [\-a|\-b \fIback\-end\fR] [\-u|\-l] [\fIfilesystem\fR|\fIvolume\fR]… .SH "DESCRIPTION" zfs\-tpm\-list(8) lists the following properties on encryption roots: .IP "\[ci]" 4 @@ -17,9 +17,9 @@ zfs\-tpm\-list(8) lists the following properties on encryption roots: \fBcoherent\fR: "yes" if either both \fBxyz\.nabijaczleweli:tzpfms\.backend\fR and \fBxyz\.nabijaczleweli:tzpfms\.key\fR are present or missing, "no" otherwise\. .IP "" 0 .P -Incoherent datasets require immediate operator attention, with either the appropriate zfs\-tpm*\-clear\-key program or zfs(8) change\-key \(em if the key becomes unloaded, they will require restoration from back\-up\. However, they should never occur, unless something went terribly wrong with the dataset properties\. +Incoherent datasets require immediate operator attention, with either the appropriate zfs\-tpm*\-clear\-key program or zfs(8) change\-key and zfs(8) inherit \(em if the key becomes unloaded, they will require restoration from back\-up\. However, they should never occur, unless something went terribly wrong with the dataset properties\. .P -If no datasets are specified, lists all matching encryption roots\. The default filter is to list all roots managed by tzpfms\. The \fB\-a\fR and \fB\-b\fR OPTIONS \fI\fR can be used to list all roots or only ones backed by a particular end\. +If no datasets are specified, lists all matching encryption roots\. The default filter is to list all roots managed by tzpfms\. The \fB\-a\fR and \fB\-b\fR OPTIONS \fI\fR can be used to either list all roots or only ones backed by a particular end, respectively\. .SH "OPTIONS" .TP \fB\-H\fR @@ -36,6 +36,12 @@ List all encryption roots, even ones not managed by tzpfms\. .TP \fB\-b\fR \fIback\-end\fR List only encryption roots with tzpfms back\-end \fIback\-end\fR\. +.TP +\fB\-l\fR +List only encryption roots whose keys are available\. +.TP +\fB\-u\fR +List only encryption roots whose keys are unavailable\. .SH "EXAMPLES" .nf $ zfs\-tpm\-list @@ -57,6 +63,13 @@ owo/venc TPM2 unavailable yes owo/vtnc \- available yes owo/v nc \- available yes owo/enc TPM1\.X available yes + +$ zfs\-tpm\-list \-al +NAME BACK\-END KEYSTATUS COHERENT +awa \- available yes +owo/vtnc \- available yes +owo/v nc \- available yes +owo/enc TPM1\.X available yes .fi .SH "AUTHOR" Written by наб <\fInabijaczleweli@nabijaczleweli\.xyz\fR> diff --git a/zfs-tpm-list.8.html b/zfs-tpm-list.8.html index cd8100a..2dff9a6 100644 --- a/zfs-tpm-list.8.html +++ b/zfs-tpm-list.8.html @@ -78,7 +78,7 @@

SYNOPSIS

-

zfs-tpm-list [-H] [-r|-d depth] [-a|-b back-end] [filesystem|volume]…

+

zfs-tpm-list [-H] [-r|-d depth] [-a|-b back-end] [-u|-l] [filesystem|volume]…

DESCRIPTION

@@ -96,13 +96,13 @@ coherent: "yes" if either both xyz.nabijaczleweli:tzpfms.backend and xyz.nabijaczleweli:tzpfms.key are present or missing, "no" otherwise. -

Incoherent datasets require immediate operator attention, with either the appropriate zfs-tpm*-clear-key program or zfs(8) change-key — +

Incoherent datasets require immediate operator attention, with either the appropriate zfs-tpm*-clear-key program or zfs(8) change-key and zfs(8) inherit — if the key becomes unloaded, they will require restoration from back-up. However, they should never occur, unless something went terribly wrong with the dataset properties.

If no datasets are specified, lists all matching encryption roots. The default filter is to list all roots managed by tzpfms. -The -a and -b OPTIONS can be used to list all roots or only ones backed by a particular end.

+The -a and -b OPTIONS can be used to either list all roots or only ones backed by a particular end, respectively.

OPTIONS

@@ -121,6 +121,10 @@ The -a and -b OPTIONS can be used to li -b back-end
List only encryption roots with tzpfms back-end back-end.
+
-l
+
List only encryption roots whose keys are available.
+
-u
+
List only encryption roots whose keys are unavailable.

EXAMPLES

@@ -144,6 +148,13 @@ owo/venc TPM2 unavailable yes owo/vtnc - available yes owo/v nc - available yes owo/enc TPM1.X available yes + +$ zfs-tpm-list -al +NAME BACK-END KEYSTATUS COHERENT +awa - available yes +owo/vtnc - available yes +owo/v nc - available yes +owo/enc TPM1.X available yes

AUTHOR

diff --git a/zfs-tpm-list.8.html_fragment b/zfs-tpm-list.8.html_fragment index 3ee4a74..9eb6d70 100644 --- a/zfs-tpm-list.8.html_fragment +++ b/zfs-tpm-list.8.html_fragment @@ -6,7 +6,7 @@

SYNOPSIS

-

zfs-tpm-list [-H] [-r|-d depth] [-a|-b back-end] [filesystem|volume]…

+

zfs-tpm-list [-H] [-r|-d depth] [-a|-b back-end] [-u|-l] [filesystem|volume]…

DESCRIPTION

@@ -24,13 +24,13 @@ coherent: "yes" if either both xyz.nabijaczleweli:tzpfms.backend and xyz.nabijaczleweli:tzpfms.key are present or missing, "no" otherwise. -

Incoherent datasets require immediate operator attention, with either the appropriate zfs-tpm*-clear-key program or zfs(8) change-key — +

Incoherent datasets require immediate operator attention, with either the appropriate zfs-tpm*-clear-key program or zfs(8) change-key and zfs(8) inherit — if the key becomes unloaded, they will require restoration from back-up. However, they should never occur, unless something went terribly wrong with the dataset properties.

If no datasets are specified, lists all matching encryption roots. The default filter is to list all roots managed by tzpfms. -The -a and -b OPTIONS can be used to list all roots or only ones backed by a particular end.

+The -a and -b OPTIONS can be used to either list all roots or only ones backed by a particular end, respectively.

OPTIONS

@@ -49,6 +49,10 @@ The -a and -b OPTIONS can be used to li -b back-end
List only encryption roots with tzpfms back-end back-end.
+
-l
+
List only encryption roots whose keys are available.
+
-u
+
List only encryption roots whose keys are unavailable.

EXAMPLES

@@ -72,6 +76,13 @@ owo/venc TPM2 unavailable yes owo/vtnc - available yes owo/v nc - available yes owo/enc TPM1.X available yes + +$ zfs-tpm-list -al +NAME BACK-END KEYSTATUS COHERENT +awa - available yes +owo/vtnc - available yes +owo/v nc - available yes +owo/enc TPM1.X available yes

AUTHOR

diff --git a/zfs-tpm-list.md b/zfs-tpm-list.md index faaf77d..0609833 100644 --- a/zfs-tpm-list.md +++ b/zfs-tpm-list.md @@ -3,7 +3,7 @@ zfs-tpm-list(8) -- print dataset tzpfms metadata ## SYNOPSIS -`zfs-tpm-list` [-H] [-r\|-d *depth*] [-a\|-b *back-end*] [*filesystem*\|*volume*]… +`zfs-tpm-list` [-H] [-r\|-d *depth*] [-a\|-b *back-end*] [-u\|-l] [*filesystem*\|*volume*]… ## DESCRIPTION @@ -15,13 +15,13 @@ zfs-tpm-list(8) lists the following properties on encryption roots: * `keystatus`: "available" or "unavailable", * `coherent`: "yes" if either both `xyz.nabijaczleweli:tzpfms.backend` and `xyz.nabijaczleweli:tzpfms.key` are present or missing, "no" otherwise. -Incoherent datasets require immediate operator attention, with either the appropriate zfs-tpm\*-clear-key program or zfs(8) change-key — +Incoherent datasets require immediate operator attention, with either the appropriate zfs-tpm\*-clear-key program or zfs(8) change-key and zfs(8) inherit — if the key becomes unloaded, they will require restoration from back-up. However, they should never occur, unless something went terribly wrong with the dataset properties. If no datasets are specified, lists all matching encryption roots. The default filter is to list all roots managed by tzpfms. -The `-a` and `-b` [OPTIONS]() can be used to list all roots or only ones backed by a particular end. +The `-a` and `-b` [OPTIONS]() can be used to either list all roots or only ones backed by a particular end, respectively. ## OPTIONS @@ -38,6 +38,11 @@ The `-a` and `-b` [OPTIONS]() can be used to list all roots or only ones backed * `-b` *back-end*: List only encryption roots with tzpfms back-end *back-end*. + * `-l`: + List only encryption roots whose keys are available. + * `-u`: + List only encryption roots whose keys are unavailable. + ## EXAMPLES $ zfs-tpm-list @@ -60,6 +65,14 @@ The `-a` and `-b` [OPTIONS]() can be used to list all roots or only ones backed owo/v nc - available yes owo/enc TPM1.X available yes + $ zfs-tpm-list -al + NAME BACK-END KEYSTATUS COHERENT + awa - available yes + owo/vtnc - available yes + owo/v nc - available yes + owo/enc TPM1.X available yes + + ## AUTHOR Written by наб <>