[PATCH v2] KVM: arm64: Document vCPU event ioctls as requiring init'ed vCPU

[PATCH v2] KVM: arm64: Document vCPU event ioctls as requiring init'ed vCPU

[Oliver Upton]

KVM rejects calls to KVM_{GET,SET}_VCPU_EVENTS for an uninitialized vCPU
as of commit cc96679f3c03 ("KVM: arm64: Prevent access to vCPU events
before init"). Update the corresponding API documentation.

Signed-off-by: Oliver Upton <oliver.upton@linux.dev>
---

v1 -> v2:
 - I can't read.

 Documentation/virt/kvm/api.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Documentation/virt/kvm/api.rst b/Documentation/virt/kvm/api.rst
index 6aa40ee05a4a..15235a465879 100644
--- a/Documentation/virt/kvm/api.rst
+++ b/Documentation/virt/kvm/api.rst
@@ -1229,6 +1229,9 @@ It is not possible to read back a pending external abort (injected via
 KVM_SET_VCPU_EVENTS or otherwise) because such an exception is always delivered
 directly to the virtual CPU).
 
+Calling this ioctl on a vCPU that hasn't been initialized will return
+-ENOEXEC.
+
 ::
 
   struct kvm_vcpu_events {
@@ -1309,6 +1312,8 @@ exceptions by manipulating individual registers using the KVM_SET_ONE_REG API.
 
 See KVM_GET_VCPU_EVENTS for the data structure.
 
+Calling this ioctl on a vCPU that hasn't been initialized will return
+-ENOEXEC.
 
 4.33 KVM_GET_DEBUGREGS
 ----------------------

base-commit: 10fd0285305d0b48e8a3bf15d4f17fc4f3d68cb6
-- 
2.39.5

Re: [PATCH v2] KVM: arm64: Document vCPU event ioctls as requiring init'ed vCPU

[Marc Zyngier]

On Tue, 30 Sep 2025 16:36:20 -0700, Oliver Upton wrote:
> KVM rejects calls to KVM_{GET,SET}_VCPU_EVENTS for an uninitialized vCPU
> as of commit cc96679f3c03 ("KVM: arm64: Prevent access to vCPU events
> before init"). Update the corresponding API documentation.
> 
> 

Applied to fixes, thanks!

[1/1] KVM: arm64: Document vCPU event ioctls as requiring init'ed vCPU
      commit: 7775af6d1cc6f398ceb16abe13d1469065abb1d8

Cheers,

	M.
-- 
Without deviation from the norm, progress is not possible.