• Sean Christopherson's avatar
    KVM: x86: Reword MSR filtering docs to more precisely define behavior · b93d2ec3
    Sean Christopherson authored
    Reword the MSR filtering documentatiion to more precisely define the
    behavior of filtering using common virtualization terminology.
    
      - Explicitly document KVM's behavior when an MSR is denied
      - s/handled/allowed as there is no guarantee KVM will "handle" the
        MSR access
      - Drop the "fall back" terminology, which incorrectly suggests that
        there is existing KVM behavior to fall back to
      - Fix an off-by-one error in the range (the end is exclusive)
      - Call out the interaction between MSR filtering and
        KVM_CAP_X86_USER_SPACE_MSR's KVM_MSR_EXIT_REASON_FILTER
      - Delete the redundant paragraph on what '0' and '1' in the bitmap
        means, it's covered by the sections on KVM_MSR_FILTER_{READ,WRITE}
      - Delete the clause on x2APIC MSR behavior depending on APIC base, this
        is covered by stating that KVM follows architectural behavior when
        emulating/virtualizing MSR accesses
    Reported-by: default avatarAaron Lewis <aaronlewis@google.com>
    Signed-off-by: default avatarSean Christopherson <seanjc@google.com>
    Link: https://lore.kernel.org/r/20220831001706.4075399-3-seanjc@google.com
    b93d2ec3
api.rst 284 KB