HMVMXCommon.h@ 97358

Last change on this file since 97358 was 97004, checked in by vboxsync, 2 years ago
VMM/HMVMXR0: Convered two HMEVENT stack variables into static const.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 19.9 KB

Line
1	/* $Id: HMVMXCommon.h 97004 2022-10-05 13:17:28Z vboxsync $ */
2	/** @file
3	* HM/VMX - Internal header file for sharing common bits between the
4	* VMX template code (which is also used with NEM on darwin) and HM.
5	*/
6
7	/*
8	* Copyright (C) 2006-2022 Oracle and/or its affiliates.
9	*
10	* This file is part of VirtualBox base platform packages, as
11	* available from https://www.virtualbox.org.
12	*
13	* This program is free software; you can redistribute it and/or
14	* modify it under the terms of the GNU General Public License
15	* as published by the Free Software Foundation, in version 3 of the
16	* License.
17	*
18	* This program is distributed in the hope that it will be useful, but
19	* WITHOUT ANY WARRANTY; without even the implied warranty of
20	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21	* General Public License for more details.
22	*
23	* You should have received a copy of the GNU General Public License
24	* along with this program; if not, see <https://www.gnu.org/licenses>.
25	*
26	* SPDX-License-Identifier: GPL-3.0-only
27	*/
28
29	#ifndef VMM_INCLUDED_SRC_include_HMVMXCommon_h
30	#define VMM_INCLUDED_SRC_include_HMVMXCommon_h
31	#ifndef RT_WITHOUT_PRAGMA_ONCE
32	# pragma once
33	#endif
34
35	#include <VBox/cdefs.h>
36	#include <VBox/types.h>
37
38	RT_C_DECLS_BEGIN
39
40
41	/** @defgroup grp_hm_int Internal
42	* @ingroup grp_hm
43	* @internal
44	* @{
45	*/
46
47	/** @name HM_CHANGED_XXX
48	* HM CPU-context changed flags.
49	*
50	* These flags are used to keep track of which registers and state has been
51	* modified since they were imported back into the guest-CPU context.
52	*
53	* @{
54	*/
55	#define HM_CHANGED_HOST_CONTEXT UINT64_C(0x0000000000000001)
56	#define HM_CHANGED_GUEST_RIP UINT64_C(0x0000000000000004)
57	#define HM_CHANGED_GUEST_RFLAGS UINT64_C(0x0000000000000008)
58
59	#define HM_CHANGED_GUEST_RAX UINT64_C(0x0000000000000010)
60	#define HM_CHANGED_GUEST_RCX UINT64_C(0x0000000000000020)
61	#define HM_CHANGED_GUEST_RDX UINT64_C(0x0000000000000040)
62	#define HM_CHANGED_GUEST_RBX UINT64_C(0x0000000000000080)
63	#define HM_CHANGED_GUEST_RSP UINT64_C(0x0000000000000100)
64	#define HM_CHANGED_GUEST_RBP UINT64_C(0x0000000000000200)
65	#define HM_CHANGED_GUEST_RSI UINT64_C(0x0000000000000400)
66	#define HM_CHANGED_GUEST_RDI UINT64_C(0x0000000000000800)
67	#define HM_CHANGED_GUEST_R8_R15 UINT64_C(0x0000000000001000)
68	#define HM_CHANGED_GUEST_GPRS_MASK UINT64_C(0x0000000000001ff0)
69
70	#define HM_CHANGED_GUEST_ES UINT64_C(0x0000000000002000)
71	#define HM_CHANGED_GUEST_CS UINT64_C(0x0000000000004000)
72	#define HM_CHANGED_GUEST_SS UINT64_C(0x0000000000008000)
73	#define HM_CHANGED_GUEST_DS UINT64_C(0x0000000000010000)
74	#define HM_CHANGED_GUEST_FS UINT64_C(0x0000000000020000)
75	#define HM_CHANGED_GUEST_GS UINT64_C(0x0000000000040000)
76	#define HM_CHANGED_GUEST_SREG_MASK UINT64_C(0x000000000007e000)
77
78	#define HM_CHANGED_GUEST_GDTR UINT64_C(0x0000000000080000)
79	#define HM_CHANGED_GUEST_IDTR UINT64_C(0x0000000000100000)
80	#define HM_CHANGED_GUEST_LDTR UINT64_C(0x0000000000200000)
81	#define HM_CHANGED_GUEST_TR UINT64_C(0x0000000000400000)
82	#define HM_CHANGED_GUEST_TABLE_MASK UINT64_C(0x0000000000780000)
83
84	#define HM_CHANGED_GUEST_CR0 UINT64_C(0x0000000000800000)
85	#define HM_CHANGED_GUEST_CR2 UINT64_C(0x0000000001000000)
86	#define HM_CHANGED_GUEST_CR3 UINT64_C(0x0000000002000000)
87	#define HM_CHANGED_GUEST_CR4 UINT64_C(0x0000000004000000)
88	#define HM_CHANGED_GUEST_CR_MASK UINT64_C(0x0000000007800000)
89
90	#define HM_CHANGED_GUEST_APIC_TPR UINT64_C(0x0000000008000000)
91	#define HM_CHANGED_GUEST_EFER_MSR UINT64_C(0x0000000010000000)
92
93	#define HM_CHANGED_GUEST_DR0_DR3 UINT64_C(0x0000000020000000)
94	#define HM_CHANGED_GUEST_DR6 UINT64_C(0x0000000040000000)
95	#define HM_CHANGED_GUEST_DR7 UINT64_C(0x0000000080000000)
96	#define HM_CHANGED_GUEST_DR_MASK UINT64_C(0x00000000e0000000)
97
98	#define HM_CHANGED_GUEST_X87 UINT64_C(0x0000000100000000)
99	#define HM_CHANGED_GUEST_SSE_AVX UINT64_C(0x0000000200000000)
100	#define HM_CHANGED_GUEST_OTHER_XSAVE UINT64_C(0x0000000400000000)
101	#define HM_CHANGED_GUEST_XCRx UINT64_C(0x0000000800000000)
102
103	#define HM_CHANGED_GUEST_KERNEL_GS_BASE UINT64_C(0x0000001000000000)
104	#define HM_CHANGED_GUEST_SYSCALL_MSRS UINT64_C(0x0000002000000000)
105	#define HM_CHANGED_GUEST_SYSENTER_CS_MSR UINT64_C(0x0000004000000000)
106	#define HM_CHANGED_GUEST_SYSENTER_EIP_MSR UINT64_C(0x0000008000000000)
107	#define HM_CHANGED_GUEST_SYSENTER_ESP_MSR UINT64_C(0x0000010000000000)
108	#define HM_CHANGED_GUEST_SYSENTER_MSR_MASK UINT64_C(0x000001c000000000)
109	#define HM_CHANGED_GUEST_TSC_AUX UINT64_C(0x0000020000000000)
110	#define HM_CHANGED_GUEST_OTHER_MSRS UINT64_C(0x0000040000000000)
111	#define HM_CHANGED_GUEST_ALL_MSRS ( HM_CHANGED_GUEST_EFER \
112	\| HM_CHANGED_GUEST_KERNEL_GS_BASE \
113	\| HM_CHANGED_GUEST_SYSCALL_MSRS \
114	\| HM_CHANGED_GUEST_SYSENTER_MSR_MASK \
115	\| HM_CHANGED_GUEST_TSC_AUX \
116	\| HM_CHANGED_GUEST_OTHER_MSRS)
117
118	#define HM_CHANGED_GUEST_HWVIRT UINT64_C(0x0000080000000000)
119	#define HM_CHANGED_GUEST_MASK UINT64_C(0x00000ffffffffffc)
120
121	#define HM_CHANGED_KEEPER_STATE_MASK UINT64_C(0xffff000000000000)
122
123	#define HM_CHANGED_VMX_XCPT_INTERCEPTS UINT64_C(0x0001000000000000)
124	#define HM_CHANGED_VMX_GUEST_AUTO_MSRS UINT64_C(0x0002000000000000)
125	#define HM_CHANGED_VMX_GUEST_LAZY_MSRS UINT64_C(0x0004000000000000)
126	#define HM_CHANGED_VMX_ENTRY_EXIT_CTLS UINT64_C(0x0008000000000000)
127	#define HM_CHANGED_VMX_MASK UINT64_C(0x000f000000000000)
128	#define HM_CHANGED_VMX_HOST_GUEST_SHARED_STATE ( HM_CHANGED_GUEST_DR_MASK \
129	\| HM_CHANGED_VMX_GUEST_LAZY_MSRS)
130
131	#define HM_CHANGED_SVM_XCPT_INTERCEPTS UINT64_C(0x0001000000000000)
132	#define HM_CHANGED_SVM_MASK UINT64_C(0x0001000000000000)
133	#define HM_CHANGED_SVM_HOST_GUEST_SHARED_STATE HM_CHANGED_GUEST_DR_MASK
134
135	#define HM_CHANGED_ALL_GUEST ( HM_CHANGED_GUEST_MASK \
136	\| HM_CHANGED_KEEPER_STATE_MASK)
137
138	/** Mask of what state might have changed when IEM raised an exception.
139	* This is a based on IEM_CPUMCTX_EXTRN_XCPT_MASK. */
140	#define HM_CHANGED_RAISED_XCPT_MASK ( HM_CHANGED_GUEST_GPRS_MASK \
141	\| HM_CHANGED_GUEST_RIP \
142	\| HM_CHANGED_GUEST_RFLAGS \
143	\| HM_CHANGED_GUEST_SS \
144	\| HM_CHANGED_GUEST_CS \
145	\| HM_CHANGED_GUEST_CR0 \
146	\| HM_CHANGED_GUEST_CR3 \
147	\| HM_CHANGED_GUEST_CR4 \
148	\| HM_CHANGED_GUEST_APIC_TPR \
149	\| HM_CHANGED_GUEST_EFER_MSR \
150	\| HM_CHANGED_GUEST_DR7 \
151	\| HM_CHANGED_GUEST_CR2 \
152	\| HM_CHANGED_GUEST_SREG_MASK \
153	\| HM_CHANGED_GUEST_TABLE_MASK)
154
155	#ifdef VBOX_WITH_NESTED_HWVIRT_SVM
156	/** Mask of what state might have changed when \#VMEXIT is emulated. */
157	# define HM_CHANGED_SVM_VMEXIT_MASK ( HM_CHANGED_GUEST_RSP \
158	\| HM_CHANGED_GUEST_RAX \
159	\| HM_CHANGED_GUEST_RIP \
160	\| HM_CHANGED_GUEST_RFLAGS \
161	\| HM_CHANGED_GUEST_CS \
162	\| HM_CHANGED_GUEST_SS \
163	\| HM_CHANGED_GUEST_DS \
164	\| HM_CHANGED_GUEST_ES \
165	\| HM_CHANGED_GUEST_GDTR \
166	\| HM_CHANGED_GUEST_IDTR \
167	\| HM_CHANGED_GUEST_CR_MASK \
168	\| HM_CHANGED_GUEST_EFER_MSR \
169	\| HM_CHANGED_GUEST_DR6 \
170	\| HM_CHANGED_GUEST_DR7 \
171	\| HM_CHANGED_GUEST_OTHER_MSRS \
172	\| HM_CHANGED_GUEST_HWVIRT \
173	\| HM_CHANGED_SVM_MASK \
174	\| HM_CHANGED_GUEST_APIC_TPR)
175
176	/** Mask of what state might have changed when VMRUN is emulated. */
177	# define HM_CHANGED_SVM_VMRUN_MASK HM_CHANGED_SVM_VMEXIT_MASK
178	#endif
179	#ifdef VBOX_WITH_NESTED_HWVIRT_VMX
180	/** Mask of what state might have changed when VM-exit is emulated.
181	*
182	* This is currently unused, but keeping it here in case we can get away a bit more
183	* fine-grained state handling.
184	*
185	* @note Update IEM_CPUMCTX_EXTRN_VMX_VMEXIT_MASK when this changes. */
186	# define HM_CHANGED_VMX_VMEXIT_MASK ( HM_CHANGED_GUEST_CR0 \| HM_CHANGED_GUEST_CR3 \| HM_CHANGED_GUEST_CR4 \
187	\| HM_CHANGED_GUEST_DR7 \| HM_CHANGED_GUEST_DR6 \
188	\| HM_CHANGED_GUEST_EFER_MSR \
189	\| HM_CHANGED_GUEST_SYSENTER_MSR_MASK \
190	\| HM_CHANGED_GUEST_OTHER_MSRS /* for PAT MSR */ \
191	\| HM_CHANGED_GUEST_RIP \| HM_CHANGED_GUEST_RSP \| HM_CHANGED_GUEST_RFLAGS \
192	\| HM_CHANGED_GUEST_SREG_MASK \
193	\| HM_CHANGED_GUEST_TR \
194	\| HM_CHANGED_GUEST_LDTR \| HM_CHANGED_GUEST_GDTR \| HM_CHANGED_GUEST_IDTR \
195	\| HM_CHANGED_GUEST_HWVIRT )
196	#endif
197	/** @} */
198
199
200	/** Maximum number of exit reason statistics counters. */
201	#define MAX_EXITREASON_STAT 0x100
202	#define MASK_EXITREASON_STAT 0xff
203	#define MASK_INJECT_IRQ_STAT 0xff
204
205
206	/**
207	* HM event.
208	*
209	* VT-x and AMD-V common event injection structure.
210	*/
211	typedef struct HMEVENT
212	{
213	/** Whether the event is pending. */
214	uint32_t fPending;
215	/** The error-code associated with the event. */
216	uint32_t u32ErrCode;
217	/** The length of the instruction in bytes (only relevant for software
218	* interrupts or software exceptions). */
219	uint32_t cbInstr;
220	/** Alignment. */
221	uint32_t u32Padding;
222	/** The encoded event (VM-entry interruption-information for VT-x or EVENTINJ
223	* for SVM). */
224	uint64_t u64IntInfo;
225	/** Guest virtual address if this is a page-fault event. */
226	RTGCUINTPTR GCPtrFaultAddress;
227	} HMEVENT;
228	/** Pointer to a HMEVENT struct. */
229	typedef HMEVENT *PHMEVENT;
230	/** Pointer to a const HMEVENT struct. */
231	typedef const HMEVENT *PCHMEVENT;
232	AssertCompileSizeAlignment(HMEVENT, 8);
233
234	/** Initializer for a HMEVENT structure with */
235	#define HMEVENT_INIT_ONLY_INT_INFO(a_uIntInfo) { 0, 0, 0, 0, (a_uIntInfo), 0 }
236
237	/**
238	* VMX VMCS information, shared.
239	*
240	* This structure provides information maintained for and during the executing of a
241	* guest (or nested-guest) VMCS (VM control structure) using hardware-assisted VMX.
242	*
243	* Note! The members here are ordered and aligned based on estimated frequency of
244	* usage and grouped to fit within a cache line in hot code paths. Even subtle
245	* changes here have a noticeable effect in the bootsector benchmarks. Modify with
246	* care.
247	*/
248	typedef struct VMXVMCSINFOSHARED
249	{
250	/** @name Real-mode emulation state.
251	* @{ */
252	/** Set if guest was executing in real mode (extra checks). */
253	bool fWasInRealMode;
254	/** Padding. */
255	bool afPadding0[7];
256	struct
257	{
258	X86DESCATTR AttrCS;
259	X86DESCATTR AttrDS;
260	X86DESCATTR AttrES;
261	X86DESCATTR AttrFS;
262	X86DESCATTR AttrGS;
263	X86DESCATTR AttrSS;
264	X86EFLAGS Eflags;
265	bool fRealOnV86Active;
266	bool afPadding1[3];
267	} RealMode;
268	/** @} */
269
270	/** @name LBR MSR data.
271	* @{ */
272	/** List of LastBranch-From-IP MSRs. */
273	uint64_t au64LbrFromIpMsr[32];
274	/** List of LastBranch-To-IP MSRs. */
275	uint64_t au64LbrToIpMsr[32];
276	/** List of LastBranch-Info MSRs. */
277	uint64_t au64LbrInfoMsr[32];
278	/** The MSR containing the index to the most recent branch record. */
279	uint64_t u64LbrTosMsr;
280	/** The MSR containing the last event record from IP value. */
281	uint64_t u64LerFromIpMsr;
282	/** The MSR containing the last event record to IP value. */
283	uint64_t u64LerToIpMsr;
284	/** @} */
285	} VMXVMCSINFOSHARED;
286	/** Pointer to a VMXVMCSINFOSHARED struct. */
287	typedef VMXVMCSINFOSHARED *PVMXVMCSINFOSHARED;
288	/** Pointer to a const VMXVMCSINFOSHARED struct. */
289	typedef const VMXVMCSINFOSHARED *PCVMXVMCSINFOSHARED;
290	AssertCompileSizeAlignment(VMXVMCSINFOSHARED, 8);
291
292
293	/**
294	* VMX VMCS information, ring-0 only.
295	*
296	* This structure provides information maintained for and during the executing of a
297	* guest (or nested-guest) VMCS (VM control structure) using hardware-assisted VMX.
298	*
299	* Note! The members here are ordered and aligned based on estimated frequency of
300	* usage and grouped to fit within a cache line in hot code paths. Even subtle
301	* changes here have a noticeable effect in the bootsector benchmarks. Modify with
302	* care.
303	*/
304	typedef struct VMXVMCSINFO
305	{
306	/** Pointer to the bits we share with ring-3. */
307	R3R0PTRTYPE(PVMXVMCSINFOSHARED) pShared;
308
309	/** @name Auxiliary information.
310	* @{ */
311	/** Host-physical address of the EPTP. */
312	RTHCPHYS HCPhysEPTP;
313	/** The VMCS launch state, see VMX_V_VMCS_LAUNCH_STATE_XXX. */
314	uint32_t fVmcsState;
315	/** The VMCS launch state of the shadow VMCS, see VMX_V_VMCS_LAUNCH_STATE_XXX. */
316	uint32_t fShadowVmcsState;
317	/** The host CPU for which its state has been exported to this VMCS. */
318	RTCPUID idHostCpuState;
319	/** The host CPU on which we last executed this VMCS. */
320	RTCPUID idHostCpuExec;
321	/** Number of guest MSRs in the VM-entry MSR-load area. */
322	uint32_t cEntryMsrLoad;
323	/** Number of guest MSRs in the VM-exit MSR-store area. */
324	uint32_t cExitMsrStore;
325	/** Number of host MSRs in the VM-exit MSR-load area. */
326	uint32_t cExitMsrLoad;
327	/** @} */
328
329	/** @name Cache of execution related VMCS fields.
330	* @{ */
331	/** Pin-based VM-execution controls. */
332	uint32_t u32PinCtls;
333	/** Processor-based VM-execution controls. */
334	uint32_t u32ProcCtls;
335	/** Secondary processor-based VM-execution controls. */
336	uint32_t u32ProcCtls2;
337	/** Tertiary processor-based VM-execution controls. */
338	uint64_t u64ProcCtls3;
339	/** VM-entry controls. */
340	uint32_t u32EntryCtls;
341	/** VM-exit controls. */
342	uint32_t u32ExitCtls;
343	/** Exception bitmap. */
344	uint32_t u32XcptBitmap;
345	/** Page-fault exception error-code mask. */
346	uint32_t u32XcptPFMask;
347	/** Page-fault exception error-code match. */
348	uint32_t u32XcptPFMatch;
349	/** Padding. */
350	uint32_t u32Alignment0;
351	/** TSC offset. */
352	uint64_t u64TscOffset;
353	/** VMCS link pointer. */
354	uint64_t u64VmcsLinkPtr;
355	/** CR0 guest/host mask. */
356	uint64_t u64Cr0Mask;
357	/** CR4 guest/host mask. */
358	uint64_t u64Cr4Mask;
359	#ifndef IN_NEM_DARWIN
360	/** Current VMX_VMCS_HOST_RIP value (only used in HMR0A.asm). */
361	uint64_t uHostRip;
362	/** Current VMX_VMCS_HOST_RSP value (only used in HMR0A.asm). */
363	uint64_t uHostRsp;
364	#endif
365	/** @} */
366
367	/** @name Host-virtual address of VMCS and related data structures.
368	* @{ */
369	/** The VMCS. */
370	R3R0PTRTYPE(void *) pvVmcs;
371	/** The shadow VMCS. */
372	R3R0PTRTYPE(void *) pvShadowVmcs;
373	/** The virtual-APIC page. */
374	R3R0PTRTYPE(uint8_t *) pbVirtApic;
375	/** The MSR bitmap. */
376	R3R0PTRTYPE(void *) pvMsrBitmap;
377	/** The VM-entry MSR-load area. */
378	R3R0PTRTYPE(void *) pvGuestMsrLoad;
379	/** The VM-exit MSR-store area. */
380	R3R0PTRTYPE(void *) pvGuestMsrStore;
381	/** The VM-exit MSR-load area. */
382	R3R0PTRTYPE(void *) pvHostMsrLoad;
383	/** @} */
384
385	#ifndef IN_NEM_DARWIN
386	/** @name Host-physical address of VMCS and related data structures.
387	* @{ */
388	/** The VMCS. */
389	RTHCPHYS HCPhysVmcs;
390	/** The shadow VMCS. */
391	RTHCPHYS HCPhysShadowVmcs;
392	/** The virtual APIC page. */
393	RTHCPHYS HCPhysVirtApic;
394	/** The MSR bitmap. */
395	RTHCPHYS HCPhysMsrBitmap;
396	/** The VM-entry MSR-load area. */
397	RTHCPHYS HCPhysGuestMsrLoad;
398	/** The VM-exit MSR-store area. */
399	RTHCPHYS HCPhysGuestMsrStore;
400	/** The VM-exit MSR-load area. */
401	RTHCPHYS HCPhysHostMsrLoad;
402	/** @} */
403
404	/** @name R0-memory objects address for VMCS and related data structures.
405	* @{ */
406	/** R0-memory object for VMCS and related data structures. */
407	RTR0MEMOBJ hMemObj;
408	/** @} */
409	#endif
410	} VMXVMCSINFO;
411	/** Pointer to a VMXVMCSINFOR0 struct. */
412	typedef VMXVMCSINFO *PVMXVMCSINFO;
413	/** Pointer to a const VMXVMCSINFO struct. */
414	typedef const VMXVMCSINFO *PCVMXVMCSINFO;
415	AssertCompileSizeAlignment(VMXVMCSINFO, 8);
416	AssertCompileMemberAlignment(VMXVMCSINFO, u32PinCtls, 4);
417	AssertCompileMemberAlignment(VMXVMCSINFO, u64VmcsLinkPtr, 8);
418	AssertCompileMemberAlignment(VMXVMCSINFO, pvVmcs, 8);
419	AssertCompileMemberAlignment(VMXVMCSINFO, pvShadowVmcs, 8);
420	AssertCompileMemberAlignment(VMXVMCSINFO, pbVirtApic, 8);
421	AssertCompileMemberAlignment(VMXVMCSINFO, pvMsrBitmap, 8);
422	AssertCompileMemberAlignment(VMXVMCSINFO, pvGuestMsrLoad, 8);
423	AssertCompileMemberAlignment(VMXVMCSINFO, pvGuestMsrStore, 8);
424	AssertCompileMemberAlignment(VMXVMCSINFO, pvHostMsrLoad, 8);
425	#ifndef IN_NEM_DARWIN
426	AssertCompileMemberAlignment(VMXVMCSINFO, HCPhysVmcs, 8);
427	AssertCompileMemberAlignment(VMXVMCSINFO, hMemObj, 8);
428	#endif
429
430	/** @} */
431
432	RT_C_DECLS_END
433
434	#endif /* !VMM_INCLUDED_SRC_include_HMVMXCommon_h */
435

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/src/VBox/VMM/include/HMVMXCommon.h@ 97358

Download in other formats: