Commit b4d863c3 authored by Cornelia Huck's avatar Cornelia Huck Committed by Christian Borntraeger

KVM: s390: improve documentation for S390_MEM_OP

Explicitly specify the valid ranges for size and ar, and reword
buf requirements a bit.
Signed-off-by: default avatarCornelia Huck <cohuck@redhat.com>
Reviewed-by: default avatarThomas Huth <thuth@redhat.com>
Reviewed-by: default avatarDavid Hildenbrand <david@redhat.com>
Link: https://lkml.kernel.org/r/20190829124746.28665-1-cohuck@redhat.comSigned-off-by: default avatarChristian Borntraeger <borntraeger@de.ibm.com>
parent a13b03bb
...@@ -3079,12 +3079,14 @@ This exception is also raised directly at the corresponding VCPU if the ...@@ -3079,12 +3079,14 @@ This exception is also raised directly at the corresponding VCPU if the
flag KVM_S390_MEMOP_F_INJECT_EXCEPTION is set in the "flags" field. flag KVM_S390_MEMOP_F_INJECT_EXCEPTION is set in the "flags" field.
The start address of the memory region has to be specified in the "gaddr" The start address of the memory region has to be specified in the "gaddr"
field, and the length of the region in the "size" field. "buf" is the buffer field, and the length of the region in the "size" field (which must not
supplied by the userspace application where the read data should be written be 0). The maximum value for "size" can be obtained by checking the
to for KVM_S390_MEMOP_LOGICAL_READ, or where the data that should be written KVM_CAP_S390_MEM_OP capability. "buf" is the buffer supplied by the
is stored for a KVM_S390_MEMOP_LOGICAL_WRITE. "buf" is unused and can be NULL userspace application where the read data should be written to for
when KVM_S390_MEMOP_F_CHECK_ONLY is specified. "ar" designates the access KVM_S390_MEMOP_LOGICAL_READ, or where the data that should be written is
register number to be used. stored for a KVM_S390_MEMOP_LOGICAL_WRITE. When KVM_S390_MEMOP_F_CHECK_ONLY
is specified, "buf" is unused and can be NULL. "ar" designates the access
register number to be used; the valid range is 0..15.
The "reserved" field is meant for future extensions. It is not used by The "reserved" field is meant for future extensions. It is not used by
KVM with the currently defined set of flags. KVM with the currently defined set of flags.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment