docs: kvm: convert devices/vfio.txt to ReST

- Use standard title markup;
- adjust lists;
- mark code blocks as such.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Reviewed-by: Cornelia Huck <cohuck@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
This commit is contained in:
Mauro Carvalho Chehab 2020-02-10 07:02:51 +01:00 committed by Paolo Bonzini
parent e777a5bd98
commit aff7aeea54
2 changed files with 16 additions and 10 deletions

View file

@ -13,3 +13,4 @@ Devices
mpic mpic
s390_flic s390_flic
vcpu vcpu
vfio

View file

@ -1,8 +1,12 @@
.. SPDX-License-Identifier: GPL-2.0
===================
VFIO virtual device VFIO virtual device
=================== ===================
Device types supported: Device types supported:
KVM_DEV_TYPE_VFIO
- KVM_DEV_TYPE_VFIO
Only one VFIO instance may be created per VM. The created device Only one VFIO instance may be created per VM. The created device
tracks VFIO groups in use by the VM and features of those groups tracks VFIO groups in use by the VM and features of those groups
@ -23,14 +27,15 @@ KVM_DEV_VFIO_GROUP attributes:
for the VFIO group. for the VFIO group.
KVM_DEV_VFIO_GROUP_SET_SPAPR_TCE: attaches a guest visible TCE table KVM_DEV_VFIO_GROUP_SET_SPAPR_TCE: attaches a guest visible TCE table
allocated by sPAPR KVM. allocated by sPAPR KVM.
kvm_device_attr.addr points to a struct: kvm_device_attr.addr points to a struct::
struct kvm_vfio_spapr_tce { struct kvm_vfio_spapr_tce {
__s32 groupfd; __s32 groupfd;
__s32 tablefd; __s32 tablefd;
}; };
where where:
@groupfd is a file descriptor for a VFIO group;
@tablefd is a file descriptor for a TCE table allocated via - @groupfd is a file descriptor for a VFIO group;
KVM_CREATE_SPAPR_TCE. - @tablefd is a file descriptor for a TCE table allocated via
KVM_CREATE_SPAPR_TCE.