[PATCH] Documentation: KVM: Fix unexpected unindent warnings

[PATCH] Documentation: KVM: Fix unexpected unindent warnings

[Binbin Wu]

Add proper indentations to bullet list items to resolve the warning:
"Bullet list ends without a blank line; unexpected unindent."

Fixes: cf207eac06f6 ("KVM: TDX: Handle TDG.VP.VMCALL<GetQuote>")
Fixes: 25e8b1dd4883 ("KVM: TDX: Exit to userspace for GetTdVmCallInfo")
Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
Closes:https://lore.kernel.org/kvm/20250623162110.6e2f4241@canb.auug.org.au/
Signed-off-by: Binbin Wu <binbin.wu@linux.intel.com>
---
The fix for the same issue in Linux Next due to the patch
"KVM: TDX: Exit to userspace for SetupEventNotifyInterrupt" is not included.
---
 Documentation/virt/kvm/api.rst | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/Documentation/virt/kvm/api.rst b/Documentation/virt/kvm/api.rst
index 9abf93ee5f65..a7dbe08dc376 100644
--- a/Documentation/virt/kvm/api.rst
+++ b/Documentation/virt/kvm/api.rst
@@ -7210,21 +7210,21 @@ number from register R11.  The remaining field of the union provide the
 inputs and outputs of the TDVMCALL.  Currently the following values of
 ``nr`` are defined:
 
-* ``TDVMCALL_GET_QUOTE``: the guest has requested to generate a TD-Quote
-signed by a service hosting TD-Quoting Enclave operating on the host.
-Parameters and return value are in the ``get_quote`` field of the union.
-The ``gpa`` field and ``size`` specify the guest physical address
-(without the shared bit set) and the size of a shared-memory buffer, in
-which the TDX guest passes a TD Report.  The ``ret`` field represents
-the return value of the GetQuote request.  When the request has been
-queued successfully, the TDX guest can poll the status field in the
-shared-memory area to check whether the Quote generation is completed or
-not. When completed, the generated Quote is returned via the same buffer.
-
-* ``TDVMCALL_GET_TD_VM_CALL_INFO``: the guest has requested the support
-status of TDVMCALLs.  The output values for the given leaf should be
-placed in fields from ``r11`` to ``r14`` of the ``get_tdvmcall_info``
-field of the union.
+ * ``TDVMCALL_GET_QUOTE``: the guest has requested to generate a TD-Quote
+   signed by a service hosting TD-Quoting Enclave operating on the host.
+   Parameters and return value are in the ``get_quote`` field of the union.
+   The ``gpa`` field and ``size`` specify the guest physical address
+   (without the shared bit set) and the size of a shared-memory buffer, in
+   which the TDX guest passes a TD Report.  The ``ret`` field represents
+   the return value of the GetQuote request.  When the request has been
+   queued successfully, the TDX guest can poll the status field in the
+   shared-memory area to check whether the Quote generation is completed or
+   not. When completed, the generated Quote is returned via the same buffer.
+
+ * ``TDVMCALL_GET_TD_VM_CALL_INFO``: the guest has requested the support
+   status of TDVMCALLs.  The output values for the given leaf should be
+   placed in fields from ``r11`` to ``r14`` of the ``get_tdvmcall_info``
+   field of the union.
 
 KVM may add support for more values in the future that may cause a userspace
 exit, even without calls to ``KVM_ENABLE_CAP`` or similar.  In this case,

base-commit: 86731a2a651e58953fc949573895f2fa6d456841
-- 
2.46.0

Re: [PATCH] Documentation: KVM: Fix unexpected unindent warnings

[Bagas Sanjaya]

[-- Attachment #1: Type: text/plain, Size: 2804 bytes --]

On Wed, Jun 25, 2025 at 09:48:29AM +0800, Binbin Wu wrote:
> diff --git a/Documentation/virt/kvm/api.rst b/Documentation/virt/kvm/api.rst
> index 9abf93ee5f65..a7dbe08dc376 100644
> --- a/Documentation/virt/kvm/api.rst
> +++ b/Documentation/virt/kvm/api.rst
> @@ -7210,21 +7210,21 @@ number from register R11.  The remaining field of the union provide the
>  inputs and outputs of the TDVMCALL.  Currently the following values of
>  ``nr`` are defined:
>  
> -* ``TDVMCALL_GET_QUOTE``: the guest has requested to generate a TD-Quote
> -signed by a service hosting TD-Quoting Enclave operating on the host.
> -Parameters and return value are in the ``get_quote`` field of the union.
> -The ``gpa`` field and ``size`` specify the guest physical address
> -(without the shared bit set) and the size of a shared-memory buffer, in
> -which the TDX guest passes a TD Report.  The ``ret`` field represents
> -the return value of the GetQuote request.  When the request has been
> -queued successfully, the TDX guest can poll the status field in the
> -shared-memory area to check whether the Quote generation is completed or
> -not. When completed, the generated Quote is returned via the same buffer.
> -
> -* ``TDVMCALL_GET_TD_VM_CALL_INFO``: the guest has requested the support
> -status of TDVMCALLs.  The output values for the given leaf should be
> -placed in fields from ``r11`` to ``r14`` of the ``get_tdvmcall_info``
> -field of the union.
> + * ``TDVMCALL_GET_QUOTE``: the guest has requested to generate a TD-Quote
> +   signed by a service hosting TD-Quoting Enclave operating on the host.
> +   Parameters and return value are in the ``get_quote`` field of the union.
> +   The ``gpa`` field and ``size`` specify the guest physical address
> +   (without the shared bit set) and the size of a shared-memory buffer, in
> +   which the TDX guest passes a TD Report.  The ``ret`` field represents
> +   the return value of the GetQuote request.  When the request has been
> +   queued successfully, the TDX guest can poll the status field in the
> +   shared-memory area to check whether the Quote generation is completed or
> +   not. When completed, the generated Quote is returned via the same buffer.
> +
> + * ``TDVMCALL_GET_TD_VM_CALL_INFO``: the guest has requested the support
> +   status of TDVMCALLs.  The output values for the given leaf should be
> +   placed in fields from ``r11`` to ``r14`` of the ``get_tdvmcall_info``
> +   field of the union.
>  
>  KVM may add support for more values in the future that may cause a userspace
>  exit, even without calls to ``KVM_ENABLE_CAP`` or similar.  In this case,
> 

LGTM, thanks!

Reviewed-by: Bagas Sanjaya <bagasdotme@gmail.com>

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

Re: [PATCH] Documentation: KVM: Fix unexpected unindent warnings

[Sean Christopherson]

On Wed, 25 Jun 2025 09:48:29 +0800, Binbin Wu wrote:
> Add proper indentations to bullet list items to resolve the warning:
> "Bullet list ends without a blank line; unexpected unindent."
> 
> Closes:https://lore.kernel.org/kvm/20250623162110.6e2f4241@canb.auug.org.au/

Applied to kvm-x86 fixes, thanks!

[1/1] Documentation: KVM: Fix unexpected unindent warnings
      https://github.com/kvm-x86/linux/commit/0c84b534047d

--
https://github.com/kvm-x86/kvm-unit-tests/tree/next