Linux KVM/arm64 development list
 help / color / mirror / Atom feed
* [PATCH] KVM: arm64: Document vCPU event ioctls as requiring init'ed vCPU
@ 2025-09-30 22:15 Oliver Upton
  0 siblings, 0 replies; only message in thread
From: Oliver Upton @ 2025-09-30 22:15 UTC (permalink / raw)
  To: kvmarm; +Cc: Marc Zyngier, Joey Gouly, Suzuki K Poulose, Zenghui Yu,
	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>
---
 Documentation/virt/kvm/api.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Documentation/virt/kvm/api.rst b/Documentation/virt/kvm/api.rst
index 6aa40ee05a4a..057a9c9336d6 100644
--- a/Documentation/virt/kvm/api.rst
+++ b/Documentation/virt/kvm/api.rst
@@ -1229,6 +1229,8 @@ 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 -ENXIO.
+
 ::
 
   struct kvm_vcpu_events {
@@ -1309,6 +1311,7 @@ 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 -ENXIO.
 
 4.33 KVM_GET_DEBUGREGS
 ----------------------

base-commit: 10fd0285305d0b48e8a3bf15d4f17fc4f3d68cb6
-- 
2.39.5


^ permalink raw reply related	[flat|nested] only message in thread

only message in thread, other threads:[~2025-09-30 22:15 UTC | newest]

Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-09-30 22:15 [PATCH] KVM: arm64: Document vCPU event ioctls as requiring init'ed vCPU Oliver Upton

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox