KVM: x86/mmu: Clarify TDP MMU page list invariants
authorBen Gardon <bgardon@google.com>
Thu, 7 Jan 2021 00:19:35 +0000 (16:19 -0800)
committerPaolo Bonzini <pbonzini@redhat.com>
Thu, 7 Jan 2021 23:11:32 +0000 (18:11 -0500)
commitc0dba6e46825716db15c4b3a8f05c85b4a59edda
tree2761a464180eeabd99d3dc53a344337f7daf2d0d
parenta889ea54b3daa63ee1463dc19ed699407d61458b
KVM: x86/mmu: Clarify TDP MMU page list invariants

The tdp_mmu_roots and tdp_mmu_pages in struct kvm_arch should only contain
pages with tdp_mmu_page set to true. tdp_mmu_pages should not contain any
pages with a non-zero root_count and tdp_mmu_roots should only contain
pages with a positive root_count, unless a thread holds the MMU lock and
is in the process of modifying the list. Various functions expect these
invariants to be maintained, but they are not explictily documented. Add
to the comments on both fields to document the above invariants.

Signed-off-by: Ben Gardon <bgardon@google.com>
Message-Id: <20210107001935.3732070-2-bgardon@google.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
arch/x86/include/asm/kvm_host.h