mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
Steffen Eiden
a8a3e7d49c
Acked-by: Marc Hartmayer <marc@linux.ibm.com> Reviewed-by: Christoph Schlameuss <schlameuss@linux.ibm.com> Signed-off-by: Steffen Eiden <seiden@linux.ibm.com> Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
62 lines
1.4 KiB
Groff
62 lines
1.4 KiB
Groff
.\" Copyright 2023, 2024 IBM Corp.
|
|
.\" s390-tools is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the MIT license. See LICENSE for details.
|
|
.\"
|
|
|
|
.TH "PVSECRET-CREATE-ASSOCIATION" "1" "2024-12-19" "s390-tools" "UV-Secret Manual"
|
|
.nh
|
|
.ad l
|
|
.SH NAME
|
|
pvsecret-create-association \- Create an association secret
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.fam C
|
|
pvsecret create association [OPTIONS] <NAME>
|
|
.fam C
|
|
.fi
|
|
.SH DESCRIPTION
|
|
Use an association secret to connect a trusted I/O device to a guest. The
|
|
\fBpvapconfig\fR tool provides more information about association secrets.
|
|
.SH OPTIONS
|
|
.PP
|
|
<NAME>
|
|
.RS 4
|
|
String that identifies the new secret. The actual secret is set with
|
|
\fB\-\-input\-secret\fR. The name is saved in `NAME.yaml` with white\-spaces
|
|
mapped to `_`.
|
|
.RE
|
|
.RE
|
|
|
|
.PP
|
|
\-\-stdout
|
|
.RS 4
|
|
Print the hashed name to stdout. The hashed name is not written to `NAME.yaml`
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\-\-input\-secret <SECRET-FILE>
|
|
.RS 4
|
|
Path from which to read the plaintext secret. Uses a random secret if not
|
|
specified.
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\-\-output\-secret <SECRET-FILE>
|
|
.RS 4
|
|
Save the generated secret as plaintext in SECRET\-FILE. The generated secret can
|
|
be used to generate add\-secret requests for a different guest with the same
|
|
secret using \fB\-\-input\-secret\fR. Destroy the secret when it is not used
|
|
anymore.
|
|
.RE
|
|
.RE
|
|
.PP
|
|
\-h, \-\-help
|
|
.RS 4
|
|
Print help (see a summary with \fB\-h\fR).
|
|
.RE
|
|
.RE
|
|
|
|
.SH "SEE ALSO"
|
|
.sp
|
|
\fBpvsecret\fR(1) \fBpvsecret-create\fR(1)
|