kvm/devices/vcpu.rst

1 .. SPDX-License-Identifier: GPL-2.0
9 kvm_device_attr as other devices, but targets VCPU-wide settings and controls.
19 ---------------------------------------
27 	 -EBUSY   The PMU overflow interrupt is already set
28 	 -EFAULT  Error reading interrupt number
29 	 -ENXIO   PMUv3 not supported or the overflow interrupt not set
31 	 -ENODEV  KVM_ARM_VCPU_PMU_V3 feature missing from VCPU
32 	 -EINVAL  Invalid PMU overflow interrupt number supplied or
33 		  trying to set the IRQ number without using an in-kernel
43 ---------------------------------------
50 	 -EEXIST  Interrupt number already used
51 	 -ENODEV  PMUv3 not supported or GIC not initialized
52 	 -ENXIO   PMUv3 not supported, missing VCPU feature or interrupt
53 		  number not set
54 	 -EBUSY   PMUv3 already initialized
57 Request the initialization of the PMUv3.  If using the PMUv3 with an in-kernel
58 virtual GIC implementation, this must be done after initializing the in-kernel
62 -----------------------------------------
70 	 -ENODEV  PMUv3 not supported or GIC not initialized
71 	 -ENXIO   PMUv3 not properly configured or in-kernel irqchip not
73 	 -EBUSY   PMUv3 already initialized or a VCPU has already run
74 	 -EINVAL  Invalid filter range
92 first registered range defines the global policy (global ALLOW if the first
93 @action is DENY, global DENY if the first @action is ALLOW). Multiple ranges
98 range doesn't change the default action. For example, installing an ALLOW
108 ------------------------------------------
116 	 -EBUSY   PMUv3 already initialized, a VCPU has already run or
117                   an event filter has already been set
118 	 -EFAULT  Error accessing the PMU identifier
119 	 -ENXIO   PMU not found
120 	 -ENODEV  PMUv3 not supported or GIC not initialized
121 	 -ENOMEM  Could not allocate memory
128 systems where there are at least two CPU PMUs on the system. The PMU that is set
129 for one VCPU will be used by all the other VCPUs. It isn't possible to set a PMU
146 -----------------------------------------------------------------------------
154 	 -EINVAL  Invalid timer interrupt number
155 	 -EBUSY   One or more VCPUs has already run
159 in-kernel virtual GIC.  These must be a PPI (16 <= intid < 32).  Setting the
169 time to use the number provided for a given timer, overwriting any previously
182 --------------------------------------
184 :Parameters: 64-bit base address
189 	 -ENXIO   Stolen time not implemented
190 	 -EEXIST  Base address already set for this VCPU
191 	 -EINVAL  Base address not 64 byte aligned
194 Specifies the base address of the stolen time structure for this VCPU. The
197 including the layout of the stolen time structure.
206 :Parameters: 64-bit unsigned TSC offset
211 	 -EFAULT Error reading/writing the provided
213 	 -ENXIO  Attribute not supported
222 so that the TSC counts the time during which the VM was paused. The
241    fields.  Ensure that the KVM_CLOCK_REALTIME flag is set in the provided
244    KVM will advance the VM's kvmclock to account for elapsed time since
247    between the source and destination, and a reasonably short time passes
249    steps 4-7.
254 6. Adjust the guest TSC offsets for every vCPU to account for (1) time
258    ofs_dst[i] = ofs_src[i] -
259      (guest_src - guest_dest) * freq +
260      (tsc_src - tsc_dest)
262    ("ofs[i] + tsc - guest * freq" is the guest TSC value corresponding to
263    a time of 0 in kvmclock.  The above formula ensures that it is the