Hi Paolo, On Tue, Mar 22, 2022 at 12:07:12PM +0100, Paolo Bonzini wrote: > Add a section to document all the different ways in which the KVM API sucks. > > I am sure there are way more, give people a place to vent so that userspace > authors are aware. > > Signed-off-by: Paolo Bonzini <pbonzini@xxxxxxxxxx> 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 :) If we go that route we likely should have a good format for documenting the ugliness. -- Thanks, Oliver
