From patchwork Sun Jun 18 00:08:50 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mingwei Zhang X-Patchwork-Id: 13283745 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 876CEEB64DA for ; Sun, 18 Jun 2023 00:09:16 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230059AbjFRAJO (ORCPT ); Sat, 17 Jun 2023 20:09:14 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38168 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229668AbjFRAJN (ORCPT ); Sat, 17 Jun 2023 20:09:13 -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 1FB9C170B for ; Sat, 17 Jun 2023 17:09:12 -0700 (PDT) Received: by mail-pg1-x549.google.com with SMTP id 41be03b00d2f7-517bad1b8c5so1770225a12.0 for ; Sat, 17 Jun 2023 17:09:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20221208; t=1687046951; x=1689638951; h=cc:to:from:subject:message-id:mime-version:date:reply-to:from:to:cc :subject:date:message-id:reply-to; bh=ymRd0fdFh05CtNVNiLUjlDKK/2gV3v4AfyLZi4whH8g=; b=rMMgGNr8vOsgIkOwkRLQIIhyAjefMdQun+/xW0SYS17CmY6HzQ06lgWc6nsxtEfJTv Ht+YODtZPWTHujruU9N3ACex9+1Dv9mnBumypRTC2rrba1NQNUZyxoh2qvP++oAnMbOe FTLLemr0Z4m1wethMrX1dXSWMKUgENWDCm7hM9la9tX8ZgYuWu8nJ5eeioSr8a3YWGvE 2FfkBIalA3Jc0giJsyLWj+lRkA2dnltrX66kqGs7FTP48zPkLEpNFf00nJy/53tnaBRA TH6QP/ReTgdCAU4enlYNi7Exx5f1Yojwdz8ryHo3mJ7Rqw3+6KkY56ON8inJK6Pzqik1 0h6g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1687046951; x=1689638951; h=cc:to:from:subject:message-id:mime-version:date:reply-to :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=ymRd0fdFh05CtNVNiLUjlDKK/2gV3v4AfyLZi4whH8g=; b=PGfUo1SfaXNg+tIFyxWLc2Wdg6W4XrhRsLxgWJcGCZWH4SPRsG8prA/6/wb3lgJuO/ xlTc0XVojU2nVsfSFTOoNpkH3W/QB+m+nb3NEmAnmGaSE0NjRyExEQpVkL/VdtSM/2oY ko2prLgDDAyMmOWTN+hJ4HdJOcVQIQ7173d/euXd+XbX1fyAviaYUpEch51I1O4htQgb HYkLQ8pW9XbAv38hnE/XrOOveKFxyOHBsF2Zne1SSTspYDLtnSfC/on2q0yGKfQRfhc9 qzLKiYDtwTuw+Of+abCEVLWEltfEh3vTDOzsau4V2e/IqiA8GVhApa9bS/H7youkD+5W r0Ng== X-Gm-Message-State: AC+VfDzX88viS8KcTppnD0yjQ6C/6G3ufgRlyRVBnVdZSOVpdQSD3QQC 0PcdnbqRlG3o8eefV9dHTCsw5I0LltFt X-Google-Smtp-Source: ACHHUZ7GBo3wRFRwvXCrjp6qeYjQCJ/WI3qJ0vD6yL18cd/w9bx5ricJ9hcD5llEl1GlDMxTKrwzIOWwXMmF X-Received: from mizhang-super.c.googlers.com ([35.247.89.60]) (user=mizhang job=sendgmr) by 2002:a17:902:a705:b0:1b3:ec39:f41b with SMTP id w5-20020a170902a70500b001b3ec39f41bmr915256plq.7.1687046951468; Sat, 17 Jun 2023 17:09:11 -0700 (PDT) Reply-To: Mingwei Zhang Date: Sun, 18 Jun 2023 00:08:50 +0000 Mime-Version: 1.0 X-Mailer: git-send-email 2.41.0.162.gfafddb0af9-goog Message-ID: <20230618000856.1714902-1-mizhang@google.com> Subject: [PATCH 0/6] KVM: Documentation: Update document description for kvm_mmu_page and 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 , Jim Mattson , David Matlack , Ben Gardon Precedence: bulk List-ID: X-Mailing-List: kvm@vger.kernel.org When reading the KVM MMU documentation for nested virtualization, I feel that the description of kvm_mmu_page (and kvm_mmu_page_role) has been lagging for around 1-2 years. The descriptions for several fields in struct kvm_mmu_page and struct kvm_mmu_page_role are missing. So I think it might be good to add them to make it consistent with the current code. Note that there are still some fields not added in this series: - kvm_mmu_page.nx_huge_page_disallowed - kvm_mmu_page.possible_nx_huge_page_link - kvm_mmu_page.hash_link - kvm_mmu_page.link For the above, I thought the description might be just better to be inlined or there is already good description inlined. Mingwei Zhang (6): KVM: Documentation: Add the missing guest_mode in kvm_mmu_page_role KVM: Documentation: Update the field name gfns in kvm_mmu_page KVM: Documentation: Add the missing ptep in kvm_mmu_page KVM: Documentation: Add the missing tdp_mmu_root_count into kvm_mmu_page KVM: Documentation: Add the missing mmu_valid_gen into kvm_mmu_page KVM: Documentation: Add the missing tdp_mmu_page into kvm_mmu_page Documentation/virt/kvm/x86/mmu.rst | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) base-commit: 265b97cbc22e0f67f79a71443b60dc1237ca5ee6