From patchwork Tue Aug 1 00:21:21 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mingwei Zhang X-Patchwork-Id: 128943 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:918b:0:b0:3e4:2afc:c1 with SMTP id s11csp2383866vqg; Mon, 31 Jul 2023 19:02:37 -0700 (PDT) X-Google-Smtp-Source: APBJJlHWM7O4MBNbRkX+NydrMy57UpFcE2zXiniKWnPUa18t1Loen6uqEXyL+IZO8E2H4LayIocn X-Received: by 2002:a9d:798c:0:b0:6b7:4cd0:8a1e with SMTP id h12-20020a9d798c000000b006b74cd08a1emr11678263otm.19.1690855357123; Mon, 31 Jul 2023 19:02:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1690855357; cv=none; d=google.com; s=arc-20160816; b=obFv/SEgeOIRBDw7GY6j0IdZmtO1jIMfi4ZxAPgRYiISvLPah0b9EietPrlc9+j6k4 jhbmUBjBPtR1dwSrRpjBDvZOB8dKhO1vvmgeQC+ug0QxL4viGakkPk8uuw9DYXiyQVgs fprhC22Vo5UoT6Pt0byDtKci5Zk2G3O5wjvpJ0FtjPYbhOqgj9PVPjdmuYlVZLgaFJG+ p1WArp5q2RjCeNc9YCQ6H6WkKbkAqyFedSq0b5JUYGr/o0N/2Orj1NNikAkLWdEbDuj4 A5/dD8QOk/EqprQfRqwOJB2cPrVFJ24627pjpfy6kI8wF13PajVFFOR+JA8lNShIwVs2 iqFg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:from:subject:message-id:references :mime-version:in-reply-to:date:reply-to:dkim-signature; bh=2V2qqbRtJdIF4yKoul1PG5FvBTRojVE4noGz8EUUEGo=; fh=gya5F2cZq9WTAdFit1IlKDHE8FQoHEyxSPkqDAO7wTs=; b=QhTGf3Mtf0yra/LDaAh0sV+RBoxVB/QXBWWpSh4oI3lD51epoxHeSKCM8edAycJicA HdkdbVLLny9i4XhZDd2FxAnmBd13Ex2CH8OfvBGiGdbVysAvpLaV+z2q/34oLmrZeBhn NOXcYF8KiJCIEDpoHBlnNBJQPg+tctWFfJLVFMW7yxanAuTutJvLsT1sxqnpIbKjVOyg CoVmpDlruNvhtkHEfwI/Dr0xUK+dLzJX9yTlKXn8oYmCqhY6JzZr0awr9kkerPeCNhfp ygIEKfHLOtc2c4q+4JN7RaChe917dT48xeTlqJ+Y3p8AuELxvP0FLK/J3ZxQJFozKQl1 dpPw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20221208 header.b=b4gXIVWX; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id n4-20020a635904000000b00553e8d95742si6764583pgb.654.2023.07.31.19.02.24; Mon, 31 Jul 2023 19:02:37 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20221208 header.b=b4gXIVWX; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231238AbjHAAVg (ORCPT + 99 others); Mon, 31 Jul 2023 20:21:36 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36616 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230507AbjHAAVc (ORCPT ); Mon, 31 Jul 2023 20:21:32 -0400 Received: from mail-pg1-x549.google.com (mail-pg1-x549.google.com [IPv6:2607:f8b0:4864:20::549]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 211BE19A8 for ; Mon, 31 Jul 2023 17:21:32 -0700 (PDT) Received: by mail-pg1-x549.google.com with SMTP id 41be03b00d2f7-563bcd2cb78so5212138a12.3 for ; Mon, 31 Jul 2023 17:21:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20221208; t=1690849291; x=1691454091; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:reply-to:from:to:cc:subject:date:message-id:reply-to; bh=2V2qqbRtJdIF4yKoul1PG5FvBTRojVE4noGz8EUUEGo=; b=b4gXIVWX4cTKAZEBzuS9bcuTAIwnIpR66S3yHkHBzJg6Pqk6/twID1GBjAw9sqMNEe sr8t7BYV6mty7CFn9oOUry++ndP3gel1ZBA8n433pUcnMmtKavpQiAYhxdjtq1zNP+qW A8K77tu+LeGtGiHgEOpdG7tDsHmKWquXFI6tAAxOsBTLMioIR2PHsAOh+VW6BFFxkxcA 9CrK1F/fby5iCi3/bzHMc/edGX33OcDpyrk8Q2FoI/Y4wqcJJHZfuATFIWdUgbI2RS9R GNpOA/tcOK68CMq2+Z/xSUQ1C7Fa6o9a9EpLwQSaxRB1rwWII+JOkwVx5V2Wyx1Ewdl/ ZR7A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1690849291; x=1691454091; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:reply-to:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=2V2qqbRtJdIF4yKoul1PG5FvBTRojVE4noGz8EUUEGo=; b=CZWTdaEJskame7ElP2QDMNX4C8/cPNbKXqChLh0w9z8GceVNAlZmiZe5+qZacdS8UP avqF+eNt1cD8+vPLvRCpUihLf9cIRwARukDoWTTWbDczMpeQreGdU23Rhk9RhBmzRPfj 96DvyjJTt3ZA8Vn/AQk4g+YtdRY8rCZ20911I531ql09YXi7DrkAL2FAjAz4ZsqKo3Pc v1bDmQhcqVioZUGfIFn2XGTigp0HtCouk9TaVSkZwJsrsL+IPqZgk7pHn9fzglnYzuOU eVxoy8Mn/yDO0f2jtjBHb6jCg2acYbbv9a+hQ5H3sInomW4xVvB64fQh88bLb5kydsUd +bBg== X-Gm-Message-State: ABy/qLawTdIr0OkcGfS2jGxOLxjs1NFauJDY0hRfboA2C8cntn990Qve JurOzwgiPq88IV0GmIXv7BuYtwNhkU+p X-Received: from mizhang-super.c.googlers.com ([34.105.13.176]) (user=mizhang job=sendgmr) by 2002:a63:7e54:0:b0:564:f85:c822 with SMTP id o20-20020a637e54000000b005640f85c822mr66706pgn.8.1690849291659; Mon, 31 Jul 2023 17:21:31 -0700 (PDT) Reply-To: Mingwei Zhang Date: Tue, 1 Aug 2023 00:21:21 +0000 In-Reply-To: <20230801002127.534020-1-mizhang@google.com> Mime-Version: 1.0 References: <20230801002127.534020-1-mizhang@google.com> X-Mailer: git-send-email 2.41.0.585.gd2178a4bd4-goog Message-ID: <20230801002127.534020-2-mizhang@google.com> Subject: [PATCH v3 1/6] KVM: Documentation: Add the missing description for guest_mode in kvm_mmu_page_role From: Mingwei Zhang To: Sean Christopherson , Paolo Bonzini Cc: kvm@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Mingwei Zhang , Kai Huang , Jim Mattson , David Matlack , Ben Gardon , Xu Yilun , Zhi Wang , Randy Dunlap X-Spam-Status: No, score=-9.6 required=5.0 tests=BAYES_00,DKIMWL_WL_MED, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF, RCVD_IN_DNSWL_BLOCKED,SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE, USER_IN_DEF_DKIM_WL autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1772990347041847651 X-GMAIL-MSGID: 1772990347041847651 Add the missing description for guest_mode in kvm_mmu_page_role description. guest_mode tells KVM whether a shadow page is used for the L1 or an L2. Update the missing field in documentation. Signed-off-by: Mingwei Zhang Reviewed-by: Kai Huang --- Documentation/virt/kvm/x86/mmu.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/virt/kvm/x86/mmu.rst b/Documentation/virt/kvm/x86/mmu.rst index 8364afa228ec..561efa8ec7d7 100644 --- a/Documentation/virt/kvm/x86/mmu.rst +++ b/Documentation/virt/kvm/x86/mmu.rst @@ -202,6 +202,8 @@ Shadow pages contain the following information: Is 1 if the MMU instance cannot use A/D bits. EPT did not have A/D bits before Haswell; shadow EPT page tables also cannot use A/D bits if the L1 hypervisor does not enable them. + role.guest_mode: + Indicates the shadow page is created for a nested guest. role.passthrough: The page is not backed by a guest page table, but its first entry points to one. This is set if NPT uses 5-level page tables (host