From patchwork Mon Jun 12 03:08:07 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 106194 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:994d:0:b0:3d9:f83d:47d9 with SMTP id k13csp2330483vqr; Sun, 11 Jun 2023 20:17:23 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ57tYUzLIztnq9unTeKfPChyH5mzmDwEBri0Y+bdMTzyyDnr2ZTWG3IsYdqD64CdsTSmXul X-Received: by 2002:a17:90a:d304:b0:25b:e081:54e6 with SMTP id p4-20020a17090ad30400b0025be08154e6mr1945438pju.37.1686539843296; Sun, 11 Jun 2023 20:17:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686539843; cv=none; d=google.com; s=arc-20160816; b=imL1IO+fo1310Mkx1p6nX+NRszGO/SMEJfqzjf6f6h8T6oqNmBhSxteGkJkZXxAHuw nY3oMYArNIm9XXwVkp0sWAdBz0PVwC3Tos6xTh1BNSDP5jTZNX8aQ1vHMw7AfLKvl8ma buni/B2V3pkkpvXi2ZVkxta6C51nwfuDDWz4ssQ6ttYDtYB00GGfHfgh6oyjgbXbtpKC tw5nvWtw2s2JyLgrAHK7AblZhHdRmG8nbPx350cvxToC7W8PXcIUmmi6J5nEii7a6WPF IAs1lb67uvzwLCN7u3GnvsBbHTkbn5FPetdQaS78K9Ow+XE7mxzfWuvJBLDR7PpyA2oA 5hdg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=kYsaDINwgGyBkCQoDFNAkvO4v5df2UfOXAdRONE+VsA=; b=FxcZKxqz1QjXVXlZRNh9Zfhj/qwaay/3v4T7wA7VqKMdLd17bFp082oUO93/zcNz/X 7Nd12JzJITmVmQsAtzDIork/X4Zj3b7iQb9Bdu11v5EFXxPII0mB5sNtm1OU3SiMuIXW eiMVO0RyTG238EkrbRcTgMsBjDhnt36ZiNkVeLYXn1nPgtvZ4sttDRwRLAqHBYqDzzDm MEc6IxQjIWkSkqHRlyM/VyVb5aoeLzsc0AanT3eDkUgv13khiitUEU9KVmlLZTBm0sey aZZNg4x9iJxmYax8q+fbtcwt/xOQFn1HyMp5WVxHgKgsyVAxainxQvpBzFi5CDSZSoat X+Uw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=cuhGQNGp; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id pi12-20020a17090b1e4c00b00256d7cc5b67si6664329pjb.133.2023.06.11.20.17.11; Sun, 11 Jun 2023 20:17:23 -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=@infradead.org header.s=bombadil.20210309 header.b=cuhGQNGp; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234270AbjFLDIZ (ORCPT + 99 others); Sun, 11 Jun 2023 23:08:25 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45648 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233094AbjFLDIR (ORCPT ); Sun, 11 Jun 2023 23:08:17 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 70AB4E5F; Sun, 11 Jun 2023 20:08:14 -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: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=kYsaDINwgGyBkCQoDFNAkvO4v5df2UfOXAdRONE+VsA=; b=cuhGQNGphwJUwp0UMhVoYyu2tM H9F7lOZDO201p3qw3R1q8bQtHyuWu0Ww+eKkYHBp2SnCKuOjfD6kgi6m69yXk4p8uoAisA9qsHuMv NZ+EO4hMOMVyYXlSs63l3oG5dPiJ78trxjJexR5Sfy8VX8lTb2HSP6n5JCMPs1BrMk2t353Ht4z7y ajHHQh6qV3BcUH7Np9z/Hyh/VfcsEyJLb2dEfJQ7sbKUTpS2sgvFs+l5wj+LyR9ojtmX1GZtq1CuV 93PdN6DAikYuO8xL+WRqN403rR53yreatar8GTfojD5i+4Meicwk0sy7/jFlbJgYm2fwuoD1f6VgC oUxdexdQ==; Received: from [2601:1c2:980:9ec0::2764] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1q8Xuf-002P78-1j; Mon, 12 Jun 2023 03:08:13 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Suraj Jitindar Singh , Paolo Bonzini , Sean Christopherson , kvm@vger.kernel.org, Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 1/4] Documentation: KVM: make corrections to halt-polling.rst Date: Sun, 11 Jun 2023 20:08:07 -0700 Message-ID: <20230612030810.23376-2-rdunlap@infradead.org> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230612030810.23376-1-rdunlap@infradead.org> References: <20230612030810.23376-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE,T_SCC_BODY_TEXT_LINE autolearn=ham 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: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1768465202522444138?= X-GMAIL-MSGID: =?utf-8?q?1768465202522444138?= Module parameters are in sysfs, not debugfs, so change that. Remove superfluous "that" following "Note:". Hyphenate "system-wide" values. Hyphenate "trade-off". Don't treat "denial of service" as a verb. Signed-off-by: Randy Dunlap Cc: Suraj Jitindar Singh Cc: Paolo Bonzini Cc: Sean Christopherson Cc: kvm@vger.kernel.org Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org --- Documentation/virt/kvm/halt-polling.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff -- a/Documentation/virt/kvm/halt-polling.rst b/Documentation/virt/kvm/halt-polling.rst --- a/Documentation/virt/kvm/halt-polling.rst +++ b/Documentation/virt/kvm/halt-polling.rst @@ -112,11 +112,11 @@ powerpc kvm-hv case. | | function. | | +-----------------------+---------------------------+-------------------------+ -These module parameters can be set from the debugfs files in: +These module parameters can be set from the sysfs files in: /sys/module/kvm/parameters/ -Note: that these module parameters are system wide values and are not able to +Note: these module parameters are system-wide values and are not able to be tuned on a per vm basis. Any changes to these parameters will be picked up by new and existing vCPUs the @@ -142,12 +142,12 @@ Further Notes global max polling interval (halt_poll_ns) then the host will always poll for the entire block time and thus cpu utilisation will go to 100%. -- Halt polling essentially presents a trade off between power usage and latency and +- Halt polling essentially presents a trade-off between power usage and latency and the module parameters should be used to tune the affinity for this. Idle cpu time is essentially converted to host kernel time with the aim of decreasing latency when entering the guest. - Halt polling will only be conducted by the host when no other tasks are runnable on that cpu, otherwise the polling will cease immediately and schedule will be invoked to - allow that other task to run. Thus this doesn't allow a guest to denial of service the - cpu. + allow that other task to run. Thus this doesn't allow a guest to cause denial of service + of the cpu. From patchwork Mon Jun 12 03:08:08 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 106186 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:994d:0:b0:3d9:f83d:47d9 with SMTP id k13csp2329591vqr; Sun, 11 Jun 2023 20:14:52 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ56YaZ0q54Twt5owgNYy5DsExAxoxQZLx4iZ3KR1Esthv2REhmt/7xgxEo8oEt3ndVlPhxt X-Received: by 2002:a17:907:2d91:b0:97d:cc56:d9bc with SMTP id gt17-20020a1709072d9100b0097dcc56d9bcmr6257998ejc.51.1686539691874; Sun, 11 Jun 2023 20:14:51 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686539691; cv=none; d=google.com; s=arc-20160816; b=YNrRpHcq7TKlb0EBRmdiil550e4NIilh7B2WIYfEp2Mn3up7rv4RNKsMASTiRDcubZ uERPxlpLH22487tmO9eBqEVDRH9wAIyD7riHFRqDfQEcU5TmRGW1uX0kBvB1g1k12rPz wEKt0+emA8f81WVDpPd2mPS12VI39hy6Yu0vDUlZYnKWcTdcw0nGZQ3qbkwe2ycqMi4q Tut7jqhqxoGY9lH9dmf3xULXAfp4hefJC7qa5/Vaic08eK3eBgbUKLtHelYxIXCiyogR 7c01jjVwwpEqyyj64mebHsQ8X6zo/3FOoO/u3mQEb/hFHUSSE5SesBbvS0Lsxiy+p2UH sD1A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=V5veyfA2KKdGawPZUrWbJWEmsvc+vf30GCw8DAtjIos=; b=hUoRm+Aw/O+dW/dmSWUf9ahEPN9bWzAZ2IQZlHdKYP6vdxJj/bFwhYgXOqCakIPmmQ NZ+SoV2CpIHepXWwVDFgK1FNm4G5UhWP5Z2k3s5xjaLi87t9xItwx/vJWXr/kGNsEXqn KrgzZNxzwwYPfHW8hy6M0/HE5iNbtzshQvQca79IKdDvuIYBbeVmCGYP/zLUZlo3Zfy8 35dT1bFlSLrmiXq3d1YXF8GrcxgI7BfbNsSPDfj3x6nbilUHWWPT1pxMrvsYAJ2OIATZ ypWV9SocC0zDZpMtZ0YaIIa5lznSITOcftcECVSu2GgXDmqoYKnKRgiTdmAJJSJ8zfqI +x2g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b="TIJfE/QE"; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id o2-20020a056402038200b005182743e87fsi2850524edv.136.2023.06.11.20.14.28; Sun, 11 Jun 2023 20:14:51 -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=@infradead.org header.s=bombadil.20210309 header.b="TIJfE/QE"; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234262AbjFLDIf (ORCPT + 99 others); Sun, 11 Jun 2023 23:08:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45670 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233318AbjFLDIR (ORCPT ); Sun, 11 Jun 2023 23:08:17 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 710E3E62; Sun, 11 Jun 2023 20:08:14 -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: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=V5veyfA2KKdGawPZUrWbJWEmsvc+vf30GCw8DAtjIos=; b=TIJfE/QEphsK3LIjhTNK9jlRrX 6NYuvunBk9ad9NfKeNCIe6/RAC6TibowZIQY48PJD5w/2wBTDwN4lwlOJvBktSMhd/66Hk9opcrQw z59i0BVg4wz10n5LG8CgzJoMpCoSJZ46xHtOXQG08brjfmJ9YcY6avmP2RuQewetROFQsf8kzuu36 ouySaslQkrvCrEhhPAwch4C2N96DIp0Rnzgce2zIgmz5EOVtCuSJtzYNz+0t7AtW05wc93y/wYTll foJ+dUGzsmMBM95sJ+YBh0niUUJUNun/XYLt2b04ls3Qalu2r8jSXONQYlMVxDuIL6Tx3fGLbm/Q6 L78Qwgqw==; Received: from [2601:1c2:980:9ec0::2764] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1q8Xuf-002P78-34; Mon, 12 Jun 2023 03:08:14 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Sean Christopherson , Paolo Bonzini , kvm@vger.kernel.org, Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 2/4] Documentation: KVM: make corrections to locking.rst Date: Sun, 11 Jun 2023 20:08:08 -0700 Message-ID: <20230612030810.23376-3-rdunlap@infradead.org> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230612030810.23376-1-rdunlap@infradead.org> References: <20230612030810.23376-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE,T_SCC_BODY_TEXT_LINE autolearn=ham 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: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1768465044013434733?= X-GMAIL-MSGID: =?utf-8?q?1768465044013434733?= Correct grammar and punctuation. Use "read-only" for consistency. Signed-off-by: Randy Dunlap Cc: Sean Christopherson Cc: Paolo Bonzini Cc: kvm@vger.kernel.org Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org --- Q: What is spte.HOST_WRITEABLE supposed to be? It is not used anywhere else in the kernel source tree. Documentation/virt/kvm/locking.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff -- a/Documentation/virt/kvm/locking.rst b/Documentation/virt/kvm/locking.rst --- a/Documentation/virt/kvm/locking.rst +++ b/Documentation/virt/kvm/locking.rst @@ -67,7 +67,7 @@ following two cases: 2. Write-Protection: The SPTE is present and the fault is caused by write-protect. That means we just need to change the W bit of the spte. -What we use to avoid all the race is the Host-writable bit and MMU-writable bit +What we use to avoid all the races is the Host-writable bit and MMU-writable bit on the spte: - Host-writable means the gfn is writable in the host kernel page tables and in @@ -130,7 +130,7 @@ to gfn. For indirect sp, we disabled fa A solution for indirect sp could be to pin the gfn, for example via kvm_vcpu_gfn_to_pfn_atomic, before the cmpxchg. After the pinning: -- We have held the refcount of pfn that means the pfn can not be freed and +- We have held the refcount of pfn; that means the pfn can not be freed and be reused for another gfn. - The pfn is writable and therefore it cannot be shared between different gfns by KSM. @@ -186,22 +186,22 @@ writable between reading spte and updati The Dirty bit is lost in this case. In order to avoid this kind of issue, we always treat the spte as "volatile" -if it can be updated out of mmu-lock, see spte_has_volatile_bits(), it means, +if it can be updated out of mmu-lock [see spte_has_volatile_bits()]; it means the spte is always atomically updated in this case. 3) flush tlbs due to spte updated -If the spte is updated from writable to readonly, we should flush all TLBs, +If the spte is updated from writable to read-only, we should flush all TLBs, otherwise rmap_write_protect will find a read-only spte, even though the writable spte might be cached on a CPU's TLB. As mentioned before, the spte can be updated to writable out of mmu-lock on -fast page fault path, in order to easily audit the path, we see if TLBs need -be flushed caused by this reason in mmu_spte_update() since this is a common +fast page fault path. In order to easily audit the path, we see if TLBs needing +to be flushed caused this reason in mmu_spte_update() since this is a common function to update spte (present -> present). Since the spte is "volatile" if it can be updated out of mmu-lock, we always -atomically update the spte, the race caused by fast page fault can be avoided, +atomically update the spte and the race caused by fast page fault can be avoided. See the comments in spte_has_volatile_bits() and mmu_spte_update(). Lockless Access Tracking: @@ -283,9 +283,9 @@ time it will be set using the Dirty trac :Arch: x86 :Protects: wakeup_vcpus_on_cpu :Comment: This is a per-CPU lock and it is used for VT-d posted-interrupts. - When VT-d posted-interrupts is supported and the VM has assigned + When VT-d posted-interrupts are supported and the VM has assigned devices, we put the blocked vCPU on the list blocked_vcpu_on_cpu - protected by blocked_vcpu_on_cpu_lock, when VT-d hardware issues + protected by blocked_vcpu_on_cpu_lock. When VT-d hardware issues wakeup notification event since external interrupts from the assigned devices happens, we will find the vCPU on the list to wakeup. From patchwork Mon Jun 12 03:08:09 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 106193 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:994d:0:b0:3d9:f83d:47d9 with SMTP id k13csp2330248vqr; Sun, 11 Jun 2023 20:16:43 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ5/975+j5sgl95pLMU/PnuxcMeipf4xoWjqxXam3kdRLeMwgkFv9XWCLzJVZy35H1LiFXGb X-Received: by 2002:a17:903:2350:b0:1a1:b3bb:cd5b with SMTP id c16-20020a170903235000b001a1b3bbcd5bmr6559340plh.62.1686539803473; Sun, 11 Jun 2023 20:16:43 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686539803; cv=none; d=google.com; s=arc-20160816; b=RF+rtK0O3GkUIJpFMZ+Hoq8yYTdU3/OMJZilS9lK7eQl5FgJxQf40oaXI5Ew1khi3c xGMsUg4lgPsQN7LdhAT/R9WhNVFgzzGGWRzbQLU8L4Tb7QN+ctftRyTpI9wh//9/+ErV E9CX4or5PiJ/8bA1Pa2uNBCmLOwfUjtJkQU6+pW1fW+PbTgaXUmUbE6zjjQp3BvGXsrZ 6gLwUak8Rk02Ot+1BDwwc5KKaPhF/BFkayKDoMNfI0sD9rh7Q6L4TfW06wqSj00TUdP0 RlqPU6RQuQf1km0zKlL5dEDvFxfJG/XJj2bG0qotQcJdniVocRUPxNPzjJJMbX4Uer+2 3hyQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=FhgBJ6qPJJSAgmnpesfTh4Obq9q8c5qykQgTTJwa4a0=; b=b2Jr35P7G7oaUkYO+axOPo0IrN9RUuzfitJXdxcx5J362UH/CBVKtur4FIq/yl6yWe cU5tHPGZ3xBac1e1eYgG+Jh1RmyWoktn2XZBnxU0h66zbJPvb3e1HWPgXiwY2wLQO5YJ Z+HTzA+FqMJPIYK+Ss3vAUTzR4FoRpW92EYduqK6Kq1aJWKMN7pH/GTXcN3OrF5C8MmF M0HDnoP8h2vs/mfISH+2dg0I5JzjHt0RxsB6R+SaGts02BSJhu0FMnFOTu3yAQotDRgY ORZPv7fhmj/qx0AVBenrpnJBQbyTQTCokg8io9IlLM+rLWKe7Dz/JWFm4sOkZQ4938+d EcSg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=RLTfSAUx; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id e6-20020a170902ef4600b001b049396679si3394167plx.556.2023.06.11.20.16.31; Sun, 11 Jun 2023 20:16:43 -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=@infradead.org header.s=bombadil.20210309 header.b=RLTfSAUx; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234377AbjFLDIp (ORCPT + 99 others); Sun, 11 Jun 2023 23:08:45 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45672 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233497AbjFLDIR (ORCPT ); Sun, 11 Jun 2023 23:08:17 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B90B3E63; Sun, 11 Jun 2023 20:08:14 -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: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=FhgBJ6qPJJSAgmnpesfTh4Obq9q8c5qykQgTTJwa4a0=; b=RLTfSAUxEScxwkSLdojIsTYxp9 zTd8cESj3uhLnFAv2s8sSZZln6PNf43BinTkjGB8r+KeQCy8lSCy3DxgOkEIS+IN7FF6alJPVqlGM 5fWeR1kP0QlrNj6oiIMrlGe3krvNS1NtRnKtaLp0daOg0F429rTk87bftA/fraJhS3oELVl7heOEa t5HD0WdCZK5gK+aP3zgk8XLuQEZ3g0/ffoyUppr5iOmkiF+4YF11IwNAqpNBME4ynvqU5iSSSHDS6 PnRzeSccYxxW6F8ViXsPKKVWHQMKybjGwo/FJK70eLaE/mQpxa0vYXqqMENkO71slLppzQrGtU1vL C71/UKfQ==; Received: from [2601:1c2:980:9ec0::2764] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1q8Xug-002P78-1C; Mon, 12 Jun 2023 03:08:14 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Paolo Bonzini , Sean Christopherson , kvm@vger.kernel.org, Alexander Graf , Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 3/4] Documentation: KVM: make corrections to ppc-pv.rst Date: Sun, 11 Jun 2023 20:08:09 -0700 Message-ID: <20230612030810.23376-4-rdunlap@infradead.org> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230612030810.23376-1-rdunlap@infradead.org> References: <20230612030810.23376-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE,T_SCC_BODY_TEXT_LINE autolearn=ham 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: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1768465160825142799?= X-GMAIL-MSGID: =?utf-8?q?1768465160825142799?= Correct the path of a header file. Change "guest to ... guest" to "guest to ... host" in one place. Hyphenate "32-bit" systems. Add a comma at one parenthetical phrase. Signed-off-by: Randy Dunlap Cc: Paolo Bonzini Cc: Sean Christopherson Cc: kvm@vger.kernel.org Cc: Alexander Graf Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org --- Documentation/virt/kvm/ppc-pv.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff -- a/Documentation/virt/kvm/ppc-pv.rst b/Documentation/virt/kvm/ppc-pv.rst --- a/Documentation/virt/kvm/ppc-pv.rst +++ b/Documentation/virt/kvm/ppc-pv.rst @@ -89,7 +89,7 @@ also define a new hypercall feature to i registers. Only if the host supports the additional features, make use of them. The magic page layout is described by struct kvm_vcpu_arch_shared -in arch/powerpc/include/asm/kvm_para.h. +in arch/powerpc/include/uapi/asm/kvm_para.h. Magic page features =================== @@ -112,7 +112,7 @@ Magic page flags ================ In addition to features that indicate whether a host is capable of a particular -feature we also have a channel for a guest to tell the guest whether it's capable +feature we also have a channel for a guest to tell the host whether it's capable of something. This is what we call "flags". Flags are passed to the host in the low 12 bits of the Effective Address. @@ -139,7 +139,7 @@ Patched instructions ==================== The "ld" and "std" instructions are transformed to "lwz" and "stw" instructions -respectively on 32 bit systems with an added offset of 4 to accommodate for big +respectively on 32-bit systems with an added offset of 4 to accommodate for big endianness. The following is a list of mapping the Linux kernel performs when running as @@ -210,7 +210,7 @@ available on all targets. 2) PAPR hypercalls PAPR hypercalls are needed to run server PowerPC PAPR guests (-M pseries in QEMU). -These are the same hypercalls that pHyp, the POWER hypervisor implements. Some of +These are the same hypercalls that pHyp, the POWER hypervisor, implements. Some of them are handled in the kernel, some are handled in user space. This is only available on book3s_64. From patchwork Mon Jun 12 03:08:10 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 106202 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:994d:0:b0:3d9:f83d:47d9 with SMTP id k13csp2335649vqr; Sun, 11 Jun 2023 20:35:38 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ54v5CWsI7CWz7kWco5jREOJAvz0W8Z31iWaj8WHzhjj8aZCp7wTcVp5ric2zc3wmH650Y6 X-Received: by 2002:a05:6870:5383:b0:19a:7f42:ee27 with SMTP id h3-20020a056870538300b0019a7f42ee27mr4596021oan.34.1686540938022; Sun, 11 Jun 2023 20:35:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686540937; cv=none; d=google.com; s=arc-20160816; b=CMPOqOu7ZwqdPjfBq3AHTQ2Wss7yp9Z57RiaAnB1LVzuMkgNUKvViRORRrMndatWEB 7yJ+QiTRymD6VVUU7EX0KmBsptF1Y9RnJ+7wQEbQ6Oawibilr2vEHV+CjKXkCuPWFTlr M8xDJVBPhkPE8+/dwfgDP4ZM4hrvIBKTlyX42kjTlc02XZVzjjGrjnxq2zZM/OxSbcg+ j6WI8MVhetdDFFCTT4e0ZyftELb26FbADm30UtuF6eVHpfkH95TdQ9NgKqPz7Rg7cjmA UQSj4+3q82KmpxhhBbq5bhP7fertP5tc+AW1a+K9+EIrh0CBoZJP4NuCOsMZhm4TfAyP B3Ug== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=fOE6Ra8njD0psF8yweu+6OMqM09Aiea1FRmZ+yo9rtc=; b=N3+q8m5nm9Cgfo46ZqzHE/VQcWtx7BomZy4JclS93By26j+c9zdOsnbEHmYLb57Alb BmmwesdAHiTyoSDUrkwUciHTvRhsWg6KnNpRFZcQvqyNzw8QXWOmfe5WU6473U1bqGjG j7GoG9PNBScI4ckaQJZOsbPdssU8peC2wmF76mopkkFyg3v7JikV7G3okecTzEanTwOI vRaCbCz2flV07TcgLsedStxjXeDkWFw2r4F9PM46+cz3W5BIsRNmFcztE1xbcFsB9YcP p09uiZJH9e4zziBVdGSqWO6F1eXIlWE0g2sVh+ok5AxOkz2CQ7RaXBzav2x8voNPtNNu hxvA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=LZsIqmVC; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id l12-20020a170903120c00b001ae4a01a7e0si6659743plh.236.2023.06.11.20.35.26; Sun, 11 Jun 2023 20:35: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=@infradead.org header.s=bombadil.20210309 header.b=LZsIqmVC; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234414AbjFLDIt (ORCPT + 99 others); Sun, 11 Jun 2023 23:08:49 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45682 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233567AbjFLDIR (ORCPT ); Sun, 11 Jun 2023 23:08:17 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3C9C9E68; Sun, 11 Jun 2023 20:08:15 -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: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=fOE6Ra8njD0psF8yweu+6OMqM09Aiea1FRmZ+yo9rtc=; b=LZsIqmVCqBomAQFE39iASpfFOt CM38Ky0Ly+ZCS3U2b0+G7kY6yDed/sgKixwmb66WOEZ/mtIUIuteGq1QXzuvUPi6ocyhXWwd1MjKn p+3o6x4wA7zkGWFjGGqZ/b66SZBJUiiWme3MPXPsuop5bl9VqA3N5jfnFRJSaB8PQi0DhIWUq7uak KYL6owcb0nwL5wkTT10qvsYRKyoknOs+huuLmrPdOmnjMAquvXrXMcdRBIgH0jCZS5P4MJuaP/Vr6 NFhwJQYO9IinRb2Id/Yi7cgwDjMs1fIHKAFwClHuPUDaxTPrkFfjTGJnzFGKbd7jG7PvaxDS75lcC 9qHE2iMA==; Received: from [2601:1c2:980:9ec0::2764] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1q8Xug-002P78-2c; Mon, 12 Jun 2023 03:08:14 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Paolo Bonzini , Sean Christopherson , Andrew Jones , Christoffer Dall , kvm@vger.kernel.org, Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 4/4] Documentation: KVM: make corrections to vcpu-requests.rst Date: Sun, 11 Jun 2023 20:08:10 -0700 Message-ID: <20230612030810.23376-5-rdunlap@infradead.org> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20230612030810.23376-1-rdunlap@infradead.org> References: <20230612030810.23376-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE,T_SCC_BODY_TEXT_LINE autolearn=ham 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: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1768466350420781902?= X-GMAIL-MSGID: =?utf-8?q?1768466350420781902?= Make corrections to punctuation and grammar. Signed-off-by: Randy Dunlap Cc: Paolo Bonzini Cc: Sean Christopherson Cc: Andrew Jones Cc: Christoffer Dall Cc: kvm@vger.kernel.org Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org --- Documentation/virt/kvm/vcpu-requests.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff -- a/Documentation/virt/kvm/vcpu-requests.rst b/Documentation/virt/kvm/vcpu-requests.rst --- a/Documentation/virt/kvm/vcpu-requests.rst +++ b/Documentation/virt/kvm/vcpu-requests.rst @@ -101,7 +101,7 @@ also be used, e.g. :: However, VCPU request users should refrain from doing so, as it would break the abstraction. The first 8 bits are reserved for architecture -independent requests, all additional bits are available for architecture +independent requests; all additional bits are available for architecture dependent requests. Architecture Independent Requests @@ -151,8 +151,8 @@ KVM_REQUEST_NO_WAKEUP This flag is applied to requests that only need immediate attention from VCPUs running in guest mode. That is, sleeping VCPUs do not need - to be awaken for these requests. Sleeping VCPUs will handle the - requests when they are awaken later for some other reason. + to be awakened for these requests. Sleeping VCPUs will handle the + requests when they are awakened later for some other reason. KVM_REQUEST_WAIT