system/s390x/vfio-ap.rst

10 of three AP instructions and from 1 to 256 PCIe cryptographic adapter cards.
14 On s390x, AP adapter cards are exposed via the AP bus. This document
24 * AP adapter
26   An AP adapter is an IBM Z adapter card that can perform cryptographic
29   running will be available to the linux host. Each adapter is identified by a
30   number from 0 to 255; however, the maximum adapter number allowed is
31   determined by machine model. When installed, an AP adapter is accessed by
36   An adapter is partitioned into domains. Each domain can be thought of as
37   a set of hardware registers for processing AP instructions. An adapter can
53   comprised of an AP adapter ID (APID) and an AP queue index (APQI). The
54   APQI corresponds to a given usage domain number within the adapter. This tuple
84   an APID from 0-255. If a bit is set, the corresponding adapter is valid for
100 an APQN to identify the AP adapter and AP queue to which an AP command-request
104 cross product of all assigned adapter numbers (APM) with all assigned queue
110 on the adapter card for each of its domains - so each APQN must be assigned to
178   is AP adapter number xx (in hex)
227 The ``apmask`` is a 256-bit mask that identifies a set of AP adapter IDs
314             default drivers pool:    adapter 0-15, domain 1
315             alternate drivers pool:  adapter 16-255, domains 0, 2-255
379    To assign an AP adapter to the mediated matrix device, its APID is written
381    than one adapter. The APID may be specified using conventional semantics
390    In order to successfully assign an adapter:
392    * The adapter number specified must represent a value from 0 up to the
393      maximum adapter number allowed by the machine model. If an adapter number
397    * All APQNs that can be derived from the adapter ID being assigned and the
404    * No APQN that can be derived from the adapter ID and the IDs of the
410    To unassign an AP adapter, its APID is written to the ``unassign_adapter``
411    file. This may also be done multiple times to unassign more than one adapter.
472 the mediated matrix device is running. Attempts to assign an adapter,
494 the guest's CRYCB with the adapter, usage domain and control domains assigned
499    adapter numbers (APID) and queue indexes (APQI) specified in the APM and AQM
834    If a mistake is made configuring an adapter, domain or control domain,
835    you can use the ``unassign_xxx`` interfaces to unassign the adapter, domain or
843    the adapter number and yyyy is the domain number. The output for Guest1