xref: /linux/include/hyperv/hvgdk_mini.h (revision d62313bdf5961b5f815f0b212f029cf146a8a804)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Type definitions for the Microsoft hypervisor.
4  */
5 #ifndef _HV_HVGDK_MINI_H
6 #define _HV_HVGDK_MINI_H
7 
8 #include <linux/types.h>
9 #include <linux/bits.h>
10 
11 struct hv_u128 {
12 	u64 low_part;
13 	u64 high_part;
14 } __packed;
15 
16 /* NOTE: when adding below, update hv_result_to_string() */
17 #define HV_STATUS_SUCCESS			    0x0
18 #define HV_STATUS_INVALID_HYPERCALL_CODE	    0x2
19 #define HV_STATUS_INVALID_HYPERCALL_INPUT	    0x3
20 #define HV_STATUS_INVALID_ALIGNMENT		    0x4
21 #define HV_STATUS_INVALID_PARAMETER		    0x5
22 #define HV_STATUS_ACCESS_DENIED			    0x6
23 #define HV_STATUS_INVALID_PARTITION_STATE	    0x7
24 #define HV_STATUS_OPERATION_DENIED		    0x8
25 #define HV_STATUS_UNKNOWN_PROPERTY		    0x9
26 #define HV_STATUS_PROPERTY_VALUE_OUT_OF_RANGE	    0xA
27 #define HV_STATUS_INSUFFICIENT_MEMORY		    0xB
28 #define HV_STATUS_INVALID_PARTITION_ID		    0xD
29 #define HV_STATUS_INVALID_VP_INDEX		    0xE
30 #define HV_STATUS_NOT_FOUND			    0x10
31 #define HV_STATUS_INVALID_PORT_ID		    0x11
32 #define HV_STATUS_INVALID_CONNECTION_ID		    0x12
33 #define HV_STATUS_INSUFFICIENT_BUFFERS		    0x13
34 #define HV_STATUS_NOT_ACKNOWLEDGED		    0x14
35 #define HV_STATUS_INVALID_VP_STATE		    0x15
36 #define HV_STATUS_NO_RESOURCES			    0x1D
37 #define HV_STATUS_PROCESSOR_FEATURE_NOT_SUPPORTED   0x20
38 #define HV_STATUS_INVALID_LP_INDEX		    0x41
39 #define HV_STATUS_INVALID_REGISTER_VALUE	    0x50
40 #define HV_STATUS_OPERATION_FAILED		    0x71
41 #define HV_STATUS_TIME_OUT			    0x78
42 #define HV_STATUS_CALL_PENDING			    0x79
43 #define HV_STATUS_VTL_ALREADY_ENABLED		    0x86
44 
45 /*
46  * The Hyper-V TimeRefCount register and the TSC
47  * page provide a guest VM clock with 100ns tick rate
48  */
49 #define HV_CLOCK_HZ (NSEC_PER_SEC / 100)
50 
51 #define HV_HYP_PAGE_SHIFT		12
52 #define HV_HYP_PAGE_SIZE		BIT(HV_HYP_PAGE_SHIFT)
53 #define HV_HYP_PAGE_MASK		(~(HV_HYP_PAGE_SIZE - 1))
54 #define HV_HYP_LARGE_PAGE_SHIFT		21
55 
56 #define HV_PARTITION_ID_INVALID		((u64)0)
57 #define HV_PARTITION_ID_SELF		((u64)-1)
58 
59 /* Hyper-V specific model specific registers (MSRs) */
60 
61 #if defined(CONFIG_X86)
62 /* HV_X64_SYNTHETIC_MSR */
63 #define HV_X64_MSR_GUEST_OS_ID			0x40000000
64 #define HV_X64_MSR_HYPERCALL			0x40000001
65 #define HV_X64_MSR_VP_INDEX			0x40000002
66 #define HV_X64_MSR_RESET			0x40000003
67 #define HV_X64_MSR_VP_RUNTIME			0x40000010
68 #define HV_X64_MSR_TIME_REF_COUNT		0x40000020
69 #define HV_X64_MSR_REFERENCE_TSC		0x40000021
70 #define HV_X64_MSR_TSC_FREQUENCY		0x40000022
71 #define HV_X64_MSR_APIC_FREQUENCY		0x40000023
72 
73 /* Define the virtual APIC registers */
74 #define HV_X64_MSR_EOI				0x40000070
75 #define HV_X64_MSR_ICR				0x40000071
76 #define HV_X64_MSR_TPR				0x40000072
77 #define HV_X64_MSR_VP_ASSIST_PAGE		0x40000073
78 
79 /* Define synthetic interrupt controller model specific registers. */
80 #define HV_X64_MSR_SCONTROL			0x40000080
81 #define HV_X64_MSR_SVERSION			0x40000081
82 #define HV_X64_MSR_SIEFP			0x40000082
83 #define HV_X64_MSR_SIMP				0x40000083
84 #define HV_X64_MSR_EOM				0x40000084
85 #define HV_X64_MSR_SIRBP			0x40000085
86 #define HV_X64_MSR_SINT0			0x40000090
87 #define HV_X64_MSR_SINT1			0x40000091
88 #define HV_X64_MSR_SINT2			0x40000092
89 #define HV_X64_MSR_SINT3			0x40000093
90 #define HV_X64_MSR_SINT4			0x40000094
91 #define HV_X64_MSR_SINT5			0x40000095
92 #define HV_X64_MSR_SINT6			0x40000096
93 #define HV_X64_MSR_SINT7			0x40000097
94 #define HV_X64_MSR_SINT8			0x40000098
95 #define HV_X64_MSR_SINT9			0x40000099
96 #define HV_X64_MSR_SINT10			0x4000009A
97 #define HV_X64_MSR_SINT11			0x4000009B
98 #define HV_X64_MSR_SINT12			0x4000009C
99 #define HV_X64_MSR_SINT13			0x4000009D
100 #define HV_X64_MSR_SINT14			0x4000009E
101 #define HV_X64_MSR_SINT15			0x4000009F
102 
103 /* Define synthetic interrupt controller model specific registers for nested hypervisor */
104 #define HV_X64_MSR_NESTED_SCONTROL		0x40001080
105 #define HV_X64_MSR_NESTED_SVERSION		0x40001081
106 #define HV_X64_MSR_NESTED_SIEFP			0x40001082
107 #define HV_X64_MSR_NESTED_SIMP			0x40001083
108 #define HV_X64_MSR_NESTED_EOM			0x40001084
109 #define HV_X64_MSR_NESTED_SINT0			0x40001090
110 
111 /*
112  * Synthetic Timer MSRs. Four timers per vcpu.
113  */
114 #define HV_X64_MSR_STIMER0_CONFIG		0x400000B0
115 #define HV_X64_MSR_STIMER0_COUNT		0x400000B1
116 #define HV_X64_MSR_STIMER1_CONFIG		0x400000B2
117 #define HV_X64_MSR_STIMER1_COUNT		0x400000B3
118 #define HV_X64_MSR_STIMER2_CONFIG		0x400000B4
119 #define HV_X64_MSR_STIMER2_COUNT		0x400000B5
120 #define HV_X64_MSR_STIMER3_CONFIG		0x400000B6
121 #define HV_X64_MSR_STIMER3_COUNT		0x400000B7
122 
123 /* Hyper-V guest idle MSR */
124 #define HV_X64_MSR_GUEST_IDLE			0x400000F0
125 
126 /* Hyper-V guest crash notification MSR's */
127 #define HV_X64_MSR_CRASH_P0			0x40000100
128 #define HV_X64_MSR_CRASH_P1			0x40000101
129 #define HV_X64_MSR_CRASH_P2			0x40000102
130 #define HV_X64_MSR_CRASH_P3			0x40000103
131 #define HV_X64_MSR_CRASH_P4			0x40000104
132 #define HV_X64_MSR_CRASH_CTL			0x40000105
133 
134 #define HV_X64_MSR_HYPERCALL_ENABLE		0x00000001
135 #define HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_SHIFT	12
136 #define HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_MASK	\
137 		(~((1ull << HV_X64_MSR_HYPERCALL_PAGE_ADDRESS_SHIFT) - 1))
138 
139 #define HV_X64_MSR_CRASH_PARAMS		\
140 		(1 + (HV_X64_MSR_CRASH_P4 - HV_X64_MSR_CRASH_P0))
141 
142 #define HV_IPI_LOW_VECTOR	 0x10
143 #define HV_IPI_HIGH_VECTOR	 0xff
144 
145 #define HV_X64_MSR_VP_ASSIST_PAGE_ENABLE	0x00000001
146 #define HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_SHIFT	12
147 #define HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_MASK	\
148 		(~((1ull << HV_X64_MSR_VP_ASSIST_PAGE_ADDRESS_SHIFT) - 1))
149 
150 /* Hyper-V Enlightened VMCS version mask in nested features CPUID */
151 #define HV_X64_ENLIGHTENED_VMCS_VERSION		0xff
152 
153 #define HV_X64_MSR_TSC_REFERENCE_ENABLE		0x00000001
154 #define HV_X64_MSR_TSC_REFERENCE_ADDRESS_SHIFT	12
155 
156 /* Number of XMM registers used in hypercall input/output */
157 #define HV_HYPERCALL_MAX_XMM_REGISTERS		6
158 
159 struct hv_reenlightenment_control {
160 	u64 vector : 8;
161 	u64 reserved1 : 8;
162 	u64 enabled : 1;
163 	u64 reserved2 : 15;
164 	u64 target_vp : 32;
165 }  __packed;
166 
167 struct hv_tsc_emulation_status {	 /* HV_TSC_EMULATION_STATUS */
168 	u64 inprogress : 1;
169 	u64 reserved : 63;
170 } __packed;
171 
172 struct hv_tsc_emulation_control {	 /* HV_TSC_INVARIANT_CONTROL */
173 	u64 enabled : 1;
174 	u64 reserved : 63;
175 } __packed;
176 
177 /* TSC emulation after migration */
178 #define HV_X64_MSR_REENLIGHTENMENT_CONTROL	0x40000106
179 #define HV_X64_MSR_TSC_EMULATION_CONTROL	0x40000107
180 #define HV_X64_MSR_TSC_EMULATION_STATUS		0x40000108
181 #define HV_X64_MSR_TSC_INVARIANT_CONTROL	0x40000118
182 #define HV_EXPOSE_INVARIANT_TSC		BIT_ULL(0)
183 
184 #endif /* CONFIG_X86 */
185 
186 struct hv_output_get_partition_id {
187 	u64 partition_id;
188 } __packed;
189 
190 /* HV_CRASH_CTL_REG_CONTENTS */
191 #define HV_CRASH_CTL_CRASH_NOTIFY_MSG		 BIT_ULL(62)
192 #define HV_CRASH_CTL_CRASH_NOTIFY		 BIT_ULL(63)
193 
194 union hv_reference_tsc_msr {
195 	u64 as_uint64;
196 	struct {
197 		u64 enable : 1;
198 		u64 reserved : 11;
199 		u64 pfn : 52;
200 	} __packed;
201 };
202 
203 /* The maximum number of sparse vCPU banks which can be encoded by 'struct hv_vpset' */
204 #define HV_MAX_SPARSE_VCPU_BANKS (64)
205 /* The number of vCPUs in one sparse bank */
206 #define HV_VCPUS_PER_SPARSE_BANK (64)
207 
208 /*
209  * Some of Hyper-V structs do not use hv_vpset where linux uses them.
210  *
211  * struct hv_vpset is usually used as part of hypercall input. The portion
212  * that counts as "fixed size input header" vs. "variable size input header"
213  * varies per hypercall. See comments at relevant hypercall call sites as to
214  * how the "valid_bank_mask" field should be accounted.
215  */
216 struct hv_vpset {	 /* HV_VP_SET */
217 	u64 format;
218 	u64 valid_bank_mask;
219 	u64 bank_contents[];
220 } __packed;
221 
222 /*
223  * Version info reported by hypervisor
224  * Changed to a union for convenience
225  */
226 union hv_hypervisor_version_info {
227 	struct {
228 		u32 build_number;
229 
230 		u32 minor_version : 16;
231 		u32 major_version : 16;
232 
233 		u32 service_pack;
234 
235 		u32 service_number : 24;
236 		u32 service_branch : 8;
237 	};
238 	struct {
239 		u32 eax;
240 		u32 ebx;
241 		u32 ecx;
242 		u32 edx;
243 	};
244 };
245 
246 /* HV_CPUID_FUNCTION */
247 #define HYPERV_CPUID_VENDOR_AND_MAX_FUNCTIONS	0x40000000
248 #define HYPERV_CPUID_INTERFACE			0x40000001
249 #define HYPERV_CPUID_VERSION			0x40000002
250 #define HYPERV_CPUID_FEATURES			0x40000003
251 #define HYPERV_CPUID_ENLIGHTMENT_INFO		0x40000004
252 #define HYPERV_CPUID_IMPLEMENT_LIMITS		0x40000005
253 #define HYPERV_CPUID_CPU_MANAGEMENT_FEATURES	0x40000007
254 #define HYPERV_CPUID_NESTED_FEATURES		0x4000000A
255 #define HYPERV_CPUID_ISOLATION_CONFIG		0x4000000C
256 
257 #define HYPERV_CPUID_VIRT_STACK_INTERFACE	 0x40000081
258 #define HYPERV_VS_INTERFACE_EAX_SIGNATURE	 0x31235356  /* "VS#1" */
259 
260 #define HYPERV_CPUID_VIRT_STACK_PROPERTIES	 0x40000082
261 /* Support for the extended IOAPIC RTE format */
262 #define HYPERV_VS_PROPERTIES_EAX_EXTENDED_IOAPIC_RTE	 BIT(2)
263 #define HYPERV_VS_PROPERTIES_EAX_CONFIDENTIAL_VMBUS_AVAILABLE	 BIT(3)
264 
265 #define HYPERV_HYPERVISOR_PRESENT_BIT		 0x80000000
266 #define HYPERV_CPUID_MIN			 0x40000005
267 #define HYPERV_CPUID_MAX			 0x4000ffff
268 
269 /*
270  * HV_X64_HYPERVISOR_FEATURES (EAX), or
271  * HV_PARTITION_PRIVILEGE_MASK [31-0]
272  */
273 #define HV_MSR_VP_RUNTIME_AVAILABLE			BIT(0)
274 #define HV_MSR_TIME_REF_COUNT_AVAILABLE			BIT(1)
275 #define HV_MSR_SYNIC_AVAILABLE				BIT(2)
276 #define HV_MSR_SYNTIMER_AVAILABLE			BIT(3)
277 #define HV_MSR_APIC_ACCESS_AVAILABLE			BIT(4)
278 #define HV_MSR_HYPERCALL_AVAILABLE			BIT(5)
279 #define HV_MSR_VP_INDEX_AVAILABLE			BIT(6)
280 #define HV_MSR_RESET_AVAILABLE				BIT(7)
281 #define HV_MSR_STAT_PAGES_AVAILABLE			BIT(8)
282 #define HV_MSR_REFERENCE_TSC_AVAILABLE			BIT(9)
283 #define HV_MSR_GUEST_IDLE_AVAILABLE			BIT(10)
284 #define HV_ACCESS_FREQUENCY_MSRS			BIT(11)
285 #define HV_ACCESS_REENLIGHTENMENT			BIT(13)
286 #define HV_ACCESS_TSC_INVARIANT				BIT(15)
287 
288 /*
289  * HV_X64_HYPERVISOR_FEATURES (EBX), or
290  * HV_PARTITION_PRIVILEGE_MASK [63-32]
291  */
292 #define HV_CREATE_PARTITIONS				BIT(0)
293 #define HV_ACCESS_PARTITION_ID				BIT(1)
294 #define HV_ACCESS_MEMORY_POOL				BIT(2)
295 #define HV_ADJUST_MESSAGE_BUFFERS			BIT(3)
296 #define HV_POST_MESSAGES				BIT(4)
297 #define HV_SIGNAL_EVENTS				BIT(5)
298 #define HV_CREATE_PORT					BIT(6)
299 #define HV_CONNECT_PORT					BIT(7)
300 #define HV_ACCESS_STATS					BIT(8)
301 #define HV_DEBUGGING					BIT(11)
302 #define HV_CPU_MANAGEMENT				BIT(12)
303 #define HV_ENABLE_EXTENDED_HYPERCALLS			BIT(20)
304 #define HV_ISOLATION					BIT(22)
305 
306 #if defined(CONFIG_X86)
307 /* HV_X64_HYPERVISOR_FEATURES (EDX) */
308 #define HV_X64_MWAIT_AVAILABLE				BIT(0)
309 #define HV_X64_GUEST_DEBUGGING_AVAILABLE		BIT(1)
310 #define HV_X64_PERF_MONITOR_AVAILABLE			BIT(2)
311 #define HV_X64_CPU_DYNAMIC_PARTITIONING_AVAILABLE	BIT(3)
312 #define HV_X64_HYPERCALL_XMM_INPUT_AVAILABLE		BIT(4)
313 #define HV_X64_GUEST_IDLE_STATE_AVAILABLE		BIT(5)
314 #define HV_FEATURE_FREQUENCY_MSRS_AVAILABLE		BIT(8)
315 #define HV_FEATURE_GUEST_CRASH_MSR_AVAILABLE		BIT(10)
316 #define HV_FEATURE_DEBUG_MSRS_AVAILABLE			BIT(11)
317 #define HV_FEATURE_EXT_GVA_RANGES_FLUSH			BIT(14)
318 /*
319  * Support for returning hypercall output block via XMM
320  * registers is available
321  */
322 #define HV_X64_HYPERCALL_XMM_OUTPUT_AVAILABLE		BIT(15)
323 /* stimer Direct Mode is available */
324 #define HV_STIMER_DIRECT_MODE_AVAILABLE			BIT(19)
325 
326 /*
327  * Implementation recommendations. Indicates which behaviors the hypervisor
328  * recommends the OS implement for optimal performance.
329  * These are HYPERV_CPUID_ENLIGHTMENT_INFO.EAX bits.
330  */
331 /* HV_X64_ENLIGHTENMENT_INFORMATION */
332 #define HV_X64_AS_SWITCH_RECOMMENDED			BIT(0)
333 #define HV_X64_LOCAL_TLB_FLUSH_RECOMMENDED		BIT(1)
334 #define HV_X64_REMOTE_TLB_FLUSH_RECOMMENDED		BIT(2)
335 #define HV_X64_APIC_ACCESS_RECOMMENDED			BIT(3)
336 #define HV_X64_SYSTEM_RESET_RECOMMENDED			BIT(4)
337 #define HV_X64_RELAXED_TIMING_RECOMMENDED		BIT(5)
338 #define HV_DEPRECATING_AEOI_RECOMMENDED			BIT(9)
339 #define HV_X64_CLUSTER_IPI_RECOMMENDED			BIT(10)
340 #define HV_X64_EX_PROCESSOR_MASKS_RECOMMENDED		BIT(11)
341 #define HV_X64_HYPERV_NESTED				BIT(12)
342 #define HV_X64_ENLIGHTENED_VMCS_RECOMMENDED		BIT(14)
343 #define HV_X64_USE_MMIO_HYPERCALLS			BIT(21)
344 
345 /*
346  * CPU management features identification.
347  * These are HYPERV_CPUID_CPU_MANAGEMENT_FEATURES.EAX bits.
348  */
349 #define HV_X64_START_LOGICAL_PROCESSOR			BIT(0)
350 #define HV_X64_CREATE_ROOT_VIRTUAL_PROCESSOR		BIT(1)
351 #define HV_X64_PERFORMANCE_COUNTER_SYNC			BIT(2)
352 #define HV_X64_RESERVED_IDENTITY_BIT			BIT(31)
353 
354 /*
355  * Virtual processor will never share a physical core with another virtual
356  * processor, except for virtual processors that are reported as sibling SMT
357  * threads.
358  */
359 #define HV_X64_NO_NONARCH_CORESHARING			BIT(18)
360 
361 /* Nested features. These are HYPERV_CPUID_NESTED_FEATURES.EAX bits. */
362 #define HV_X64_NESTED_DIRECT_FLUSH			BIT(17)
363 #define HV_X64_NESTED_GUEST_MAPPING_FLUSH		BIT(18)
364 #define HV_X64_NESTED_MSR_BITMAP			BIT(19)
365 
366 /* Nested features #2. These are HYPERV_CPUID_NESTED_FEATURES.EBX bits. */
367 #define HV_X64_NESTED_EVMCS1_PERF_GLOBAL_CTRL		BIT(0)
368 
369 /*
370  * This is specific to AMD and specifies that enlightened TLB flush is
371  * supported. If guest opts in to this feature, ASID invalidations only
372  * flushes gva -> hpa mapping entries. To flush the TLB entries derived
373  * from NPT, hypercalls should be used (HvFlushGuestPhysicalAddressSpace
374  * or HvFlushGuestPhysicalAddressList).
375  */
376 #define HV_X64_NESTED_ENLIGHTENED_TLB			BIT(22)
377 
378 /* HYPERV_CPUID_ISOLATION_CONFIG.EAX bits. */
379 #define HV_PARAVISOR_PRESENT				BIT(0)
380 
381 /* HYPERV_CPUID_ISOLATION_CONFIG.EBX bits. */
382 #define HV_ISOLATION_TYPE				GENMASK(3, 0)
383 #define HV_SHARED_GPA_BOUNDARY_ACTIVE			BIT(5)
384 #define HV_SHARED_GPA_BOUNDARY_BITS			GENMASK(11, 6)
385 
386 /* HYPERV_CPUID_FEATURES.ECX bits. */
387 #define HV_VP_DISPATCH_INTERRUPT_INJECTION_AVAILABLE	BIT(9)
388 #define HV_VP_GHCB_ROOT_MAPPING_AVAILABLE		BIT(10)
389 
390 enum hv_isolation_type {
391 	HV_ISOLATION_TYPE_NONE	= 0,	/* HV_PARTITION_ISOLATION_TYPE_NONE */
392 	HV_ISOLATION_TYPE_VBS	= 1,
393 	HV_ISOLATION_TYPE_SNP	= 2,
394 	HV_ISOLATION_TYPE_TDX	= 3
395 };
396 
397 union hv_x64_msr_hypercall_contents {
398 	u64 as_uint64;
399 	struct {
400 		u64 enable : 1;
401 		u64 reserved : 11;
402 		u64 guest_physical_address : 52;
403 	} __packed;
404 };
405 #endif /* CONFIG_X86 */
406 
407 #if defined(CONFIG_ARM64)
408 #define HV_FEATURE_GUEST_CRASH_MSR_AVAILABLE	BIT(8)
409 #define HV_STIMER_DIRECT_MODE_AVAILABLE		BIT(13)
410 #endif /* CONFIG_ARM64 */
411 
412 #if defined(CONFIG_X86)
413 #define HV_MAXIMUM_PROCESSORS	    2048
414 #elif defined(CONFIG_ARM64) /* CONFIG_X86 */
415 #define HV_MAXIMUM_PROCESSORS	    320
416 #endif /* CONFIG_ARM64 */
417 
418 #define HV_MAX_VP_INDEX			(HV_MAXIMUM_PROCESSORS - 1)
419 #define HV_VP_INDEX_SELF		((u32)-2)
420 #define HV_ANY_VP			((u32)-1)
421 
422 union hv_vp_assist_msr_contents {	 /* HV_REGISTER_VP_ASSIST_PAGE */
423 	u64 as_uint64;
424 	struct {
425 		u64 enable : 1;
426 		u64 reserved : 11;
427 		u64 pfn : 52;
428 	} __packed;
429 };
430 
431 /* Declare the various hypercall operations. */
432 /* HV_CALL_CODE */
433 #define HVCALL_FLUSH_VIRTUAL_ADDRESS_SPACE		0x0002
434 #define HVCALL_FLUSH_VIRTUAL_ADDRESS_LIST		0x0003
435 #define HVCALL_NOTIFY_LONG_SPIN_WAIT			0x0008
436 #define HVCALL_SEND_IPI					0x000b
437 #define HVCALL_ENABLE_VP_VTL				0x000f
438 #define HVCALL_FLUSH_VIRTUAL_ADDRESS_SPACE_EX		0x0013
439 #define HVCALL_FLUSH_VIRTUAL_ADDRESS_LIST_EX		0x0014
440 #define HVCALL_SEND_IPI_EX				0x0015
441 #define HVCALL_CREATE_PARTITION				0x0040
442 #define HVCALL_INITIALIZE_PARTITION			0x0041
443 #define HVCALL_FINALIZE_PARTITION			0x0042
444 #define HVCALL_DELETE_PARTITION				0x0043
445 #define HVCALL_GET_PARTITION_PROPERTY			0x0044
446 #define HVCALL_SET_PARTITION_PROPERTY			0x0045
447 #define HVCALL_GET_PARTITION_ID				0x0046
448 #define HVCALL_DEPOSIT_MEMORY				0x0048
449 #define HVCALL_WITHDRAW_MEMORY				0x0049
450 #define HVCALL_MAP_GPA_PAGES				0x004b
451 #define HVCALL_UNMAP_GPA_PAGES				0x004c
452 #define HVCALL_INSTALL_INTERCEPT			0x004d
453 #define HVCALL_CREATE_VP				0x004e
454 #define HVCALL_DELETE_VP				0x004f
455 #define HVCALL_GET_VP_REGISTERS				0x0050
456 #define HVCALL_SET_VP_REGISTERS				0x0051
457 #define HVCALL_TRANSLATE_VIRTUAL_ADDRESS		0x0052
458 #define HVCALL_CLEAR_VIRTUAL_INTERRUPT			0x0056
459 #define HVCALL_DELETE_PORT				0x0058
460 #define HVCALL_DISCONNECT_PORT				0x005b
461 #define HVCALL_POST_MESSAGE				0x005c
462 #define HVCALL_SIGNAL_EVENT				0x005d
463 #define HVCALL_POST_DEBUG_DATA				0x0069
464 #define HVCALL_RETRIEVE_DEBUG_DATA			0x006a
465 #define HVCALL_RESET_DEBUG_SESSION			0x006b
466 #define HVCALL_MAP_STATS_PAGE				0x006c
467 #define HVCALL_UNMAP_STATS_PAGE				0x006d
468 #define HVCALL_ADD_LOGICAL_PROCESSOR			0x0076
469 #define HVCALL_GET_SYSTEM_PROPERTY			0x007b
470 #define HVCALL_MAP_DEVICE_INTERRUPT			0x007c
471 #define HVCALL_UNMAP_DEVICE_INTERRUPT			0x007d
472 #define HVCALL_RETARGET_INTERRUPT			0x007e
473 #define HVCALL_NOTIFY_PORT_RING_EMPTY			0x008b
474 #define HVCALL_REGISTER_INTERCEPT_RESULT		0x0091
475 #define HVCALL_ASSERT_VIRTUAL_INTERRUPT			0x0094
476 #define HVCALL_CREATE_PORT				0x0095
477 #define HVCALL_CONNECT_PORT				0x0096
478 #define HVCALL_START_VP					0x0099
479 #define HVCALL_GET_VP_INDEX_FROM_APIC_ID			0x009a
480 #define HVCALL_FLUSH_GUEST_PHYSICAL_ADDRESS_SPACE	0x00af
481 #define HVCALL_FLUSH_GUEST_PHYSICAL_ADDRESS_LIST	0x00b0
482 #define HVCALL_SIGNAL_EVENT_DIRECT			0x00c0
483 #define HVCALL_POST_MESSAGE_DIRECT			0x00c1
484 #define HVCALL_DISPATCH_VP				0x00c2
485 #define HVCALL_GET_GPA_PAGES_ACCESS_STATES		0x00c9
486 #define HVCALL_ACQUIRE_SPARSE_SPA_PAGE_HOST_ACCESS	0x00d7
487 #define HVCALL_RELEASE_SPARSE_SPA_PAGE_HOST_ACCESS	0x00d8
488 #define HVCALL_MODIFY_SPARSE_GPA_PAGE_HOST_VISIBILITY	0x00db
489 #define HVCALL_MAP_VP_STATE_PAGE			0x00e1
490 #define HVCALL_UNMAP_VP_STATE_PAGE			0x00e2
491 #define HVCALL_GET_VP_STATE				0x00e3
492 #define HVCALL_SET_VP_STATE				0x00e4
493 #define HVCALL_GET_VP_CPUID_VALUES			0x00f4
494 #define HVCALL_GET_PARTITION_PROPERTY_EX		0x0101
495 #define HVCALL_MMIO_READ				0x0106
496 #define HVCALL_MMIO_WRITE				0x0107
497 #define HVCALL_MAP_STATS_PAGE2				0x0131
498 
499 /* HV_HYPERCALL_INPUT */
500 #define HV_HYPERCALL_RESULT_MASK	GENMASK_ULL(15, 0)
501 #define HV_HYPERCALL_FAST_BIT		BIT(16)
502 #define HV_HYPERCALL_VARHEAD_OFFSET	17
503 #define HV_HYPERCALL_VARHEAD_MASK	GENMASK_ULL(26, 17)
504 #define HV_HYPERCALL_RSVD0_MASK		GENMASK_ULL(31, 27)
505 #define HV_HYPERCALL_NESTED		BIT_ULL(31)
506 #define HV_HYPERCALL_REP_COMP_OFFSET	32
507 #define HV_HYPERCALL_REP_COMP_1		BIT_ULL(32)
508 #define HV_HYPERCALL_REP_COMP_MASK	GENMASK_ULL(43, 32)
509 #define HV_HYPERCALL_RSVD1_MASK		GENMASK_ULL(47, 44)
510 #define HV_HYPERCALL_REP_START_OFFSET	48
511 #define HV_HYPERCALL_REP_START_MASK	GENMASK_ULL(59, 48)
512 #define HV_HYPERCALL_RSVD2_MASK		GENMASK_ULL(63, 60)
513 #define HV_HYPERCALL_RSVD_MASK		(HV_HYPERCALL_RSVD0_MASK | \
514 					 HV_HYPERCALL_RSVD1_MASK | \
515 					 HV_HYPERCALL_RSVD2_MASK)
516 
517 /* HvFlushGuestPhysicalAddressSpace hypercalls */
518 struct hv_guest_mapping_flush {
519 	u64 address_space;
520 	u64 flags;
521 } __packed;
522 
523 /*
524  *  HV_MAX_FLUSH_PAGES = "additional_pages" + 1. It's limited
525  *  by the bitwidth of "additional_pages" in union hv_gpa_page_range.
526  */
527 #define HV_MAX_FLUSH_PAGES (2048)
528 #define HV_GPA_PAGE_RANGE_PAGE_SIZE_2MB		0
529 #define HV_GPA_PAGE_RANGE_PAGE_SIZE_1GB		1
530 
531 #define HV_FLUSH_ALL_PROCESSORS			BIT(0)
532 #define HV_FLUSH_ALL_VIRTUAL_ADDRESS_SPACES	BIT(1)
533 #define HV_FLUSH_NON_GLOBAL_MAPPINGS_ONLY	BIT(2)
534 #define HV_FLUSH_USE_EXTENDED_RANGE_FORMAT	BIT(3)
535 
536 /* HvFlushGuestPhysicalAddressList, HvExtCallMemoryHeatHint hypercall */
537 union hv_gpa_page_range {
538 	u64 address_space;
539 	struct {
540 		u64 additional_pages : 11;
541 		u64 largepage : 1;
542 		u64 basepfn : 52;
543 	} page;
544 	struct {
545 		u64 reserved : 12;
546 		u64 page_size : 1;
547 		u64 reserved1 : 8;
548 		u64 base_large_pfn : 43;
549 	};
550 };
551 
552 /*
553  * All input flush parameters should be in single page. The max flush
554  * count is equal with how many entries of union hv_gpa_page_range can
555  * be populated into the input parameter page.
556  */
557 #define HV_MAX_FLUSH_REP_COUNT ((HV_HYP_PAGE_SIZE - 2 * sizeof(u64)) / \
558 				sizeof(union hv_gpa_page_range))
559 
560 struct hv_guest_mapping_flush_list {
561 	u64 address_space;
562 	u64 flags;
563 	union hv_gpa_page_range gpa_list[HV_MAX_FLUSH_REP_COUNT];
564 };
565 
566 struct hv_tlb_flush {	 /* HV_INPUT_FLUSH_VIRTUAL_ADDRESS_LIST */
567 	u64 address_space;
568 	u64 flags;
569 	u64 processor_mask;
570 	u64 gva_list[];
571 } __packed;
572 
573 /* HvFlushVirtualAddressSpaceEx, HvFlushVirtualAddressListEx hypercalls */
574 struct hv_tlb_flush_ex {
575 	u64 address_space;
576 	u64 flags;
577 	struct hv_vpset hv_vp_set;
578 	u64 gva_list[];
579 } __packed;
580 
581 struct ms_hyperv_tsc_page {	 /* HV_REFERENCE_TSC_PAGE */
582 	volatile u32 tsc_sequence;
583 	u32 reserved1;
584 	volatile u64 tsc_scale;
585 	volatile s64 tsc_offset;
586 } __packed;
587 
588 /* Define the number of synthetic interrupt sources. */
589 #define HV_SYNIC_SINT_COUNT (16)
590 
591 /* Define the expected SynIC version. */
592 #define HV_SYNIC_VERSION_1		(0x1)
593 /* Valid SynIC vectors are 16-255. */
594 #define HV_SYNIC_FIRST_VALID_VECTOR	(16)
595 
596 #define HV_SYNIC_CONTROL_ENABLE		(1ULL << 0)
597 #define HV_SYNIC_SIMP_ENABLE		(1ULL << 0)
598 #define HV_SYNIC_SIEFP_ENABLE		(1ULL << 0)
599 #define HV_SYNIC_SINT_MASKED		(1ULL << 16)
600 #define HV_SYNIC_SINT_AUTO_EOI		(1ULL << 17)
601 #define HV_SYNIC_SINT_VECTOR_MASK	(0xFF)
602 
603 /* Hyper-V defined statically assigned SINTs */
604 #define HV_SYNIC_INTERCEPTION_SINT_INDEX 0x00000000
605 #define HV_SYNIC_IOMMU_FAULT_SINT_INDEX  0x00000001
606 #define HV_SYNIC_VMBUS_SINT_INDEX	 0x00000002
607 #define HV_SYNIC_FIRST_UNUSED_SINT_INDEX 0x00000005
608 
609 /* mshv assigned SINT for doorbell */
610 #define HV_SYNIC_DOORBELL_SINT_INDEX     HV_SYNIC_FIRST_UNUSED_SINT_INDEX
611 
612 enum hv_interrupt_type {
613 	HV_X64_INTERRUPT_TYPE_FIXED		= 0x0000,
614 	HV_X64_INTERRUPT_TYPE_LOWESTPRIORITY	= 0x0001,
615 	HV_X64_INTERRUPT_TYPE_SMI		= 0x0002,
616 	HV_X64_INTERRUPT_TYPE_REMOTEREAD	= 0x0003,
617 	HV_X64_INTERRUPT_TYPE_NMI		= 0x0004,
618 	HV_X64_INTERRUPT_TYPE_INIT		= 0x0005,
619 	HV_X64_INTERRUPT_TYPE_SIPI		= 0x0006,
620 	HV_X64_INTERRUPT_TYPE_EXTINT		= 0x0007,
621 	HV_X64_INTERRUPT_TYPE_LOCALINT0		= 0x0008,
622 	HV_X64_INTERRUPT_TYPE_LOCALINT1		= 0x0009,
623 	HV_X64_INTERRUPT_TYPE_MAXIMUM		= 0x000A,
624 };
625 
626 /* Define synthetic interrupt source. */
627 union hv_synic_sint {
628 	u64 as_uint64;
629 	struct {
630 		u64 vector : 8;
631 		u64 reserved1 : 8;
632 		u64 masked : 1;
633 		u64 auto_eoi : 1;
634 		u64 polling : 1;
635 		u64 as_intercept : 1;
636 		u64 proxy : 1;
637 		u64 reserved2 : 43;
638 	} __packed;
639 };
640 
641 union hv_x64_xsave_xfem_register {
642 	u64 as_uint64;
643 	struct {
644 		u32 low_uint32;
645 		u32 high_uint32;
646 	} __packed;
647 	struct {
648 		u64 legacy_x87 : 1;
649 		u64 legacy_sse : 1;
650 		u64 avx : 1;
651 		u64 mpx_bndreg : 1;
652 		u64 mpx_bndcsr : 1;
653 		u64 avx_512_op_mask : 1;
654 		u64 avx_512_zmmhi : 1;
655 		u64 avx_512_zmm16_31 : 1;
656 		u64 rsvd8_9 : 2;
657 		u64 pasid : 1;
658 		u64 cet_u : 1;
659 		u64 cet_s : 1;
660 		u64 rsvd13_16 : 4;
661 		u64 xtile_cfg : 1;
662 		u64 xtile_data : 1;
663 		u64 rsvd19_63 : 45;
664 	} __packed;
665 };
666 
667 /* Synthetic timer configuration */
668 union hv_stimer_config {	 /* HV_X64_MSR_STIMER_CONFIG_CONTENTS */
669 	u64 as_uint64;
670 	struct {
671 		u64 enable : 1;
672 		u64 periodic : 1;
673 		u64 lazy : 1;
674 		u64 auto_enable : 1;
675 		u64 apic_vector : 8;
676 		u64 direct_mode : 1;
677 		u64 reserved_z0 : 3;
678 		u64 sintx : 4;
679 		u64 reserved_z1 : 44;
680 	} __packed;
681 };
682 
683 /* Define the number of synthetic timers */
684 #define HV_SYNIC_STIMER_COUNT	(4)
685 
686 /* Define port identifier type. */
687 union hv_port_id {
688 	u32 asu32;
689 	struct {
690 		u32 id : 24;
691 		u32 reserved : 8;
692 	} __packed u;
693 };
694 
695 #define HV_MESSAGE_SIZE			(256)
696 #define HV_MESSAGE_PAYLOAD_BYTE_COUNT	(240)
697 #define HV_MESSAGE_PAYLOAD_QWORD_COUNT	(30)
698 
699 /* Define hypervisor message types. */
700 enum hv_message_type {
701 	HVMSG_NONE				= 0x00000000,
702 
703 	/* Memory access messages. */
704 	HVMSG_UNMAPPED_GPA			= 0x80000000,
705 	HVMSG_GPA_INTERCEPT			= 0x80000001,
706 
707 	/* Timer notification messages. */
708 	HVMSG_TIMER_EXPIRED			= 0x80000010,
709 
710 	/* Error messages. */
711 	HVMSG_INVALID_VP_REGISTER_VALUE		= 0x80000020,
712 	HVMSG_UNRECOVERABLE_EXCEPTION		= 0x80000021,
713 	HVMSG_UNSUPPORTED_FEATURE		= 0x80000022,
714 
715 	/*
716 	 * Opaque intercept message. The original intercept message is only
717 	 * accessible from the mapped intercept message page.
718 	 */
719 	HVMSG_OPAQUE_INTERCEPT			= 0x8000003F,
720 
721 	/* Trace buffer complete messages. */
722 	HVMSG_EVENTLOG_BUFFERCOMPLETE		= 0x80000040,
723 
724 	/* Hypercall intercept */
725 	HVMSG_HYPERCALL_INTERCEPT		= 0x80000050,
726 
727 	/* SynIC intercepts */
728 	HVMSG_SYNIC_EVENT_INTERCEPT		= 0x80000060,
729 	HVMSG_SYNIC_SINT_INTERCEPT		= 0x80000061,
730 	HVMSG_SYNIC_SINT_DELIVERABLE	= 0x80000062,
731 
732 	/* Async call completion intercept */
733 	HVMSG_ASYNC_CALL_COMPLETION		= 0x80000070,
734 
735 	/* Root scheduler messages */
736 	HVMSG_SCHEDULER_VP_SIGNAL_BITSET	= 0x80000100,
737 	HVMSG_SCHEDULER_VP_SIGNAL_PAIR		= 0x80000101,
738 
739 	/* Platform-specific processor intercept messages. */
740 	HVMSG_X64_IO_PORT_INTERCEPT		= 0x80010000,
741 	HVMSG_X64_MSR_INTERCEPT			= 0x80010001,
742 	HVMSG_X64_CPUID_INTERCEPT		= 0x80010002,
743 	HVMSG_X64_EXCEPTION_INTERCEPT		= 0x80010003,
744 	HVMSG_X64_APIC_EOI			= 0x80010004,
745 	HVMSG_X64_LEGACY_FP_ERROR		= 0x80010005,
746 	HVMSG_X64_IOMMU_PRQ			= 0x80010006,
747 	HVMSG_X64_HALT				= 0x80010007,
748 	HVMSG_X64_INTERRUPTION_DELIVERABLE	= 0x80010008,
749 	HVMSG_X64_SIPI_INTERCEPT		= 0x80010009,
750 };
751 
752 /* Define the format of the SIMP register */
753 union hv_synic_simp {
754 	u64 as_uint64;
755 	struct {
756 		u64 simp_enabled : 1;
757 		u64 preserved : 11;
758 		u64 base_simp_gpa : 52;
759 	} __packed;
760 };
761 
762 union hv_message_flags {
763 	u8 asu8;
764 	struct {
765 		u8 msg_pending : 1;
766 		u8 reserved : 7;
767 	} __packed;
768 };
769 
770 struct hv_message_header {
771 	u32 message_type;
772 	u8 payload_size;
773 	union hv_message_flags message_flags;
774 	u8 reserved[2];
775 	union {
776 		u64 sender;
777 		union hv_port_id port;
778 	};
779 } __packed;
780 
781 /*
782  * Message format for notifications delivered via
783  * intercept message(as_intercept=1)
784  */
785 struct hv_notification_message_payload {
786 	u32 sint_index;
787 } __packed;
788 
789 struct hv_message {
790 	struct hv_message_header header;
791 	union {
792 		u64 payload[HV_MESSAGE_PAYLOAD_QWORD_COUNT];
793 	} u;
794 } __packed;
795 
796 /* Define the synthetic interrupt message page layout. */
797 struct hv_message_page {
798 	struct hv_message sint_message[HV_SYNIC_SINT_COUNT];
799 } __packed;
800 
801 /* Define timer message payload structure. */
802 struct hv_timer_message_payload {
803 	u32 timer_index;
804 	u32 reserved;
805 	u64 expiration_time;	/* When the timer expired */
806 	u64 delivery_time;	/* When the message was delivered */
807 } __packed;
808 
809 struct hv_x64_segment_register {
810 	u64 base;
811 	u32 limit;
812 	u16 selector;
813 	union {
814 		struct {
815 			u16 segment_type : 4;
816 			u16 non_system_segment : 1;
817 			u16 descriptor_privilege_level : 2;
818 			u16 present : 1;
819 			u16 reserved : 4;
820 			u16 available : 1;
821 			u16 _long : 1;
822 			u16 _default : 1;
823 			u16 granularity : 1;
824 		} __packed;
825 		u16 attributes;
826 	};
827 } __packed;
828 
829 struct hv_x64_table_register {
830 	u16 pad[3];
831 	u16 limit;
832 	u64 base;
833 } __packed;
834 
835 #define HV_NORMAL_VTL	0
836 
837 union hv_input_vtl {
838 	u8 as_uint8;
839 	struct {
840 		u8 target_vtl : 4;
841 		u8 use_target_vtl : 1;
842 		u8 reserved_z : 3;
843 	};
844 } __packed;
845 
846 struct hv_init_vp_context {
847 	u64 rip;
848 	u64 rsp;
849 	u64 rflags;
850 
851 	struct hv_x64_segment_register cs;
852 	struct hv_x64_segment_register ds;
853 	struct hv_x64_segment_register es;
854 	struct hv_x64_segment_register fs;
855 	struct hv_x64_segment_register gs;
856 	struct hv_x64_segment_register ss;
857 	struct hv_x64_segment_register tr;
858 	struct hv_x64_segment_register ldtr;
859 
860 	struct hv_x64_table_register idtr;
861 	struct hv_x64_table_register gdtr;
862 
863 	u64 efer;
864 	u64 cr0;
865 	u64 cr3;
866 	u64 cr4;
867 	u64 msr_cr_pat;
868 } __packed;
869 
870 struct hv_enable_vp_vtl {
871 	u64				partition_id;
872 	u32				vp_index;
873 	union hv_input_vtl		target_vtl;
874 	u8				mbz0;
875 	u16				mbz1;
876 	struct hv_init_vp_context	vp_context;
877 } __packed;
878 
879 struct hv_get_vp_from_apic_id_in {
880 	u64 partition_id;
881 	union hv_input_vtl target_vtl;
882 	u8 res[7];
883 	u32 apic_ids[];
884 } __packed;
885 
886 struct hv_nested_enlightenments_control {
887 	struct {
888 		u32 directhypercall : 1;
889 		u32 reserved : 31;
890 	} __packed features;
891 	struct {
892 		u32 inter_partition_comm : 1;
893 		u32 reserved : 31;
894 	} __packed hypercall_controls;
895 } __packed;
896 
897 /* Define virtual processor assist page structure. */
898 struct hv_vp_assist_page {
899 	u32 apic_assist;
900 	u32 reserved1;
901 	u32 vtl_entry_reason;
902 	u32 vtl_reserved;
903 	u64 vtl_ret_x64rax;
904 	u64 vtl_ret_x64rcx;
905 	struct hv_nested_enlightenments_control nested_control;
906 	u8 enlighten_vmentry;
907 	u8 reserved2[7];
908 	u64 current_nested_vmcs;
909 	u8 synthetic_time_unhalted_timer_expired;
910 	u8 reserved3[7];
911 	u8 virtualization_fault_information[40];
912 	u8 reserved4[8];
913 	u8 intercept_message[256];
914 	u8 vtl_ret_actions[256];
915 } __packed;
916 
917 enum hv_register_name {
918 	/* Suspend Registers */
919 	HV_REGISTER_EXPLICIT_SUSPEND				= 0x00000000,
920 	HV_REGISTER_INTERCEPT_SUSPEND				= 0x00000001,
921 	HV_REGISTER_DISPATCH_SUSPEND				= 0x00000003,
922 
923 	/* Version - 128-bit result same as CPUID 0x40000002 */
924 	HV_REGISTER_HYPERVISOR_VERSION				= 0x00000100,
925 
926 	/* Feature Access (registers are 128 bits) - same as CPUID 0x40000003 - 0x4000000B */
927 	HV_REGISTER_PRIVILEGES_AND_FEATURES_INFO		= 0x00000200,
928 	HV_REGISTER_FEATURES_INFO				= 0x00000201,
929 	HV_REGISTER_IMPLEMENTATION_LIMITS_INFO			= 0x00000202,
930 	HV_REGISTER_HARDWARE_FEATURES_INFO			= 0x00000203,
931 	HV_REGISTER_CPU_MANAGEMENT_FEATURES_INFO		= 0x00000204,
932 	HV_REGISTER_SVM_FEATURES_INFO				= 0x00000205,
933 	HV_REGISTER_SKIP_LEVEL_FEATURES_INFO			= 0x00000206,
934 	HV_REGISTER_NESTED_VIRT_FEATURES_INFO			= 0x00000207,
935 	HV_REGISTER_IPT_FEATURES_INFO				= 0x00000208,
936 
937 	/* Guest Crash Registers */
938 	HV_REGISTER_GUEST_CRASH_P0				= 0x00000210,
939 	HV_REGISTER_GUEST_CRASH_P1				= 0x00000211,
940 	HV_REGISTER_GUEST_CRASH_P2				= 0x00000212,
941 	HV_REGISTER_GUEST_CRASH_P3				= 0x00000213,
942 	HV_REGISTER_GUEST_CRASH_P4				= 0x00000214,
943 	HV_REGISTER_GUEST_CRASH_CTL				= 0x00000215,
944 
945 	/* Misc */
946 	HV_REGISTER_VP_RUNTIME					= 0x00090000,
947 	HV_REGISTER_GUEST_OS_ID					= 0x00090002,
948 	HV_REGISTER_VP_INDEX					= 0x00090003,
949 	HV_REGISTER_TIME_REF_COUNT				= 0x00090004,
950 	HV_REGISTER_CPU_MANAGEMENT_VERSION			= 0x00090007,
951 	HV_REGISTER_VP_ASSIST_PAGE				= 0x00090013,
952 	HV_REGISTER_VP_ROOT_SIGNAL_COUNT			= 0x00090014,
953 	HV_REGISTER_REFERENCE_TSC				= 0x00090017,
954 
955 	/* Hypervisor-defined Registers (Synic) */
956 	HV_REGISTER_SINT0					= 0x000A0000,
957 	HV_REGISTER_SINT1					= 0x000A0001,
958 	HV_REGISTER_SINT2					= 0x000A0002,
959 	HV_REGISTER_SINT3					= 0x000A0003,
960 	HV_REGISTER_SINT4					= 0x000A0004,
961 	HV_REGISTER_SINT5					= 0x000A0005,
962 	HV_REGISTER_SINT6					= 0x000A0006,
963 	HV_REGISTER_SINT7					= 0x000A0007,
964 	HV_REGISTER_SINT8					= 0x000A0008,
965 	HV_REGISTER_SINT9					= 0x000A0009,
966 	HV_REGISTER_SINT10					= 0x000A000A,
967 	HV_REGISTER_SINT11					= 0x000A000B,
968 	HV_REGISTER_SINT12					= 0x000A000C,
969 	HV_REGISTER_SINT13					= 0x000A000D,
970 	HV_REGISTER_SINT14					= 0x000A000E,
971 	HV_REGISTER_SINT15					= 0x000A000F,
972 	HV_REGISTER_SCONTROL					= 0x000A0010,
973 	HV_REGISTER_SVERSION					= 0x000A0011,
974 	HV_REGISTER_SIEFP					= 0x000A0012,
975 	HV_REGISTER_SIMP					= 0x000A0013,
976 	HV_REGISTER_EOM						= 0x000A0014,
977 	HV_REGISTER_SIRBP					= 0x000A0015,
978 
979 	HV_REGISTER_NESTED_SINT0				= 0x000A1000,
980 	HV_REGISTER_NESTED_SINT1				= 0x000A1001,
981 	HV_REGISTER_NESTED_SINT2				= 0x000A1002,
982 	HV_REGISTER_NESTED_SINT3				= 0x000A1003,
983 	HV_REGISTER_NESTED_SINT4				= 0x000A1004,
984 	HV_REGISTER_NESTED_SINT5				= 0x000A1005,
985 	HV_REGISTER_NESTED_SINT6				= 0x000A1006,
986 	HV_REGISTER_NESTED_SINT7				= 0x000A1007,
987 	HV_REGISTER_NESTED_SINT8				= 0x000A1008,
988 	HV_REGISTER_NESTED_SINT9				= 0x000A1009,
989 	HV_REGISTER_NESTED_SINT10				= 0x000A100A,
990 	HV_REGISTER_NESTED_SINT11				= 0x000A100B,
991 	HV_REGISTER_NESTED_SINT12				= 0x000A100C,
992 	HV_REGISTER_NESTED_SINT13				= 0x000A100D,
993 	HV_REGISTER_NESTED_SINT14				= 0x000A100E,
994 	HV_REGISTER_NESTED_SINT15				= 0x000A100F,
995 	HV_REGISTER_NESTED_SCONTROL				= 0x000A1010,
996 	HV_REGISTER_NESTED_SVERSION				= 0x000A1011,
997 	HV_REGISTER_NESTED_SIFP					= 0x000A1012,
998 	HV_REGISTER_NESTED_SIPP					= 0x000A1013,
999 	HV_REGISTER_NESTED_EOM					= 0x000A1014,
1000 	HV_REGISTER_NESTED_SIRBP				= 0x000a1015,
1001 
1002 	/* Hypervisor-defined Registers (Synthetic Timers) */
1003 	HV_REGISTER_STIMER0_CONFIG				= 0x000B0000,
1004 	HV_REGISTER_STIMER0_COUNT				= 0x000B0001,
1005 
1006 	/* VSM */
1007 	HV_REGISTER_VSM_VP_STATUS				= 0x000D0003,
1008 };
1009 
1010 /*
1011  * Arch compatibility regs for use with hv_set/get_register
1012  */
1013 #if defined(CONFIG_X86)
1014 
1015 /*
1016  * To support arch-generic code calling hv_set/get_register:
1017  * - On x86, HV_MSR_ indicates an MSR accessed via rdmsrq/wrmsrq
1018  * - On ARM, HV_MSR_ indicates a VP register accessed via hypercall
1019  */
1020 #define HV_MSR_CRASH_P0		(HV_X64_MSR_CRASH_P0)
1021 #define HV_MSR_CRASH_P1		(HV_X64_MSR_CRASH_P1)
1022 #define HV_MSR_CRASH_P2		(HV_X64_MSR_CRASH_P2)
1023 #define HV_MSR_CRASH_P3		(HV_X64_MSR_CRASH_P3)
1024 #define HV_MSR_CRASH_P4		(HV_X64_MSR_CRASH_P4)
1025 #define HV_MSR_CRASH_CTL	(HV_X64_MSR_CRASH_CTL)
1026 
1027 #define HV_MSR_VP_INDEX		(HV_X64_MSR_VP_INDEX)
1028 #define HV_MSR_TIME_REF_COUNT	(HV_X64_MSR_TIME_REF_COUNT)
1029 #define HV_MSR_REFERENCE_TSC	(HV_X64_MSR_REFERENCE_TSC)
1030 
1031 #define HV_MSR_SINT0		(HV_X64_MSR_SINT0)
1032 #define HV_MSR_SVERSION		(HV_X64_MSR_SVERSION)
1033 #define HV_MSR_SCONTROL		(HV_X64_MSR_SCONTROL)
1034 #define HV_MSR_SIEFP		(HV_X64_MSR_SIEFP)
1035 #define HV_MSR_SIMP		(HV_X64_MSR_SIMP)
1036 #define HV_MSR_EOM		(HV_X64_MSR_EOM)
1037 #define HV_MSR_SIRBP		(HV_X64_MSR_SIRBP)
1038 
1039 #define HV_MSR_NESTED_SCONTROL	(HV_X64_MSR_NESTED_SCONTROL)
1040 #define HV_MSR_NESTED_SVERSION	(HV_X64_MSR_NESTED_SVERSION)
1041 #define HV_MSR_NESTED_SIEFP	(HV_X64_MSR_NESTED_SIEFP)
1042 #define HV_MSR_NESTED_SIMP	(HV_X64_MSR_NESTED_SIMP)
1043 #define HV_MSR_NESTED_EOM	(HV_X64_MSR_NESTED_EOM)
1044 #define HV_MSR_NESTED_SINT0	(HV_X64_MSR_NESTED_SINT0)
1045 
1046 #define HV_MSR_STIMER0_CONFIG	(HV_X64_MSR_STIMER0_CONFIG)
1047 #define HV_MSR_STIMER0_COUNT	(HV_X64_MSR_STIMER0_COUNT)
1048 
1049 #elif defined(CONFIG_ARM64) /* CONFIG_X86 */
1050 
1051 #define HV_MSR_CRASH_P0		(HV_REGISTER_GUEST_CRASH_P0)
1052 #define HV_MSR_CRASH_P1		(HV_REGISTER_GUEST_CRASH_P1)
1053 #define HV_MSR_CRASH_P2		(HV_REGISTER_GUEST_CRASH_P2)
1054 #define HV_MSR_CRASH_P3		(HV_REGISTER_GUEST_CRASH_P3)
1055 #define HV_MSR_CRASH_P4		(HV_REGISTER_GUEST_CRASH_P4)
1056 #define HV_MSR_CRASH_CTL	(HV_REGISTER_GUEST_CRASH_CTL)
1057 
1058 #define HV_MSR_VP_INDEX		(HV_REGISTER_VP_INDEX)
1059 #define HV_MSR_TIME_REF_COUNT	(HV_REGISTER_TIME_REF_COUNT)
1060 #define HV_MSR_REFERENCE_TSC	(HV_REGISTER_REFERENCE_TSC)
1061 
1062 #define HV_MSR_SINT0		(HV_REGISTER_SINT0)
1063 #define HV_MSR_SCONTROL		(HV_REGISTER_SCONTROL)
1064 #define HV_MSR_SIEFP		(HV_REGISTER_SIEFP)
1065 #define HV_MSR_SIMP		(HV_REGISTER_SIMP)
1066 #define HV_MSR_EOM		(HV_REGISTER_EOM)
1067 #define HV_MSR_SIRBP		(HV_REGISTER_SIRBP)
1068 
1069 #define HV_MSR_STIMER0_CONFIG	(HV_REGISTER_STIMER0_CONFIG)
1070 #define HV_MSR_STIMER0_COUNT	(HV_REGISTER_STIMER0_COUNT)
1071 
1072 #endif /* CONFIG_ARM64 */
1073 
1074 union hv_explicit_suspend_register {
1075 	u64 as_uint64;
1076 	struct {
1077 		u64 suspended : 1;
1078 		u64 reserved : 63;
1079 	} __packed;
1080 };
1081 
1082 union hv_intercept_suspend_register {
1083 	u64 as_uint64;
1084 	struct {
1085 		u64 suspended : 1;
1086 		u64 reserved : 63;
1087 	} __packed;
1088 };
1089 
1090 union hv_dispatch_suspend_register {
1091 	u64 as_uint64;
1092 	struct {
1093 		u64 suspended : 1;
1094 		u64 reserved : 63;
1095 	} __packed;
1096 };
1097 
1098 union hv_arm64_pending_interruption_register {
1099 	u64 as_uint64;
1100 	struct {
1101 		u64 interruption_pending : 1;
1102 		u64 interruption_type: 1;
1103 		u64 reserved : 30;
1104 		u64 error_code : 32;
1105 	} __packed;
1106 };
1107 
1108 union hv_arm64_interrupt_state_register {
1109 	u64 as_uint64;
1110 	struct {
1111 		u64 interrupt_shadow : 1;
1112 		u64 reserved : 63;
1113 	} __packed;
1114 };
1115 
1116 union hv_arm64_pending_synthetic_exception_event {
1117 	u64 as_uint64[2];
1118 	struct {
1119 		u8 event_pending : 1;
1120 		u8 event_type : 3;
1121 		u8 reserved : 4;
1122 		u8 rsvd[3];
1123 		u32 exception_type;
1124 		u64 context;
1125 	} __packed;
1126 };
1127 
1128 union hv_x64_interrupt_state_register {
1129 	u64 as_uint64;
1130 	struct {
1131 		u64 interrupt_shadow : 1;
1132 		u64 nmi_masked : 1;
1133 		u64 reserved : 62;
1134 	} __packed;
1135 };
1136 
1137 union hv_x64_pending_interruption_register {
1138 	u64 as_uint64;
1139 	struct {
1140 		u32 interruption_pending : 1;
1141 		u32 interruption_type : 3;
1142 		u32 deliver_error_code : 1;
1143 		u32 instruction_length : 4;
1144 		u32 nested_event : 1;
1145 		u32 reserved : 6;
1146 		u32 interruption_vector : 16;
1147 		u32 error_code;
1148 	} __packed;
1149 };
1150 
1151 union hv_register_value {
1152 	struct hv_u128 reg128;
1153 	u64 reg64;
1154 	u32 reg32;
1155 	u16 reg16;
1156 	u8 reg8;
1157 
1158 	struct hv_x64_segment_register segment;
1159 	struct hv_x64_table_register table;
1160 	union hv_explicit_suspend_register explicit_suspend;
1161 	union hv_intercept_suspend_register intercept_suspend;
1162 	union hv_dispatch_suspend_register dispatch_suspend;
1163 #ifdef CONFIG_ARM64
1164 	union hv_arm64_interrupt_state_register interrupt_state;
1165 	union hv_arm64_pending_interruption_register pending_interruption;
1166 #endif
1167 #ifdef CONFIG_X86
1168 	union hv_x64_interrupt_state_register interrupt_state;
1169 	union hv_x64_pending_interruption_register pending_interruption;
1170 #endif
1171 	union hv_arm64_pending_synthetic_exception_event pending_synthetic_exception_event;
1172 };
1173 
1174 /* NOTE: Linux helper struct - NOT from Hyper-V code. */
1175 struct hv_output_get_vp_registers {
1176 	DECLARE_FLEX_ARRAY(union hv_register_value, values);
1177 };
1178 
1179 #if defined(CONFIG_ARM64)
1180 /* HvGetVpRegisters returns an array of these output elements */
1181 struct hv_get_vp_registers_output {
1182 	union {
1183 		struct {
1184 			u32 a;
1185 			u32 b;
1186 			u32 c;
1187 			u32 d;
1188 		} as32 __packed;
1189 		struct {
1190 			u64 low;
1191 			u64 high;
1192 		} as64 __packed;
1193 	};
1194 };
1195 
1196 #endif /* CONFIG_ARM64 */
1197 
1198 struct hv_register_assoc {
1199 	u32 name;			/* enum hv_register_name */
1200 	u32 reserved1;
1201 	u64 reserved2;
1202 	union hv_register_value value;
1203 } __packed;
1204 
1205 struct hv_input_get_vp_registers {
1206 	u64 partition_id;
1207 	u32 vp_index;
1208 	union hv_input_vtl input_vtl;
1209 	u8  rsvd_z8;
1210 	u16 rsvd_z16;
1211 	u32 names[];
1212 } __packed;
1213 
1214 struct hv_input_set_vp_registers {
1215 	u64 partition_id;
1216 	u32 vp_index;
1217 	union hv_input_vtl input_vtl;
1218 	u8  rsvd_z8;
1219 	u16 rsvd_z16;
1220 	struct hv_register_assoc elements[];
1221 } __packed;
1222 
1223 #define HV_UNMAP_GPA_LARGE_PAGE		0x2
1224 
1225 /* HvCallSendSyntheticClusterIpi hypercall */
1226 struct hv_send_ipi {	 /* HV_INPUT_SEND_SYNTHETIC_CLUSTER_IPI */
1227 	u32 vector;
1228 	u32 reserved;
1229 	u64 cpu_mask;
1230 } __packed;
1231 
1232 #define	HV_VTL_MASK			GENMASK(3, 0)
1233 
1234 /* Hyper-V memory host visibility */
1235 enum hv_mem_host_visibility {
1236 	VMBUS_PAGE_NOT_VISIBLE		= 0,
1237 	VMBUS_PAGE_VISIBLE_READ_ONLY	= 1,
1238 	VMBUS_PAGE_VISIBLE_READ_WRITE	= 3
1239 };
1240 
1241 /* HvCallModifySparseGpaPageHostVisibility hypercall */
1242 #define HV_MAX_MODIFY_GPA_REP_COUNT	((HV_HYP_PAGE_SIZE / sizeof(u64)) - 2)
1243 struct hv_gpa_range_for_visibility {
1244 	u64 partition_id;
1245 	u32 host_visibility : 2;
1246 	u32 reserved0 : 30;
1247 	u32 reserved1;
1248 	u64 gpa_page_list[HV_MAX_MODIFY_GPA_REP_COUNT];
1249 } __packed;
1250 
1251 #if defined(CONFIG_X86)
1252 union hv_msi_address_register { /* HV_MSI_ADDRESS */
1253 	u32 as_uint32;
1254 	struct {
1255 		u32 reserved1 : 2;
1256 		u32 destination_mode : 1;
1257 		u32 redirection_hint : 1;
1258 		u32 reserved2 : 8;
1259 		u32 destination_id : 8;
1260 		u32 msi_base : 12;
1261 	};
1262 } __packed;
1263 
1264 union hv_msi_data_register {	 /* HV_MSI_ENTRY.Data */
1265 	u32 as_uint32;
1266 	struct {
1267 		u32 vector : 8;
1268 		u32 delivery_mode : 3;
1269 		u32 reserved1 : 3;
1270 		u32 level_assert : 1;
1271 		u32 trigger_mode : 1;
1272 		u32 reserved2 : 16;
1273 	};
1274 } __packed;
1275 
1276 union hv_msi_entry {	 /* HV_MSI_ENTRY */
1277 
1278 	u64 as_uint64;
1279 	struct {
1280 		union hv_msi_address_register address;
1281 		union hv_msi_data_register data;
1282 	} __packed;
1283 };
1284 
1285 #elif defined(CONFIG_ARM64) /* CONFIG_X86 */
1286 
1287 union hv_msi_entry {
1288 	u64 as_uint64[2];
1289 	struct {
1290 		u64 address;
1291 		u32 data;
1292 		u32 reserved;
1293 	} __packed;
1294 };
1295 #endif /* CONFIG_ARM64 */
1296 
1297 union hv_ioapic_rte {
1298 	u64 as_uint64;
1299 
1300 	struct {
1301 		u32 vector : 8;
1302 		u32 delivery_mode : 3;
1303 		u32 destination_mode : 1;
1304 		u32 delivery_status : 1;
1305 		u32 interrupt_polarity : 1;
1306 		u32 remote_irr : 1;
1307 		u32 trigger_mode : 1;
1308 		u32 interrupt_mask : 1;
1309 		u32 reserved1 : 15;
1310 
1311 		u32 reserved2 : 24;
1312 		u32 destination_id : 8;
1313 	};
1314 
1315 	struct {
1316 		u32 low_uint32;
1317 		u32 high_uint32;
1318 	};
1319 } __packed;
1320 
1321 enum hv_interrupt_source {	 /* HV_INTERRUPT_SOURCE */
1322 	HV_INTERRUPT_SOURCE_MSI = 1, /* MSI and MSI-X */
1323 	HV_INTERRUPT_SOURCE_IOAPIC,
1324 };
1325 
1326 struct hv_interrupt_entry {	 /* HV_INTERRUPT_ENTRY */
1327 	u32 source;
1328 	u32 reserved1;
1329 	union {
1330 		union hv_msi_entry msi_entry;
1331 		union hv_ioapic_rte ioapic_rte;
1332 	};
1333 } __packed;
1334 
1335 #define HV_DEVICE_INTERRUPT_TARGET_MULTICAST		1
1336 #define HV_DEVICE_INTERRUPT_TARGET_PROCESSOR_SET	2
1337 
1338 struct hv_device_interrupt_target {	 /* HV_DEVICE_INTERRUPT_TARGET */
1339 	u32 vector;
1340 	u32 flags;		/* HV_DEVICE_INTERRUPT_TARGET_* above */
1341 	union {
1342 		u64 vp_mask;
1343 		struct hv_vpset vp_set;
1344 	};
1345 } __packed;
1346 
1347 struct hv_retarget_device_interrupt {	 /* HV_INPUT_RETARGET_DEVICE_INTERRUPT */
1348 	u64 partition_id;		/* use "self" */
1349 	u64 device_id;
1350 	struct hv_interrupt_entry int_entry;
1351 	u64 reserved2;
1352 	struct hv_device_interrupt_target int_target;
1353 } __packed __aligned(8);
1354 
1355 enum hv_intercept_type {
1356 #if defined(CONFIG_X86)
1357 	HV_INTERCEPT_TYPE_X64_IO_PORT			= 0x00000000,
1358 	HV_INTERCEPT_TYPE_X64_MSR			= 0x00000001,
1359 	HV_INTERCEPT_TYPE_X64_CPUID			= 0x00000002,
1360 #endif
1361 	HV_INTERCEPT_TYPE_EXCEPTION			= 0x00000003,
1362 	/* Used to be HV_INTERCEPT_TYPE_REGISTER */
1363 	HV_INTERCEPT_TYPE_RESERVED0			= 0x00000004,
1364 	HV_INTERCEPT_TYPE_MMIO				= 0x00000005,
1365 #if defined(CONFIG_X86)
1366 	HV_INTERCEPT_TYPE_X64_GLOBAL_CPUID		= 0x00000006,
1367 	HV_INTERCEPT_TYPE_X64_APIC_SMI			= 0x00000007,
1368 #endif
1369 	HV_INTERCEPT_TYPE_HYPERCALL			= 0x00000008,
1370 #if defined(CONFIG_X86)
1371 	HV_INTERCEPT_TYPE_X64_APIC_INIT_SIPI		= 0x00000009,
1372 	HV_INTERCEPT_MC_UPDATE_PATCH_LEVEL_MSR_READ	= 0x0000000A,
1373 	HV_INTERCEPT_TYPE_X64_APIC_WRITE		= 0x0000000B,
1374 	HV_INTERCEPT_TYPE_X64_MSR_INDEX			= 0x0000000C,
1375 #endif
1376 	HV_INTERCEPT_TYPE_MAX,
1377 	HV_INTERCEPT_TYPE_INVALID			= 0xFFFFFFFF,
1378 };
1379 
1380 union hv_intercept_parameters {
1381 	/*  HV_INTERCEPT_PARAMETERS is defined to be an 8-byte field. */
1382 	u64 as_uint64;
1383 #if defined(CONFIG_X86)
1384 	/* HV_INTERCEPT_TYPE_X64_IO_PORT */
1385 	u16 io_port;
1386 	/* HV_INTERCEPT_TYPE_X64_CPUID */
1387 	u32 cpuid_index;
1388 	/* HV_INTERCEPT_TYPE_X64_APIC_WRITE */
1389 	u32 apic_write_mask;
1390 	/* HV_INTERCEPT_TYPE_EXCEPTION */
1391 	u16 exception_vector;
1392 	/* HV_INTERCEPT_TYPE_X64_MSR_INDEX */
1393 	u32 msr_index;
1394 #endif
1395 	/* N.B. Other intercept types do not have any parameters. */
1396 };
1397 
1398 /* Data structures for HVCALL_MMIO_READ and HVCALL_MMIO_WRITE */
1399 #define HV_HYPERCALL_MMIO_MAX_DATA_LENGTH 64
1400 
1401 struct hv_mmio_read_input { /* HV_INPUT_MEMORY_MAPPED_IO_READ */
1402 	u64 gpa;
1403 	u32 size;
1404 	u32 reserved;
1405 } __packed;
1406 
1407 struct hv_mmio_read_output {
1408 	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
1409 } __packed;
1410 
1411 struct hv_mmio_write_input {
1412 	u64 gpa;
1413 	u32 size;
1414 	u32 reserved;
1415 	u8 data[HV_HYPERCALL_MMIO_MAX_DATA_LENGTH];
1416 } __packed;
1417 
1418 #endif /* _HV_HVGDK_MINI_H */
1419