system/s390x/vfio-ap.rst

11 These AP devices provide cryptographic functions to all CPUs assigned to a
165 linux system is started, the AP bus will detect the AP devices assigned to the
169   ... [devices]
188   ... [devices]
216 Binding AP devices to device drivers
322 mediated matrix device must first be created for the ``/sys/devices/vfio_ap/matrix``
325 creating mediated matrix devices is created::
327   /sys/devices
333   ............... [devices]
347 the UUID is created in the ``devices`` subdirectory::
349   /sys/devices
355   ............... [devices]
362   /sys/devices
368   ............... [devices]
486   /sys/devices/vfio_ap/matrix/$uuid
487   /sys/bus/mdev/devices/$uuid
489   /sys/devices/vfio_ap/matrix/mdev_supported_types/vfio_ap-passthrough/devices/$uuid
594         running on the guest will not detect CEX4 and newer devices
595         without it. Since only CEX4 and newer devices are supported
596         for guest usage, no AP devices can be made accessible to a
615 Note that on Linux guests, the AP devices will be created in the
616 ``/sys/bus/ap/devices`` directory when the AP bus subsequently performs its periodic
617 scan, so there may be a short delay before the AP devices are accessible on the
640 On a Linux guest, the AP devices will be removed from the ``/sys/bus/ap/devices``
642 so there may be a short delay before the AP devices are no longer accessible by
715               -> VFIO driver for Mediated devices
717         -> VFIO support for AP devices
732    to the AP queue devices bound to it::
749    supporting older devices that will go out of service in the relatively near
757      cat /sys/bus/ap/devices/card05/hwtype
762 3. Create the mediated devices needed to configure the AP matrixes for the
766      /sys/devices/vfio_ap/matrix/
770      ......... [devices]
772    To create the mediated devices for the three guests::
786    This will create three mediated devices in the [devices] subdirectory named
790      /sys/devices/vfio_ap/matrix/
793      ......... [devices]
822    devices $uuid1 (for Guest1), $uuid2 (for Guest2) and $uuid3 (for Guest3).
865 …s390x ... -cpu host,ap=on,apqci=on,apft=on -device vfio-ap,sysfsdev=/sys/devices/vfio_ap/matrix/$u…
869 …s390x ... -cpu host,ap=on,apqci=on,apft=on -device vfio-ap,sysfsdev=/sys/devices/vfio_ap/matrix/$u…
873 …s390x ... -cpu host,ap=on,apqci=on,apft=on -device vfio-ap,sysfsdev=/sys/devices/vfio_ap/matrix/$u…
875 When the guest is shut down, the mediated matrix devices may be removed.
879    /sys/devices/vfio_ap/matrix/
882    ......... [devices]
913 * Live guest migration is not supported for guests using AP devices. If a guest
914   is using AP devices, the vfio-ap device configured for the guest must be