WSL2-Linux-Kernel/Documentation/virt/kvm/devices
Nico Boehr f2d3155e2a KVM: s390: disable migration mode when dirty tracking is disabled
Migration mode is a VM attribute which enables tracking of changes in
storage attributes (PGSTE). It assumes dirty tracking is enabled on all
memslots to keep a dirty bitmap of pages with changed storage attributes.

When enabling migration mode, we currently check that dirty tracking is
enabled for all memslots. However, userspace can disable dirty tracking
without disabling migration mode.

Since migration mode is pointless with dirty tracking disabled, disable
migration mode whenever userspace disables dirty tracking on any slot.

Also update the documentation to clarify that dirty tracking must be
enabled when enabling migration mode, which is already enforced by the
code in kvm_s390_vm_start_migration().

Also highlight in the documentation for KVM_S390_GET_CMMA_BITS that it
can now fail with -EINVAL when dirty tracking is disabled while
migration mode is on. Move all the error codes to a table so this stays
readable.

To disable migration mode, slots_lock should be held, which is taken
in kvm_set_memory_region() and thus held in
kvm_arch_prepare_memory_region().

Restructure the prepare code a bit so all the sanity checking is done
before disabling migration mode. This ensures migration mode isn't
disabled when some sanity check fails.

Cc: stable@vger.kernel.org
Fixes: 190df4a212 ("KVM: s390: CMMA tracking, ESSA emulation, migration mode")
Signed-off-by: Nico Boehr <nrb@linux.ibm.com>
Reviewed-by: Janosch Frank <frankja@linux.ibm.com>
Reviewed-by: Claudio Imbrenda <imbrenda@linux.ibm.com>
Link: https://lore.kernel.org/r/20230127140532.230651-2-nrb@linux.ibm.com
Message-Id: <20230127140532.230651-2-nrb@linux.ibm.com>
[frankja@linux.ibm.com: fixed commit message typo, moved api.rst error table upwards]
Signed-off-by: Janosch Frank <frankja@linux.ibm.com>
2023-02-07 18:05:59 +01:00
..
README Documentation: move Documentation/virtual to Documentation/virt 2019-07-24 10:52:11 +02:00
arm-vgic-its.rst KVM: Support dirty ring in conjunction with bitmap 2022-11-10 13:11:58 +00:00
arm-vgic-v3.rst docs: kvm: devices/arm-vgic-v3: enhance KVM_DEV_ARM_VGIC_CTRL_INIT doc 2021-04-06 14:51:38 +01:00
arm-vgic.rst docs: kvm: convert devices/arm-vgit.txt to ReST 2020-02-12 20:09:53 +01:00
index.rst docs: kvm: convert devices/xive.txt to ReST 2020-02-12 20:09:58 +01:00
mpic.rst docs: kvm: convert devices/mpic.txt to ReST 2020-02-12 20:09:54 +01:00
s390_flic.rst KVM: s390/interrupt: do not pin adapter interrupt pages 2020-02-27 19:47:10 +01:00
vcpu.rst KVM: arm64: Fix pvtime documentation 2022-11-11 16:29:22 +00:00
vfio.rst docs: kvm: convert devices/vfio.txt to ReST 2020-02-12 20:09:56 +01:00
vm.rst KVM: s390: disable migration mode when dirty tracking is disabled 2023-02-07 18:05:59 +01:00
xics.rst kvm: rename KVM_MAX_VCPU_ID to KVM_MAX_VCPU_IDS 2021-09-30 04:27:05 -04:00
xive.rst kvm: rename KVM_MAX_VCPU_ID to KVM_MAX_VCPU_IDS 2021-09-30 04:27:05 -04:00

README

This directory contains specific device bindings for KVM_CAP_DEVICE_CTRL.