From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 223EAEB64D9 for ; Mon, 26 Jun 2023 21:44:58 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230121AbjFZVo5 (ORCPT ); Mon, 26 Jun 2023 17:44:57 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37320 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229459AbjFZVoy (ORCPT ); Mon, 26 Jun 2023 17:44:54 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 26FAEE6F; Mon, 26 Jun 2023 14:44:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date: Message-ID:Sender:Reply-To:Content-ID:Content-Description; bh=EdgK0IHrzHwFNhFM3Sp8S6TGye1AJP5vyX4MGNNLE8c=; b=vnYPiZvsf3gk3whl4Re7bpeeIs jpvevsVauYb3VlJxp9V4mE/NVKN57XH9jjzcYBkndLmQxeFzogqHcP3BZlN2BJsHekICQdg78vmfE wqUSbheArEfSqVUUpR6M+FfegOjI/jIantl2IpIFec1f20/luP4UNAOEVFNNdMOGJULNt7HrdfHJh sQdZz7hRnwaVkLdzSdFwajRBKerXhGiKCEIcKGV5Y1DOFiB3i7opU3GVc/HPC1mvhwqYusJLJNuTl ebhnq3XIO+Gz3+eCL3P0f2xnYo31RYVQpN1okrb7l4a9cWiRt9zGn30AkrvcstTvkL9xpBGdayinu jqyeB4pw==; Received: from [2601:1c2:980:9ec0::2764] by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qDu0y-00B5Z2-0f; Mon, 26 Jun 2023 21:44:52 +0000 Message-ID: Date: Mon, 26 Jun 2023 14:44:51 -0700 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.11.2 Subject: Re: [PATCH v2 3/6] KVM: Documentation: Add the missing description for ptep in kvm_mmu_page Content-Language: en-US To: Mingwei Zhang , Sean Christopherson , Paolo Bonzini Cc: kvm@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Kai Huang , Jim Mattson , David Matlack , Ben Gardon , Xu Yilun , Zhi Wang References: <20230626182016.4127366-1-mizhang@google.com> <20230626182016.4127366-4-mizhang@google.com> From: Randy Dunlap In-Reply-To: <20230626182016.4127366-4-mizhang@google.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 6/26/23 11:20, Mingwei Zhang wrote: > Add the missing description for ptep in kvm_mmu_page description. ptep is > used when TDP MMU is enabled and it shares the storage with parent_ptes. > Update the doc to help readers to get up-to-date info. > > Signed-off-by: Mingwei Zhang > --- > Documentation/virt/kvm/x86/mmu.rst | 5 +++++ > 1 file changed, 5 insertions(+) > > diff --git a/Documentation/virt/kvm/x86/mmu.rst b/Documentation/virt/kvm/x86/mmu.rst > index 4c9044b4dc6c..5cd6cd5e8926 100644 > --- a/Documentation/virt/kvm/x86/mmu.rst > +++ b/Documentation/virt/kvm/x86/mmu.rst > @@ -237,6 +237,11 @@ Shadow pages contain the following information: > parent_ptes points at this single spte, otherwise, there exists multiple > sptes pointing at this page and (parent_ptes & ~0x1) points at a data > structure with a list of parent sptes. > + ptep: > + The reverse mapping for the pte pointing at this page's spt. This field is > + used in replace of parent_ptes when TDP MMU is used. In TDP MMU, each in replacement of > + non-root shadow page will have one parent, while each root shadow page has > + no parent. Note that this field is a union with parent_ptes. > unsync: > If true, then the translations in this page may not match the guest's > translation. This is equivalent to the state of the tlb when a pte is -- ~Randy