From 7d67dc8f1c8da874e24949e18dda43c75986e9ca Mon Sep 17 00:00:00 2001 From: Matthew Rosato Date: Thu, 21 Jul 2022 11:47:52 -0400 Subject: [PATCH] zdev: add some --type ap examples to manpages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The ap type has some unique input parameters, provide some examples on how to modify and set the apmask and aqmask via chzdev. Also include an example of using lszdev to view the apmask and aqmask. Fixes: https://github.com/ibm-s390-linux/s390-tools/issues/140 Reviewed-by: Peter Oberparleiter Reviewed-by: Tony Krowiak Signed-off-by: Matthew Rosato Signed-off-by: Jan Höppner --- zdev/man/chzdev.8 | 23 +++++++++++++++++++++++ zdev/man/lszdev.8 | 6 ++++++ 2 files changed, 29 insertions(+) diff --git a/zdev/man/chzdev.8 b/zdev/man/chzdev.8 index a8520207..92988649 100644 --- a/zdev/man/chzdev.8 +++ b/zdev/man/chzdev.8 @@ -690,6 +690,29 @@ Answer all confirmation questions with 'yes'. .RE .PP . +If you intend to assign a cryptographic (AP) adapter or domain to a KVM +guest you must first release its usage by the zcrypt driver in the host +operating system using chzdev commands similar to the following examples: +. +.PP +.B Remove AP adapters 1 and 20 through 22 from host usage: +.RS 4 +.CL chzdev \-\-type ap apmask=-1,-20-22 +.RE +.PP +. +.B Return AP domains 5 and 8 through 10 to host usage: +.RS 4 +.CL chzdev \-\-type ap aqmask=+5,+8-10 +.RE +.PP +. +.B Specify the list of AP adapters and domains available for host usage: +.RS 4 +.CL chzdev \-\-type ap apmask=0-120,129-255 aqmask=0-200,220-255 +.RE +.PP +. . .SH "EXIT CODES" .TP diff --git a/zdev/man/lszdev.8 b/zdev/man/lszdev.8 index 902dd256..12f20efb 100644 --- a/zdev/man/lszdev.8 +++ b/zdev/man/lszdev.8 @@ -429,6 +429,12 @@ Print additional run-time information. .RE .PP . +.B Display cryptographic (AP) adapter and domain assignments: +.RS 4 +.CL lszdev \-\-type ap +.RE +.PP +. .SH "EXIT CODES" lszdev returns a subset of the exit codes returned by the chzdev tool. See .MP chzdev 8