€•ÓŠ      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ./translations/zh_CN/virt/kvm/devices/s390_flic”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/zh_TW/virt/kvm/devices/s390_flic”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/it_IT/virt/kvm/devices/s390_flic”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ja_JP/virt/kvm/devices/s390_flic”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ko_KR/virt/kvm/devices/s390_flic”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/sp_SP/virt/kvm/devices/s390_flic”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒH/var/lib/git/docbuild/linux/Documentation/virt/kvm/devices/s390_flic.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ$FLIC (floating interrupt controller)”h]”hŒ$FLIC (floating interrupt controller)”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒÐFLIC handles floating (non per-cpu) interrupts, i.e. I/O, service and some
machine check interruptions. All interrupts are stored in a per-vm list of
pending interrupts. FLIC performs operations on this list.”h]”hŒÐFLIC handles floating (non per-cpu) interrupts, i.e. I/O, service and some
machine check interruptions. All interrupts are stored in a per-vm list of
pending interrupts. FLIC performs operations on this list.”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒ+Only one FLIC instance may be instantiated.”h]”hŒ+Only one FLIC instance may be instantiated.”…””}”(hhÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hXa  FLIC provides support to
- add interrupts (KVM_DEV_FLIC_ENQUEUE)
- inspect currently pending interrupts (KVM_FLIC_GET_ALL_IRQS)
- purge all pending floating interrupts (KVM_DEV_FLIC_CLEAR_IRQS)
- purge one pending floating I/O interrupt (KVM_DEV_FLIC_CLEAR_IO_IRQ)
- enable/disable for the guest transparent async page faults
- register and modify adapter interrupt sources (KVM_DEV_FLIC_ADAPTER_*)
- modify AIS (adapter-interruption-suppression) mode state (KVM_DEV_FLIC_AISM)
- inject adapter interrupts on a specified adapter (KVM_DEV_FLIC_AIRQ_INJECT)
- get/set all AIS mode states (KVM_DEV_FLIC_AISM_ALL)”h]”hXa  FLIC provides support to
- add interrupts (KVM_DEV_FLIC_ENQUEUE)
- inspect currently pending interrupts (KVM_FLIC_GET_ALL_IRQS)
- purge all pending floating interrupts (KVM_DEV_FLIC_CLEAR_IRQS)
- purge one pending floating I/O interrupt (KVM_DEV_FLIC_CLEAR_IO_IRQ)
- enable/disable for the guest transparent async page faults
- register and modify adapter interrupt sources (KVM_DEV_FLIC_ADAPTER_*)
- modify AIS (adapter-interruption-suppression) mode state (KVM_DEV_FLIC_AISM)
- inject adapter interrupts on a specified adapter (KVM_DEV_FLIC_AIRQ_INJECT)
- get/set all AIS mode states (KVM_DEV_FLIC_AISM_ALL)”…””}”(hhçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hX[  Groups:
KVM_DEV_FLIC_ENQUEUE
  Passes a buffer and length into the kernel which are then injected into
  the list of pending interrupts.
  attr->addr contains the pointer to the buffer and attr->attr contains
  the length of the buffer.
  The format of the data structure kvm_s390_irq as it is copied from userspace
  is defined in usr/include/linux/kvm.h.

KVM_DEV_FLIC_GET_ALL_IRQS
  Copies all floating interrupts into a buffer provided by userspace.
  When the buffer is too small it returns -ENOMEM, which is the indication
  for userspace to try again with a bigger buffer.

  -ENOBUFS is returned when the allocation of a kernelspace buffer has
  failed.

  -EFAULT is returned when copying data to userspace failed.
  All interrupts remain pending, i.e. are not deleted from the list of
  currently pending interrupts.
  attr->addr contains the userspace address of the buffer into which all
  interrupt data will be copied.
  attr->attr contains the size of the buffer in bytes.

KVM_DEV_FLIC_CLEAR_IRQS
  Simply deletes all elements from the list of currently pending floating
  interrupts.  No interrupts are injected into the guest.

KVM_DEV_FLIC_CLEAR_IO_IRQ
  Deletes one (if any) I/O interrupt for a subchannel identified by the
  subsystem identification word passed via the buffer specified by
  attr->addr (address) and attr->attr (length).

KVM_DEV_FLIC_APF_ENABLE
  Enables async page faults for the guest. So in case of a major page fault
  the host is allowed to handle this async and continues the guest.

  -EINVAL is returned when called on the FLIC of a ucontrol VM.

KVM_DEV_FLIC_APF_DISABLE_WAIT
  Disables async page faults for the guest and waits until already pending
  async page faults are done. This is necessary to trigger a completion interrupt
  for every init interrupt before migrating the interrupt list.

  -EINVAL is returned when called on the FLIC of a ucontrol VM.

KVM_DEV_FLIC_ADAPTER_REGISTER
  Register an I/O adapter interrupt source. Takes a kvm_s390_io_adapter
  describing the adapter to register::

      struct kvm_s390_io_adapter {
              __u32 id;
              __u8 isc;
              __u8 maskable;
              __u8 swap;
              __u8 flags;
      };

 id contains the unique id for the adapter, isc the I/O interruption subclass
 to use, maskable whether this adapter may be masked (interrupts turned off),
 swap whether the indicators need to be byte swapped, and flags contains
 further characteristics of the adapter.

 Currently defined values for 'flags' are:

 - KVM_S390_ADAPTER_SUPPRESSIBLE: adapter is subject to AIS
   (adapter-interrupt-suppression) facility. This flag only has an effect if
   the AIS capability is enabled.

 Unknown flag values are ignored.


KVM_DEV_FLIC_ADAPTER_MODIFY
  Modifies attributes of an existing I/O adapter interrupt source. Takes
  a kvm_s390_io_adapter_req specifying the adapter and the operation::

      struct kvm_s390_io_adapter_req {
              __u32 id;
              __u8 type;
              __u8 mask;
              __u16 pad0;
              __u64 addr;
      };

  id specifies the adapter and type the operation. The supported operations
  are:

  KVM_S390_IO_ADAPTER_MASK
    mask or unmask the adapter, as specified in mask

  KVM_S390_IO_ADAPTER_MAP
    This is now a no-op. The mapping is purely done by the irq route.
  KVM_S390_IO_ADAPTER_UNMAP
    This is now a no-op. The mapping is purely done by the irq route.

KVM_DEV_FLIC_AISM
  modify the adapter-interruption-suppression mode for a given isc if the
  AIS capability is enabled. Takes a kvm_s390_ais_req describing::

      struct kvm_s390_ais_req {
              __u8 isc;
              __u16 mode;
      };

  isc contains the target I/O interruption subclass, mode the target
  adapter-interruption-suppression mode. The following modes are
  currently supported:

  - KVM_S390_AIS_MODE_ALL: ALL-Interruptions Mode, i.e. airq injection
    is always allowed;
  - KVM_S390_AIS_MODE_SINGLE: SINGLE-Interruption Mode, i.e. airq
    injection is only allowed once and the following adapter interrupts
    will be suppressed until the mode is set again to ALL-Interruptions
    or SINGLE-Interruption mode.

KVM_DEV_FLIC_AIRQ_INJECT
  Inject adapter interrupts on a specified adapter.
  attr->attr contains the unique id for the adapter, which allows for
  adapter-specific checks and actions.
  For adapters subject to AIS, handle the airq injection suppression for
  an isc according to the adapter-interruption-suppression mode on condition
  that the AIS capability is enabled.

KVM_DEV_FLIC_AISM_ALL
  Gets or sets the adapter-interruption-suppression mode for all ISCs. Takes
  a kvm_s390_ais_all describing::

      struct kvm_s390_ais_all {
             __u8 simm; /* Single-Interruption-Mode mask */
             __u8 nimm; /* No-Interruption-Mode mask *
      };

  simm contains Single-Interruption-Mode mask for all ISCs, nimm contains
  No-Interruption-Mode mask for all ISCs. Each bit in simm and nimm corresponds
  to an ISC (MSB0 bit 0 to ISC 0 and so on). The combination of simm bit and
  nimm bit presents AIS mode for a ISC.

  KVM_DEV_FLIC_AISM_ALL is indicated by KVM_CAP_S390_AIS_MIGRATION.
”h]”(hŒterm”“”)”}”(hŒGroups:”h]”hŒGroups:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K¡hhüubhŒ
definition”“”)”}”(hhh]”hö)”}”(hhh]”(hû)”}”(hXQ  KVM_DEV_FLIC_ENQUEUE
Passes a buffer and length into the kernel which are then injected into
the list of pending interrupts.
attr->addr contains the pointer to the buffer and attr->attr contains
the length of the buffer.
The format of the data structure kvm_s390_irq as it is copied from userspace
is defined in usr/include/linux/kvm.h.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_ENQUEUE”h]”hŒKVM_DEV_FLIC_ENQUEUE”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h Khj  ubj  )”}”(hhh]”hÊ)”}”(hX;  Passes a buffer and length into the kernel which are then injected into
the list of pending interrupts.
attr->addr contains the pointer to the buffer and attr->attr contains
the length of the buffer.
The format of the data structure kvm_s390_irq as it is copied from userspace
is defined in usr/include/linux/kvm.h.”h]”hX;  Passes a buffer and length into the kernel which are then injected into
the list of pending interrupts.
attr->addr contains the pointer to the buffer and attr->attr contains
the length of the buffer.
The format of the data structure kvm_s390_irq as it is copied from userspace
is defined in usr/include/linux/kvm.h.”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj*  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h Khj  ubhû)”}”(hX`  KVM_DEV_FLIC_GET_ALL_IRQS
Copies all floating interrupts into a buffer provided by userspace.
When the buffer is too small it returns -ENOMEM, which is the indication
for userspace to try again with a bigger buffer.

-ENOBUFS is returned when the allocation of a kernelspace buffer has
failed.

-EFAULT is returned when copying data to userspace failed.
All interrupts remain pending, i.e. are not deleted from the list of
currently pending interrupts.
attr->addr contains the userspace address of the buffer into which all
interrupt data will be copied.
attr->attr contains the size of the buffer in bytes.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_GET_ALL_IRQS”h]”hŒKVM_DEV_FLIC_GET_ALL_IRQS”…””}”(hjK  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K.hjG  ubj  )”}”(hhh]”(hÊ)”}”(hŒ½Copies all floating interrupts into a buffer provided by userspace.
When the buffer is too small it returns -ENOMEM, which is the indication
for userspace to try again with a bigger buffer.”h]”hŒ½Copies all floating interrupts into a buffer provided by userspace.
When the buffer is too small it returns -ENOMEM, which is the indication
for userspace to try again with a bigger buffer.”…””}”(hj\  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K"hjY  ubhÊ)”}”(hŒL-ENOBUFS is returned when the allocation of a kernelspace buffer has
failed.”h]”hŒL-ENOBUFS is returned when the allocation of a kernelspace buffer has
failed.”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K&hjY  ubhÊ)”}”(hX8  -EFAULT is returned when copying data to userspace failed.
All interrupts remain pending, i.e. are not deleted from the list of
currently pending interrupts.
attr->addr contains the userspace address of the buffer into which all
interrupt data will be copied.
attr->attr contains the size of the buffer in bytes.”h]”hX8  -EFAULT is returned when copying data to userspace failed.
All interrupts remain pending, i.e. are not deleted from the list of
currently pending interrupts.
attr->addr contains the userspace address of the buffer into which all
interrupt data will be copied.
attr->attr contains the size of the buffer in bytes.”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K)hjY  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hjG  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K.hj  ubhû)”}”(hŒ˜KVM_DEV_FLIC_CLEAR_IRQS
Simply deletes all elements from the list of currently pending floating
interrupts.  No interrupts are injected into the guest.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_CLEAR_IRQS”h]”hŒKVM_DEV_FLIC_CLEAR_IRQS”…””}”(hj–  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K2hj’  ubj  )”}”(hhh]”hÊ)”}”(hŒSimply deletes all elements from the list of currently pending floating
interrupts.  No interrupts are injected into the guest.”h]”hŒSimply deletes all elements from the list of currently pending floating
interrupts.  No interrupts are injected into the guest.”…””}”(hj§  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K1hj¤  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj’  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K2hj  ubhû)”}”(hŒÏKVM_DEV_FLIC_CLEAR_IO_IRQ
Deletes one (if any) I/O interrupt for a subchannel identified by the
subsystem identification word passed via the buffer specified by
attr->addr (address) and attr->attr (length).
”h]”(j  )”}”(hŒKVM_DEV_FLIC_CLEAR_IO_IRQ”h]”hŒKVM_DEV_FLIC_CLEAR_IO_IRQ”…””}”(hjÅ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K7hjÁ  ubj  )”}”(hhh]”hÊ)”}”(hŒ´Deletes one (if any) I/O interrupt for a subchannel identified by the
subsystem identification word passed via the buffer specified by
attr->addr (address) and attr->attr (length).”h]”hŒ´Deletes one (if any) I/O interrupt for a subchannel identified by the
subsystem identification word passed via the buffer specified by
attr->addr (address) and attr->attr (length).”…””}”(hjÖ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K5hjÓ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÁ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K7hj  ubhû)”}”(hŒãKVM_DEV_FLIC_APF_ENABLE
Enables async page faults for the guest. So in case of a major page fault
the host is allowed to handle this async and continues the guest.

-EINVAL is returned when called on the FLIC of a ucontrol VM.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_APF_ENABLE”h]”hŒKVM_DEV_FLIC_APF_ENABLE”…””}”(hjô  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K=hjð  ubj  )”}”(hhh]”(hÊ)”}”(hŒ‹Enables async page faults for the guest. So in case of a major page fault
the host is allowed to handle this async and continues the guest.”h]”hŒ‹Enables async page faults for the guest. So in case of a major page fault
the host is allowed to handle this async and continues the guest.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K:hj  ubhÊ)”}”(hŒ=-EINVAL is returned when called on the FLIC of a ucontrol VM.”h]”hŒ=-EINVAL is returned when called on the FLIC of a ucontrol VM.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K=hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hjð  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K=hj  ubhû)”}”(hX4  KVM_DEV_FLIC_APF_DISABLE_WAIT
Disables async page faults for the guest and waits until already pending
async page faults are done. This is necessary to trigger a completion interrupt
for every init interrupt before migrating the interrupt list.

-EINVAL is returned when called on the FLIC of a ucontrol VM.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_APF_DISABLE_WAIT”h]”hŒKVM_DEV_FLIC_APF_DISABLE_WAIT”…””}”(hj1  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h KDhj-  ubj  )”}”(hhh]”(hÊ)”}”(hŒÖDisables async page faults for the guest and waits until already pending
async page faults are done. This is necessary to trigger a completion interrupt
for every init interrupt before migrating the interrupt list.”h]”hŒÖDisables async page faults for the guest and waits until already pending
async page faults are done. This is necessary to trigger a completion interrupt
for every init interrupt before migrating the interrupt list.”…””}”(hjB  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K@hj?  ubhÊ)”}”(hŒ=-EINVAL is returned when called on the FLIC of a ucontrol VM.”h]”hŒ=-EINVAL is returned when called on the FLIC of a ucontrol VM.”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KDhj?  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj-  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h KDhj  ubhû)”}”(hX3  KVM_DEV_FLIC_ADAPTER_REGISTER
 Register an I/O adapter interrupt source. Takes a kvm_s390_io_adapter
 describing the adapter to register::

     struct kvm_s390_io_adapter {
             __u32 id;
             __u8 isc;
             __u8 maskable;
             __u8 swap;
             __u8 flags;
     };

id contains the unique id for the adapter, isc the I/O interruption subclass
to use, maskable whether this adapter may be masked (interrupts turned off),
swap whether the indicators need to be byte swapped, and flags contains
further characteristics of the adapter.

Currently defined values for 'flags' are:

- KVM_S390_ADAPTER_SUPPRESSIBLE: adapter is subject to AIS
  (adapter-interrupt-suppression) facility. This flag only has an effect if
  the AIS capability is enabled.

Unknown flag values are ignored.

”h]”(j  )”}”(hŒKVM_DEV_FLIC_ADAPTER_REGISTER”h]”hŒKVM_DEV_FLIC_ADAPTER_REGISTER”…””}”(hjn  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K^hjj  ubj  )”}”(hhh]”(hŒblock_quote”“”)”}”(hX
  Register an I/O adapter interrupt source. Takes a kvm_s390_io_adapter
describing the adapter to register::

    struct kvm_s390_io_adapter {
            __u32 id;
            __u8 isc;
            __u8 maskable;
            __u8 swap;
            __u8 flags;
    };
”h]”(hÊ)”}”(hŒjRegister an I/O adapter interrupt source. Takes a kvm_s390_io_adapter
describing the adapter to register::”h]”hŒiRegister an I/O adapter interrupt source. Takes a kvm_s390_io_adapter
describing the adapter to register:”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KGhj  ubhŒliteral_block”“”)”}”(hŒstruct kvm_s390_io_adapter {
        __u32 id;
        __u8 isc;
        __u8 maskable;
        __u8 swap;
        __u8 flags;
};”h]”hŒstruct kvm_s390_io_adapter {
        __u32 id;
        __u8 isc;
        __u8 maskable;
        __u8 swap;
        __u8 flags;
};”…””}”hj•  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j“  hŸh³h KJhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h KGhj|  ubhÊ)”}”(hX	  id contains the unique id for the adapter, isc the I/O interruption subclass
to use, maskable whether this adapter may be masked (interrupts turned off),
swap whether the indicators need to be byte swapped, and flags contains
further characteristics of the adapter.”h]”hX	  id contains the unique id for the adapter, isc the I/O interruption subclass
to use, maskable whether this adapter may be masked (interrupts turned off),
swap whether the indicators need to be byte swapped, and flags contains
further characteristics of the adapter.”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KRhj|  ubhÊ)”}”(hŒ)Currently defined values for 'flags' are:”h]”hŒ-Currently defined values for â€˜flagsâ€™ are:”…””}”(hj·  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KWhj|  ubhŒbullet_list”“”)”}”(hhh]”hŒ	list_item”“”)”}”(hŒ¢KVM_S390_ADAPTER_SUPPRESSIBLE: adapter is subject to AIS
(adapter-interrupt-suppression) facility. This flag only has an effect if
the AIS capability is enabled.
”h]”hÊ)”}”(hŒ¡KVM_S390_ADAPTER_SUPPRESSIBLE: adapter is subject to AIS
(adapter-interrupt-suppression) facility. This flag only has an effect if
the AIS capability is enabled.”h]”hŒ¡KVM_S390_ADAPTER_SUPPRESSIBLE: adapter is subject to AIS
(adapter-interrupt-suppression) facility. This flag only has an effect if
the AIS capability is enabled.”…””}”(hjÐ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KYhjÌ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  hjÇ  ubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jÅ  hŸh³h KYhj|  ubhÊ)”}”(hŒ Unknown flag values are ignored.”h]”hŒ Unknown flag values are ignored.”…””}”(hjì  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K]hj|  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hjj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K^hj  ubhû)”}”(hX¡  KVM_DEV_FLIC_ADAPTER_MODIFY
Modifies attributes of an existing I/O adapter interrupt source. Takes
a kvm_s390_io_adapter_req specifying the adapter and the operation::

    struct kvm_s390_io_adapter_req {
            __u32 id;
            __u8 type;
            __u8 mask;
            __u16 pad0;
            __u64 addr;
    };

id specifies the adapter and type the operation. The supported operations
are:

KVM_S390_IO_ADAPTER_MASK
  mask or unmask the adapter, as specified in mask

KVM_S390_IO_ADAPTER_MAP
  This is now a no-op. The mapping is purely done by the irq route.
KVM_S390_IO_ADAPTER_UNMAP
  This is now a no-op. The mapping is purely done by the irq route.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_ADAPTER_MODIFY”h]”hŒKVM_DEV_FLIC_ADAPTER_MODIFY”…””}”(hj
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h Kuhj  ubj  )”}”(hhh]”(hÊ)”}”(hŒ‹Modifies attributes of an existing I/O adapter interrupt source. Takes
a kvm_s390_io_adapter_req specifying the adapter and the operation::”h]”hŒŠModifies attributes of an existing I/O adapter interrupt source. Takes
a kvm_s390_io_adapter_req specifying the adapter and the operation:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kahj  ubj”  )”}”(hŒƒstruct kvm_s390_io_adapter_req {
        __u32 id;
        __u8 type;
        __u8 mask;
        __u16 pad0;
        __u64 addr;
};”h]”hŒƒstruct kvm_s390_io_adapter_req {
        __u32 id;
        __u8 type;
        __u8 mask;
        __u16 pad0;
        __u64 addr;
};”…””}”hj)  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j“  hŸh³h Kdhj  ubhÊ)”}”(hŒNid specifies the adapter and type the operation. The supported operations
are:”h]”hŒNid specifies the adapter and type the operation. The supported operations
are:”…””}”(hj7  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Klhj  ubhö)”}”(hhh]”(hû)”}”(hŒJKVM_S390_IO_ADAPTER_MASK
mask or unmask the adapter, as specified in mask
”h]”(j  )”}”(hŒKVM_S390_IO_ADAPTER_MASK”h]”hŒKVM_S390_IO_ADAPTER_MASK”…””}”(hjL  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h KphjH  ubj  )”}”(hhh]”hÊ)”}”(hŒ0mask or unmask the adapter, as specified in mask”h]”hŒ0mask or unmask the adapter, as specified in mask”…””}”(hj]  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KphjZ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjH  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h KphjE  ubhû)”}”(hŒYKVM_S390_IO_ADAPTER_MAP
This is now a no-op. The mapping is purely done by the irq route.”h]”(j  )”}”(hŒKVM_S390_IO_ADAPTER_MAP”h]”hŒKVM_S390_IO_ADAPTER_MAP”…””}”(hj{  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h Krhjw  ubj  )”}”(hhh]”hÊ)”}”(hŒAThis is now a no-op. The mapping is purely done by the irq route.”h]”hŒAThis is now a no-op. The mapping is purely done by the irq route.”…””}”(hjŒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kshj‰  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjw  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h KrhjE  ubhû)”}”(hŒ\KVM_S390_IO_ADAPTER_UNMAP
This is now a no-op. The mapping is purely done by the irq route.
”h]”(j  )”}”(hŒKVM_S390_IO_ADAPTER_UNMAP”h]”hŒKVM_S390_IO_ADAPTER_UNMAP”…””}”(hjª  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h Kuhj¦  ubj  )”}”(hhh]”hÊ)”}”(hŒAThis is now a no-op. The mapping is purely done by the irq route.”h]”hŒAThis is now a no-op. The mapping is purely done by the irq route.”…””}”(hj»  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kuhj¸  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj¦  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h KuhjE  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hõhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h Kuhj  ubhû)”}”(hXÍ  KVM_DEV_FLIC_AISM
modify the adapter-interruption-suppression mode for a given isc if the
AIS capability is enabled. Takes a kvm_s390_ais_req describing::

    struct kvm_s390_ais_req {
            __u8 isc;
            __u16 mode;
    };

isc contains the target I/O interruption subclass, mode the target
adapter-interruption-suppression mode. The following modes are
currently supported:

- KVM_S390_AIS_MODE_ALL: ALL-Interruptions Mode, i.e. airq injection
  is always allowed;
- KVM_S390_AIS_MODE_SINGLE: SINGLE-Interruption Mode, i.e. airq
  injection is only allowed once and the following adapter interrupts
  will be suppressed until the mode is set again to ALL-Interruptions
  or SINGLE-Interruption mode.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_AISM”h]”hŒKVM_DEV_FLIC_AISM”…””}”(hjë  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K‰hjç  ubj  )”}”(hhh]”(hÊ)”}”(hŒˆmodify the adapter-interruption-suppression mode for a given isc if the
AIS capability is enabled. Takes a kvm_s390_ais_req describing::”h]”hŒ‡modify the adapter-interruption-suppression mode for a given isc if the
AIS capability is enabled. Takes a kvm_s390_ais_req describing:”…””}”(hjü  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kxhjù  ubj”  )”}”(hŒBstruct kvm_s390_ais_req {
        __u8 isc;
        __u16 mode;
};”h]”hŒBstruct kvm_s390_ais_req {
        __u8 isc;
        __u16 mode;
};”…””}”hj
  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j“  hŸh³h K{hjù  ubhÊ)”}”(hŒ–isc contains the target I/O interruption subclass, mode the target
adapter-interruption-suppression mode. The following modes are
currently supported:”h]”hŒ–isc contains the target I/O interruption subclass, mode the target
adapter-interruption-suppression mode. The following modes are
currently supported:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K€hjù  ubjÆ  )”}”(hhh]”(jË  )”}”(hŒUKVM_S390_AIS_MODE_ALL: ALL-Interruptions Mode, i.e. airq injection
is always allowed;”h]”hÊ)”}”(hŒUKVM_S390_AIS_MODE_ALL: ALL-Interruptions Mode, i.e. airq injection
is always allowed;”h]”hŒUKVM_S390_AIS_MODE_ALL: ALL-Interruptions Mode, i.e. airq injection
is always allowed;”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K„hj)  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  hj&  ubjË  )”}”(hŒãKVM_S390_AIS_MODE_SINGLE: SINGLE-Interruption Mode, i.e. airq
injection is only allowed once and the following adapter interrupts
will be suppressed until the mode is set again to ALL-Interruptions
or SINGLE-Interruption mode.
”h]”hÊ)”}”(hŒâKVM_S390_AIS_MODE_SINGLE: SINGLE-Interruption Mode, i.e. airq
injection is only allowed once and the following adapter interrupts
will be suppressed until the mode is set again to ALL-Interruptions
or SINGLE-Interruption mode.”h]”hŒâKVM_S390_AIS_MODE_SINGLE: SINGLE-Interruption Mode, i.e. airq
injection is only allowed once and the following adapter interrupts
will be suppressed until the mode is set again to ALL-Interruptions
or SINGLE-Interruption mode.”…””}”(hjE  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K†hjA  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  hj&  ubeh}”(h]”h ]”h"]”h$]”h&]”jê  jë  uh1jÅ  hŸh³h K„hjù  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hjç  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K‰hj  ubhû)”}”(hXj  KVM_DEV_FLIC_AIRQ_INJECT
Inject adapter interrupts on a specified adapter.
attr->attr contains the unique id for the adapter, which allows for
adapter-specific checks and actions.
For adapters subject to AIS, handle the airq injection suppression for
an isc according to the adapter-interruption-suppression mode on condition
that the AIS capability is enabled.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_AIRQ_INJECT”h]”hŒKVM_DEV_FLIC_AIRQ_INJECT”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K‘hjk  ubj  )”}”(hhh]”hÊ)”}”(hXP  Inject adapter interrupts on a specified adapter.
attr->attr contains the unique id for the adapter, which allows for
adapter-specific checks and actions.
For adapters subject to AIS, handle the airq injection suppression for
an isc according to the adapter-interruption-suppression mode on condition
that the AIS capability is enabled.”h]”hXP  Inject adapter interrupts on a specified adapter.
attr->attr contains the unique id for the adapter, which allows for
adapter-specific checks and actions.
For adapters subject to AIS, handle the airq injection suppression for
an isc according to the adapter-interruption-suppression mode on condition
that the AIS capability is enabled.”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KŒhj}  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjk  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K‘hj  ubhû)”}”(hXa  KVM_DEV_FLIC_AISM_ALL
Gets or sets the adapter-interruption-suppression mode for all ISCs. Takes
a kvm_s390_ais_all describing::

    struct kvm_s390_ais_all {
           __u8 simm; /* Single-Interruption-Mode mask */
           __u8 nimm; /* No-Interruption-Mode mask *
    };

simm contains Single-Interruption-Mode mask for all ISCs, nimm contains
No-Interruption-Mode mask for all ISCs. Each bit in simm and nimm corresponds
to an ISC (MSB0 bit 0 to ISC 0 and so on). The combination of simm bit and
nimm bit presents AIS mode for a ISC.

KVM_DEV_FLIC_AISM_ALL is indicated by KVM_CAP_S390_AIS_MIGRATION.
”h]”(j  )”}”(hŒKVM_DEV_FLIC_AISM_ALL”h]”hŒKVM_DEV_FLIC_AISM_ALL”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j   hŸh³h K¡hjš  ubj  )”}”(hhh]”(hÊ)”}”(hŒjGets or sets the adapter-interruption-suppression mode for all ISCs. Takes
a kvm_s390_ais_all describing::”h]”hŒiGets or sets the adapter-interruption-suppression mode for all ISCs. Takes
a kvm_s390_ais_all describing:”…””}”(hj¯  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K”hj¬  ubj”  )”}”(hŒƒstruct kvm_s390_ais_all {
       __u8 simm; /* Single-Interruption-Mode mask */
       __u8 nimm; /* No-Interruption-Mode mask *
};”h]”hŒƒstruct kvm_s390_ais_all {
       __u8 simm; /* Single-Interruption-Mode mask */
       __u8 nimm; /* No-Interruption-Mode mask *
};”…””}”hj½  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j“  hŸh³h K—hj¬  ubhÊ)”}”(hX  simm contains Single-Interruption-Mode mask for all ISCs, nimm contains
No-Interruption-Mode mask for all ISCs. Each bit in simm and nimm corresponds
to an ISC (MSB0 bit 0 to ISC 0 and so on). The combination of simm bit and
nimm bit presents AIS mode for a ISC.”h]”hX  simm contains Single-Interruption-Mode mask for all ISCs, nimm contains
No-Interruption-Mode mask for all ISCs. Each bit in simm and nimm corresponds
to an ISC (MSB0 bit 0 to ISC 0 and so on). The combination of simm bit and
nimm bit presents AIS mode for a ISC.”…””}”(hjË  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kœhj¬  ubhÊ)”}”(hŒAKVM_DEV_FLIC_AISM_ALL is indicated by KVM_CAP_S390_AIS_MIGRATION.”h]”hŒAKVM_DEV_FLIC_AISM_ALL is indicated by KVM_CAP_S390_AIS_MIGRATION.”…””}”(hjÙ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K¡hj¬  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hjš  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K¡hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hõhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hhüubeh}”(h]”h ]”h"]”h$]”h&]”uh1húhŸh³h K¡hh÷ubah}”(h]”h ]”h"]”h$]”h&]”uh1hõhh¶hžhhŸNh NubhÊ)”}”(hXF  Note: The KVM_SET_DEVICE_ATTR/KVM_GET_DEVICE_ATTR device ioctls executed on
FLIC with an unknown group or attribute gives the error code EINVAL (instead of
ENXIO, as specified in the API documentation). It is not possible to conclude
that a FLIC operation is unavailable based on the error code resulting from a
usage attempt.”h]”hXF  Note: The KVM_SET_DEVICE_ATTR/KVM_GET_DEVICE_ATTR device ioctls executed on
FLIC with an unknown group or attribute gives the error code EINVAL (instead of
ENXIO, as specified in the API documentation). It is not possible to conclude
that a FLIC operation is unavailable based on the error code resulting from a
usage attempt.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K£hh¶hžhubhŒnote”“”)”}”(hŒYThe KVM_DEV_FLIC_CLEAR_IO_IRQ ioctl will return EINVAL in case a
zero schid is specified.”h]”hÊ)”}”(hŒYThe KVM_DEV_FLIC_CLEAR_IO_IRQ ioctl will return EINVAL in case a
zero schid is specified.”h]”hŒYThe KVM_DEV_FLIC_CLEAR_IO_IRQ ioctl will return EINVAL in case a
zero schid is specified.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K©hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hh¶hžhhŸh³h Nubeh}”(h]”Œ"flic-floating-interrupt-controller”ah ]”h"]”Œ$flic (floating interrupt controller)”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j^  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”j8  j5  sŒ	nametypes”}”j8  ‰sh}”j5  h¶sŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.