Commit 9df2d660 authored by Dave Martin's avatar Dave Martin Committed by Marc Zyngier

KVM: Clarify capability requirements for KVM_ARM_VCPU_FINALIZE

Userspace is only supposed to use KVM_ARM_VCPU_FINALIZE when there
is some vcpu feature that can actually be finalized.

This means that documenting KVM_ARM_VCPU_FINALIZE as available or
not depending on the capabilities present is not helpful.

This patch amends the documentation to describe availability in
terms of which capability is required for each finalizable feature
instead.

In any case, userspace sees the same error (EINVAL) regardless of
whether the given feature is not present or KVM_ARM_VCPU_FINALIZE
is not implemented at all.

No functional change.
Suggested-by: default avatarAndrew Jones <drjones@redhat.com>
Signed-off-by: default avatarDave Martin <Dave.Martin@arm.com>
Reviewed-by: default avatarAndrew Jones <drjones@redhat.com>
Signed-off-by: default avatarMarc Zyngier <marc.zyngier@arm.com>
parent 92e68b2b
...@@ -3999,17 +3999,16 @@ userspace should not expect to get any particular value there. ...@@ -3999,17 +3999,16 @@ userspace should not expect to get any particular value there.
4.119 KVM_ARM_VCPU_FINALIZE 4.119 KVM_ARM_VCPU_FINALIZE
Capability: KVM_CAP_ARM_SVE
Architectures: arm, arm64 Architectures: arm, arm64
Type: vcpu ioctl Type: vcpu ioctl
Parameters: int feature (in) Parameters: int feature (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
Errors: Errors:
EPERM: feature not enabled, needs configuration, or already finalized EPERM: feature not enabled, needs configuration, or already finalized
EINVAL: unknown feature EINVAL: feature unknown or not present
Recognised values for feature: Recognised values for feature:
arm64 KVM_ARM_VCPU_SVE arm64 KVM_ARM_VCPU_SVE (requires KVM_CAP_ARM_SVE)
Finalizes the configuration of the specified vcpu feature. Finalizes the configuration of the specified vcpu feature.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment