Re: [RFC PATCH v2 3/6] kvm: arm64: Add support for util_hint service

From: Bagas Sanjaya
Date: Fri Mar 31 2023 - 23:22:15 EST


On Thu, Mar 30, 2023 at 06:43:47PM -0700, David Dai wrote:
> +ARM_SMCCC_HYP_KVM_UTIL_HINT_FUNC_ID
> + ============== ========= ============================
> + Function ID: (uint32) 0x86000041
> + Arguments: (uint32) util value(0-1024) where 1024 represents
> + the highest performance point normalized
> + across all CPUs
> + Return values: (int32) NOT_SUPPORTED(-1) on error.
> + Endianness: Must be the same endianness
> + as the host.
> + ============== ======== ============================

Sphinx reports htmldocs warning:
/home/bagas/repo/linux-kernel/Documentation/virt/kvm/arm/util_hint.rst:21: WARNING: Malformed table.
Column span alignment problem in table line 8.

============== ========= ============================
Function ID: (uint32) 0x86000041
Arguments: (uint32) util value(0-1024) where 1024 represents
the highest performance point normalized
across all CPUs
Return values: (int32) NOT_SUPPORTED(-1) on error.
Endianness: Must be the same endianness
as the host.
============== ======== ============================

I have to fix the table:

---- >8 ----
diff --git a/Documentation/virt/kvm/arm/util_hint.rst b/Documentation/virt/kvm/arm/util_hint.rst
index 262d142d62d91e..99e5bf99446d90 100644
--- a/Documentation/virt/kvm/arm/util_hint.rst
+++ b/Documentation/virt/kvm/arm/util_hint.rst
@@ -11,7 +11,8 @@ to the host.
This hypercall using the SMC32/HVC32 calling convention:

ARM_SMCCC_HYP_KVM_UTIL_HINT_FUNC_ID
- ============== ========= ============================
+
+ ============== ========= ========================================
Function ID: (uint32) 0x86000041
Arguments: (uint32) util value(0-1024) where 1024 represents
the highest performance point normalized
@@ -19,4 +20,4 @@ ARM_SMCCC_HYP_KVM_UTIL_HINT_FUNC_ID
Return values: (int32) NOT_SUPPORTED(-1) on error.
Endianness: Must be the same endianness
as the host.
- ============== ======== ============================
+ ============== ========= ========================================

Thanks.

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