system/s390x/vfio-ap.rst

11 These AP devices provide cryptographic functions to all CPUs assigned to a
27   functions. There can be from 0 to 256 adapters assigned to an LPAR depending
28   on the machine model. Adapters assigned to the LPAR in which a linux host is
80 the adapters, usage domains and control domains assigned to the KVM guest:
82 * The AP Mask (APM) field is a bit mask that identifies the AP adapters assigned
88   assigned to the KVM guest. Each bit in the mask, from left to right,
93   assigned to the KVM guest. The ADM bit mask controls which domains can be
104 cross product of all assigned adapter numbers (APM) with all assigned queue
106 assigned to a guest, the APQNs (1,5), (1,6), (2,5) and (2,6) will be valid for
110 on the adapter card for each of its domains - so each APQN must be assigned to
165 linux system is started, the AP bus will detect the AP devices assigned to the
201 device that can be assigned to the LPAR on which a linux host is running::
250 The APQN of each AP queue device assigned to the linux host is checked by the
397    * All APQNs that can be derived from the adapter ID being assigned and the
398      IDs of the previously assigned domains must be bound to the vfio_ap device
399      driver. If no domains have yet been assigned, then there must be at least
405      previously assigned domains can be assigned to another mediated matrix
406      device. If an APQN is assigned to another mediated matrix device, the
432    * All APQNs that can be derived from the domain ID being assigned and the IDs
433      of the previously assigned adapters must be bound to the vfio_ap device
434      driver. If no domains have yet been assigned, then there must be at least
439    * No APQN that can be derived from the domain ID being assigned and the IDs
440      of the previously assigned adapters can be assigned to another mediated
441      matrix device. If an APQN is assigned to another mediated matrix device,
494 the guest's CRYCB with the adapter, usage domain and control domains assigned
612 device to which AP resources to be used by the guest have been assigned.
831    Control domains can similarly be assigned using the assign_control_domain
903   to the default drivers pool of a queue that is still assigned to a mediated
906   assigned lest the host be given access to the private data of the AP queue