| From: |
| Ackerley Tng via B4 Relay <devnull+ackerleytng.google.com-AT-kernel.org> |
| To: |
| Paolo Bonzini <pbonzini-AT-redhat.com>, Jonathan Corbet <corbet-AT-lwn.net>, Shuah Khan <skhan-AT-linuxfoundation.org>, Tianrui Zhao <zhaotianrui-AT-loongson.cn>, Bibo Mao <maobibo-AT-loongson.cn>, Huacai Chen <chenhuacai-AT-kernel.org>, WANG Xuerui <kernel-AT-xen0n.name>, Sean Christopherson <seanjc-AT-google.com>, Thomas Gleixner <tglx-AT-kernel.org>, Ingo Molnar <mingo-AT-redhat.com>, Borislav Petkov <bp-AT-alien8.de>, Dave Hansen <dave.hansen-AT-linux.intel.com>, Fuad Tabba <tabba-AT-google.com>, vannapurve-AT-google.com, x86-AT-kernel.org, "H. Peter Anvin" <hpa-AT-zytor.com> |
| Subject: |
| [PATCH RFC 00/12] Document synchronization used in managing guest faults |
| Date: |
| Wed, 27 May 2026 08:33:12 -0700 |
| Message-ID: |
| <20260527-kvm-locking-docs-v1-0-4fe8b602ff47@google.com> |
| Cc: |
| kvm-AT-vger.kernel.org, linux-doc-AT-vger.kernel.org, linux-kernel-AT-vger.kernel.org, loongarch-AT-lists.linux.dev, Ackerley Tng <ackerleytng-AT-google.com> |
| Archive-link: |
| Article |
In [1], Sean suggested consolidating comments for some functions.
While trying to consolidate comments, I read up more about synchronization
used in managing guest faults and put together some updates for
Documentation/virt/kvm/locking.rst, including some fixes to the current
content.
I'm generalizing the kinds of functions Sean was referring to as
"documentation for functions that depend on derived information from GFNs",
and kvm_gmem_get_memory_attributes() from the conversion series [1] will
also point to the documentation that is updated in this patch series.
[1] https://lore.kernel.org/all/ag8JIlHjohAOC3-g@google.com/
Signed-off-by: Ackerley Tng <ackerleytng@google.com>
---
Ackerley Tng (12):
Documentation: KVM: Elaborate comment on kvm_usage_lock
Documentation: KVM: Consolidate notes about cpu_read_lock() and kvm_lock
Documentation: KVM: Consolidate notes about kvm->slots_lock and irq_lock
Documentation: KVM: Turn - into bullet point
Documentation: KVM: Explain what rule the exception section is meant for
Documentation: KVM: Have actual headings for exceptions
Documentation: KVM: Drop mention of kvm->lock in SRCU documentation
Documentation: KVM: Add example for kvm->srcu in relation to mutex/lock
Documentation: KVM: Document synchronization for managing guest faults
KVM: guest_memfd: Clarify comment about gmem.file vs kvm->srcu
KVM: mmu: Point users of host_pfn_mapping_level() to docs
Documentation: KVM: Focus acquisition order section on preventing deadlocks
Documentation/virt/kvm/locking.rst | 173 ++++++++++++++++++++++++++++++++-----
arch/loongarch/kvm/mmu.c | 24 +----
arch/x86/kvm/mmu/mmu.c | 24 +----
virt/kvm/guest_memfd.c | 9 +-
4 files changed, 165 insertions(+), 65 deletions(-)
---
base-commit: b7fbe9a1bf9ee6c967ef77d366ca58c35fcf1887
change-id: 20260527-kvm-locking-docs-3c6dee0fabce
Best regards,
--
Ackerley Tng <ackerleytng@google.com>
