system/s390x/vfio-ap.rst

29   running will be available to the linux host. Each adapter is identified by a
31   determined by machine model. When installed, an AP adapter is accessed by
32   AP instructions executed by any CPU.
39   determined by machine model. Each domain is identified by a number from 0 to
45     * Control domains are domains that are accessed indirectly by AP
51   An AP queue is the means by which an AP command-request message is sent to an
52   AP usage domain inside a specific AP. An AP queue is identified by a tuple
75 A KVM guest is started by executing the Start Interpretive Execution (SIE)
85   use by the KVM guest.
90   corresponding queue is valid for use by the KVM guest.
94   changed by an AP command-request message sent to a usage domain from the
96   0-255. If a bit is set, the corresponding domain can be modified by an AP
103 APQN is defined by the matrix calculated from the APM and AQM; it is the
206   ...... [cex2aqueue]       for AP queues served by Crypto Express 2/3
210   ...... [cex4queue]        for AP queues served by Crypto Express 4/5/6
213   ...... [pcixccqueue]      for AP queues served by Crypto Express 2/3
220 range as 'usable by the default AP queue device drivers' or 'not usable by the
221 default device drivers' and thus available for use by the alternate device
230 0-255. If a bit is set, the APID is marked as usable only by the default AP
231 queue device drivers; otherwise, the APID is usable by the vfio_ap
237 0-255. If a bit is set, the APQI is marked as usable only by the default AP
238 queue device drivers; otherwise, the APQI is usable by the vfio_ap device
250 The APQN of each AP queue device assigned to the linux host is checked by the
252 and APQIs marked as usable only by the default AP queue device drivers. If a
256 By default, the two masks are set to reserve all APQNs for use by the default
259  1. The sysfs mask files can be edited by echoing a string into the
276     * Individual bits in the mask can be switched on and off by specifying
335 A mediated AP matrix device is created by writing a UUID to the attribute file
393      maximum adapter number allowed by the machine model. If an adapter number
428      maximum domain number allowed by the machine model. If a domain number
463    allowed by the machine model. If a control domain number higher than the
478 To provide a mediated matrix device for use by a guest, the following option
501    that are valid for use by the guest; meaning, AP commands can be sent by the
537    The QCI facility is used by the AP bus running on the guest to query the
562         greater than 15 will not be detected by the AP bus
567    The APFT facility is used by the AP bus running on the guest to test the
612 device to which AP resources to be used by the guest have been assigned.
642 so there may be a short delay before the AP devices are no longer accessible by
719 2. Secure the AP queues to be used by the three guests so that the host can not
721    06.0004, 06.0047, 06.00ab, and 06.00ff for use by the vfio_ap device driver,
748    simplify the implementation by not needlessly complicating the design by
764    use by the guests::
897 the pool of adapters and queues reserved for use by the default drivers.
904   device in use by a guest. It is incumbent upon the administrator to
905   ensure there is no mediated device in use by a guest to which the APQN is