Re: [PATCH 3/3] Documentation: KVM: add API issues section

From: Paolo Bonzini
Date: Wed Mar 23 2022 - 17:33:01 EST


On 3/23/22 19:16, Oliver Upton wrote:
Do you think we should vent about our mistakes inline with the
descriptions of the corresponding UAPI? One example that comes to mind
is ARM's CNTV_CVAL_EL0/CNTVCT_EL0 mixup, which is mentioned in 4.68
'KVM_SET_ONE_REG'. That, of course, doesn't cover the
previously-undocumented bits of UAPI that are problematic:)

It depends. My intention was to use this document more for hidden interdependencies, in this case between KVM_GET_SUPPORTED_CPUID and KVM_CREATE_IRQCHIP, KVM_ENABLE_CAP(KVM_CAP_IRQCHIP_SPLIT), KVM_CAP_TSC_DEADLINE_TIMER.

Paolo