mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
Steffen Eiden
16610a211f
Add a CLI compatible Rust implementation of pvattest-C. - All (non-experimental) options are supported and work exactly as in the C implementation. For some options/parameters new variants are available. - `perform` now also accepts positional arguments, while keep accepting -i and -o that was mandatory in the C implementation. - `version` may also be a command instead of an option now. - -V is deprecated - -v increases verbosity instead of showing the version - all experimental options are dropped Acked-by: Qi Feng Huo <huoqif@cn.ibm.com> Acked-by: Marc Hartmayer <mhartmay@linux.ibm.com> Signed-off-by: Steffen Eiden <seiden@linux.ibm.com>
72 lines
1.5 KiB
Groff
72 lines
1.5 KiB
Groff
.\" Copyright 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 pvattest-perform 1 "2024-05-15" "s390-tools" "Attestation Manual"
|
||
.nh
|
||
.ad l
|
||
.SH NAME
|
||
\fBpvattest perform\fP - Send the attestation request to the Ultravisor
|
||
\fB
|
||
.SH SYNOPSIS
|
||
.nf
|
||
.fam C
|
||
pvattest perform [OPTIONS] [INPUT] [OUTPUT]
|
||
.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.
|
||
.SH OPTIONS
|
||
.PP
|
||
<INPUT>
|
||
.RS 4
|
||
Specify the request to be sent.
|
||
.RE
|
||
.RE
|
||
.PP
|
||
<OUTPUT>
|
||
.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
|
||
\-v, \-\-verbose
|
||
.RS 4
|
||
Provide more detailed output.
|
||
.RE
|
||
.RE
|
||
.PP
|
||
\-h, \-\-help
|
||
.RS 4
|
||
Print help (see a summary with '-h').
|
||
.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)
|