[PATCH v2 0/4] Add new headers for Hyper-V Dom0

[PATCH v2 0/4] Add new headers for Hyper-V Dom0

[Nuno Das Neves]

To support Hyper-V Dom0 (aka Linux as root partition), many new
definitions are required.

The plan going forward is to directly import definitions from
Hyper-V code without waiting for them to land in the TLFS document.
This is a quicker and more maintainable way to import definitions,
and is a step toward the eventual goal of exporting headers directly
from Hyper-V for use in Linux.

This patch series introduces new headers (hvhdk.h, hvgdk.h, etc,
see patch #3) derived directly from Hyper-V code. hyperv-tlfs.h is
replaced with hvhdk.h (which includes the other new headers)
everywhere.

No functional change is expected.

Summary:
Patch 1-2: Minor cleanup patches
Patch 3: Add the new headers (hvhdk.h, etc..) in include/hyperv/
Patch 4: Switch to the new headers

Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
---
Changelog:
v2:
- Rework the series to simply use the new headers everywhere
  instead of fiddling around to keep hyperv-tlfs.h used in some
  places, suggested by Michael Kelley and Easwar Hariharan
- Fix compilation errors with some configs by adding missing
  definitions and changing some names, thanks to Simon Horman for
  catching those
- Add additional definitions to the new headers to support them now
  replacing hyperv-tlfs.h everywhere
- Add additional context in the commit messages for patches #3 and #4
- In patch #2, don't remove indirect includes. Only remove includes
  which truly aren't used, suggested by Michael Kelley

---
Nuno Das Neves (4):
  hyperv: Move hv_connection_id to hyperv-tlfs.h
  hyperv: Clean up unnecessary #includes
  hyperv: Add new Hyper-V headers in include/hyperv
  hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h

 arch/arm64/hyperv/hv_core.c        |    3 +-
 arch/arm64/hyperv/mshyperv.c       |    4 +-
 arch/arm64/include/asm/mshyperv.h  |    2 +-
 arch/x86/hyperv/hv_apic.c          |    1 -
 arch/x86/hyperv/hv_init.c          |   21 +-
 arch/x86/hyperv/hv_proc.c          |    3 +-
 arch/x86/hyperv/ivm.c              |    1 -
 arch/x86/hyperv/mmu.c              |    1 -
 arch/x86/hyperv/nested.c           |    2 +-
 arch/x86/include/asm/kvm_host.h    |    3 +-
 arch/x86/include/asm/mshyperv.h    |    3 +-
 arch/x86/include/asm/svm.h         |    2 +-
 arch/x86/kernel/cpu/mshyperv.c     |    2 +-
 arch/x86/kvm/vmx/hyperv_evmcs.h    |    2 +-
 arch/x86/kvm/vmx/vmx_onhyperv.h    |    2 +-
 arch/x86/mm/pat/set_memory.c       |    2 -
 drivers/clocksource/hyperv_timer.c |    2 +-
 drivers/hv/hv_balloon.c            |    4 +-
 drivers/hv/hv_common.c             |    2 +-
 drivers/hv/hv_kvp.c                |    2 +-
 drivers/hv/hv_snapshot.c           |    2 +-
 drivers/hv/hyperv_vmbus.h          |    2 +-
 include/asm-generic/hyperv-tlfs.h  |    9 +
 include/asm-generic/mshyperv.h     |    2 +-
 include/clocksource/hyperv_timer.h |    2 +-
 include/hyperv/hvgdk.h             |  303 +++++++
 include/hyperv/hvgdk_ext.h         |   46 +
 include/hyperv/hvgdk_mini.h        | 1295 ++++++++++++++++++++++++++++
 include/hyperv/hvhdk.h             |  733 ++++++++++++++++
 include/hyperv/hvhdk_mini.h        |  310 +++++++
 include/linux/hyperv.h             |   11 +-
 net/vmw_vsock/hyperv_transport.c   |    2 +-
 32 files changed, 2729 insertions(+), 52 deletions(-)
 create mode 100644 include/hyperv/hvgdk.h
 create mode 100644 include/hyperv/hvgdk_ext.h
 create mode 100644 include/hyperv/hvgdk_mini.h
 create mode 100644 include/hyperv/hvhdk.h
 create mode 100644 include/hyperv/hvhdk_mini.h

-- 
2.34.1

[PATCH v2 1/4] hyperv: Move hv_connection_id to hyperv-tlfs.h

[Nuno Das Neves]

This definition is in the wrong file; it is part of the TLFS doc.

Acked-by: Wei Liu <wei.liu@kernel.org>
Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
---
 include/asm-generic/hyperv-tlfs.h | 9 +++++++++
 include/linux/hyperv.h            | 9 ---------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/include/asm-generic/hyperv-tlfs.h b/include/asm-generic/hyperv-tlfs.h
index 814207e7c37f..52274c9aefef 100644
--- a/include/asm-generic/hyperv-tlfs.h
+++ b/include/asm-generic/hyperv-tlfs.h
@@ -871,4 +871,13 @@ struct hv_mmio_write_input {
 	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
 } __packed;
 
+/* Define connection identifier type. */
+union hv_connection_id {
+	u32 asu32;
+	struct {
+		u32 id:24;
+		u32 reserved:8;
+	} u;
+};
+
 #endif
diff --git a/include/linux/hyperv.h b/include/linux/hyperv.h
index 22c22fb91042..d0893ec488ae 100644
--- a/include/linux/hyperv.h
+++ b/include/linux/hyperv.h
@@ -768,15 +768,6 @@ struct vmbus_close_msg {
 	struct vmbus_channel_close_channel msg;
 };
 
-/* Define connection identifier type. */
-union hv_connection_id {
-	u32 asu32;
-	struct {
-		u32 id:24;
-		u32 reserved:8;
-	} u;
-};
-
 enum vmbus_device_type {
 	HV_IDE = 0,
 	HV_SCSI,
-- 
2.34.1

Re: [PATCH v2 1/4] hyperv: Move hv_connection_id to hyperv-tlfs.h

[Easwar Hariharan]

On 11/7/2024 2:32 PM, Nuno Das Neves wrote:
> This definition is in the wrong file; it is part of the TLFS doc.
> 
> Acked-by: Wei Liu <wei.liu@kernel.org>
> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> ---
>  include/asm-generic/hyperv-tlfs.h | 9 +++++++++
>  include/linux/hyperv.h            | 9 ---------
>  2 files changed, 9 insertions(+), 9 deletions(-)
> 

Reviewed-by: Easwar Hariharan <eahariha@linux.microsoft.com>

RE: [PATCH v2 1/4] hyperv: Move hv_connection_id to hyperv-tlfs.h

[Michael Kelley]

From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
> 
> This definition is in the wrong file; it is part of the TLFS doc.
> 
> Acked-by: Wei Liu <wei.liu@kernel.org>
> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> ---
>  include/asm-generic/hyperv-tlfs.h | 9 +++++++++
>  include/linux/hyperv.h            | 9 ---------
>  2 files changed, 9 insertions(+), 9 deletions(-)
> 
> diff --git a/include/asm-generic/hyperv-tlfs.h b/include/asm-generic/hyperv-tlfs.h
> index 814207e7c37f..52274c9aefef 100644
> --- a/include/asm-generic/hyperv-tlfs.h
> +++ b/include/asm-generic/hyperv-tlfs.h
> @@ -871,4 +871,13 @@ struct hv_mmio_write_input {
>  	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
>  } __packed;
> 
> +/* Define connection identifier type. */
> +union hv_connection_id {
> +	u32 asu32;
> +	struct {
> +		u32 id:24;
> +		u32 reserved:8;
> +	} u;
> +};
> +
>  #endif
> diff --git a/include/linux/hyperv.h b/include/linux/hyperv.h
> index 22c22fb91042..d0893ec488ae 100644
> --- a/include/linux/hyperv.h
> +++ b/include/linux/hyperv.h
> @@ -768,15 +768,6 @@ struct vmbus_close_msg {
>  	struct vmbus_channel_close_channel msg;
>  };
> 
> -/* Define connection identifier type. */
> -union hv_connection_id {
> -	u32 asu32;
> -	struct {
> -		u32 id:24;
> -		u32 reserved:8;
> -	} u;
> -};
> -
>  enum vmbus_device_type {
>  	HV_IDE = 0,
>  	HV_SCSI,
> --
> 2.34.1

Reviewed-by: Michael Kelley <mhklinux@outlook.com>

[PATCH v2 2/4] hyperv: Clean up unnecessary #includes

[Nuno Das Neves]

Remove includes of linux/hyperv.h, mshyperv.h, and hyperv-tlfs.h where
they are not used.

Acked-by: Wei Liu <wei.liu@kernel.org>
Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
---
 arch/arm64/hyperv/hv_core.c     | 1 -
 arch/x86/hyperv/hv_apic.c       | 1 -
 arch/x86/hyperv/hv_init.c       | 1 -
 arch/x86/hyperv/hv_proc.c       | 1 -
 arch/x86/hyperv/ivm.c           | 1 -
 arch/x86/hyperv/mmu.c           | 1 -
 arch/x86/include/asm/kvm_host.h | 1 -
 arch/x86/include/asm/mshyperv.h | 1 -
 arch/x86/mm/pat/set_memory.c    | 2 --
 9 files changed, 10 deletions(-)

diff --git a/arch/arm64/hyperv/hv_core.c b/arch/arm64/hyperv/hv_core.c
index f1ebc025e1df..7a746a5a6b42 100644
--- a/arch/arm64/hyperv/hv_core.c
+++ b/arch/arm64/hyperv/hv_core.c
@@ -11,7 +11,6 @@
 #include <linux/types.h>
 #include <linux/export.h>
 #include <linux/mm.h>
-#include <linux/hyperv.h>
 #include <linux/arm-smccc.h>
 #include <linux/module.h>
 #include <asm-generic/bug.h>
diff --git a/arch/x86/hyperv/hv_apic.c b/arch/x86/hyperv/hv_apic.c
index 0569f579338b..f022d5f64fb6 100644
--- a/arch/x86/hyperv/hv_apic.c
+++ b/arch/x86/hyperv/hv_apic.c
@@ -23,7 +23,6 @@
 #include <linux/vmalloc.h>
 #include <linux/mm.h>
 #include <linux/clockchips.h>
-#include <linux/hyperv.h>
 #include <linux/slab.h>
 #include <linux/cpuhotplug.h>
 #include <asm/hypervisor.h>
diff --git a/arch/x86/hyperv/hv_init.c b/arch/x86/hyperv/hv_init.c
index 17a71e92a343..1a6354b3e582 100644
--- a/arch/x86/hyperv/hv_init.c
+++ b/arch/x86/hyperv/hv_init.c
@@ -27,7 +27,6 @@
 #include <linux/version.h>
 #include <linux/vmalloc.h>
 #include <linux/mm.h>
-#include <linux/hyperv.h>
 #include <linux/slab.h>
 #include <linux/kernel.h>
 #include <linux/cpuhotplug.h>
diff --git a/arch/x86/hyperv/hv_proc.c b/arch/x86/hyperv/hv_proc.c
index 3fa1f2ee7b0d..b74c06c04ff1 100644
--- a/arch/x86/hyperv/hv_proc.c
+++ b/arch/x86/hyperv/hv_proc.c
@@ -3,7 +3,6 @@
 #include <linux/vmalloc.h>
 #include <linux/mm.h>
 #include <linux/clockchips.h>
-#include <linux/hyperv.h>
 #include <linux/slab.h>
 #include <linux/cpuhotplug.h>
 #include <linux/minmax.h>
diff --git a/arch/x86/hyperv/ivm.c b/arch/x86/hyperv/ivm.c
index 60fc3ed72830..b56d70612734 100644
--- a/arch/x86/hyperv/ivm.c
+++ b/arch/x86/hyperv/ivm.c
@@ -7,7 +7,6 @@
  */
 
 #include <linux/bitfield.h>
-#include <linux/hyperv.h>
 #include <linux/types.h>
 #include <linux/slab.h>
 #include <asm/svm.h>
diff --git a/arch/x86/hyperv/mmu.c b/arch/x86/hyperv/mmu.c
index 1cc113200ff5..cc8c3bd0e7c2 100644
--- a/arch/x86/hyperv/mmu.c
+++ b/arch/x86/hyperv/mmu.c
@@ -1,6 +1,5 @@
 #define pr_fmt(fmt)  "Hyper-V: " fmt
 
-#include <linux/hyperv.h>
 #include <linux/log2.h>
 #include <linux/slab.h>
 #include <linux/types.h>
diff --git a/arch/x86/include/asm/kvm_host.h b/arch/x86/include/asm/kvm_host.h
index 4a68cb3eba78..3627eab994a3 100644
--- a/arch/x86/include/asm/kvm_host.h
+++ b/arch/x86/include/asm/kvm_host.h
@@ -24,7 +24,6 @@
 #include <linux/pvclock_gtod.h>
 #include <linux/clocksource.h>
 #include <linux/irqbypass.h>
-#include <linux/hyperv.h>
 #include <linux/kfifo.h>
 
 #include <asm/apic.h>
diff --git a/arch/x86/include/asm/mshyperv.h b/arch/x86/include/asm/mshyperv.h
index 390c4d13956d..47ca48062547 100644
--- a/arch/x86/include/asm/mshyperv.h
+++ b/arch/x86/include/asm/mshyperv.h
@@ -9,7 +9,6 @@
 #include <asm/hyperv-tlfs.h>
 #include <asm/nospec-branch.h>
 #include <asm/paravirt.h>
-#include <asm/mshyperv.h>
 
 /*
  * Hyper-V always provides a single IO-APIC at this MMIO address.
diff --git a/arch/x86/mm/pat/set_memory.c b/arch/x86/mm/pat/set_memory.c
index 44f7b2ea6a07..85fa0d4509f0 100644
--- a/arch/x86/mm/pat/set_memory.c
+++ b/arch/x86/mm/pat/set_memory.c
@@ -32,8 +32,6 @@
 #include <asm/pgalloc.h>
 #include <asm/proto.h>
 #include <asm/memtype.h>
-#include <asm/hyperv-tlfs.h>
-#include <asm/mshyperv.h>
 
 #include "../mm_internal.h"
 
-- 
2.34.1

Re: [PATCH v2 2/4] hyperv: Clean up unnecessary #includes

[Easwar Hariharan]

On 11/7/2024 2:32 PM, Nuno Das Neves wrote:
> Remove includes of linux/hyperv.h, mshyperv.h, and hyperv-tlfs.h where
> they are not used.
> 
> Acked-by: Wei Liu <wei.liu@kernel.org>
> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> ---
>  arch/arm64/hyperv/hv_core.c     | 1 -
>  arch/x86/hyperv/hv_apic.c       | 1 -
>  arch/x86/hyperv/hv_init.c       | 1 -
>  arch/x86/hyperv/hv_proc.c       | 1 -
>  arch/x86/hyperv/ivm.c           | 1 -
>  arch/x86/hyperv/mmu.c           | 1 -
>  arch/x86/include/asm/kvm_host.h | 1 -
>  arch/x86/include/asm/mshyperv.h | 1 -
>  arch/x86/mm/pat/set_memory.c    | 2 --
>  9 files changed, 10 deletions(-)
> 

Reviewed-by: Easwar Hariharan <eahariha@linux.microsoft.com>

RE: [PATCH v2 2/4] hyperv: Clean up unnecessary #includes

[Michael Kelley]

From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
> 
> Remove includes of linux/hyperv.h, mshyperv.h, and hyperv-tlfs.h where
> they are not used.
> 
> Acked-by: Wei Liu <wei.liu@kernel.org>
> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> ---
>  arch/arm64/hyperv/hv_core.c     | 1 -
>  arch/x86/hyperv/hv_apic.c       | 1 -
>  arch/x86/hyperv/hv_init.c       | 1 -
>  arch/x86/hyperv/hv_proc.c       | 1 -
>  arch/x86/hyperv/ivm.c           | 1 -
>  arch/x86/hyperv/mmu.c           | 1 -
>  arch/x86/include/asm/kvm_host.h | 1 -
>  arch/x86/include/asm/mshyperv.h | 1 -
>  arch/x86/mm/pat/set_memory.c    | 2 --
>  9 files changed, 10 deletions(-)
> 
> diff --git a/arch/arm64/hyperv/hv_core.c b/arch/arm64/hyperv/hv_core.c
> index f1ebc025e1df..7a746a5a6b42 100644
> --- a/arch/arm64/hyperv/hv_core.c
> +++ b/arch/arm64/hyperv/hv_core.c
> @@ -11,7 +11,6 @@
>  #include <linux/types.h>
>  #include <linux/export.h>
>  #include <linux/mm.h>
> -#include <linux/hyperv.h>
>  #include <linux/arm-smccc.h>
>  #include <linux/module.h>
>  #include <asm-generic/bug.h>
> diff --git a/arch/x86/hyperv/hv_apic.c b/arch/x86/hyperv/hv_apic.c
> index 0569f579338b..f022d5f64fb6 100644
> --- a/arch/x86/hyperv/hv_apic.c
> +++ b/arch/x86/hyperv/hv_apic.c
> @@ -23,7 +23,6 @@
>  #include <linux/vmalloc.h>
>  #include <linux/mm.h>
>  #include <linux/clockchips.h>
> -#include <linux/hyperv.h>
>  #include <linux/slab.h>
>  #include <linux/cpuhotplug.h>
>  #include <asm/hypervisor.h>
> diff --git a/arch/x86/hyperv/hv_init.c b/arch/x86/hyperv/hv_init.c
> index 17a71e92a343..1a6354b3e582 100644
> --- a/arch/x86/hyperv/hv_init.c
> +++ b/arch/x86/hyperv/hv_init.c
> @@ -27,7 +27,6 @@
>  #include <linux/version.h>
>  #include <linux/vmalloc.h>
>  #include <linux/mm.h>
> -#include <linux/hyperv.h>
>  #include <linux/slab.h>
>  #include <linux/kernel.h>
>  #include <linux/cpuhotplug.h>
> diff --git a/arch/x86/hyperv/hv_proc.c b/arch/x86/hyperv/hv_proc.c
> index 3fa1f2ee7b0d..b74c06c04ff1 100644
> --- a/arch/x86/hyperv/hv_proc.c
> +++ b/arch/x86/hyperv/hv_proc.c
> @@ -3,7 +3,6 @@
>  #include <linux/vmalloc.h>
>  #include <linux/mm.h>
>  #include <linux/clockchips.h>
> -#include <linux/hyperv.h>
>  #include <linux/slab.h>
>  #include <linux/cpuhotplug.h>
>  #include <linux/minmax.h>
> diff --git a/arch/x86/hyperv/ivm.c b/arch/x86/hyperv/ivm.c
> index 60fc3ed72830..b56d70612734 100644
> --- a/arch/x86/hyperv/ivm.c
> +++ b/arch/x86/hyperv/ivm.c
> @@ -7,7 +7,6 @@
>   */
> 
>  #include <linux/bitfield.h>
> -#include <linux/hyperv.h>
>  #include <linux/types.h>
>  #include <linux/slab.h>
>  #include <asm/svm.h>
> diff --git a/arch/x86/hyperv/mmu.c b/arch/x86/hyperv/mmu.c
> index 1cc113200ff5..cc8c3bd0e7c2 100644
> --- a/arch/x86/hyperv/mmu.c
> +++ b/arch/x86/hyperv/mmu.c
> @@ -1,6 +1,5 @@
>  #define pr_fmt(fmt)  "Hyper-V: " fmt
> 
> -#include <linux/hyperv.h>
>  #include <linux/log2.h>
>  #include <linux/slab.h>
>  #include <linux/types.h>
> diff --git a/arch/x86/include/asm/kvm_host.h b/arch/x86/include/asm/kvm_host.h
> index 4a68cb3eba78..3627eab994a3 100644
> --- a/arch/x86/include/asm/kvm_host.h
> +++ b/arch/x86/include/asm/kvm_host.h
> @@ -24,7 +24,6 @@
>  #include <linux/pvclock_gtod.h>
>  #include <linux/clocksource.h>
>  #include <linux/irqbypass.h>
> -#include <linux/hyperv.h>
>  #include <linux/kfifo.h>
> 
>  #include <asm/apic.h>
> diff --git a/arch/x86/include/asm/mshyperv.h b/arch/x86/include/asm/mshyperv.h
> index 390c4d13956d..47ca48062547 100644
> --- a/arch/x86/include/asm/mshyperv.h
> +++ b/arch/x86/include/asm/mshyperv.h
> @@ -9,7 +9,6 @@
>  #include <asm/hyperv-tlfs.h>
>  #include <asm/nospec-branch.h>
>  #include <asm/paravirt.h>
> -#include <asm/mshyperv.h>
> 
>  /*
>   * Hyper-V always provides a single IO-APIC at this MMIO address.
> diff --git a/arch/x86/mm/pat/set_memory.c b/arch/x86/mm/pat/set_memory.c
> index 44f7b2ea6a07..85fa0d4509f0 100644
> --- a/arch/x86/mm/pat/set_memory.c
> +++ b/arch/x86/mm/pat/set_memory.c
> @@ -32,8 +32,6 @@
>  #include <asm/pgalloc.h>
>  #include <asm/proto.h>
>  #include <asm/memtype.h>
> -#include <asm/hyperv-tlfs.h>
> -#include <asm/mshyperv.h>
> 
>  #include "../mm_internal.h"
> 
> --
> 2.34.1

Looks good!

Reviewed-by: Michael Kelley <mhklinux@outlook.com>

[PATCH v2 3/4] hyperv: Add new Hyper-V headers in include/hyperv

[Nuno Das Neves]

These headers contain definitions for regular Hyper-V guests (as in
hyperv-tlfs.h), as well as interfaces for more privileged guests like
Dom0.

These files are derived from headers exported from Hyper-V, rather than
being derived from the TLFS document. (Although, to preserve
compatibility with existing Linux code, some definitions are copied
directly from hyperv-tlfs.h too).

The new files follow a naming convention according to their original
use:
- hdk "host development kit"
- gdk "guest development kit"
With postfix "_mini" implying userspace-only headers, and "_ext" for
extended hypercalls.

These names should be considered a rough guide only - since there are
many places already where both host and guest code are in the same
place, hvhdk.h (which includes everything) can be used most of the time.

The original names are kept intact primarily to keep the provenance of
exactly where they came from in Hyper-V code, which is helpful for
manual maintenance and extension of these definitions. Microsoft
maintainers importing new definitions should take care to put them in
the right file.

Note also that the files contain both arm64 and x86_64 code guarded by
\#ifdefs, which is how the definitions originally appear in Hyper-V.
Keeping this convention from Hyper-V code is another tactic for
simplying the process of importing new definitions.

These headers are a step toward importing headers directly from Hyper-V
in the future, similar to Xen public files in include/xen/interface/.

Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
---
 include/hyperv/hvgdk.h      |  303 ++++++++
 include/hyperv/hvgdk_ext.h  |   46 ++
 include/hyperv/hvgdk_mini.h | 1295 +++++++++++++++++++++++++++++++++++
 include/hyperv/hvhdk.h      |  733 ++++++++++++++++++++
 include/hyperv/hvhdk_mini.h |  310 +++++++++
 5 files changed, 2687 insertions(+)
 create mode 100644 include/hyperv/hvgdk.h
 create mode 100644 include/hyperv/hvgdk_ext.h
 create mode 100644 include/hyperv/hvgdk_mini.h
 create mode 100644 include/hyperv/hvhdk.h
 create mode 100644 include/hyperv/hvhdk_mini.h

diff --git a/include/hyperv/hvgdk.h b/include/hyperv/hvgdk.h
new file mode 100644
index 000000000000..9687c6570dfb
--- /dev/null
+++ b/include/hyperv/hvgdk.h
@@ -0,0 +1,303 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Type definitions for the Microsoft Hypervisor.
+ */
+#ifndef _HV_HVGDK_H
+#define _HV_HVGDK_H
+
+#include "hvgdk_mini.h"
+#include "hvgdk_ext.h"
+
+/*
+ * The guest OS needs to register the guest ID with the hypervisor.
+ * The guest ID is a 64 bit entity and the structure of this ID is
+ * specified in the Hyper-V TLFS specification.
+ *
+ * While the current guideline does not specify how Linux guest ID(s)
+ * need to be generated, our plan is to publish the guidelines for
+ * Linux and other guest operating systems that currently are hosted
+ * on Hyper-V. The implementation here conforms to this yet
+ * unpublished guidelines.
+ *
+ * Bit(s)
+ * 63 - Indicates if the OS is Open Source or not; 1 is Open Source
+ * 62:56 - Os Type; Linux is 0x100
+ * 55:48 - Distro specific identification
+ * 47:16 - Linux kernel version number
+ * 15:0  - Distro specific identification
+ */
+
+#define HV_LINUX_VENDOR_ID              0x8100
+
+/* HV_VMX_ENLIGHTENED_VMCS */
+struct hv_enlightened_vmcs {
+	u32 revision_id;
+	u32 abort;
+
+	u16 host_es_selector;
+	u16 host_cs_selector;
+	u16 host_ss_selector;
+	u16 host_ds_selector;
+	u16 host_fs_selector;
+	u16 host_gs_selector;
+	u16 host_tr_selector;
+
+	u16 padding16_1;
+
+	u64 host_ia32_pat;
+	u64 host_ia32_efer;
+
+	u64 host_cr0;
+	u64 host_cr3;
+	u64 host_cr4;
+
+	u64 host_ia32_sysenter_esp;
+	u64 host_ia32_sysenter_eip;
+	u64 host_rip;
+	u32 host_ia32_sysenter_cs;
+
+	u32 pin_based_vm_exec_control;
+	u32 vm_exit_controls;
+	u32 secondary_vm_exec_control;
+
+	u64 io_bitmap_a;
+	u64 io_bitmap_b;
+	u64 msr_bitmap;
+
+	u16 guest_es_selector;
+	u16 guest_cs_selector;
+	u16 guest_ss_selector;
+	u16 guest_ds_selector;
+	u16 guest_fs_selector;
+	u16 guest_gs_selector;
+	u16 guest_ldtr_selector;
+	u16 guest_tr_selector;
+
+	u32 guest_es_limit;
+	u32 guest_cs_limit;
+	u32 guest_ss_limit;
+	u32 guest_ds_limit;
+	u32 guest_fs_limit;
+	u32 guest_gs_limit;
+	u32 guest_ldtr_limit;
+	u32 guest_tr_limit;
+	u32 guest_gdtr_limit;
+	u32 guest_idtr_limit;
+
+	u32 guest_es_ar_bytes;
+	u32 guest_cs_ar_bytes;
+	u32 guest_ss_ar_bytes;
+	u32 guest_ds_ar_bytes;
+	u32 guest_fs_ar_bytes;
+	u32 guest_gs_ar_bytes;
+	u32 guest_ldtr_ar_bytes;
+	u32 guest_tr_ar_bytes;
+
+	u64 guest_es_base;
+	u64 guest_cs_base;
+	u64 guest_ss_base;
+	u64 guest_ds_base;
+	u64 guest_fs_base;
+	u64 guest_gs_base;
+	u64 guest_ldtr_base;
+	u64 guest_tr_base;
+	u64 guest_gdtr_base;
+	u64 guest_idtr_base;
+
+	u64 padding64_1[3];
+
+	u64 vm_exit_msr_store_addr;
+	u64 vm_exit_msr_load_addr;
+	u64 vm_entry_msr_load_addr;
+
+	u64 cr3_target_value0;
+	u64 cr3_target_value1;
+	u64 cr3_target_value2;
+	u64 cr3_target_value3;
+
+	u32 page_fault_error_code_mask;
+	u32 page_fault_error_code_match;
+
+	u32 cr3_target_count;
+	u32 vm_exit_msr_store_count;
+	u32 vm_exit_msr_load_count;
+	u32 vm_entry_msr_load_count;
+
+	u64 tsc_offset;
+	u64 virtual_apic_page_addr;
+	u64 vmcs_link_pointer;
+
+	u64 guest_ia32_debugctl;
+	u64 guest_ia32_pat;
+	u64 guest_ia32_efer;
+
+	u64 guest_pdptr0;
+	u64 guest_pdptr1;
+	u64 guest_pdptr2;
+	u64 guest_pdptr3;
+
+	u64 guest_pending_dbg_exceptions;
+	u64 guest_sysenter_esp;
+	u64 guest_sysenter_eip;
+
+	u32 guest_activity_state;
+	u32 guest_sysenter_cs;
+
+	u64 cr0_guest_host_mask;
+	u64 cr4_guest_host_mask;
+	u64 cr0_read_shadow;
+	u64 cr4_read_shadow;
+	u64 guest_cr0;
+	u64 guest_cr3;
+	u64 guest_cr4;
+	u64 guest_dr7;
+
+	u64 host_fs_base;
+	u64 host_gs_base;
+	u64 host_tr_base;
+	u64 host_gdtr_base;
+	u64 host_idtr_base;
+	u64 host_rsp;
+
+	u64 ept_pointer;
+
+	u16 virtual_processor_id;
+	u16 padding16_2[3];
+
+	u64 padding64_2[5];
+	u64 guest_physical_address;
+
+	u32 vm_instruction_error;
+	u32 vm_exit_reason;
+	u32 vm_exit_intr_info;
+	u32 vm_exit_intr_error_code;
+	u32 idt_vectoring_info_field;
+	u32 idt_vectoring_error_code;
+	u32 vm_exit_instruction_len;
+	u32 vmx_instruction_info;
+
+	u64 exit_qualification;
+	u64 exit_io_instruction_ecx;
+	u64 exit_io_instruction_esi;
+	u64 exit_io_instruction_edi;
+	u64 exit_io_instruction_eip;
+
+	u64 guest_linear_address;
+	u64 guest_rsp;
+	u64 guest_rflags;
+
+	u32 guest_interruptibility_info;
+	u32 cpu_based_vm_exec_control;
+	u32 exception_bitmap;
+	u32 vm_entry_controls;
+	u32 vm_entry_intr_info_field;
+	u32 vm_entry_exception_error_code;
+	u32 vm_entry_instruction_len;
+	u32 tpr_threshold;
+
+	u64 guest_rip;
+
+	u32 hv_clean_fields;
+	u32 padding32_1;
+	u32 hv_synthetic_controls;
+	struct {
+		u32 nested_flush_hypercall:1;
+		u32 msr_bitmap:1;
+		u32 reserved:30;
+	}  __packed hv_enlightenments_control;
+	u32 hv_vp_id;
+	u32 padding32_2;
+	u64 hv_vm_id;
+	u64 partition_assist_page;
+	u64 padding64_4[4];
+	u64 guest_bndcfgs;
+	u64 guest_ia32_perf_global_ctrl;
+	u64 guest_ia32_s_cet;
+	u64 guest_ssp;
+	u64 guest_ia32_int_ssp_table_addr;
+	u64 guest_ia32_lbr_ctl;
+	u64 padding64_5[2];
+	u64 xss_exit_bitmap;
+	u64 encls_exiting_bitmap;
+	u64 host_ia32_perf_global_ctrl;
+	u64 tsc_multiplier;
+	u64 host_ia32_s_cet;
+	u64 host_ssp;
+	u64 host_ia32_int_ssp_table_addr;
+	u64 padding64_6;
+} __packed;
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_NONE			0
+
+
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_IO_BITMAP		BIT(0)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_MSR_BITMAP		BIT(1)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_GRP2		BIT(2)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_GRP1		BIT(3)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_PROC		BIT(4)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_EVENT		BIT(5)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_ENTRY		BIT(6)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_EXCPN		BIT(7)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CRDR			BIT(8)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_XLAT		BIT(9)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_BASIC		BIT(10)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_GRP1		BIT(11)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_GRP2		BIT(12)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_HOST_POINTER		BIT(13)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_HOST_GRP1		BIT(14)
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_ENLIGHTENMENTSCONTROL	BIT(15)
+
+#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_ALL			0xFFFF
+
+/*
+ * Note, Hyper-V isn't actually stealing bit 28 from Intel, just abusing it by
+ * pairing it with architecturally impossible exit reasons.  Bit 28 is set only
+ * on SMI exits to a SMI transfer monitor (STM) and if and only if a MTF VM-Exit
+ * is pending.  I.e. it will never be set by hardware for non-SMI exits (there
+ * are only three), nor will it ever be set unless the VMM is an STM.
+ */
+#define HV_VMX_SYNTHETIC_EXIT_REASON_TRAP_AFTER_FLUSH		0x10000031
+
+/*
+ * Hyper-V uses the software reserved 32 bytes in VMCB control area to expose
+ * SVM enlightenments to guests. This is documented in the TLFS doc.
+ * Note on naming: SVM_NESTED_ENLIGHTENED_VMCB_FIELDS
+ */
+struct hv_vmcb_enlightenments {
+	struct __packed hv_enlightenments_control {
+		u32 nested_flush_hypercall : 1;
+		u32 msr_bitmap : 1;
+		u32 enlightened_npt_tlb: 1;
+		u32 reserved : 29;
+	} __packed hv_enlightenments_control;
+	u32 hv_vp_id;
+	u64 hv_vm_id;
+	u64 partition_assist_page;
+	u64 reserved;
+} __packed;
+
+/*
+ * Hyper-V uses the software reserved clean bit in VMCB.
+ */
+#define HV_VMCB_NESTED_ENLIGHTENMENTS		31
+
+/* Synthetic VM-Exit */
+#define HV_SVM_EXITCODE_ENL			0xf0000000
+#define HV_SVM_ENL_EXITCODE_TRAP_AFTER_FLUSH	(1)
+
+/* Define connection identifier type. */
+union hv_connection_id {
+	u32 asu32;
+	struct {
+		u32 id : 24;
+		u32 reserved : 8;
+	} __packed u;
+};
+
+struct hv_input_unmap_gpa_pages {
+	u64 target_partition_id;
+	u64 target_gpa_base;
+	u32 unmap_flags;
+	u32 padding;
+} __packed;
+
+#endif /* #ifndef _HV_HVGDK_H */
diff --git a/include/hyperv/hvgdk_ext.h b/include/hyperv/hvgdk_ext.h
new file mode 100644
index 000000000000..641b591ee61f
--- /dev/null
+++ b/include/hyperv/hvgdk_ext.h
@@ -0,0 +1,46 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Type definitions for the Microsoft Hypervisor.
+ */
+#ifndef _HV_HVGDK_EXT_H
+#define _HV_HVGDK_EXT_H
+
+#include "hvgdk_mini.h"
+
+/* Extended hypercalls */
+#define HV_EXT_CALL_QUERY_CAPABILITIES		0x8001
+#define HV_EXT_CALL_MEMORY_HEAT_HINT		0x8003
+
+/* Extended hypercalls */
+enum {		/* HV_EXT_CALL */
+	HV_EXTCALL_QUERY_CAPABILITIES = 0x8001,
+	HV_EXTCALL_MEMORY_HEAT_HINT   = 0x8003,
+};
+
+/* HV_EXT_OUTPUT_QUERY_CAPABILITIES */
+#define HV_EXT_CAPABILITY_MEMORY_COLD_DISCARD_HINT BIT(8)
+
+enum {		/* HV_EXT_MEMORY_HEAT_HINT_TYPE */
+	HV_EXTMEM_HEAT_HINT_COLD = 0,
+	HV_EXTMEM_HEAT_HINT_HOT = 1,
+	HV_EXTMEM_HEAT_HINT_COLD_DISCARD = 2,
+	HV_EXTMEM_HEAT_HINT_MAX
+};
+
+/*
+ * The whole argument should fit in a page to be able to pass to the hypervisor
+ * in one hypercall.
+ */
+#define HV_MEMORY_HINT_MAX_GPA_PAGE_RANGES  \
+	((HV_HYP_PAGE_SIZE - sizeof(struct hv_memory_hint)) / \
+		sizeof(union hv_gpa_page_range))
+
+/* HvExtCallMemoryHeatHint hypercall */
+#define HV_EXT_MEMORY_HEAT_HINT_TYPE_COLD_DISCARD	2
+struct hv_memory_hint {		/* HV_EXT_INPUT_MEMORY_HEAT_HINT */
+	u64 heat_type : 2;	/* HV_EXTMEM_HEAT_HINT_* */
+	u64 reserved : 62;
+	union hv_gpa_page_range ranges[];
+} __packed;
+
+#endif /* _HV_HVGDK_EXT_H */
diff --git a/include/hyperv/hvgdk_mini.h b/include/hyperv/hvgdk_mini.h
new file mode 100644
index 000000000000..c78f345fa4af
--- /dev/null
+++ b/include/hyperv/hvgdk_mini.h
@@ -0,0 +1,1295 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Type definitions for the Microsoft hypervisor.
+ */
+#ifndef _HV_HVGDK_MINI_H
+#define _HV_HVGDK_MINI_H
+
+#include <linux/types.h>
+#include <linux/bits.h>
+
+struct hv_u128 {
+	u64 low_part;
+	u64 high_part;
+} __packed;
+
+/* NOTE: when adding below, update hv_status_to_string() */
+#define HV_STATUS_SUCCESS			    0x0
+#define HV_STATUS_INVALID_HYPERCALL_CODE	    0x2
+#define HV_STATUS_INVALID_HYPERCALL_INPUT	    0x3
+#define HV_STATUS_INVALID_ALIGNMENT		    0x4
+#define HV_STATUS_INVALID_PARAMETER		    0x5
+#define HV_STATUS_ACCESS_DENIED			    0x6
+#define HV_STATUS_INVALID_PARTITION_STATE	    0x7
+#define HV_STATUS_OPERATION_DENIED		    0x8
+#define HV_STATUS_UNKNOWN_PROPERTY		    0x9
+#define HV_STATUS_PROPERTY_VALUE_OUT_OF_RANGE	    0xA
+#define HV_STATUS_INSUFFICIENT_MEMORY		    0xB
+#define HV_STATUS_INVALID_PARTITION_ID		    0xD
+#define HV_STATUS_INVALID_VP_INDEX		    0xE
+#define HV_STATUS_NOT_FOUND			    0x10
+#define HV_STATUS_INVALID_PORT_ID		    0x11
+#define HV_STATUS_INVALID_CONNECTION_ID		    0x12
+#define HV_STATUS_INSUFFICIENT_BUFFERS		    0x13
+#define HV_STATUS_NOT_ACKNOWLEDGED		    0x14
+#define HV_STATUS_INVALID_VP_STATE		    0x15
+#define HV_STATUS_NO_RESOURCES			    0x1D
+#define HV_STATUS_PROCESSOR_FEATURE_NOT_SUPPORTED   0x20
+#define HV_STATUS_INVALID_LP_INDEX		    0x41
+#define HV_STATUS_INVALID_REGISTER_VALUE	    0x50
+#define HV_STATUS_OPERATION_FAILED		    0x71
+#define HV_STATUS_TIME_OUT			    0x78
+#define HV_STATUS_CALL_PENDING			    0x79
+#define HV_STATUS_VTL_ALREADY_ENABLED		    0x86
+
+/*
+ * The Hyper-V TimeRefCount register and the TSC
+ * page provide a guest VM clock with 100ns tick rate
+ */
+#define HV_CLOCK_HZ (NSEC_PER_SEC / 100)
+
+#define HV_HYP_PAGE_SHIFT		12
+#define HV_HYP_PAGE_SIZE		BIT(HV_HYP_PAGE_SHIFT)
+#define HV_HYP_PAGE_MASK		(~(HV_HYP_PAGE_SIZE - 1))
+
+#define HV_PARTITION_ID_INVALID		((u64)0)
+#define HV_PARTITION_ID_SELF		((u64)-1)
+
+/* Hyper-V specific model specific registers (MSRs) */
+
+#if defined(CONFIG_X86)
+/* HV_X64_SYNTHETIC_MSR */
+#define HV_X64_MSR_GUEST_OS_ID			0x40000000
+#define HV_X64_MSR_HYPERCALL			0x40000001
+#define HV_X64_MSR_VP_INDEX			0x40000002
+#define HV_X64_MSR_RESET			0x40000003
+#define HV_X64_MSR_VP_RUNTIME			0x40000010
+#define HV_X64_MSR_TIME_REF_COUNT		0x40000020
+#define HV_X64_MSR_REFERENCE_TSC		0x40000021
+#define HV_X64_MSR_TSC_FREQUENCY		0x40000022
+#define HV_X64_MSR_APIC_FREQUENCY		0x40000023
+
+/* Define the virtual APIC registers */
+#define HV_X64_MSR_EOI				0x40000070
+#define HV_X64_MSR_ICR				0x40000071
+#define HV_X64_MSR_TPR				0x40000072
+#define HV_X64_MSR_VP_ASSIST_PAGE		0x40000073
+
+/* Define synthetic interrupt controller model specific registers. */
+#define HV_X64_MSR_SCONTROL			0x40000080
+#define HV_X64_MSR_SVERSION			0x40000081
+#define HV_X64_MSR_SIEFP			0x40000082
+#define HV_X64_MSR_SIMP				0x40000083
+#define HV_X64_MSR_EOM				0x40000084
+#define HV_X64_MSR_SIRBP			0x40000085
+#define HV_X64_MSR_SINT0			0x40000090
+#define HV_X64_MSR_SINT1			0x40000091
+#define HV_X64_MSR_SINT2			0x40000092
+#define HV_X64_MSR_SINT3			0x40000093
+#define HV_X64_MSR_SINT4			0x40000094
+#define HV_X64_MSR_SINT5			0x40000095
+#define HV_X64_MSR_SINT6			0x40000096
+#define HV_X64_MSR_SINT7			0x40000097
+#define HV_X64_MSR_SINT8			0x40000098
+#define HV_X64_MSR_SINT9			0x40000099
+#define HV_X64_MSR_SINT10			0x4000009A
+#define HV_X64_MSR_SINT11			0x4000009B
+#define HV_X64_MSR_SINT12			0x4000009C
+#define HV_X64_MSR_SINT13			0x4000009D
+#define HV_X64_MSR_SINT14			0x4000009E
+#define HV_X64_MSR_SINT15			0x4000009F
+
+/* Define synthetic interrupt controller model specific registers for nested hypervisor */
+#define HV_X64_MSR_NESTED_SCONTROL		0x40001080
+#define HV_X64_MSR_NESTED_SVERSION		0x40001081
+#define HV_X64_MSR_NESTED_SIEFP			0x40001082
+#define HV_X64_MSR_NESTED_SIMP			0x40001083
+#define HV_X64_MSR_NESTED_EOM			0x40001084
+#define HV_X64_MSR_NESTED_SINT0			0x40001090
+
+/*
+ * Synthetic Timer MSRs. Four timers per vcpu.
+ */
+#define HV_X64_MSR_STIMER0_CONFIG		0x400000B0
+#define HV_X64_MSR_STIMER0_COUNT		0x400000B1
+#define HV_X64_MSR_STIMER1_CONFIG		0x400000B2
+#define HV_X64_MSR_STIMER1_COUNT		0x400000B3
+#define HV_X64_MSR_STIMER2_CONFIG		0x400000B4
+#define HV_X64_MSR_STIMER2_COUNT		0x400000B5
+#define HV_X64_MSR_STIMER3_CONFIG		0x400000B6
+#define HV_X64_MSR_STIMER3_COUNT		0x400000B7
+
+/* Hyper-V guest idle MSR */
+#define HV_X64_MSR_GUEST_IDLE			0x400000F0
+
+/* Hyper-V guest crash notification MSR's */
+#define HV_X64_MSR_CRASH_P0			0x40000100
+#define HV_X64_MSR_CRASH_P1			0x40000101
+#define HV_X64_MSR_CRASH_P2			0x40000102
+#define HV_X64_MSR_CRASH_P3			0x40000103
+#define HV_X64_MSR_CRASH_P4			0x40000104
+#define HV_X64_MSR_CRASH_CTL			0x40000105
+
+#define HV_X64_MSR_HYPERCALL_ENABLE		0x00000001
+#define HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_SHIFT	12
+#define HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_MASK	\
+		(~((1ull << HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_SHIFT) - 1))
+
+#define HV_X64_MSR_CRASH_PARAMS		\
+		(1 + (HV_X64_MSR_CRASH_P4 - HV_X64_MSR_CRASH_P0))
+
+#define HV_IPI_LOW_VECTOR	 0x10
+#define HV_IPI_HIGH_VECTOR	 0xff
+
+#define HV_X64_MSR_VP_ASSIST_PAGE_ENABLE	0x00000001
+#define HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_SHIFT	12
+#define HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_MASK	\
+		(~((1ull << HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_SHIFT) - 1))
+
+/* Hyper-V Enlightened VMCS version mask in nested features CPUID */
+#define HV_X64_ENLIGHTENED_VMCS_VERSION		0xff
+
+#define HV_X64_MSR_TSC_REFERENCE_ENABLE		0x00000001
+#define HV_X64_MSR_TSC_REFERENCE_ADDRESS_SHIFT	12
+
+/* Number of XMM registers used in hypercall input/output */
+#define HV_HYPERCALL_MAX_XMM_REGISTERS		6
+
+struct hv_reenlightenment_control {
+	u64 vector : 8;
+	u64 reserved1 : 8;
+	u64 enabled : 1;
+	u64 reserved2 : 15;
+	u64 target_vp : 32;
+}  __packed;
+
+struct hv_tsc_emulation_status {	 /* HV_TSC_EMULATION_STATUS */
+	u64 inprogress : 1;
+	u64 reserved : 63;
+} __packed;
+
+struct hv_tsc_emulation_control {	 /* HV_TSC_INVARIANT_CONTROL */
+	u64 enabled : 1;
+	u64 reserved : 63;
+} __packed;
+
+/* TSC emulation after migration */
+#define HV_X64_MSR_REENLIGHTENMENT_CONTROL	0x40000106
+#define HV_X64_MSR_TSC_EMULATION_CONTROL	0x40000107
+#define HV_X64_MSR_TSC_EMULATION_STATUS		0x40000108
+#define HV_X64_MSR_TSC_INVARIANT_CONTROL	0x40000118
+#define HV_EXPOSE_INVARIANT_TSC		BIT_ULL(0)
+
+#endif /* CONFIG_X86 */
+
+struct hv_get_partition_id {	 /* HV_OUTPUT_GET_PARTITION_ID */
+	u64 partition_id;
+} __packed;
+
+/* HV_CRASH_CTL_REG_CONTENTS */
+#define HV_CRASH_CTL_CRASH_NOTIFY_MSG		 BIT_ULL(62)
+#define HV_CRASH_CTL_CRASH_NOTIFY		 BIT_ULL(63)
+
+union hv_reference_tsc_msr {
+	u64 as_uint64;
+	struct {
+		u64 enable : 1;
+		u64 reserved : 11;
+		u64 pfn : 52;
+	} __packed;
+};
+
+/* The maximum number of sparse vCPU banks which can be encoded by 'struct hv_vpset' */
+#define HV_MAX_SPARSE_VCPU_BANKS (64)
+/* The number of vCPUs in one sparse bank */
+#define HV_VCPUS_PER_SPARSE_BANK (64)
+
+/* Some of Hyper-V structs do not use hv_vpset where linux uses them */
+struct hv_vpset {	 /* HV_VP_SET */
+	u64 format;
+	u64 valid_bank_mask;
+	u64 bank_contents[];
+} __packed;
+
+/*
+ * Version info reported by hypervisor
+ * Changed to a union for convenience
+ */
+union hv_hypervisor_version_info {
+	struct {
+		u32 build_number;
+
+		u32 minor_version : 16;
+		u32 major_version : 16;
+
+		u32 service_pack;
+
+		u32 service_number : 24;
+		u32 service_branch : 8;
+	};
+	struct {
+		u32 eax;
+		u32 ebx;
+		u32 ecx;
+		u32 edx;
+	};
+};
+
+/* HV_CPUID_FUNCTION */
+#define HYPERV_CPUID_VENDOR_AND_MAX_FUNCTIONS	0x40000000
+#define HYPERV_CPUID_INTERFACE			0x40000001
+#define HYPERV_CPUID_VERSION			0x40000002
+#define HYPERV_CPUID_FEATURES			0x40000003
+#define HYPERV_CPUID_ENLIGHTMENT_INFO		0x40000004
+#define HYPERV_CPUID_IMPLEMENT_LIMITS		0x40000005
+#define HYPERV_CPUID_CPU_MANAGEMENT_FEATURES	0x40000007
+#define HYPERV_CPUID_NESTED_FEATURES		0x4000000A
+#define HYPERV_CPUID_ISOLATION_CONFIG		0x4000000C
+
+#define HYPERV_CPUID_VIRT_STACK_INTERFACE	 0x40000081
+#define HYPERV_VS_INTERFACE_EAX_SIGNATURE	 0x31235356  /* "VS#1" */
+
+#define HYPERV_CPUID_VIRT_STACK_PROPERTIES	 0x40000082
+/* Support for the extended IOAPIC RTE format */
+#define HYPERV_VS_PROPERTIES_EAX_EXTENDED_IOAPIC_RTE	 BIT(2)
+
+#define HYPERV_HYPERVISOR_PRESENT_BIT		 0x80000000
+#define HYPERV_CPUID_MIN			 0x40000005
+#define HYPERV_CPUID_MAX			 0x4000ffff
+
+/* HV_PARTITION_PRIVILEGE_MASK */
+#define HV_MSR_VP_RUNTIME_AVAILABLE			BIT(0)
+#define HV_MSR_TIME_REF_COUNT_AVAILABLE			BIT(1)
+#define HV_MSR_SYNIC_AVAILABLE				BIT(2)
+#define HV_MSR_SYNTIMER_AVAILABLE			BIT(3)
+#define HV_MSR_APIC_ACCESS_AVAILABLE			BIT(4)
+#define HV_MSR_HYPERCALL_AVAILABLE			BIT(5)
+#define HV_MSR_VP_INDEX_AVAILABLE			BIT(6)
+#define HV_MSR_RESET_AVAILABLE				BIT(7)
+#define HV_MSR_STAT_PAGES_AVAILABLE			BIT(8)
+#define HV_MSR_REFERENCE_TSC_AVAILABLE			BIT(9)
+#define HV_MSR_GUEST_IDLE_AVAILABLE			BIT(10)
+#define HV_ACCESS_FREQUENCY_MSRS			BIT(11)
+#define HV_ACCESS_REENLIGHTENMENT			BIT(13)
+#define HV_ACCESS_TSC_INVARIANT				BIT(15)
+
+/* HV_PARTITION_PRIVILEGE_MASK */
+#define HV_CREATE_PARTITIONS				BIT(0)
+#define HV_ACCESS_PARTITION_ID				BIT(1)
+#define HV_ACCESS_MEMORY_POOL				BIT(2)
+#define HV_ADJUST_MESSAGE_BUFFERS			BIT(3)
+#define HV_POST_MESSAGES				BIT(4)
+#define HV_SIGNAL_EVENTS				BIT(5)
+#define HV_CREATE_PORT					BIT(6)
+#define HV_CONNECT_PORT					BIT(7)
+#define HV_ACCESS_STATS					BIT(8)
+#define HV_DEBUGGING					BIT(11)
+#define HV_CPU_MANAGEMENT				BIT(12)
+#define HV_ENABLE_EXTENDED_HYPERCALLS			BIT(20)
+#define HV_ISOLATION					BIT(22)
+
+#if defined(CONFIG_X86)
+/* HV_X64_HYPERVISOR_FEATURES (EDX) */
+#define HV_X64_MWAIT_AVAILABLE				BIT(0)
+#define HV_X64_GUEST_DEBUGGING_AVAILABLE		BIT(1)
+#define HV_X64_PERF_MONITOR_AVAILABLE			BIT(2)
+#define HV_X64_CPU_DYNAMIC_PARTITIONING_AVAILABLE	BIT(3)
+#define HV_X64_HYPERCALL_XMM_INPUT_AVAILABLE		BIT(4)
+#define HV_X64_GUEST_IDLE_STATE_AVAILABLE		BIT(5)
+#define HV_FEATURE_FREQUENCY_MSRS_AVAILABLE		BIT(8)
+#define HV_FEATURE_GUEST_CRASH_MSR_AVAILABLE		BIT(10)
+#define HV_FEATURE_DEBUG_MSRS_AVAILABLE			BIT(11)
+#define HV_FEATURE_EXT_GVA_RANGES_FLUSH			BIT(14)
+/*
+ * Support for returning hypercall output block via XMM
+ * registers is available
+ */
+#define HV_X64_HYPERCALL_XMM_OUTPUT_AVAILABLE		BIT(15)
+/* stimer Direct Mode is available */
+#define HV_STIMER_DIRECT_MODE_AVAILABLE			BIT(19)
+
+/* HV_X64_ENLIGHTENMENT_INFORMATION */
+#define HV_X64_AS_SWITCH_RECOMMENDED			BIT(0)
+#define HV_X64_LOCAL_TLB_FLUSH_RECOMMENDED		BIT(1)
+#define HV_X64_REMOTE_TLB_FLUSH_RECOMMENDED		BIT(2)
+#define HV_X64_APIC_ACCESS_RECOMMENDED			BIT(3)
+#define HV_X64_SYSTEM_RESET_RECOMMENDED			BIT(4)
+#define HV_X64_RELAXED_TIMING_RECOMMENDED		BIT(5)
+#define HV_DEPRECATING_AEOI_RECOMMENDED			BIT(9)
+#define HV_X64_CLUSTER_IPI_RECOMMENDED			BIT(10)
+#define HV_X64_EX_PROCESSOR_MASKS_RECOMMENDED		BIT(11)
+#define HV_X64_HYPERV_NESTED				BIT(12)
+#define HV_X64_ENLIGHTENED_VMCS_RECOMMENDED		BIT(14)
+#define HV_X64_USE_MMIO_HYPERCALLS			BIT(21)
+
+/*
+ * CPU management features identification.
+ * These are HYPERV_CPUID_CPU_MANAGEMENT_FEATURES.EAX bits.
+ */
+#define HV_X64_START_LOGICAL_PROCESSOR			BIT(0)
+#define HV_X64_CREATE_ROOT_VIRTUAL_PROCESSOR		BIT(1)
+#define HV_X64_PERFORMANCE_COUNTER_SYNC			BIT(2)
+#define HV_X64_RESERVED_IDENTITY_BIT			BIT(31)
+
+/*
+ * Virtual processor will never share a physical core with another virtual
+ * processor, except for virtual processors that are reported as sibling SMT
+ * threads.
+ */
+#define HV_X64_NO_NONARCH_CORESHARING			BIT(18)
+
+/* Nested features. These are HYPERV_CPUID_NESTED_FEATURES.EAX bits. */
+#define HV_X64_NESTED_DIRECT_FLUSH			BIT(17)
+#define HV_X64_NESTED_GUEST_MAPPING_FLUSH		BIT(18)
+#define HV_X64_NESTED_MSR_BITMAP			BIT(19)
+
+/* Nested features #2. These are HYPERV_CPUID_NESTED_FEATURES.EBX bits. */
+#define HV_X64_NESTED_EVMCS1_PERF_GLOBAL_CTRL		BIT(0)
+
+/*
+ * This is specific to AMD and specifies that enlightened TLB flush is
+ * supported. If guest opts in to this feature, ASID invalidations only
+ * flushes gva -> hpa mapping entries. To flush the TLB entries derived
+ * from NPT, hypercalls should be used (HvFlushGuestPhysicalAddressSpace
+ * or HvFlushGuestPhysicalAddressList).
+ */
+#define HV_X64_NESTED_ENLIGHTENED_TLB			BIT(22)
+
+/* HYPERV_CPUID_ISOLATION_CONFIG.EAX bits. */
+#define HV_PARAVISOR_PRESENT				BIT(0)
+
+/* HYPERV_CPUID_ISOLATION_CONFIG.EBX bits. */
+#define HV_ISOLATION_TYPE				GENMASK(3, 0)
+#define HV_SHARED_GPA_BOUNDARY_ACTIVE			BIT(5)
+#define HV_SHARED_GPA_BOUNDARY_BITS			GENMASK(11, 6)
+
+enum hv_isolation_type {
+	HV_ISOLATION_TYPE_NONE	= 0,	/* HV_PARTITION_ISOLATION_TYPE_NONE */
+	HV_ISOLATION_TYPE_VBS	= 1,
+	HV_ISOLATION_TYPE_SNP	= 2,
+	HV_ISOLATION_TYPE_TDX	= 3
+};
+
+union hv_x64_msr_hypercall_contents {
+	u64 as_uint64;
+	struct {
+		u64 enable : 1;
+		u64 reserved : 11;
+		u64 guest_physical_address : 52;
+	} __packed;
+};
+#endif /* CONFIG_X86 */
+
+#if defined(CONFIG_ARM64)
+#define HV_FEATURE_GUEST_CRASH_MSR_AVAILABLE	BIT(8)
+#define HV_STIMER_DIRECT_MODE_AVAILABLE		BIT(13)
+#endif /* CONFIG_ARM64 */
+
+#if defined(CONFIG_X86)
+#define HV_MAXIMUM_PROCESSORS	    2048
+#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
+#define HV_MAXIMUM_PROCESSORS	    320
+#endif /* CONFIG_ARM64 */
+
+#define HV_MAX_VP_INDEX			(HV_MAXIMUM_PROCESSORS - 1)
+#define HV_VP_INDEX_SELF		((u32)-2)
+#define HV_ANY_VP			((u32)-1)
+
+union hv_vp_assist_msr_contents {	 /* HV_REGISTER_VP_ASSIST_PAGE */
+	u64 as_uint64;
+	struct {
+		u64 enable : 1;
+		u64 reserved : 11;
+		u64 pfn : 52;
+	} __packed;
+};
+
+/* Declare the various hypercall operations. */
+/* HV_CALL_CODE */
+#define HVCALL_FLUSH_VIRTUAL_ADDRESS_SPACE		0x0002
+#define HVCALL_FLUSH_VIRTUAL_ADDRESS_LIST		0x0003
+#define HVCALL_NOTIFY_LONG_SPIN_WAIT			0x0008
+#define HVCALL_SEND_IPI					0x000b
+#define HVCALL_ENABLE_VP_VTL				0x000f
+#define HVCALL_FLUSH_VIRTUAL_ADDRESS_SPACE_EX		0x0013
+#define HVCALL_FLUSH_VIRTUAL_ADDRESS_LIST_EX		0x0014
+#define HVCALL_SEND_IPI_EX				0x0015
+#define HVCALL_CREATE_PARTITION				0x0040
+#define HVCALL_INITIALIZE_PARTITION			0x0041
+#define HVCALL_FINALIZE_PARTITION			0x0042
+#define HVCALL_DELETE_PARTITION				0x0043
+#define HVCALL_GET_PARTITION_PROPERTY			0x0044
+#define HVCALL_SET_PARTITION_PROPERTY			0x0045
+#define HVCALL_GET_PARTITION_ID				0x0046
+#define HVCALL_DEPOSIT_MEMORY				0x0048
+#define HVCALL_WITHDRAW_MEMORY				0x0049
+#define HVCALL_MAP_GPA_PAGES				0x004b
+#define HVCALL_UNMAP_GPA_PAGES				0x004c
+#define HVCALL_CREATE_VP				0x004e
+#define HVCALL_DELETE_VP				0x004f
+#define HVCALL_GET_VP_REGISTERS				0x0050
+#define HVCALL_SET_VP_REGISTERS				0x0051
+#define HVCALL_DELETE_PORT				0x0058
+#define HVCALL_DISCONNECT_PORT				0x005b
+#define HVCALL_POST_MESSAGE				0x005c
+#define HVCALL_SIGNAL_EVENT				0x005d
+#define HVCALL_POST_DEBUG_DATA				0x0069
+#define HVCALL_RETRIEVE_DEBUG_DATA			0x006a
+#define HVCALL_RESET_DEBUG_SESSION			0x006b
+#define HVCALL_ADD_LOGICAL_PROCESSOR			0x0076
+#define HVCALL_GET_SYSTEM_PROPERTY			0x007b
+#define HVCALL_MAP_DEVICE_INTERRUPT			0x007c
+#define HVCALL_UNMAP_DEVICE_INTERRUPT			0x007d
+#define HVCALL_RETARGET_INTERRUPT			0x007e
+#define HVCALL_NOTIFY_PORT_RING_EMPTY			0x008b
+#define HVCALL_ASSERT_VIRTUAL_INTERRUPT			0x0094
+#define HVCALL_CREATE_PORT				0x0095
+#define HVCALL_CONNECT_PORT				0x0096
+#define HVCALL_START_VP					0x0099
+#define HVCALL_GET_VP_ID_FROM_APIC_ID			0x009a
+#define HVCALL_FLUSH_GUEST_PHYSICAL_ADDRESS_SPACE	0x00af
+#define HVCALL_FLUSH_GUEST_PHYSICAL_ADDRESS_LIST	0x00b0
+#define HVCALL_DISPATCH_VP				0x00c2
+#define HVCALL_MODIFY_SPARSE_GPA_PAGE_HOST_VISIBILITY	0x00db
+#define HVCALL_MAP_VP_STATE_PAGE			0x00e1
+#define HVCALL_UNMAP_VP_STATE_PAGE			0x00e2
+#define HVCALL_GET_VP_STATE				0x00e3
+#define HVCALL_SET_VP_STATE				0x00e4
+#define HVCALL_MMIO_READ				0x0106
+#define HVCALL_MMIO_WRITE				0x0107
+
+/* HV_HYPERCALL_INPUT */
+#define HV_HYPERCALL_RESULT_MASK	GENMASK_ULL(15, 0)
+#define HV_HYPERCALL_FAST_BIT		BIT(16)
+#define HV_HYPERCALL_VARHEAD_OFFSET	17
+#define HV_HYPERCALL_VARHEAD_MASK	GENMASK_ULL(26, 17)
+#define HV_HYPERCALL_RSVD0_MASK		GENMASK_ULL(31, 27)
+#define HV_HYPERCALL_NESTED		BIT_ULL(31)
+#define HV_HYPERCALL_REP_COMP_OFFSET	32
+#define HV_HYPERCALL_REP_COMP_1		BIT_ULL(32)
+#define HV_HYPERCALL_REP_COMP_MASK	GENMASK_ULL(43, 32)
+#define HV_HYPERCALL_RSVD1_MASK		GENMASK_ULL(47, 44)
+#define HV_HYPERCALL_REP_START_OFFSET	48
+#define HV_HYPERCALL_REP_START_MASK	GENMASK_ULL(59, 48)
+#define HV_HYPERCALL_RSVD2_MASK		GENMASK_ULL(63, 60)
+#define HV_HYPERCALL_RSVD_MASK		(HV_HYPERCALL_RSVD0_MASK | \
+					 HV_HYPERCALL_RSVD1_MASK | \
+					 HV_HYPERCALL_RSVD2_MASK)
+
+/* HvFlushGuestPhysicalAddressSpace hypercalls */
+struct hv_guest_mapping_flush {
+	u64 address_space;
+	u64 flags;
+} __packed;
+
+/*
+ *  HV_MAX_FLUSH_PAGES = "additional_pages" + 1. It's limited
+ *  by the bitwidth of "additional_pages" in union hv_gpa_page_range.
+ */
+#define HV_MAX_FLUSH_PAGES (2048)
+#define HV_GPA_PAGE_RANGE_PAGE_SIZE_2MB		0
+#define HV_GPA_PAGE_RANGE_PAGE_SIZE_1GB		1
+
+#define HV_FLUSH_ALL_PROCESSORS			BIT(0)
+#define HV_FLUSH_ALL_VIRTUAL_ADDRESS_SPACES	BIT(1)
+#define HV_FLUSH_NON_GLOBAL_MAPPINGS_ONLY	BIT(2)
+#define HV_FLUSH_USE_EXTENDED_RANGE_FORMAT	BIT(3)
+
+/* HvFlushGuestPhysicalAddressList, HvExtCallMemoryHeatHint hypercall */
+union hv_gpa_page_range {
+	u64 address_space;
+	struct {
+		u64 additional_pages : 11;
+		u64 largepage : 1;
+		u64 basepfn : 52;
+	} page;
+	struct {
+		u64 reserved : 12;
+		u64 page_size : 1;
+		u64 reserved1 : 8;
+		u64 base_large_pfn : 43;
+	};
+};
+
+/*
+ * All input flush parameters should be in single page. The max flush
+ * count is equal with how many entries of union hv_gpa_page_range can
+ * be populated into the input parameter page.
+ */
+#define HV_MAX_FLUSH_REP_COUNT ((HV_HYP_PAGE_SIZE - 2 * sizeof(u64)) / \
+				sizeof(union hv_gpa_page_range))
+
+struct hv_guest_mapping_flush_list {
+	u64 address_space;
+	u64 flags;
+	union hv_gpa_page_range gpa_list[HV_MAX_FLUSH_REP_COUNT];
+};
+
+struct hv_tlb_flush {	 /* HV_INPUT_FLUSH_VIRTUAL_ADDRESS_LIST */
+	u64 address_space;
+	u64 flags;
+	u64 processor_mask;
+	u64 gva_list[];
+} __packed;
+
+/* HvFlushVirtualAddressSpaceEx, HvFlushVirtualAddressListEx hypercalls */
+struct hv_tlb_flush_ex {
+	u64 address_space;
+	u64 flags;
+	struct hv_vpset hv_vp_set;
+	u64 gva_list[];
+} __packed;
+
+struct ms_hyperv_tsc_page {	 /* HV_REFERENCE_TSC_PAGE */
+	volatile u32 tsc_sequence;
+	u32 reserved1;
+	volatile u64 tsc_scale;
+	volatile s64 tsc_offset;
+} __packed;
+
+/* Define the number of synthetic interrupt sources. */
+#define HV_SYNIC_SINT_COUNT (16)
+
+/* Define the expected SynIC version. */
+#define HV_SYNIC_VERSION_1		(0x1)
+/* Valid SynIC vectors are 16-255. */
+#define HV_SYNIC_FIRST_VALID_VECTOR	(16)
+
+#define HV_SYNIC_CONTROL_ENABLE		(1ULL << 0)
+#define HV_SYNIC_SIMP_ENABLE		(1ULL << 0)
+#define HV_SYNIC_SIEFP_ENABLE		(1ULL << 0)
+#define HV_SYNIC_SINT_MASKED		(1ULL << 16)
+#define HV_SYNIC_SINT_AUTO_EOI		(1ULL << 17)
+#define HV_SYNIC_SINT_VECTOR_MASK	(0xFF)
+
+#
+
+/* Hyper-V defined statically assigned SINTs */
+#define HV_SYNIC_INTERCEPTION_SINT_INDEX 0x00000000
+#define HV_SYNIC_IOMMU_FAULT_SINT_INDEX  0x00000001
+#define HV_SYNIC_VMBUS_SINT_INDEX	 0x00000002
+#define HV_SYNIC_FIRST_UNUSED_SINT_INDEX 0x00000005
+
+/* mshv assigned SINT for doorbell */
+#define HV_SYNIC_DOORBELL_SINT_INDEX     HV_SYNIC_FIRST_UNUSED_SINT_INDEX
+
+enum hv_interrupt_type {
+	HV_X64_INTERRUPT_TYPE_FIXED		= 0x0000,
+	HV_X64_INTERRUPT_TYPE_LOWESTPRIORITY	= 0x0001,
+	HV_X64_INTERRUPT_TYPE_SMI		= 0x0002,
+	HV_X64_INTERRUPT_TYPE_REMOTEREAD	= 0x0003,
+	HV_X64_INTERRUPT_TYPE_NMI		= 0x0004,
+	HV_X64_INTERRUPT_TYPE_INIT		= 0x0005,
+	HV_X64_INTERRUPT_TYPE_SIPI		= 0x0006,
+	HV_X64_INTERRUPT_TYPE_EXTINT		= 0x0007,
+	HV_X64_INTERRUPT_TYPE_LOCALINT0		= 0x0008,
+	HV_X64_INTERRUPT_TYPE_LOCALINT1		= 0x0009,
+	HV_X64_INTERRUPT_TYPE_MAXIMUM		= 0x000A,
+};
+
+/* Define synthetic interrupt source. */
+union hv_synic_sint {
+	u64 as_uint64;
+	struct {
+		u64 vector : 8;
+		u64 reserved1 : 8;
+		u64 masked : 1;
+		u64 auto_eoi : 1;
+		u64 polling : 1;
+		u64 as_intercept : 1;
+		u64 proxy : 1;
+		u64 reserved2 : 43;
+	} __packed;
+};
+
+union hv_x64_xsave_xfem_register {
+	u64 as_uint64;
+	struct {
+		u32 low_uint32;
+		u32 high_uint32;
+	} __packed;
+	struct {
+		u64 legacy_x87 : 1;
+		u64 legacy_sse : 1;
+		u64 avx : 1;
+		u64 mpx_bndreg : 1;
+		u64 mpx_bndcsr : 1;
+		u64 avx_512_op_mask : 1;
+		u64 avx_512_zmmhi : 1;
+		u64 avx_512_zmm16_31 : 1;
+		u64 rsvd8_9 : 2;
+		u64 pasid : 1;
+		u64 cet_u : 1;
+		u64 cet_s : 1;
+		u64 rsvd13_16 : 4;
+		u64 xtile_cfg : 1;
+		u64 xtile_data : 1;
+		u64 rsvd19_63 : 45;
+	} __packed;
+};
+
+/* Synthetic timer configuration */
+union hv_stimer_config {	 /* HV_X64_MSR_STIMER_CONFIG_CONTENTS */
+	u64 as_uint64;
+	struct {
+		u64 enable : 1;
+		u64 periodic : 1;
+		u64 lazy : 1;
+		u64 auto_enable : 1;
+		u64 apic_vector : 8;
+		u64 direct_mode : 1;
+		u64 reserved_z0 : 3;
+		u64 sintx : 4;
+		u64 reserved_z1 : 44;
+	} __packed;
+};
+
+/* Define the number of synthetic timers */
+#define HV_SYNIC_STIMER_COUNT	(4)
+
+/* Define port identifier type. */
+union hv_port_id {
+	u32 asu32;
+	struct {
+		u32 id : 24;
+		u32 reserved : 8;
+	} __packed u;
+};
+
+#define HV_MESSAGE_SIZE			(256)
+#define HV_MESSAGE_PAYLOAD_BYTE_COUNT	(240)
+#define HV_MESSAGE_PAYLOAD_QWORD_COUNT	(30)
+
+/* Define hypervisor message types. */
+enum hv_message_type {
+	HVMSG_NONE				= 0x00000000,
+
+	/* Memory access messages. */
+	HVMSG_UNMAPPED_GPA			= 0x80000000,
+	HVMSG_GPA_INTERCEPT			= 0x80000001,
+
+	/* Timer notification messages. */
+	HVMSG_TIMER_EXPIRED			= 0x80000010,
+
+	/* Error messages. */
+	HVMSG_INVALID_VP_REGISTER_VALUE		= 0x80000020,
+	HVMSG_UNRECOVERABLE_EXCEPTION		= 0x80000021,
+	HVMSG_UNSUPPORTED_FEATURE		= 0x80000022,
+
+	/*
+	 * Opaque intercept message. The original intercept message is only
+	 * accessible from the mapped intercept message page.
+	 */
+	HVMSG_OPAQUE_INTERCEPT			= 0x8000003F,
+
+	/* Trace buffer complete messages. */
+	HVMSG_EVENTLOG_BUFFERCOMPLETE		= 0x80000040,
+
+	/* Hypercall intercept */
+	HVMSG_HYPERCALL_INTERCEPT		= 0x80000050,
+
+	/* SynIC intercepts */
+	HVMSG_SYNIC_EVENT_INTERCEPT		= 0x80000060,
+	HVMSG_SYNIC_SINT_INTERCEPT		= 0x80000061,
+	HVMSG_SYNIC_SINT_DELIVERABLE	= 0x80000062,
+
+	/* Async call completion intercept */
+	HVMSG_ASYNC_CALL_COMPLETION		= 0x80000070,
+
+	/* Root scheduler messages */
+	HVMSG_SCHEDULER_VP_SIGNAL_BITSET	= 0x80000100,
+	HVMSG_SCHEDULER_VP_SIGNAL_PAIR		= 0x80000101,
+
+	/* Platform-specific processor intercept messages. */
+	HVMSG_X64_IO_PORT_INTERCEPT		= 0x80010000,
+	HVMSG_X64_MSR_INTERCEPT			= 0x80010001,
+	HVMSG_X64_CPUID_INTERCEPT		= 0x80010002,
+	HVMSG_X64_EXCEPTION_INTERCEPT		= 0x80010003,
+	HVMSG_X64_APIC_EOI			= 0x80010004,
+	HVMSG_X64_LEGACY_FP_ERROR		= 0x80010005,
+	HVMSG_X64_IOMMU_PRQ			= 0x80010006,
+	HVMSG_X64_HALT				= 0x80010007,
+	HVMSG_X64_INTERRUPTION_DELIVERABLE	= 0x80010008,
+	HVMSG_X64_SIPI_INTERCEPT		= 0x80010009,
+};
+
+/* Define the format of the SIMP register */
+union hv_synic_simp {
+	u64 as_uint64;
+	struct {
+		u64 simp_enabled : 1;
+		u64 preserved : 11;
+		u64 base_simp_gpa : 52;
+	} __packed;
+};
+
+union hv_message_flags {
+	u8 asu8;
+	struct {
+		u8 msg_pending : 1;
+		u8 reserved : 7;
+	} __packed;
+};
+
+struct hv_message_header {
+	u32 message_type;
+	u8 payload_size;
+	union hv_message_flags message_flags;
+	u8 reserved[2];
+	union {
+		u64 sender;
+		union hv_port_id port;
+	};
+} __packed;
+
+/*
+ * Message format for notifications delivered via
+ * intercept message(as_intercept=1)
+ */
+struct hv_notification_message_payload {
+	u32 sint_index;
+} __packed;
+
+struct hv_message {
+	struct hv_message_header header;
+	union {
+		u64 payload[HV_MESSAGE_PAYLOAD_QWORD_COUNT];
+	} u;
+} __packed;
+
+/* Define the synthetic interrupt message page layout. */
+struct hv_message_page {
+	struct hv_message sint_message[HV_SYNIC_SINT_COUNT];
+} __packed;
+
+/* Define timer message payload structure. */
+struct hv_timer_message_payload {
+	__u32 timer_index;
+	__u32 reserved;
+	__u64 expiration_time;	/* When the timer expired */
+	__u64 delivery_time;	/* When the message was delivered */
+} __packed;
+
+struct hv_x64_segment_register {
+	u64 base;
+	u32 limit;
+	u16 selector;
+	union {
+		struct {
+			u16 segment_type : 4;
+			u16 non_system_segment : 1;
+			u16 descriptor_privilege_level : 2;
+			u16 present : 1;
+			u16 reserved : 4;
+			u16 available : 1;
+			u16 _long : 1;
+			u16 _default : 1;
+			u16 granularity : 1;
+		} __packed;
+		u16 attributes;
+	};
+} __packed;
+
+struct hv_x64_table_register {
+	u16 pad[3];
+	u16 limit;
+	u64 base;
+} __packed;
+
+union hv_input_vtl {
+	u8 as_uint8;
+	struct {
+		u8 target_vtl : 4;
+		u8 use_target_vtl : 1;
+		u8 reserved_z : 3;
+	};
+} __packed;
+
+struct hv_init_vp_context {
+	u64 rip;
+	u64 rsp;
+	u64 rflags;
+
+	struct hv_x64_segment_register cs;
+	struct hv_x64_segment_register ds;
+	struct hv_x64_segment_register es;
+	struct hv_x64_segment_register fs;
+	struct hv_x64_segment_register gs;
+	struct hv_x64_segment_register ss;
+	struct hv_x64_segment_register tr;
+	struct hv_x64_segment_register ldtr;
+
+	struct hv_x64_table_register idtr;
+	struct hv_x64_table_register gdtr;
+
+	u64 efer;
+	u64 cr0;
+	u64 cr3;
+	u64 cr4;
+	u64 msr_cr_pat;
+} __packed;
+
+struct hv_enable_vp_vtl {
+	u64				partition_id;
+	u32				vp_index;
+	union hv_input_vtl		target_vtl;
+	u8				mbz0;
+	u16				mbz1;
+	struct hv_init_vp_context	vp_context;
+} __packed;
+
+struct hv_get_vp_from_apic_id_in {
+	u64 partition_id;
+	union hv_input_vtl target_vtl;
+	u8 res[7];
+	u32 apic_ids[];
+} __packed;
+
+struct hv_nested_enlightenments_control {
+	struct {
+		u32 directhypercall : 1;
+		u32 reserved : 31;
+	} __packed features;
+	struct {
+		u32 inter_partition_comm : 1;
+		u32 reserved : 31;
+	} __packed hypercall_controls;
+} __packed;
+
+/* Define virtual processor assist page structure. */
+struct hv_vp_assist_page {
+	u32 apic_assist;
+	u32 reserved1;
+	u32 vtl_entry_reason;
+	u32 vtl_reserved;
+	u64 vtl_ret_x64rax;
+	u64 vtl_ret_x64rcx;
+	struct hv_nested_enlightenments_control nested_control;
+	u8 enlighten_vmentry;
+	u8 reserved2[7];
+	u64 current_nested_vmcs;
+	u8 synthetic_time_unhalted_timer_expired;
+	u8 reserved3[7];
+	u8 virtualization_fault_information[40];
+	u8 reserved4[8];
+	u8 intercept_message[256];
+	u8 vtl_ret_actions[256];
+} __packed;
+
+enum hv_register_name {
+	/* Suspend Registers */
+	HV_REGISTER_EXPLICIT_SUSPEND				= 0x00000000,
+	HV_REGISTER_INTERCEPT_SUSPEND				= 0x00000001,
+	HV_REGISTER_DISPATCH_SUSPEND				= 0x00000003,
+
+	/* Version - 128-bit result same as CPUID 0x40000002 */
+	HV_REGISTER_HYPERVISOR_VERSION				= 0x00000100,
+
+	/* Feature Access (registers are 128 bits) - same as CPUID 0x40000003 - 0x4000000B */
+	HV_REGISTER_PRIVILEGES_AND_FEATURES_INFO		= 0x00000200,
+	HV_REGISTER_FEATURES_INFO				= 0x00000201,
+	HV_REGISTER_IMPLEMENTATION_LIMITS_INFO			= 0x00000202,
+	HV_REGISTER_HARDWARE_FEATURES_INFO			= 0x00000203,
+	HV_REGISTER_CPU_MANAGEMENT_FEATURES_INFO		= 0x00000204,
+	HV_REGISTER_SVM_FEATURES_INFO				= 0x00000205,
+	HV_REGISTER_SKIP_LEVEL_FEATURES_INFO			= 0x00000206,
+	HV_REGISTER_NESTED_VIRT_FEATURES_INFO			= 0x00000207,
+	HV_REGISTER_IPT_FEATURES_INFO				= 0x00000208,
+
+	/* Guest Crash Registers */
+	HV_REGISTER_GUEST_CRASH_P0				= 0x00000210,
+	HV_REGISTER_GUEST_CRASH_P1				= 0x00000211,
+	HV_REGISTER_GUEST_CRASH_P2				= 0x00000212,
+	HV_REGISTER_GUEST_CRASH_P3				= 0x00000213,
+	HV_REGISTER_GUEST_CRASH_P4				= 0x00000214,
+	HV_REGISTER_GUEST_CRASH_CTL				= 0x00000215,
+
+	/* Misc */
+	HV_REGISTER_VP_RUNTIME					= 0x00090000,
+	HV_REGISTER_GUEST_OS_ID					= 0x00090002,
+	HV_REGISTER_VP_INDEX					= 0x00090003,
+	HV_REGISTER_TIME_REF_COUNT				= 0x00090004,
+	HV_REGISTER_CPU_MANAGEMENT_VERSION			= 0x00090007,
+	HV_REGISTER_VP_ASSIST_PAGE				= 0x00090013,
+	HV_REGISTER_VP_ROOT_SIGNAL_COUNT			= 0x00090014,
+	HV_REGISTER_REFERENCE_TSC				= 0x00090017,
+
+	/* Hypervisor-defined Registers (Synic) */
+	HV_REGISTER_SINT0					= 0x000A0000,
+	HV_REGISTER_SINT1					= 0x000A0001,
+	HV_REGISTER_SINT2					= 0x000A0002,
+	HV_REGISTER_SINT3					= 0x000A0003,
+	HV_REGISTER_SINT4					= 0x000A0004,
+	HV_REGISTER_SINT5					= 0x000A0005,
+	HV_REGISTER_SINT6					= 0x000A0006,
+	HV_REGISTER_SINT7					= 0x000A0007,
+	HV_REGISTER_SINT8					= 0x000A0008,
+	HV_REGISTER_SINT9					= 0x000A0009,
+	HV_REGISTER_SINT10					= 0x000A000A,
+	HV_REGISTER_SINT11					= 0x000A000B,
+	HV_REGISTER_SINT12					= 0x000A000C,
+	HV_REGISTER_SINT13					= 0x000A000D,
+	HV_REGISTER_SINT14					= 0x000A000E,
+	HV_REGISTER_SINT15					= 0x000A000F,
+	HV_REGISTER_SCONTROL					= 0x000A0010,
+	HV_REGISTER_SVERSION					= 0x000A0011,
+	HV_REGISTER_SIEFP					= 0x000A0012,
+	HV_REGISTER_SIMP					= 0x000A0013,
+	HV_REGISTER_EOM						= 0x000A0014,
+	HV_REGISTER_SIRBP					= 0x000A0015,
+
+	HV_REGISTER_NESTED_SINT0				= 0x000A1000,
+	HV_REGISTER_NESTED_SINT1				= 0x000A1001,
+	HV_REGISTER_NESTED_SINT2				= 0x000A1002,
+	HV_REGISTER_NESTED_SINT3				= 0x000A1003,
+	HV_REGISTER_NESTED_SINT4				= 0x000A1004,
+	HV_REGISTER_NESTED_SINT5				= 0x000A1005,
+	HV_REGISTER_NESTED_SINT6				= 0x000A1006,
+	HV_REGISTER_NESTED_SINT7				= 0x000A1007,
+	HV_REGISTER_NESTED_SINT8				= 0x000A1008,
+	HV_REGISTER_NESTED_SINT9				= 0x000A1009,
+	HV_REGISTER_NESTED_SINT10				= 0x000A100A,
+	HV_REGISTER_NESTED_SINT11				= 0x000A100B,
+	HV_REGISTER_NESTED_SINT12				= 0x000A100C,
+	HV_REGISTER_NESTED_SINT13				= 0x000A100D,
+	HV_REGISTER_NESTED_SINT14				= 0x000A100E,
+	HV_REGISTER_NESTED_SINT15				= 0x000A100F,
+	HV_REGISTER_NESTED_SCONTROL				= 0x000A1010,
+	HV_REGISTER_NESTED_SVERSION				= 0x000A1011,
+	HV_REGISTER_NESTED_SIFP					= 0x000A1012,
+	HV_REGISTER_NESTED_SIPP					= 0x000A1013,
+	HV_REGISTER_NESTED_EOM					= 0x000A1014,
+	HV_REGISTER_NESTED_SIRBP				= 0x000a1015,
+
+	/* Hypervisor-defined Registers (Synthetic Timers) */
+	HV_REGISTER_STIMER0_CONFIG				= 0x000B0000,
+	HV_REGISTER_STIMER0_COUNT				= 0x000B0001,
+
+	/* VSM */
+	HV_X64_REGISTER_VSM_VP_STATUS				= 0x000D0003,
+};
+
+/*
+ * Arch compatibility regs for use with hv_set/get_register
+ */
+#if defined(CONFIG_X86)
+
+/*
+ * To support arch-generic code calling hv_set/get_register:
+ * - On x86, HV_MSR_ indicates an MSR accessed via rdmsrl/wrmsrl
+ * - On ARM, HV_MSR_ indicates a VP register accessed via hypercall
+ */
+#define HV_MSR_CRASH_P0		(HV_X64_MSR_CRASH_P0)
+#define HV_MSR_CRASH_P1		(HV_X64_MSR_CRASH_P1)
+#define HV_MSR_CRASH_P2		(HV_X64_MSR_CRASH_P2)
+#define HV_MSR_CRASH_P3		(HV_X64_MSR_CRASH_P3)
+#define HV_MSR_CRASH_P4		(HV_X64_MSR_CRASH_P4)
+#define HV_MSR_CRASH_CTL	(HV_X64_MSR_CRASH_CTL)
+
+#define HV_MSR_VP_INDEX		(HV_X64_MSR_VP_INDEX)
+#define HV_MSR_TIME_REF_COUNT	(HV_X64_MSR_TIME_REF_COUNT)
+#define HV_MSR_REFERENCE_TSC	(HV_X64_MSR_REFERENCE_TSC)
+
+#define HV_MSR_SINT0		(HV_X64_MSR_SINT0)
+#define HV_MSR_SVERSION		(HV_X64_MSR_SVERSION)
+#define HV_MSR_SCONTROL		(HV_X64_MSR_SCONTROL)
+#define HV_MSR_SIEFP		(HV_X64_MSR_SIEFP)
+#define HV_MSR_SIMP		(HV_X64_MSR_SIMP)
+#define HV_MSR_EOM		(HV_X64_MSR_EOM)
+#define HV_MSR_SIRBP		(HV_X64_MSR_SIRBP)
+
+#define HV_MSR_NESTED_SCONTROL	(HV_X64_MSR_NESTED_SCONTROL)
+#define HV_MSR_NESTED_SVERSION	(HV_X64_MSR_NESTED_SVERSION)
+#define HV_MSR_NESTED_SIEFP	(HV_X64_MSR_NESTED_SIEFP)
+#define HV_MSR_NESTED_SIMP	(HV_X64_MSR_NESTED_SIMP)
+#define HV_MSR_NESTED_EOM	(HV_X64_MSR_NESTED_EOM)
+#define HV_MSR_NESTED_SINT0	(HV_X64_MSR_NESTED_SINT0)
+
+#define HV_MSR_STIMER0_CONFIG	(HV_X64_MSR_STIMER0_CONFIG)
+#define HV_MSR_STIMER0_COUNT	(HV_X64_MSR_STIMER0_COUNT)
+
+#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
+
+#define HV_MSR_CRASH_P0		(HV_REGISTER_GUEST_CRASH_P0)
+#define HV_MSR_CRASH_P1		(HV_REGISTER_GUEST_CRASH_P1)
+#define HV_MSR_CRASH_P2		(HV_REGISTER_GUEST_CRASH_P2)
+#define HV_MSR_CRASH_P3		(HV_REGISTER_GUEST_CRASH_P3)
+#define HV_MSR_CRASH_P4		(HV_REGISTER_GUEST_CRASH_P4)
+#define HV_MSR_CRASH_CTL	(HV_REGISTER_GUEST_CRASH_CTL)
+
+#define HV_MSR_VP_INDEX		(HV_REGISTER_VP_INDEX)
+#define HV_MSR_TIME_REF_COUNT	(HV_REGISTER_TIME_REF_COUNT)
+#define HV_MSR_REFERENCE_TSC	(HV_REGISTER_REFERENCE_TSC)
+
+#define HV_MSR_SINT0		(HV_REGISTER_SINT0)
+#define HV_MSR_SCONTROL		(HV_REGISTER_SCONTROL)
+#define HV_MSR_SIEFP		(HV_REGISTER_SIEFP)
+#define HV_MSR_SIMP		(HV_REGISTER_SIMP)
+#define HV_MSR_EOM		(HV_REGISTER_EOM)
+#define HV_MSR_SIRBP		(HV_REGISTER_SIRBP)
+
+#define HV_MSR_STIMER0_CONFIG	(HV_REGISTER_STIMER0_CONFIG)
+#define HV_MSR_STIMER0_COUNT	(HV_REGISTER_STIMER0_COUNT)
+
+#endif /* CONFIG_ARM64 */
+
+union hv_explicit_suspend_register {
+	u64 as_uint64;
+	struct {
+		u64 suspended : 1;
+		u64 reserved : 63;
+	} __packed;
+};
+
+union hv_intercept_suspend_register {
+	u64 as_uint64;
+	struct {
+		u64 suspended : 1;
+		u64 reserved : 63;
+	} __packed;
+};
+
+union hv_dispatch_suspend_register {
+	u64 as_uint64;
+	struct {
+		u64 suspended : 1;
+		u64 reserved : 63;
+	} __packed;
+};
+
+union hv_x64_interrupt_state_register {
+	u64 as_uint64;
+	struct {
+		u64 interrupt_shadow : 1;
+		u64 nmi_masked : 1;
+		u64 reserved : 62;
+	} __packed;
+};
+
+union hv_x64_pending_interruption_register {
+	u64 as_uint64;
+	struct {
+		u32 interruption_pending : 1;
+		u32 interruption_type : 3;
+		u32 deliver_error_code : 1;
+		u32 instruction_length : 4;
+		u32 nested_event : 1;
+		u32 reserved : 6;
+		u32 interruption_vector : 16;
+		u32 error_code;
+	} __packed;
+};
+
+union hv_register_value {
+	struct hv_u128 reg128;
+	u64 reg64;
+	u32 reg32;
+	u16 reg16;
+	u8 reg8;
+
+	struct hv_x64_segment_register segment;
+	struct hv_x64_table_register table;
+	union hv_explicit_suspend_register explicit_suspend;
+	union hv_intercept_suspend_register intercept_suspend;
+	union hv_dispatch_suspend_register dispatch_suspend;
+	union hv_x64_interrupt_state_register interrupt_state;
+	union hv_x64_pending_interruption_register pending_interruption;
+};
+
+#if defined(CONFIG_ARM64)
+/* HvGetVpRegisters returns an array of these output elements */
+struct hv_get_vp_registers_output {
+	union {
+		struct {
+			u32 a;
+			u32 b;
+			u32 c;
+			u32 d;
+		} as32 __packed;
+		struct {
+			u64 low;
+			u64 high;
+		} as64 __packed;
+	};
+};
+
+#endif /* CONFIG_ARM64 */
+
+struct hv_register_assoc {
+	u32 name;			/* enum hv_register_name */
+	u32 reserved1;
+	u64 reserved2;
+	union hv_register_value value;
+} __packed;
+
+struct hv_input_get_vp_registers {
+	u64 partition_id;
+	u32 vp_index;
+	union hv_input_vtl input_vtl;
+	u8  rsvd_z8;
+	u16 rsvd_z16;
+	u32 names[];
+} __packed;
+
+struct hv_input_set_vp_registers {
+	u64 partition_id;
+	u32 vp_index;
+	union hv_input_vtl input_vtl;
+	u8  rsvd_z8;
+	u16 rsvd_z16;
+	struct hv_register_assoc elements[];
+} __packed;
+
+#define HV_UNMAP_GPA_LARGE_PAGE		0x2
+
+/* HvCallSendSyntheticClusterIpi hypercall */
+struct hv_send_ipi {	 /* HV_INPUT_SEND_SYNTHETIC_CLUSTER_IPI */
+	u32 vector;
+	u32 reserved;
+	u64 cpu_mask;
+} __packed;
+
+#define	HV_X64_VTL_MASK			GENMASK(3, 0)
+
+/* Hyper-V memory host visibility */
+enum hv_mem_host_visibility {
+	VMBUS_PAGE_NOT_VISIBLE		= 0,
+	VMBUS_PAGE_VISIBLE_READ_ONLY	= 1,
+	VMBUS_PAGE_VISIBLE_READ_WRITE	= 3
+};
+
+/* HvCallModifySparseGpaPageHostVisibility hypercall */
+#define HV_MAX_MODIFY_GPA_REP_COUNT	((HV_HYP_PAGE_SIZE / sizeof(u64)) - 2)
+struct hv_gpa_range_for_visibility {
+	u64 partition_id;
+	u32 host_visibility : 2;
+	u32 reserved0 : 30;
+	u32 reserved1;
+	u64 gpa_page_list[HV_MAX_MODIFY_GPA_REP_COUNT];
+} __packed;
+
+#if defined(CONFIG_X86)
+union hv_msi_address_register { /* HV_MSI_ADDRESS */
+	u32 as_uint32;
+	struct {
+		u32 reserved1 : 2;
+		u32 destination_mode : 1;
+		u32 redirection_hint : 1;
+		u32 reserved2 : 8;
+		u32 destination_id : 8;
+		u32 msi_base : 12;
+	};
+} __packed;
+
+union hv_msi_data_register {	 /* HV_MSI_ENTRY.Data */
+	u32 as_uint32;
+	struct {
+		u32 vector : 8;
+		u32 delivery_mode : 3;
+		u32 reserved1 : 3;
+		u32 level_assert : 1;
+		u32 trigger_mode : 1;
+		u32 reserved2 : 16;
+	};
+} __packed;
+
+union hv_msi_entry {	 /* HV_MSI_ENTRY */
+
+	u64 as_uint64;
+	struct {
+		union hv_msi_address_register address;
+		union hv_msi_data_register data;
+	} __packed;
+};
+
+#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
+
+union hv_msi_entry {
+	u64 as_uint64[2];
+	struct {
+		u64 address;
+		u32 data;
+		u32 reserved;
+	} __packed;
+};
+#endif /* CONFIG_ARM64 */
+
+union hv_ioapic_rte {
+	u64 as_uint64;
+
+	struct {
+		u32 vector : 8;
+		u32 delivery_mode : 3;
+		u32 destination_mode : 1;
+		u32 delivery_status : 1;
+		u32 interrupt_polarity : 1;
+		u32 remote_irr : 1;
+		u32 trigger_mode : 1;
+		u32 interrupt_mask : 1;
+		u32 reserved1 : 15;
+
+		u32 reserved2 : 24;
+		u32 destination_id : 8;
+	};
+
+	struct {
+		u32 low_uint32;
+		u32 high_uint32;
+	};
+} __packed;
+
+enum hv_interrupt_source {	 /* HV_INTERRUPT_SOURCE */
+	HV_INTERRUPT_SOURCE_MSI = 1, /* MSI and MSI-X */
+	HV_INTERRUPT_SOURCE_IOAPIC,
+};
+
+struct hv_interrupt_entry {	 /* HV_INTERRUPT_ENTRY */
+	u32 source;
+	u32 reserved1;
+	union {
+		union hv_msi_entry msi_entry;
+		union hv_ioapic_rte ioapic_rte;
+	};
+} __packed;
+
+#define HV_DEVICE_INTERRUPT_TARGET_MULTICAST		1
+#define HV_DEVICE_INTERRUPT_TARGET_PROCESSOR_SET	2
+
+struct hv_device_interrupt_target {	 /* HV_DEVICE_INTERRUPT_TARGET */
+	u32 vector;
+	u32 flags;		/* HV_DEVICE_INTERRUPT_TARGET_* above */
+	union {
+		u64 vp_mask;
+		struct hv_vpset vp_set;
+	};
+} __packed;
+
+struct hv_retarget_device_interrupt {	 /* HV_INPUT_RETARGET_DEVICE_INTERRUPT */
+	u64 partition_id;		/* use "self" */
+	u64 device_id;
+	struct hv_interrupt_entry int_entry;
+	u64 reserved2;
+	struct hv_device_interrupt_target int_target;
+} __packed __aligned(8);
+
+/* Data structures for HVCALL_MMIO_READ and HVCALL_MMIO_WRITE */
+#define HV_HYPERCALL_MMIO_MAX_DATA_LENGTH 64
+
+struct hv_mmio_read_input { /* HV_INPUT_MEMORY_MAPPED_IO_READ */
+	u64 gpa;
+	u32 size;
+	u32 reserved;
+} __packed;
+
+struct hv_mmio_read_output {
+	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
+} __packed;
+
+struct hv_mmio_write_input {
+	u64 gpa;
+	u32 size;
+	u32 reserved;
+	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
+} __packed;
+
+#endif /* _HV_HVGDK_MINI_H */
diff --git a/include/hyperv/hvhdk.h b/include/hyperv/hvhdk.h
new file mode 100644
index 000000000000..64407c2a3809
--- /dev/null
+++ b/include/hyperv/hvhdk.h
@@ -0,0 +1,733 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Type definitions for the Microsoft hypervisor.
+ */
+#ifndef _HV_HVHDK_H
+#define _HV_HVHDK_H
+
+#include <linux/build_bug.h>
+
+#include "hvhdk_mini.h"
+#include "hvgdk.h"
+
+/* Bits for dirty mask of hv_vp_register_page */
+#define HV_X64_REGISTER_CLASS_GENERAL	0
+#define HV_X64_REGISTER_CLASS_IP	1
+#define HV_X64_REGISTER_CLASS_XMM	2
+#define HV_X64_REGISTER_CLASS_SEGMENT	3
+#define HV_X64_REGISTER_CLASS_FLAGS	4
+
+#define HV_VP_REGISTER_PAGE_VERSION_1	1u
+
+struct hv_vp_register_page {
+	u16 version;
+	u8 isvalid;
+	u8 rsvdz;
+	u32 dirty;
+	union {
+		struct {
+			/* General purpose registers
+			 * (HV_X64_REGISTER_CLASS_GENERAL)
+			 */
+			union {
+				struct {
+					u64 rax;
+					u64 rcx;
+					u64 rdx;
+					u64 rbx;
+					u64 rsp;
+					u64 rbp;
+					u64 rsi;
+					u64 rdi;
+					u64 r8;
+					u64 r9;
+					u64 r10;
+					u64 r11;
+					u64 r12;
+					u64 r13;
+					u64 r14;
+					u64 r15;
+				} __packed;
+
+				u64 gp_registers[16];
+			};
+			/* Instruction pointer (HV_X64_REGISTER_CLASS_IP) */
+			u64 rip;
+			/* Flags (HV_X64_REGISTER_CLASS_FLAGS) */
+			u64 rflags;
+		} __packed;
+
+		u64 registers[18];
+	};
+	/* Volatile XMM registers (HV_X64_REGISTER_CLASS_XMM) */
+	union {
+		struct {
+			struct hv_u128 xmm0;
+			struct hv_u128 xmm1;
+			struct hv_u128 xmm2;
+			struct hv_u128 xmm3;
+			struct hv_u128 xmm4;
+			struct hv_u128 xmm5;
+		} __packed;
+
+		struct hv_u128 xmm_registers[6];
+	};
+	/* Segment registers (HV_X64_REGISTER_CLASS_SEGMENT) */
+	union {
+		struct {
+			struct hv_x64_segment_register es;
+			struct hv_x64_segment_register cs;
+			struct hv_x64_segment_register ss;
+			struct hv_x64_segment_register ds;
+			struct hv_x64_segment_register fs;
+			struct hv_x64_segment_register gs;
+		} __packed;
+
+		struct hv_x64_segment_register segment_registers[6];
+	};
+	/* Misc. control registers (cannot be set via this interface) */
+	u64 cr0;
+	u64 cr3;
+	u64 cr4;
+	u64 cr8;
+	u64 efer;
+	u64 dr7;
+	union hv_x64_pending_interruption_register pending_interruption;
+	union hv_x64_interrupt_state_register interrupt_state;
+	u64 instruction_emulation_hints;
+} __packed;
+
+#define HV_PARTITION_PROCESSOR_FEATURES_BANKS 2
+
+union hv_partition_processor_features {
+	u64 as_uint64[HV_PARTITION_PROCESSOR_FEATURES_BANKS];
+	struct {
+		u64 sse3_support : 1;
+		u64 lahf_sahf_support : 1;
+		u64 ssse3_support : 1;
+		u64 sse4_1_support : 1;
+		u64 sse4_2_support : 1;
+		u64 sse4a_support : 1;
+		u64 xop_support : 1;
+		u64 pop_cnt_support : 1;
+		u64 cmpxchg16b_support : 1;
+		u64 altmovcr8_support : 1;
+		u64 lzcnt_support : 1;
+		u64 mis_align_sse_support : 1;
+		u64 mmx_ext_support : 1;
+		u64 amd3dnow_support : 1;
+		u64 extended_amd3dnow_support : 1;
+		u64 page_1gb_support : 1;
+		u64 aes_support : 1;
+		u64 pclmulqdq_support : 1;
+		u64 pcid_support : 1;
+		u64 fma4_support : 1;
+		u64 f16c_support : 1;
+		u64 rd_rand_support : 1;
+		u64 rd_wr_fs_gs_support : 1;
+		u64 smep_support : 1;
+		u64 enhanced_fast_string_support : 1;
+		u64 bmi1_support : 1;
+		u64 bmi2_support : 1;
+		u64 hle_support_deprecated : 1;
+		u64 rtm_support_deprecated : 1;
+		u64 movbe_support : 1;
+		u64 npiep1_support : 1;
+		u64 dep_x87_fpu_save_support : 1;
+		u64 rd_seed_support : 1;
+		u64 adx_support : 1;
+		u64 intel_prefetch_support : 1;
+		u64 smap_support : 1;
+		u64 hle_support : 1;
+		u64 rtm_support : 1;
+		u64 rdtscp_support : 1;
+		u64 clflushopt_support : 1;
+		u64 clwb_support : 1;
+		u64 sha_support : 1;
+		u64 x87_pointers_saved_support : 1;
+		u64 invpcid_support : 1;
+		u64 ibrs_support : 1;
+		u64 stibp_support : 1;
+		u64 ibpb_support: 1;
+		u64 unrestricted_guest_support : 1;
+		u64 mdd_support : 1;
+		u64 fast_short_rep_mov_support : 1;
+		u64 l1dcache_flush_support : 1;
+		u64 rdcl_no_support : 1;
+		u64 ibrs_all_support : 1;
+		u64 skip_l1df_support : 1;
+		u64 ssb_no_support : 1;
+		u64 rsb_a_no_support : 1;
+		u64 virt_spec_ctrl_support : 1;
+		u64 rd_pid_support : 1;
+		u64 umip_support : 1;
+		u64 mbs_no_support : 1;
+		u64 mb_clear_support : 1;
+		u64 taa_no_support : 1;
+		u64 tsx_ctrl_support : 1;
+		/*
+		 * N.B. The final processor feature bit in bank 0 is reserved to
+		 * simplify potential downlevel backports.
+		 */
+		u64 reserved_bank0 : 1;
+
+		/* N.B. Begin bank 1 processor features. */
+		u64 acount_mcount_support : 1;
+		u64 tsc_invariant_support : 1;
+		u64 cl_zero_support : 1;
+		u64 rdpru_support : 1;
+		u64 la57_support : 1;
+		u64 mbec_support : 1;
+		u64 nested_virt_support : 1;
+		u64 psfd_support : 1;
+		u64 cet_ss_support : 1;
+		u64 cet_ibt_support : 1;
+		u64 vmx_exception_inject_support : 1;
+		u64 enqcmd_support : 1;
+		u64 umwait_tpause_support : 1;
+		u64 movdiri_support : 1;
+		u64 movdir64b_support : 1;
+		u64 cldemote_support : 1;
+		u64 serialize_support : 1;
+		u64 tsc_deadline_tmr_support : 1;
+		u64 tsc_adjust_support : 1;
+		u64 fzlrep_movsb : 1;
+		u64 fsrep_stosb : 1;
+		u64 fsrep_cmpsb : 1;
+		u64 reserved_bank1 : 42;
+	} __packed;
+};
+
+union hv_partition_processor_xsave_features {
+	struct {
+		u64 xsave_support : 1;
+		u64 xsaveopt_support : 1;
+		u64 avx_support : 1;
+		u64 reserved1 : 61;
+	} __packed;
+	u64 as_uint64;
+};
+
+struct hv_partition_creation_properties {
+	union hv_partition_processor_features disabled_processor_features;
+	union hv_partition_processor_xsave_features
+		disabled_processor_xsave_features;
+} __packed;
+
+#define HV_PARTITION_SYNTHETIC_PROCESSOR_FEATURES_BANKS 1
+
+union hv_partition_synthetic_processor_features {
+	u64 as_uint64[HV_PARTITION_SYNTHETIC_PROCESSOR_FEATURES_BANKS];
+
+	struct {
+		u64 hypervisor_present : 1;
+		/* Support for HV#1: (CPUID leaves 0x40000000 - 0x40000006)*/
+		u64 hv1 : 1;
+		u64 access_vp_run_time_reg : 1; /* HV_X64_MSR_VP_RUNTIME */
+		u64 access_partition_reference_counter : 1; /* HV_X64_MSR_TIME_REF_COUNT */
+		u64 access_synic_regs : 1; /* SINT-related registers */
+		/*
+		 * Access to HV_X64_MSR_STIMER0_CONFIG through
+		 * HV_X64_MSR_STIMER3_COUNT.
+		 */
+		u64 access_synthetic_timer_regs : 1;
+		u64 access_intr_ctrl_regs : 1; /* APIC MSRs and VP assist page*/
+		/* HV_X64_MSR_GUEST_OS_ID and HV_X64_MSR_HYPERCALL */
+		u64 access_hypercall_regs : 1;
+		u64 access_vp_index : 1;
+		u64 access_partition_reference_tsc : 1;
+		u64 access_guest_idle_reg : 1;
+		u64 access_frequency_regs : 1;
+		u64 reserved_z12 : 1;
+		u64 reserved_z13 : 1;
+		u64 reserved_z14 : 1;
+		u64 enable_extended_gva_ranges_for_flush_virtual_address_list : 1;
+		u64 reserved_z16 : 1;
+		u64 reserved_z17 : 1;
+		/* Use fast hypercall output. Corresponds to privilege. */
+		u64 fast_hypercall_output : 1;
+		u64 reserved_z19 : 1;
+		u64 start_virtual_processor : 1; /* Can start VPs */
+		u64 reserved_z21 : 1;
+		/* Synthetic timers in direct mode. */
+		u64 direct_synthetic_timers : 1;
+		u64 reserved_z23 : 1;
+		u64 extended_processor_masks : 1;
+
+		/* Enable various hypercalls */
+		u64 tb_flush_hypercalls : 1;
+		u64 synthetic_cluster_ipi : 1;
+		u64 notify_long_spin_wait : 1;
+		u64 query_numa_distance : 1;
+		u64 signal_events : 1;
+		u64 retarget_device_interrupt : 1;
+		u64 restore_time : 1;
+
+		/* EnlightenedVmcs nested enlightenment is supported. */
+		u64 enlightened_vmcs : 1;
+		u64 reserved : 31;
+	} __packed;
+};
+
+#define HV_MAKE_COMPATIBILITY_VERSION(major_, minor_)	\
+	((u32)((major_) << 8 | (minor_)))
+
+#define HV_COMPATIBILITY_21_H2		HV_MAKE_COMPATIBILITY_VERSION(0X6, 0X9)
+
+union hv_partition_isolation_properties {
+	u64 as_uint64;
+	struct {
+		u64 isolation_type: 5;
+		u64 isolation_host_type : 2;
+		u64 rsvd_z: 5;
+		u64 shared_gpa_boundary_page_number: 52;
+	} __packed;
+};
+
+/*
+ * Various isolation types supported by MSHV.
+ */
+#define HV_PARTITION_ISOLATION_TYPE_NONE            0
+#define HV_PARTITION_ISOLATION_TYPE_SNP             2
+#define HV_PARTITION_ISOLATION_TYPE_TDX             3
+
+/*
+ * Various host isolation types supported by MSHV.
+ */
+#define HV_PARTITION_ISOLATION_HOST_TYPE_NONE       0x0
+#define HV_PARTITION_ISOLATION_HOST_TYPE_HARDWARE   0x1
+#define HV_PARTITION_ISOLATION_HOST_TYPE_RESERVED   0x2
+
+/* Note: Exo partition is enabled by default */
+#define HV_PARTITION_CREATION_FLAG_EXO_PARTITION                    BIT(8)
+#define HV_PARTITION_CREATION_FLAG_LAPIC_ENABLED                    BIT(13)
+#define HV_PARTITION_CREATION_FLAG_INTERCEPT_MESSAGE_PAGE_ENABLED   BIT(19)
+#define HV_PARTITION_CREATION_FLAG_X2APIC_CAPABLE                   BIT(22)
+
+struct hv_input_create_partition {
+	u64 flags;
+	struct hv_proximity_domain_info proximity_domain_info;
+	u32 compatibility_version;
+	u32 padding;
+	struct hv_partition_creation_properties partition_creation_properties;
+	union hv_partition_isolation_properties isolation_properties;
+} __packed;
+
+struct hv_output_create_partition {
+	u64 partition_id;
+} __packed;
+
+struct hv_input_initialize_partition {
+	u64 partition_id;
+} __packed;
+
+struct hv_input_finalize_partition {
+	u64 partition_id;
+} __packed;
+
+struct hv_input_delete_partition {
+	u64 partition_id;
+} __packed;
+
+struct hv_input_get_partition_property {
+	u64 partition_id;
+	u32 property_code; /* enum hv_partition_property_code */
+	u32 padding;
+} __packed;
+
+struct hv_output_get_partition_property {
+	u64 property_value;
+} __packed;
+
+struct hv_input_set_partition_property {
+	u64 partition_id;
+	u32 property_code; /* enum hv_partition_property_code */
+	u32 padding;
+	u64 property_value;
+} __packed;
+
+enum hv_vp_state_page_type {
+	HV_VP_STATE_PAGE_REGISTERS = 0,
+	HV_VP_STATE_PAGE_INTERCEPT_MESSAGE = 1,
+	HV_VP_STATE_PAGE_COUNT
+};
+
+struct hv_input_map_vp_state_page {
+	u64 partition_id;
+	u32 vp_index;
+	u32 type; /* enum hv_vp_state_page_type */
+} __packed;
+
+struct hv_output_map_vp_state_page {
+	u64 map_location; /* GPA page number */
+} __packed;
+
+struct hv_input_unmap_vp_state_page {
+	u64 partition_id;
+	u32 vp_index;
+	u32 type; /* enum hv_vp_state_page_type */
+} __packed;
+
+struct hv_opaque_intercept_message {
+	u32 vp_index;
+} __packed;
+
+enum hv_port_type {
+	HV_PORT_TYPE_MESSAGE = 1,
+	HV_PORT_TYPE_EVENT   = 2,
+	HV_PORT_TYPE_MONITOR = 3,
+	HV_PORT_TYPE_DOORBELL = 4	/* Root Partition only */
+};
+
+struct hv_port_info {
+	u32 port_type; /* enum hv_port_type */
+	u32 padding;
+	union {
+		struct {
+			u32 target_sint;
+			u32 target_vp;
+			u64 rsvdz;
+		} message_port_info;
+		struct {
+			u32 target_sint;
+			u32 target_vp;
+			u16 base_flag_number;
+			u16 flag_count;
+			u32 rsvdz;
+		} event_port_info;
+		struct {
+			u64 monitor_address;
+			u64 rsvdz;
+		} monitor_port_info;
+		struct {
+			u32 target_sint;
+			u32 target_vp;
+			u64 rsvdz;
+		} doorbell_port_info;
+	};
+} __packed;
+
+struct hv_connection_info {
+	u32 port_type;
+	u32 padding;
+	union {
+		struct {
+			u64 rsvdz;
+		} message_connection_info;
+		struct {
+			u64 rsvdz;
+		} event_connection_info;
+		struct {
+			u64 monitor_address;
+		} monitor_connection_info;
+		struct {
+			u64 gpa;
+			u64 trigger_value;
+			u64 flags;
+		} doorbell_connection_info;
+	};
+} __packed;
+
+/* Define synthetic interrupt controller flag constants. */
+#define HV_EVENT_FLAGS_COUNT		(256 * 8)
+#define HV_EVENT_FLAGS_BYTE_COUNT	(256)
+#define HV_EVENT_FLAGS32_COUNT		(256 / sizeof(u32))
+
+/* linux side we create long version of flags to use long bit ops on flags */
+#define HV_EVENT_FLAGS_UL_COUNT		(256 / sizeof(ulong))
+
+/* Define the synthetic interrupt controller event flags format. */
+union hv_synic_event_flags {
+	unsigned char flags8[HV_EVENT_FLAGS_BYTE_COUNT];
+	u32 flags32[HV_EVENT_FLAGS32_COUNT];
+	ulong flags[HV_EVENT_FLAGS_UL_COUNT];  /* linux only */
+};
+
+struct hv_synic_event_flags_page {
+	volatile union hv_synic_event_flags event_flags[HV_SYNIC_SINT_COUNT];
+};
+
+#define HV_SYNIC_EVENT_RING_MESSAGE_COUNT 63
+
+struct hv_synic_event_ring {
+	u8  signal_masked;
+	u8  ring_full;
+	u16 reserved_z;
+	u32 data[HV_SYNIC_EVENT_RING_MESSAGE_COUNT];
+} __packed;
+
+struct hv_synic_event_ring_page {
+	struct hv_synic_event_ring sint_event_ring[HV_SYNIC_SINT_COUNT];
+};
+
+/* Define SynIC control register. */
+union hv_synic_scontrol {
+	u64 as_uint64;
+	struct {
+		u64 enable : 1;
+		u64 reserved : 63;
+	} __packed;
+};
+
+/* Define the format of the SIEFP register */
+union hv_synic_siefp {
+	u64 as_uint64;
+	struct {
+		u64 siefp_enabled : 1;
+		u64 preserved : 11;
+		u64 base_siefp_gpa : 52;
+	} __packed;
+};
+
+union hv_synic_sirbp {
+	u64 as_uint64;
+	struct {
+		u64 sirbp_enabled : 1;
+		u64 preserved : 11;
+		u64 base_sirbp_gpa : 52;
+	} __packed;
+};
+
+union hv_interrupt_control {
+	u64 as_uint64;
+	struct {
+		u32 interrupt_type; /* enum hv_interrupt_type */
+		u32 level_triggered : 1;
+		u32 logical_dest_mode : 1;
+		u32 rsvd : 30;
+	} __packed;
+};
+
+struct hv_stimer_state {
+	struct {
+		u32 undelivered_msg_pending : 1;
+		u32 reserved : 31;
+	} __packed flags;
+	u32 resvd;
+	u64 config;
+	u64 count;
+	u64 adjustment;
+	u64 undelivered_exp_time;
+} __packed;
+
+struct hv_synthetic_timers_state {
+	struct hv_stimer_state timers[HV_SYNIC_STIMER_COUNT];
+	u64 reserved[5];
+} __packed;
+
+union hv_input_delete_vp {
+	u64 as_uint64[2];
+	struct {
+		u64 partition_id;
+		u32 vp_index;
+		u8 reserved[4];
+	} __packed;
+} __packed;
+
+struct hv_input_assert_virtual_interrupt {
+	u64 partition_id;
+	union hv_interrupt_control control;
+	u64 dest_addr; /* cpu's apic id */
+	u32 vector;
+	u8 target_vtl;
+	u8 rsvd_z0;
+	u16 rsvd_z1;
+} __packed;
+
+struct hv_input_create_port {
+	u64 port_partition_id;
+	union hv_port_id port_id;
+	u8 port_vtl;
+	u8 min_connection_vtl;
+	u16 padding;
+	u64 connection_partition_id;
+	struct hv_port_info port_info;
+	struct hv_proximity_domain_info proximity_domain_info;
+} __packed;
+
+union hv_input_delete_port {
+	u64 as_uint64[2];
+	struct {
+		u64 port_partition_id;
+		union hv_port_id port_id;
+		u32 reserved;
+	};
+} __packed;
+
+struct hv_input_connect_port {
+	u64 connection_partition_id;
+	union hv_connection_id connection_id;
+	u8 connection_vtl;
+	u8 rsvdz0;
+	u16 rsvdz1;
+	u64 port_partition_id;
+	union hv_port_id port_id;
+	u32 reserved2;
+	struct hv_connection_info connection_info;
+	struct hv_proximity_domain_info proximity_domain_info;
+} __packed;
+
+union hv_input_disconnect_port {
+	u64 as_uint64[2];
+	struct {
+		u64 connection_partition_id;
+		union hv_connection_id connection_id;
+		u32 is_doorbell: 1;
+		u32 reserved: 31;
+	} __packed;
+} __packed;
+
+union hv_input_notify_port_ring_empty {
+	u64 as_uint64;
+	struct {
+		u32 sint_index;
+		u32 reserved;
+	};
+} __packed;
+
+struct hv_vp_state_data_xsave {
+	u64 flags;
+	union hv_x64_xsave_xfem_register states;
+} __packed;
+
+/*
+ * For getting and setting VP state, there are two options based on the state type:
+ *
+ *     1.) Data that is accessed by PFNs in the input hypercall page. This is used
+ *         for state which may not fit into the hypercall pages.
+ *     2.) Data that is accessed directly in the input\output hypercall pages.
+ *         This is used for state that will always fit into the hypercall pages.
+ *
+ * In the future this could be dynamic based on the size if needed.
+ *
+ * Note these hypercalls have an 8-byte aligned variable header size as per the tlfs
+ */
+
+#define HV_GET_SET_VP_STATE_TYPE_PFN	BIT(31)
+
+enum hv_get_set_vp_state_type {
+	/* HvGetSetVpStateLocalInterruptControllerState - APIC/GIC state */
+	HV_GET_SET_VP_STATE_LAPIC_STATE	     = 0 | HV_GET_SET_VP_STATE_TYPE_PFN,
+	HV_GET_SET_VP_STATE_XSAVE	     = 1 | HV_GET_SET_VP_STATE_TYPE_PFN,
+	HV_GET_SET_VP_STATE_SIM_PAGE	     = 2 | HV_GET_SET_VP_STATE_TYPE_PFN,
+	HV_GET_SET_VP_STATE_SIEF_PAGE	     = 3 | HV_GET_SET_VP_STATE_TYPE_PFN,
+	HV_GET_SET_VP_STATE_SYNTHETIC_TIMERS = 4,
+};
+
+struct hv_vp_state_data {
+	u32 type;
+	u32 rsvd;
+	struct hv_vp_state_data_xsave xsave;
+} __packed;
+
+struct hv_input_get_vp_state {
+	u64 partition_id;
+	u32 vp_index;
+	u8 input_vtl;
+	u8 rsvd0;
+	u16 rsvd1;
+	struct hv_vp_state_data state_data;
+	u64 output_data_pfns[];
+} __packed;
+
+union hv_output_get_vp_state {
+	struct hv_synthetic_timers_state synthetic_timers_state;
+} __packed;
+
+union hv_input_set_vp_state_data {
+	u64 pfns;
+	u8 bytes;
+} __packed;
+
+struct hv_input_set_vp_state {
+	u64 partition_id;
+	u32 vp_index;
+	u8 input_vtl;
+	u8 rsvd0;
+	u16 rsvd1;
+	struct hv_vp_state_data state_data;
+	union hv_input_set_vp_state_data data[];
+} __packed;
+
+/*
+ * Dispatch state for the VP communicated by the hypervisor to the
+ * VP-dispatching thread in the root on return from HVCALL_DISPATCH_VP.
+ */
+enum hv_vp_dispatch_state {
+	HV_VP_DISPATCH_STATE_INVALID	= 0,
+	HV_VP_DISPATCH_STATE_BLOCKED	= 1,
+	HV_VP_DISPATCH_STATE_READY	= 2,
+};
+
+/*
+ * Dispatch event that caused the current dispatch state on return from
+ * HVCALL_DISPATCH_VP.
+ */
+enum hv_vp_dispatch_event {
+	HV_VP_DISPATCH_EVENT_INVALID	= 0x00000000,
+	HV_VP_DISPATCH_EVENT_SUSPEND	= 0x00000001,
+	HV_VP_DISPATCH_EVENT_INTERCEPT	= 0x00000002,
+};
+
+#define HV_ROOT_SCHEDULER_MAX_VPS_PER_CHILD_PARTITION   1024
+/* The maximum array size of HV_GENERIC_SET (vp_set) buffer */
+#define HV_GENERIC_SET_QWORD_COUNT(max) (((((max) - 1) >> 6) + 1) + 2)
+
+struct hv_vp_signal_bitset_scheduler_message {
+	u64 partition_id;
+	u32 overflow_count;
+	u16 vp_count;
+	u16 reserved;
+
+#define BITSET_BUFFER_SIZE \
+	HV_GENERIC_SET_QWORD_COUNT(HV_ROOT_SCHEDULER_MAX_VPS_PER_CHILD_PARTITION)
+	union {
+		struct hv_vpset bitset;
+		u64 bitset_buffer[BITSET_BUFFER_SIZE];
+	} vp_bitset;
+#undef BITSET_BUFFER_SIZE
+} __packed;
+
+static_assert(sizeof(struct hv_vp_signal_bitset_scheduler_message) <=
+	(sizeof(struct hv_message) - sizeof(struct hv_message_header)));
+
+#define HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT \
+	(((sizeof(struct hv_message) - sizeof(struct hv_message_header)) / \
+	 (sizeof(u64 /* partition id */) + sizeof(u32 /* vp index */))) - 1)
+
+struct hv_vp_signal_pair_scheduler_message {
+	u32 overflow_count;
+	u8 vp_count;
+	u8 reserved1[3];
+
+	u64 partition_ids[HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT];
+	u32 vp_indexes[HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT];
+
+	u8 reserved2[4];
+} __packed;
+
+static_assert(sizeof(struct hv_vp_signal_pair_scheduler_message) ==
+	(sizeof(struct hv_message) - sizeof(struct hv_message_header)));
+
+/* Input and output structures for HVCALL_DISPATCH_VP */
+#define HV_DISPATCH_VP_FLAG_CLEAR_INTERCEPT_SUSPEND	0x1
+#define HV_DISPATCH_VP_FLAG_ENABLE_CALLER_INTERRUPTS	0x2
+#define HV_DISPATCH_VP_FLAG_SET_CALLER_SPEC_CTRL	0x4
+#define HV_DISPATCH_VP_FLAG_SKIP_VP_SPEC_FLUSH		0x8
+#define HV_DISPATCH_VP_FLAG_SKIP_CALLER_SPEC_FLUSH	0x10
+#define HV_DISPATCH_VP_FLAG_SKIP_CALLER_USER_SPEC_FLUSH	0x20
+
+struct hv_input_dispatch_vp {
+	u64 partition_id;
+	u32 vp_index;
+	u32 flags;
+	u64 time_slice; /* in 100ns */
+	u64 spec_ctrl;
+} __packed;
+
+struct hv_output_dispatch_vp {
+	u32 dispatch_state; /* enum hv_vp_dispatch_state */
+	u32 dispatch_event; /* enum hv_vp_dispatch_event */
+} __packed;
+
+#endif /* _HV_HVHDK_H */
diff --git a/include/hyperv/hvhdk_mini.h b/include/hyperv/hvhdk_mini.h
new file mode 100644
index 000000000000..d003223fac79
--- /dev/null
+++ b/include/hyperv/hvhdk_mini.h
@@ -0,0 +1,310 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Type definitions for the Microsoft Hypervisor.
+ */
+#ifndef _HV_HVHDK_MINI_H
+#define _HV_HVHDK_MINI_H
+
+#include "hvgdk_mini.h"
+
+/*
+ * Doorbell connection_info flags.
+ */
+#define HV_DOORBELL_FLAG_TRIGGER_SIZE_MASK  0x00000007
+#define HV_DOORBELL_FLAG_TRIGGER_SIZE_ANY   0x00000000
+#define HV_DOORBELL_FLAG_TRIGGER_SIZE_BYTE  0x00000001
+#define HV_DOORBELL_FLAG_TRIGGER_SIZE_WORD  0x00000002
+#define HV_DOORBELL_FLAG_TRIGGER_SIZE_DWORD 0x00000003
+#define HV_DOORBELL_FLAG_TRIGGER_SIZE_QWORD 0x00000004
+#define HV_DOORBELL_FLAG_TRIGGER_ANY_VALUE  0x80000000
+
+/* Each generic set contains 64 elements */
+#define HV_GENERIC_SET_SHIFT		(6)
+#define HV_GENERIC_SET_MASK		(63)
+
+enum hv_generic_set_format {
+	HV_GENERIC_SET_SPARSE_4K,
+	HV_GENERIC_SET_ALL,
+};
+
+enum hv_scheduler_type {
+	HV_SCHEDULER_TYPE_LP		= 1, /* Classic scheduler w/o SMT */
+	HV_SCHEDULER_TYPE_LP_SMT	= 2, /* Classic scheduler w/ SMT */
+	HV_SCHEDULER_TYPE_CORE_SMT	= 3, /* Core scheduler */
+	HV_SCHEDULER_TYPE_ROOT		= 4, /* Root / integrated scheduler */
+	HV_SCHEDULER_TYPE_MAX
+};
+
+enum hv_partition_property_code {
+	/* Privilege properties */
+	HV_PARTITION_PROPERTY_PRIVILEGE_FLAGS			= 0x00010000,
+	HV_PARTITION_PROPERTY_SYNTHETIC_PROC_FEATURES		= 0x00010001,
+
+	/* Resource properties */
+	HV_PARTITION_PROPERTY_GPA_PAGE_ACCESS_TRACKING		= 0x00050005,
+	HV_PARTITION_PROPERTY_UNIMPLEMENTED_MSR_ACTION		= 0x00050017,
+
+	/* Compatibility properties */
+	HV_PARTITION_PROPERTY_PROCESSOR_XSAVE_FEATURES		= 0x00060002,
+	HV_PARTITION_PROPERTY_MAX_XSAVE_DATA_SIZE		= 0x00060008,
+	HV_PARTITION_PROPERTY_PROCESSOR_CLOCK_FREQUENCY		= 0x00060009,
+};
+
+enum hv_system_property {
+	/* Add more values when needed */
+	HV_SYSTEM_PROPERTY_SCHEDULER_TYPE = 15,
+};
+
+struct hv_input_get_system_property {
+	u32 property_id; /* enum hv_system_property */
+	union {
+		u32 as_uint32;
+		/* More fields to be filled in when needed */
+	};
+} __packed;
+
+struct hv_output_get_system_property {
+	union {
+		u32 scheduler_type; /* enum hv_scheduler_type */
+	};
+} __packed;
+
+struct hv_proximity_domain_flags {
+	u32 proximity_preferred : 1;
+	u32 reserved : 30;
+	u32 proximity_info_valid : 1;
+} __packed;
+
+struct hv_proximity_domain_info {
+	u32 domain_id;
+	struct hv_proximity_domain_flags flags;
+} __packed;
+
+/* HvDepositMemory hypercall */
+struct hv_deposit_memory {	/* HV_INPUT_DEPOSIT_MEMORY */
+	u64 partition_id;
+	u64 gpa_page_list[];
+} __packed;
+
+struct hv_input_withdraw_memory {
+	u64 partition_id;
+	struct hv_proximity_domain_info proximity_domain_info;
+} __packed;
+
+struct hv_output_withdraw_memory {
+	DECLARE_FLEX_ARRAY(u64, gpa_page_list);
+} __packed;
+
+/* HV Map GPA (Guest Physical Address) Flags */
+#define HV_MAP_GPA_PERMISSIONS_NONE	       0x0
+#define HV_MAP_GPA_READABLE		       0x1
+#define HV_MAP_GPA_WRITABLE		       0x2
+#define HV_MAP_GPA_KERNEL_EXECUTABLE	       0x4
+#define HV_MAP_GPA_USER_EXECUTABLE	       0x8
+#define HV_MAP_GPA_EXECUTABLE		       0xC
+#define HV_MAP_GPA_PERMISSIONS_MASK	       0xF
+#define HV_MAP_GPA_ADJUSTABLE		    0x8000
+#define HV_MAP_GPA_NO_ACCESS		   0x10000
+#define HV_MAP_GPA_NOT_CACHED		  0x200000
+#define HV_MAP_GPA_LARGE_PAGE		0x80000000
+
+struct hv_input_map_gpa_pages {
+	u64 target_partition_id;
+	u64 target_gpa_base;
+	u32 map_flags;
+	u32 padding;
+	u64 source_gpa_page_list[];
+} __packed;
+
+union hv_gpa_page_access_state_flags {
+	struct {
+		u64 clear_accessed : 1;
+		u64 set_accessed : 1;
+		u64 clear_dirty : 1;
+		u64 set_dirty : 1;
+		u64 reserved : 60;
+	} __packed;
+	u64 as_uint64;
+};
+
+struct hv_input_get_gpa_pages_access_state {
+	u64  partition_id;
+	union hv_gpa_page_access_state_flags flags;
+	u64 hv_gpa_page_number;
+} __packed;
+
+union hv_gpa_page_access_state {
+	struct {
+		u8 accessed : 1;
+		u8 dirty : 1;
+		u8 reserved: 6;
+	};
+	u8 as_uint8;
+} __packed;
+
+struct hv_lp_startup_status {
+	u64 hv_status;
+	u64 substatus1;
+	u64 substatus2;
+	u64 substatus3;
+	u64 substatus4;
+	u64 substatus5;
+	u64 substatus6;
+} __packed;
+
+struct hv_input_add_logical_processor {
+	u32 lp_index;
+	u32 apic_id;
+	struct hv_proximity_domain_info proximity_domain_info;
+} __packed;
+
+struct hv_output_add_logical_processor {
+	struct hv_lp_startup_status startup_status;
+} __packed;
+
+enum {	/* HV_SUBNODE_TYPE */
+	HV_SUBNODE_ANY		= 0,
+	HV_SUBNODE_SOCKET,
+	HV_SUBNODE_CLUSTER,
+	HV_SUBNODE_L3,
+	HV_SUBNODE_COUNT,
+	HV_SUBNODE_INVALID	= -1
+};
+
+struct hv_create_vp {	/* HV_INPUT_CREATE_VP */
+	u64 partition_id;
+	u32 vp_index;
+	u8 padding[3];
+	u8 subnode_type;
+	u64 subnode_id;
+	struct hv_proximity_domain_info proximity_domain_info;
+	u64 flags;
+} __packed;
+
+/* HV_INTERRUPT_TRIGGER_MODE */
+enum hv_interrupt_trigger_mode {
+	HV_INTERRUPT_TRIGGER_MODE_EDGE	= 0,
+	HV_INTERRUPT_TRIGGER_MODE_LEVEL	= 1,
+};
+
+/* HV_DEVICE_INTERRUPT_DESCRIPTOR */
+struct hv_device_interrupt_descriptor {
+	u32 interrupt_type;
+	u32 trigger_mode;
+	u32 vector_count;
+	u32 reserved;
+	struct hv_device_interrupt_target target;
+} __packed;
+
+/* HV_INPUT_MAP_DEVICE_INTERRUPT */
+struct hv_input_map_device_interrupt {
+	u64 partition_id;
+	u64 device_id;
+	u32 flags;
+	u32 base_irt_idx;
+	struct hv_interrupt_entry logical_interrupt_entry;
+	struct hv_device_interrupt_descriptor interrupt_descriptor;
+} __packed;
+
+/* HV_OUTPUT_MAP_DEVICE_INTERRUPT */
+struct hv_output_map_device_interrupt {
+	struct hv_interrupt_entry interrupt_entry;
+} __packed;
+
+/* HV_INPUT_UNMAP_DEVICE_INTERRUPT */
+struct hv_input_unmap_device_interrupt {
+	u64 partition_id;
+	u64 device_id;
+	struct hv_interrupt_entry interrupt_entry;
+	u32 flags;
+} __packed;
+
+#define HV_SOURCE_SHADOW_NONE		    0x0
+#define HV_SOURCE_SHADOW_BRIDGE_BUS_RANGE   0x1
+
+struct hv_send_ipi_ex { /* HV_INPUT_SEND_SYNTHETIC_CLUSTER_IPI_EX */
+	u32 vector;
+	u32 reserved;
+	struct hv_vpset vp_set;
+} __packed;
+
+typedef u16 hv_pci_rid;		/* HV_PCI_RID */
+typedef u16 hv_pci_segment;	/* HV_PCI_SEGMENT */
+typedef u64 hv_logical_device_id;
+union hv_pci_bdf {	/* HV_PCI_BDF */
+	u16 as_uint16;
+
+	struct {
+		u8 function : 3;
+		u8 device : 5;
+		u8 bus;
+	};
+} __packed;
+
+union hv_pci_bus_range {
+	u16 as_uint16;
+
+	struct {
+		u8 subordinate_bus;
+		u8 secondary_bus;
+	};
+} __packed;
+
+enum hv_device_type {		/* HV_DEVICE_TYPE */
+	HV_DEVICE_TYPE_LOGICAL	= 0,
+	HV_DEVICE_TYPE_PCI	= 1,
+	HV_DEVICE_TYPE_IOAPIC	= 2,
+	HV_DEVICE_TYPE_ACPI	= 3,
+};
+
+union hv_device_id {		/* HV_DEVICE_ID */
+	u64 as_uint64;
+
+	struct {
+		u64 reserved0 : 62;
+		u64 device_type : 2;
+	};
+
+	/* HV_DEVICE_TYPE_LOGICAL */
+	struct {
+		u64 id : 62;
+		u64 device_type : 2;
+	} logical;
+
+	/* HV_DEVICE_TYPE_PCI */
+	struct {
+		union {
+			hv_pci_rid rid;
+			union hv_pci_bdf bdf;
+		};
+
+		hv_pci_segment segment;
+		union hv_pci_bus_range shadow_bus_range;
+
+		u16 phantom_function_bits : 2;
+		u16 source_shadow : 1;
+
+		u16 rsvdz0 : 11;
+		u16 device_type : 2;
+	} pci;
+
+	/* HV_DEVICE_TYPE_IOAPIC */
+	struct {
+		u8 ioapic_id;
+		u8 rsvdz0;
+		u16 rsvdz1;
+		u16 rsvdz2;
+
+		u16 rsvdz3 : 14;
+		u16 device_type : 2;
+	} ioapic;
+
+	/* HV_DEVICE_TYPE_ACPI */
+	struct {
+		u32 input_mapping_base;
+		u32 input_mapping_count : 30;
+		u32 device_type : 2;
+	} acpi;
+} __packed;
+
+#endif /* _HV_HVHDK_MINI_H */
-- 
2.34.1

Re: [PATCH v2 3/4] hyperv: Add new Hyper-V headers in include/hyperv

[Naman Jain]

On 11/8/2024 4:02 AM, Nuno Das Neves wrote:
> These headers contain definitions for regular Hyper-V guests (as in
> hyperv-tlfs.h), as well as interfaces for more privileged guests like
> Dom0.
> 
> These files are derived from headers exported from Hyper-V, rather than
> being derived from the TLFS document. (Although, to preserve
> compatibility with existing Linux code, some definitions are copied
> directly from hyperv-tlfs.h too).
> 
> The new files follow a naming convention according to their original
> use:
> - hdk "host development kit"
> - gdk "guest development kit"
> With postfix "_mini" implying userspace-only headers, and "_ext" for
> extended hypercalls.

Naming convention for mini (which may have come from HyperV code) is a 
bit odd TBH. May be it has more to it than what is mentioned here or 
what I know. If more information helps, or this can be changed, please see.

> 
> These names should be considered a rough guide only - since there are
> many places already where both host and guest code are in the same
> place, hvhdk.h (which includes everything) can be used most of the time.
> 
> The original names are kept intact primarily to keep the provenance of
> exactly where they came from in Hyper-V code, which is helpful for
> manual maintenance and extension of these definitions. Microsoft
> maintainers importing new definitions should take care to put them in
> the right file.
> 
> Note also that the files contain both arm64 and x86_64 code guarded by
> \#ifdefs, which is how the definitions originally appear in Hyper-V.
> Keeping this convention from Hyper-V code is another tactic for
> simplying the process of importing new definitions.
> 
> These headers are a step toward importing headers directly from Hyper-V
> in the future, similar to Xen public files in include/xen/interface/.
> 
> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>

While I understand the motivation behind this series that this is going 
to ease out the process of updating the header files with respect to 
HyperV, I think, we will need to pay attention to what we are bringing 
in with these headers, whether there are any users of it or not, and 
make sure that TLFS document is updated regularly, to avoid having bunch 
of code with no information of it.
The code comments in these files are one step forward towards that.
And from your cover letter it seems that some changes which actually 
make use of these additional interfaces are underway, so things will 
make more sense later. For now, this looks good to me.


Regards,
Naman

<snip>

Re: [PATCH v2 3/4] hyperv: Add new Hyper-V headers in include/hyperv

[Nuno Das Neves]

On 11/7/2024 9:59 PM, Naman Jain wrote:
> 
> 
> On 11/8/2024 4:02 AM, Nuno Das Neves wrote:
>> These headers contain definitions for regular Hyper-V guests (as in
>> hyperv-tlfs.h), as well as interfaces for more privileged guests like
>> Dom0.
>>
>> These files are derived from headers exported from Hyper-V, rather than
>> being derived from the TLFS document. (Although, to preserve
>> compatibility with existing Linux code, some definitions are copied
>> directly from hyperv-tlfs.h too).
>>
>> The new files follow a naming convention according to their original
>> use:
>> - hdk "host development kit"
>> - gdk "guest development kit"
>> With postfix "_mini" implying userspace-only headers, and "_ext" for
>> extended hypercalls.
> 
> Naming convention for mini (which may have come from HyperV code) is a bit odd TBH. May be it has more to it than what is mentioned here or what I know. If more information helps, or this can be changed, please see.
> 

The naming is originally from the Hyper-V code. See below: "The original
names are kept intact primarily to keep the provenance of exactly where
they came from in Hyper-V code, which is helpful for manual maintenance
and extension of these definitions."

>>
>> These names should be considered a rough guide only - since there are
>> many places already where both host and guest code are in the same
>> place, hvhdk.h (which includes everything) can be used most of the time.
>>
>> The original names are kept intact primarily to keep the provenance of
>> exactly where they came from in Hyper-V code, which is helpful for
>> manual maintenance and extension of these definitions. Microsoft
>> maintainers importing new definitions should take care to put them in
>> the right file.
>>
>> Note also that the files contain both arm64 and x86_64 code guarded by
>> \#ifdefs, which is how the definitions originally appear in Hyper-V.
>> Keeping this convention from Hyper-V code is another tactic for
>> simplying the process of importing new definitions.
>>
>> These headers are a step toward importing headers directly from Hyper-V
>> in the future, similar to Xen public files in include/xen/interface/.
>>
>> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> 
> While I understand the motivation behind this series that this is going to ease out the process of updating the header files with respect to HyperV, I think, we will need to pay attention to what we are bringing in with these headers, whether there are any users of it or not, and make sure that TLFS document is updated regularly, to avoid having bunch of code with no information of it.
> The code comments in these files are one step forward towards that.
> And from your cover letter it seems that some changes which actually make use of these additional interfaces are underway, so things will make more sense later. For now, this looks good to me.
> 

Yes, we do need to be careful about what interfaces we add here. Not just
anything can be copied from Hyper-V code into these files. The exact
process is a matter we can discuss internally. But, as you say, there are
upcoming patches (previous versions can be found in the mailing list) which
use the new root partition interfaces.

Updating the TLFS and documenting the interfaces is a different matter.
I can't speak to the best way forward for documenting these, but in many
cases the use of the new interfaces will be self-evident from the code
that uses them, and/or comments as you mentioned.

Over the years many Hyper-V definitions have already been added and used
in Linux which have not been documented in the TLFS or elsewhere. This
patch series makes that fact more obvious and sets us on a path towards a
more maintainable method (i.e., publishing headers directly from the Hyper-V
code, hopefully).

Thanks
Nuno

> > Regards,
> Naman
> 
> <snip>

RE: [PATCH v2 3/4] hyperv: Add new Hyper-V headers in include/hyperv

[Michael Kelley]

From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
> 
> These headers contain definitions for regular Hyper-V guests (as in
> hyperv-tlfs.h), as well as interfaces for more privileged guests like
> Dom0.

See my comment on Patch 0/4 about use of "dom0" terminology.

> 
> These files are derived from headers exported from Hyper-V, rather than
> being derived from the TLFS document. (Although, to preserve
> compatibility with existing Linux code, some definitions are copied
> directly from hyperv-tlfs.h too).
> 
> The new files follow a naming convention according to their original
> use:
> - hdk "host development kit"
> - gdk "guest development kit"
> With postfix "_mini" implying userspace-only headers, and "_ext" for
> extended hypercalls.
> 
> These names should be considered a rough guide only - since there are
> many places already where both host and guest code are in the same
> place, hvhdk.h (which includes everything) can be used most of the time.

Just curious -- are there really cases where hvhdk.h can't be used?
If so, could you summarize why?

I ask because it would be nice to expand slightly on your paragraph
below, as follows:  (if indeed what I've added is correct)

The use of multiple files and their original names is primarily to
keep the provenance of exactly where they came from in Hyper-V
code, which is helpful for manual maintenance and extension
of these definitions. Microsoft maintainers importing new definitions
should take care to put them in the right file. However, Linux kernel code
that uses any of the definitions need not be aware of the multiple files
or assign any meaning to the new names. Linux kernel uses should
always just include hvhdk.h

> 
> The original names are kept intact primarily to keep the provenance of
> exactly where they came from in Hyper-V code, which is helpful for
> manual maintenance and extension of these definitions. Microsoft
> maintainers importing new definitions should take care to put them in
> the right file.
> 
> Note also that the files contain both arm64 and x86_64 code guarded by
> \#ifdefs, which is how the definitions originally appear in Hyper-V.

Spurious backslash?

I would suggest some additional clarification:  The #ifdef guards are
employed minimally where necessary to prevent conflicts due to
different definitions for the same thing on x86_64 and arm64. Where
there are no conflicts, the union of x86_64 definitions and arm64
definitions is visible when building for either architecture. In other
words, not all definitions specific to x86_64 are protected by #ifdef
x86_64. Such unprotected definitions may be visible when building
for arm64. And vice versa.

Michael

> Keeping this convention from Hyper-V code is another tactic for
> simplying the process of importing new definitions.
> 
> These headers are a step toward importing headers directly from Hyper-V
> in the future, similar to Xen public files in include/xen/interface/.
> 
> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> ---
>  include/hyperv/hvgdk.h      |  303 ++++++++
>  include/hyperv/hvgdk_ext.h  |   46 ++
>  include/hyperv/hvgdk_mini.h | 1295 +++++++++++++++++++++++++++++++++++
>  include/hyperv/hvhdk.h      |  733 ++++++++++++++++++++
>  include/hyperv/hvhdk_mini.h |  310 +++++++++
>  5 files changed, 2687 insertions(+)
>  create mode 100644 include/hyperv/hvgdk.h
>  create mode 100644 include/hyperv/hvgdk_ext.h
>  create mode 100644 include/hyperv/hvgdk_mini.h
>  create mode 100644 include/hyperv/hvhdk.h
>  create mode 100644 include/hyperv/hvhdk_mini.h
> 
> diff --git a/include/hyperv/hvgdk.h b/include/hyperv/hvgdk.h
> new file mode 100644
> index 000000000000..9687c6570dfb
> --- /dev/null
> +++ b/include/hyperv/hvgdk.h
> @@ -0,0 +1,303 @@
> +/* SPDX-License-Identifier: GPL-2.0 */
> +/*
> + * Type definitions for the Microsoft Hypervisor.
> + */
> +#ifndef _HV_HVGDK_H
> +#define _HV_HVGDK_H
> +
> +#include "hvgdk_mini.h"
> +#include "hvgdk_ext.h"
> +
> +/*
> + * The guest OS needs to register the guest ID with the hypervisor.
> + * The guest ID is a 64 bit entity and the structure of this ID is
> + * specified in the Hyper-V TLFS specification.
> + *
> + * While the current guideline does not specify how Linux guest ID(s)
> + * need to be generated, our plan is to publish the guidelines for
> + * Linux and other guest operating systems that currently are hosted
> + * on Hyper-V. The implementation here conforms to this yet
> + * unpublished guidelines.
> + *
> + * Bit(s)
> + * 63 - Indicates if the OS is Open Source or not; 1 is Open Source
> + * 62:56 - Os Type; Linux is 0x100
> + * 55:48 - Distro specific identification
> + * 47:16 - Linux kernel version number
> + * 15:0  - Distro specific identification
> + */
> +
> +#define HV_LINUX_VENDOR_ID              0x8100
> +
> +/* HV_VMX_ENLIGHTENED_VMCS */
> +struct hv_enlightened_vmcs {
> +	u32 revision_id;
> +	u32 abort;
> +
> +	u16 host_es_selector;
> +	u16 host_cs_selector;
> +	u16 host_ss_selector;
> +	u16 host_ds_selector;
> +	u16 host_fs_selector;
> +	u16 host_gs_selector;
> +	u16 host_tr_selector;
> +
> +	u16 padding16_1;
> +
> +	u64 host_ia32_pat;
> +	u64 host_ia32_efer;
> +
> +	u64 host_cr0;
> +	u64 host_cr3;
> +	u64 host_cr4;
> +
> +	u64 host_ia32_sysenter_esp;
> +	u64 host_ia32_sysenter_eip;
> +	u64 host_rip;
> +	u32 host_ia32_sysenter_cs;
> +
> +	u32 pin_based_vm_exec_control;
> +	u32 vm_exit_controls;
> +	u32 secondary_vm_exec_control;
> +
> +	u64 io_bitmap_a;
> +	u64 io_bitmap_b;
> +	u64 msr_bitmap;
> +
> +	u16 guest_es_selector;
> +	u16 guest_cs_selector;
> +	u16 guest_ss_selector;
> +	u16 guest_ds_selector;
> +	u16 guest_fs_selector;
> +	u16 guest_gs_selector;
> +	u16 guest_ldtr_selector;
> +	u16 guest_tr_selector;
> +
> +	u32 guest_es_limit;
> +	u32 guest_cs_limit;
> +	u32 guest_ss_limit;
> +	u32 guest_ds_limit;
> +	u32 guest_fs_limit;
> +	u32 guest_gs_limit;
> +	u32 guest_ldtr_limit;
> +	u32 guest_tr_limit;
> +	u32 guest_gdtr_limit;
> +	u32 guest_idtr_limit;
> +
> +	u32 guest_es_ar_bytes;
> +	u32 guest_cs_ar_bytes;
> +	u32 guest_ss_ar_bytes;
> +	u32 guest_ds_ar_bytes;
> +	u32 guest_fs_ar_bytes;
> +	u32 guest_gs_ar_bytes;
> +	u32 guest_ldtr_ar_bytes;
> +	u32 guest_tr_ar_bytes;
> +
> +	u64 guest_es_base;
> +	u64 guest_cs_base;
> +	u64 guest_ss_base;
> +	u64 guest_ds_base;
> +	u64 guest_fs_base;
> +	u64 guest_gs_base;
> +	u64 guest_ldtr_base;
> +	u64 guest_tr_base;
> +	u64 guest_gdtr_base;
> +	u64 guest_idtr_base;
> +
> +	u64 padding64_1[3];
> +
> +	u64 vm_exit_msr_store_addr;
> +	u64 vm_exit_msr_load_addr;
> +	u64 vm_entry_msr_load_addr;
> +
> +	u64 cr3_target_value0;
> +	u64 cr3_target_value1;
> +	u64 cr3_target_value2;
> +	u64 cr3_target_value3;
> +
> +	u32 page_fault_error_code_mask;
> +	u32 page_fault_error_code_match;
> +
> +	u32 cr3_target_count;
> +	u32 vm_exit_msr_store_count;
> +	u32 vm_exit_msr_load_count;
> +	u32 vm_entry_msr_load_count;
> +
> +	u64 tsc_offset;
> +	u64 virtual_apic_page_addr;
> +	u64 vmcs_link_pointer;
> +
> +	u64 guest_ia32_debugctl;
> +	u64 guest_ia32_pat;
> +	u64 guest_ia32_efer;
> +
> +	u64 guest_pdptr0;
> +	u64 guest_pdptr1;
> +	u64 guest_pdptr2;
> +	u64 guest_pdptr3;
> +
> +	u64 guest_pending_dbg_exceptions;
> +	u64 guest_sysenter_esp;
> +	u64 guest_sysenter_eip;
> +
> +	u32 guest_activity_state;
> +	u32 guest_sysenter_cs;
> +
> +	u64 cr0_guest_host_mask;
> +	u64 cr4_guest_host_mask;
> +	u64 cr0_read_shadow;
> +	u64 cr4_read_shadow;
> +	u64 guest_cr0;
> +	u64 guest_cr3;
> +	u64 guest_cr4;
> +	u64 guest_dr7;
> +
> +	u64 host_fs_base;
> +	u64 host_gs_base;
> +	u64 host_tr_base;
> +	u64 host_gdtr_base;
> +	u64 host_idtr_base;
> +	u64 host_rsp;
> +
> +	u64 ept_pointer;
> +
> +	u16 virtual_processor_id;
> +	u16 padding16_2[3];
> +
> +	u64 padding64_2[5];
> +	u64 guest_physical_address;
> +
> +	u32 vm_instruction_error;
> +	u32 vm_exit_reason;
> +	u32 vm_exit_intr_info;
> +	u32 vm_exit_intr_error_code;
> +	u32 idt_vectoring_info_field;
> +	u32 idt_vectoring_error_code;
> +	u32 vm_exit_instruction_len;
> +	u32 vmx_instruction_info;
> +
> +	u64 exit_qualification;
> +	u64 exit_io_instruction_ecx;
> +	u64 exit_io_instruction_esi;
> +	u64 exit_io_instruction_edi;
> +	u64 exit_io_instruction_eip;
> +
> +	u64 guest_linear_address;
> +	u64 guest_rsp;
> +	u64 guest_rflags;
> +
> +	u32 guest_interruptibility_info;
> +	u32 cpu_based_vm_exec_control;
> +	u32 exception_bitmap;
> +	u32 vm_entry_controls;
> +	u32 vm_entry_intr_info_field;
> +	u32 vm_entry_exception_error_code;
> +	u32 vm_entry_instruction_len;
> +	u32 tpr_threshold;
> +
> +	u64 guest_rip;
> +
> +	u32 hv_clean_fields;
> +	u32 padding32_1;
> +	u32 hv_synthetic_controls;
> +	struct {
> +		u32 nested_flush_hypercall:1;
> +		u32 msr_bitmap:1;
> +		u32 reserved:30;
> +	}  __packed hv_enlightenments_control;
> +	u32 hv_vp_id;
> +	u32 padding32_2;
> +	u64 hv_vm_id;
> +	u64 partition_assist_page;
> +	u64 padding64_4[4];
> +	u64 guest_bndcfgs;
> +	u64 guest_ia32_perf_global_ctrl;
> +	u64 guest_ia32_s_cet;
> +	u64 guest_ssp;
> +	u64 guest_ia32_int_ssp_table_addr;
> +	u64 guest_ia32_lbr_ctl;
> +	u64 padding64_5[2];
> +	u64 xss_exit_bitmap;
> +	u64 encls_exiting_bitmap;
> +	u64 host_ia32_perf_global_ctrl;
> +	u64 tsc_multiplier;
> +	u64 host_ia32_s_cet;
> +	u64 host_ssp;
> +	u64 host_ia32_int_ssp_table_addr;
> +	u64 padding64_6;
> +} __packed;
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_NONE			0
> +
> +
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_IO_BITMAP		BIT(0)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_MSR_BITMAP		BIT(1)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_GRP2		BIT(2)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_GRP1		BIT(3)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_PROC		BIT(4)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_EVENT		BIT(5)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_ENTRY		BIT(6)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_EXCPN		BIT(7)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CRDR			BIT(8)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_XLAT		BIT(9)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_BASIC		BIT(10)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_GRP1		BIT(11)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_GRP2		BIT(12)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_HOST_POINTER		BIT(13)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_HOST_GRP1		BIT(14)
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_ENLIGHTENMENTSCONTROL	BIT(15)
> +
> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_ALL			0xFFFF
> +
> +/*
> + * Note, Hyper-V isn't actually stealing bit 28 from Intel, just abusing it by
> + * pairing it with architecturally impossible exit reasons.  Bit 28 is set only
> + * on SMI exits to a SMI transfer monitor (STM) and if and only if a MTF VM-Exit
> + * is pending.  I.e. it will never be set by hardware for non-SMI exits (there
> + * are only three), nor will it ever be set unless the VMM is an STM.
> + */
> +#define HV_VMX_SYNTHETIC_EXIT_REASON_TRAP_AFTER_FLUSH
> 	0x10000031
> +
> +/*
> + * Hyper-V uses the software reserved 32 bytes in VMCB control area to expose
> + * SVM enlightenments to guests. This is documented in the TLFS doc.
> + * Note on naming: SVM_NESTED_ENLIGHTENED_VMCB_FIELDS
> + */
> +struct hv_vmcb_enlightenments {
> +	struct __packed hv_enlightenments_control {
> +		u32 nested_flush_hypercall : 1;
> +		u32 msr_bitmap : 1;
> +		u32 enlightened_npt_tlb: 1;
> +		u32 reserved : 29;
> +	} __packed hv_enlightenments_control;
> +	u32 hv_vp_id;
> +	u64 hv_vm_id;
> +	u64 partition_assist_page;
> +	u64 reserved;
> +} __packed;
> +
> +/*
> + * Hyper-V uses the software reserved clean bit in VMCB.
> + */
> +#define HV_VMCB_NESTED_ENLIGHTENMENTS		31
> +
> +/* Synthetic VM-Exit */
> +#define HV_SVM_EXITCODE_ENL			0xf0000000
> +#define HV_SVM_ENL_EXITCODE_TRAP_AFTER_FLUSH	(1)
> +
> +/* Define connection identifier type. */
> +union hv_connection_id {
> +	u32 asu32;
> +	struct {
> +		u32 id : 24;
> +		u32 reserved : 8;
> +	} __packed u;
> +};
> +
> +struct hv_input_unmap_gpa_pages {
> +	u64 target_partition_id;
> +	u64 target_gpa_base;
> +	u32 unmap_flags;
> +	u32 padding;
> +} __packed;
> +
> +#endif /* #ifndef _HV_HVGDK_H */
> diff --git a/include/hyperv/hvgdk_ext.h b/include/hyperv/hvgdk_ext.h
> new file mode 100644
> index 000000000000..641b591ee61f
> --- /dev/null
> +++ b/include/hyperv/hvgdk_ext.h
> @@ -0,0 +1,46 @@
> +/* SPDX-License-Identifier: GPL-2.0 */
> +/*
> + * Type definitions for the Microsoft Hypervisor.
> + */
> +#ifndef _HV_HVGDK_EXT_H
> +#define _HV_HVGDK_EXT_H
> +
> +#include "hvgdk_mini.h"
> +
> +/* Extended hypercalls */
> +#define HV_EXT_CALL_QUERY_CAPABILITIES		0x8001
> +#define HV_EXT_CALL_MEMORY_HEAT_HINT		0x8003
> +
> +/* Extended hypercalls */
> +enum {		/* HV_EXT_CALL */
> +	HV_EXTCALL_QUERY_CAPABILITIES = 0x8001,
> +	HV_EXTCALL_MEMORY_HEAT_HINT   = 0x8003,
> +};
> +
> +/* HV_EXT_OUTPUT_QUERY_CAPABILITIES */
> +#define HV_EXT_CAPABILITY_MEMORY_COLD_DISCARD_HINT BIT(8)
> +
> +enum {		/* HV_EXT_MEMORY_HEAT_HINT_TYPE */
> +	HV_EXTMEM_HEAT_HINT_COLD = 0,
> +	HV_EXTMEM_HEAT_HINT_HOT = 1,
> +	HV_EXTMEM_HEAT_HINT_COLD_DISCARD = 2,
> +	HV_EXTMEM_HEAT_HINT_MAX
> +};
> +
> +/*
> + * The whole argument should fit in a page to be able to pass to the hypervisor
> + * in one hypercall.
> + */
> +#define HV_MEMORY_HINT_MAX_GPA_PAGE_RANGES  \
> +	((HV_HYP_PAGE_SIZE - sizeof(struct hv_memory_hint)) / \
> +		sizeof(union hv_gpa_page_range))
> +
> +/* HvExtCallMemoryHeatHint hypercall */
> +#define HV_EXT_MEMORY_HEAT_HINT_TYPE_COLD_DISCARD	2
> +struct hv_memory_hint {		/* HV_EXT_INPUT_MEMORY_HEAT_HINT */
> +	u64 heat_type : 2;	/* HV_EXTMEM_HEAT_HINT_* */
> +	u64 reserved : 62;
> +	union hv_gpa_page_range ranges[];
> +} __packed;
> +
> +#endif /* _HV_HVGDK_EXT_H */
> diff --git a/include/hyperv/hvgdk_mini.h b/include/hyperv/hvgdk_mini.h
> new file mode 100644
> index 000000000000..c78f345fa4af
> --- /dev/null
> +++ b/include/hyperv/hvgdk_mini.h
> @@ -0,0 +1,1295 @@
> +/* SPDX-License-Identifier: GPL-2.0 */
> +/*
> + * Type definitions for the Microsoft hypervisor.
> + */
> +#ifndef _HV_HVGDK_MINI_H
> +#define _HV_HVGDK_MINI_H
> +
> +#include <linux/types.h>
> +#include <linux/bits.h>
> +
> +struct hv_u128 {
> +	u64 low_part;
> +	u64 high_part;
> +} __packed;
> +
> +/* NOTE: when adding below, update hv_status_to_string() */
> +#define HV_STATUS_SUCCESS			    0x0
> +#define HV_STATUS_INVALID_HYPERCALL_CODE	    0x2
> +#define HV_STATUS_INVALID_HYPERCALL_INPUT	    0x3
> +#define HV_STATUS_INVALID_ALIGNMENT		    0x4
> +#define HV_STATUS_INVALID_PARAMETER		    0x5
> +#define HV_STATUS_ACCESS_DENIED			    0x6
> +#define HV_STATUS_INVALID_PARTITION_STATE	    0x7
> +#define HV_STATUS_OPERATION_DENIED		    0x8
> +#define HV_STATUS_UNKNOWN_PROPERTY		    0x9
> +#define HV_STATUS_PROPERTY_VALUE_OUT_OF_RANGE	    0xA
> +#define HV_STATUS_INSUFFICIENT_MEMORY		    0xB
> +#define HV_STATUS_INVALID_PARTITION_ID		    0xD
> +#define HV_STATUS_INVALID_VP_INDEX		    0xE
> +#define HV_STATUS_NOT_FOUND			    0x10
> +#define HV_STATUS_INVALID_PORT_ID		    0x11
> +#define HV_STATUS_INVALID_CONNECTION_ID		    0x12
> +#define HV_STATUS_INSUFFICIENT_BUFFERS		    0x13
> +#define HV_STATUS_NOT_ACKNOWLEDGED		    0x14
> +#define HV_STATUS_INVALID_VP_STATE		    0x15
> +#define HV_STATUS_NO_RESOURCES			    0x1D
> +#define HV_STATUS_PROCESSOR_FEATURE_NOT_SUPPORTED   0x20
> +#define HV_STATUS_INVALID_LP_INDEX		    0x41
> +#define HV_STATUS_INVALID_REGISTER_VALUE	    0x50
> +#define HV_STATUS_OPERATION_FAILED		    0x71
> +#define HV_STATUS_TIME_OUT			    0x78
> +#define HV_STATUS_CALL_PENDING			    0x79
> +#define HV_STATUS_VTL_ALREADY_ENABLED		    0x86
> +
> +/*
> + * The Hyper-V TimeRefCount register and the TSC
> + * page provide a guest VM clock with 100ns tick rate
> + */
> +#define HV_CLOCK_HZ (NSEC_PER_SEC / 100)
> +
> +#define HV_HYP_PAGE_SHIFT		12
> +#define HV_HYP_PAGE_SIZE		BIT(HV_HYP_PAGE_SHIFT)
> +#define HV_HYP_PAGE_MASK		(~(HV_HYP_PAGE_SIZE - 1))
> +
> +#define HV_PARTITION_ID_INVALID		((u64)0)
> +#define HV_PARTITION_ID_SELF		((u64)-1)
> +
> +/* Hyper-V specific model specific registers (MSRs) */
> +
> +#if defined(CONFIG_X86)
> +/* HV_X64_SYNTHETIC_MSR */
> +#define HV_X64_MSR_GUEST_OS_ID			0x40000000
> +#define HV_X64_MSR_HYPERCALL			0x40000001
> +#define HV_X64_MSR_VP_INDEX			0x40000002
> +#define HV_X64_MSR_RESET			0x40000003
> +#define HV_X64_MSR_VP_RUNTIME			0x40000010
> +#define HV_X64_MSR_TIME_REF_COUNT		0x40000020
> +#define HV_X64_MSR_REFERENCE_TSC		0x40000021
> +#define HV_X64_MSR_TSC_FREQUENCY		0x40000022
> +#define HV_X64_MSR_APIC_FREQUENCY		0x40000023
> +
> +/* Define the virtual APIC registers */
> +#define HV_X64_MSR_EOI				0x40000070
> +#define HV_X64_MSR_ICR				0x40000071
> +#define HV_X64_MSR_TPR				0x40000072
> +#define HV_X64_MSR_VP_ASSIST_PAGE		0x40000073
> +
> +/* Define synthetic interrupt controller model specific registers. */
> +#define HV_X64_MSR_SCONTROL			0x40000080
> +#define HV_X64_MSR_SVERSION			0x40000081
> +#define HV_X64_MSR_SIEFP			0x40000082
> +#define HV_X64_MSR_SIMP				0x40000083
> +#define HV_X64_MSR_EOM				0x40000084
> +#define HV_X64_MSR_SIRBP			0x40000085
> +#define HV_X64_MSR_SINT0			0x40000090
> +#define HV_X64_MSR_SINT1			0x40000091
> +#define HV_X64_MSR_SINT2			0x40000092
> +#define HV_X64_MSR_SINT3			0x40000093
> +#define HV_X64_MSR_SINT4			0x40000094
> +#define HV_X64_MSR_SINT5			0x40000095
> +#define HV_X64_MSR_SINT6			0x40000096
> +#define HV_X64_MSR_SINT7			0x40000097
> +#define HV_X64_MSR_SINT8			0x40000098
> +#define HV_X64_MSR_SINT9			0x40000099
> +#define HV_X64_MSR_SINT10			0x4000009A
> +#define HV_X64_MSR_SINT11			0x4000009B
> +#define HV_X64_MSR_SINT12			0x4000009C
> +#define HV_X64_MSR_SINT13			0x4000009D
> +#define HV_X64_MSR_SINT14			0x4000009E
> +#define HV_X64_MSR_SINT15			0x4000009F
> +
> +/* Define synthetic interrupt controller model specific registers for nested hypervisor */
> +#define HV_X64_MSR_NESTED_SCONTROL		0x40001080
> +#define HV_X64_MSR_NESTED_SVERSION		0x40001081
> +#define HV_X64_MSR_NESTED_SIEFP			0x40001082
> +#define HV_X64_MSR_NESTED_SIMP			0x40001083
> +#define HV_X64_MSR_NESTED_EOM			0x40001084
> +#define HV_X64_MSR_NESTED_SINT0			0x40001090
> +
> +/*
> + * Synthetic Timer MSRs. Four timers per vcpu.
> + */
> +#define HV_X64_MSR_STIMER0_CONFIG		0x400000B0
> +#define HV_X64_MSR_STIMER0_COUNT		0x400000B1
> +#define HV_X64_MSR_STIMER1_CONFIG		0x400000B2
> +#define HV_X64_MSR_STIMER1_COUNT		0x400000B3
> +#define HV_X64_MSR_STIMER2_CONFIG		0x400000B4
> +#define HV_X64_MSR_STIMER2_COUNT		0x400000B5
> +#define HV_X64_MSR_STIMER3_CONFIG		0x400000B6
> +#define HV_X64_MSR_STIMER3_COUNT		0x400000B7
> +
> +/* Hyper-V guest idle MSR */
> +#define HV_X64_MSR_GUEST_IDLE			0x400000F0
> +
> +/* Hyper-V guest crash notification MSR's */
> +#define HV_X64_MSR_CRASH_P0			0x40000100
> +#define HV_X64_MSR_CRASH_P1			0x40000101
> +#define HV_X64_MSR_CRASH_P2			0x40000102
> +#define HV_X64_MSR_CRASH_P3			0x40000103
> +#define HV_X64_MSR_CRASH_P4			0x40000104
> +#define HV_X64_MSR_CRASH_CTL			0x40000105
> +
> +#define HV_X64_MSR_HYPERCALL_ENABLE		0x00000001
> +#define HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_SHIFT	12
> +#define HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_MASK	\
> +		(~((1ull << HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_SHIFT) - 1))
> +
> +#define HV_X64_MSR_CRASH_PARAMS		\
> +		(1 + (HV_X64_MSR_CRASH_P4 - HV_X64_MSR_CRASH_P0))
> +
> +#define HV_IPI_LOW_VECTOR	 0x10
> +#define HV_IPI_HIGH_VECTOR	 0xff
> +
> +#define HV_X64_MSR_VP_ASSIST_PAGE_ENABLE	0x00000001
> +#define HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_SHIFT	12
> +#define HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_MASK	\
> +		(~((1ull << HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_SHIFT) - 1))
> +
> +/* Hyper-V Enlightened VMCS version mask in nested features CPUID */
> +#define HV_X64_ENLIGHTENED_VMCS_VERSION		0xff
> +
> +#define HV_X64_MSR_TSC_REFERENCE_ENABLE		0x00000001
> +#define HV_X64_MSR_TSC_REFERENCE_ADDRESS_SHIFT	12
> +
> +/* Number of XMM registers used in hypercall input/output */
> +#define HV_HYPERCALL_MAX_XMM_REGISTERS		6
> +
> +struct hv_reenlightenment_control {
> +	u64 vector : 8;
> +	u64 reserved1 : 8;
> +	u64 enabled : 1;
> +	u64 reserved2 : 15;
> +	u64 target_vp : 32;
> +}  __packed;
> +
> +struct hv_tsc_emulation_status {	 /* HV_TSC_EMULATION_STATUS */
> +	u64 inprogress : 1;
> +	u64 reserved : 63;
> +} __packed;
> +
> +struct hv_tsc_emulation_control {	 /* HV_TSC_INVARIANT_CONTROL */
> +	u64 enabled : 1;
> +	u64 reserved : 63;
> +} __packed;
> +
> +/* TSC emulation after migration */
> +#define HV_X64_MSR_REENLIGHTENMENT_CONTROL	0x40000106
> +#define HV_X64_MSR_TSC_EMULATION_CONTROL	0x40000107
> +#define HV_X64_MSR_TSC_EMULATION_STATUS		0x40000108
> +#define HV_X64_MSR_TSC_INVARIANT_CONTROL	0x40000118
> +#define HV_EXPOSE_INVARIANT_TSC		BIT_ULL(0)
> +
> +#endif /* CONFIG_X86 */
> +
> +struct hv_get_partition_id {	 /* HV_OUTPUT_GET_PARTITION_ID */
> +	u64 partition_id;
> +} __packed;
> +
> +/* HV_CRASH_CTL_REG_CONTENTS */
> +#define HV_CRASH_CTL_CRASH_NOTIFY_MSG		 BIT_ULL(62)
> +#define HV_CRASH_CTL_CRASH_NOTIFY		 BIT_ULL(63)
> +
> +union hv_reference_tsc_msr {
> +	u64 as_uint64;
> +	struct {
> +		u64 enable : 1;
> +		u64 reserved : 11;
> +		u64 pfn : 52;
> +	} __packed;
> +};
> +
> +/* The maximum number of sparse vCPU banks which can be encoded by 'struct
> hv_vpset' */
> +#define HV_MAX_SPARSE_VCPU_BANKS (64)
> +/* The number of vCPUs in one sparse bank */
> +#define HV_VCPUS_PER_SPARSE_BANK (64)
> +
> +/* Some of Hyper-V structs do not use hv_vpset where linux uses them */
> +struct hv_vpset {	 /* HV_VP_SET */
> +	u64 format;
> +	u64 valid_bank_mask;
> +	u64 bank_contents[];
> +} __packed;
> +
> +/*
> + * Version info reported by hypervisor
> + * Changed to a union for convenience
> + */
> +union hv_hypervisor_version_info {
> +	struct {
> +		u32 build_number;
> +
> +		u32 minor_version : 16;
> +		u32 major_version : 16;
> +
> +		u32 service_pack;
> +
> +		u32 service_number : 24;
> +		u32 service_branch : 8;
> +	};
> +	struct {
> +		u32 eax;
> +		u32 ebx;
> +		u32 ecx;
> +		u32 edx;
> +	};
> +};
> +
> +/* HV_CPUID_FUNCTION */
> +#define HYPERV_CPUID_VENDOR_AND_MAX_FUNCTIONS	0x40000000
> +#define HYPERV_CPUID_INTERFACE			0x40000001
> +#define HYPERV_CPUID_VERSION			0x40000002
> +#define HYPERV_CPUID_FEATURES			0x40000003
> +#define HYPERV_CPUID_ENLIGHTMENT_INFO		0x40000004
> +#define HYPERV_CPUID_IMPLEMENT_LIMITS		0x40000005
> +#define HYPERV_CPUID_CPU_MANAGEMENT_FEATURES	0x40000007
> +#define HYPERV_CPUID_NESTED_FEATURES		0x4000000A
> +#define HYPERV_CPUID_ISOLATION_CONFIG		0x4000000C
> +
> +#define HYPERV_CPUID_VIRT_STACK_INTERFACE	 0x40000081
> +#define HYPERV_VS_INTERFACE_EAX_SIGNATURE	 0x31235356  /* "VS#1" */
> +
> +#define HYPERV_CPUID_VIRT_STACK_PROPERTIES	 0x40000082
> +/* Support for the extended IOAPIC RTE format */
> +#define HYPERV_VS_PROPERTIES_EAX_EXTENDED_IOAPIC_RTE	 BIT(2)
> +
> +#define HYPERV_HYPERVISOR_PRESENT_BIT		 0x80000000
> +#define HYPERV_CPUID_MIN			 0x40000005
> +#define HYPERV_CPUID_MAX			 0x4000ffff
> +
> +/* HV_PARTITION_PRIVILEGE_MASK */
> +#define HV_MSR_VP_RUNTIME_AVAILABLE			BIT(0)
> +#define HV_MSR_TIME_REF_COUNT_AVAILABLE			BIT(1)
> +#define HV_MSR_SYNIC_AVAILABLE				BIT(2)
> +#define HV_MSR_SYNTIMER_AVAILABLE			BIT(3)
> +#define HV_MSR_APIC_ACCESS_AVAILABLE			BIT(4)
> +#define HV_MSR_HYPERCALL_AVAILABLE			BIT(5)
> +#define HV_MSR_VP_INDEX_AVAILABLE			BIT(6)
> +#define HV_MSR_RESET_AVAILABLE				BIT(7)
> +#define HV_MSR_STAT_PAGES_AVAILABLE			BIT(8)
> +#define HV_MSR_REFERENCE_TSC_AVAILABLE			BIT(9)
> +#define HV_MSR_GUEST_IDLE_AVAILABLE			BIT(10)
> +#define HV_ACCESS_FREQUENCY_MSRS			BIT(11)
> +#define HV_ACCESS_REENLIGHTENMENT			BIT(13)
> +#define HV_ACCESS_TSC_INVARIANT				BIT(15)
> +
> +/* HV_PARTITION_PRIVILEGE_MASK */
> +#define HV_CREATE_PARTITIONS				BIT(0)
> +#define HV_ACCESS_PARTITION_ID				BIT(1)
> +#define HV_ACCESS_MEMORY_POOL				BIT(2)
> +#define HV_ADJUST_MESSAGE_BUFFERS			BIT(3)
> +#define HV_POST_MESSAGES				BIT(4)
> +#define HV_SIGNAL_EVENTS				BIT(5)
> +#define HV_CREATE_PORT					BIT(6)
> +#define HV_CONNECT_PORT					BIT(7)
> +#define HV_ACCESS_STATS					BIT(8)
> +#define HV_DEBUGGING					BIT(11)
> +#define HV_CPU_MANAGEMENT				BIT(12)
> +#define HV_ENABLE_EXTENDED_HYPERCALLS			BIT(20)
> +#define HV_ISOLATION					BIT(22)
> +
> +#if defined(CONFIG_X86)
> +/* HV_X64_HYPERVISOR_FEATURES (EDX) */
> +#define HV_X64_MWAIT_AVAILABLE				BIT(0)
> +#define HV_X64_GUEST_DEBUGGING_AVAILABLE		BIT(1)
> +#define HV_X64_PERF_MONITOR_AVAILABLE			BIT(2)
> +#define HV_X64_CPU_DYNAMIC_PARTITIONING_AVAILABLE	BIT(3)
> +#define HV_X64_HYPERCALL_XMM_INPUT_AVAILABLE		BIT(4)
> +#define HV_X64_GUEST_IDLE_STATE_AVAILABLE		BIT(5)
> +#define HV_FEATURE_FREQUENCY_MSRS_AVAILABLE		BIT(8)
> +#define HV_FEATURE_GUEST_CRASH_MSR_AVAILABLE		BIT(10)
> +#define HV_FEATURE_DEBUG_MSRS_AVAILABLE			BIT(11)
> +#define HV_FEATURE_EXT_GVA_RANGES_FLUSH			BIT(14)
> +/*
> + * Support for returning hypercall output block via XMM
> + * registers is available
> + */
> +#define HV_X64_HYPERCALL_XMM_OUTPUT_AVAILABLE		BIT(15)
> +/* stimer Direct Mode is available */
> +#define HV_STIMER_DIRECT_MODE_AVAILABLE			BIT(19)
> +
> +/* HV_X64_ENLIGHTENMENT_INFORMATION */
> +#define HV_X64_AS_SWITCH_RECOMMENDED			BIT(0)
> +#define HV_X64_LOCAL_TLB_FLUSH_RECOMMENDED		BIT(1)
> +#define HV_X64_REMOTE_TLB_FLUSH_RECOMMENDED		BIT(2)
> +#define HV_X64_APIC_ACCESS_RECOMMENDED			BIT(3)
> +#define HV_X64_SYSTEM_RESET_RECOMMENDED			BIT(4)
> +#define HV_X64_RELAXED_TIMING_RECOMMENDED		BIT(5)
> +#define HV_DEPRECATING_AEOI_RECOMMENDED			BIT(9)
> +#define HV_X64_CLUSTER_IPI_RECOMMENDED			BIT(10)
> +#define HV_X64_EX_PROCESSOR_MASKS_RECOMMENDED		BIT(11)
> +#define HV_X64_HYPERV_NESTED				BIT(12)
> +#define HV_X64_ENLIGHTENED_VMCS_RECOMMENDED		BIT(14)
> +#define HV_X64_USE_MMIO_HYPERCALLS			BIT(21)
> +
> +/*
> + * CPU management features identification.
> + * These are HYPERV_CPUID_CPU_MANAGEMENT_FEATURES.EAX bits.
> + */
> +#define HV_X64_START_LOGICAL_PROCESSOR			BIT(0)
> +#define HV_X64_CREATE_ROOT_VIRTUAL_PROCESSOR		BIT(1)
> +#define HV_X64_PERFORMANCE_COUNTER_SYNC			BIT(2)
> +#define HV_X64_RESERVED_IDENTITY_BIT			BIT(31)
> +
> +/*
> + * Virtual processor will never share a physical core with another virtual
> + * processor, except for virtual processors that are reported as sibling SMT
> + * threads.
> + */
> +#define HV_X64_NO_NONARCH_CORESHARING			BIT(18)
> +
> +/* Nested features. These are HYPERV_CPUID_NESTED_FEATURES.EAX bits. */
> +#define HV_X64_NESTED_DIRECT_FLUSH			BIT(17)
> +#define HV_X64_NESTED_GUEST_MAPPING_FLUSH		BIT(18)
> +#define HV_X64_NESTED_MSR_BITMAP			BIT(19)
> +
> +/* Nested features #2. These are HYPERV_CPUID_NESTED_FEATURES.EBX bits. */
> +#define HV_X64_NESTED_EVMCS1_PERF_GLOBAL_CTRL		BIT(0)
> +
> +/*
> + * This is specific to AMD and specifies that enlightened TLB flush is
> + * supported. If guest opts in to this feature, ASID invalidations only
> + * flushes gva -> hpa mapping entries. To flush the TLB entries derived
> + * from NPT, hypercalls should be used (HvFlushGuestPhysicalAddressSpace
> + * or HvFlushGuestPhysicalAddressList).
> + */
> +#define HV_X64_NESTED_ENLIGHTENED_TLB			BIT(22)
> +
> +/* HYPERV_CPUID_ISOLATION_CONFIG.EAX bits. */
> +#define HV_PARAVISOR_PRESENT				BIT(0)
> +
> +/* HYPERV_CPUID_ISOLATION_CONFIG.EBX bits. */
> +#define HV_ISOLATION_TYPE				GENMASK(3, 0)
> +#define HV_SHARED_GPA_BOUNDARY_ACTIVE			BIT(5)
> +#define HV_SHARED_GPA_BOUNDARY_BITS			GENMASK(11, 6)
> +
> +enum hv_isolation_type {
> +	HV_ISOLATION_TYPE_NONE	= 0,	/*
> HV_PARTITION_ISOLATION_TYPE_NONE */
> +	HV_ISOLATION_TYPE_VBS	= 1,
> +	HV_ISOLATION_TYPE_SNP	= 2,
> +	HV_ISOLATION_TYPE_TDX	= 3
> +};
> +
> +union hv_x64_msr_hypercall_contents {
> +	u64 as_uint64;
> +	struct {
> +		u64 enable : 1;
> +		u64 reserved : 11;
> +		u64 guest_physical_address : 52;
> +	} __packed;
> +};
> +#endif /* CONFIG_X86 */
> +
> +#if defined(CONFIG_ARM64)
> +#define HV_FEATURE_GUEST_CRASH_MSR_AVAILABLE	BIT(8)
> +#define HV_STIMER_DIRECT_MODE_AVAILABLE		BIT(13)
> +#endif /* CONFIG_ARM64 */
> +
> +#if defined(CONFIG_X86)
> +#define HV_MAXIMUM_PROCESSORS	    2048
> +#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
> +#define HV_MAXIMUM_PROCESSORS	    320
> +#endif /* CONFIG_ARM64 */
> +
> +#define HV_MAX_VP_INDEX			(HV_MAXIMUM_PROCESSORS - 1)
> +#define HV_VP_INDEX_SELF		((u32)-2)
> +#define HV_ANY_VP			((u32)-1)
> +
> +union hv_vp_assist_msr_contents {	 /* HV_REGISTER_VP_ASSIST_PAGE */
> +	u64 as_uint64;
> +	struct {
> +		u64 enable : 1;
> +		u64 reserved : 11;
> +		u64 pfn : 52;
> +	} __packed;
> +};
> +
> +/* Declare the various hypercall operations. */
> +/* HV_CALL_CODE */
> +#define HVCALL_FLUSH_VIRTUAL_ADDRESS_SPACE		0x0002
> +#define HVCALL_FLUSH_VIRTUAL_ADDRESS_LIST		0x0003
> +#define HVCALL_NOTIFY_LONG_SPIN_WAIT			0x0008
> +#define HVCALL_SEND_IPI					0x000b
> +#define HVCALL_ENABLE_VP_VTL				0x000f
> +#define HVCALL_FLUSH_VIRTUAL_ADDRESS_SPACE_EX		0x0013
> +#define HVCALL_FLUSH_VIRTUAL_ADDRESS_LIST_EX		0x0014
> +#define HVCALL_SEND_IPI_EX				0x0015
> +#define HVCALL_CREATE_PARTITION				0x0040
> +#define HVCALL_INITIALIZE_PARTITION			0x0041
> +#define HVCALL_FINALIZE_PARTITION			0x0042
> +#define HVCALL_DELETE_PARTITION				0x0043
> +#define HVCALL_GET_PARTITION_PROPERTY			0x0044
> +#define HVCALL_SET_PARTITION_PROPERTY			0x0045
> +#define HVCALL_GET_PARTITION_ID				0x0046
> +#define HVCALL_DEPOSIT_MEMORY				0x0048
> +#define HVCALL_WITHDRAW_MEMORY				0x0049
> +#define HVCALL_MAP_GPA_PAGES				0x004b
> +#define HVCALL_UNMAP_GPA_PAGES				0x004c
> +#define HVCALL_CREATE_VP				0x004e
> +#define HVCALL_DELETE_VP				0x004f
> +#define HVCALL_GET_VP_REGISTERS				0x0050
> +#define HVCALL_SET_VP_REGISTERS				0x0051
> +#define HVCALL_DELETE_PORT				0x0058
> +#define HVCALL_DISCONNECT_PORT				0x005b
> +#define HVCALL_POST_MESSAGE				0x005c
> +#define HVCALL_SIGNAL_EVENT				0x005d
> +#define HVCALL_POST_DEBUG_DATA				0x0069
> +#define HVCALL_RETRIEVE_DEBUG_DATA			0x006a
> +#define HVCALL_RESET_DEBUG_SESSION			0x006b
> +#define HVCALL_ADD_LOGICAL_PROCESSOR			0x0076
> +#define HVCALL_GET_SYSTEM_PROPERTY			0x007b
> +#define HVCALL_MAP_DEVICE_INTERRUPT			0x007c
> +#define HVCALL_UNMAP_DEVICE_INTERRUPT			0x007d
> +#define HVCALL_RETARGET_INTERRUPT			0x007e
> +#define HVCALL_NOTIFY_PORT_RING_EMPTY			0x008b
> +#define HVCALL_ASSERT_VIRTUAL_INTERRUPT			0x0094
> +#define HVCALL_CREATE_PORT				0x0095
> +#define HVCALL_CONNECT_PORT				0x0096
> +#define HVCALL_START_VP					0x0099
> +#define HVCALL_GET_VP_ID_FROM_APIC_ID			0x009a
> +#define HVCALL_FLUSH_GUEST_PHYSICAL_ADDRESS_SPACE	0x00af
> +#define HVCALL_FLUSH_GUEST_PHYSICAL_ADDRESS_LIST	0x00b0
> +#define HVCALL_DISPATCH_VP				0x00c2
> +#define HVCALL_MODIFY_SPARSE_GPA_PAGE_HOST_VISIBILITY	0x00db
> +#define HVCALL_MAP_VP_STATE_PAGE			0x00e1
> +#define HVCALL_UNMAP_VP_STATE_PAGE			0x00e2
> +#define HVCALL_GET_VP_STATE				0x00e3
> +#define HVCALL_SET_VP_STATE				0x00e4
> +#define HVCALL_MMIO_READ				0x0106
> +#define HVCALL_MMIO_WRITE				0x0107
> +
> +/* HV_HYPERCALL_INPUT */
> +#define HV_HYPERCALL_RESULT_MASK	GENMASK_ULL(15, 0)
> +#define HV_HYPERCALL_FAST_BIT		BIT(16)
> +#define HV_HYPERCALL_VARHEAD_OFFSET	17
> +#define HV_HYPERCALL_VARHEAD_MASK	GENMASK_ULL(26, 17)
> +#define HV_HYPERCALL_RSVD0_MASK		GENMASK_ULL(31, 27)
> +#define HV_HYPERCALL_NESTED		BIT_ULL(31)
> +#define HV_HYPERCALL_REP_COMP_OFFSET	32
> +#define HV_HYPERCALL_REP_COMP_1		BIT_ULL(32)
> +#define HV_HYPERCALL_REP_COMP_MASK	GENMASK_ULL(43, 32)
> +#define HV_HYPERCALL_RSVD1_MASK		GENMASK_ULL(47, 44)
> +#define HV_HYPERCALL_REP_START_OFFSET	48
> +#define HV_HYPERCALL_REP_START_MASK	GENMASK_ULL(59, 48)
> +#define HV_HYPERCALL_RSVD2_MASK		GENMASK_ULL(63, 60)
> +#define HV_HYPERCALL_RSVD_MASK		(HV_HYPERCALL_RSVD0_MASK | \
> +					 HV_HYPERCALL_RSVD1_MASK | \
> +					 HV_HYPERCALL_RSVD2_MASK)
> +
> +/* HvFlushGuestPhysicalAddressSpace hypercalls */
> +struct hv_guest_mapping_flush {
> +	u64 address_space;
> +	u64 flags;
> +} __packed;
> +
> +/*
> + *  HV_MAX_FLUSH_PAGES = "additional_pages" + 1. It's limited
> + *  by the bitwidth of "additional_pages" in union hv_gpa_page_range.
> + */
> +#define HV_MAX_FLUSH_PAGES (2048)
> +#define HV_GPA_PAGE_RANGE_PAGE_SIZE_2MB		0
> +#define HV_GPA_PAGE_RANGE_PAGE_SIZE_1GB		1
> +
> +#define HV_FLUSH_ALL_PROCESSORS			BIT(0)
> +#define HV_FLUSH_ALL_VIRTUAL_ADDRESS_SPACES	BIT(1)
> +#define HV_FLUSH_NON_GLOBAL_MAPPINGS_ONLY	BIT(2)
> +#define HV_FLUSH_USE_EXTENDED_RANGE_FORMAT	BIT(3)
> +
> +/* HvFlushGuestPhysicalAddressList, HvExtCallMemoryHeatHint hypercall */
> +union hv_gpa_page_range {
> +	u64 address_space;
> +	struct {
> +		u64 additional_pages : 11;
> +		u64 largepage : 1;
> +		u64 basepfn : 52;
> +	} page;
> +	struct {
> +		u64 reserved : 12;
> +		u64 page_size : 1;
> +		u64 reserved1 : 8;
> +		u64 base_large_pfn : 43;
> +	};
> +};
> +
> +/*
> + * All input flush parameters should be in single page. The max flush
> + * count is equal with how many entries of union hv_gpa_page_range can
> + * be populated into the input parameter page.
> + */
> +#define HV_MAX_FLUSH_REP_COUNT ((HV_HYP_PAGE_SIZE - 2 * sizeof(u64)) / \
> +				sizeof(union hv_gpa_page_range))
> +
> +struct hv_guest_mapping_flush_list {
> +	u64 address_space;
> +	u64 flags;
> +	union hv_gpa_page_range gpa_list[HV_MAX_FLUSH_REP_COUNT];
> +};
> +
> +struct hv_tlb_flush {	 /* HV_INPUT_FLUSH_VIRTUAL_ADDRESS_LIST */
> +	u64 address_space;
> +	u64 flags;
> +	u64 processor_mask;
> +	u64 gva_list[];
> +} __packed;
> +
> +/* HvFlushVirtualAddressSpaceEx, HvFlushVirtualAddressListEx hypercalls */
> +struct hv_tlb_flush_ex {
> +	u64 address_space;
> +	u64 flags;
> +	struct hv_vpset hv_vp_set;
> +	u64 gva_list[];
> +} __packed;
> +
> +struct ms_hyperv_tsc_page {	 /* HV_REFERENCE_TSC_PAGE */
> +	volatile u32 tsc_sequence;
> +	u32 reserved1;
> +	volatile u64 tsc_scale;
> +	volatile s64 tsc_offset;
> +} __packed;
> +
> +/* Define the number of synthetic interrupt sources. */
> +#define HV_SYNIC_SINT_COUNT (16)
> +
> +/* Define the expected SynIC version. */
> +#define HV_SYNIC_VERSION_1		(0x1)
> +/* Valid SynIC vectors are 16-255. */
> +#define HV_SYNIC_FIRST_VALID_VECTOR	(16)
> +
> +#define HV_SYNIC_CONTROL_ENABLE		(1ULL << 0)
> +#define HV_SYNIC_SIMP_ENABLE		(1ULL << 0)
> +#define HV_SYNIC_SIEFP_ENABLE		(1ULL << 0)
> +#define HV_SYNIC_SINT_MASKED		(1ULL << 16)
> +#define HV_SYNIC_SINT_AUTO_EOI		(1ULL << 17)
> +#define HV_SYNIC_SINT_VECTOR_MASK	(0xFF)
> +
> +#
> +
> +/* Hyper-V defined statically assigned SINTs */
> +#define HV_SYNIC_INTERCEPTION_SINT_INDEX 0x00000000
> +#define HV_SYNIC_IOMMU_FAULT_SINT_INDEX  0x00000001
> +#define HV_SYNIC_VMBUS_SINT_INDEX	 0x00000002
> +#define HV_SYNIC_FIRST_UNUSED_SINT_INDEX 0x00000005
> +
> +/* mshv assigned SINT for doorbell */
> +#define HV_SYNIC_DOORBELL_SINT_INDEX     HV_SYNIC_FIRST_UNUSED_SINT_INDEX
> +
> +enum hv_interrupt_type {
> +	HV_X64_INTERRUPT_TYPE_FIXED		= 0x0000,
> +	HV_X64_INTERRUPT_TYPE_LOWESTPRIORITY	= 0x0001,
> +	HV_X64_INTERRUPT_TYPE_SMI		= 0x0002,
> +	HV_X64_INTERRUPT_TYPE_REMOTEREAD	= 0x0003,
> +	HV_X64_INTERRUPT_TYPE_NMI		= 0x0004,
> +	HV_X64_INTERRUPT_TYPE_INIT		= 0x0005,
> +	HV_X64_INTERRUPT_TYPE_SIPI		= 0x0006,
> +	HV_X64_INTERRUPT_TYPE_EXTINT		= 0x0007,
> +	HV_X64_INTERRUPT_TYPE_LOCALINT0		= 0x0008,
> +	HV_X64_INTERRUPT_TYPE_LOCALINT1		= 0x0009,
> +	HV_X64_INTERRUPT_TYPE_MAXIMUM		= 0x000A,
> +};
> +
> +/* Define synthetic interrupt source. */
> +union hv_synic_sint {
> +	u64 as_uint64;
> +	struct {
> +		u64 vector : 8;
> +		u64 reserved1 : 8;
> +		u64 masked : 1;
> +		u64 auto_eoi : 1;
> +		u64 polling : 1;
> +		u64 as_intercept : 1;
> +		u64 proxy : 1;
> +		u64 reserved2 : 43;
> +	} __packed;
> +};
> +
> +union hv_x64_xsave_xfem_register {
> +	u64 as_uint64;
> +	struct {
> +		u32 low_uint32;
> +		u32 high_uint32;
> +	} __packed;
> +	struct {
> +		u64 legacy_x87 : 1;
> +		u64 legacy_sse : 1;
> +		u64 avx : 1;
> +		u64 mpx_bndreg : 1;
> +		u64 mpx_bndcsr : 1;
> +		u64 avx_512_op_mask : 1;
> +		u64 avx_512_zmmhi : 1;
> +		u64 avx_512_zmm16_31 : 1;
> +		u64 rsvd8_9 : 2;
> +		u64 pasid : 1;
> +		u64 cet_u : 1;
> +		u64 cet_s : 1;
> +		u64 rsvd13_16 : 4;
> +		u64 xtile_cfg : 1;
> +		u64 xtile_data : 1;
> +		u64 rsvd19_63 : 45;
> +	} __packed;
> +};
> +
> +/* Synthetic timer configuration */
> +union hv_stimer_config {	 /* HV_X64_MSR_STIMER_CONFIG_CONTENTS */
> +	u64 as_uint64;
> +	struct {
> +		u64 enable : 1;
> +		u64 periodic : 1;
> +		u64 lazy : 1;
> +		u64 auto_enable : 1;
> +		u64 apic_vector : 8;
> +		u64 direct_mode : 1;
> +		u64 reserved_z0 : 3;
> +		u64 sintx : 4;
> +		u64 reserved_z1 : 44;
> +	} __packed;
> +};
> +
> +/* Define the number of synthetic timers */
> +#define HV_SYNIC_STIMER_COUNT	(4)
> +
> +/* Define port identifier type. */
> +union hv_port_id {
> +	u32 asu32;
> +	struct {
> +		u32 id : 24;
> +		u32 reserved : 8;
> +	} __packed u;
> +};
> +
> +#define HV_MESSAGE_SIZE			(256)
> +#define HV_MESSAGE_PAYLOAD_BYTE_COUNT	(240)
> +#define HV_MESSAGE_PAYLOAD_QWORD_COUNT	(30)
> +
> +/* Define hypervisor message types. */
> +enum hv_message_type {
> +	HVMSG_NONE				= 0x00000000,
> +
> +	/* Memory access messages. */
> +	HVMSG_UNMAPPED_GPA			= 0x80000000,
> +	HVMSG_GPA_INTERCEPT			= 0x80000001,
> +
> +	/* Timer notification messages. */
> +	HVMSG_TIMER_EXPIRED			= 0x80000010,
> +
> +	/* Error messages. */
> +	HVMSG_INVALID_VP_REGISTER_VALUE		= 0x80000020,
> +	HVMSG_UNRECOVERABLE_EXCEPTION		= 0x80000021,
> +	HVMSG_UNSUPPORTED_FEATURE		= 0x80000022,
> +
> +	/*
> +	 * Opaque intercept message. The original intercept message is only
> +	 * accessible from the mapped intercept message page.
> +	 */
> +	HVMSG_OPAQUE_INTERCEPT			= 0x8000003F,
> +
> +	/* Trace buffer complete messages. */
> +	HVMSG_EVENTLOG_BUFFERCOMPLETE		= 0x80000040,
> +
> +	/* Hypercall intercept */
> +	HVMSG_HYPERCALL_INTERCEPT		= 0x80000050,
> +
> +	/* SynIC intercepts */
> +	HVMSG_SYNIC_EVENT_INTERCEPT		= 0x80000060,
> +	HVMSG_SYNIC_SINT_INTERCEPT		= 0x80000061,
> +	HVMSG_SYNIC_SINT_DELIVERABLE	= 0x80000062,
> +
> +	/* Async call completion intercept */
> +	HVMSG_ASYNC_CALL_COMPLETION		= 0x80000070,
> +
> +	/* Root scheduler messages */
> +	HVMSG_SCHEDULER_VP_SIGNAL_BITSET	= 0x80000100,
> +	HVMSG_SCHEDULER_VP_SIGNAL_PAIR		= 0x80000101,
> +
> +	/* Platform-specific processor intercept messages. */
> +	HVMSG_X64_IO_PORT_INTERCEPT		= 0x80010000,
> +	HVMSG_X64_MSR_INTERCEPT			= 0x80010001,
> +	HVMSG_X64_CPUID_INTERCEPT		= 0x80010002,
> +	HVMSG_X64_EXCEPTION_INTERCEPT		= 0x80010003,
> +	HVMSG_X64_APIC_EOI			= 0x80010004,
> +	HVMSG_X64_LEGACY_FP_ERROR		= 0x80010005,
> +	HVMSG_X64_IOMMU_PRQ			= 0x80010006,
> +	HVMSG_X64_HALT				= 0x80010007,
> +	HVMSG_X64_INTERRUPTION_DELIVERABLE	= 0x80010008,
> +	HVMSG_X64_SIPI_INTERCEPT		= 0x80010009,
> +};
> +
> +/* Define the format of the SIMP register */
> +union hv_synic_simp {
> +	u64 as_uint64;
> +	struct {
> +		u64 simp_enabled : 1;
> +		u64 preserved : 11;
> +		u64 base_simp_gpa : 52;
> +	} __packed;
> +};
> +
> +union hv_message_flags {
> +	u8 asu8;
> +	struct {
> +		u8 msg_pending : 1;
> +		u8 reserved : 7;
> +	} __packed;
> +};
> +
> +struct hv_message_header {
> +	u32 message_type;
> +	u8 payload_size;
> +	union hv_message_flags message_flags;
> +	u8 reserved[2];
> +	union {
> +		u64 sender;
> +		union hv_port_id port;
> +	};
> +} __packed;
> +
> +/*
> + * Message format for notifications delivered via
> + * intercept message(as_intercept=1)
> + */
> +struct hv_notification_message_payload {
> +	u32 sint_index;
> +} __packed;
> +
> +struct hv_message {
> +	struct hv_message_header header;
> +	union {
> +		u64 payload[HV_MESSAGE_PAYLOAD_QWORD_COUNT];
> +	} u;
> +} __packed;
> +
> +/* Define the synthetic interrupt message page layout. */
> +struct hv_message_page {
> +	struct hv_message sint_message[HV_SYNIC_SINT_COUNT];
> +} __packed;
> +
> +/* Define timer message payload structure. */
> +struct hv_timer_message_payload {
> +	__u32 timer_index;
> +	__u32 reserved;
> +	__u64 expiration_time;	/* When the timer expired */
> +	__u64 delivery_time;	/* When the message was delivered */
> +} __packed;
> +
> +struct hv_x64_segment_register {
> +	u64 base;
> +	u32 limit;
> +	u16 selector;
> +	union {
> +		struct {
> +			u16 segment_type : 4;
> +			u16 non_system_segment : 1;
> +			u16 descriptor_privilege_level : 2;
> +			u16 present : 1;
> +			u16 reserved : 4;
> +			u16 available : 1;
> +			u16 _long : 1;
> +			u16 _default : 1;
> +			u16 granularity : 1;
> +		} __packed;
> +		u16 attributes;
> +	};
> +} __packed;
> +
> +struct hv_x64_table_register {
> +	u16 pad[3];
> +	u16 limit;
> +	u64 base;
> +} __packed;
> +
> +union hv_input_vtl {
> +	u8 as_uint8;
> +	struct {
> +		u8 target_vtl : 4;
> +		u8 use_target_vtl : 1;
> +		u8 reserved_z : 3;
> +	};
> +} __packed;
> +
> +struct hv_init_vp_context {
> +	u64 rip;
> +	u64 rsp;
> +	u64 rflags;
> +
> +	struct hv_x64_segment_register cs;
> +	struct hv_x64_segment_register ds;
> +	struct hv_x64_segment_register es;
> +	struct hv_x64_segment_register fs;
> +	struct hv_x64_segment_register gs;
> +	struct hv_x64_segment_register ss;
> +	struct hv_x64_segment_register tr;
> +	struct hv_x64_segment_register ldtr;
> +
> +	struct hv_x64_table_register idtr;
> +	struct hv_x64_table_register gdtr;
> +
> +	u64 efer;
> +	u64 cr0;
> +	u64 cr3;
> +	u64 cr4;
> +	u64 msr_cr_pat;
> +} __packed;
> +
> +struct hv_enable_vp_vtl {
> +	u64				partition_id;
> +	u32				vp_index;
> +	union hv_input_vtl		target_vtl;
> +	u8				mbz0;
> +	u16				mbz1;
> +	struct hv_init_vp_context	vp_context;
> +} __packed;
> +
> +struct hv_get_vp_from_apic_id_in {
> +	u64 partition_id;
> +	union hv_input_vtl target_vtl;
> +	u8 res[7];
> +	u32 apic_ids[];
> +} __packed;
> +
> +struct hv_nested_enlightenments_control {
> +	struct {
> +		u32 directhypercall : 1;
> +		u32 reserved : 31;
> +	} __packed features;
> +	struct {
> +		u32 inter_partition_comm : 1;
> +		u32 reserved : 31;
> +	} __packed hypercall_controls;
> +} __packed;
> +
> +/* Define virtual processor assist page structure. */
> +struct hv_vp_assist_page {
> +	u32 apic_assist;
> +	u32 reserved1;
> +	u32 vtl_entry_reason;
> +	u32 vtl_reserved;
> +	u64 vtl_ret_x64rax;
> +	u64 vtl_ret_x64rcx;
> +	struct hv_nested_enlightenments_control nested_control;
> +	u8 enlighten_vmentry;
> +	u8 reserved2[7];
> +	u64 current_nested_vmcs;
> +	u8 synthetic_time_unhalted_timer_expired;
> +	u8 reserved3[7];
> +	u8 virtualization_fault_information[40];
> +	u8 reserved4[8];
> +	u8 intercept_message[256];
> +	u8 vtl_ret_actions[256];
> +} __packed;
> +
> +enum hv_register_name {
> +	/* Suspend Registers */
> +	HV_REGISTER_EXPLICIT_SUSPEND				= 0x00000000,
> +	HV_REGISTER_INTERCEPT_SUSPEND				= 0x00000001,
> +	HV_REGISTER_DISPATCH_SUSPEND				= 0x00000003,
> +
> +	/* Version - 128-bit result same as CPUID 0x40000002 */
> +	HV_REGISTER_HYPERVISOR_VERSION				= 0x00000100,
> +
> +	/* Feature Access (registers are 128 bits) - same as CPUID 0x40000003 -
> 0x4000000B */
> +	HV_REGISTER_PRIVILEGES_AND_FEATURES_INFO		= 0x00000200,
> +	HV_REGISTER_FEATURES_INFO				= 0x00000201,
> +	HV_REGISTER_IMPLEMENTATION_LIMITS_INFO			=
> 0x00000202,
> +	HV_REGISTER_HARDWARE_FEATURES_INFO			= 0x00000203,
> +	HV_REGISTER_CPU_MANAGEMENT_FEATURES_INFO		= 0x00000204,
> +	HV_REGISTER_SVM_FEATURES_INFO				= 0x00000205,
> +	HV_REGISTER_SKIP_LEVEL_FEATURES_INFO			= 0x00000206,
> +	HV_REGISTER_NESTED_VIRT_FEATURES_INFO			= 0x00000207,
> +	HV_REGISTER_IPT_FEATURES_INFO				= 0x00000208,
> +
> +	/* Guest Crash Registers */
> +	HV_REGISTER_GUEST_CRASH_P0				= 0x00000210,
> +	HV_REGISTER_GUEST_CRASH_P1				= 0x00000211,
> +	HV_REGISTER_GUEST_CRASH_P2				= 0x00000212,
> +	HV_REGISTER_GUEST_CRASH_P3				= 0x00000213,
> +	HV_REGISTER_GUEST_CRASH_P4				= 0x00000214,
> +	HV_REGISTER_GUEST_CRASH_CTL				= 0x00000215,
> +
> +	/* Misc */
> +	HV_REGISTER_VP_RUNTIME					= 0x00090000,
> +	HV_REGISTER_GUEST_OS_ID					= 0x00090002,
> +	HV_REGISTER_VP_INDEX					= 0x00090003,
> +	HV_REGISTER_TIME_REF_COUNT				= 0x00090004,
> +	HV_REGISTER_CPU_MANAGEMENT_VERSION			= 0x00090007,
> +	HV_REGISTER_VP_ASSIST_PAGE				= 0x00090013,
> +	HV_REGISTER_VP_ROOT_SIGNAL_COUNT			= 0x00090014,
> +	HV_REGISTER_REFERENCE_TSC				= 0x00090017,
> +
> +	/* Hypervisor-defined Registers (Synic) */
> +	HV_REGISTER_SINT0					= 0x000A0000,
> +	HV_REGISTER_SINT1					= 0x000A0001,
> +	HV_REGISTER_SINT2					= 0x000A0002,
> +	HV_REGISTER_SINT3					= 0x000A0003,
> +	HV_REGISTER_SINT4					= 0x000A0004,
> +	HV_REGISTER_SINT5					= 0x000A0005,
> +	HV_REGISTER_SINT6					= 0x000A0006,
> +	HV_REGISTER_SINT7					= 0x000A0007,
> +	HV_REGISTER_SINT8					= 0x000A0008,
> +	HV_REGISTER_SINT9					= 0x000A0009,
> +	HV_REGISTER_SINT10					= 0x000A000A,
> +	HV_REGISTER_SINT11					= 0x000A000B,
> +	HV_REGISTER_SINT12					= 0x000A000C,
> +	HV_REGISTER_SINT13					= 0x000A000D,
> +	HV_REGISTER_SINT14					= 0x000A000E,
> +	HV_REGISTER_SINT15					= 0x000A000F,
> +	HV_REGISTER_SCONTROL					= 0x000A0010,
> +	HV_REGISTER_SVERSION					= 0x000A0011,
> +	HV_REGISTER_SIEFP					= 0x000A0012,
> +	HV_REGISTER_SIMP					= 0x000A0013,
> +	HV_REGISTER_EOM						= 0x000A0014,
> +	HV_REGISTER_SIRBP					= 0x000A0015,
> +
> +	HV_REGISTER_NESTED_SINT0				= 0x000A1000,
> +	HV_REGISTER_NESTED_SINT1				= 0x000A1001,
> +	HV_REGISTER_NESTED_SINT2				= 0x000A1002,
> +	HV_REGISTER_NESTED_SINT3				= 0x000A1003,
> +	HV_REGISTER_NESTED_SINT4				= 0x000A1004,
> +	HV_REGISTER_NESTED_SINT5				= 0x000A1005,
> +	HV_REGISTER_NESTED_SINT6				= 0x000A1006,
> +	HV_REGISTER_NESTED_SINT7				= 0x000A1007,
> +	HV_REGISTER_NESTED_SINT8				= 0x000A1008,
> +	HV_REGISTER_NESTED_SINT9				= 0x000A1009,
> +	HV_REGISTER_NESTED_SINT10				= 0x000A100A,
> +	HV_REGISTER_NESTED_SINT11				= 0x000A100B,
> +	HV_REGISTER_NESTED_SINT12				= 0x000A100C,
> +	HV_REGISTER_NESTED_SINT13				= 0x000A100D,
> +	HV_REGISTER_NESTED_SINT14				= 0x000A100E,
> +	HV_REGISTER_NESTED_SINT15				= 0x000A100F,
> +	HV_REGISTER_NESTED_SCONTROL				= 0x000A1010,
> +	HV_REGISTER_NESTED_SVERSION				= 0x000A1011,
> +	HV_REGISTER_NESTED_SIFP					= 0x000A1012,
> +	HV_REGISTER_NESTED_SIPP					= 0x000A1013,
> +	HV_REGISTER_NESTED_EOM					= 0x000A1014,
> +	HV_REGISTER_NESTED_SIRBP				= 0x000a1015,
> +
> +	/* Hypervisor-defined Registers (Synthetic Timers) */
> +	HV_REGISTER_STIMER0_CONFIG				= 0x000B0000,
> +	HV_REGISTER_STIMER0_COUNT				= 0x000B0001,
> +
> +	/* VSM */
> +	HV_X64_REGISTER_VSM_VP_STATUS				= 0x000D0003,
> +};
> +
> +/*
> + * Arch compatibility regs for use with hv_set/get_register
> + */
> +#if defined(CONFIG_X86)
> +
> +/*
> + * To support arch-generic code calling hv_set/get_register:
> + * - On x86, HV_MSR_ indicates an MSR accessed via rdmsrl/wrmsrl
> + * - On ARM, HV_MSR_ indicates a VP register accessed via hypercall
> + */
> +#define HV_MSR_CRASH_P0		(HV_X64_MSR_CRASH_P0)
> +#define HV_MSR_CRASH_P1		(HV_X64_MSR_CRASH_P1)
> +#define HV_MSR_CRASH_P2		(HV_X64_MSR_CRASH_P2)
> +#define HV_MSR_CRASH_P3		(HV_X64_MSR_CRASH_P3)
> +#define HV_MSR_CRASH_P4		(HV_X64_MSR_CRASH_P4)
> +#define HV_MSR_CRASH_CTL	(HV_X64_MSR_CRASH_CTL)
> +
> +#define HV_MSR_VP_INDEX		(HV_X64_MSR_VP_INDEX)
> +#define HV_MSR_TIME_REF_COUNT	(HV_X64_MSR_TIME_REF_COUNT)
> +#define HV_MSR_REFERENCE_TSC	(HV_X64_MSR_REFERENCE_TSC)
> +
> +#define HV_MSR_SINT0		(HV_X64_MSR_SINT0)
> +#define HV_MSR_SVERSION		(HV_X64_MSR_SVERSION)
> +#define HV_MSR_SCONTROL		(HV_X64_MSR_SCONTROL)
> +#define HV_MSR_SIEFP		(HV_X64_MSR_SIEFP)
> +#define HV_MSR_SIMP		(HV_X64_MSR_SIMP)
> +#define HV_MSR_EOM		(HV_X64_MSR_EOM)
> +#define HV_MSR_SIRBP		(HV_X64_MSR_SIRBP)
> +
> +#define HV_MSR_NESTED_SCONTROL	(HV_X64_MSR_NESTED_SCONTROL)
> +#define HV_MSR_NESTED_SVERSION	(HV_X64_MSR_NESTED_SVERSION)
> +#define HV_MSR_NESTED_SIEFP	(HV_X64_MSR_NESTED_SIEFP)
> +#define HV_MSR_NESTED_SIMP	(HV_X64_MSR_NESTED_SIMP)
> +#define HV_MSR_NESTED_EOM	(HV_X64_MSR_NESTED_EOM)
> +#define HV_MSR_NESTED_SINT0	(HV_X64_MSR_NESTED_SINT0)
> +
> +#define HV_MSR_STIMER0_CONFIG	(HV_X64_MSR_STIMER0_CONFIG)
> +#define HV_MSR_STIMER0_COUNT	(HV_X64_MSR_STIMER0_COUNT)
> +
> +#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
> +
> +#define HV_MSR_CRASH_P0		(HV_REGISTER_GUEST_CRASH_P0)
> +#define HV_MSR_CRASH_P1		(HV_REGISTER_GUEST_CRASH_P1)
> +#define HV_MSR_CRASH_P2		(HV_REGISTER_GUEST_CRASH_P2)
> +#define HV_MSR_CRASH_P3		(HV_REGISTER_GUEST_CRASH_P3)
> +#define HV_MSR_CRASH_P4		(HV_REGISTER_GUEST_CRASH_P4)
> +#define HV_MSR_CRASH_CTL	(HV_REGISTER_GUEST_CRASH_CTL)
> +
> +#define HV_MSR_VP_INDEX		(HV_REGISTER_VP_INDEX)
> +#define HV_MSR_TIME_REF_COUNT	(HV_REGISTER_TIME_REF_COUNT)
> +#define HV_MSR_REFERENCE_TSC	(HV_REGISTER_REFERENCE_TSC)
> +
> +#define HV_MSR_SINT0		(HV_REGISTER_SINT0)
> +#define HV_MSR_SCONTROL		(HV_REGISTER_SCONTROL)
> +#define HV_MSR_SIEFP		(HV_REGISTER_SIEFP)
> +#define HV_MSR_SIMP		(HV_REGISTER_SIMP)
> +#define HV_MSR_EOM		(HV_REGISTER_EOM)
> +#define HV_MSR_SIRBP		(HV_REGISTER_SIRBP)
> +
> +#define HV_MSR_STIMER0_CONFIG	(HV_REGISTER_STIMER0_CONFIG)
> +#define HV_MSR_STIMER0_COUNT	(HV_REGISTER_STIMER0_COUNT)
> +
> +#endif /* CONFIG_ARM64 */
> +
> +union hv_explicit_suspend_register {
> +	u64 as_uint64;
> +	struct {
> +		u64 suspended : 1;
> +		u64 reserved : 63;
> +	} __packed;
> +};
> +
> +union hv_intercept_suspend_register {
> +	u64 as_uint64;
> +	struct {
> +		u64 suspended : 1;
> +		u64 reserved : 63;
> +	} __packed;
> +};
> +
> +union hv_dispatch_suspend_register {
> +	u64 as_uint64;
> +	struct {
> +		u64 suspended : 1;
> +		u64 reserved : 63;
> +	} __packed;
> +};
> +
> +union hv_x64_interrupt_state_register {
> +	u64 as_uint64;
> +	struct {
> +		u64 interrupt_shadow : 1;
> +		u64 nmi_masked : 1;
> +		u64 reserved : 62;
> +	} __packed;
> +};
> +
> +union hv_x64_pending_interruption_register {
> +	u64 as_uint64;
> +	struct {
> +		u32 interruption_pending : 1;
> +		u32 interruption_type : 3;
> +		u32 deliver_error_code : 1;
> +		u32 instruction_length : 4;
> +		u32 nested_event : 1;
> +		u32 reserved : 6;
> +		u32 interruption_vector : 16;
> +		u32 error_code;
> +	} __packed;
> +};
> +
> +union hv_register_value {
> +	struct hv_u128 reg128;
> +	u64 reg64;
> +	u32 reg32;
> +	u16 reg16;
> +	u8 reg8;
> +
> +	struct hv_x64_segment_register segment;
> +	struct hv_x64_table_register table;
> +	union hv_explicit_suspend_register explicit_suspend;
> +	union hv_intercept_suspend_register intercept_suspend;
> +	union hv_dispatch_suspend_register dispatch_suspend;
> +	union hv_x64_interrupt_state_register interrupt_state;
> +	union hv_x64_pending_interruption_register pending_interruption;
> +};
> +
> +#if defined(CONFIG_ARM64)
> +/* HvGetVpRegisters returns an array of these output elements */
> +struct hv_get_vp_registers_output {
> +	union {
> +		struct {
> +			u32 a;
> +			u32 b;
> +			u32 c;
> +			u32 d;
> +		} as32 __packed;
> +		struct {
> +			u64 low;
> +			u64 high;
> +		} as64 __packed;
> +	};
> +};
> +
> +#endif /* CONFIG_ARM64 */
> +
> +struct hv_register_assoc {
> +	u32 name;			/* enum hv_register_name */
> +	u32 reserved1;
> +	u64 reserved2;
> +	union hv_register_value value;
> +} __packed;
> +
> +struct hv_input_get_vp_registers {
> +	u64 partition_id;
> +	u32 vp_index;
> +	union hv_input_vtl input_vtl;
> +	u8  rsvd_z8;
> +	u16 rsvd_z16;
> +	u32 names[];
> +} __packed;
> +
> +struct hv_input_set_vp_registers {
> +	u64 partition_id;
> +	u32 vp_index;
> +	union hv_input_vtl input_vtl;
> +	u8  rsvd_z8;
> +	u16 rsvd_z16;
> +	struct hv_register_assoc elements[];
> +} __packed;
> +
> +#define HV_UNMAP_GPA_LARGE_PAGE		0x2
> +
> +/* HvCallSendSyntheticClusterIpi hypercall */
> +struct hv_send_ipi {	 /* HV_INPUT_SEND_SYNTHETIC_CLUSTER_IPI */
> +	u32 vector;
> +	u32 reserved;
> +	u64 cpu_mask;
> +} __packed;
> +
> +#define	HV_X64_VTL_MASK			GENMASK(3, 0)
> +
> +/* Hyper-V memory host visibility */
> +enum hv_mem_host_visibility {
> +	VMBUS_PAGE_NOT_VISIBLE		= 0,
> +	VMBUS_PAGE_VISIBLE_READ_ONLY	= 1,
> +	VMBUS_PAGE_VISIBLE_READ_WRITE	= 3
> +};
> +
> +/* HvCallModifySparseGpaPageHostVisibility hypercall */
> +#define HV_MAX_MODIFY_GPA_REP_COUNT	((HV_HYP_PAGE_SIZE / sizeof(u64)) -
> 2)
> +struct hv_gpa_range_for_visibility {
> +	u64 partition_id;
> +	u32 host_visibility : 2;
> +	u32 reserved0 : 30;
> +	u32 reserved1;
> +	u64 gpa_page_list[HV_MAX_MODIFY_GPA_REP_COUNT];
> +} __packed;
> +
> +#if defined(CONFIG_X86)
> +union hv_msi_address_register { /* HV_MSI_ADDRESS */
> +	u32 as_uint32;
> +	struct {
> +		u32 reserved1 : 2;
> +		u32 destination_mode : 1;
> +		u32 redirection_hint : 1;
> +		u32 reserved2 : 8;
> +		u32 destination_id : 8;
> +		u32 msi_base : 12;
> +	};
> +} __packed;
> +
> +union hv_msi_data_register {	 /* HV_MSI_ENTRY.Data */
> +	u32 as_uint32;
> +	struct {
> +		u32 vector : 8;
> +		u32 delivery_mode : 3;
> +		u32 reserved1 : 3;
> +		u32 level_assert : 1;
> +		u32 trigger_mode : 1;
> +		u32 reserved2 : 16;
> +	};
> +} __packed;
> +
> +union hv_msi_entry {	 /* HV_MSI_ENTRY */
> +
> +	u64 as_uint64;
> +	struct {
> +		union hv_msi_address_register address;
> +		union hv_msi_data_register data;
> +	} __packed;
> +};
> +
> +#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
> +
> +union hv_msi_entry {
> +	u64 as_uint64[2];
> +	struct {
> +		u64 address;
> +		u32 data;
> +		u32 reserved;
> +	} __packed;
> +};
> +#endif /* CONFIG_ARM64 */
> +
> +union hv_ioapic_rte {
> +	u64 as_uint64;
> +
> +	struct {
> +		u32 vector : 8;
> +		u32 delivery_mode : 3;
> +		u32 destination_mode : 1;
> +		u32 delivery_status : 1;
> +		u32 interrupt_polarity : 1;
> +		u32 remote_irr : 1;
> +		u32 trigger_mode : 1;
> +		u32 interrupt_mask : 1;
> +		u32 reserved1 : 15;
> +
> +		u32 reserved2 : 24;
> +		u32 destination_id : 8;
> +	};
> +
> +	struct {
> +		u32 low_uint32;
> +		u32 high_uint32;
> +	};
> +} __packed;
> +
> +enum hv_interrupt_source {	 /* HV_INTERRUPT_SOURCE */
> +	HV_INTERRUPT_SOURCE_MSI = 1, /* MSI and MSI-X */
> +	HV_INTERRUPT_SOURCE_IOAPIC,
> +};
> +
> +struct hv_interrupt_entry {	 /* HV_INTERRUPT_ENTRY */
> +	u32 source;
> +	u32 reserved1;
> +	union {
> +		union hv_msi_entry msi_entry;
> +		union hv_ioapic_rte ioapic_rte;
> +	};
> +} __packed;
> +
> +#define HV_DEVICE_INTERRUPT_TARGET_MULTICAST		1
> +#define HV_DEVICE_INTERRUPT_TARGET_PROCESSOR_SET	2
> +
> +struct hv_device_interrupt_target {	 /* HV_DEVICE_INTERRUPT_TARGET */
> +	u32 vector;
> +	u32 flags;		/* HV_DEVICE_INTERRUPT_TARGET_* above */
> +	union {
> +		u64 vp_mask;
> +		struct hv_vpset vp_set;
> +	};
> +} __packed;
> +
> +struct hv_retarget_device_interrupt {	 /* HV_INPUT_RETARGET_DEVICE_INTERRUPT
> */
> +	u64 partition_id;		/* use "self" */
> +	u64 device_id;
> +	struct hv_interrupt_entry int_entry;
> +	u64 reserved2;
> +	struct hv_device_interrupt_target int_target;
> +} __packed __aligned(8);
> +
> +/* Data structures for HVCALL_MMIO_READ and HVCALL_MMIO_WRITE */
> +#define HV_HYPERCALL_MMIO_MAX_DATA_LENGTH 64
> +
> +struct hv_mmio_read_input { /* HV_INPUT_MEMORY_MAPPED_IO_READ */
> +	u64 gpa;
> +	u32 size;
> +	u32 reserved;
> +} __packed;
> +
> +struct hv_mmio_read_output {
> +	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
> +} __packed;
> +
> +struct hv_mmio_write_input {
> +	u64 gpa;
> +	u32 size;
> +	u32 reserved;
> +	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
> +} __packed;
> +
> +#endif /* _HV_HVGDK_MINI_H */
> diff --git a/include/hyperv/hvhdk.h b/include/hyperv/hvhdk.h
> new file mode 100644
> index 000000000000..64407c2a3809
> --- /dev/null
> +++ b/include/hyperv/hvhdk.h
> @@ -0,0 +1,733 @@
> +/* SPDX-License-Identifier: GPL-2.0 */
> +/*
> + * Type definitions for the Microsoft hypervisor.
> + */
> +#ifndef _HV_HVHDK_H
> +#define _HV_HVHDK_H
> +
> +#include <linux/build_bug.h>
> +
> +#include "hvhdk_mini.h"
> +#include "hvgdk.h"
> +
> +/* Bits for dirty mask of hv_vp_register_page */
> +#define HV_X64_REGISTER_CLASS_GENERAL	0
> +#define HV_X64_REGISTER_CLASS_IP	1
> +#define HV_X64_REGISTER_CLASS_XMM	2
> +#define HV_X64_REGISTER_CLASS_SEGMENT	3
> +#define HV_X64_REGISTER_CLASS_FLAGS	4
> +
> +#define HV_VP_REGISTER_PAGE_VERSION_1	1u
> +
> +struct hv_vp_register_page {
> +	u16 version;
> +	u8 isvalid;
> +	u8 rsvdz;
> +	u32 dirty;
> +	union {
> +		struct {
> +			/* General purpose registers
> +			 * (HV_X64_REGISTER_CLASS_GENERAL)
> +			 */
> +			union {
> +				struct {
> +					u64 rax;
> +					u64 rcx;
> +					u64 rdx;
> +					u64 rbx;
> +					u64 rsp;
> +					u64 rbp;
> +					u64 rsi;
> +					u64 rdi;
> +					u64 r8;
> +					u64 r9;
> +					u64 r10;
> +					u64 r11;
> +					u64 r12;
> +					u64 r13;
> +					u64 r14;
> +					u64 r15;
> +				} __packed;
> +
> +				u64 gp_registers[16];
> +			};
> +			/* Instruction pointer (HV_X64_REGISTER_CLASS_IP) */
> +			u64 rip;
> +			/* Flags (HV_X64_REGISTER_CLASS_FLAGS) */
> +			u64 rflags;
> +		} __packed;
> +
> +		u64 registers[18];
> +	};
> +	/* Volatile XMM registers (HV_X64_REGISTER_CLASS_XMM) */
> +	union {
> +		struct {
> +			struct hv_u128 xmm0;
> +			struct hv_u128 xmm1;
> +			struct hv_u128 xmm2;
> +			struct hv_u128 xmm3;
> +			struct hv_u128 xmm4;
> +			struct hv_u128 xmm5;
> +		} __packed;
> +
> +		struct hv_u128 xmm_registers[6];
> +	};
> +	/* Segment registers (HV_X64_REGISTER_CLASS_SEGMENT) */
> +	union {
> +		struct {
> +			struct hv_x64_segment_register es;
> +			struct hv_x64_segment_register cs;
> +			struct hv_x64_segment_register ss;
> +			struct hv_x64_segment_register ds;
> +			struct hv_x64_segment_register fs;
> +			struct hv_x64_segment_register gs;
> +		} __packed;
> +
> +		struct hv_x64_segment_register segment_registers[6];
> +	};
> +	/* Misc. control registers (cannot be set via this interface) */
> +	u64 cr0;
> +	u64 cr3;
> +	u64 cr4;
> +	u64 cr8;
> +	u64 efer;
> +	u64 dr7;
> +	union hv_x64_pending_interruption_register pending_interruption;
> +	union hv_x64_interrupt_state_register interrupt_state;
> +	u64 instruction_emulation_hints;
> +} __packed;
> +
> +#define HV_PARTITION_PROCESSOR_FEATURES_BANKS 2
> +
> +union hv_partition_processor_features {
> +	u64 as_uint64[HV_PARTITION_PROCESSOR_FEATURES_BANKS];
> +	struct {
> +		u64 sse3_support : 1;
> +		u64 lahf_sahf_support : 1;
> +		u64 ssse3_support : 1;
> +		u64 sse4_1_support : 1;
> +		u64 sse4_2_support : 1;
> +		u64 sse4a_support : 1;
> +		u64 xop_support : 1;
> +		u64 pop_cnt_support : 1;
> +		u64 cmpxchg16b_support : 1;
> +		u64 altmovcr8_support : 1;
> +		u64 lzcnt_support : 1;
> +		u64 mis_align_sse_support : 1;
> +		u64 mmx_ext_support : 1;
> +		u64 amd3dnow_support : 1;
> +		u64 extended_amd3dnow_support : 1;
> +		u64 page_1gb_support : 1;
> +		u64 aes_support : 1;
> +		u64 pclmulqdq_support : 1;
> +		u64 pcid_support : 1;
> +		u64 fma4_support : 1;
> +		u64 f16c_support : 1;
> +		u64 rd_rand_support : 1;
> +		u64 rd_wr_fs_gs_support : 1;
> +		u64 smep_support : 1;
> +		u64 enhanced_fast_string_support : 1;
> +		u64 bmi1_support : 1;
> +		u64 bmi2_support : 1;
> +		u64 hle_support_deprecated : 1;
> +		u64 rtm_support_deprecated : 1;
> +		u64 movbe_support : 1;
> +		u64 npiep1_support : 1;
> +		u64 dep_x87_fpu_save_support : 1;
> +		u64 rd_seed_support : 1;
> +		u64 adx_support : 1;
> +		u64 intel_prefetch_support : 1;
> +		u64 smap_support : 1;
> +		u64 hle_support : 1;
> +		u64 rtm_support : 1;
> +		u64 rdtscp_support : 1;
> +		u64 clflushopt_support : 1;
> +		u64 clwb_support : 1;
> +		u64 sha_support : 1;
> +		u64 x87_pointers_saved_support : 1;
> +		u64 invpcid_support : 1;
> +		u64 ibrs_support : 1;
> +		u64 stibp_support : 1;
> +		u64 ibpb_support: 1;
> +		u64 unrestricted_guest_support : 1;
> +		u64 mdd_support : 1;
> +		u64 fast_short_rep_mov_support : 1;
> +		u64 l1dcache_flush_support : 1;
> +		u64 rdcl_no_support : 1;
> +		u64 ibrs_all_support : 1;
> +		u64 skip_l1df_support : 1;
> +		u64 ssb_no_support : 1;
> +		u64 rsb_a_no_support : 1;
> +		u64 virt_spec_ctrl_support : 1;
> +		u64 rd_pid_support : 1;
> +		u64 umip_support : 1;
> +		u64 mbs_no_support : 1;
> +		u64 mb_clear_support : 1;
> +		u64 taa_no_support : 1;
> +		u64 tsx_ctrl_support : 1;
> +		/*
> +		 * N.B. The final processor feature bit in bank 0 is reserved to
> +		 * simplify potential downlevel backports.
> +		 */
> +		u64 reserved_bank0 : 1;
> +
> +		/* N.B. Begin bank 1 processor features. */
> +		u64 acount_mcount_support : 1;
> +		u64 tsc_invariant_support : 1;
> +		u64 cl_zero_support : 1;
> +		u64 rdpru_support : 1;
> +		u64 la57_support : 1;
> +		u64 mbec_support : 1;
> +		u64 nested_virt_support : 1;
> +		u64 psfd_support : 1;
> +		u64 cet_ss_support : 1;
> +		u64 cet_ibt_support : 1;
> +		u64 vmx_exception_inject_support : 1;
> +		u64 enqcmd_support : 1;
> +		u64 umwait_tpause_support : 1;
> +		u64 movdiri_support : 1;
> +		u64 movdir64b_support : 1;
> +		u64 cldemote_support : 1;
> +		u64 serialize_support : 1;
> +		u64 tsc_deadline_tmr_support : 1;
> +		u64 tsc_adjust_support : 1;
> +		u64 fzlrep_movsb : 1;
> +		u64 fsrep_stosb : 1;
> +		u64 fsrep_cmpsb : 1;
> +		u64 reserved_bank1 : 42;
> +	} __packed;
> +};
> +
> +union hv_partition_processor_xsave_features {
> +	struct {
> +		u64 xsave_support : 1;
> +		u64 xsaveopt_support : 1;
> +		u64 avx_support : 1;
> +		u64 reserved1 : 61;
> +	} __packed;
> +	u64 as_uint64;
> +};
> +
> +struct hv_partition_creation_properties {
> +	union hv_partition_processor_features disabled_processor_features;
> +	union hv_partition_processor_xsave_features
> +		disabled_processor_xsave_features;
> +} __packed;
> +
> +#define HV_PARTITION_SYNTHETIC_PROCESSOR_FEATURES_BANKS 1
> +
> +union hv_partition_synthetic_processor_features {
> +	u64 as_uint64[HV_PARTITION_SYNTHETIC_PROCESSOR_FEATURES_BANKS];
> +
> +	struct {
> +		u64 hypervisor_present : 1;
> +		/* Support for HV#1: (CPUID leaves 0x40000000 - 0x40000006)*/
> +		u64 hv1 : 1;
> +		u64 access_vp_run_time_reg : 1; /* HV_X64_MSR_VP_RUNTIME */
> +		u64 access_partition_reference_counter : 1; /*
> HV_X64_MSR_TIME_REF_COUNT */
> +		u64 access_synic_regs : 1; /* SINT-related registers */
> +		/*
> +		 * Access to HV_X64_MSR_STIMER0_CONFIG through
> +		 * HV_X64_MSR_STIMER3_COUNT.
> +		 */
> +		u64 access_synthetic_timer_regs : 1;
> +		u64 access_intr_ctrl_regs : 1; /* APIC MSRs and VP assist page*/
> +		/* HV_X64_MSR_GUEST_OS_ID and HV_X64_MSR_HYPERCALL */
> +		u64 access_hypercall_regs : 1;
> +		u64 access_vp_index : 1;
> +		u64 access_partition_reference_tsc : 1;
> +		u64 access_guest_idle_reg : 1;
> +		u64 access_frequency_regs : 1;
> +		u64 reserved_z12 : 1;
> +		u64 reserved_z13 : 1;
> +		u64 reserved_z14 : 1;
> +		u64 enable_extended_gva_ranges_for_flush_virtual_address_list : 1;
> +		u64 reserved_z16 : 1;
> +		u64 reserved_z17 : 1;
> +		/* Use fast hypercall output. Corresponds to privilege. */
> +		u64 fast_hypercall_output : 1;
> +		u64 reserved_z19 : 1;
> +		u64 start_virtual_processor : 1; /* Can start VPs */
> +		u64 reserved_z21 : 1;
> +		/* Synthetic timers in direct mode. */
> +		u64 direct_synthetic_timers : 1;
> +		u64 reserved_z23 : 1;
> +		u64 extended_processor_masks : 1;
> +
> +		/* Enable various hypercalls */
> +		u64 tb_flush_hypercalls : 1;
> +		u64 synthetic_cluster_ipi : 1;
> +		u64 notify_long_spin_wait : 1;
> +		u64 query_numa_distance : 1;
> +		u64 signal_events : 1;
> +		u64 retarget_device_interrupt : 1;
> +		u64 restore_time : 1;
> +
> +		/* EnlightenedVmcs nested enlightenment is supported. */
> +		u64 enlightened_vmcs : 1;
> +		u64 reserved : 31;
> +	} __packed;
> +};
> +
> +#define HV_MAKE_COMPATIBILITY_VERSION(major_, minor_)	\
> +	((u32)((major_) << 8 | (minor_)))
> +
> +#define HV_COMPATIBILITY_21_H2
> 	HV_MAKE_COMPATIBILITY_VERSION(0X6, 0X9)
> +
> +union hv_partition_isolation_properties {
> +	u64 as_uint64;
> +	struct {
> +		u64 isolation_type: 5;
> +		u64 isolation_host_type : 2;
> +		u64 rsvd_z: 5;
> +		u64 shared_gpa_boundary_page_number: 52;
> +	} __packed;
> +};
> +
> +/*
> + * Various isolation types supported by MSHV.
> + */
> +#define HV_PARTITION_ISOLATION_TYPE_NONE            0
> +#define HV_PARTITION_ISOLATION_TYPE_SNP             2
> +#define HV_PARTITION_ISOLATION_TYPE_TDX             3
> +
> +/*
> + * Various host isolation types supported by MSHV.
> + */
> +#define HV_PARTITION_ISOLATION_HOST_TYPE_NONE       0x0
> +#define HV_PARTITION_ISOLATION_HOST_TYPE_HARDWARE   0x1
> +#define HV_PARTITION_ISOLATION_HOST_TYPE_RESERVED   0x2
> +
> +/* Note: Exo partition is enabled by default */
> +#define HV_PARTITION_CREATION_FLAG_EXO_PARTITION                    BIT(8)
> +#define HV_PARTITION_CREATION_FLAG_LAPIC_ENABLED                    BIT(13)
> +#define HV_PARTITION_CREATION_FLAG_INTERCEPT_MESSAGE_PAGE_ENABLED
> BIT(19)
> +#define HV_PARTITION_CREATION_FLAG_X2APIC_CAPABLE                   BIT(22)
> +
> +struct hv_input_create_partition {
> +	u64 flags;
> +	struct hv_proximity_domain_info proximity_domain_info;
> +	u32 compatibility_version;
> +	u32 padding;
> +	struct hv_partition_creation_properties partition_creation_properties;
> +	union hv_partition_isolation_properties isolation_properties;
> +} __packed;
> +
> +struct hv_output_create_partition {
> +	u64 partition_id;
> +} __packed;
> +
> +struct hv_input_initialize_partition {
> +	u64 partition_id;
> +} __packed;
> +
> +struct hv_input_finalize_partition {
> +	u64 partition_id;
> +} __packed;
> +
> +struct hv_input_delete_partition {
> +	u64 partition_id;
> +} __packed;
> +
> +struct hv_input_get_partition_property {
> +	u64 partition_id;
> +	u32 property_code; /* enum hv_partition_property_code */
> +	u32 padding;
> +} __packed;
> +
> +struct hv_output_get_partition_property {
> +	u64 property_value;
> +} __packed;
> +
> +struct hv_input_set_partition_property {
> +	u64 partition_id;
> +	u32 property_code; /* enum hv_partition_property_code */
> +	u32 padding;
> +	u64 property_value;
> +} __packed;
> +
> +enum hv_vp_state_page_type {
> +	HV_VP_STATE_PAGE_REGISTERS = 0,
> +	HV_VP_STATE_PAGE_INTERCEPT_MESSAGE = 1,
> +	HV_VP_STATE_PAGE_COUNT
> +};
> +
> +struct hv_input_map_vp_state_page {
> +	u64 partition_id;
> +	u32 vp_index;
> +	u32 type; /* enum hv_vp_state_page_type */
> +} __packed;
> +
> +struct hv_output_map_vp_state_page {
> +	u64 map_location; /* GPA page number */
> +} __packed;
> +
> +struct hv_input_unmap_vp_state_page {
> +	u64 partition_id;
> +	u32 vp_index;
> +	u32 type; /* enum hv_vp_state_page_type */
> +} __packed;
> +
> +struct hv_opaque_intercept_message {
> +	u32 vp_index;
> +} __packed;
> +
> +enum hv_port_type {
> +	HV_PORT_TYPE_MESSAGE = 1,
> +	HV_PORT_TYPE_EVENT   = 2,
> +	HV_PORT_TYPE_MONITOR = 3,
> +	HV_PORT_TYPE_DOORBELL = 4	/* Root Partition only */
> +};
> +
> +struct hv_port_info {
> +	u32 port_type; /* enum hv_port_type */
> +	u32 padding;
> +	union {
> +		struct {
> +			u32 target_sint;
> +			u32 target_vp;
> +			u64 rsvdz;
> +		} message_port_info;
> +		struct {
> +			u32 target_sint;
> +			u32 target_vp;
> +			u16 base_flag_number;
> +			u16 flag_count;
> +			u32 rsvdz;
> +		} event_port_info;
> +		struct {
> +			u64 monitor_address;
> +			u64 rsvdz;
> +		} monitor_port_info;
> +		struct {
> +			u32 target_sint;
> +			u32 target_vp;
> +			u64 rsvdz;
> +		} doorbell_port_info;
> +	};
> +} __packed;
> +
> +struct hv_connection_info {
> +	u32 port_type;
> +	u32 padding;
> +	union {
> +		struct {
> +			u64 rsvdz;
> +		} message_connection_info;
> +		struct {
> +			u64 rsvdz;
> +		} event_connection_info;
> +		struct {
> +			u64 monitor_address;
> +		} monitor_connection_info;
> +		struct {
> +			u64 gpa;
> +			u64 trigger_value;
> +			u64 flags;
> +		} doorbell_connection_info;
> +	};
> +} __packed;
> +
> +/* Define synthetic interrupt controller flag constants. */
> +#define HV_EVENT_FLAGS_COUNT		(256 * 8)
> +#define HV_EVENT_FLAGS_BYTE_COUNT	(256)
> +#define HV_EVENT_FLAGS32_COUNT		(256 / sizeof(u32))
> +
> +/* linux side we create long version of flags to use long bit ops on flags */
> +#define HV_EVENT_FLAGS_UL_COUNT		(256 / sizeof(ulong))
> +
> +/* Define the synthetic interrupt controller event flags format. */
> +union hv_synic_event_flags {
> +	unsigned char flags8[HV_EVENT_FLAGS_BYTE_COUNT];
> +	u32 flags32[HV_EVENT_FLAGS32_COUNT];
> +	ulong flags[HV_EVENT_FLAGS_UL_COUNT];  /* linux only */
> +};
> +
> +struct hv_synic_event_flags_page {
> +	volatile union hv_synic_event_flags event_flags[HV_SYNIC_SINT_COUNT];
> +};
> +
> +#define HV_SYNIC_EVENT_RING_MESSAGE_COUNT 63
> +
> +struct hv_synic_event_ring {
> +	u8  signal_masked;
> +	u8  ring_full;
> +	u16 reserved_z;
> +	u32 data[HV_SYNIC_EVENT_RING_MESSAGE_COUNT];
> +} __packed;
> +
> +struct hv_synic_event_ring_page {
> +	struct hv_synic_event_ring sint_event_ring[HV_SYNIC_SINT_COUNT];
> +};
> +
> +/* Define SynIC control register. */
> +union hv_synic_scontrol {
> +	u64 as_uint64;
> +	struct {
> +		u64 enable : 1;
> +		u64 reserved : 63;
> +	} __packed;
> +};
> +
> +/* Define the format of the SIEFP register */
> +union hv_synic_siefp {
> +	u64 as_uint64;
> +	struct {
> +		u64 siefp_enabled : 1;
> +		u64 preserved : 11;
> +		u64 base_siefp_gpa : 52;
> +	} __packed;
> +};
> +
> +union hv_synic_sirbp {
> +	u64 as_uint64;
> +	struct {
> +		u64 sirbp_enabled : 1;
> +		u64 preserved : 11;
> +		u64 base_sirbp_gpa : 52;
> +	} __packed;
> +};
> +
> +union hv_interrupt_control {
> +	u64 as_uint64;
> +	struct {
> +		u32 interrupt_type; /* enum hv_interrupt_type */
> +		u32 level_triggered : 1;
> +		u32 logical_dest_mode : 1;
> +		u32 rsvd : 30;
> +	} __packed;
> +};
> +
> +struct hv_stimer_state {
> +	struct {
> +		u32 undelivered_msg_pending : 1;
> +		u32 reserved : 31;
> +	} __packed flags;
> +	u32 resvd;
> +	u64 config;
> +	u64 count;
> +	u64 adjustment;
> +	u64 undelivered_exp_time;
> +} __packed;
> +
> +struct hv_synthetic_timers_state {
> +	struct hv_stimer_state timers[HV_SYNIC_STIMER_COUNT];
> +	u64 reserved[5];
> +} __packed;
> +
> +union hv_input_delete_vp {
> +	u64 as_uint64[2];
> +	struct {
> +		u64 partition_id;
> +		u32 vp_index;
> +		u8 reserved[4];
> +	} __packed;
> +} __packed;
> +
> +struct hv_input_assert_virtual_interrupt {
> +	u64 partition_id;
> +	union hv_interrupt_control control;
> +	u64 dest_addr; /* cpu's apic id */
> +	u32 vector;
> +	u8 target_vtl;
> +	u8 rsvd_z0;
> +	u16 rsvd_z1;
> +} __packed;
> +
> +struct hv_input_create_port {
> +	u64 port_partition_id;
> +	union hv_port_id port_id;
> +	u8 port_vtl;
> +	u8 min_connection_vtl;
> +	u16 padding;
> +	u64 connection_partition_id;
> +	struct hv_port_info port_info;
> +	struct hv_proximity_domain_info proximity_domain_info;
> +} __packed;
> +
> +union hv_input_delete_port {
> +	u64 as_uint64[2];
> +	struct {
> +		u64 port_partition_id;
> +		union hv_port_id port_id;
> +		u32 reserved;
> +	};
> +} __packed;
> +
> +struct hv_input_connect_port {
> +	u64 connection_partition_id;
> +	union hv_connection_id connection_id;
> +	u8 connection_vtl;
> +	u8 rsvdz0;
> +	u16 rsvdz1;
> +	u64 port_partition_id;
> +	union hv_port_id port_id;
> +	u32 reserved2;
> +	struct hv_connection_info connection_info;
> +	struct hv_proximity_domain_info proximity_domain_info;
> +} __packed;
> +
> +union hv_input_disconnect_port {
> +	u64 as_uint64[2];
> +	struct {
> +		u64 connection_partition_id;
> +		union hv_connection_id connection_id;
> +		u32 is_doorbell: 1;
> +		u32 reserved: 31;
> +	} __packed;
> +} __packed;
> +
> +union hv_input_notify_port_ring_empty {
> +	u64 as_uint64;
> +	struct {
> +		u32 sint_index;
> +		u32 reserved;
> +	};
> +} __packed;
> +
> +struct hv_vp_state_data_xsave {
> +	u64 flags;
> +	union hv_x64_xsave_xfem_register states;
> +} __packed;
> +
> +/*
> + * For getting and setting VP state, there are two options based on the state type:
> + *
> + *     1.) Data that is accessed by PFNs in the input hypercall page. This is used
> + *         for state which may not fit into the hypercall pages.
> + *     2.) Data that is accessed directly in the input\output hypercall pages.
> + *         This is used for state that will always fit into the hypercall pages.
> + *
> + * In the future this could be dynamic based on the size if needed.
> + *
> + * Note these hypercalls have an 8-byte aligned variable header size as per the tlfs
> + */
> +
> +#define HV_GET_SET_VP_STATE_TYPE_PFN	BIT(31)
> +
> +enum hv_get_set_vp_state_type {
> +	/* HvGetSetVpStateLocalInterruptControllerState - APIC/GIC state */
> +	HV_GET_SET_VP_STATE_LAPIC_STATE	     = 0 |
> HV_GET_SET_VP_STATE_TYPE_PFN,
> +	HV_GET_SET_VP_STATE_XSAVE	     = 1 | HV_GET_SET_VP_STATE_TYPE_PFN,
> +	HV_GET_SET_VP_STATE_SIM_PAGE	     = 2 |
> HV_GET_SET_VP_STATE_TYPE_PFN,
> +	HV_GET_SET_VP_STATE_SIEF_PAGE	     = 3 |
> HV_GET_SET_VP_STATE_TYPE_PFN,
> +	HV_GET_SET_VP_STATE_SYNTHETIC_TIMERS = 4,
> +};
> +
> +struct hv_vp_state_data {
> +	u32 type;
> +	u32 rsvd;
> +	struct hv_vp_state_data_xsave xsave;
> +} __packed;
> +
> +struct hv_input_get_vp_state {
> +	u64 partition_id;
> +	u32 vp_index;
> +	u8 input_vtl;
> +	u8 rsvd0;
> +	u16 rsvd1;
> +	struct hv_vp_state_data state_data;
> +	u64 output_data_pfns[];
> +} __packed;
> +
> +union hv_output_get_vp_state {
> +	struct hv_synthetic_timers_state synthetic_timers_state;
> +} __packed;
> +
> +union hv_input_set_vp_state_data {
> +	u64 pfns;
> +	u8 bytes;
> +} __packed;
> +
> +struct hv_input_set_vp_state {
> +	u64 partition_id;
> +	u32 vp_index;
> +	u8 input_vtl;
> +	u8 rsvd0;
> +	u16 rsvd1;
> +	struct hv_vp_state_data state_data;
> +	union hv_input_set_vp_state_data data[];
> +} __packed;
> +
> +/*
> + * Dispatch state for the VP communicated by the hypervisor to the
> + * VP-dispatching thread in the root on return from HVCALL_DISPATCH_VP.
> + */
> +enum hv_vp_dispatch_state {
> +	HV_VP_DISPATCH_STATE_INVALID	= 0,
> +	HV_VP_DISPATCH_STATE_BLOCKED	= 1,
> +	HV_VP_DISPATCH_STATE_READY	= 2,
> +};
> +
> +/*
> + * Dispatch event that caused the current dispatch state on return from
> + * HVCALL_DISPATCH_VP.
> + */
> +enum hv_vp_dispatch_event {
> +	HV_VP_DISPATCH_EVENT_INVALID	= 0x00000000,
> +	HV_VP_DISPATCH_EVENT_SUSPEND	= 0x00000001,
> +	HV_VP_DISPATCH_EVENT_INTERCEPT	= 0x00000002,
> +};
> +
> +#define HV_ROOT_SCHEDULER_MAX_VPS_PER_CHILD_PARTITION   1024
> +/* The maximum array size of HV_GENERIC_SET (vp_set) buffer */
> +#define HV_GENERIC_SET_QWORD_COUNT(max) (((((max) - 1) >> 6) + 1) + 2)
> +
> +struct hv_vp_signal_bitset_scheduler_message {
> +	u64 partition_id;
> +	u32 overflow_count;
> +	u16 vp_count;
> +	u16 reserved;
> +
> +#define BITSET_BUFFER_SIZE \
> +
> 	HV_GENERIC_SET_QWORD_COUNT(HV_ROOT_SCHEDULER_MAX_VPS_PER_C
> HILD_PARTITION)
> +	union {
> +		struct hv_vpset bitset;
> +		u64 bitset_buffer[BITSET_BUFFER_SIZE];
> +	} vp_bitset;
> +#undef BITSET_BUFFER_SIZE
> +} __packed;
> +
> +static_assert(sizeof(struct hv_vp_signal_bitset_scheduler_message) <=
> +	(sizeof(struct hv_message) - sizeof(struct hv_message_header)));
> +
> +#define HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT \
> +	(((sizeof(struct hv_message) - sizeof(struct hv_message_header)) / \
> +	 (sizeof(u64 /* partition id */) + sizeof(u32 /* vp index */))) - 1)
> +
> +struct hv_vp_signal_pair_scheduler_message {
> +	u32 overflow_count;
> +	u8 vp_count;
> +	u8 reserved1[3];
> +
> +	u64 partition_ids[HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT];
> +	u32 vp_indexes[HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT];
> +
> +	u8 reserved2[4];
> +} __packed;
> +
> +static_assert(sizeof(struct hv_vp_signal_pair_scheduler_message) ==
> +	(sizeof(struct hv_message) - sizeof(struct hv_message_header)));
> +
> +/* Input and output structures for HVCALL_DISPATCH_VP */
> +#define HV_DISPATCH_VP_FLAG_CLEAR_INTERCEPT_SUSPEND	0x1
> +#define HV_DISPATCH_VP_FLAG_ENABLE_CALLER_INTERRUPTS	0x2
> +#define HV_DISPATCH_VP_FLAG_SET_CALLER_SPEC_CTRL	0x4
> +#define HV_DISPATCH_VP_FLAG_SKIP_VP_SPEC_FLUSH		0x8
> +#define HV_DISPATCH_VP_FLAG_SKIP_CALLER_SPEC_FLUSH	0x10
> +#define HV_DISPATCH_VP_FLAG_SKIP_CALLER_USER_SPEC_FLUSH	0x20
> +
> +struct hv_input_dispatch_vp {
> +	u64 partition_id;
> +	u32 vp_index;
> +	u32 flags;
> +	u64 time_slice; /* in 100ns */
> +	u64 spec_ctrl;
> +} __packed;
> +
> +struct hv_output_dispatch_vp {
> +	u32 dispatch_state; /* enum hv_vp_dispatch_state */
> +	u32 dispatch_event; /* enum hv_vp_dispatch_event */
> +} __packed;
> +
> +#endif /* _HV_HVHDK_H */
> diff --git a/include/hyperv/hvhdk_mini.h b/include/hyperv/hvhdk_mini.h
> new file mode 100644
> index 000000000000..d003223fac79
> --- /dev/null
> +++ b/include/hyperv/hvhdk_mini.h
> @@ -0,0 +1,310 @@
> +/* SPDX-License-Identifier: GPL-2.0 */
> +/*
> + * Type definitions for the Microsoft Hypervisor.
> + */
> +#ifndef _HV_HVHDK_MINI_H
> +#define _HV_HVHDK_MINI_H
> +
> +#include "hvgdk_mini.h"
> +
> +/*
> + * Doorbell connection_info flags.
> + */
> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_MASK  0x00000007
> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_ANY   0x00000000
> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_BYTE  0x00000001
> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_WORD  0x00000002
> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_DWORD 0x00000003
> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_QWORD 0x00000004
> +#define HV_DOORBELL_FLAG_TRIGGER_ANY_VALUE  0x80000000
> +
> +/* Each generic set contains 64 elements */
> +#define HV_GENERIC_SET_SHIFT		(6)
> +#define HV_GENERIC_SET_MASK		(63)
> +
> +enum hv_generic_set_format {
> +	HV_GENERIC_SET_SPARSE_4K,
> +	HV_GENERIC_SET_ALL,
> +};
> +
> +enum hv_scheduler_type {
> +	HV_SCHEDULER_TYPE_LP		= 1, /* Classic scheduler w/o SMT */
> +	HV_SCHEDULER_TYPE_LP_SMT	= 2, /* Classic scheduler w/ SMT */
> +	HV_SCHEDULER_TYPE_CORE_SMT	= 3, /* Core scheduler */
> +	HV_SCHEDULER_TYPE_ROOT		= 4, /* Root / integrated scheduler */
> +	HV_SCHEDULER_TYPE_MAX
> +};
> +
> +enum hv_partition_property_code {
> +	/* Privilege properties */
> +	HV_PARTITION_PROPERTY_PRIVILEGE_FLAGS			= 0x00010000,
> +	HV_PARTITION_PROPERTY_SYNTHETIC_PROC_FEATURES		=
> 0x00010001,
> +
> +	/* Resource properties */
> +	HV_PARTITION_PROPERTY_GPA_PAGE_ACCESS_TRACKING		=
> 0x00050005,
> +	HV_PARTITION_PROPERTY_UNIMPLEMENTED_MSR_ACTION		=
> 0x00050017,
> +
> +	/* Compatibility properties */
> +	HV_PARTITION_PROPERTY_PROCESSOR_XSAVE_FEATURES		=
> 0x00060002,
> +	HV_PARTITION_PROPERTY_MAX_XSAVE_DATA_SIZE		= 0x00060008,
> +	HV_PARTITION_PROPERTY_PROCESSOR_CLOCK_FREQUENCY		=
> 0x00060009,
> +};
> +
> +enum hv_system_property {
> +	/* Add more values when needed */
> +	HV_SYSTEM_PROPERTY_SCHEDULER_TYPE = 15,
> +};
> +
> +struct hv_input_get_system_property {
> +	u32 property_id; /* enum hv_system_property */
> +	union {
> +		u32 as_uint32;
> +		/* More fields to be filled in when needed */
> +	};
> +} __packed;
> +
> +struct hv_output_get_system_property {
> +	union {
> +		u32 scheduler_type; /* enum hv_scheduler_type */
> +	};
> +} __packed;
> +
> +struct hv_proximity_domain_flags {
> +	u32 proximity_preferred : 1;
> +	u32 reserved : 30;
> +	u32 proximity_info_valid : 1;
> +} __packed;
> +
> +struct hv_proximity_domain_info {
> +	u32 domain_id;
> +	struct hv_proximity_domain_flags flags;
> +} __packed;
> +
> +/* HvDepositMemory hypercall */
> +struct hv_deposit_memory {	/* HV_INPUT_DEPOSIT_MEMORY */
> +	u64 partition_id;
> +	u64 gpa_page_list[];
> +} __packed;
> +
> +struct hv_input_withdraw_memory {
> +	u64 partition_id;
> +	struct hv_proximity_domain_info proximity_domain_info;
> +} __packed;
> +
> +struct hv_output_withdraw_memory {
> +	DECLARE_FLEX_ARRAY(u64, gpa_page_list);
> +} __packed;
> +
> +/* HV Map GPA (Guest Physical Address) Flags */
> +#define HV_MAP_GPA_PERMISSIONS_NONE	       0x0
> +#define HV_MAP_GPA_READABLE		       0x1
> +#define HV_MAP_GPA_WRITABLE		       0x2
> +#define HV_MAP_GPA_KERNEL_EXECUTABLE	       0x4
> +#define HV_MAP_GPA_USER_EXECUTABLE	       0x8
> +#define HV_MAP_GPA_EXECUTABLE		       0xC
> +#define HV_MAP_GPA_PERMISSIONS_MASK	       0xF
> +#define HV_MAP_GPA_ADJUSTABLE		    0x8000
> +#define HV_MAP_GPA_NO_ACCESS		   0x10000
> +#define HV_MAP_GPA_NOT_CACHED		  0x200000
> +#define HV_MAP_GPA_LARGE_PAGE		0x80000000
> +
> +struct hv_input_map_gpa_pages {
> +	u64 target_partition_id;
> +	u64 target_gpa_base;
> +	u32 map_flags;
> +	u32 padding;
> +	u64 source_gpa_page_list[];
> +} __packed;
> +
> +union hv_gpa_page_access_state_flags {
> +	struct {
> +		u64 clear_accessed : 1;
> +		u64 set_accessed : 1;
> +		u64 clear_dirty : 1;
> +		u64 set_dirty : 1;
> +		u64 reserved : 60;
> +	} __packed;
> +	u64 as_uint64;
> +};
> +
> +struct hv_input_get_gpa_pages_access_state {
> +	u64  partition_id;
> +	union hv_gpa_page_access_state_flags flags;
> +	u64 hv_gpa_page_number;
> +} __packed;
> +
> +union hv_gpa_page_access_state {
> +	struct {
> +		u8 accessed : 1;
> +		u8 dirty : 1;
> +		u8 reserved: 6;
> +	};
> +	u8 as_uint8;
> +} __packed;
> +
> +struct hv_lp_startup_status {
> +	u64 hv_status;
> +	u64 substatus1;
> +	u64 substatus2;
> +	u64 substatus3;
> +	u64 substatus4;
> +	u64 substatus5;
> +	u64 substatus6;
> +} __packed;
> +
> +struct hv_input_add_logical_processor {
> +	u32 lp_index;
> +	u32 apic_id;
> +	struct hv_proximity_domain_info proximity_domain_info;
> +} __packed;
> +
> +struct hv_output_add_logical_processor {
> +	struct hv_lp_startup_status startup_status;
> +} __packed;
> +
> +enum {	/* HV_SUBNODE_TYPE */
> +	HV_SUBNODE_ANY		= 0,
> +	HV_SUBNODE_SOCKET,
> +	HV_SUBNODE_CLUSTER,
> +	HV_SUBNODE_L3,
> +	HV_SUBNODE_COUNT,
> +	HV_SUBNODE_INVALID	= -1
> +};
> +
> +struct hv_create_vp {	/* HV_INPUT_CREATE_VP */
> +	u64 partition_id;
> +	u32 vp_index;
> +	u8 padding[3];
> +	u8 subnode_type;
> +	u64 subnode_id;
> +	struct hv_proximity_domain_info proximity_domain_info;
> +	u64 flags;
> +} __packed;
> +
> +/* HV_INTERRUPT_TRIGGER_MODE */
> +enum hv_interrupt_trigger_mode {
> +	HV_INTERRUPT_TRIGGER_MODE_EDGE	= 0,
> +	HV_INTERRUPT_TRIGGER_MODE_LEVEL	= 1,
> +};
> +
> +/* HV_DEVICE_INTERRUPT_DESCRIPTOR */
> +struct hv_device_interrupt_descriptor {
> +	u32 interrupt_type;
> +	u32 trigger_mode;
> +	u32 vector_count;
> +	u32 reserved;
> +	struct hv_device_interrupt_target target;
> +} __packed;
> +
> +/* HV_INPUT_MAP_DEVICE_INTERRUPT */
> +struct hv_input_map_device_interrupt {
> +	u64 partition_id;
> +	u64 device_id;
> +	u32 flags;
> +	u32 base_irt_idx;
> +	struct hv_interrupt_entry logical_interrupt_entry;
> +	struct hv_device_interrupt_descriptor interrupt_descriptor;
> +} __packed;
> +
> +/* HV_OUTPUT_MAP_DEVICE_INTERRUPT */
> +struct hv_output_map_device_interrupt {
> +	struct hv_interrupt_entry interrupt_entry;
> +} __packed;
> +
> +/* HV_INPUT_UNMAP_DEVICE_INTERRUPT */
> +struct hv_input_unmap_device_interrupt {
> +	u64 partition_id;
> +	u64 device_id;
> +	struct hv_interrupt_entry interrupt_entry;
> +	u32 flags;
> +} __packed;
> +
> +#define HV_SOURCE_SHADOW_NONE		    0x0
> +#define HV_SOURCE_SHADOW_BRIDGE_BUS_RANGE   0x1
> +
> +struct hv_send_ipi_ex { /* HV_INPUT_SEND_SYNTHETIC_CLUSTER_IPI_EX */
> +	u32 vector;
> +	u32 reserved;
> +	struct hv_vpset vp_set;
> +} __packed;
> +
> +typedef u16 hv_pci_rid;		/* HV_PCI_RID */
> +typedef u16 hv_pci_segment;	/* HV_PCI_SEGMENT */
> +typedef u64 hv_logical_device_id;
> +union hv_pci_bdf {	/* HV_PCI_BDF */
> +	u16 as_uint16;
> +
> +	struct {
> +		u8 function : 3;
> +		u8 device : 5;
> +		u8 bus;
> +	};
> +} __packed;
> +
> +union hv_pci_bus_range {
> +	u16 as_uint16;
> +
> +	struct {
> +		u8 subordinate_bus;
> +		u8 secondary_bus;
> +	};
> +} __packed;
> +
> +enum hv_device_type {		/* HV_DEVICE_TYPE */
> +	HV_DEVICE_TYPE_LOGICAL	= 0,
> +	HV_DEVICE_TYPE_PCI	= 1,
> +	HV_DEVICE_TYPE_IOAPIC	= 2,
> +	HV_DEVICE_TYPE_ACPI	= 3,
> +};
> +
> +union hv_device_id {		/* HV_DEVICE_ID */
> +	u64 as_uint64;
> +
> +	struct {
> +		u64 reserved0 : 62;
> +		u64 device_type : 2;
> +	};
> +
> +	/* HV_DEVICE_TYPE_LOGICAL */
> +	struct {
> +		u64 id : 62;
> +		u64 device_type : 2;
> +	} logical;
> +
> +	/* HV_DEVICE_TYPE_PCI */
> +	struct {
> +		union {
> +			hv_pci_rid rid;
> +			union hv_pci_bdf bdf;
> +		};
> +
> +		hv_pci_segment segment;
> +		union hv_pci_bus_range shadow_bus_range;
> +
> +		u16 phantom_function_bits : 2;
> +		u16 source_shadow : 1;
> +
> +		u16 rsvdz0 : 11;
> +		u16 device_type : 2;
> +	} pci;
> +
> +	/* HV_DEVICE_TYPE_IOAPIC */
> +	struct {
> +		u8 ioapic_id;
> +		u8 rsvdz0;
> +		u16 rsvdz1;
> +		u16 rsvdz2;
> +
> +		u16 rsvdz3 : 14;
> +		u16 device_type : 2;
> +	} ioapic;
> +
> +	/* HV_DEVICE_TYPE_ACPI */
> +	struct {
> +		u32 input_mapping_base;
> +		u32 input_mapping_count : 30;
> +		u32 device_type : 2;
> +	} acpi;
> +} __packed;
> +
> +#endif /* _HV_HVHDK_MINI_H */
> --
> 2.34.1

Re: [PATCH v2 3/4] hyperv: Add new Hyper-V headers in include/hyperv

[Nuno Das Neves]

On 11/10/2024 8:13 PM, Michael Kelley wrote:
> From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
>>
>> These headers contain definitions for regular Hyper-V guests (as in
>> hyperv-tlfs.h), as well as interfaces for more privileged guests like
>> Dom0.
> 
> See my comment on Patch 0/4 about use of "dom0" terminology.
> 

Thanks, noted.

>>
>> These files are derived from headers exported from Hyper-V, rather than
>> being derived from the TLFS document. (Although, to preserve
>> compatibility with existing Linux code, some definitions are copied
>> directly from hyperv-tlfs.h too).
>>
>> The new files follow a naming convention according to their original
>> use:
>> - hdk "host development kit"
>> - gdk "guest development kit"
>> With postfix "_mini" implying userspace-only headers, and "_ext" for
>> extended hypercalls.
>>
>> These names should be considered a rough guide only - since there are
>> many places already where both host and guest code are in the same
>> place, hvhdk.h (which includes everything) can be used most of the time.
> 
> Just curious -- are there really cases where hvhdk.h can't be used?
> If so, could you summarize why?
> 

No, there aren't cases where it "can't" be used. I suppose if someone
doesn't want to include everything, perhaps they could just include
hvgdk.h, for example. It doesn't really matter though.

> I ask because it would be nice to expand slightly on your paragraph
> below, as follows:  (if indeed what I've added is correct)
> 
> The use of multiple files and their original names is primarily to
> keep the provenance of exactly where they came from in Hyper-V
> code, which is helpful for manual maintenance and extension
> of these definitions. Microsoft maintainers importing new definitions
> should take care to put them in the right file. However, Linux kernel code
> that uses any of the definitions need not be aware of the multiple files
> or assign any meaning to the new names. Linux kernel uses should
> always just include hvhdk.h
> 

Thanks, I think that additional sentence helps clarify things. I'll
include it in the next version, and I think I can probably omit the prior
paragraph: "These names should be considered a rough guide only...".

>>
>> The original names are kept intact primarily to keep the provenance of
>> exactly where they came from in Hyper-V code, which is helpful for
>> manual maintenance and extension of these definitions. Microsoft
>> maintainers importing new definitions should take care to put them in
>> the right file.
>>
>> Note also that the files contain both arm64 and x86_64 code guarded by
>> \#ifdefs, which is how the definitions originally appear in Hyper-V.
> 
> Spurious backslash?
> 

Indeed, thanks.

> I would suggest some additional clarification:  The #ifdef guards are
> employed minimally where necessary to prevent conflicts due to
> different definitions for the same thing on x86_64 and arm64. Where
> there are no conflicts, the union of x86_64 definitions and arm64
> definitions is visible when building for either architecture. In other
> words, not all definitions specific to x86_64 are protected by #ifdef
> x86_64. Such unprotected definitions may be visible when building
> for arm64. And vice versa.
> 

Is there a reason you specifically want to point out that "Such
unprotected definitions may be visible when building for arm64. And vice
versa."? I think, in all the cases where #ifdefs are not used, an
arch-specific prefix is used - hv_x64_ or hv_arm64_.

The main thing I wanted to call out here was the reasoning for not
splitting arch-specific definitions into separate files in arch/x86/
and arch/arm64/ as is typical in Linux.

Maybe this is a bit clearer:
"
Note the new headers contain both arm64 and x86_64 definitions. Some are
guarded by #ifdefs, and some are instead prefixed with the architecture,
e.g. hv_x64_*. These conventions are kept from Hyper-V code as another
tactic to simplify the process of importing and maintaining the
definitions, rather than splitting them up into their own files in
arch/x86/ and arch/arm64/.
"

I hope it's reasonably clear that it's a good tradeoff to go against
Linux convention in this case, to make it easy to import and maintain
Hyper-V definitions.

Thanks
Nuno

> Michael
> 
>> Keeping this convention from Hyper-V code is another tactic for
>> simplying the process of importing new definitions.
>>
>> These headers are a step toward importing headers directly from Hyper-V
>> in the future, similar to Xen public files in include/xen/interface/.
>>
>> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
>> ---
>>  include/hyperv/hvgdk.h      |  303 ++++++++
>>  include/hyperv/hvgdk_ext.h  |   46 ++
>>  include/hyperv/hvgdk_mini.h | 1295 +++++++++++++++++++++++++++++++++++
>>  include/hyperv/hvhdk.h      |  733 ++++++++++++++++++++
>>  include/hyperv/hvhdk_mini.h |  310 +++++++++
>>  5 files changed, 2687 insertions(+)
>>  create mode 100644 include/hyperv/hvgdk.h
>>  create mode 100644 include/hyperv/hvgdk_ext.h
>>  create mode 100644 include/hyperv/hvgdk_mini.h
>>  create mode 100644 include/hyperv/hvhdk.h
>>  create mode 100644 include/hyperv/hvhdk_mini.h
>>
>> diff --git a/include/hyperv/hvgdk.h b/include/hyperv/hvgdk.h
>> new file mode 100644
>> index 000000000000..9687c6570dfb
>> --- /dev/null
>> +++ b/include/hyperv/hvgdk.h
>> @@ -0,0 +1,303 @@
>> +/* SPDX-License-Identifier: GPL-2.0 */
>> +/*
>> + * Type definitions for the Microsoft Hypervisor.
>> + */
>> +#ifndef _HV_HVGDK_H
>> +#define _HV_HVGDK_H
>> +
>> +#include "hvgdk_mini.h"
>> +#include "hvgdk_ext.h"
>> +
>> +/*
>> + * The guest OS needs to register the guest ID with the hypervisor.
>> + * The guest ID is a 64 bit entity and the structure of this ID is
>> + * specified in the Hyper-V TLFS specification.
>> + *
>> + * While the current guideline does not specify how Linux guest ID(s)
>> + * need to be generated, our plan is to publish the guidelines for
>> + * Linux and other guest operating systems that currently are hosted
>> + * on Hyper-V. The implementation here conforms to this yet
>> + * unpublished guidelines.
>> + *
>> + * Bit(s)
>> + * 63 - Indicates if the OS is Open Source or not; 1 is Open Source
>> + * 62:56 - Os Type; Linux is 0x100
>> + * 55:48 - Distro specific identification
>> + * 47:16 - Linux kernel version number
>> + * 15:0  - Distro specific identification
>> + */
>> +
>> +#define HV_LINUX_VENDOR_ID              0x8100
>> +
>> +/* HV_VMX_ENLIGHTENED_VMCS */
>> +struct hv_enlightened_vmcs {
>> +	u32 revision_id;
>> +	u32 abort;
>> +
>> +	u16 host_es_selector;
>> +	u16 host_cs_selector;
>> +	u16 host_ss_selector;
>> +	u16 host_ds_selector;
>> +	u16 host_fs_selector;
>> +	u16 host_gs_selector;
>> +	u16 host_tr_selector;
>> +
>> +	u16 padding16_1;
>> +
>> +	u64 host_ia32_pat;
>> +	u64 host_ia32_efer;
>> +
>> +	u64 host_cr0;
>> +	u64 host_cr3;
>> +	u64 host_cr4;
>> +
>> +	u64 host_ia32_sysenter_esp;
>> +	u64 host_ia32_sysenter_eip;
>> +	u64 host_rip;
>> +	u32 host_ia32_sysenter_cs;
>> +
>> +	u32 pin_based_vm_exec_control;
>> +	u32 vm_exit_controls;
>> +	u32 secondary_vm_exec_control;
>> +
>> +	u64 io_bitmap_a;
>> +	u64 io_bitmap_b;
>> +	u64 msr_bitmap;
>> +
>> +	u16 guest_es_selector;
>> +	u16 guest_cs_selector;
>> +	u16 guest_ss_selector;
>> +	u16 guest_ds_selector;
>> +	u16 guest_fs_selector;
>> +	u16 guest_gs_selector;
>> +	u16 guest_ldtr_selector;
>> +	u16 guest_tr_selector;
>> +
>> +	u32 guest_es_limit;
>> +	u32 guest_cs_limit;
>> +	u32 guest_ss_limit;
>> +	u32 guest_ds_limit;
>> +	u32 guest_fs_limit;
>> +	u32 guest_gs_limit;
>> +	u32 guest_ldtr_limit;
>> +	u32 guest_tr_limit;
>> +	u32 guest_gdtr_limit;
>> +	u32 guest_idtr_limit;
>> +
>> +	u32 guest_es_ar_bytes;
>> +	u32 guest_cs_ar_bytes;
>> +	u32 guest_ss_ar_bytes;
>> +	u32 guest_ds_ar_bytes;
>> +	u32 guest_fs_ar_bytes;
>> +	u32 guest_gs_ar_bytes;
>> +	u32 guest_ldtr_ar_bytes;
>> +	u32 guest_tr_ar_bytes;
>> +
>> +	u64 guest_es_base;
>> +	u64 guest_cs_base;
>> +	u64 guest_ss_base;
>> +	u64 guest_ds_base;
>> +	u64 guest_fs_base;
>> +	u64 guest_gs_base;
>> +	u64 guest_ldtr_base;
>> +	u64 guest_tr_base;
>> +	u64 guest_gdtr_base;
>> +	u64 guest_idtr_base;
>> +
>> +	u64 padding64_1[3];
>> +
>> +	u64 vm_exit_msr_store_addr;
>> +	u64 vm_exit_msr_load_addr;
>> +	u64 vm_entry_msr_load_addr;
>> +
>> +	u64 cr3_target_value0;
>> +	u64 cr3_target_value1;
>> +	u64 cr3_target_value2;
>> +	u64 cr3_target_value3;
>> +
>> +	u32 page_fault_error_code_mask;
>> +	u32 page_fault_error_code_match;
>> +
>> +	u32 cr3_target_count;
>> +	u32 vm_exit_msr_store_count;
>> +	u32 vm_exit_msr_load_count;
>> +	u32 vm_entry_msr_load_count;
>> +
>> +	u64 tsc_offset;
>> +	u64 virtual_apic_page_addr;
>> +	u64 vmcs_link_pointer;
>> +
>> +	u64 guest_ia32_debugctl;
>> +	u64 guest_ia32_pat;
>> +	u64 guest_ia32_efer;
>> +
>> +	u64 guest_pdptr0;
>> +	u64 guest_pdptr1;
>> +	u64 guest_pdptr2;
>> +	u64 guest_pdptr3;
>> +
>> +	u64 guest_pending_dbg_exceptions;
>> +	u64 guest_sysenter_esp;
>> +	u64 guest_sysenter_eip;
>> +
>> +	u32 guest_activity_state;
>> +	u32 guest_sysenter_cs;
>> +
>> +	u64 cr0_guest_host_mask;
>> +	u64 cr4_guest_host_mask;
>> +	u64 cr0_read_shadow;
>> +	u64 cr4_read_shadow;
>> +	u64 guest_cr0;
>> +	u64 guest_cr3;
>> +	u64 guest_cr4;
>> +	u64 guest_dr7;
>> +
>> +	u64 host_fs_base;
>> +	u64 host_gs_base;
>> +	u64 host_tr_base;
>> +	u64 host_gdtr_base;
>> +	u64 host_idtr_base;
>> +	u64 host_rsp;
>> +
>> +	u64 ept_pointer;
>> +
>> +	u16 virtual_processor_id;
>> +	u16 padding16_2[3];
>> +
>> +	u64 padding64_2[5];
>> +	u64 guest_physical_address;
>> +
>> +	u32 vm_instruction_error;
>> +	u32 vm_exit_reason;
>> +	u32 vm_exit_intr_info;
>> +	u32 vm_exit_intr_error_code;
>> +	u32 idt_vectoring_info_field;
>> +	u32 idt_vectoring_error_code;
>> +	u32 vm_exit_instruction_len;
>> +	u32 vmx_instruction_info;
>> +
>> +	u64 exit_qualification;
>> +	u64 exit_io_instruction_ecx;
>> +	u64 exit_io_instruction_esi;
>> +	u64 exit_io_instruction_edi;
>> +	u64 exit_io_instruction_eip;
>> +
>> +	u64 guest_linear_address;
>> +	u64 guest_rsp;
>> +	u64 guest_rflags;
>> +
>> +	u32 guest_interruptibility_info;
>> +	u32 cpu_based_vm_exec_control;
>> +	u32 exception_bitmap;
>> +	u32 vm_entry_controls;
>> +	u32 vm_entry_intr_info_field;
>> +	u32 vm_entry_exception_error_code;
>> +	u32 vm_entry_instruction_len;
>> +	u32 tpr_threshold;
>> +
>> +	u64 guest_rip;
>> +
>> +	u32 hv_clean_fields;
>> +	u32 padding32_1;
>> +	u32 hv_synthetic_controls;
>> +	struct {
>> +		u32 nested_flush_hypercall:1;
>> +		u32 msr_bitmap:1;
>> +		u32 reserved:30;
>> +	}  __packed hv_enlightenments_control;
>> +	u32 hv_vp_id;
>> +	u32 padding32_2;
>> +	u64 hv_vm_id;
>> +	u64 partition_assist_page;
>> +	u64 padding64_4[4];
>> +	u64 guest_bndcfgs;
>> +	u64 guest_ia32_perf_global_ctrl;
>> +	u64 guest_ia32_s_cet;
>> +	u64 guest_ssp;
>> +	u64 guest_ia32_int_ssp_table_addr;
>> +	u64 guest_ia32_lbr_ctl;
>> +	u64 padding64_5[2];
>> +	u64 xss_exit_bitmap;
>> +	u64 encls_exiting_bitmap;
>> +	u64 host_ia32_perf_global_ctrl;
>> +	u64 tsc_multiplier;
>> +	u64 host_ia32_s_cet;
>> +	u64 host_ssp;
>> +	u64 host_ia32_int_ssp_table_addr;
>> +	u64 padding64_6;
>> +} __packed;
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_NONE			0
>> +
>> +
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_IO_BITMAP		BIT(0)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_MSR_BITMAP		BIT(1)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_GRP2		BIT(2)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_GRP1		BIT(3)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_PROC		BIT(4)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_EVENT		BIT(5)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_ENTRY		BIT(6)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_EXCPN		BIT(7)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CRDR			BIT(8)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_CONTROL_XLAT		BIT(9)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_BASIC		BIT(10)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_GRP1		BIT(11)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_GUEST_GRP2		BIT(12)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_HOST_POINTER		BIT(13)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_HOST_GRP1		BIT(14)
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_ENLIGHTENMENTSCONTROL	BIT(15)
>> +
>> +#define HV_VMX_ENLIGHTENED_CLEAN_FIELD_ALL			0xFFFF
>> +
>> +/*
>> + * Note, Hyper-V isn't actually stealing bit 28 from Intel, just abusing it by
>> + * pairing it with architecturally impossible exit reasons.  Bit 28 is set only
>> + * on SMI exits to a SMI transfer monitor (STM) and if and only if a MTF VM-Exit
>> + * is pending.  I.e. it will never be set by hardware for non-SMI exits (there
>> + * are only three), nor will it ever be set unless the VMM is an STM.
>> + */
>> +#define HV_VMX_SYNTHETIC_EXIT_REASON_TRAP_AFTER_FLUSH
>> 	0x10000031
>> +
>> +/*
>> + * Hyper-V uses the software reserved 32 bytes in VMCB control area to expose
>> + * SVM enlightenments to guests. This is documented in the TLFS doc.
>> + * Note on naming: SVM_NESTED_ENLIGHTENED_VMCB_FIELDS
>> + */
>> +struct hv_vmcb_enlightenments {
>> +	struct __packed hv_enlightenments_control {
>> +		u32 nested_flush_hypercall : 1;
>> +		u32 msr_bitmap : 1;
>> +		u32 enlightened_npt_tlb: 1;
>> +		u32 reserved : 29;
>> +	} __packed hv_enlightenments_control;
>> +	u32 hv_vp_id;
>> +	u64 hv_vm_id;
>> +	u64 partition_assist_page;
>> +	u64 reserved;
>> +} __packed;
>> +
>> +/*
>> + * Hyper-V uses the software reserved clean bit in VMCB.
>> + */
>> +#define HV_VMCB_NESTED_ENLIGHTENMENTS		31
>> +
>> +/* Synthetic VM-Exit */
>> +#define HV_SVM_EXITCODE_ENL			0xf0000000
>> +#define HV_SVM_ENL_EXITCODE_TRAP_AFTER_FLUSH	(1)
>> +
>> +/* Define connection identifier type. */
>> +union hv_connection_id {
>> +	u32 asu32;
>> +	struct {
>> +		u32 id : 24;
>> +		u32 reserved : 8;
>> +	} __packed u;
>> +};
>> +
>> +struct hv_input_unmap_gpa_pages {
>> +	u64 target_partition_id;
>> +	u64 target_gpa_base;
>> +	u32 unmap_flags;
>> +	u32 padding;
>> +} __packed;
>> +
>> +#endif /* #ifndef _HV_HVGDK_H */
>> diff --git a/include/hyperv/hvgdk_ext.h b/include/hyperv/hvgdk_ext.h
>> new file mode 100644
>> index 000000000000..641b591ee61f
>> --- /dev/null
>> +++ b/include/hyperv/hvgdk_ext.h
>> @@ -0,0 +1,46 @@
>> +/* SPDX-License-Identifier: GPL-2.0 */
>> +/*
>> + * Type definitions for the Microsoft Hypervisor.
>> + */
>> +#ifndef _HV_HVGDK_EXT_H
>> +#define _HV_HVGDK_EXT_H
>> +
>> +#include "hvgdk_mini.h"
>> +
>> +/* Extended hypercalls */
>> +#define HV_EXT_CALL_QUERY_CAPABILITIES		0x8001
>> +#define HV_EXT_CALL_MEMORY_HEAT_HINT		0x8003
>> +
>> +/* Extended hypercalls */
>> +enum {		/* HV_EXT_CALL */
>> +	HV_EXTCALL_QUERY_CAPABILITIES = 0x8001,
>> +	HV_EXTCALL_MEMORY_HEAT_HINT   = 0x8003,
>> +};
>> +
>> +/* HV_EXT_OUTPUT_QUERY_CAPABILITIES */
>> +#define HV_EXT_CAPABILITY_MEMORY_COLD_DISCARD_HINT BIT(8)
>> +
>> +enum {		/* HV_EXT_MEMORY_HEAT_HINT_TYPE */
>> +	HV_EXTMEM_HEAT_HINT_COLD = 0,
>> +	HV_EXTMEM_HEAT_HINT_HOT = 1,
>> +	HV_EXTMEM_HEAT_HINT_COLD_DISCARD = 2,
>> +	HV_EXTMEM_HEAT_HINT_MAX
>> +};
>> +
>> +/*
>> + * The whole argument should fit in a page to be able to pass to the hypervisor
>> + * in one hypercall.
>> + */
>> +#define HV_MEMORY_HINT_MAX_GPA_PAGE_RANGES  \
>> +	((HV_HYP_PAGE_SIZE - sizeof(struct hv_memory_hint)) / \
>> +		sizeof(union hv_gpa_page_range))
>> +
>> +/* HvExtCallMemoryHeatHint hypercall */
>> +#define HV_EXT_MEMORY_HEAT_HINT_TYPE_COLD_DISCARD	2
>> +struct hv_memory_hint {		/* HV_EXT_INPUT_MEMORY_HEAT_HINT */
>> +	u64 heat_type : 2;	/* HV_EXTMEM_HEAT_HINT_* */
>> +	u64 reserved : 62;
>> +	union hv_gpa_page_range ranges[];
>> +} __packed;
>> +
>> +#endif /* _HV_HVGDK_EXT_H */
>> diff --git a/include/hyperv/hvgdk_mini.h b/include/hyperv/hvgdk_mini.h
>> new file mode 100644
>> index 000000000000..c78f345fa4af
>> --- /dev/null
>> +++ b/include/hyperv/hvgdk_mini.h
>> @@ -0,0 +1,1295 @@
>> +/* SPDX-License-Identifier: GPL-2.0 */
>> +/*
>> + * Type definitions for the Microsoft hypervisor.
>> + */
>> +#ifndef _HV_HVGDK_MINI_H
>> +#define _HV_HVGDK_MINI_H
>> +
>> +#include <linux/types.h>
>> +#include <linux/bits.h>
>> +
>> +struct hv_u128 {
>> +	u64 low_part;
>> +	u64 high_part;
>> +} __packed;
>> +
>> +/* NOTE: when adding below, update hv_status_to_string() */
>> +#define HV_STATUS_SUCCESS			    0x0
>> +#define HV_STATUS_INVALID_HYPERCALL_CODE	    0x2
>> +#define HV_STATUS_INVALID_HYPERCALL_INPUT	    0x3
>> +#define HV_STATUS_INVALID_ALIGNMENT		    0x4
>> +#define HV_STATUS_INVALID_PARAMETER		    0x5
>> +#define HV_STATUS_ACCESS_DENIED			    0x6
>> +#define HV_STATUS_INVALID_PARTITION_STATE	    0x7
>> +#define HV_STATUS_OPERATION_DENIED		    0x8
>> +#define HV_STATUS_UNKNOWN_PROPERTY		    0x9
>> +#define HV_STATUS_PROPERTY_VALUE_OUT_OF_RANGE	    0xA
>> +#define HV_STATUS_INSUFFICIENT_MEMORY		    0xB
>> +#define HV_STATUS_INVALID_PARTITION_ID		    0xD
>> +#define HV_STATUS_INVALID_VP_INDEX		    0xE
>> +#define HV_STATUS_NOT_FOUND			    0x10
>> +#define HV_STATUS_INVALID_PORT_ID		    0x11
>> +#define HV_STATUS_INVALID_CONNECTION_ID		    0x12
>> +#define HV_STATUS_INSUFFICIENT_BUFFERS		    0x13
>> +#define HV_STATUS_NOT_ACKNOWLEDGED		    0x14
>> +#define HV_STATUS_INVALID_VP_STATE		    0x15
>> +#define HV_STATUS_NO_RESOURCES			    0x1D
>> +#define HV_STATUS_PROCESSOR_FEATURE_NOT_SUPPORTED   0x20
>> +#define HV_STATUS_INVALID_LP_INDEX		    0x41
>> +#define HV_STATUS_INVALID_REGISTER_VALUE	    0x50
>> +#define HV_STATUS_OPERATION_FAILED		    0x71
>> +#define HV_STATUS_TIME_OUT			    0x78
>> +#define HV_STATUS_CALL_PENDING			    0x79
>> +#define HV_STATUS_VTL_ALREADY_ENABLED		    0x86
>> +
>> +/*
>> + * The Hyper-V TimeRefCount register and the TSC
>> + * page provide a guest VM clock with 100ns tick rate
>> + */
>> +#define HV_CLOCK_HZ (NSEC_PER_SEC / 100)
>> +
>> +#define HV_HYP_PAGE_SHIFT		12
>> +#define HV_HYP_PAGE_SIZE		BIT(HV_HYP_PAGE_SHIFT)
>> +#define HV_HYP_PAGE_MASK		(~(HV_HYP_PAGE_SIZE - 1))
>> +
>> +#define HV_PARTITION_ID_INVALID		((u64)0)
>> +#define HV_PARTITION_ID_SELF		((u64)-1)
>> +
>> +/* Hyper-V specific model specific registers (MSRs) */
>> +
>> +#if defined(CONFIG_X86)
>> +/* HV_X64_SYNTHETIC_MSR */
>> +#define HV_X64_MSR_GUEST_OS_ID			0x40000000
>> +#define HV_X64_MSR_HYPERCALL			0x40000001
>> +#define HV_X64_MSR_VP_INDEX			0x40000002
>> +#define HV_X64_MSR_RESET			0x40000003
>> +#define HV_X64_MSR_VP_RUNTIME			0x40000010
>> +#define HV_X64_MSR_TIME_REF_COUNT		0x40000020
>> +#define HV_X64_MSR_REFERENCE_TSC		0x40000021
>> +#define HV_X64_MSR_TSC_FREQUENCY		0x40000022
>> +#define HV_X64_MSR_APIC_FREQUENCY		0x40000023
>> +
>> +/* Define the virtual APIC registers */
>> +#define HV_X64_MSR_EOI				0x40000070
>> +#define HV_X64_MSR_ICR				0x40000071
>> +#define HV_X64_MSR_TPR				0x40000072
>> +#define HV_X64_MSR_VP_ASSIST_PAGE		0x40000073
>> +
>> +/* Define synthetic interrupt controller model specific registers. */
>> +#define HV_X64_MSR_SCONTROL			0x40000080
>> +#define HV_X64_MSR_SVERSION			0x40000081
>> +#define HV_X64_MSR_SIEFP			0x40000082
>> +#define HV_X64_MSR_SIMP				0x40000083
>> +#define HV_X64_MSR_EOM				0x40000084
>> +#define HV_X64_MSR_SIRBP			0x40000085
>> +#define HV_X64_MSR_SINT0			0x40000090
>> +#define HV_X64_MSR_SINT1			0x40000091
>> +#define HV_X64_MSR_SINT2			0x40000092
>> +#define HV_X64_MSR_SINT3			0x40000093
>> +#define HV_X64_MSR_SINT4			0x40000094
>> +#define HV_X64_MSR_SINT5			0x40000095
>> +#define HV_X64_MSR_SINT6			0x40000096
>> +#define HV_X64_MSR_SINT7			0x40000097
>> +#define HV_X64_MSR_SINT8			0x40000098
>> +#define HV_X64_MSR_SINT9			0x40000099
>> +#define HV_X64_MSR_SINT10			0x4000009A
>> +#define HV_X64_MSR_SINT11			0x4000009B
>> +#define HV_X64_MSR_SINT12			0x4000009C
>> +#define HV_X64_MSR_SINT13			0x4000009D
>> +#define HV_X64_MSR_SINT14			0x4000009E
>> +#define HV_X64_MSR_SINT15			0x4000009F
>> +
>> +/* Define synthetic interrupt controller model specific registers for nested hypervisor */
>> +#define HV_X64_MSR_NESTED_SCONTROL		0x40001080
>> +#define HV_X64_MSR_NESTED_SVERSION		0x40001081
>> +#define HV_X64_MSR_NESTED_SIEFP			0x40001082
>> +#define HV_X64_MSR_NESTED_SIMP			0x40001083
>> +#define HV_X64_MSR_NESTED_EOM			0x40001084
>> +#define HV_X64_MSR_NESTED_SINT0			0x40001090
>> +
>> +/*
>> + * Synthetic Timer MSRs. Four timers per vcpu.
>> + */
>> +#define HV_X64_MSR_STIMER0_CONFIG		0x400000B0
>> +#define HV_X64_MSR_STIMER0_COUNT		0x400000B1
>> +#define HV_X64_MSR_STIMER1_CONFIG		0x400000B2
>> +#define HV_X64_MSR_STIMER1_COUNT		0x400000B3
>> +#define HV_X64_MSR_STIMER2_CONFIG		0x400000B4
>> +#define HV_X64_MSR_STIMER2_COUNT		0x400000B5
>> +#define HV_X64_MSR_STIMER3_CONFIG		0x400000B6
>> +#define HV_X64_MSR_STIMER3_COUNT		0x400000B7
>> +
>> +/* Hyper-V guest idle MSR */
>> +#define HV_X64_MSR_GUEST_IDLE			0x400000F0
>> +
>> +/* Hyper-V guest crash notification MSR's */
>> +#define HV_X64_MSR_CRASH_P0			0x40000100
>> +#define HV_X64_MSR_CRASH_P1			0x40000101
>> +#define HV_X64_MSR_CRASH_P2			0x40000102
>> +#define HV_X64_MSR_CRASH_P3			0x40000103
>> +#define HV_X64_MSR_CRASH_P4			0x40000104
>> +#define HV_X64_MSR_CRASH_CTL			0x40000105
>> +
>> +#define HV_X64_MSR_HYPERCALL_ENABLE		0x00000001
>> +#define HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_SHIFT	12
>> +#define HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_MASK	\
>> +		(~((1ull << HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_SHIFT) - 1))
>> +
>> +#define HV_X64_MSR_CRASH_PARAMS		\
>> +		(1 + (HV_X64_MSR_CRASH_P4 - HV_X64_MSR_CRASH_P0))
>> +
>> +#define HV_IPI_LOW_VECTOR	 0x10
>> +#define HV_IPI_HIGH_VECTOR	 0xff
>> +
>> +#define HV_X64_MSR_VP_ASSIST_PAGE_ENABLE	0x00000001
>> +#define HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_SHIFT	12
>> +#define HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_MASK	\
>> +		(~((1ull << HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_SHIFT) - 1))
>> +
>> +/* Hyper-V Enlightened VMCS version mask in nested features CPUID */
>> +#define HV_X64_ENLIGHTENED_VMCS_VERSION		0xff
>> +
>> +#define HV_X64_MSR_TSC_REFERENCE_ENABLE		0x00000001
>> +#define HV_X64_MSR_TSC_REFERENCE_ADDRESS_SHIFT	12
>> +
>> +/* Number of XMM registers used in hypercall input/output */
>> +#define HV_HYPERCALL_MAX_XMM_REGISTERS		6
>> +
>> +struct hv_reenlightenment_control {
>> +	u64 vector : 8;
>> +	u64 reserved1 : 8;
>> +	u64 enabled : 1;
>> +	u64 reserved2 : 15;
>> +	u64 target_vp : 32;
>> +}  __packed;
>> +
>> +struct hv_tsc_emulation_status {	 /* HV_TSC_EMULATION_STATUS */
>> +	u64 inprogress : 1;
>> +	u64 reserved : 63;
>> +} __packed;
>> +
>> +struct hv_tsc_emulation_control {	 /* HV_TSC_INVARIANT_CONTROL */
>> +	u64 enabled : 1;
>> +	u64 reserved : 63;
>> +} __packed;
>> +
>> +/* TSC emulation after migration */
>> +#define HV_X64_MSR_REENLIGHTENMENT_CONTROL	0x40000106
>> +#define HV_X64_MSR_TSC_EMULATION_CONTROL	0x40000107
>> +#define HV_X64_MSR_TSC_EMULATION_STATUS		0x40000108
>> +#define HV_X64_MSR_TSC_INVARIANT_CONTROL	0x40000118
>> +#define HV_EXPOSE_INVARIANT_TSC		BIT_ULL(0)
>> +
>> +#endif /* CONFIG_X86 */
>> +
>> +struct hv_get_partition_id {	 /* HV_OUTPUT_GET_PARTITION_ID */
>> +	u64 partition_id;
>> +} __packed;
>> +
>> +/* HV_CRASH_CTL_REG_CONTENTS */
>> +#define HV_CRASH_CTL_CRASH_NOTIFY_MSG		 BIT_ULL(62)
>> +#define HV_CRASH_CTL_CRASH_NOTIFY		 BIT_ULL(63)
>> +
>> +union hv_reference_tsc_msr {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 enable : 1;
>> +		u64 reserved : 11;
>> +		u64 pfn : 52;
>> +	} __packed;
>> +};
>> +
>> +/* The maximum number of sparse vCPU banks which can be encoded by 'struct
>> hv_vpset' */
>> +#define HV_MAX_SPARSE_VCPU_BANKS (64)
>> +/* The number of vCPUs in one sparse bank */
>> +#define HV_VCPUS_PER_SPARSE_BANK (64)
>> +
>> +/* Some of Hyper-V structs do not use hv_vpset where linux uses them */
>> +struct hv_vpset {	 /* HV_VP_SET */
>> +	u64 format;
>> +	u64 valid_bank_mask;
>> +	u64 bank_contents[];
>> +} __packed;
>> +
>> +/*
>> + * Version info reported by hypervisor
>> + * Changed to a union for convenience
>> + */
>> +union hv_hypervisor_version_info {
>> +	struct {
>> +		u32 build_number;
>> +
>> +		u32 minor_version : 16;
>> +		u32 major_version : 16;
>> +
>> +		u32 service_pack;
>> +
>> +		u32 service_number : 24;
>> +		u32 service_branch : 8;
>> +	};
>> +	struct {
>> +		u32 eax;
>> +		u32 ebx;
>> +		u32 ecx;
>> +		u32 edx;
>> +	};
>> +};
>> +
>> +/* HV_CPUID_FUNCTION */
>> +#define HYPERV_CPUID_VENDOR_AND_MAX_FUNCTIONS	0x40000000
>> +#define HYPERV_CPUID_INTERFACE			0x40000001
>> +#define HYPERV_CPUID_VERSION			0x40000002
>> +#define HYPERV_CPUID_FEATURES			0x40000003
>> +#define HYPERV_CPUID_ENLIGHTMENT_INFO		0x40000004
>> +#define HYPERV_CPUID_IMPLEMENT_LIMITS		0x40000005
>> +#define HYPERV_CPUID_CPU_MANAGEMENT_FEATURES	0x40000007
>> +#define HYPERV_CPUID_NESTED_FEATURES		0x4000000A
>> +#define HYPERV_CPUID_ISOLATION_CONFIG		0x4000000C
>> +
>> +#define HYPERV_CPUID_VIRT_STACK_INTERFACE	 0x40000081
>> +#define HYPERV_VS_INTERFACE_EAX_SIGNATURE	 0x31235356  /* "VS#1" */
>> +
>> +#define HYPERV_CPUID_VIRT_STACK_PROPERTIES	 0x40000082
>> +/* Support for the extended IOAPIC RTE format */
>> +#define HYPERV_VS_PROPERTIES_EAX_EXTENDED_IOAPIC_RTE	 BIT(2)
>> +
>> +#define HYPERV_HYPERVISOR_PRESENT_BIT		 0x80000000
>> +#define HYPERV_CPUID_MIN			 0x40000005
>> +#define HYPERV_CPUID_MAX			 0x4000ffff
>> +
>> +/* HV_PARTITION_PRIVILEGE_MASK */
>> +#define HV_MSR_VP_RUNTIME_AVAILABLE			BIT(0)
>> +#define HV_MSR_TIME_REF_COUNT_AVAILABLE			BIT(1)
>> +#define HV_MSR_SYNIC_AVAILABLE				BIT(2)
>> +#define HV_MSR_SYNTIMER_AVAILABLE			BIT(3)
>> +#define HV_MSR_APIC_ACCESS_AVAILABLE			BIT(4)
>> +#define HV_MSR_HYPERCALL_AVAILABLE			BIT(5)
>> +#define HV_MSR_VP_INDEX_AVAILABLE			BIT(6)
>> +#define HV_MSR_RESET_AVAILABLE				BIT(7)
>> +#define HV_MSR_STAT_PAGES_AVAILABLE			BIT(8)
>> +#define HV_MSR_REFERENCE_TSC_AVAILABLE			BIT(9)
>> +#define HV_MSR_GUEST_IDLE_AVAILABLE			BIT(10)
>> +#define HV_ACCESS_FREQUENCY_MSRS			BIT(11)
>> +#define HV_ACCESS_REENLIGHTENMENT			BIT(13)
>> +#define HV_ACCESS_TSC_INVARIANT				BIT(15)
>> +
>> +/* HV_PARTITION_PRIVILEGE_MASK */
>> +#define HV_CREATE_PARTITIONS				BIT(0)
>> +#define HV_ACCESS_PARTITION_ID				BIT(1)
>> +#define HV_ACCESS_MEMORY_POOL				BIT(2)
>> +#define HV_ADJUST_MESSAGE_BUFFERS			BIT(3)
>> +#define HV_POST_MESSAGES				BIT(4)
>> +#define HV_SIGNAL_EVENTS				BIT(5)
>> +#define HV_CREATE_PORT					BIT(6)
>> +#define HV_CONNECT_PORT					BIT(7)
>> +#define HV_ACCESS_STATS					BIT(8)
>> +#define HV_DEBUGGING					BIT(11)
>> +#define HV_CPU_MANAGEMENT				BIT(12)
>> +#define HV_ENABLE_EXTENDED_HYPERCALLS			BIT(20)
>> +#define HV_ISOLATION					BIT(22)
>> +
>> +#if defined(CONFIG_X86)
>> +/* HV_X64_HYPERVISOR_FEATURES (EDX) */
>> +#define HV_X64_MWAIT_AVAILABLE				BIT(0)
>> +#define HV_X64_GUEST_DEBUGGING_AVAILABLE		BIT(1)
>> +#define HV_X64_PERF_MONITOR_AVAILABLE			BIT(2)
>> +#define HV_X64_CPU_DYNAMIC_PARTITIONING_AVAILABLE	BIT(3)
>> +#define HV_X64_HYPERCALL_XMM_INPUT_AVAILABLE		BIT(4)
>> +#define HV_X64_GUEST_IDLE_STATE_AVAILABLE		BIT(5)
>> +#define HV_FEATURE_FREQUENCY_MSRS_AVAILABLE		BIT(8)
>> +#define HV_FEATURE_GUEST_CRASH_MSR_AVAILABLE		BIT(10)
>> +#define HV_FEATURE_DEBUG_MSRS_AVAILABLE			BIT(11)
>> +#define HV_FEATURE_EXT_GVA_RANGES_FLUSH			BIT(14)
>> +/*
>> + * Support for returning hypercall output block via XMM
>> + * registers is available
>> + */
>> +#define HV_X64_HYPERCALL_XMM_OUTPUT_AVAILABLE		BIT(15)
>> +/* stimer Direct Mode is available */
>> +#define HV_STIMER_DIRECT_MODE_AVAILABLE			BIT(19)
>> +
>> +/* HV_X64_ENLIGHTENMENT_INFORMATION */
>> +#define HV_X64_AS_SWITCH_RECOMMENDED			BIT(0)
>> +#define HV_X64_LOCAL_TLB_FLUSH_RECOMMENDED		BIT(1)
>> +#define HV_X64_REMOTE_TLB_FLUSH_RECOMMENDED		BIT(2)
>> +#define HV_X64_APIC_ACCESS_RECOMMENDED			BIT(3)
>> +#define HV_X64_SYSTEM_RESET_RECOMMENDED			BIT(4)
>> +#define HV_X64_RELAXED_TIMING_RECOMMENDED		BIT(5)
>> +#define HV_DEPRECATING_AEOI_RECOMMENDED			BIT(9)
>> +#define HV_X64_CLUSTER_IPI_RECOMMENDED			BIT(10)
>> +#define HV_X64_EX_PROCESSOR_MASKS_RECOMMENDED		BIT(11)
>> +#define HV_X64_HYPERV_NESTED				BIT(12)
>> +#define HV_X64_ENLIGHTENED_VMCS_RECOMMENDED		BIT(14)
>> +#define HV_X64_USE_MMIO_HYPERCALLS			BIT(21)
>> +
>> +/*
>> + * CPU management features identification.
>> + * These are HYPERV_CPUID_CPU_MANAGEMENT_FEATURES.EAX bits.
>> + */
>> +#define HV_X64_START_LOGICAL_PROCESSOR			BIT(0)
>> +#define HV_X64_CREATE_ROOT_VIRTUAL_PROCESSOR		BIT(1)
>> +#define HV_X64_PERFORMANCE_COUNTER_SYNC			BIT(2)
>> +#define HV_X64_RESERVED_IDENTITY_BIT			BIT(31)
>> +
>> +/*
>> + * Virtual processor will never share a physical core with another virtual
>> + * processor, except for virtual processors that are reported as sibling SMT
>> + * threads.
>> + */
>> +#define HV_X64_NO_NONARCH_CORESHARING			BIT(18)
>> +
>> +/* Nested features. These are HYPERV_CPUID_NESTED_FEATURES.EAX bits. */
>> +#define HV_X64_NESTED_DIRECT_FLUSH			BIT(17)
>> +#define HV_X64_NESTED_GUEST_MAPPING_FLUSH		BIT(18)
>> +#define HV_X64_NESTED_MSR_BITMAP			BIT(19)
>> +
>> +/* Nested features #2. These are HYPERV_CPUID_NESTED_FEATURES.EBX bits. */
>> +#define HV_X64_NESTED_EVMCS1_PERF_GLOBAL_CTRL		BIT(0)
>> +
>> +/*
>> + * This is specific to AMD and specifies that enlightened TLB flush is
>> + * supported. If guest opts in to this feature, ASID invalidations only
>> + * flushes gva -> hpa mapping entries. To flush the TLB entries derived
>> + * from NPT, hypercalls should be used (HvFlushGuestPhysicalAddressSpace
>> + * or HvFlushGuestPhysicalAddressList).
>> + */
>> +#define HV_X64_NESTED_ENLIGHTENED_TLB			BIT(22)
>> +
>> +/* HYPERV_CPUID_ISOLATION_CONFIG.EAX bits. */
>> +#define HV_PARAVISOR_PRESENT				BIT(0)
>> +
>> +/* HYPERV_CPUID_ISOLATION_CONFIG.EBX bits. */
>> +#define HV_ISOLATION_TYPE				GENMASK(3, 0)
>> +#define HV_SHARED_GPA_BOUNDARY_ACTIVE			BIT(5)
>> +#define HV_SHARED_GPA_BOUNDARY_BITS			GENMASK(11, 6)
>> +
>> +enum hv_isolation_type {
>> +	HV_ISOLATION_TYPE_NONE	= 0,	/*
>> HV_PARTITION_ISOLATION_TYPE_NONE */
>> +	HV_ISOLATION_TYPE_VBS	= 1,
>> +	HV_ISOLATION_TYPE_SNP	= 2,
>> +	HV_ISOLATION_TYPE_TDX	= 3
>> +};
>> +
>> +union hv_x64_msr_hypercall_contents {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 enable : 1;
>> +		u64 reserved : 11;
>> +		u64 guest_physical_address : 52;
>> +	} __packed;
>> +};
>> +#endif /* CONFIG_X86 */
>> +
>> +#if defined(CONFIG_ARM64)
>> +#define HV_FEATURE_GUEST_CRASH_MSR_AVAILABLE	BIT(8)
>> +#define HV_STIMER_DIRECT_MODE_AVAILABLE		BIT(13)
>> +#endif /* CONFIG_ARM64 */
>> +
>> +#if defined(CONFIG_X86)
>> +#define HV_MAXIMUM_PROCESSORS	    2048
>> +#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
>> +#define HV_MAXIMUM_PROCESSORS	    320
>> +#endif /* CONFIG_ARM64 */
>> +
>> +#define HV_MAX_VP_INDEX			(HV_MAXIMUM_PROCESSORS - 1)
>> +#define HV_VP_INDEX_SELF		((u32)-2)
>> +#define HV_ANY_VP			((u32)-1)
>> +
>> +union hv_vp_assist_msr_contents {	 /* HV_REGISTER_VP_ASSIST_PAGE */
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 enable : 1;
>> +		u64 reserved : 11;
>> +		u64 pfn : 52;
>> +	} __packed;
>> +};
>> +
>> +/* Declare the various hypercall operations. */
>> +/* HV_CALL_CODE */
>> +#define HVCALL_FLUSH_VIRTUAL_ADDRESS_SPACE		0x0002
>> +#define HVCALL_FLUSH_VIRTUAL_ADDRESS_LIST		0x0003
>> +#define HVCALL_NOTIFY_LONG_SPIN_WAIT			0x0008
>> +#define HVCALL_SEND_IPI					0x000b
>> +#define HVCALL_ENABLE_VP_VTL				0x000f
>> +#define HVCALL_FLUSH_VIRTUAL_ADDRESS_SPACE_EX		0x0013
>> +#define HVCALL_FLUSH_VIRTUAL_ADDRESS_LIST_EX		0x0014
>> +#define HVCALL_SEND_IPI_EX				0x0015
>> +#define HVCALL_CREATE_PARTITION				0x0040
>> +#define HVCALL_INITIALIZE_PARTITION			0x0041
>> +#define HVCALL_FINALIZE_PARTITION			0x0042
>> +#define HVCALL_DELETE_PARTITION				0x0043
>> +#define HVCALL_GET_PARTITION_PROPERTY			0x0044
>> +#define HVCALL_SET_PARTITION_PROPERTY			0x0045
>> +#define HVCALL_GET_PARTITION_ID				0x0046
>> +#define HVCALL_DEPOSIT_MEMORY				0x0048
>> +#define HVCALL_WITHDRAW_MEMORY				0x0049
>> +#define HVCALL_MAP_GPA_PAGES				0x004b
>> +#define HVCALL_UNMAP_GPA_PAGES				0x004c
>> +#define HVCALL_CREATE_VP				0x004e
>> +#define HVCALL_DELETE_VP				0x004f
>> +#define HVCALL_GET_VP_REGISTERS				0x0050
>> +#define HVCALL_SET_VP_REGISTERS				0x0051
>> +#define HVCALL_DELETE_PORT				0x0058
>> +#define HVCALL_DISCONNECT_PORT				0x005b
>> +#define HVCALL_POST_MESSAGE				0x005c
>> +#define HVCALL_SIGNAL_EVENT				0x005d
>> +#define HVCALL_POST_DEBUG_DATA				0x0069
>> +#define HVCALL_RETRIEVE_DEBUG_DATA			0x006a
>> +#define HVCALL_RESET_DEBUG_SESSION			0x006b
>> +#define HVCALL_ADD_LOGICAL_PROCESSOR			0x0076
>> +#define HVCALL_GET_SYSTEM_PROPERTY			0x007b
>> +#define HVCALL_MAP_DEVICE_INTERRUPT			0x007c
>> +#define HVCALL_UNMAP_DEVICE_INTERRUPT			0x007d
>> +#define HVCALL_RETARGET_INTERRUPT			0x007e
>> +#define HVCALL_NOTIFY_PORT_RING_EMPTY			0x008b
>> +#define HVCALL_ASSERT_VIRTUAL_INTERRUPT			0x0094
>> +#define HVCALL_CREATE_PORT				0x0095
>> +#define HVCALL_CONNECT_PORT				0x0096
>> +#define HVCALL_START_VP					0x0099
>> +#define HVCALL_GET_VP_ID_FROM_APIC_ID			0x009a
>> +#define HVCALL_FLUSH_GUEST_PHYSICAL_ADDRESS_SPACE	0x00af
>> +#define HVCALL_FLUSH_GUEST_PHYSICAL_ADDRESS_LIST	0x00b0
>> +#define HVCALL_DISPATCH_VP				0x00c2
>> +#define HVCALL_MODIFY_SPARSE_GPA_PAGE_HOST_VISIBILITY	0x00db
>> +#define HVCALL_MAP_VP_STATE_PAGE			0x00e1
>> +#define HVCALL_UNMAP_VP_STATE_PAGE			0x00e2
>> +#define HVCALL_GET_VP_STATE				0x00e3
>> +#define HVCALL_SET_VP_STATE				0x00e4
>> +#define HVCALL_MMIO_READ				0x0106
>> +#define HVCALL_MMIO_WRITE				0x0107
>> +
>> +/* HV_HYPERCALL_INPUT */
>> +#define HV_HYPERCALL_RESULT_MASK	GENMASK_ULL(15, 0)
>> +#define HV_HYPERCALL_FAST_BIT		BIT(16)
>> +#define HV_HYPERCALL_VARHEAD_OFFSET	17
>> +#define HV_HYPERCALL_VARHEAD_MASK	GENMASK_ULL(26, 17)
>> +#define HV_HYPERCALL_RSVD0_MASK		GENMASK_ULL(31, 27)
>> +#define HV_HYPERCALL_NESTED		BIT_ULL(31)
>> +#define HV_HYPERCALL_REP_COMP_OFFSET	32
>> +#define HV_HYPERCALL_REP_COMP_1		BIT_ULL(32)
>> +#define HV_HYPERCALL_REP_COMP_MASK	GENMASK_ULL(43, 32)
>> +#define HV_HYPERCALL_RSVD1_MASK		GENMASK_ULL(47, 44)
>> +#define HV_HYPERCALL_REP_START_OFFSET	48
>> +#define HV_HYPERCALL_REP_START_MASK	GENMASK_ULL(59, 48)
>> +#define HV_HYPERCALL_RSVD2_MASK		GENMASK_ULL(63, 60)
>> +#define HV_HYPERCALL_RSVD_MASK		(HV_HYPERCALL_RSVD0_MASK | \
>> +					 HV_HYPERCALL_RSVD1_MASK | \
>> +					 HV_HYPERCALL_RSVD2_MASK)
>> +
>> +/* HvFlushGuestPhysicalAddressSpace hypercalls */
>> +struct hv_guest_mapping_flush {
>> +	u64 address_space;
>> +	u64 flags;
>> +} __packed;
>> +
>> +/*
>> + *  HV_MAX_FLUSH_PAGES = "additional_pages" + 1. It's limited
>> + *  by the bitwidth of "additional_pages" in union hv_gpa_page_range.
>> + */
>> +#define HV_MAX_FLUSH_PAGES (2048)
>> +#define HV_GPA_PAGE_RANGE_PAGE_SIZE_2MB		0
>> +#define HV_GPA_PAGE_RANGE_PAGE_SIZE_1GB		1
>> +
>> +#define HV_FLUSH_ALL_PROCESSORS			BIT(0)
>> +#define HV_FLUSH_ALL_VIRTUAL_ADDRESS_SPACES	BIT(1)
>> +#define HV_FLUSH_NON_GLOBAL_MAPPINGS_ONLY	BIT(2)
>> +#define HV_FLUSH_USE_EXTENDED_RANGE_FORMAT	BIT(3)
>> +
>> +/* HvFlushGuestPhysicalAddressList, HvExtCallMemoryHeatHint hypercall */
>> +union hv_gpa_page_range {
>> +	u64 address_space;
>> +	struct {
>> +		u64 additional_pages : 11;
>> +		u64 largepage : 1;
>> +		u64 basepfn : 52;
>> +	} page;
>> +	struct {
>> +		u64 reserved : 12;
>> +		u64 page_size : 1;
>> +		u64 reserved1 : 8;
>> +		u64 base_large_pfn : 43;
>> +	};
>> +};
>> +
>> +/*
>> + * All input flush parameters should be in single page. The max flush
>> + * count is equal with how many entries of union hv_gpa_page_range can
>> + * be populated into the input parameter page.
>> + */
>> +#define HV_MAX_FLUSH_REP_COUNT ((HV_HYP_PAGE_SIZE - 2 * sizeof(u64)) / \
>> +				sizeof(union hv_gpa_page_range))
>> +
>> +struct hv_guest_mapping_flush_list {
>> +	u64 address_space;
>> +	u64 flags;
>> +	union hv_gpa_page_range gpa_list[HV_MAX_FLUSH_REP_COUNT];
>> +};
>> +
>> +struct hv_tlb_flush {	 /* HV_INPUT_FLUSH_VIRTUAL_ADDRESS_LIST */
>> +	u64 address_space;
>> +	u64 flags;
>> +	u64 processor_mask;
>> +	u64 gva_list[];
>> +} __packed;
>> +
>> +/* HvFlushVirtualAddressSpaceEx, HvFlushVirtualAddressListEx hypercalls */
>> +struct hv_tlb_flush_ex {
>> +	u64 address_space;
>> +	u64 flags;
>> +	struct hv_vpset hv_vp_set;
>> +	u64 gva_list[];
>> +} __packed;
>> +
>> +struct ms_hyperv_tsc_page {	 /* HV_REFERENCE_TSC_PAGE */
>> +	volatile u32 tsc_sequence;
>> +	u32 reserved1;
>> +	volatile u64 tsc_scale;
>> +	volatile s64 tsc_offset;
>> +} __packed;
>> +
>> +/* Define the number of synthetic interrupt sources. */
>> +#define HV_SYNIC_SINT_COUNT (16)
>> +
>> +/* Define the expected SynIC version. */
>> +#define HV_SYNIC_VERSION_1		(0x1)
>> +/* Valid SynIC vectors are 16-255. */
>> +#define HV_SYNIC_FIRST_VALID_VECTOR	(16)
>> +
>> +#define HV_SYNIC_CONTROL_ENABLE		(1ULL << 0)
>> +#define HV_SYNIC_SIMP_ENABLE		(1ULL << 0)
>> +#define HV_SYNIC_SIEFP_ENABLE		(1ULL << 0)
>> +#define HV_SYNIC_SINT_MASKED		(1ULL << 16)
>> +#define HV_SYNIC_SINT_AUTO_EOI		(1ULL << 17)
>> +#define HV_SYNIC_SINT_VECTOR_MASK	(0xFF)
>> +
>> +#
>> +
>> +/* Hyper-V defined statically assigned SINTs */
>> +#define HV_SYNIC_INTERCEPTION_SINT_INDEX 0x00000000
>> +#define HV_SYNIC_IOMMU_FAULT_SINT_INDEX  0x00000001
>> +#define HV_SYNIC_VMBUS_SINT_INDEX	 0x00000002
>> +#define HV_SYNIC_FIRST_UNUSED_SINT_INDEX 0x00000005
>> +
>> +/* mshv assigned SINT for doorbell */
>> +#define HV_SYNIC_DOORBELL_SINT_INDEX     HV_SYNIC_FIRST_UNUSED_SINT_INDEX
>> +
>> +enum hv_interrupt_type {
>> +	HV_X64_INTERRUPT_TYPE_FIXED		= 0x0000,
>> +	HV_X64_INTERRUPT_TYPE_LOWESTPRIORITY	= 0x0001,
>> +	HV_X64_INTERRUPT_TYPE_SMI		= 0x0002,
>> +	HV_X64_INTERRUPT_TYPE_REMOTEREAD	= 0x0003,
>> +	HV_X64_INTERRUPT_TYPE_NMI		= 0x0004,
>> +	HV_X64_INTERRUPT_TYPE_INIT		= 0x0005,
>> +	HV_X64_INTERRUPT_TYPE_SIPI		= 0x0006,
>> +	HV_X64_INTERRUPT_TYPE_EXTINT		= 0x0007,
>> +	HV_X64_INTERRUPT_TYPE_LOCALINT0		= 0x0008,
>> +	HV_X64_INTERRUPT_TYPE_LOCALINT1		= 0x0009,
>> +	HV_X64_INTERRUPT_TYPE_MAXIMUM		= 0x000A,
>> +};
>> +
>> +/* Define synthetic interrupt source. */
>> +union hv_synic_sint {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 vector : 8;
>> +		u64 reserved1 : 8;
>> +		u64 masked : 1;
>> +		u64 auto_eoi : 1;
>> +		u64 polling : 1;
>> +		u64 as_intercept : 1;
>> +		u64 proxy : 1;
>> +		u64 reserved2 : 43;
>> +	} __packed;
>> +};
>> +
>> +union hv_x64_xsave_xfem_register {
>> +	u64 as_uint64;
>> +	struct {
>> +		u32 low_uint32;
>> +		u32 high_uint32;
>> +	} __packed;
>> +	struct {
>> +		u64 legacy_x87 : 1;
>> +		u64 legacy_sse : 1;
>> +		u64 avx : 1;
>> +		u64 mpx_bndreg : 1;
>> +		u64 mpx_bndcsr : 1;
>> +		u64 avx_512_op_mask : 1;
>> +		u64 avx_512_zmmhi : 1;
>> +		u64 avx_512_zmm16_31 : 1;
>> +		u64 rsvd8_9 : 2;
>> +		u64 pasid : 1;
>> +		u64 cet_u : 1;
>> +		u64 cet_s : 1;
>> +		u64 rsvd13_16 : 4;
>> +		u64 xtile_cfg : 1;
>> +		u64 xtile_data : 1;
>> +		u64 rsvd19_63 : 45;
>> +	} __packed;
>> +};
>> +
>> +/* Synthetic timer configuration */
>> +union hv_stimer_config {	 /* HV_X64_MSR_STIMER_CONFIG_CONTENTS */
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 enable : 1;
>> +		u64 periodic : 1;
>> +		u64 lazy : 1;
>> +		u64 auto_enable : 1;
>> +		u64 apic_vector : 8;
>> +		u64 direct_mode : 1;
>> +		u64 reserved_z0 : 3;
>> +		u64 sintx : 4;
>> +		u64 reserved_z1 : 44;
>> +	} __packed;
>> +};
>> +
>> +/* Define the number of synthetic timers */
>> +#define HV_SYNIC_STIMER_COUNT	(4)
>> +
>> +/* Define port identifier type. */
>> +union hv_port_id {
>> +	u32 asu32;
>> +	struct {
>> +		u32 id : 24;
>> +		u32 reserved : 8;
>> +	} __packed u;
>> +};
>> +
>> +#define HV_MESSAGE_SIZE			(256)
>> +#define HV_MESSAGE_PAYLOAD_BYTE_COUNT	(240)
>> +#define HV_MESSAGE_PAYLOAD_QWORD_COUNT	(30)
>> +
>> +/* Define hypervisor message types. */
>> +enum hv_message_type {
>> +	HVMSG_NONE				= 0x00000000,
>> +
>> +	/* Memory access messages. */
>> +	HVMSG_UNMAPPED_GPA			= 0x80000000,
>> +	HVMSG_GPA_INTERCEPT			= 0x80000001,
>> +
>> +	/* Timer notification messages. */
>> +	HVMSG_TIMER_EXPIRED			= 0x80000010,
>> +
>> +	/* Error messages. */
>> +	HVMSG_INVALID_VP_REGISTER_VALUE		= 0x80000020,
>> +	HVMSG_UNRECOVERABLE_EXCEPTION		= 0x80000021,
>> +	HVMSG_UNSUPPORTED_FEATURE		= 0x80000022,
>> +
>> +	/*
>> +	 * Opaque intercept message. The original intercept message is only
>> +	 * accessible from the mapped intercept message page.
>> +	 */
>> +	HVMSG_OPAQUE_INTERCEPT			= 0x8000003F,
>> +
>> +	/* Trace buffer complete messages. */
>> +	HVMSG_EVENTLOG_BUFFERCOMPLETE		= 0x80000040,
>> +
>> +	/* Hypercall intercept */
>> +	HVMSG_HYPERCALL_INTERCEPT		= 0x80000050,
>> +
>> +	/* SynIC intercepts */
>> +	HVMSG_SYNIC_EVENT_INTERCEPT		= 0x80000060,
>> +	HVMSG_SYNIC_SINT_INTERCEPT		= 0x80000061,
>> +	HVMSG_SYNIC_SINT_DELIVERABLE	= 0x80000062,
>> +
>> +	/* Async call completion intercept */
>> +	HVMSG_ASYNC_CALL_COMPLETION		= 0x80000070,
>> +
>> +	/* Root scheduler messages */
>> +	HVMSG_SCHEDULER_VP_SIGNAL_BITSET	= 0x80000100,
>> +	HVMSG_SCHEDULER_VP_SIGNAL_PAIR		= 0x80000101,
>> +
>> +	/* Platform-specific processor intercept messages. */
>> +	HVMSG_X64_IO_PORT_INTERCEPT		= 0x80010000,
>> +	HVMSG_X64_MSR_INTERCEPT			= 0x80010001,
>> +	HVMSG_X64_CPUID_INTERCEPT		= 0x80010002,
>> +	HVMSG_X64_EXCEPTION_INTERCEPT		= 0x80010003,
>> +	HVMSG_X64_APIC_EOI			= 0x80010004,
>> +	HVMSG_X64_LEGACY_FP_ERROR		= 0x80010005,
>> +	HVMSG_X64_IOMMU_PRQ			= 0x80010006,
>> +	HVMSG_X64_HALT				= 0x80010007,
>> +	HVMSG_X64_INTERRUPTION_DELIVERABLE	= 0x80010008,
>> +	HVMSG_X64_SIPI_INTERCEPT		= 0x80010009,
>> +};
>> +
>> +/* Define the format of the SIMP register */
>> +union hv_synic_simp {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 simp_enabled : 1;
>> +		u64 preserved : 11;
>> +		u64 base_simp_gpa : 52;
>> +	} __packed;
>> +};
>> +
>> +union hv_message_flags {
>> +	u8 asu8;
>> +	struct {
>> +		u8 msg_pending : 1;
>> +		u8 reserved : 7;
>> +	} __packed;
>> +};
>> +
>> +struct hv_message_header {
>> +	u32 message_type;
>> +	u8 payload_size;
>> +	union hv_message_flags message_flags;
>> +	u8 reserved[2];
>> +	union {
>> +		u64 sender;
>> +		union hv_port_id port;
>> +	};
>> +} __packed;
>> +
>> +/*
>> + * Message format for notifications delivered via
>> + * intercept message(as_intercept=1)
>> + */
>> +struct hv_notification_message_payload {
>> +	u32 sint_index;
>> +} __packed;
>> +
>> +struct hv_message {
>> +	struct hv_message_header header;
>> +	union {
>> +		u64 payload[HV_MESSAGE_PAYLOAD_QWORD_COUNT];
>> +	} u;
>> +} __packed;
>> +
>> +/* Define the synthetic interrupt message page layout. */
>> +struct hv_message_page {
>> +	struct hv_message sint_message[HV_SYNIC_SINT_COUNT];
>> +} __packed;
>> +
>> +/* Define timer message payload structure. */
>> +struct hv_timer_message_payload {
>> +	__u32 timer_index;
>> +	__u32 reserved;
>> +	__u64 expiration_time;	/* When the timer expired */
>> +	__u64 delivery_time;	/* When the message was delivered */
>> +} __packed;
>> +
>> +struct hv_x64_segment_register {
>> +	u64 base;
>> +	u32 limit;
>> +	u16 selector;
>> +	union {
>> +		struct {
>> +			u16 segment_type : 4;
>> +			u16 non_system_segment : 1;
>> +			u16 descriptor_privilege_level : 2;
>> +			u16 present : 1;
>> +			u16 reserved : 4;
>> +			u16 available : 1;
>> +			u16 _long : 1;
>> +			u16 _default : 1;
>> +			u16 granularity : 1;
>> +		} __packed;
>> +		u16 attributes;
>> +	};
>> +} __packed;
>> +
>> +struct hv_x64_table_register {
>> +	u16 pad[3];
>> +	u16 limit;
>> +	u64 base;
>> +} __packed;
>> +
>> +union hv_input_vtl {
>> +	u8 as_uint8;
>> +	struct {
>> +		u8 target_vtl : 4;
>> +		u8 use_target_vtl : 1;
>> +		u8 reserved_z : 3;
>> +	};
>> +} __packed;
>> +
>> +struct hv_init_vp_context {
>> +	u64 rip;
>> +	u64 rsp;
>> +	u64 rflags;
>> +
>> +	struct hv_x64_segment_register cs;
>> +	struct hv_x64_segment_register ds;
>> +	struct hv_x64_segment_register es;
>> +	struct hv_x64_segment_register fs;
>> +	struct hv_x64_segment_register gs;
>> +	struct hv_x64_segment_register ss;
>> +	struct hv_x64_segment_register tr;
>> +	struct hv_x64_segment_register ldtr;
>> +
>> +	struct hv_x64_table_register idtr;
>> +	struct hv_x64_table_register gdtr;
>> +
>> +	u64 efer;
>> +	u64 cr0;
>> +	u64 cr3;
>> +	u64 cr4;
>> +	u64 msr_cr_pat;
>> +} __packed;
>> +
>> +struct hv_enable_vp_vtl {
>> +	u64				partition_id;
>> +	u32				vp_index;
>> +	union hv_input_vtl		target_vtl;
>> +	u8				mbz0;
>> +	u16				mbz1;
>> +	struct hv_init_vp_context	vp_context;
>> +} __packed;
>> +
>> +struct hv_get_vp_from_apic_id_in {
>> +	u64 partition_id;
>> +	union hv_input_vtl target_vtl;
>> +	u8 res[7];
>> +	u32 apic_ids[];
>> +} __packed;
>> +
>> +struct hv_nested_enlightenments_control {
>> +	struct {
>> +		u32 directhypercall : 1;
>> +		u32 reserved : 31;
>> +	} __packed features;
>> +	struct {
>> +		u32 inter_partition_comm : 1;
>> +		u32 reserved : 31;
>> +	} __packed hypercall_controls;
>> +} __packed;
>> +
>> +/* Define virtual processor assist page structure. */
>> +struct hv_vp_assist_page {
>> +	u32 apic_assist;
>> +	u32 reserved1;
>> +	u32 vtl_entry_reason;
>> +	u32 vtl_reserved;
>> +	u64 vtl_ret_x64rax;
>> +	u64 vtl_ret_x64rcx;
>> +	struct hv_nested_enlightenments_control nested_control;
>> +	u8 enlighten_vmentry;
>> +	u8 reserved2[7];
>> +	u64 current_nested_vmcs;
>> +	u8 synthetic_time_unhalted_timer_expired;
>> +	u8 reserved3[7];
>> +	u8 virtualization_fault_information[40];
>> +	u8 reserved4[8];
>> +	u8 intercept_message[256];
>> +	u8 vtl_ret_actions[256];
>> +} __packed;
>> +
>> +enum hv_register_name {
>> +	/* Suspend Registers */
>> +	HV_REGISTER_EXPLICIT_SUSPEND				= 0x00000000,
>> +	HV_REGISTER_INTERCEPT_SUSPEND				= 0x00000001,
>> +	HV_REGISTER_DISPATCH_SUSPEND				= 0x00000003,
>> +
>> +	/* Version - 128-bit result same as CPUID 0x40000002 */
>> +	HV_REGISTER_HYPERVISOR_VERSION				= 0x00000100,
>> +
>> +	/* Feature Access (registers are 128 bits) - same as CPUID 0x40000003 -
>> 0x4000000B */
>> +	HV_REGISTER_PRIVILEGES_AND_FEATURES_INFO		= 0x00000200,
>> +	HV_REGISTER_FEATURES_INFO				= 0x00000201,
>> +	HV_REGISTER_IMPLEMENTATION_LIMITS_INFO			=
>> 0x00000202,
>> +	HV_REGISTER_HARDWARE_FEATURES_INFO			= 0x00000203,
>> +	HV_REGISTER_CPU_MANAGEMENT_FEATURES_INFO		= 0x00000204,
>> +	HV_REGISTER_SVM_FEATURES_INFO				= 0x00000205,
>> +	HV_REGISTER_SKIP_LEVEL_FEATURES_INFO			= 0x00000206,
>> +	HV_REGISTER_NESTED_VIRT_FEATURES_INFO			= 0x00000207,
>> +	HV_REGISTER_IPT_FEATURES_INFO				= 0x00000208,
>> +
>> +	/* Guest Crash Registers */
>> +	HV_REGISTER_GUEST_CRASH_P0				= 0x00000210,
>> +	HV_REGISTER_GUEST_CRASH_P1				= 0x00000211,
>> +	HV_REGISTER_GUEST_CRASH_P2				= 0x00000212,
>> +	HV_REGISTER_GUEST_CRASH_P3				= 0x00000213,
>> +	HV_REGISTER_GUEST_CRASH_P4				= 0x00000214,
>> +	HV_REGISTER_GUEST_CRASH_CTL				= 0x00000215,
>> +
>> +	/* Misc */
>> +	HV_REGISTER_VP_RUNTIME					= 0x00090000,
>> +	HV_REGISTER_GUEST_OS_ID					= 0x00090002,
>> +	HV_REGISTER_VP_INDEX					= 0x00090003,
>> +	HV_REGISTER_TIME_REF_COUNT				= 0x00090004,
>> +	HV_REGISTER_CPU_MANAGEMENT_VERSION			= 0x00090007,
>> +	HV_REGISTER_VP_ASSIST_PAGE				= 0x00090013,
>> +	HV_REGISTER_VP_ROOT_SIGNAL_COUNT			= 0x00090014,
>> +	HV_REGISTER_REFERENCE_TSC				= 0x00090017,
>> +
>> +	/* Hypervisor-defined Registers (Synic) */
>> +	HV_REGISTER_SINT0					= 0x000A0000,
>> +	HV_REGISTER_SINT1					= 0x000A0001,
>> +	HV_REGISTER_SINT2					= 0x000A0002,
>> +	HV_REGISTER_SINT3					= 0x000A0003,
>> +	HV_REGISTER_SINT4					= 0x000A0004,
>> +	HV_REGISTER_SINT5					= 0x000A0005,
>> +	HV_REGISTER_SINT6					= 0x000A0006,
>> +	HV_REGISTER_SINT7					= 0x000A0007,
>> +	HV_REGISTER_SINT8					= 0x000A0008,
>> +	HV_REGISTER_SINT9					= 0x000A0009,
>> +	HV_REGISTER_SINT10					= 0x000A000A,
>> +	HV_REGISTER_SINT11					= 0x000A000B,
>> +	HV_REGISTER_SINT12					= 0x000A000C,
>> +	HV_REGISTER_SINT13					= 0x000A000D,
>> +	HV_REGISTER_SINT14					= 0x000A000E,
>> +	HV_REGISTER_SINT15					= 0x000A000F,
>> +	HV_REGISTER_SCONTROL					= 0x000A0010,
>> +	HV_REGISTER_SVERSION					= 0x000A0011,
>> +	HV_REGISTER_SIEFP					= 0x000A0012,
>> +	HV_REGISTER_SIMP					= 0x000A0013,
>> +	HV_REGISTER_EOM						= 0x000A0014,
>> +	HV_REGISTER_SIRBP					= 0x000A0015,
>> +
>> +	HV_REGISTER_NESTED_SINT0				= 0x000A1000,
>> +	HV_REGISTER_NESTED_SINT1				= 0x000A1001,
>> +	HV_REGISTER_NESTED_SINT2				= 0x000A1002,
>> +	HV_REGISTER_NESTED_SINT3				= 0x000A1003,
>> +	HV_REGISTER_NESTED_SINT4				= 0x000A1004,
>> +	HV_REGISTER_NESTED_SINT5				= 0x000A1005,
>> +	HV_REGISTER_NESTED_SINT6				= 0x000A1006,
>> +	HV_REGISTER_NESTED_SINT7				= 0x000A1007,
>> +	HV_REGISTER_NESTED_SINT8				= 0x000A1008,
>> +	HV_REGISTER_NESTED_SINT9				= 0x000A1009,
>> +	HV_REGISTER_NESTED_SINT10				= 0x000A100A,
>> +	HV_REGISTER_NESTED_SINT11				= 0x000A100B,
>> +	HV_REGISTER_NESTED_SINT12				= 0x000A100C,
>> +	HV_REGISTER_NESTED_SINT13				= 0x000A100D,
>> +	HV_REGISTER_NESTED_SINT14				= 0x000A100E,
>> +	HV_REGISTER_NESTED_SINT15				= 0x000A100F,
>> +	HV_REGISTER_NESTED_SCONTROL				= 0x000A1010,
>> +	HV_REGISTER_NESTED_SVERSION				= 0x000A1011,
>> +	HV_REGISTER_NESTED_SIFP					= 0x000A1012,
>> +	HV_REGISTER_NESTED_SIPP					= 0x000A1013,
>> +	HV_REGISTER_NESTED_EOM					= 0x000A1014,
>> +	HV_REGISTER_NESTED_SIRBP				= 0x000a1015,
>> +
>> +	/* Hypervisor-defined Registers (Synthetic Timers) */
>> +	HV_REGISTER_STIMER0_CONFIG				= 0x000B0000,
>> +	HV_REGISTER_STIMER0_COUNT				= 0x000B0001,
>> +
>> +	/* VSM */
>> +	HV_X64_REGISTER_VSM_VP_STATUS				= 0x000D0003,
>> +};
>> +
>> +/*
>> + * Arch compatibility regs for use with hv_set/get_register
>> + */
>> +#if defined(CONFIG_X86)
>> +
>> +/*
>> + * To support arch-generic code calling hv_set/get_register:
>> + * - On x86, HV_MSR_ indicates an MSR accessed via rdmsrl/wrmsrl
>> + * - On ARM, HV_MSR_ indicates a VP register accessed via hypercall
>> + */
>> +#define HV_MSR_CRASH_P0		(HV_X64_MSR_CRASH_P0)
>> +#define HV_MSR_CRASH_P1		(HV_X64_MSR_CRASH_P1)
>> +#define HV_MSR_CRASH_P2		(HV_X64_MSR_CRASH_P2)
>> +#define HV_MSR_CRASH_P3		(HV_X64_MSR_CRASH_P3)
>> +#define HV_MSR_CRASH_P4		(HV_X64_MSR_CRASH_P4)
>> +#define HV_MSR_CRASH_CTL	(HV_X64_MSR_CRASH_CTL)
>> +
>> +#define HV_MSR_VP_INDEX		(HV_X64_MSR_VP_INDEX)
>> +#define HV_MSR_TIME_REF_COUNT	(HV_X64_MSR_TIME_REF_COUNT)
>> +#define HV_MSR_REFERENCE_TSC	(HV_X64_MSR_REFERENCE_TSC)
>> +
>> +#define HV_MSR_SINT0		(HV_X64_MSR_SINT0)
>> +#define HV_MSR_SVERSION		(HV_X64_MSR_SVERSION)
>> +#define HV_MSR_SCONTROL		(HV_X64_MSR_SCONTROL)
>> +#define HV_MSR_SIEFP		(HV_X64_MSR_SIEFP)
>> +#define HV_MSR_SIMP		(HV_X64_MSR_SIMP)
>> +#define HV_MSR_EOM		(HV_X64_MSR_EOM)
>> +#define HV_MSR_SIRBP		(HV_X64_MSR_SIRBP)
>> +
>> +#define HV_MSR_NESTED_SCONTROL	(HV_X64_MSR_NESTED_SCONTROL)
>> +#define HV_MSR_NESTED_SVERSION	(HV_X64_MSR_NESTED_SVERSION)
>> +#define HV_MSR_NESTED_SIEFP	(HV_X64_MSR_NESTED_SIEFP)
>> +#define HV_MSR_NESTED_SIMP	(HV_X64_MSR_NESTED_SIMP)
>> +#define HV_MSR_NESTED_EOM	(HV_X64_MSR_NESTED_EOM)
>> +#define HV_MSR_NESTED_SINT0	(HV_X64_MSR_NESTED_SINT0)
>> +
>> +#define HV_MSR_STIMER0_CONFIG	(HV_X64_MSR_STIMER0_CONFIG)
>> +#define HV_MSR_STIMER0_COUNT	(HV_X64_MSR_STIMER0_COUNT)
>> +
>> +#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
>> +
>> +#define HV_MSR_CRASH_P0		(HV_REGISTER_GUEST_CRASH_P0)
>> +#define HV_MSR_CRASH_P1		(HV_REGISTER_GUEST_CRASH_P1)
>> +#define HV_MSR_CRASH_P2		(HV_REGISTER_GUEST_CRASH_P2)
>> +#define HV_MSR_CRASH_P3		(HV_REGISTER_GUEST_CRASH_P3)
>> +#define HV_MSR_CRASH_P4		(HV_REGISTER_GUEST_CRASH_P4)
>> +#define HV_MSR_CRASH_CTL	(HV_REGISTER_GUEST_CRASH_CTL)
>> +
>> +#define HV_MSR_VP_INDEX		(HV_REGISTER_VP_INDEX)
>> +#define HV_MSR_TIME_REF_COUNT	(HV_REGISTER_TIME_REF_COUNT)
>> +#define HV_MSR_REFERENCE_TSC	(HV_REGISTER_REFERENCE_TSC)
>> +
>> +#define HV_MSR_SINT0		(HV_REGISTER_SINT0)
>> +#define HV_MSR_SCONTROL		(HV_REGISTER_SCONTROL)
>> +#define HV_MSR_SIEFP		(HV_REGISTER_SIEFP)
>> +#define HV_MSR_SIMP		(HV_REGISTER_SIMP)
>> +#define HV_MSR_EOM		(HV_REGISTER_EOM)
>> +#define HV_MSR_SIRBP		(HV_REGISTER_SIRBP)
>> +
>> +#define HV_MSR_STIMER0_CONFIG	(HV_REGISTER_STIMER0_CONFIG)
>> +#define HV_MSR_STIMER0_COUNT	(HV_REGISTER_STIMER0_COUNT)
>> +
>> +#endif /* CONFIG_ARM64 */
>> +
>> +union hv_explicit_suspend_register {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 suspended : 1;
>> +		u64 reserved : 63;
>> +	} __packed;
>> +};
>> +
>> +union hv_intercept_suspend_register {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 suspended : 1;
>> +		u64 reserved : 63;
>> +	} __packed;
>> +};
>> +
>> +union hv_dispatch_suspend_register {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 suspended : 1;
>> +		u64 reserved : 63;
>> +	} __packed;
>> +};
>> +
>> +union hv_x64_interrupt_state_register {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 interrupt_shadow : 1;
>> +		u64 nmi_masked : 1;
>> +		u64 reserved : 62;
>> +	} __packed;
>> +};
>> +
>> +union hv_x64_pending_interruption_register {
>> +	u64 as_uint64;
>> +	struct {
>> +		u32 interruption_pending : 1;
>> +		u32 interruption_type : 3;
>> +		u32 deliver_error_code : 1;
>> +		u32 instruction_length : 4;
>> +		u32 nested_event : 1;
>> +		u32 reserved : 6;
>> +		u32 interruption_vector : 16;
>> +		u32 error_code;
>> +	} __packed;
>> +};
>> +
>> +union hv_register_value {
>> +	struct hv_u128 reg128;
>> +	u64 reg64;
>> +	u32 reg32;
>> +	u16 reg16;
>> +	u8 reg8;
>> +
>> +	struct hv_x64_segment_register segment;
>> +	struct hv_x64_table_register table;
>> +	union hv_explicit_suspend_register explicit_suspend;
>> +	union hv_intercept_suspend_register intercept_suspend;
>> +	union hv_dispatch_suspend_register dispatch_suspend;
>> +	union hv_x64_interrupt_state_register interrupt_state;
>> +	union hv_x64_pending_interruption_register pending_interruption;
>> +};
>> +
>> +#if defined(CONFIG_ARM64)
>> +/* HvGetVpRegisters returns an array of these output elements */
>> +struct hv_get_vp_registers_output {
>> +	union {
>> +		struct {
>> +			u32 a;
>> +			u32 b;
>> +			u32 c;
>> +			u32 d;
>> +		} as32 __packed;
>> +		struct {
>> +			u64 low;
>> +			u64 high;
>> +		} as64 __packed;
>> +	};
>> +};
>> +
>> +#endif /* CONFIG_ARM64 */
>> +
>> +struct hv_register_assoc {
>> +	u32 name;			/* enum hv_register_name */
>> +	u32 reserved1;
>> +	u64 reserved2;
>> +	union hv_register_value value;
>> +} __packed;
>> +
>> +struct hv_input_get_vp_registers {
>> +	u64 partition_id;
>> +	u32 vp_index;
>> +	union hv_input_vtl input_vtl;
>> +	u8  rsvd_z8;
>> +	u16 rsvd_z16;
>> +	u32 names[];
>> +} __packed;
>> +
>> +struct hv_input_set_vp_registers {
>> +	u64 partition_id;
>> +	u32 vp_index;
>> +	union hv_input_vtl input_vtl;
>> +	u8  rsvd_z8;
>> +	u16 rsvd_z16;
>> +	struct hv_register_assoc elements[];
>> +} __packed;
>> +
>> +#define HV_UNMAP_GPA_LARGE_PAGE		0x2
>> +
>> +/* HvCallSendSyntheticClusterIpi hypercall */
>> +struct hv_send_ipi {	 /* HV_INPUT_SEND_SYNTHETIC_CLUSTER_IPI */
>> +	u32 vector;
>> +	u32 reserved;
>> +	u64 cpu_mask;
>> +} __packed;
>> +
>> +#define	HV_X64_VTL_MASK			GENMASK(3, 0)
>> +
>> +/* Hyper-V memory host visibility */
>> +enum hv_mem_host_visibility {
>> +	VMBUS_PAGE_NOT_VISIBLE		= 0,
>> +	VMBUS_PAGE_VISIBLE_READ_ONLY	= 1,
>> +	VMBUS_PAGE_VISIBLE_READ_WRITE	= 3
>> +};
>> +
>> +/* HvCallModifySparseGpaPageHostVisibility hypercall */
>> +#define HV_MAX_MODIFY_GPA_REP_COUNT	((HV_HYP_PAGE_SIZE / sizeof(u64)) -
>> 2)
>> +struct hv_gpa_range_for_visibility {
>> +	u64 partition_id;
>> +	u32 host_visibility : 2;
>> +	u32 reserved0 : 30;
>> +	u32 reserved1;
>> +	u64 gpa_page_list[HV_MAX_MODIFY_GPA_REP_COUNT];
>> +} __packed;
>> +
>> +#if defined(CONFIG_X86)
>> +union hv_msi_address_register { /* HV_MSI_ADDRESS */
>> +	u32 as_uint32;
>> +	struct {
>> +		u32 reserved1 : 2;
>> +		u32 destination_mode : 1;
>> +		u32 redirection_hint : 1;
>> +		u32 reserved2 : 8;
>> +		u32 destination_id : 8;
>> +		u32 msi_base : 12;
>> +	};
>> +} __packed;
>> +
>> +union hv_msi_data_register {	 /* HV_MSI_ENTRY.Data */
>> +	u32 as_uint32;
>> +	struct {
>> +		u32 vector : 8;
>> +		u32 delivery_mode : 3;
>> +		u32 reserved1 : 3;
>> +		u32 level_assert : 1;
>> +		u32 trigger_mode : 1;
>> +		u32 reserved2 : 16;
>> +	};
>> +} __packed;
>> +
>> +union hv_msi_entry {	 /* HV_MSI_ENTRY */
>> +
>> +	u64 as_uint64;
>> +	struct {
>> +		union hv_msi_address_register address;
>> +		union hv_msi_data_register data;
>> +	} __packed;
>> +};
>> +
>> +#elif defined(CONFIG_ARM64) /* CONFIG_X86 */
>> +
>> +union hv_msi_entry {
>> +	u64 as_uint64[2];
>> +	struct {
>> +		u64 address;
>> +		u32 data;
>> +		u32 reserved;
>> +	} __packed;
>> +};
>> +#endif /* CONFIG_ARM64 */
>> +
>> +union hv_ioapic_rte {
>> +	u64 as_uint64;
>> +
>> +	struct {
>> +		u32 vector : 8;
>> +		u32 delivery_mode : 3;
>> +		u32 destination_mode : 1;
>> +		u32 delivery_status : 1;
>> +		u32 interrupt_polarity : 1;
>> +		u32 remote_irr : 1;
>> +		u32 trigger_mode : 1;
>> +		u32 interrupt_mask : 1;
>> +		u32 reserved1 : 15;
>> +
>> +		u32 reserved2 : 24;
>> +		u32 destination_id : 8;
>> +	};
>> +
>> +	struct {
>> +		u32 low_uint32;
>> +		u32 high_uint32;
>> +	};
>> +} __packed;
>> +
>> +enum hv_interrupt_source {	 /* HV_INTERRUPT_SOURCE */
>> +	HV_INTERRUPT_SOURCE_MSI = 1, /* MSI and MSI-X */
>> +	HV_INTERRUPT_SOURCE_IOAPIC,
>> +};
>> +
>> +struct hv_interrupt_entry {	 /* HV_INTERRUPT_ENTRY */
>> +	u32 source;
>> +	u32 reserved1;
>> +	union {
>> +		union hv_msi_entry msi_entry;
>> +		union hv_ioapic_rte ioapic_rte;
>> +	};
>> +} __packed;
>> +
>> +#define HV_DEVICE_INTERRUPT_TARGET_MULTICAST		1
>> +#define HV_DEVICE_INTERRUPT_TARGET_PROCESSOR_SET	2
>> +
>> +struct hv_device_interrupt_target {	 /* HV_DEVICE_INTERRUPT_TARGET */
>> +	u32 vector;
>> +	u32 flags;		/* HV_DEVICE_INTERRUPT_TARGET_* above */
>> +	union {
>> +		u64 vp_mask;
>> +		struct hv_vpset vp_set;
>> +	};
>> +} __packed;
>> +
>> +struct hv_retarget_device_interrupt {	 /* HV_INPUT_RETARGET_DEVICE_INTERRUPT
>> */
>> +	u64 partition_id;		/* use "self" */
>> +	u64 device_id;
>> +	struct hv_interrupt_entry int_entry;
>> +	u64 reserved2;
>> +	struct hv_device_interrupt_target int_target;
>> +} __packed __aligned(8);
>> +
>> +/* Data structures for HVCALL_MMIO_READ and HVCALL_MMIO_WRITE */
>> +#define HV_HYPERCALL_MMIO_MAX_DATA_LENGTH 64
>> +
>> +struct hv_mmio_read_input { /* HV_INPUT_MEMORY_MAPPED_IO_READ */
>> +	u64 gpa;
>> +	u32 size;
>> +	u32 reserved;
>> +} __packed;
>> +
>> +struct hv_mmio_read_output {
>> +	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
>> +} __packed;
>> +
>> +struct hv_mmio_write_input {
>> +	u64 gpa;
>> +	u32 size;
>> +	u32 reserved;
>> +	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
>> +} __packed;
>> +
>> +#endif /* _HV_HVGDK_MINI_H */
>> diff --git a/include/hyperv/hvhdk.h b/include/hyperv/hvhdk.h
>> new file mode 100644
>> index 000000000000..64407c2a3809
>> --- /dev/null
>> +++ b/include/hyperv/hvhdk.h
>> @@ -0,0 +1,733 @@
>> +/* SPDX-License-Identifier: GPL-2.0 */
>> +/*
>> + * Type definitions for the Microsoft hypervisor.
>> + */
>> +#ifndef _HV_HVHDK_H
>> +#define _HV_HVHDK_H
>> +
>> +#include <linux/build_bug.h>
>> +
>> +#include "hvhdk_mini.h"
>> +#include "hvgdk.h"
>> +
>> +/* Bits for dirty mask of hv_vp_register_page */
>> +#define HV_X64_REGISTER_CLASS_GENERAL	0
>> +#define HV_X64_REGISTER_CLASS_IP	1
>> +#define HV_X64_REGISTER_CLASS_XMM	2
>> +#define HV_X64_REGISTER_CLASS_SEGMENT	3
>> +#define HV_X64_REGISTER_CLASS_FLAGS	4
>> +
>> +#define HV_VP_REGISTER_PAGE_VERSION_1	1u
>> +
>> +struct hv_vp_register_page {
>> +	u16 version;
>> +	u8 isvalid;
>> +	u8 rsvdz;
>> +	u32 dirty;
>> +	union {
>> +		struct {
>> +			/* General purpose registers
>> +			 * (HV_X64_REGISTER_CLASS_GENERAL)
>> +			 */
>> +			union {
>> +				struct {
>> +					u64 rax;
>> +					u64 rcx;
>> +					u64 rdx;
>> +					u64 rbx;
>> +					u64 rsp;
>> +					u64 rbp;
>> +					u64 rsi;
>> +					u64 rdi;
>> +					u64 r8;
>> +					u64 r9;
>> +					u64 r10;
>> +					u64 r11;
>> +					u64 r12;
>> +					u64 r13;
>> +					u64 r14;
>> +					u64 r15;
>> +				} __packed;
>> +
>> +				u64 gp_registers[16];
>> +			};
>> +			/* Instruction pointer (HV_X64_REGISTER_CLASS_IP) */
>> +			u64 rip;
>> +			/* Flags (HV_X64_REGISTER_CLASS_FLAGS) */
>> +			u64 rflags;
>> +		} __packed;
>> +
>> +		u64 registers[18];
>> +	};
>> +	/* Volatile XMM registers (HV_X64_REGISTER_CLASS_XMM) */
>> +	union {
>> +		struct {
>> +			struct hv_u128 xmm0;
>> +			struct hv_u128 xmm1;
>> +			struct hv_u128 xmm2;
>> +			struct hv_u128 xmm3;
>> +			struct hv_u128 xmm4;
>> +			struct hv_u128 xmm5;
>> +		} __packed;
>> +
>> +		struct hv_u128 xmm_registers[6];
>> +	};
>> +	/* Segment registers (HV_X64_REGISTER_CLASS_SEGMENT) */
>> +	union {
>> +		struct {
>> +			struct hv_x64_segment_register es;
>> +			struct hv_x64_segment_register cs;
>> +			struct hv_x64_segment_register ss;
>> +			struct hv_x64_segment_register ds;
>> +			struct hv_x64_segment_register fs;
>> +			struct hv_x64_segment_register gs;
>> +		} __packed;
>> +
>> +		struct hv_x64_segment_register segment_registers[6];
>> +	};
>> +	/* Misc. control registers (cannot be set via this interface) */
>> +	u64 cr0;
>> +	u64 cr3;
>> +	u64 cr4;
>> +	u64 cr8;
>> +	u64 efer;
>> +	u64 dr7;
>> +	union hv_x64_pending_interruption_register pending_interruption;
>> +	union hv_x64_interrupt_state_register interrupt_state;
>> +	u64 instruction_emulation_hints;
>> +} __packed;
>> +
>> +#define HV_PARTITION_PROCESSOR_FEATURES_BANKS 2
>> +
>> +union hv_partition_processor_features {
>> +	u64 as_uint64[HV_PARTITION_PROCESSOR_FEATURES_BANKS];
>> +	struct {
>> +		u64 sse3_support : 1;
>> +		u64 lahf_sahf_support : 1;
>> +		u64 ssse3_support : 1;
>> +		u64 sse4_1_support : 1;
>> +		u64 sse4_2_support : 1;
>> +		u64 sse4a_support : 1;
>> +		u64 xop_support : 1;
>> +		u64 pop_cnt_support : 1;
>> +		u64 cmpxchg16b_support : 1;
>> +		u64 altmovcr8_support : 1;
>> +		u64 lzcnt_support : 1;
>> +		u64 mis_align_sse_support : 1;
>> +		u64 mmx_ext_support : 1;
>> +		u64 amd3dnow_support : 1;
>> +		u64 extended_amd3dnow_support : 1;
>> +		u64 page_1gb_support : 1;
>> +		u64 aes_support : 1;
>> +		u64 pclmulqdq_support : 1;
>> +		u64 pcid_support : 1;
>> +		u64 fma4_support : 1;
>> +		u64 f16c_support : 1;
>> +		u64 rd_rand_support : 1;
>> +		u64 rd_wr_fs_gs_support : 1;
>> +		u64 smep_support : 1;
>> +		u64 enhanced_fast_string_support : 1;
>> +		u64 bmi1_support : 1;
>> +		u64 bmi2_support : 1;
>> +		u64 hle_support_deprecated : 1;
>> +		u64 rtm_support_deprecated : 1;
>> +		u64 movbe_support : 1;
>> +		u64 npiep1_support : 1;
>> +		u64 dep_x87_fpu_save_support : 1;
>> +		u64 rd_seed_support : 1;
>> +		u64 adx_support : 1;
>> +		u64 intel_prefetch_support : 1;
>> +		u64 smap_support : 1;
>> +		u64 hle_support : 1;
>> +		u64 rtm_support : 1;
>> +		u64 rdtscp_support : 1;
>> +		u64 clflushopt_support : 1;
>> +		u64 clwb_support : 1;
>> +		u64 sha_support : 1;
>> +		u64 x87_pointers_saved_support : 1;
>> +		u64 invpcid_support : 1;
>> +		u64 ibrs_support : 1;
>> +		u64 stibp_support : 1;
>> +		u64 ibpb_support: 1;
>> +		u64 unrestricted_guest_support : 1;
>> +		u64 mdd_support : 1;
>> +		u64 fast_short_rep_mov_support : 1;
>> +		u64 l1dcache_flush_support : 1;
>> +		u64 rdcl_no_support : 1;
>> +		u64 ibrs_all_support : 1;
>> +		u64 skip_l1df_support : 1;
>> +		u64 ssb_no_support : 1;
>> +		u64 rsb_a_no_support : 1;
>> +		u64 virt_spec_ctrl_support : 1;
>> +		u64 rd_pid_support : 1;
>> +		u64 umip_support : 1;
>> +		u64 mbs_no_support : 1;
>> +		u64 mb_clear_support : 1;
>> +		u64 taa_no_support : 1;
>> +		u64 tsx_ctrl_support : 1;
>> +		/*
>> +		 * N.B. The final processor feature bit in bank 0 is reserved to
>> +		 * simplify potential downlevel backports.
>> +		 */
>> +		u64 reserved_bank0 : 1;
>> +
>> +		/* N.B. Begin bank 1 processor features. */
>> +		u64 acount_mcount_support : 1;
>> +		u64 tsc_invariant_support : 1;
>> +		u64 cl_zero_support : 1;
>> +		u64 rdpru_support : 1;
>> +		u64 la57_support : 1;
>> +		u64 mbec_support : 1;
>> +		u64 nested_virt_support : 1;
>> +		u64 psfd_support : 1;
>> +		u64 cet_ss_support : 1;
>> +		u64 cet_ibt_support : 1;
>> +		u64 vmx_exception_inject_support : 1;
>> +		u64 enqcmd_support : 1;
>> +		u64 umwait_tpause_support : 1;
>> +		u64 movdiri_support : 1;
>> +		u64 movdir64b_support : 1;
>> +		u64 cldemote_support : 1;
>> +		u64 serialize_support : 1;
>> +		u64 tsc_deadline_tmr_support : 1;
>> +		u64 tsc_adjust_support : 1;
>> +		u64 fzlrep_movsb : 1;
>> +		u64 fsrep_stosb : 1;
>> +		u64 fsrep_cmpsb : 1;
>> +		u64 reserved_bank1 : 42;
>> +	} __packed;
>> +};
>> +
>> +union hv_partition_processor_xsave_features {
>> +	struct {
>> +		u64 xsave_support : 1;
>> +		u64 xsaveopt_support : 1;
>> +		u64 avx_support : 1;
>> +		u64 reserved1 : 61;
>> +	} __packed;
>> +	u64 as_uint64;
>> +};
>> +
>> +struct hv_partition_creation_properties {
>> +	union hv_partition_processor_features disabled_processor_features;
>> +	union hv_partition_processor_xsave_features
>> +		disabled_processor_xsave_features;
>> +} __packed;
>> +
>> +#define HV_PARTITION_SYNTHETIC_PROCESSOR_FEATURES_BANKS 1
>> +
>> +union hv_partition_synthetic_processor_features {
>> +	u64 as_uint64[HV_PARTITION_SYNTHETIC_PROCESSOR_FEATURES_BANKS];
>> +
>> +	struct {
>> +		u64 hypervisor_present : 1;
>> +		/* Support for HV#1: (CPUID leaves 0x40000000 - 0x40000006)*/
>> +		u64 hv1 : 1;
>> +		u64 access_vp_run_time_reg : 1; /* HV_X64_MSR_VP_RUNTIME */
>> +		u64 access_partition_reference_counter : 1; /*
>> HV_X64_MSR_TIME_REF_COUNT */
>> +		u64 access_synic_regs : 1; /* SINT-related registers */
>> +		/*
>> +		 * Access to HV_X64_MSR_STIMER0_CONFIG through
>> +		 * HV_X64_MSR_STIMER3_COUNT.
>> +		 */
>> +		u64 access_synthetic_timer_regs : 1;
>> +		u64 access_intr_ctrl_regs : 1; /* APIC MSRs and VP assist page*/
>> +		/* HV_X64_MSR_GUEST_OS_ID and HV_X64_MSR_HYPERCALL */
>> +		u64 access_hypercall_regs : 1;
>> +		u64 access_vp_index : 1;
>> +		u64 access_partition_reference_tsc : 1;
>> +		u64 access_guest_idle_reg : 1;
>> +		u64 access_frequency_regs : 1;
>> +		u64 reserved_z12 : 1;
>> +		u64 reserved_z13 : 1;
>> +		u64 reserved_z14 : 1;
>> +		u64 enable_extended_gva_ranges_for_flush_virtual_address_list : 1;
>> +		u64 reserved_z16 : 1;
>> +		u64 reserved_z17 : 1;
>> +		/* Use fast hypercall output. Corresponds to privilege. */
>> +		u64 fast_hypercall_output : 1;
>> +		u64 reserved_z19 : 1;
>> +		u64 start_virtual_processor : 1; /* Can start VPs */
>> +		u64 reserved_z21 : 1;
>> +		/* Synthetic timers in direct mode. */
>> +		u64 direct_synthetic_timers : 1;
>> +		u64 reserved_z23 : 1;
>> +		u64 extended_processor_masks : 1;
>> +
>> +		/* Enable various hypercalls */
>> +		u64 tb_flush_hypercalls : 1;
>> +		u64 synthetic_cluster_ipi : 1;
>> +		u64 notify_long_spin_wait : 1;
>> +		u64 query_numa_distance : 1;
>> +		u64 signal_events : 1;
>> +		u64 retarget_device_interrupt : 1;
>> +		u64 restore_time : 1;
>> +
>> +		/* EnlightenedVmcs nested enlightenment is supported. */
>> +		u64 enlightened_vmcs : 1;
>> +		u64 reserved : 31;
>> +	} __packed;
>> +};
>> +
>> +#define HV_MAKE_COMPATIBILITY_VERSION(major_, minor_)	\
>> +	((u32)((major_) << 8 | (minor_)))
>> +
>> +#define HV_COMPATIBILITY_21_H2
>> 	HV_MAKE_COMPATIBILITY_VERSION(0X6, 0X9)
>> +
>> +union hv_partition_isolation_properties {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 isolation_type: 5;
>> +		u64 isolation_host_type : 2;
>> +		u64 rsvd_z: 5;
>> +		u64 shared_gpa_boundary_page_number: 52;
>> +	} __packed;
>> +};
>> +
>> +/*
>> + * Various isolation types supported by MSHV.
>> + */
>> +#define HV_PARTITION_ISOLATION_TYPE_NONE            0
>> +#define HV_PARTITION_ISOLATION_TYPE_SNP             2
>> +#define HV_PARTITION_ISOLATION_TYPE_TDX             3
>> +
>> +/*
>> + * Various host isolation types supported by MSHV.
>> + */
>> +#define HV_PARTITION_ISOLATION_HOST_TYPE_NONE       0x0
>> +#define HV_PARTITION_ISOLATION_HOST_TYPE_HARDWARE   0x1
>> +#define HV_PARTITION_ISOLATION_HOST_TYPE_RESERVED   0x2
>> +
>> +/* Note: Exo partition is enabled by default */
>> +#define HV_PARTITION_CREATION_FLAG_EXO_PARTITION                    BIT(8)
>> +#define HV_PARTITION_CREATION_FLAG_LAPIC_ENABLED                    BIT(13)
>> +#define HV_PARTITION_CREATION_FLAG_INTERCEPT_MESSAGE_PAGE_ENABLED
>> BIT(19)
>> +#define HV_PARTITION_CREATION_FLAG_X2APIC_CAPABLE                   BIT(22)
>> +
>> +struct hv_input_create_partition {
>> +	u64 flags;
>> +	struct hv_proximity_domain_info proximity_domain_info;
>> +	u32 compatibility_version;
>> +	u32 padding;
>> +	struct hv_partition_creation_properties partition_creation_properties;
>> +	union hv_partition_isolation_properties isolation_properties;
>> +} __packed;
>> +
>> +struct hv_output_create_partition {
>> +	u64 partition_id;
>> +} __packed;
>> +
>> +struct hv_input_initialize_partition {
>> +	u64 partition_id;
>> +} __packed;
>> +
>> +struct hv_input_finalize_partition {
>> +	u64 partition_id;
>> +} __packed;
>> +
>> +struct hv_input_delete_partition {
>> +	u64 partition_id;
>> +} __packed;
>> +
>> +struct hv_input_get_partition_property {
>> +	u64 partition_id;
>> +	u32 property_code; /* enum hv_partition_property_code */
>> +	u32 padding;
>> +} __packed;
>> +
>> +struct hv_output_get_partition_property {
>> +	u64 property_value;
>> +} __packed;
>> +
>> +struct hv_input_set_partition_property {
>> +	u64 partition_id;
>> +	u32 property_code; /* enum hv_partition_property_code */
>> +	u32 padding;
>> +	u64 property_value;
>> +} __packed;
>> +
>> +enum hv_vp_state_page_type {
>> +	HV_VP_STATE_PAGE_REGISTERS = 0,
>> +	HV_VP_STATE_PAGE_INTERCEPT_MESSAGE = 1,
>> +	HV_VP_STATE_PAGE_COUNT
>> +};
>> +
>> +struct hv_input_map_vp_state_page {
>> +	u64 partition_id;
>> +	u32 vp_index;
>> +	u32 type; /* enum hv_vp_state_page_type */
>> +} __packed;
>> +
>> +struct hv_output_map_vp_state_page {
>> +	u64 map_location; /* GPA page number */
>> +} __packed;
>> +
>> +struct hv_input_unmap_vp_state_page {
>> +	u64 partition_id;
>> +	u32 vp_index;
>> +	u32 type; /* enum hv_vp_state_page_type */
>> +} __packed;
>> +
>> +struct hv_opaque_intercept_message {
>> +	u32 vp_index;
>> +} __packed;
>> +
>> +enum hv_port_type {
>> +	HV_PORT_TYPE_MESSAGE = 1,
>> +	HV_PORT_TYPE_EVENT   = 2,
>> +	HV_PORT_TYPE_MONITOR = 3,
>> +	HV_PORT_TYPE_DOORBELL = 4	/* Root Partition only */
>> +};
>> +
>> +struct hv_port_info {
>> +	u32 port_type; /* enum hv_port_type */
>> +	u32 padding;
>> +	union {
>> +		struct {
>> +			u32 target_sint;
>> +			u32 target_vp;
>> +			u64 rsvdz;
>> +		} message_port_info;
>> +		struct {
>> +			u32 target_sint;
>> +			u32 target_vp;
>> +			u16 base_flag_number;
>> +			u16 flag_count;
>> +			u32 rsvdz;
>> +		} event_port_info;
>> +		struct {
>> +			u64 monitor_address;
>> +			u64 rsvdz;
>> +		} monitor_port_info;
>> +		struct {
>> +			u32 target_sint;
>> +			u32 target_vp;
>> +			u64 rsvdz;
>> +		} doorbell_port_info;
>> +	};
>> +} __packed;
>> +
>> +struct hv_connection_info {
>> +	u32 port_type;
>> +	u32 padding;
>> +	union {
>> +		struct {
>> +			u64 rsvdz;
>> +		} message_connection_info;
>> +		struct {
>> +			u64 rsvdz;
>> +		} event_connection_info;
>> +		struct {
>> +			u64 monitor_address;
>> +		} monitor_connection_info;
>> +		struct {
>> +			u64 gpa;
>> +			u64 trigger_value;
>> +			u64 flags;
>> +		} doorbell_connection_info;
>> +	};
>> +} __packed;
>> +
>> +/* Define synthetic interrupt controller flag constants. */
>> +#define HV_EVENT_FLAGS_COUNT		(256 * 8)
>> +#define HV_EVENT_FLAGS_BYTE_COUNT	(256)
>> +#define HV_EVENT_FLAGS32_COUNT		(256 / sizeof(u32))
>> +
>> +/* linux side we create long version of flags to use long bit ops on flags */
>> +#define HV_EVENT_FLAGS_UL_COUNT		(256 / sizeof(ulong))
>> +
>> +/* Define the synthetic interrupt controller event flags format. */
>> +union hv_synic_event_flags {
>> +	unsigned char flags8[HV_EVENT_FLAGS_BYTE_COUNT];
>> +	u32 flags32[HV_EVENT_FLAGS32_COUNT];
>> +	ulong flags[HV_EVENT_FLAGS_UL_COUNT];  /* linux only */
>> +};
>> +
>> +struct hv_synic_event_flags_page {
>> +	volatile union hv_synic_event_flags event_flags[HV_SYNIC_SINT_COUNT];
>> +};
>> +
>> +#define HV_SYNIC_EVENT_RING_MESSAGE_COUNT 63
>> +
>> +struct hv_synic_event_ring {
>> +	u8  signal_masked;
>> +	u8  ring_full;
>> +	u16 reserved_z;
>> +	u32 data[HV_SYNIC_EVENT_RING_MESSAGE_COUNT];
>> +} __packed;
>> +
>> +struct hv_synic_event_ring_page {
>> +	struct hv_synic_event_ring sint_event_ring[HV_SYNIC_SINT_COUNT];
>> +};
>> +
>> +/* Define SynIC control register. */
>> +union hv_synic_scontrol {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 enable : 1;
>> +		u64 reserved : 63;
>> +	} __packed;
>> +};
>> +
>> +/* Define the format of the SIEFP register */
>> +union hv_synic_siefp {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 siefp_enabled : 1;
>> +		u64 preserved : 11;
>> +		u64 base_siefp_gpa : 52;
>> +	} __packed;
>> +};
>> +
>> +union hv_synic_sirbp {
>> +	u64 as_uint64;
>> +	struct {
>> +		u64 sirbp_enabled : 1;
>> +		u64 preserved : 11;
>> +		u64 base_sirbp_gpa : 52;
>> +	} __packed;
>> +};
>> +
>> +union hv_interrupt_control {
>> +	u64 as_uint64;
>> +	struct {
>> +		u32 interrupt_type; /* enum hv_interrupt_type */
>> +		u32 level_triggered : 1;
>> +		u32 logical_dest_mode : 1;
>> +		u32 rsvd : 30;
>> +	} __packed;
>> +};
>> +
>> +struct hv_stimer_state {
>> +	struct {
>> +		u32 undelivered_msg_pending : 1;
>> +		u32 reserved : 31;
>> +	} __packed flags;
>> +	u32 resvd;
>> +	u64 config;
>> +	u64 count;
>> +	u64 adjustment;
>> +	u64 undelivered_exp_time;
>> +} __packed;
>> +
>> +struct hv_synthetic_timers_state {
>> +	struct hv_stimer_state timers[HV_SYNIC_STIMER_COUNT];
>> +	u64 reserved[5];
>> +} __packed;
>> +
>> +union hv_input_delete_vp {
>> +	u64 as_uint64[2];
>> +	struct {
>> +		u64 partition_id;
>> +		u32 vp_index;
>> +		u8 reserved[4];
>> +	} __packed;
>> +} __packed;
>> +
>> +struct hv_input_assert_virtual_interrupt {
>> +	u64 partition_id;
>> +	union hv_interrupt_control control;
>> +	u64 dest_addr; /* cpu's apic id */
>> +	u32 vector;
>> +	u8 target_vtl;
>> +	u8 rsvd_z0;
>> +	u16 rsvd_z1;
>> +} __packed;
>> +
>> +struct hv_input_create_port {
>> +	u64 port_partition_id;
>> +	union hv_port_id port_id;
>> +	u8 port_vtl;
>> +	u8 min_connection_vtl;
>> +	u16 padding;
>> +	u64 connection_partition_id;
>> +	struct hv_port_info port_info;
>> +	struct hv_proximity_domain_info proximity_domain_info;
>> +} __packed;
>> +
>> +union hv_input_delete_port {
>> +	u64 as_uint64[2];
>> +	struct {
>> +		u64 port_partition_id;
>> +		union hv_port_id port_id;
>> +		u32 reserved;
>> +	};
>> +} __packed;
>> +
>> +struct hv_input_connect_port {
>> +	u64 connection_partition_id;
>> +	union hv_connection_id connection_id;
>> +	u8 connection_vtl;
>> +	u8 rsvdz0;
>> +	u16 rsvdz1;
>> +	u64 port_partition_id;
>> +	union hv_port_id port_id;
>> +	u32 reserved2;
>> +	struct hv_connection_info connection_info;
>> +	struct hv_proximity_domain_info proximity_domain_info;
>> +} __packed;
>> +
>> +union hv_input_disconnect_port {
>> +	u64 as_uint64[2];
>> +	struct {
>> +		u64 connection_partition_id;
>> +		union hv_connection_id connection_id;
>> +		u32 is_doorbell: 1;
>> +		u32 reserved: 31;
>> +	} __packed;
>> +} __packed;
>> +
>> +union hv_input_notify_port_ring_empty {
>> +	u64 as_uint64;
>> +	struct {
>> +		u32 sint_index;
>> +		u32 reserved;
>> +	};
>> +} __packed;
>> +
>> +struct hv_vp_state_data_xsave {
>> +	u64 flags;
>> +	union hv_x64_xsave_xfem_register states;
>> +} __packed;
>> +
>> +/*
>> + * For getting and setting VP state, there are two options based on the state type:
>> + *
>> + *     1.) Data that is accessed by PFNs in the input hypercall page. This is used
>> + *         for state which may not fit into the hypercall pages.
>> + *     2.) Data that is accessed directly in the input\output hypercall pages.
>> + *         This is used for state that will always fit into the hypercall pages.
>> + *
>> + * In the future this could be dynamic based on the size if needed.
>> + *
>> + * Note these hypercalls have an 8-byte aligned variable header size as per the tlfs
>> + */
>> +
>> +#define HV_GET_SET_VP_STATE_TYPE_PFN	BIT(31)
>> +
>> +enum hv_get_set_vp_state_type {
>> +	/* HvGetSetVpStateLocalInterruptControllerState - APIC/GIC state */
>> +	HV_GET_SET_VP_STATE_LAPIC_STATE	     = 0 |
>> HV_GET_SET_VP_STATE_TYPE_PFN,
>> +	HV_GET_SET_VP_STATE_XSAVE	     = 1 | HV_GET_SET_VP_STATE_TYPE_PFN,
>> +	HV_GET_SET_VP_STATE_SIM_PAGE	     = 2 |
>> HV_GET_SET_VP_STATE_TYPE_PFN,
>> +	HV_GET_SET_VP_STATE_SIEF_PAGE	     = 3 |
>> HV_GET_SET_VP_STATE_TYPE_PFN,
>> +	HV_GET_SET_VP_STATE_SYNTHETIC_TIMERS = 4,
>> +};
>> +
>> +struct hv_vp_state_data {
>> +	u32 type;
>> +	u32 rsvd;
>> +	struct hv_vp_state_data_xsave xsave;
>> +} __packed;
>> +
>> +struct hv_input_get_vp_state {
>> +	u64 partition_id;
>> +	u32 vp_index;
>> +	u8 input_vtl;
>> +	u8 rsvd0;
>> +	u16 rsvd1;
>> +	struct hv_vp_state_data state_data;
>> +	u64 output_data_pfns[];
>> +} __packed;
>> +
>> +union hv_output_get_vp_state {
>> +	struct hv_synthetic_timers_state synthetic_timers_state;
>> +} __packed;
>> +
>> +union hv_input_set_vp_state_data {
>> +	u64 pfns;
>> +	u8 bytes;
>> +} __packed;
>> +
>> +struct hv_input_set_vp_state {
>> +	u64 partition_id;
>> +	u32 vp_index;
>> +	u8 input_vtl;
>> +	u8 rsvd0;
>> +	u16 rsvd1;
>> +	struct hv_vp_state_data state_data;
>> +	union hv_input_set_vp_state_data data[];
>> +} __packed;
>> +
>> +/*
>> + * Dispatch state for the VP communicated by the hypervisor to the
>> + * VP-dispatching thread in the root on return from HVCALL_DISPATCH_VP.
>> + */
>> +enum hv_vp_dispatch_state {
>> +	HV_VP_DISPATCH_STATE_INVALID	= 0,
>> +	HV_VP_DISPATCH_STATE_BLOCKED	= 1,
>> +	HV_VP_DISPATCH_STATE_READY	= 2,
>> +};
>> +
>> +/*
>> + * Dispatch event that caused the current dispatch state on return from
>> + * HVCALL_DISPATCH_VP.
>> + */
>> +enum hv_vp_dispatch_event {
>> +	HV_VP_DISPATCH_EVENT_INVALID	= 0x00000000,
>> +	HV_VP_DISPATCH_EVENT_SUSPEND	= 0x00000001,
>> +	HV_VP_DISPATCH_EVENT_INTERCEPT	= 0x00000002,
>> +};
>> +
>> +#define HV_ROOT_SCHEDULER_MAX_VPS_PER_CHILD_PARTITION   1024
>> +/* The maximum array size of HV_GENERIC_SET (vp_set) buffer */
>> +#define HV_GENERIC_SET_QWORD_COUNT(max) (((((max) - 1) >> 6) + 1) + 2)
>> +
>> +struct hv_vp_signal_bitset_scheduler_message {
>> +	u64 partition_id;
>> +	u32 overflow_count;
>> +	u16 vp_count;
>> +	u16 reserved;
>> +
>> +#define BITSET_BUFFER_SIZE \
>> +
>> 	HV_GENERIC_SET_QWORD_COUNT(HV_ROOT_SCHEDULER_MAX_VPS_PER_C
>> HILD_PARTITION)
>> +	union {
>> +		struct hv_vpset bitset;
>> +		u64 bitset_buffer[BITSET_BUFFER_SIZE];
>> +	} vp_bitset;
>> +#undef BITSET_BUFFER_SIZE
>> +} __packed;
>> +
>> +static_assert(sizeof(struct hv_vp_signal_bitset_scheduler_message) <=
>> +	(sizeof(struct hv_message) - sizeof(struct hv_message_header)));
>> +
>> +#define HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT \
>> +	(((sizeof(struct hv_message) - sizeof(struct hv_message_header)) / \
>> +	 (sizeof(u64 /* partition id */) + sizeof(u32 /* vp index */))) - 1)
>> +
>> +struct hv_vp_signal_pair_scheduler_message {
>> +	u32 overflow_count;
>> +	u8 vp_count;
>> +	u8 reserved1[3];
>> +
>> +	u64 partition_ids[HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT];
>> +	u32 vp_indexes[HV_MESSAGE_MAX_PARTITION_VP_PAIR_COUNT];
>> +
>> +	u8 reserved2[4];
>> +} __packed;
>> +
>> +static_assert(sizeof(struct hv_vp_signal_pair_scheduler_message) ==
>> +	(sizeof(struct hv_message) - sizeof(struct hv_message_header)));
>> +
>> +/* Input and output structures for HVCALL_DISPATCH_VP */
>> +#define HV_DISPATCH_VP_FLAG_CLEAR_INTERCEPT_SUSPEND	0x1
>> +#define HV_DISPATCH_VP_FLAG_ENABLE_CALLER_INTERRUPTS	0x2
>> +#define HV_DISPATCH_VP_FLAG_SET_CALLER_SPEC_CTRL	0x4
>> +#define HV_DISPATCH_VP_FLAG_SKIP_VP_SPEC_FLUSH		0x8
>> +#define HV_DISPATCH_VP_FLAG_SKIP_CALLER_SPEC_FLUSH	0x10
>> +#define HV_DISPATCH_VP_FLAG_SKIP_CALLER_USER_SPEC_FLUSH	0x20
>> +
>> +struct hv_input_dispatch_vp {
>> +	u64 partition_id;
>> +	u32 vp_index;
>> +	u32 flags;
>> +	u64 time_slice; /* in 100ns */
>> +	u64 spec_ctrl;
>> +} __packed;
>> +
>> +struct hv_output_dispatch_vp {
>> +	u32 dispatch_state; /* enum hv_vp_dispatch_state */
>> +	u32 dispatch_event; /* enum hv_vp_dispatch_event */
>> +} __packed;
>> +
>> +#endif /* _HV_HVHDK_H */
>> diff --git a/include/hyperv/hvhdk_mini.h b/include/hyperv/hvhdk_mini.h
>> new file mode 100644
>> index 000000000000..d003223fac79
>> --- /dev/null
>> +++ b/include/hyperv/hvhdk_mini.h
>> @@ -0,0 +1,310 @@
>> +/* SPDX-License-Identifier: GPL-2.0 */
>> +/*
>> + * Type definitions for the Microsoft Hypervisor.
>> + */
>> +#ifndef _HV_HVHDK_MINI_H
>> +#define _HV_HVHDK_MINI_H
>> +
>> +#include "hvgdk_mini.h"
>> +
>> +/*
>> + * Doorbell connection_info flags.
>> + */
>> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_MASK  0x00000007
>> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_ANY   0x00000000
>> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_BYTE  0x00000001
>> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_WORD  0x00000002
>> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_DWORD 0x00000003
>> +#define HV_DOORBELL_FLAG_TRIGGER_SIZE_QWORD 0x00000004
>> +#define HV_DOORBELL_FLAG_TRIGGER_ANY_VALUE  0x80000000
>> +
>> +/* Each generic set contains 64 elements */
>> +#define HV_GENERIC_SET_SHIFT		(6)
>> +#define HV_GENERIC_SET_MASK		(63)
>> +
>> +enum hv_generic_set_format {
>> +	HV_GENERIC_SET_SPARSE_4K,
>> +	HV_GENERIC_SET_ALL,
>> +};
>> +
>> +enum hv_scheduler_type {
>> +	HV_SCHEDULER_TYPE_LP		= 1, /* Classic scheduler w/o SMT */
>> +	HV_SCHEDULER_TYPE_LP_SMT	= 2, /* Classic scheduler w/ SMT */
>> +	HV_SCHEDULER_TYPE_CORE_SMT	= 3, /* Core scheduler */
>> +	HV_SCHEDULER_TYPE_ROOT		= 4, /* Root / integrated scheduler */
>> +	HV_SCHEDULER_TYPE_MAX
>> +};
>> +
>> +enum hv_partition_property_code {
>> +	/* Privilege properties */
>> +	HV_PARTITION_PROPERTY_PRIVILEGE_FLAGS			= 0x00010000,
>> +	HV_PARTITION_PROPERTY_SYNTHETIC_PROC_FEATURES		=
>> 0x00010001,
>> +
>> +	/* Resource properties */
>> +	HV_PARTITION_PROPERTY_GPA_PAGE_ACCESS_TRACKING		=
>> 0x00050005,
>> +	HV_PARTITION_PROPERTY_UNIMPLEMENTED_MSR_ACTION		=
>> 0x00050017,
>> +
>> +	/* Compatibility properties */
>> +	HV_PARTITION_PROPERTY_PROCESSOR_XSAVE_FEATURES		=
>> 0x00060002,
>> +	HV_PARTITION_PROPERTY_MAX_XSAVE_DATA_SIZE		= 0x00060008,
>> +	HV_PARTITION_PROPERTY_PROCESSOR_CLOCK_FREQUENCY		=
>> 0x00060009,
>> +};
>> +
>> +enum hv_system_property {
>> +	/* Add more values when needed */
>> +	HV_SYSTEM_PROPERTY_SCHEDULER_TYPE = 15,
>> +};
>> +
>> +struct hv_input_get_system_property {
>> +	u32 property_id; /* enum hv_system_property */
>> +	union {
>> +		u32 as_uint32;
>> +		/* More fields to be filled in when needed */
>> +	};
>> +} __packed;
>> +
>> +struct hv_output_get_system_property {
>> +	union {
>> +		u32 scheduler_type; /* enum hv_scheduler_type */
>> +	};
>> +} __packed;
>> +
>> +struct hv_proximity_domain_flags {
>> +	u32 proximity_preferred : 1;
>> +	u32 reserved : 30;
>> +	u32 proximity_info_valid : 1;
>> +} __packed;
>> +
>> +struct hv_proximity_domain_info {
>> +	u32 domain_id;
>> +	struct hv_proximity_domain_flags flags;
>> +} __packed;
>> +
>> +/* HvDepositMemory hypercall */
>> +struct hv_deposit_memory {	/* HV_INPUT_DEPOSIT_MEMORY */
>> +	u64 partition_id;
>> +	u64 gpa_page_list[];
>> +} __packed;
>> +
>> +struct hv_input_withdraw_memory {
>> +	u64 partition_id;
>> +	struct hv_proximity_domain_info proximity_domain_info;
>> +} __packed;
>> +
>> +struct hv_output_withdraw_memory {
>> +	DECLARE_FLEX_ARRAY(u64, gpa_page_list);
>> +} __packed;
>> +
>> +/* HV Map GPA (Guest Physical Address) Flags */
>> +#define HV_MAP_GPA_PERMISSIONS_NONE	       0x0
>> +#define HV_MAP_GPA_READABLE		       0x1
>> +#define HV_MAP_GPA_WRITABLE		       0x2
>> +#define HV_MAP_GPA_KERNEL_EXECUTABLE	       0x4
>> +#define HV_MAP_GPA_USER_EXECUTABLE	       0x8
>> +#define HV_MAP_GPA_EXECUTABLE		       0xC
>> +#define HV_MAP_GPA_PERMISSIONS_MASK	       0xF
>> +#define HV_MAP_GPA_ADJUSTABLE		    0x8000
>> +#define HV_MAP_GPA_NO_ACCESS		   0x10000
>> +#define HV_MAP_GPA_NOT_CACHED		  0x200000
>> +#define HV_MAP_GPA_LARGE_PAGE		0x80000000
>> +
>> +struct hv_input_map_gpa_pages {
>> +	u64 target_partition_id;
>> +	u64 target_gpa_base;
>> +	u32 map_flags;
>> +	u32 padding;
>> +	u64 source_gpa_page_list[];
>> +} __packed;
>> +
>> +union hv_gpa_page_access_state_flags {
>> +	struct {
>> +		u64 clear_accessed : 1;
>> +		u64 set_accessed : 1;
>> +		u64 clear_dirty : 1;
>> +		u64 set_dirty : 1;
>> +		u64 reserved : 60;
>> +	} __packed;
>> +	u64 as_uint64;
>> +};
>> +
>> +struct hv_input_get_gpa_pages_access_state {
>> +	u64  partition_id;
>> +	union hv_gpa_page_access_state_flags flags;
>> +	u64 hv_gpa_page_number;
>> +} __packed;
>> +
>> +union hv_gpa_page_access_state {
>> +	struct {
>> +		u8 accessed : 1;
>> +		u8 dirty : 1;
>> +		u8 reserved: 6;
>> +	};
>> +	u8 as_uint8;
>> +} __packed;
>> +
>> +struct hv_lp_startup_status {
>> +	u64 hv_status;
>> +	u64 substatus1;
>> +	u64 substatus2;
>> +	u64 substatus3;
>> +	u64 substatus4;
>> +	u64 substatus5;
>> +	u64 substatus6;
>> +} __packed;
>> +
>> +struct hv_input_add_logical_processor {
>> +	u32 lp_index;
>> +	u32 apic_id;
>> +	struct hv_proximity_domain_info proximity_domain_info;
>> +} __packed;
>> +
>> +struct hv_output_add_logical_processor {
>> +	struct hv_lp_startup_status startup_status;
>> +} __packed;
>> +
>> +enum {	/* HV_SUBNODE_TYPE */
>> +	HV_SUBNODE_ANY		= 0,
>> +	HV_SUBNODE_SOCKET,
>> +	HV_SUBNODE_CLUSTER,
>> +	HV_SUBNODE_L3,
>> +	HV_SUBNODE_COUNT,
>> +	HV_SUBNODE_INVALID	= -1
>> +};
>> +
>> +struct hv_create_vp {	/* HV_INPUT_CREATE_VP */
>> +	u64 partition_id;
>> +	u32 vp_index;
>> +	u8 padding[3];
>> +	u8 subnode_type;
>> +	u64 subnode_id;
>> +	struct hv_proximity_domain_info proximity_domain_info;
>> +	u64 flags;
>> +} __packed;
>> +
>> +/* HV_INTERRUPT_TRIGGER_MODE */
>> +enum hv_interrupt_trigger_mode {
>> +	HV_INTERRUPT_TRIGGER_MODE_EDGE	= 0,
>> +	HV_INTERRUPT_TRIGGER_MODE_LEVEL	= 1,
>> +};
>> +
>> +/* HV_DEVICE_INTERRUPT_DESCRIPTOR */
>> +struct hv_device_interrupt_descriptor {
>> +	u32 interrupt_type;
>> +	u32 trigger_mode;
>> +	u32 vector_count;
>> +	u32 reserved;
>> +	struct hv_device_interrupt_target target;
>> +} __packed;
>> +
>> +/* HV_INPUT_MAP_DEVICE_INTERRUPT */
>> +struct hv_input_map_device_interrupt {
>> +	u64 partition_id;
>> +	u64 device_id;
>> +	u32 flags;
>> +	u32 base_irt_idx;
>> +	struct hv_interrupt_entry logical_interrupt_entry;
>> +	struct hv_device_interrupt_descriptor interrupt_descriptor;
>> +} __packed;
>> +
>> +/* HV_OUTPUT_MAP_DEVICE_INTERRUPT */
>> +struct hv_output_map_device_interrupt {
>> +	struct hv_interrupt_entry interrupt_entry;
>> +} __packed;
>> +
>> +/* HV_INPUT_UNMAP_DEVICE_INTERRUPT */
>> +struct hv_input_unmap_device_interrupt {
>> +	u64 partition_id;
>> +	u64 device_id;
>> +	struct hv_interrupt_entry interrupt_entry;
>> +	u32 flags;
>> +} __packed;
>> +
>> +#define HV_SOURCE_SHADOW_NONE		    0x0
>> +#define HV_SOURCE_SHADOW_BRIDGE_BUS_RANGE   0x1
>> +
>> +struct hv_send_ipi_ex { /* HV_INPUT_SEND_SYNTHETIC_CLUSTER_IPI_EX */
>> +	u32 vector;
>> +	u32 reserved;
>> +	struct hv_vpset vp_set;
>> +} __packed;
>> +
>> +typedef u16 hv_pci_rid;		/* HV_PCI_RID */
>> +typedef u16 hv_pci_segment;	/* HV_PCI_SEGMENT */
>> +typedef u64 hv_logical_device_id;
>> +union hv_pci_bdf {	/* HV_PCI_BDF */
>> +	u16 as_uint16;
>> +
>> +	struct {
>> +		u8 function : 3;
>> +		u8 device : 5;
>> +		u8 bus;
>> +	};
>> +} __packed;
>> +
>> +union hv_pci_bus_range {
>> +	u16 as_uint16;
>> +
>> +	struct {
>> +		u8 subordinate_bus;
>> +		u8 secondary_bus;
>> +	};
>> +} __packed;
>> +
>> +enum hv_device_type {		/* HV_DEVICE_TYPE */
>> +	HV_DEVICE_TYPE_LOGICAL	= 0,
>> +	HV_DEVICE_TYPE_PCI	= 1,
>> +	HV_DEVICE_TYPE_IOAPIC	= 2,
>> +	HV_DEVICE_TYPE_ACPI	= 3,
>> +};
>> +
>> +union hv_device_id {		/* HV_DEVICE_ID */
>> +	u64 as_uint64;
>> +
>> +	struct {
>> +		u64 reserved0 : 62;
>> +		u64 device_type : 2;
>> +	};
>> +
>> +	/* HV_DEVICE_TYPE_LOGICAL */
>> +	struct {
>> +		u64 id : 62;
>> +		u64 device_type : 2;
>> +	} logical;
>> +
>> +	/* HV_DEVICE_TYPE_PCI */
>> +	struct {
>> +		union {
>> +			hv_pci_rid rid;
>> +			union hv_pci_bdf bdf;
>> +		};
>> +
>> +		hv_pci_segment segment;
>> +		union hv_pci_bus_range shadow_bus_range;
>> +
>> +		u16 phantom_function_bits : 2;
>> +		u16 source_shadow : 1;
>> +
>> +		u16 rsvdz0 : 11;
>> +		u16 device_type : 2;
>> +	} pci;
>> +
>> +	/* HV_DEVICE_TYPE_IOAPIC */
>> +	struct {
>> +		u8 ioapic_id;
>> +		u8 rsvdz0;
>> +		u16 rsvdz1;
>> +		u16 rsvdz2;
>> +
>> +		u16 rsvdz3 : 14;
>> +		u16 device_type : 2;
>> +	} ioapic;
>> +
>> +	/* HV_DEVICE_TYPE_ACPI */
>> +	struct {
>> +		u32 input_mapping_base;
>> +		u32 input_mapping_count : 30;
>> +		u32 device_type : 2;
>> +	} acpi;
>> +} __packed;
>> +
>> +#endif /* _HV_HVHDK_MINI_H */
>> --
>> 2.34.1

RE: [PATCH v2 3/4] hyperv: Add new Hyper-V headers in include/hyperv

[Michael Kelley]

From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Monday, November 11, 2024 10:45 AM
> 
> On 11/10/2024 8:13 PM, Michael Kelley wrote:
> > From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday,
> November 7, 2024 2:32 PM
> >>
> >> These headers contain definitions for regular Hyper-V guests (as in
> >> hyperv-tlfs.h), as well as interfaces for more privileged guests like
> >> Dom0.
> >
> > See my comment on Patch 0/4 about use of "dom0" terminology.
> >
> 
> Thanks, noted.
> 
> >>
> >> These files are derived from headers exported from Hyper-V, rather than
> >> being derived from the TLFS document. (Although, to preserve
> >> compatibility with existing Linux code, some definitions are copied
> >> directly from hyperv-tlfs.h too).
> >>
> >> The new files follow a naming convention according to their original
> >> use:
> >> - hdk "host development kit"
> >> - gdk "guest development kit"
> >> With postfix "_mini" implying userspace-only headers, and "_ext" for
> >> extended hypercalls.
> >>
> >> These names should be considered a rough guide only - since there are
> >> many places already where both host and guest code are in the same
> >> place, hvhdk.h (which includes everything) can be used most of the time.
> >
> > Just curious -- are there really cases where hvhdk.h can't be used?
> > If so, could you summarize why?
> >
> 
> No, there aren't cases where it "can't" be used. I suppose if someone
> doesn't want to include everything, perhaps they could just include
> hvgdk.h, for example. It doesn't really matter though.
> 
> > I ask because it would be nice to expand slightly on your paragraph
> > below, as follows:  (if indeed what I've added is correct)
> >
> > The use of multiple files and their original names is primarily to
> > keep the provenance of exactly where they came from in Hyper-V
> > code, which is helpful for manual maintenance and extension
> > of these definitions. Microsoft maintainers importing new definitions
> > should take care to put them in the right file. However, Linux kernel code
> > that uses any of the definitions need not be aware of the multiple files
> > or assign any meaning to the new names. Linux kernel uses should
> > always just include hvhdk.h
> >
> 
> Thanks, I think that additional sentence helps clarify things. I'll
> include it in the next version, and I think I can probably omit the prior
> paragraph: "These names should be considered a rough guide only...".
> 

Omitting that prior paragraph is OK with me.  The key thoughts from my
standpoint are:
* The separation into multiple files and the file names come from
   the Windows Hyper-V world and are maintained to ease bringing
   the definitions over from that world
   
* Linux code can ignore the multiple files and their names. Just
   #include hvhdk.h.

> >>
> >> The original names are kept intact primarily to keep the provenance of
> >> exactly where they came from in Hyper-V code, which is helpful for
> >> manual maintenance and extension of these definitions. Microsoft
> >> maintainers importing new definitions should take care to put them in
> >> the right file.
> >>
> >> Note also that the files contain both arm64 and x86_64 code guarded by
> >> \#ifdefs, which is how the definitions originally appear in Hyper-V.
> >
> > Spurious backslash?
> >
> 
> Indeed, thanks.
> 
> > I would suggest some additional clarification:  The #ifdef guards are
> > employed minimally where necessary to prevent conflicts due to
> > different definitions for the same thing on x86_64 and arm64. Where
> > there are no conflicts, the union of x86_64 definitions and arm64
> > definitions is visible when building for either architecture. In other
> > words, not all definitions specific to x86_64 are protected by #ifdef
> > x86_64. Such unprotected definitions may be visible when building
> > for arm64. And vice versa.
> >
> 
> Is there a reason you specifically want to point out that "Such
> unprotected definitions may be visible when building for arm64. And vice
> versa."? I think, in all the cases where #ifdefs are not used, an
> arch-specific prefix is used - hv_x64_ or hv_arm64_.
> 
> The main thing I wanted to call out here was the reasoning for not
> splitting arch-specific definitions into separate files in arch/x86/
> and arch/arm64/ as is typical in Linux.
> 
> Maybe this is a bit clearer:
> "
> Note the new headers contain both arm64 and x86_64 definitions. Some are
> guarded by #ifdefs, and some are instead prefixed with the architecture,
> e.g. hv_x64_*. These conventions are kept from Hyper-V code as another
> tactic to simplify the process of importing and maintaining the
> definitions, rather than splitting them up into their own files in
> arch/x86/ and arch/arm64/.
> "

Yes, your new paragraph works for me. Your original statement was
"the files contain both arm64 and x86_64 code guarded by #ifdefs",
which sounds like the more typical Linux approach of using #ifdefs
to segregate into x86-specific, arm64-specific, and common. I was
just trying to be explicit that full segregation isn't done, and isn't a
goal, because of wanting to maintain alignment with the original
Hyper-V definitions.

It's "Hey, we know we're not handling this in the typical Linux way,
and here's why". Your revised paragraph covers that in a less
heavyweight way than what I wrote. :-)

Michael

> 
> I hope it's reasonably clear that it's a good tradeoff to go against
> Linux convention in this case, to make it easy to import and maintain
> Hyper-V definitions.
> 
> Thanks
> Nuno
> 

Re: [PATCH v2 3/4] hyperv: Add new Hyper-V headers in include/hyperv

[Nuno Das Neves]

On 11/11/2024 11:31 AM, Michael Kelley wrote:
> From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Monday, November 11, 2024 10:45 AM
>>
>> On 11/10/2024 8:13 PM, Michael Kelley wrote:
>>> From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday,
>> November 7, 2024 2:32 PM
>>>>
>>>> These headers contain definitions for regular Hyper-V guests (as in
>>>> hyperv-tlfs.h), as well as interfaces for more privileged guests like
>>>> Dom0.
>>>
>>> See my comment on Patch 0/4 about use of "dom0" terminology.
>>>
>>
>> Thanks, noted.
>>
>>>>
>>>> These files are derived from headers exported from Hyper-V, rather than
>>>> being derived from the TLFS document. (Although, to preserve
>>>> compatibility with existing Linux code, some definitions are copied
>>>> directly from hyperv-tlfs.h too).
>>>>
>>>> The new files follow a naming convention according to their original
>>>> use:
>>>> - hdk "host development kit"
>>>> - gdk "guest development kit"
>>>> With postfix "_mini" implying userspace-only headers, and "_ext" for
>>>> extended hypercalls.
>>>>
>>>> These names should be considered a rough guide only - since there are
>>>> many places already where both host and guest code are in the same
>>>> place, hvhdk.h (which includes everything) can be used most of the time.
>>>
>>> Just curious -- are there really cases where hvhdk.h can't be used?
>>> If so, could you summarize why?
>>>
>>
>> No, there aren't cases where it "can't" be used. I suppose if someone
>> doesn't want to include everything, perhaps they could just include
>> hvgdk.h, for example. It doesn't really matter though.
>>
>>> I ask because it would be nice to expand slightly on your paragraph
>>> below, as follows:  (if indeed what I've added is correct)
>>>
>>> The use of multiple files and their original names is primarily to
>>> keep the provenance of exactly where they came from in Hyper-V
>>> code, which is helpful for manual maintenance and extension
>>> of these definitions. Microsoft maintainers importing new definitions
>>> should take care to put them in the right file. However, Linux kernel code
>>> that uses any of the definitions need not be aware of the multiple files
>>> or assign any meaning to the new names. Linux kernel uses should
>>> always just include hvhdk.h
>>>
>>
>> Thanks, I think that additional sentence helps clarify things. I'll
>> include it in the next version, and I think I can probably omit the prior
>> paragraph: "These names should be considered a rough guide only...".
>>
> 
> Omitting that prior paragraph is OK with me.  The key thoughts from my
> standpoint are:
> * The separation into multiple files and the file names come from
>    the Windows Hyper-V world and are maintained to ease bringing
>    the definitions over from that world
>    
> * Linux code can ignore the multiple files and their names. Just
>    #include hvhdk.h.
> 

Agreed, thanks for helping clarify the points.

>>>>
>>>> The original names are kept intact primarily to keep the provenance of
>>>> exactly where they came from in Hyper-V code, which is helpful for
>>>> manual maintenance and extension of these definitions. Microsoft
>>>> maintainers importing new definitions should take care to put them in
>>>> the right file.
>>>>
>>>> Note also that the files contain both arm64 and x86_64 code guarded by
>>>> \#ifdefs, which is how the definitions originally appear in Hyper-V.
>>>
>>> Spurious backslash?
>>>
>>
>> Indeed, thanks.
>>
>>> I would suggest some additional clarification:  The #ifdef guards are
>>> employed minimally where necessary to prevent conflicts due to
>>> different definitions for the same thing on x86_64 and arm64. Where
>>> there are no conflicts, the union of x86_64 definitions and arm64
>>> definitions is visible when building for either architecture. In other
>>> words, not all definitions specific to x86_64 are protected by #ifdef
>>> x86_64. Such unprotected definitions may be visible when building
>>> for arm64. And vice versa.
>>>
>>
>> Is there a reason you specifically want to point out that "Such
>> unprotected definitions may be visible when building for arm64. And vice
>> versa."? I think, in all the cases where #ifdefs are not used, an
>> arch-specific prefix is used - hv_x64_ or hv_arm64_.
>>
>> The main thing I wanted to call out here was the reasoning for not
>> splitting arch-specific definitions into separate files in arch/x86/
>> and arch/arm64/ as is typical in Linux.
>>
>> Maybe this is a bit clearer:
>> "
>> Note the new headers contain both arm64 and x86_64 definitions. Some are
>> guarded by #ifdefs, and some are instead prefixed with the architecture,
>> e.g. hv_x64_*. These conventions are kept from Hyper-V code as another
>> tactic to simplify the process of importing and maintaining the
>> definitions, rather than splitting them up into their own files in
>> arch/x86/ and arch/arm64/.
>> "
> 
> Yes, your new paragraph works for me. Your original statement was
> "the files contain both arm64 and x86_64 code guarded by #ifdefs",
> which sounds like the more typical Linux approach of using #ifdefs
> to segregate into x86-specific, arm64-specific, and common. I was
> just trying to be explicit that full segregation isn't done, and isn't a
> goal, because of wanting to maintain alignment with the original
> Hyper-V definitions.
> 
> It's "Hey, we know we're not handling this in the typical Linux way,
> and here's why". Your revised paragraph covers that in a less
> heavyweight way than what I wrote. :-)
> 

Ok, great. I'll use that for the next version then.

Thanks again!
Nuno

> Michael
> 
>>
>> I hope it's reasonably clear that it's a good tradeoff to go against
>> Linux convention in this case, to make it easy to import and maintain
>> Hyper-V definitions.
>>
>> Thanks
>> Nuno
>>

[PATCH v2 4/4] hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h

[Nuno Das Neves]

Switch to using hvhdk.h everywhere in the kernel. This header includes
all the new Hyper-V headers in include/hyperv, which form a superset of
the definitions found in hyperv-tlfs.h.

This makes it easier to add new Hyper-V interfaces without being
restricted to those in the TLFS doc (reflected in hyperv-tlfs.h).

To be more consistent with the original Hyper-V code, the names of some
definitions are changed slightly. Update those where needed.

hyperv-tlfs.h is no longer included anywhere - hvhdk.h can serve
the same role, but with an easier path for adding new definitions.

Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
---
 arch/arm64/hyperv/hv_core.c        |  2 +-
 arch/arm64/hyperv/mshyperv.c       |  4 ++--
 arch/arm64/include/asm/mshyperv.h  |  2 +-
 arch/x86/hyperv/hv_init.c          | 20 ++++++++++----------
 arch/x86/hyperv/hv_proc.c          |  2 +-
 arch/x86/hyperv/nested.c           |  2 +-
 arch/x86/include/asm/kvm_host.h    |  2 +-
 arch/x86/include/asm/mshyperv.h    |  2 +-
 arch/x86/include/asm/svm.h         |  2 +-
 arch/x86/kernel/cpu/mshyperv.c     |  2 +-
 arch/x86/kvm/vmx/hyperv_evmcs.h    |  2 +-
 arch/x86/kvm/vmx/vmx_onhyperv.h    |  2 +-
 drivers/clocksource/hyperv_timer.c |  2 +-
 drivers/hv/hv_balloon.c            |  4 ++--
 drivers/hv/hv_common.c             |  2 +-
 drivers/hv/hv_kvp.c                |  2 +-
 drivers/hv/hv_snapshot.c           |  2 +-
 drivers/hv/hyperv_vmbus.h          |  2 +-
 include/asm-generic/mshyperv.h     |  2 +-
 include/clocksource/hyperv_timer.h |  2 +-
 include/linux/hyperv.h             |  2 +-
 net/vmw_vsock/hyperv_transport.c   |  2 +-
 22 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/arch/arm64/hyperv/hv_core.c b/arch/arm64/hyperv/hv_core.c
index 7a746a5a6b42..69004f619c57 100644
--- a/arch/arm64/hyperv/hv_core.c
+++ b/arch/arm64/hyperv/hv_core.c
@@ -14,7 +14,7 @@
 #include <linux/arm-smccc.h>
 #include <linux/module.h>
 #include <asm-generic/bug.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 #include <asm/mshyperv.h>
 
 /*
diff --git a/arch/arm64/hyperv/mshyperv.c b/arch/arm64/hyperv/mshyperv.c
index b1a4de4eee29..fc49949b7df6 100644
--- a/arch/arm64/hyperv/mshyperv.c
+++ b/arch/arm64/hyperv/mshyperv.c
@@ -49,12 +49,12 @@ static int __init hyperv_init(void)
 	hv_set_vpreg(HV_REGISTER_GUEST_OS_ID, guest_id);
 
 	/* Get the features and hints from Hyper-V */
-	hv_get_vpreg_128(HV_REGISTER_FEATURES, &result);
+	hv_get_vpreg_128(HV_REGISTER_PRIVILEGES_AND_FEATURES_INFO, &result);
 	ms_hyperv.features = result.as32.a;
 	ms_hyperv.priv_high = result.as32.b;
 	ms_hyperv.misc_features = result.as32.c;
 
-	hv_get_vpreg_128(HV_REGISTER_ENLIGHTENMENTS, &result);
+	hv_get_vpreg_128(HV_REGISTER_FEATURES_INFO, &result);
 	ms_hyperv.hints = result.as32.a;
 
 	pr_info("Hyper-V: privilege flags low 0x%x, high 0x%x, hints 0x%x, misc 0x%x\n",
diff --git a/arch/arm64/include/asm/mshyperv.h b/arch/arm64/include/asm/mshyperv.h
index a975e1a689dd..7595fb35fae6 100644
--- a/arch/arm64/include/asm/mshyperv.h
+++ b/arch/arm64/include/asm/mshyperv.h
@@ -20,7 +20,7 @@
 
 #include <linux/types.h>
 #include <linux/arm-smccc.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 /*
  * Declare calls to get and set Hyper-V VP register values on ARM64, which
diff --git a/arch/x86/hyperv/hv_init.c b/arch/x86/hyperv/hv_init.c
index 1a6354b3e582..3f9aef157c88 100644
--- a/arch/x86/hyperv/hv_init.c
+++ b/arch/x86/hyperv/hv_init.c
@@ -19,7 +19,7 @@
 #include <asm/sev.h>
 #include <asm/ibt.h>
 #include <asm/hypervisor.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 #include <asm/mshyperv.h>
 #include <asm/idtentry.h>
 #include <asm/set_memory.h>
@@ -416,24 +416,24 @@ static void __init hv_get_partition_id(void)
 static u8 __init get_vtl(void)
 {
 	u64 control = HV_HYPERCALL_REP_COMP_1 | HVCALL_GET_VP_REGISTERS;
-	struct hv_get_vp_registers_input *input;
-	struct hv_get_vp_registers_output *output;
+	struct hv_input_get_vp_registers *input;
+	struct hv_register_assoc *output;
 	unsigned long flags;
 	u64 ret;
 
 	local_irq_save(flags);
 	input = *this_cpu_ptr(hyperv_pcpu_input_arg);
-	output = (struct hv_get_vp_registers_output *)input;
+	output = (struct hv_register_assoc *)input;
 
-	memset(input, 0, struct_size(input, element, 1));
-	input->header.partitionid = HV_PARTITION_ID_SELF;
-	input->header.vpindex = HV_VP_INDEX_SELF;
-	input->header.inputvtl = 0;
-	input->element[0].name0 = HV_X64_REGISTER_VSM_VP_STATUS;
+	memset(input, 0, struct_size(input, names, 1));
+	input->partition_id = HV_PARTITION_ID_SELF;
+	input->vp_index = HV_VP_INDEX_SELF;
+	input->input_vtl.as_uint8 = 0;
+	input->names[0] = HV_X64_REGISTER_VSM_VP_STATUS;
 
 	ret = hv_do_hypercall(control, input, output);
 	if (hv_result_success(ret)) {
-		ret = output->as64.low & HV_X64_VTL_MASK;
+		ret = output->value.reg8 & HV_X64_VTL_MASK;
 	} else {
 		pr_err("Failed to get VTL(error: %lld) exiting...\n", ret);
 		BUG();
diff --git a/arch/x86/hyperv/hv_proc.c b/arch/x86/hyperv/hv_proc.c
index b74c06c04ff1..ac4c834d4435 100644
--- a/arch/x86/hyperv/hv_proc.c
+++ b/arch/x86/hyperv/hv_proc.c
@@ -176,7 +176,7 @@ int hv_call_create_vp(int node, u64 partition_id, u32 vp_index, u32 flags)
 		input->partition_id = partition_id;
 		input->vp_index = vp_index;
 		input->flags = flags;
-		input->subnode_type = HvSubnodeAny;
+		input->subnode_type = HV_SUBNODE_ANY;
 		input->proximity_domain_info = hv_numa_node_to_pxm_info(node);
 		status = hv_do_hypercall(HVCALL_CREATE_VP, input, NULL);
 		local_irq_restore(irq_flags);
diff --git a/arch/x86/hyperv/nested.c b/arch/x86/hyperv/nested.c
index 9dc259fa322e..1083dc8646f9 100644
--- a/arch/x86/hyperv/nested.c
+++ b/arch/x86/hyperv/nested.c
@@ -11,7 +11,7 @@
 
 
 #include <linux/types.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 #include <asm/mshyperv.h>
 #include <asm/tlbflush.h>
 
diff --git a/arch/x86/include/asm/kvm_host.h b/arch/x86/include/asm/kvm_host.h
index 3627eab994a3..38cd609f37c7 100644
--- a/arch/x86/include/asm/kvm_host.h
+++ b/arch/x86/include/asm/kvm_host.h
@@ -34,7 +34,7 @@
 #include <asm/asm.h>
 #include <asm/kvm_page_track.h>
 #include <asm/kvm_vcpu_regs.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 #define __KVM_HAVE_ARCH_VCPU_DEBUGFS
 
diff --git a/arch/x86/include/asm/mshyperv.h b/arch/x86/include/asm/mshyperv.h
index 47ca48062547..f0564e599b7f 100644
--- a/arch/x86/include/asm/mshyperv.h
+++ b/arch/x86/include/asm/mshyperv.h
@@ -6,9 +6,9 @@
 #include <linux/nmi.h>
 #include <linux/msi.h>
 #include <linux/io.h>
-#include <asm/hyperv-tlfs.h>
 #include <asm/nospec-branch.h>
 #include <asm/paravirt.h>
+#include <hyperv/hvhdk.h>
 
 /*
  * Hyper-V always provides a single IO-APIC at this MMIO address.
diff --git a/arch/x86/include/asm/svm.h b/arch/x86/include/asm/svm.h
index f0dea3750ca9..913af68ad660 100644
--- a/arch/x86/include/asm/svm.h
+++ b/arch/x86/include/asm/svm.h
@@ -5,7 +5,7 @@
 #include <uapi/asm/svm.h>
 #include <uapi/asm/kvm.h>
 
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 /*
  * 32-bit intercept words in the VMCB Control Area, starting
diff --git a/arch/x86/kernel/cpu/mshyperv.c b/arch/x86/kernel/cpu/mshyperv.c
index e0fd57a8ba84..be0d1f4491d9 100644
--- a/arch/x86/kernel/cpu/mshyperv.c
+++ b/arch/x86/kernel/cpu/mshyperv.c
@@ -20,7 +20,7 @@
 #include <linux/random.h>
 #include <asm/processor.h>
 #include <asm/hypervisor.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 #include <asm/mshyperv.h>
 #include <asm/desc.h>
 #include <asm/idtentry.h>
diff --git a/arch/x86/kvm/vmx/hyperv_evmcs.h b/arch/x86/kvm/vmx/hyperv_evmcs.h
index a543fccfc574..6536290f4274 100644
--- a/arch/x86/kvm/vmx/hyperv_evmcs.h
+++ b/arch/x86/kvm/vmx/hyperv_evmcs.h
@@ -6,7 +6,7 @@
 #ifndef __KVM_X86_VMX_HYPERV_EVMCS_H
 #define __KVM_X86_VMX_HYPERV_EVMCS_H
 
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 #include "capabilities.h"
 #include "vmcs12.h"
diff --git a/arch/x86/kvm/vmx/vmx_onhyperv.h b/arch/x86/kvm/vmx/vmx_onhyperv.h
index eb48153bfd73..2b94ff301712 100644
--- a/arch/x86/kvm/vmx/vmx_onhyperv.h
+++ b/arch/x86/kvm/vmx/vmx_onhyperv.h
@@ -3,7 +3,7 @@
 #ifndef __ARCH_X86_KVM_VMX_ONHYPERV_H__
 #define __ARCH_X86_KVM_VMX_ONHYPERV_H__
 
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 #include <asm/mshyperv.h>
 
 #include <linux/jump_label.h>
diff --git a/drivers/clocksource/hyperv_timer.c b/drivers/clocksource/hyperv_timer.c
index b2a080647e41..c1cc96a168c7 100644
--- a/drivers/clocksource/hyperv_timer.c
+++ b/drivers/clocksource/hyperv_timer.c
@@ -23,7 +23,7 @@
 #include <linux/acpi.h>
 #include <linux/hyperv.h>
 #include <clocksource/hyperv_timer.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 #include <asm/mshyperv.h>
 
 static struct clock_event_device __percpu *hv_clock_event;
diff --git a/drivers/hv/hv_balloon.c b/drivers/hv/hv_balloon.c
index c38dcdfcb914..d792df113962 100644
--- a/drivers/hv/hv_balloon.c
+++ b/drivers/hv/hv_balloon.c
@@ -28,7 +28,7 @@
 #include <linux/sizes.h>
 
 #include <linux/hyperv.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 #include <asm/mshyperv.h>
 
@@ -1585,7 +1585,7 @@ static int hv_free_page_report(struct page_reporting_dev_info *pr_dev_info,
 		return -ENOSPC;
 	}
 
-	hint->type = HV_EXT_MEMORY_HEAT_HINT_TYPE_COLD_DISCARD;
+	hint->heat_type = HV_EXTMEM_HEAT_HINT_COLD_DISCARD;
 	hint->reserved = 0;
 	for_each_sg(sgl, sg, nents, i) {
 		union hv_gpa_page_range *range;
diff --git a/drivers/hv/hv_common.c b/drivers/hv/hv_common.c
index 9c452bfbd571..9ea05cbbf50d 100644
--- a/drivers/hv/hv_common.c
+++ b/drivers/hv/hv_common.c
@@ -28,7 +28,7 @@
 #include <linux/slab.h>
 #include <linux/dma-map-ops.h>
 #include <linux/set_memory.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 #include <asm/mshyperv.h>
 
 /*
diff --git a/drivers/hv/hv_kvp.c b/drivers/hv/hv_kvp.c
index d35b60c06114..bfb7a518b4ed 100644
--- a/drivers/hv/hv_kvp.c
+++ b/drivers/hv/hv_kvp.c
@@ -27,7 +27,7 @@
 #include <linux/connector.h>
 #include <linux/workqueue.h>
 #include <linux/hyperv.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 #include "hyperv_vmbus.h"
 #include "hv_utils_transport.h"
diff --git a/drivers/hv/hv_snapshot.c b/drivers/hv/hv_snapshot.c
index 0d2184be1691..097ebd58f14e 100644
--- a/drivers/hv/hv_snapshot.c
+++ b/drivers/hv/hv_snapshot.c
@@ -12,7 +12,7 @@
 #include <linux/connector.h>
 #include <linux/workqueue.h>
 #include <linux/hyperv.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 #include "hyperv_vmbus.h"
 #include "hv_utils_transport.h"
diff --git a/drivers/hv/hyperv_vmbus.h b/drivers/hv/hyperv_vmbus.h
index 76ac5185a01a..2bea654858e3 100644
--- a/drivers/hv/hyperv_vmbus.h
+++ b/drivers/hv/hyperv_vmbus.h
@@ -15,10 +15,10 @@
 #include <linux/list.h>
 #include <linux/bitops.h>
 #include <asm/sync_bitops.h>
-#include <asm/hyperv-tlfs.h>
 #include <linux/atomic.h>
 #include <linux/hyperv.h>
 #include <linux/interrupt.h>
+#include <hyperv/hvhdk.h>
 
 #include "hv_trace.h"
 
diff --git a/include/asm-generic/mshyperv.h b/include/asm-generic/mshyperv.h
index 8fe7aaab2599..138e416a0f9c 100644
--- a/include/asm-generic/mshyperv.h
+++ b/include/asm-generic/mshyperv.h
@@ -25,7 +25,7 @@
 #include <linux/cpumask.h>
 #include <linux/nmi.h>
 #include <asm/ptrace.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 #define VTPM_BASE_ADDRESS 0xfed40000
 
diff --git a/include/clocksource/hyperv_timer.h b/include/clocksource/hyperv_timer.h
index 6cdc873ac907..a4c81a60f53d 100644
--- a/include/clocksource/hyperv_timer.h
+++ b/include/clocksource/hyperv_timer.h
@@ -15,7 +15,7 @@
 
 #include <linux/clocksource.h>
 #include <linux/math64.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 #define HV_MAX_MAX_DELTA_TICKS 0xffffffff
 #define HV_MIN_DELTA_TICKS 1
diff --git a/include/linux/hyperv.h b/include/linux/hyperv.h
index d0893ec488ae..ed65b20defea 100644
--- a/include/linux/hyperv.h
+++ b/include/linux/hyperv.h
@@ -24,7 +24,7 @@
 #include <linux/mod_devicetable.h>
 #include <linux/interrupt.h>
 #include <linux/reciprocal_div.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 #define MAX_PAGE_BUFFER_COUNT				32
 #define MAX_MULTIPAGE_BUFFER_COUNT			32 /* 128K */
diff --git a/net/vmw_vsock/hyperv_transport.c b/net/vmw_vsock/hyperv_transport.c
index e2157e387217..152b6ed8877d 100644
--- a/net/vmw_vsock/hyperv_transport.c
+++ b/net/vmw_vsock/hyperv_transport.c
@@ -13,7 +13,7 @@
 #include <linux/hyperv.h>
 #include <net/sock.h>
 #include <net/af_vsock.h>
-#include <asm/hyperv-tlfs.h>
+#include <hyperv/hvhdk.h>
 
 /* Older (VMBUS version 'VERSION_WIN10' or before) Windows hosts have some
  * stricter requirements on the hv_sock ring buffer size of six 4K pages.
-- 
2.34.1

RE: [PATCH v2 4/4] hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h

[Michael Kelley]

From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
> 
> Switch to using hvhdk.h everywhere in the kernel. This header includes
> all the new Hyper-V headers in include/hyperv, which form a superset of
> the definitions found in hyperv-tlfs.h.
> 
> This makes it easier to add new Hyper-V interfaces without being
> restricted to those in the TLFS doc (reflected in hyperv-tlfs.h).
> 
> To be more consistent with the original Hyper-V code, the names of some
> definitions are changed slightly. Update those where needed.
> 
> hyperv-tlfs.h is no longer included anywhere - hvhdk.h can serve
> the same role, but with an easier path for adding new definitions.

Is hyperv-tlfs.h and friends being deleted? If not, the risk is that
someone adds a new #include of it without realizing that it has been
superseded by hvhdk.h.

Note also that this patch does not apply cleanly to 6.12 rc's, or to
current linux-next trees. There's an unrelated #include added to
arch/x86/include/asm/kvm_host.h that causes a merge failure
in that file.

Michael

> 
> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> ---
>  arch/arm64/hyperv/hv_core.c        |  2 +-
>  arch/arm64/hyperv/mshyperv.c       |  4 ++--
>  arch/arm64/include/asm/mshyperv.h  |  2 +-
>  arch/x86/hyperv/hv_init.c          | 20 ++++++++++----------
>  arch/x86/hyperv/hv_proc.c          |  2 +-
>  arch/x86/hyperv/nested.c           |  2 +-
>  arch/x86/include/asm/kvm_host.h    |  2 +-
>  arch/x86/include/asm/mshyperv.h    |  2 +-
>  arch/x86/include/asm/svm.h         |  2 +-
>  arch/x86/kernel/cpu/mshyperv.c     |  2 +-
>  arch/x86/kvm/vmx/hyperv_evmcs.h    |  2 +-
>  arch/x86/kvm/vmx/vmx_onhyperv.h    |  2 +-
>  drivers/clocksource/hyperv_timer.c |  2 +-
>  drivers/hv/hv_balloon.c            |  4 ++--
>  drivers/hv/hv_common.c             |  2 +-
>  drivers/hv/hv_kvp.c                |  2 +-
>  drivers/hv/hv_snapshot.c           |  2 +-
>  drivers/hv/hyperv_vmbus.h          |  2 +-
>  include/asm-generic/mshyperv.h     |  2 +-
>  include/clocksource/hyperv_timer.h |  2 +-
>  include/linux/hyperv.h             |  2 +-
>  net/vmw_vsock/hyperv_transport.c   |  2 +-
>  22 files changed, 33 insertions(+), 33 deletions(-)
> 
> diff --git a/arch/arm64/hyperv/hv_core.c b/arch/arm64/hyperv/hv_core.c
> index 7a746a5a6b42..69004f619c57 100644
> --- a/arch/arm64/hyperv/hv_core.c
> +++ b/arch/arm64/hyperv/hv_core.c
> @@ -14,7 +14,7 @@
>  #include <linux/arm-smccc.h>
>  #include <linux/module.h>
>  #include <asm-generic/bug.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
>  #include <asm/mshyperv.h>
> 
>  /*
> diff --git a/arch/arm64/hyperv/mshyperv.c b/arch/arm64/hyperv/mshyperv.c
> index b1a4de4eee29..fc49949b7df6 100644
> --- a/arch/arm64/hyperv/mshyperv.c
> +++ b/arch/arm64/hyperv/mshyperv.c
> @@ -49,12 +49,12 @@ static int __init hyperv_init(void)
>  	hv_set_vpreg(HV_REGISTER_GUEST_OS_ID, guest_id);
> 
>  	/* Get the features and hints from Hyper-V */
> -	hv_get_vpreg_128(HV_REGISTER_FEATURES, &result);
> +	hv_get_vpreg_128(HV_REGISTER_PRIVILEGES_AND_FEATURES_INFO, &result);
>  	ms_hyperv.features = result.as32.a;
>  	ms_hyperv.priv_high = result.as32.b;
>  	ms_hyperv.misc_features = result.as32.c;
> 
> -	hv_get_vpreg_128(HV_REGISTER_ENLIGHTENMENTS, &result);
> +	hv_get_vpreg_128(HV_REGISTER_FEATURES_INFO, &result);
>  	ms_hyperv.hints = result.as32.a;
> 
>  	pr_info("Hyper-V: privilege flags low 0x%x, high 0x%x, hints 0x%x, misc
> 0x%x\n",
> diff --git a/arch/arm64/include/asm/mshyperv.h
> b/arch/arm64/include/asm/mshyperv.h
> index a975e1a689dd..7595fb35fae6 100644
> --- a/arch/arm64/include/asm/mshyperv.h
> +++ b/arch/arm64/include/asm/mshyperv.h
> @@ -20,7 +20,7 @@
> 
>  #include <linux/types.h>
>  #include <linux/arm-smccc.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  /*
>   * Declare calls to get and set Hyper-V VP register values on ARM64, which
> diff --git a/arch/x86/hyperv/hv_init.c b/arch/x86/hyperv/hv_init.c
> index 1a6354b3e582..3f9aef157c88 100644
> --- a/arch/x86/hyperv/hv_init.c
> +++ b/arch/x86/hyperv/hv_init.c
> @@ -19,7 +19,7 @@
>  #include <asm/sev.h>
>  #include <asm/ibt.h>
>  #include <asm/hypervisor.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
>  #include <asm/mshyperv.h>
>  #include <asm/idtentry.h>
>  #include <asm/set_memory.h>
> @@ -416,24 +416,24 @@ static void __init hv_get_partition_id(void)
>  static u8 __init get_vtl(void)
>  {
>  	u64 control = HV_HYPERCALL_REP_COMP_1 | HVCALL_GET_VP_REGISTERS;
> -	struct hv_get_vp_registers_input *input;
> -	struct hv_get_vp_registers_output *output;
> +	struct hv_input_get_vp_registers *input;
> +	struct hv_register_assoc *output;
>  	unsigned long flags;
>  	u64 ret;
> 
>  	local_irq_save(flags);
>  	input = *this_cpu_ptr(hyperv_pcpu_input_arg);
> -	output = (struct hv_get_vp_registers_output *)input;
> +	output = (struct hv_register_assoc *)input;
> 
> -	memset(input, 0, struct_size(input, element, 1));
> -	input->header.partitionid = HV_PARTITION_ID_SELF;
> -	input->header.vpindex = HV_VP_INDEX_SELF;
> -	input->header.inputvtl = 0;
> -	input->element[0].name0 = HV_X64_REGISTER_VSM_VP_STATUS;
> +	memset(input, 0, struct_size(input, names, 1));
> +	input->partition_id = HV_PARTITION_ID_SELF;
> +	input->vp_index = HV_VP_INDEX_SELF;
> +	input->input_vtl.as_uint8 = 0;
> +	input->names[0] = HV_X64_REGISTER_VSM_VP_STATUS;
> 
>  	ret = hv_do_hypercall(control, input, output);
>  	if (hv_result_success(ret)) {
> -		ret = output->as64.low & HV_X64_VTL_MASK;
> +		ret = output->value.reg8 & HV_X64_VTL_MASK;
>  	} else {
>  		pr_err("Failed to get VTL(error: %lld) exiting...\n", ret);
>  		BUG();
> diff --git a/arch/x86/hyperv/hv_proc.c b/arch/x86/hyperv/hv_proc.c
> index b74c06c04ff1..ac4c834d4435 100644
> --- a/arch/x86/hyperv/hv_proc.c
> +++ b/arch/x86/hyperv/hv_proc.c
> @@ -176,7 +176,7 @@ int hv_call_create_vp(int node, u64 partition_id, u32 vp_index,
> u32 flags)
>  		input->partition_id = partition_id;
>  		input->vp_index = vp_index;
>  		input->flags = flags;
> -		input->subnode_type = HvSubnodeAny;
> +		input->subnode_type = HV_SUBNODE_ANY;
>  		input->proximity_domain_info = hv_numa_node_to_pxm_info(node);
>  		status = hv_do_hypercall(HVCALL_CREATE_VP, input, NULL);
>  		local_irq_restore(irq_flags);
> diff --git a/arch/x86/hyperv/nested.c b/arch/x86/hyperv/nested.c
> index 9dc259fa322e..1083dc8646f9 100644
> --- a/arch/x86/hyperv/nested.c
> +++ b/arch/x86/hyperv/nested.c
> @@ -11,7 +11,7 @@
> 
> 
>  #include <linux/types.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
>  #include <asm/mshyperv.h>
>  #include <asm/tlbflush.h>
> 
> diff --git a/arch/x86/include/asm/kvm_host.h b/arch/x86/include/asm/kvm_host.h
> index 3627eab994a3..38cd609f37c7 100644
> --- a/arch/x86/include/asm/kvm_host.h
> +++ b/arch/x86/include/asm/kvm_host.h
> @@ -34,7 +34,7 @@
>  #include <asm/asm.h>
>  #include <asm/kvm_page_track.h>
>  #include <asm/kvm_vcpu_regs.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  #define __KVM_HAVE_ARCH_VCPU_DEBUGFS
> 
> diff --git a/arch/x86/include/asm/mshyperv.h b/arch/x86/include/asm/mshyperv.h
> index 47ca48062547..f0564e599b7f 100644
> --- a/arch/x86/include/asm/mshyperv.h
> +++ b/arch/x86/include/asm/mshyperv.h
> @@ -6,9 +6,9 @@
>  #include <linux/nmi.h>
>  #include <linux/msi.h>
>  #include <linux/io.h>
> -#include <asm/hyperv-tlfs.h>
>  #include <asm/nospec-branch.h>
>  #include <asm/paravirt.h>
> +#include <hyperv/hvhdk.h>
> 
>  /*
>   * Hyper-V always provides a single IO-APIC at this MMIO address.
> diff --git a/arch/x86/include/asm/svm.h b/arch/x86/include/asm/svm.h
> index f0dea3750ca9..913af68ad660 100644
> --- a/arch/x86/include/asm/svm.h
> +++ b/arch/x86/include/asm/svm.h
> @@ -5,7 +5,7 @@
>  #include <uapi/asm/svm.h>
>  #include <uapi/asm/kvm.h>
> 
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  /*
>   * 32-bit intercept words in the VMCB Control Area, starting
> diff --git a/arch/x86/kernel/cpu/mshyperv.c b/arch/x86/kernel/cpu/mshyperv.c
> index e0fd57a8ba84..be0d1f4491d9 100644
> --- a/arch/x86/kernel/cpu/mshyperv.c
> +++ b/arch/x86/kernel/cpu/mshyperv.c
> @@ -20,7 +20,7 @@
>  #include <linux/random.h>
>  #include <asm/processor.h>
>  #include <asm/hypervisor.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
>  #include <asm/mshyperv.h>
>  #include <asm/desc.h>
>  #include <asm/idtentry.h>
> diff --git a/arch/x86/kvm/vmx/hyperv_evmcs.h b/arch/x86/kvm/vmx/hyperv_evmcs.h
> index a543fccfc574..6536290f4274 100644
> --- a/arch/x86/kvm/vmx/hyperv_evmcs.h
> +++ b/arch/x86/kvm/vmx/hyperv_evmcs.h
> @@ -6,7 +6,7 @@
>  #ifndef __KVM_X86_VMX_HYPERV_EVMCS_H
>  #define __KVM_X86_VMX_HYPERV_EVMCS_H
> 
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  #include "capabilities.h"
>  #include "vmcs12.h"
> diff --git a/arch/x86/kvm/vmx/vmx_onhyperv.h
> b/arch/x86/kvm/vmx/vmx_onhyperv.h
> index eb48153bfd73..2b94ff301712 100644
> --- a/arch/x86/kvm/vmx/vmx_onhyperv.h
> +++ b/arch/x86/kvm/vmx/vmx_onhyperv.h
> @@ -3,7 +3,7 @@
>  #ifndef __ARCH_X86_KVM_VMX_ONHYPERV_H__
>  #define __ARCH_X86_KVM_VMX_ONHYPERV_H__
> 
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
>  #include <asm/mshyperv.h>
> 
>  #include <linux/jump_label.h>
> diff --git a/drivers/clocksource/hyperv_timer.c b/drivers/clocksource/hyperv_timer.c
> index b2a080647e41..c1cc96a168c7 100644
> --- a/drivers/clocksource/hyperv_timer.c
> +++ b/drivers/clocksource/hyperv_timer.c
> @@ -23,7 +23,7 @@
>  #include <linux/acpi.h>
>  #include <linux/hyperv.h>
>  #include <clocksource/hyperv_timer.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
>  #include <asm/mshyperv.h>
> 
>  static struct clock_event_device __percpu *hv_clock_event;
> diff --git a/drivers/hv/hv_balloon.c b/drivers/hv/hv_balloon.c
> index c38dcdfcb914..d792df113962 100644
> --- a/drivers/hv/hv_balloon.c
> +++ b/drivers/hv/hv_balloon.c
> @@ -28,7 +28,7 @@
>  #include <linux/sizes.h>
> 
>  #include <linux/hyperv.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  #include <asm/mshyperv.h>
> 
> @@ -1585,7 +1585,7 @@ static int hv_free_page_report(struct
> page_reporting_dev_info *pr_dev_info,
>  		return -ENOSPC;
>  	}
> 
> -	hint->type = HV_EXT_MEMORY_HEAT_HINT_TYPE_COLD_DISCARD;
> +	hint->heat_type = HV_EXTMEM_HEAT_HINT_COLD_DISCARD;
>  	hint->reserved = 0;
>  	for_each_sg(sgl, sg, nents, i) {
>  		union hv_gpa_page_range *range;
> diff --git a/drivers/hv/hv_common.c b/drivers/hv/hv_common.c
> index 9c452bfbd571..9ea05cbbf50d 100644
> --- a/drivers/hv/hv_common.c
> +++ b/drivers/hv/hv_common.c
> @@ -28,7 +28,7 @@
>  #include <linux/slab.h>
>  #include <linux/dma-map-ops.h>
>  #include <linux/set_memory.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
>  #include <asm/mshyperv.h>
> 
>  /*
> diff --git a/drivers/hv/hv_kvp.c b/drivers/hv/hv_kvp.c
> index d35b60c06114..bfb7a518b4ed 100644
> --- a/drivers/hv/hv_kvp.c
> +++ b/drivers/hv/hv_kvp.c
> @@ -27,7 +27,7 @@
>  #include <linux/connector.h>
>  #include <linux/workqueue.h>
>  #include <linux/hyperv.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  #include "hyperv_vmbus.h"
>  #include "hv_utils_transport.h"
> diff --git a/drivers/hv/hv_snapshot.c b/drivers/hv/hv_snapshot.c
> index 0d2184be1691..097ebd58f14e 100644
> --- a/drivers/hv/hv_snapshot.c
> +++ b/drivers/hv/hv_snapshot.c
> @@ -12,7 +12,7 @@
>  #include <linux/connector.h>
>  #include <linux/workqueue.h>
>  #include <linux/hyperv.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  #include "hyperv_vmbus.h"
>  #include "hv_utils_transport.h"
> diff --git a/drivers/hv/hyperv_vmbus.h b/drivers/hv/hyperv_vmbus.h
> index 76ac5185a01a..2bea654858e3 100644
> --- a/drivers/hv/hyperv_vmbus.h
> +++ b/drivers/hv/hyperv_vmbus.h
> @@ -15,10 +15,10 @@
>  #include <linux/list.h>
>  #include <linux/bitops.h>
>  #include <asm/sync_bitops.h>
> -#include <asm/hyperv-tlfs.h>
>  #include <linux/atomic.h>
>  #include <linux/hyperv.h>
>  #include <linux/interrupt.h>
> +#include <hyperv/hvhdk.h>
> 
>  #include "hv_trace.h"
> 
> diff --git a/include/asm-generic/mshyperv.h b/include/asm-generic/mshyperv.h
> index 8fe7aaab2599..138e416a0f9c 100644
> --- a/include/asm-generic/mshyperv.h
> +++ b/include/asm-generic/mshyperv.h
> @@ -25,7 +25,7 @@
>  #include <linux/cpumask.h>
>  #include <linux/nmi.h>
>  #include <asm/ptrace.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  #define VTPM_BASE_ADDRESS 0xfed40000
> 
> diff --git a/include/clocksource/hyperv_timer.h b/include/clocksource/hyperv_timer.h
> index 6cdc873ac907..a4c81a60f53d 100644
> --- a/include/clocksource/hyperv_timer.h
> +++ b/include/clocksource/hyperv_timer.h
> @@ -15,7 +15,7 @@
> 
>  #include <linux/clocksource.h>
>  #include <linux/math64.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  #define HV_MAX_MAX_DELTA_TICKS 0xffffffff
>  #define HV_MIN_DELTA_TICKS 1
> diff --git a/include/linux/hyperv.h b/include/linux/hyperv.h
> index d0893ec488ae..ed65b20defea 100644
> --- a/include/linux/hyperv.h
> +++ b/include/linux/hyperv.h
> @@ -24,7 +24,7 @@
>  #include <linux/mod_devicetable.h>
>  #include <linux/interrupt.h>
>  #include <linux/reciprocal_div.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  #define MAX_PAGE_BUFFER_COUNT				32
>  #define MAX_MULTIPAGE_BUFFER_COUNT			32 /* 128K */
> diff --git a/net/vmw_vsock/hyperv_transport.c b/net/vmw_vsock/hyperv_transport.c
> index e2157e387217..152b6ed8877d 100644
> --- a/net/vmw_vsock/hyperv_transport.c
> +++ b/net/vmw_vsock/hyperv_transport.c
> @@ -13,7 +13,7 @@
>  #include <linux/hyperv.h>
>  #include <net/sock.h>
>  #include <net/af_vsock.h>
> -#include <asm/hyperv-tlfs.h>
> +#include <hyperv/hvhdk.h>
> 
>  /* Older (VMBUS version 'VERSION_WIN10' or before) Windows hosts have some
>   * stricter requirements on the hv_sock ring buffer size of six 4K pages.
> --
> 2.34.1

Re: [PATCH v2 4/4] hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h

[Nuno Das Neves]

On 11/10/2024 8:13 PM, Michael Kelley wrote:
> From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
>>
>> Switch to using hvhdk.h everywhere in the kernel. This header includes
>> all the new Hyper-V headers in include/hyperv, which form a superset of
>> the definitions found in hyperv-tlfs.h.
>>
>> This makes it easier to add new Hyper-V interfaces without being
>> restricted to those in the TLFS doc (reflected in hyperv-tlfs.h).
>>
>> To be more consistent with the original Hyper-V code, the names of some
>> definitions are changed slightly. Update those where needed.
>>
>> hyperv-tlfs.h is no longer included anywhere - hvhdk.h can serve
>> the same role, but with an easier path for adding new definitions.
> 
> Is hyperv-tlfs.h and friends being deleted? If not, the risk is that
> someone adds a new #include of it without realizing that it has been
> superseded by hvhdk.h.
> 

I was hesitant to delete it because I thought someone may still have
a use for a header file that (mostly) reflects the TLFS document and
nothing more.

But in practical terms, this patchset makes it much more difficult to
use because all the helper code (i.e. mshyperv.h) now uses hvhdk.h.
So, maybe there is no point keeping it.

> Note also that this patch does not apply cleanly to 6.12 rc's, or to
> current linux-next trees. There's an unrelated #include added to
> arch/x86/include/asm/kvm_host.h that causes a merge failure
> in that file.
> 

I've been developing this series based on hyperv-next. Should I be
basing it on linux-next?

> Michael
> 
>>
>> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
>> ---
>>  arch/arm64/hyperv/hv_core.c        |  2 +-
>>  arch/arm64/hyperv/mshyperv.c       |  4 ++--
>>  arch/arm64/include/asm/mshyperv.h  |  2 +-
>>  arch/x86/hyperv/hv_init.c          | 20 ++++++++++----------
>>  arch/x86/hyperv/hv_proc.c          |  2 +-
>>  arch/x86/hyperv/nested.c           |  2 +-
>>  arch/x86/include/asm/kvm_host.h    |  2 +-
>>  arch/x86/include/asm/mshyperv.h    |  2 +-
>>  arch/x86/include/asm/svm.h         |  2 +-
>>  arch/x86/kernel/cpu/mshyperv.c     |  2 +-
>>  arch/x86/kvm/vmx/hyperv_evmcs.h    |  2 +-
>>  arch/x86/kvm/vmx/vmx_onhyperv.h    |  2 +-
>>  drivers/clocksource/hyperv_timer.c |  2 +-
>>  drivers/hv/hv_balloon.c            |  4 ++--
>>  drivers/hv/hv_common.c             |  2 +-
>>  drivers/hv/hv_kvp.c                |  2 +-
>>  drivers/hv/hv_snapshot.c           |  2 +-
>>  drivers/hv/hyperv_vmbus.h          |  2 +-
>>  include/asm-generic/mshyperv.h     |  2 +-
>>  include/clocksource/hyperv_timer.h |  2 +-
>>  include/linux/hyperv.h             |  2 +-
>>  net/vmw_vsock/hyperv_transport.c   |  2 +-
>>  22 files changed, 33 insertions(+), 33 deletions(-)
>>
>> diff --git a/arch/arm64/hyperv/hv_core.c b/arch/arm64/hyperv/hv_core.c
>> index 7a746a5a6b42..69004f619c57 100644
>> --- a/arch/arm64/hyperv/hv_core.c
>> +++ b/arch/arm64/hyperv/hv_core.c
>> @@ -14,7 +14,7 @@
>>  #include <linux/arm-smccc.h>
>>  #include <linux/module.h>
>>  #include <asm-generic/bug.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>  #include <asm/mshyperv.h>
>>
>>  /*
>> diff --git a/arch/arm64/hyperv/mshyperv.c b/arch/arm64/hyperv/mshyperv.c
>> index b1a4de4eee29..fc49949b7df6 100644
>> --- a/arch/arm64/hyperv/mshyperv.c
>> +++ b/arch/arm64/hyperv/mshyperv.c
>> @@ -49,12 +49,12 @@ static int __init hyperv_init(void)
>>  	hv_set_vpreg(HV_REGISTER_GUEST_OS_ID, guest_id);
>>
>>  	/* Get the features and hints from Hyper-V */
>> -	hv_get_vpreg_128(HV_REGISTER_FEATURES, &result);
>> +	hv_get_vpreg_128(HV_REGISTER_PRIVILEGES_AND_FEATURES_INFO, &result);
>>  	ms_hyperv.features = result.as32.a;
>>  	ms_hyperv.priv_high = result.as32.b;
>>  	ms_hyperv.misc_features = result.as32.c;
>>
>> -	hv_get_vpreg_128(HV_REGISTER_ENLIGHTENMENTS, &result);
>> +	hv_get_vpreg_128(HV_REGISTER_FEATURES_INFO, &result);
>>  	ms_hyperv.hints = result.as32.a;
>>
>>  	pr_info("Hyper-V: privilege flags low 0x%x, high 0x%x, hints 0x%x, misc
>> 0x%x\n",
>> diff --git a/arch/arm64/include/asm/mshyperv.h
>> b/arch/arm64/include/asm/mshyperv.h
>> index a975e1a689dd..7595fb35fae6 100644
>> --- a/arch/arm64/include/asm/mshyperv.h
>> +++ b/arch/arm64/include/asm/mshyperv.h
>> @@ -20,7 +20,7 @@
>>
>>  #include <linux/types.h>
>>  #include <linux/arm-smccc.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  /*
>>   * Declare calls to get and set Hyper-V VP register values on ARM64, which
>> diff --git a/arch/x86/hyperv/hv_init.c b/arch/x86/hyperv/hv_init.c
>> index 1a6354b3e582..3f9aef157c88 100644
>> --- a/arch/x86/hyperv/hv_init.c
>> +++ b/arch/x86/hyperv/hv_init.c
>> @@ -19,7 +19,7 @@
>>  #include <asm/sev.h>
>>  #include <asm/ibt.h>
>>  #include <asm/hypervisor.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>  #include <asm/mshyperv.h>
>>  #include <asm/idtentry.h>
>>  #include <asm/set_memory.h>
>> @@ -416,24 +416,24 @@ static void __init hv_get_partition_id(void)
>>  static u8 __init get_vtl(void)
>>  {
>>  	u64 control = HV_HYPERCALL_REP_COMP_1 | HVCALL_GET_VP_REGISTERS;
>> -	struct hv_get_vp_registers_input *input;
>> -	struct hv_get_vp_registers_output *output;
>> +	struct hv_input_get_vp_registers *input;
>> +	struct hv_register_assoc *output;
>>  	unsigned long flags;
>>  	u64 ret;
>>
>>  	local_irq_save(flags);
>>  	input = *this_cpu_ptr(hyperv_pcpu_input_arg);
>> -	output = (struct hv_get_vp_registers_output *)input;
>> +	output = (struct hv_register_assoc *)input;
>>
>> -	memset(input, 0, struct_size(input, element, 1));
>> -	input->header.partitionid = HV_PARTITION_ID_SELF;
>> -	input->header.vpindex = HV_VP_INDEX_SELF;
>> -	input->header.inputvtl = 0;
>> -	input->element[0].name0 = HV_X64_REGISTER_VSM_VP_STATUS;
>> +	memset(input, 0, struct_size(input, names, 1));
>> +	input->partition_id = HV_PARTITION_ID_SELF;
>> +	input->vp_index = HV_VP_INDEX_SELF;
>> +	input->input_vtl.as_uint8 = 0;
>> +	input->names[0] = HV_X64_REGISTER_VSM_VP_STATUS;
>>
>>  	ret = hv_do_hypercall(control, input, output);
>>  	if (hv_result_success(ret)) {
>> -		ret = output->as64.low & HV_X64_VTL_MASK;
>> +		ret = output->value.reg8 & HV_X64_VTL_MASK;
>>  	} else {
>>  		pr_err("Failed to get VTL(error: %lld) exiting...\n", ret);
>>  		BUG();
>> diff --git a/arch/x86/hyperv/hv_proc.c b/arch/x86/hyperv/hv_proc.c
>> index b74c06c04ff1..ac4c834d4435 100644
>> --- a/arch/x86/hyperv/hv_proc.c
>> +++ b/arch/x86/hyperv/hv_proc.c
>> @@ -176,7 +176,7 @@ int hv_call_create_vp(int node, u64 partition_id, u32 vp_index,
>> u32 flags)
>>  		input->partition_id = partition_id;
>>  		input->vp_index = vp_index;
>>  		input->flags = flags;
>> -		input->subnode_type = HvSubnodeAny;
>> +		input->subnode_type = HV_SUBNODE_ANY;
>>  		input->proximity_domain_info = hv_numa_node_to_pxm_info(node);
>>  		status = hv_do_hypercall(HVCALL_CREATE_VP, input, NULL);
>>  		local_irq_restore(irq_flags);
>> diff --git a/arch/x86/hyperv/nested.c b/arch/x86/hyperv/nested.c
>> index 9dc259fa322e..1083dc8646f9 100644
>> --- a/arch/x86/hyperv/nested.c
>> +++ b/arch/x86/hyperv/nested.c
>> @@ -11,7 +11,7 @@
>>
>>
>>  #include <linux/types.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>  #include <asm/mshyperv.h>
>>  #include <asm/tlbflush.h>
>>
>> diff --git a/arch/x86/include/asm/kvm_host.h b/arch/x86/include/asm/kvm_host.h
>> index 3627eab994a3..38cd609f37c7 100644
>> --- a/arch/x86/include/asm/kvm_host.h
>> +++ b/arch/x86/include/asm/kvm_host.h
>> @@ -34,7 +34,7 @@
>>  #include <asm/asm.h>
>>  #include <asm/kvm_page_track.h>
>>  #include <asm/kvm_vcpu_regs.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #define __KVM_HAVE_ARCH_VCPU_DEBUGFS
>>
>> diff --git a/arch/x86/include/asm/mshyperv.h b/arch/x86/include/asm/mshyperv.h
>> index 47ca48062547..f0564e599b7f 100644
>> --- a/arch/x86/include/asm/mshyperv.h
>> +++ b/arch/x86/include/asm/mshyperv.h
>> @@ -6,9 +6,9 @@
>>  #include <linux/nmi.h>
>>  #include <linux/msi.h>
>>  #include <linux/io.h>
>> -#include <asm/hyperv-tlfs.h>
>>  #include <asm/nospec-branch.h>
>>  #include <asm/paravirt.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  /*
>>   * Hyper-V always provides a single IO-APIC at this MMIO address.
>> diff --git a/arch/x86/include/asm/svm.h b/arch/x86/include/asm/svm.h
>> index f0dea3750ca9..913af68ad660 100644
>> --- a/arch/x86/include/asm/svm.h
>> +++ b/arch/x86/include/asm/svm.h
>> @@ -5,7 +5,7 @@
>>  #include <uapi/asm/svm.h>
>>  #include <uapi/asm/kvm.h>
>>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  /*
>>   * 32-bit intercept words in the VMCB Control Area, starting
>> diff --git a/arch/x86/kernel/cpu/mshyperv.c b/arch/x86/kernel/cpu/mshyperv.c
>> index e0fd57a8ba84..be0d1f4491d9 100644
>> --- a/arch/x86/kernel/cpu/mshyperv.c
>> +++ b/arch/x86/kernel/cpu/mshyperv.c
>> @@ -20,7 +20,7 @@
>>  #include <linux/random.h>
>>  #include <asm/processor.h>
>>  #include <asm/hypervisor.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>  #include <asm/mshyperv.h>
>>  #include <asm/desc.h>
>>  #include <asm/idtentry.h>
>> diff --git a/arch/x86/kvm/vmx/hyperv_evmcs.h b/arch/x86/kvm/vmx/hyperv_evmcs.h
>> index a543fccfc574..6536290f4274 100644
>> --- a/arch/x86/kvm/vmx/hyperv_evmcs.h
>> +++ b/arch/x86/kvm/vmx/hyperv_evmcs.h
>> @@ -6,7 +6,7 @@
>>  #ifndef __KVM_X86_VMX_HYPERV_EVMCS_H
>>  #define __KVM_X86_VMX_HYPERV_EVMCS_H
>>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #include "capabilities.h"
>>  #include "vmcs12.h"
>> diff --git a/arch/x86/kvm/vmx/vmx_onhyperv.h
>> b/arch/x86/kvm/vmx/vmx_onhyperv.h
>> index eb48153bfd73..2b94ff301712 100644
>> --- a/arch/x86/kvm/vmx/vmx_onhyperv.h
>> +++ b/arch/x86/kvm/vmx/vmx_onhyperv.h
>> @@ -3,7 +3,7 @@
>>  #ifndef __ARCH_X86_KVM_VMX_ONHYPERV_H__
>>  #define __ARCH_X86_KVM_VMX_ONHYPERV_H__
>>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>  #include <asm/mshyperv.h>
>>
>>  #include <linux/jump_label.h>
>> diff --git a/drivers/clocksource/hyperv_timer.c b/drivers/clocksource/hyperv_timer.c
>> index b2a080647e41..c1cc96a168c7 100644
>> --- a/drivers/clocksource/hyperv_timer.c
>> +++ b/drivers/clocksource/hyperv_timer.c
>> @@ -23,7 +23,7 @@
>>  #include <linux/acpi.h>
>>  #include <linux/hyperv.h>
>>  #include <clocksource/hyperv_timer.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>  #include <asm/mshyperv.h>
>>
>>  static struct clock_event_device __percpu *hv_clock_event;
>> diff --git a/drivers/hv/hv_balloon.c b/drivers/hv/hv_balloon.c
>> index c38dcdfcb914..d792df113962 100644
>> --- a/drivers/hv/hv_balloon.c
>> +++ b/drivers/hv/hv_balloon.c
>> @@ -28,7 +28,7 @@
>>  #include <linux/sizes.h>
>>
>>  #include <linux/hyperv.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #include <asm/mshyperv.h>
>>
>> @@ -1585,7 +1585,7 @@ static int hv_free_page_report(struct
>> page_reporting_dev_info *pr_dev_info,
>>  		return -ENOSPC;
>>  	}
>>
>> -	hint->type = HV_EXT_MEMORY_HEAT_HINT_TYPE_COLD_DISCARD;
>> +	hint->heat_type = HV_EXTMEM_HEAT_HINT_COLD_DISCARD;
>>  	hint->reserved = 0;
>>  	for_each_sg(sgl, sg, nents, i) {
>>  		union hv_gpa_page_range *range;
>> diff --git a/drivers/hv/hv_common.c b/drivers/hv/hv_common.c
>> index 9c452bfbd571..9ea05cbbf50d 100644
>> --- a/drivers/hv/hv_common.c
>> +++ b/drivers/hv/hv_common.c
>> @@ -28,7 +28,7 @@
>>  #include <linux/slab.h>
>>  #include <linux/dma-map-ops.h>
>>  #include <linux/set_memory.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>  #include <asm/mshyperv.h>
>>
>>  /*
>> diff --git a/drivers/hv/hv_kvp.c b/drivers/hv/hv_kvp.c
>> index d35b60c06114..bfb7a518b4ed 100644
>> --- a/drivers/hv/hv_kvp.c
>> +++ b/drivers/hv/hv_kvp.c
>> @@ -27,7 +27,7 @@
>>  #include <linux/connector.h>
>>  #include <linux/workqueue.h>
>>  #include <linux/hyperv.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #include "hyperv_vmbus.h"
>>  #include "hv_utils_transport.h"
>> diff --git a/drivers/hv/hv_snapshot.c b/drivers/hv/hv_snapshot.c
>> index 0d2184be1691..097ebd58f14e 100644
>> --- a/drivers/hv/hv_snapshot.c
>> +++ b/drivers/hv/hv_snapshot.c
>> @@ -12,7 +12,7 @@
>>  #include <linux/connector.h>
>>  #include <linux/workqueue.h>
>>  #include <linux/hyperv.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #include "hyperv_vmbus.h"
>>  #include "hv_utils_transport.h"
>> diff --git a/drivers/hv/hyperv_vmbus.h b/drivers/hv/hyperv_vmbus.h
>> index 76ac5185a01a..2bea654858e3 100644
>> --- a/drivers/hv/hyperv_vmbus.h
>> +++ b/drivers/hv/hyperv_vmbus.h
>> @@ -15,10 +15,10 @@
>>  #include <linux/list.h>
>>  #include <linux/bitops.h>
>>  #include <asm/sync_bitops.h>
>> -#include <asm/hyperv-tlfs.h>
>>  #include <linux/atomic.h>
>>  #include <linux/hyperv.h>
>>  #include <linux/interrupt.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #include "hv_trace.h"
>>
>> diff --git a/include/asm-generic/mshyperv.h b/include/asm-generic/mshyperv.h
>> index 8fe7aaab2599..138e416a0f9c 100644
>> --- a/include/asm-generic/mshyperv.h
>> +++ b/include/asm-generic/mshyperv.h
>> @@ -25,7 +25,7 @@
>>  #include <linux/cpumask.h>
>>  #include <linux/nmi.h>
>>  #include <asm/ptrace.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #define VTPM_BASE_ADDRESS 0xfed40000
>>
>> diff --git a/include/clocksource/hyperv_timer.h b/include/clocksource/hyperv_timer.h
>> index 6cdc873ac907..a4c81a60f53d 100644
>> --- a/include/clocksource/hyperv_timer.h
>> +++ b/include/clocksource/hyperv_timer.h
>> @@ -15,7 +15,7 @@
>>
>>  #include <linux/clocksource.h>
>>  #include <linux/math64.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #define HV_MAX_MAX_DELTA_TICKS 0xffffffff
>>  #define HV_MIN_DELTA_TICKS 1
>> diff --git a/include/linux/hyperv.h b/include/linux/hyperv.h
>> index d0893ec488ae..ed65b20defea 100644
>> --- a/include/linux/hyperv.h
>> +++ b/include/linux/hyperv.h
>> @@ -24,7 +24,7 @@
>>  #include <linux/mod_devicetable.h>
>>  #include <linux/interrupt.h>
>>  #include <linux/reciprocal_div.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  #define MAX_PAGE_BUFFER_COUNT				32
>>  #define MAX_MULTIPAGE_BUFFER_COUNT			32 /* 128K */
>> diff --git a/net/vmw_vsock/hyperv_transport.c b/net/vmw_vsock/hyperv_transport.c
>> index e2157e387217..152b6ed8877d 100644
>> --- a/net/vmw_vsock/hyperv_transport.c
>> +++ b/net/vmw_vsock/hyperv_transport.c
>> @@ -13,7 +13,7 @@
>>  #include <linux/hyperv.h>
>>  #include <net/sock.h>
>>  #include <net/af_vsock.h>
>> -#include <asm/hyperv-tlfs.h>
>> +#include <hyperv/hvhdk.h>
>>
>>  /* Older (VMBUS version 'VERSION_WIN10' or before) Windows hosts have some
>>   * stricter requirements on the hv_sock ring buffer size of six 4K pages.
>> --
>> 2.34.1

RE: [PATCH v2 4/4] hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h

[Michael Kelley]

From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Friday, November 15, 2024 1:15 PM
> 
> On 11/10/2024 8:13 PM, Michael Kelley wrote:
> > From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
> >>
> >> Switch to using hvhdk.h everywhere in the kernel. This header includes
> >> all the new Hyper-V headers in include/hyperv, which form a superset of
> >> the definitions found in hyperv-tlfs.h.
> >>
> >> This makes it easier to add new Hyper-V interfaces without being
> >> restricted to those in the TLFS doc (reflected in hyperv-tlfs.h).
> >>
> >> To be more consistent with the original Hyper-V code, the names of some
> >> definitions are changed slightly. Update those where needed.
> >>
> >> hyperv-tlfs.h is no longer included anywhere - hvhdk.h can serve
> >> the same role, but with an easier path for adding new definitions.
> >
> > Is hyperv-tlfs.h and friends being deleted? If not, the risk is that
> > someone adds a new #include of it without realizing that it has been
> > superseded by hvhdk.h.
> >
> 
> I was hesitant to delete it because I thought someone may still have
> a use for a header file that (mostly) reflects the TLFS document and
> nothing more.
> 
> But in practical terms, this patchset makes it much more difficult to
> use because all the helper code (i.e. mshyperv.h) now uses hvhdk.h.
> So, maybe there is no point keeping it.
> 
> > Note also that this patch does not apply cleanly to 6.12 rc's, or to
> > current linux-next trees. There's an unrelated #include added to
> > arch/x86/include/asm/kvm_host.h that causes a merge failure
> > in that file.
> >
> 
> I've been developing this series based on hyperv-next. Should I be
> basing it on linux-next?
> 

Yes, base it on linux-next. hyperv-next was last sync'ed with
upstream at 6.11-rc4 back in mid-August, so it's pretty far
out-of-date. Wei will need to sync it before picking up any
new patches.

Michael

Re: [PATCH v2 4/4] hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h

[Easwar Hariharan]

On 11/7/2024 2:32 PM, Nuno Das Neves wrote:
> Switch to using hvhdk.h everywhere in the kernel. This header includes
> all the new Hyper-V headers in include/hyperv, which form a superset of
> the definitions found in hyperv-tlfs.h.
> 
> This makes it easier to add new Hyper-V interfaces without being
> restricted to those in the TLFS doc (reflected in hyperv-tlfs.h).
> 
> To be more consistent with the original Hyper-V code, the names of some
> definitions are changed slightly. Update those where needed.
> 
> hyperv-tlfs.h is no longer included anywhere - hvhdk.h can serve
> the same role, but with an easier path for adding new definitions.

Michael already mentioned this, I'd also agree that it's better to
remove hyperv-tlfs.h entirely since it's been superseded.

This looks good to me, I'll wait for v3 addressing the other comments to
take a look again.

- Easwar

<...>

RE: [PATCH v2 0/4] Add new headers for Hyper-V Dom0

[Michael Kelley]

From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
> 
> To support Hyper-V Dom0 (aka Linux as root partition), many new
> definitions are required.

Using "dom0" terminology here and in the Subject: line is likely to
be confusing to folks who aren't intimately involved in Hyper-V work.
Previous Linux kernel commit messages and code for running in the
Hyper-V root partition use "root partition" terminology, and I couldn't
find "dom0" having been used before. "root partition" would be more
consistent, and it also matches the public documentation for Hyper-V.
"dom0" is Xen specific terminology, and having it show up in Hyper-V
patches would be confusing for the casual reader. I know "dom0" has
been used internally at Microsoft as shorthand for "Hyper-V root
partition", but it's probably best to completely avoid such shorthand
in public Linux kernel patches and code.

Just my $.02 ....

> 
> The plan going forward is to directly import definitions from
> Hyper-V code without waiting for them to land in the TLFS document.
> This is a quicker and more maintainable way to import definitions,
> and is a step toward the eventual goal of exporting headers directly
> from Hyper-V for use in Linux.
> 
> This patch series introduces new headers (hvhdk.h, hvgdk.h, etc,
> see patch #3) derived directly from Hyper-V code. hyperv-tlfs.h is
> replaced with hvhdk.h (which includes the other new headers)
> everywhere.
> 
> No functional change is expected.
> 
> Summary:
> Patch 1-2: Minor cleanup patches
> Patch 3: Add the new headers (hvhdk.h, etc..) in include/hyperv/
> Patch 4: Switch to the new headers
> 
> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> ---
> Changelog:
> v2:
> - Rework the series to simply use the new headers everywhere
>   instead of fiddling around to keep hyperv-tlfs.h used in some
>   places, suggested by Michael Kelley and Easwar Hariharan

Thanks! That should be simpler all around.

Michael

> - Fix compilation errors with some configs by adding missing
>   definitions and changing some names, thanks to Simon Horman for
>   catching those
> - Add additional definitions to the new headers to support them now
>   replacing hyperv-tlfs.h everywhere
> - Add additional context in the commit messages for patches #3 and #4
> - In patch #2, don't remove indirect includes. Only remove includes
>   which truly aren't used, suggested by Michael Kelley
> 
> ---
> Nuno Das Neves (4):
>   hyperv: Move hv_connection_id to hyperv-tlfs.h
>   hyperv: Clean up unnecessary #includes
>   hyperv: Add new Hyper-V headers in include/hyperv
>   hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h
> 
>  arch/arm64/hyperv/hv_core.c        |    3 +-
>  arch/arm64/hyperv/mshyperv.c       |    4 +-
>  arch/arm64/include/asm/mshyperv.h  |    2 +-
>  arch/x86/hyperv/hv_apic.c          |    1 -
>  arch/x86/hyperv/hv_init.c          |   21 +-
>  arch/x86/hyperv/hv_proc.c          |    3 +-
>  arch/x86/hyperv/ivm.c              |    1 -
>  arch/x86/hyperv/mmu.c              |    1 -
>  arch/x86/hyperv/nested.c           |    2 +-
>  arch/x86/include/asm/kvm_host.h    |    3 +-
>  arch/x86/include/asm/mshyperv.h    |    3 +-
>  arch/x86/include/asm/svm.h         |    2 +-
>  arch/x86/kernel/cpu/mshyperv.c     |    2 +-
>  arch/x86/kvm/vmx/hyperv_evmcs.h    |    2 +-
>  arch/x86/kvm/vmx/vmx_onhyperv.h    |    2 +-
>  arch/x86/mm/pat/set_memory.c       |    2 -
>  drivers/clocksource/hyperv_timer.c |    2 +-
>  drivers/hv/hv_balloon.c            |    4 +-
>  drivers/hv/hv_common.c             |    2 +-
>  drivers/hv/hv_kvp.c                |    2 +-
>  drivers/hv/hv_snapshot.c           |    2 +-
>  drivers/hv/hyperv_vmbus.h          |    2 +-
>  include/asm-generic/hyperv-tlfs.h  |    9 +
>  include/asm-generic/mshyperv.h     |    2 +-
>  include/clocksource/hyperv_timer.h |    2 +-
>  include/hyperv/hvgdk.h             |  303 +++++++
>  include/hyperv/hvgdk_ext.h         |   46 +
>  include/hyperv/hvgdk_mini.h        | 1295 ++++++++++++++++++++++++++++
>  include/hyperv/hvhdk.h             |  733 ++++++++++++++++
>  include/hyperv/hvhdk_mini.h        |  310 +++++++
>  include/linux/hyperv.h             |   11 +-
>  net/vmw_vsock/hyperv_transport.c   |    2 +-
>  32 files changed, 2729 insertions(+), 52 deletions(-)
>  create mode 100644 include/hyperv/hvgdk.h
>  create mode 100644 include/hyperv/hvgdk_ext.h
>  create mode 100644 include/hyperv/hvgdk_mini.h
>  create mode 100644 include/hyperv/hvhdk.h
>  create mode 100644 include/hyperv/hvhdk_mini.h
> 
> --
> 2.34.1

Re: [PATCH v2 0/4] Add new headers for Hyper-V Dom0

[Nuno Das Neves]

On 11/10/2024 8:12 PM, Michael Kelley wrote:
> From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
>>
>> To support Hyper-V Dom0 (aka Linux as root partition), many new
>> definitions are required.
> 
> Using "dom0" terminology here and in the Subject: line is likely to
> be confusing to folks who aren't intimately involved in Hyper-V work.
> Previous Linux kernel commit messages and code for running in the
> Hyper-V root partition use "root partition" terminology, and I couldn't
> find "dom0" having been used before. "root partition" would be more
> consistent, and it also matches the public documentation for Hyper-V.
> "dom0" is Xen specific terminology, and having it show up in Hyper-V
> patches would be confusing for the casual reader. I know "dom0" has
> been used internally at Microsoft as shorthand for "Hyper-V root
> partition", but it's probably best to completely avoid such shorthand
> in public Linux kernel patches and code.
> 
> Just my $.02 ....
> 

Noted - I will update the terminology in v3 and generally avoid "Dom0",
except possibly by way of explanation (i.e. to compare it to Xen Dom0).

Thanks
Nuno

>>
>> The plan going forward is to directly import definitions from
>> Hyper-V code without waiting for them to land in the TLFS document.
>> This is a quicker and more maintainable way to import definitions,
>> and is a step toward the eventual goal of exporting headers directly
>> from Hyper-V for use in Linux.
>>
>> This patch series introduces new headers (hvhdk.h, hvgdk.h, etc,
>> see patch #3) derived directly from Hyper-V code. hyperv-tlfs.h is
>> replaced with hvhdk.h (which includes the other new headers)
>> everywhere.
>>
>> No functional change is expected.
>>
>> Summary:
>> Patch 1-2: Minor cleanup patches
>> Patch 3: Add the new headers (hvhdk.h, etc..) in include/hyperv/
>> Patch 4: Switch to the new headers
>>
>> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
>> ---
>> Changelog:
>> v2:
>> - Rework the series to simply use the new headers everywhere
>>   instead of fiddling around to keep hyperv-tlfs.h used in some
>>   places, suggested by Michael Kelley and Easwar Hariharan
> 
> Thanks! That should be simpler all around.
> 
> Michael
> 
>> - Fix compilation errors with some configs by adding missing
>>   definitions and changing some names, thanks to Simon Horman for
>>   catching those
>> - Add additional definitions to the new headers to support them now
>>   replacing hyperv-tlfs.h everywhere
>> - Add additional context in the commit messages for patches #3 and #4
>> - In patch #2, don't remove indirect includes. Only remove includes
>>   which truly aren't used, suggested by Michael Kelley
>>
>> ---
>> Nuno Das Neves (4):
>>   hyperv: Move hv_connection_id to hyperv-tlfs.h
>>   hyperv: Clean up unnecessary #includes
>>   hyperv: Add new Hyper-V headers in include/hyperv
>>   hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h
>>
>>  arch/arm64/hyperv/hv_core.c        |    3 +-
>>  arch/arm64/hyperv/mshyperv.c       |    4 +-
>>  arch/arm64/include/asm/mshyperv.h  |    2 +-
>>  arch/x86/hyperv/hv_apic.c          |    1 -
>>  arch/x86/hyperv/hv_init.c          |   21 +-
>>  arch/x86/hyperv/hv_proc.c          |    3 +-
>>  arch/x86/hyperv/ivm.c              |    1 -
>>  arch/x86/hyperv/mmu.c              |    1 -
>>  arch/x86/hyperv/nested.c           |    2 +-
>>  arch/x86/include/asm/kvm_host.h    |    3 +-
>>  arch/x86/include/asm/mshyperv.h    |    3 +-
>>  arch/x86/include/asm/svm.h         |    2 +-
>>  arch/x86/kernel/cpu/mshyperv.c     |    2 +-
>>  arch/x86/kvm/vmx/hyperv_evmcs.h    |    2 +-
>>  arch/x86/kvm/vmx/vmx_onhyperv.h    |    2 +-
>>  arch/x86/mm/pat/set_memory.c       |    2 -
>>  drivers/clocksource/hyperv_timer.c |    2 +-
>>  drivers/hv/hv_balloon.c            |    4 +-
>>  drivers/hv/hv_common.c             |    2 +-
>>  drivers/hv/hv_kvp.c                |    2 +-
>>  drivers/hv/hv_snapshot.c           |    2 +-
>>  drivers/hv/hyperv_vmbus.h          |    2 +-
>>  include/asm-generic/hyperv-tlfs.h  |    9 +
>>  include/asm-generic/mshyperv.h     |    2 +-
>>  include/clocksource/hyperv_timer.h |    2 +-
>>  include/hyperv/hvgdk.h             |  303 +++++++
>>  include/hyperv/hvgdk_ext.h         |   46 +
>>  include/hyperv/hvgdk_mini.h        | 1295 ++++++++++++++++++++++++++++
>>  include/hyperv/hvhdk.h             |  733 ++++++++++++++++
>>  include/hyperv/hvhdk_mini.h        |  310 +++++++
>>  include/linux/hyperv.h             |   11 +-
>>  net/vmw_vsock/hyperv_transport.c   |    2 +-
>>  32 files changed, 2729 insertions(+), 52 deletions(-)
>>  create mode 100644 include/hyperv/hvgdk.h
>>  create mode 100644 include/hyperv/hvgdk_ext.h
>>  create mode 100644 include/hyperv/hvgdk_mini.h
>>  create mode 100644 include/hyperv/hvhdk.h
>>  create mode 100644 include/hyperv/hvhdk_mini.h
>>
>> --
>> 2.34.1

RE: [PATCH v2 0/4] Add new headers for Hyper-V Dom0

[Michael Kelley]

From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Monday, November 11, 2024 10:00 AM
> 
> On 11/10/2024 8:12 PM, Michael Kelley wrote:
> > From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: Thursday, November 7, 2024 2:32 PM
> >>
> >> To support Hyper-V Dom0 (aka Linux as root partition), many new
> >> definitions are required.
> >
> > Using "dom0" terminology here and in the Subject: line is likely to
> > be confusing to folks who aren't intimately involved in Hyper-V work.
> > Previous Linux kernel commit messages and code for running in the
> > Hyper-V root partition use "root partition" terminology, and I couldn't
> > find "dom0" having been used before. "root partition" would be more
> > consistent, and it also matches the public documentation for Hyper-V.
> > "dom0" is Xen specific terminology, and having it show up in Hyper-V
> > patches would be confusing for the casual reader. I know "dom0" has
> > been used internally at Microsoft as shorthand for "Hyper-V root
> > partition", but it's probably best to completely avoid such shorthand
> > in public Linux kernel patches and code.
> >
> > Just my $.02 ....
> >
> 
> Noted - I will update the terminology in v3 and generally avoid "Dom0",
> except possibly by way of explanation (i.e. to compare it to Xen Dom0).

Yes, I'm good with comparing the Hyper-V root partition to Xen dom0 as
part of an explanation.

Michael

> 
> Thanks
> Nuno
> 
> >>
> >> The plan going forward is to directly import definitions from
> >> Hyper-V code without waiting for them to land in the TLFS document.
> >> This is a quicker and more maintainable way to import definitions,
> >> and is a step toward the eventual goal of exporting headers directly
> >> from Hyper-V for use in Linux.
> >>
> >> This patch series introduces new headers (hvhdk.h, hvgdk.h, etc,
> >> see patch #3) derived directly from Hyper-V code. hyperv-tlfs.h is
> >> replaced with hvhdk.h (which includes the other new headers)
> >> everywhere.
> >>
> >> No functional change is expected.
> >>
> >> Summary:
> >> Patch 1-2: Minor cleanup patches
> >> Patch 3: Add the new headers (hvhdk.h, etc..) in include/hyperv/
> >> Patch 4: Switch to the new headers
> >>
> >> Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
> >> ---
> >> Changelog:
> >> v2:
> >> - Rework the series to simply use the new headers everywhere
> >>   instead of fiddling around to keep hyperv-tlfs.h used in some
> >>   places, suggested by Michael Kelley and Easwar Hariharan
> >
> > Thanks! That should be simpler all around.
> >
> > Michael
> >
> >> - Fix compilation errors with some configs by adding missing
> >>   definitions and changing some names, thanks to Simon Horman for
> >>   catching those
> >> - Add additional definitions to the new headers to support them now
> >>   replacing hyperv-tlfs.h everywhere
> >> - Add additional context in the commit messages for patches #3 and #4
> >> - In patch #2, don't remove indirect includes. Only remove includes
> >>   which truly aren't used, suggested by Michael Kelley
> >>
> >> ---
> >> Nuno Das Neves (4):
> >>   hyperv: Move hv_connection_id to hyperv-tlfs.h
> >>   hyperv: Clean up unnecessary #includes
> >>   hyperv: Add new Hyper-V headers in include/hyperv
> >>   hyperv: Switch from hyperv-tlfs.h to hyperv/hvhdk.h
> >>
> >>  arch/arm64/hyperv/hv_core.c        |    3 +-
> >>  arch/arm64/hyperv/mshyperv.c       |    4 +-
> >>  arch/arm64/include/asm/mshyperv.h  |    2 +-
> >>  arch/x86/hyperv/hv_apic.c          |    1 -
> >>  arch/x86/hyperv/hv_init.c          |   21 +-
> >>  arch/x86/hyperv/hv_proc.c          |    3 +-
> >>  arch/x86/hyperv/ivm.c              |    1 -
> >>  arch/x86/hyperv/mmu.c              |    1 -
> >>  arch/x86/hyperv/nested.c           |    2 +-
> >>  arch/x86/include/asm/kvm_host.h    |    3 +-
> >>  arch/x86/include/asm/mshyperv.h    |    3 +-
> >>  arch/x86/include/asm/svm.h         |    2 +-
> >>  arch/x86/kernel/cpu/mshyperv.c     |    2 +-
> >>  arch/x86/kvm/vmx/hyperv_evmcs.h    |    2 +-
> >>  arch/x86/kvm/vmx/vmx_onhyperv.h    |    2 +-
> >>  arch/x86/mm/pat/set_memory.c       |    2 -
> >>  drivers/clocksource/hyperv_timer.c |    2 +-
> >>  drivers/hv/hv_balloon.c            |    4 +-
> >>  drivers/hv/hv_common.c             |    2 +-
> >>  drivers/hv/hv_kvp.c                |    2 +-
> >>  drivers/hv/hv_snapshot.c           |    2 +-
> >>  drivers/hv/hyperv_vmbus.h          |    2 +-
> >>  include/asm-generic/hyperv-tlfs.h  |    9 +
> >>  include/asm-generic/mshyperv.h     |    2 +-
> >>  include/clocksource/hyperv_timer.h |    2 +-
> >>  include/hyperv/hvgdk.h             |  303 +++++++
> >>  include/hyperv/hvgdk_ext.h         |   46 +
> >>  include/hyperv/hvgdk_mini.h        | 1295 ++++++++++++++++++++++++++++
> >>  include/hyperv/hvhdk.h             |  733 ++++++++++++++++
> >>  include/hyperv/hvhdk_mini.h        |  310 +++++++
> >>  include/linux/hyperv.h             |   11 +-
> >>  net/vmw_vsock/hyperv_transport.c   |    2 +-
> >>  32 files changed, 2729 insertions(+), 52 deletions(-)
> >>  create mode 100644 include/hyperv/hvgdk.h
> >>  create mode 100644 include/hyperv/hvgdk_ext.h
> >>  create mode 100644 include/hyperv/hvgdk_mini.h
> >>  create mode 100644 include/hyperv/hvhdk.h
> >>  create mode 100644 include/hyperv/hvhdk_mini.h
> >>
> >> --
> >> 2.34.1

Re: [EXTERNAL] RE: [PATCH v2 0/4] Add new headers for Hyper-V Dom0

[MUKESH RATHOR]

On 11/10/24 20:12, Michael Kelley wrote:
 > From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent: 
Thursday, November 7, 2024 2:32 PM
 >>
 >> To support Hyper-V Dom0 (aka Linux as root partition), many new
 >> definitions are required.
 >
 > Using "dom0" terminology here and in the Subject: line is likely to
 > be confusing to folks who aren't intimately involved in Hyper-V work.
 > Previous Linux kernel commit messages and code for running in the
 > Hyper-V root partition use "root partition" terminology, and I couldn't
 > find "dom0" having been used before. "root partition" would be more
 > consistent, and it also matches the public documentation for Hyper-V.
 > "dom0" is Xen specific terminology, and having it show up in Hyper-V
 > patches would be confusing for the casual reader. I know "dom0" has
 > been used internally at Microsoft as shorthand for "Hyper-V root
 > partition", but it's probably best to completely avoid such shorthand
 > in public Linux kernel patches and code.
 >
 > Just my $.02 ....

Hi Michael,

FWIW, hyperv team and us are using the term "dom0" more and more to
avoid confusion between windows root and linux root, as dom0 is
always linux root. I did a quick search, and "dom0" is neither
copyrighted nor trademarked by xen, and I'm sure the fine folks
there won't be offended. Hopefully, [Hyper-V] tag would reduce
the confusion.

Just my $0.1

Thanks,
-Mukesh

RE: [EXTERNAL] RE: [PATCH v2 0/4] Add new headers for Hyper-V Dom0

[Michael Kelley]

From: MUKESH RATHOR <mukeshrathor@microsoft.com> Sent: Monday, November 11, 2024 10:53 AM
> 
> On 11/10/24 20:12, Michael Kelley wrote:
>  > From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent:
> Thursday, November 7, 2024 2:32 PM
>  >>
>  >> To support Hyper-V Dom0 (aka Linux as root partition), many new
>  >> definitions are required.
>  >
>  > Using "dom0" terminology here and in the Subject: line is likely to
>  > be confusing to folks who aren't intimately involved in Hyper-V work.
>  > Previous Linux kernel commit messages and code for running in the
>  > Hyper-V root partition use "root partition" terminology, and I couldn't
>  > find "dom0" having been used before. "root partition" would be more
>  > consistent, and it also matches the public documentation for Hyper-V.
>  > "dom0" is Xen specific terminology, and having it show up in Hyper-V
>  > patches would be confusing for the casual reader. I know "dom0" has
>  > been used internally at Microsoft as shorthand for "Hyper-V root
>  > partition", but it's probably best to completely avoid such shorthand
>  > in public Linux kernel patches and code.
>  >
>  > Just my $.02 ....
> 
> Hi Michael,
> 
> FWIW, hyperv team and us are using the term "dom0" more and more to
> avoid confusion between windows root and linux root, as dom0 is
> always linux root. I did a quick search, and "dom0" is neither
> copyrighted nor trademarked by xen, and I'm sure the fine folks
> there won't be offended. Hopefully, [Hyper-V] tag would reduce
> the confusion.
> 
> Just my $0.1
> 

Yeah, "dom0" certainly fits as shorthand for the rather ponderous
"Linux running in a Hyper-V root partition". :-)

But even using "Hyper-V dom0" to add clarity vs. Xen dom0 seems
to me to be a misnomer because Hyper-V dom0 is only conceptually
like Xen dom0. It's not actually an implementation of Xen dom0.
Let me give two examples:

1) Hyper-V provides VMBus, which is conceptually similar to virtio.
But VMBus is not an implementation of virtio, and we don't call it
"Hyper-V virtio".  Of course, "VMBus" is a lot shorter than "Hyper-V
root partition" so the motivation for a shorthand isn't there, but still.
If Hyper-V should ever implement actual virtio interfaces, then it
would be valid to call that "Hyper-V virtio".

2) KVM has "KVM Hyper-V", which I think is valid. It's an
implementation of Hyper-V interfaces in KVM so that Windows
guests can run as if they are running on Hyper-V.

I won't speculate on what the Xen folks would think of "Hyper-V
dom0", especially if it isn't an implementation that's compatible
with Xen dom0 functionality.

As for "more and more" usage of "dom0" by your team and the
Hyper-V team:  Is that internal usage only? Or usage in public mailing
lists or open source projects like Cloud Hypervisor? Again, from
my standpoint, internal is internal and can be whatever is convenient
and properly understood internally. But in public mailing lists and
projects, I think "Hyper-V dom0" should be avoided unless it's
truly an implementation of the dom0 interfaces.

That's probably now $0.10 worth instead of $0.02. :-) And I'm
not the decider here -- I'm just offering a perspective.

Michael

Re: [EXTERNAL] RE: [PATCH v2 0/4] Add new headers for Hyper-V Dom0

[MUKESH RATHOR]

On 11/11/24 13:28, Michael Kelley wrote:
 > From: MUKESH RATHOR <mukeshrathor@microsoft.com> Sent: Monday, 
November 11, 2024 10:53 AM
 >>
 >> On 11/10/24 20:12, Michael Kelley wrote:
 >>   > From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent:
 >> Thursday, November 7, 2024 2:32 PM
 >>   >>
 >>   >> To support Hyper-V Dom0 (aka Linux as root partition), many new
 >>   >> definitions are required.
 >>   >
 >>   > Using "dom0" terminology here and in the Subject: line is likely to
 >>   > be confusing to folks who aren't intimately involved in Hyper-V 
work.
 >>   > Previous Linux kernel commit messages and code for running in the
 >>   > Hyper-V root partition use "root partition" terminology, and I 
couldn't
 >>   > find "dom0" having been used before. "root partition" would be more
 >>   > consistent, and it also matches the public documentation for 
Hyper-V.
 >>   > "dom0" is Xen specific terminology, and having it show up in Hyper-V
 >>   > patches would be confusing for the casual reader. I know "dom0" has
 >>   > been used internally at Microsoft as shorthand for "Hyper-V root
 >>   > partition", but it's probably best to completely avoid such 
shorthand
 >>   > in public Linux kernel patches and code.
 >>   >
 >>   > Just my $.02 ....
 >>
 >> Hi Michael,
 >>
 >> FWIW, hyperv team and us are using the term "dom0" more and more to
 >> avoid confusion between windows root and linux root, as dom0 is
 >> always linux root. I did a quick search, and "dom0" is neither
 >> copyrighted nor trademarked by xen, and I'm sure the fine folks
 >> there won't be offended. Hopefully, [Hyper-V] tag would reduce
 >> the confusion.
 >>
 >> Just my $0.1
 >>
 >
 > Yeah, "dom0" certainly fits as shorthand for the rather ponderous
 > "Linux running in a Hyper-V root partition". :-)
 >
 > But even using "Hyper-V dom0" to add clarity vs. Xen dom0 seems
 > to me to be a misnomer because Hyper-V dom0 is only conceptually
 > like Xen dom0. It's not actually an implementation of Xen dom0.
 > Let me give two examples:
 >
 > 1) Hyper-V provides VMBus, which is conceptually similar to virtio.
 > But VMBus is not an implementation of virtio, and we don't call it
 > "Hyper-V virtio".  Of course, "VMBus" is a lot shorter than "Hyper-V
 > root partition" so the motivation for a shorthand isn't there, but still.
 > If Hyper-V should ever implement actual virtio interfaces, then it
 > would be valid to call that "Hyper-V virtio".
 >
 > 2) KVM has "KVM Hyper-V", which I think is valid. It's an
 > implementation of Hyper-V interfaces in KVM so that Windows
 > guests can run as if they are running on Hyper-V.
 >
 > I won't speculate on what the Xen folks would think of "Hyper-V
 > dom0", especially if it isn't an implementation that's compatible
 > with Xen dom0 functionality.
 >
 > As for "more and more" usage of "dom0" by your team and the
 > Hyper-V team:  Is that internal usage only? Or usage in public mailing
 > lists or open source projects like Cloud Hypervisor? Again, from
 > my standpoint, internal is internal and can be whatever is convenient
 > and properly understood internally. But in public mailing lists and
 > projects, I think "Hyper-V dom0" should be avoided unless it's
 > truly an implementation of the dom0 interfaces.
 >
 > That's probably now $0.10 worth instead of $0.02. :-) And I'm
 > not the decider here -- I'm just offering a perspective.

"dom0" is neither a technology nor a protocol. It simply means initial
domain (which on xen happened to be domid of 0, could have been 1). This
is created during boot, same as linux root on hyperv, and is privileged
domain same as xen. Even in KVM world, I've heard many folks refer to
the host as kvm dom0...

Given the mix of windows and linux with l1vh and nested, dom0 is helping
in conversations internally, and I'm sure it will keep percolating
externally.

Thanks,
-Mukesh

RE: [EXTERNAL] RE: [PATCH v2 0/4] Add new headers for Hyper-V Dom0

[Michael Kelley]

From: MUKESH RATHOR <mukeshrathor@microsoft.com> Sent: Monday, November 11, 2024 3:11 PM
> 
> On 11/11/24 13:28, Michael Kelley wrote:
>  > From: MUKESH RATHOR <mukeshrathor@microsoft.com> Sent: Monday, November 11, 2024 10:53 AM
>  >>
>  >> On 11/10/24 20:12, Michael Kelley wrote:
>  >>   > From: Nuno Das Neves <nunodasneves@linux.microsoft.com> Sent:
>  >> Thursday, November 7, 2024 2:32 PM
>  >>   >>
>  >>   >> To support Hyper-V Dom0 (aka Linux as root partition), many new
>  >>   >> definitions are required.
>  >>   >
>  >>   > Using "dom0" terminology here and in the Subject: line is likely to
>  >>   > be confusing to folks who aren't intimately involved in Hyper-V work.
>  >>   > Previous Linux kernel commit messages and code for running in the
>  >>   > Hyper-V root partition use "root partition" terminology, and I couldn't
>  >>   > find "dom0" having been used before. "root partition" would be more
>  >>   > consistent, and it also matches the public documentation for Hyper-V.
>  >>   > "dom0" is Xen specific terminology, and having it show up in Hyper-V
>  >>   > patches would be confusing for the casual reader. I know "dom0" has
>  >>   > been used internally at Microsoft as shorthand for "Hyper-V root
>  >>   > partition", but it's probably best to completely avoid such shorthand
>  >>   > in public Linux kernel patches and code.
>  >>   >
>  >>   > Just my $.02 ....
>  >>
>  >> Hi Michael,
>  >>
>  >> FWIW, hyperv team and us are using the term "dom0" more and more to
>  >> avoid confusion between windows root and linux root, as dom0 is
>  >> always linux root. I did a quick search, and "dom0" is neither
>  >> copyrighted nor trademarked by xen, and I'm sure the fine folks
>  >> there won't be offended. Hopefully, [Hyper-V] tag would reduce
>  >> the confusion.
>  >>
>  >> Just my $0.1
>  >>
>  >
>  > Yeah, "dom0" certainly fits as shorthand for the rather ponderous
>  > "Linux running in a Hyper-V root partition". :-)
>  >
>  > But even using "Hyper-V dom0" to add clarity vs. Xen dom0 seems
>  > to me to be a misnomer because Hyper-V dom0 is only conceptually
>  > like Xen dom0. It's not actually an implementation of Xen dom0.
>  > Let me give two examples:
>  >
>  > 1) Hyper-V provides VMBus, which is conceptually similar to virtio.
>  > But VMBus is not an implementation of virtio, and we don't call it
>  > "Hyper-V virtio".  Of course, "VMBus" is a lot shorter than "Hyper-V
>  > root partition" so the motivation for a shorthand isn't there, but still.
>  > If Hyper-V should ever implement actual virtio interfaces, then it
>  > would be valid to call that "Hyper-V virtio".
>  >
>  > 2) KVM has "KVM Hyper-V", which I think is valid. It's an
>  > implementation of Hyper-V interfaces in KVM so that Windows
>  > guests can run as if they are running on Hyper-V.
>  >
>  > I won't speculate on what the Xen folks would think of "Hyper-V
>  > dom0", especially if it isn't an implementation that's compatible
>  > with Xen dom0 functionality.
>  >
>  > As for "more and more" usage of "dom0" by your team and the
>  > Hyper-V team:  Is that internal usage only? Or usage in public mailing
>  > lists or open source projects like Cloud Hypervisor? Again, from
>  > my standpoint, internal is internal and can be whatever is convenient
>  > and properly understood internally. But in public mailing lists and
>  > projects, I think "Hyper-V dom0" should be avoided unless it's
>  > truly an implementation of the dom0 interfaces.
>  >
>  > That's probably now $0.10 worth instead of $0.02. :-) And I'm
>  > not the decider here -- I'm just offering a perspective.
> 
> "dom0" is neither a technology nor a protocol. It simply means initial
> domain (which on xen happened to be domid of 0, could have been 1). This
> is created during boot, same as linux root on hyperv, and is privileged
> domain same as xen. Even in KVM world, I've heard many folks refer to
> the host as kvm dom0...
> 
> Given the mix of windows and linux with l1vh and nested, dom0 is helping
> in conversations internally, and I'm sure it will keep percolating
> externally.
> 

OK, fair enough. My perspective is probably more limited than
yours as my experience with "dom0" is exclusively with the Xen
code in a Linux kernel environment. I just haven't seen "dom0"
used elsewhere, but that certainly doesn't mean it's not being
done.

If the decision on the Microsoft side is that introducing "Hyper-V
dom0" terminology makes sense, I won't object further, though
I would think there should be some kind of reconciliation with
existing code/comments/documentation that uses "root partition".

Michael