mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
Steffen Eiden
1d6f7d0bec
man and README got out of sync with --help over time. Resync them. Reviewed-by: Jan Höppner <hoeppner@linux.ibm.com> Signed-off-by: Steffen Eiden <seiden@linux.ibm.com> Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
78 lines
1.6 KiB
Groff
78 lines
1.6 KiB
Groff
.\" Copyright 2024, 2025 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 "PVATTEST-PERFORM" "1" "2026-05-19" "s390-tools" "Attestation Manual"
|
||
.nh
|
||
.ad l
|
||
.SH NAME
|
||
pvattest-perform \- Send the attestation request to the Ultravisor (s390x only.)
|
||
.SH SYNOPSIS
|
||
.nf
|
||
.fam C
|
||
pvattest perform [OPTIONS] [IN] [OUT]
|
||
.fam C
|
||
.fi
|
||
.SH DESCRIPTION
|
||
Run a measurement of this system through ’/dev/uv’. This device must be
|
||
accessible and the attestation Ultravisor facility must be present. The input
|
||
must be an attestation request created with ’pvattest create’. Output will
|
||
contain the original request and the response from the Ultravisor. Only
|
||
available on s390x.
|
||
.SH OPTIONS
|
||
.PP
|
||
<IN>
|
||
.RS 4
|
||
Specify the request to be sent.
|
||
.RE
|
||
.RE
|
||
.PP
|
||
<OUT>
|
||
.RS 4
|
||
Write the result to FILE.
|
||
.RE
|
||
.RE
|
||
|
||
.PP
|
||
\-i, \-\-input <FILE>
|
||
.RS 4
|
||
Specify the request to be sent.
|
||
.RE
|
||
.RE
|
||
.PP
|
||
\-o, \-\-output <FILE>
|
||
.RS 4
|
||
Write the result to FILE.
|
||
.RE
|
||
.RE
|
||
.PP
|
||
\-u, \-\-user\-data <File>
|
||
.RS 4
|
||
Provide up to 256 bytes of user input User\-data is arbitrary user\-defined data
|
||
appended to the Attestation measurement. It is verified during the Attestation
|
||
measurement verification. May be any arbitrary data, as long as it is less or
|
||
equal to 256 bytes
|
||
.RE
|
||
.RE
|
||
.PP
|
||
\-h, \-\-help
|
||
.RS 4
|
||
Print help (see a summary with \fB\-h\fR).
|
||
.RE
|
||
.RE
|
||
|
||
.SH EXAMPLES
|
||
Perform an attestation measurement with the attestation request 'attreq.bin' and write the output to 'attresp.bin'.
|
||
.PP
|
||
.nf
|
||
.fam C
|
||
$ pvattest perform attreq.bin attresp.bin
|
||
|
||
|
||
.fam T
|
||
.fi
|
||
.SH "SEE ALSO"
|
||
.sp
|
||
\fBpvattest\fR(1)
|