NEMInternal.h@ 107381

Last change on this file since 107381 was 107308, checked in by vboxsync, 2 months ago
VMM: bugref:10759 Refactor GIC for use with different backends.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 28.3 KB

Line
1	/* $Id: NEMInternal.h 107308 2024-12-13 08:09:39Z vboxsync $ */
2	/** @file
3	* NEM - Internal header file.
4	*/
5
6	/*
7	* Copyright (C) 2018-2024 Oracle and/or its affiliates.
8	*
9	* This file is part of VirtualBox base platform packages, as
10	* available from https://www.virtualbox.org.
11	*
12	* This program is free software; you can redistribute it and/or
13	* modify it under the terms of the GNU General Public License
14	* as published by the Free Software Foundation, in version 3 of the
15	* License.
16	*
17	* This program is distributed in the hope that it will be useful, but
18	* WITHOUT ANY WARRANTY; without even the implied warranty of
19	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20	* General Public License for more details.
21	*
22	* You should have received a copy of the GNU General Public License
23	* along with this program; if not, see <https://www.gnu.org/licenses>.
24	*
25	* SPDX-License-Identifier: GPL-3.0-only
26	*/
27
28	#ifndef VMM_INCLUDED_SRC_include_NEMInternal_h
29	#define VMM_INCLUDED_SRC_include_NEMInternal_h
30	#ifndef RT_WITHOUT_PRAGMA_ONCE
31	# pragma once
32	#endif
33
34	#include <VBox/cdefs.h>
35	#include <VBox/types.h>
36	#include <VBox/vmm/nem.h>
37	#include <VBox/vmm/cpum.h> /* For CPUMCPUVENDOR. */
38	#include <VBox/vmm/stam.h>
39	#include <VBox/vmm/vmapi.h>
40	#ifdef RT_OS_WINDOWS
41	# include <iprt/nt/hyperv.h>
42	# include <iprt/critsect.h>
43	#elif defined(RT_OS_DARWIN)
44	# ifdef VBOX_VMM_TARGET_ARMV8
45	# include <Hypervisor/Hypervisor.h>
46	# else
47	# include "VMXInternal.h"
48	# endif
49	#endif
50
51	RT_C_DECLS_BEGIN
52
53
54	/** @defgroup grp_nem_int Internal
55	* @ingroup grp_nem
56	* @internal
57	* @{
58	*/
59
60	#if defined(VBOX_WITH_NATIVE_NEM) && !defined(VBOX_WITH_PGM_NEM_MODE)
61	# error "VBOX_WITH_NATIVE_NEM requires VBOX_WITH_PGM_NEM_MODE to be defined"
62	#endif
63
64
65	#ifdef RT_OS_WINDOWS
66	/*
67	* Windows: Code configuration.
68	*/
69	/* nothing at the moment */
70
71	/**
72	* Windows VID I/O control information.
73	*/
74	typedef struct NEMWINIOCTL
75	{
76	/** The I/O control function number. */
77	uint32_t uFunction;
78	uint32_t cbInput;
79	uint32_t cbOutput;
80	} NEMWINIOCTL;
81
82	/** @name Windows: Our two-bit physical page state for PGMPAGE
83	* @{ */
84	# define NEM_WIN_PAGE_STATE_NOT_SET 0
85	# define NEM_WIN_PAGE_STATE_UNMAPPED 1
86	# define NEM_WIN_PAGE_STATE_READABLE 2
87	# define NEM_WIN_PAGE_STATE_WRITABLE 3
88	/** @} */
89
90	/** Windows: Checks if a_GCPhys is subject to the limited A20 gate emulation. */
91	# define NEM_WIN_IS_SUBJECT_TO_A20(a_GCPhys) ((RTGCPHYS)((a_GCPhys) - _1M) < (RTGCPHYS)_64K)
92	/** Windows: Checks if a_GCPhys is relevant to the limited A20 gate emulation. */
93	# define NEM_WIN_IS_RELEVANT_TO_A20(a_GCPhys) \
94	( ((RTGCPHYS)((a_GCPhys) - _1M) < (RTGCPHYS)_64K) \|\| ((RTGCPHYS)(a_GCPhys) < (RTGCPHYS)_64K) )
95
96	/** The CPUMCTX_EXTRN_XXX mask for IEM. */
97	# define NEM_WIN_CPUMCTX_EXTRN_MASK_FOR_IEM ( IEM_CPUMCTX_EXTRN_MUST_MASK \| CPUMCTX_EXTRN_INHIBIT_INT \
98	\| CPUMCTX_EXTRN_INHIBIT_NMI )
99	/** The CPUMCTX_EXTRN_XXX mask for IEM when raising exceptions. */
100	# define NEM_WIN_CPUMCTX_EXTRN_MASK_FOR_IEM_XCPT (IEM_CPUMCTX_EXTRN_XCPT_MASK \| NEM_WIN_CPUMCTX_EXTRN_MASK_FOR_IEM)
101
102	/** @name Windows: Interrupt window flags (NEM_WIN_INTW_F_XXX).
103	* @{ */
104	# define NEM_WIN_INTW_F_NMI UINT8_C(0x01)
105	# define NEM_WIN_INTW_F_REGULAR UINT8_C(0x02)
106	# define NEM_WIN_INTW_F_PRIO_MASK UINT8_C(0x3c)
107	# define NEM_WIN_INTW_F_PRIO_SHIFT 2
108	/** @} */
109
110	#endif /* RT_OS_WINDOWS */
111
112
113	#ifdef RT_OS_DARWIN
114	# ifndef VBOX_VMM_TARGET_ARMV8
115	/** vCPU ID declaration to avoid dragging in HV headers here. */
116	typedef unsigned hv_vcpuid_t;
117	/** The HV VM memory space ID (ASID). */
118	typedef unsigned hv_vm_space_t;
119	# endif
120
121
122	/** @name Darwin: Our two-bit physical page state for PGMPAGE
123	* @{ */
124	# define NEM_DARWIN_PAGE_STATE_UNMAPPED 0
125	# define NEM_DARWIN_PAGE_STATE_RX 1
126	# define NEM_DARWIN_PAGE_STATE_RW 2
127	# define NEM_DARWIN_PAGE_STATE_RWX 3
128	/** @} */
129
130	/** The CPUMCTX_EXTRN_XXX mask for IEM. */
131	# ifdef VBOX_VMM_TARGET_ARMV8
132	# define NEM_DARWIN_CPUMCTX_EXTRN_MASK_FOR_IEM ( IEM_CPUMCTX_EXTRN_MUST_MASK )
133	# else
134	# define NEM_DARWIN_CPUMCTX_EXTRN_MASK_FOR_IEM ( IEM_CPUMCTX_EXTRN_MUST_MASK \
135	\| CPUMCTX_EXTRN_INHIBIT_INT \| CPUMCTX_EXTRN_INHIBIT_NMI )
136	# endif
137
138	/** The CPUMCTX_EXTRN_XXX mask for IEM when raising exceptions. */
139	# define NEM_DARWIN_CPUMCTX_EXTRN_MASK_FOR_IEM_XCPT (IEM_CPUMCTX_EXTRN_XCPT_MASK \| NEM_DARWIN_CPUMCTX_EXTRN_MASK_FOR_IEM)
140
141
142	# ifdef VBOX_VMM_TARGET_ARMV8
143	/**
144	* MMIO2 tracking region.
145	*/
146	typedef struct
147	{
148	/* Start of the region. */
149	RTGCPHYS GCPhysStart;
150	/** End of the region. */
151	RTGCPHYS GCPhysLast;
152	/** Whether the region was accessed since last time. */
153	bool fDirty;
154	} NEMHVMMIO2REGION;
155	/** Pointer to a MMIO2 tracking region. */
156	typedef NEMHVMMIO2REGION *PNEMHVMMIO2REGION;
157	# endif
158
159	#endif
160
161
162	/** Trick to make slickedit see the static functions in the template. */
163	#ifndef IN_SLICKEDIT
164	# define NEM_TMPL_STATIC static
165	#else
166	# define NEM_TMPL_STATIC
167	#endif
168
169
170	/**
171	* Generic NEM exit type enumeration for use with EMHistoryAddExit.
172	*
173	* On windows we've got two different set of exit types and they are both jumping
174	* around the place value wise, so EM can use their values.
175	*
176	* @note We only have exit types for exits not covered by EM here.
177	*/
178	typedef enum NEMEXITTYPE
179	{
180	NEMEXITTYPE_INVALID = 0,
181
182	/* Common: */
183	NEMEXITTYPE_INTTERRUPT_WINDOW,
184	NEMEXITTYPE_HALT,
185
186	/* Windows: */
187	NEMEXITTYPE_UNRECOVERABLE_EXCEPTION,
188	NEMEXITTYPE_INVALID_VP_REGISTER_VALUE,
189	NEMEXITTYPE_XCPT_UD,
190	NEMEXITTYPE_XCPT_DB,
191	NEMEXITTYPE_XCPT_BP,
192	NEMEXITTYPE_CANCELED,
193	NEMEXITTYPE_MEMORY_ACCESS,
194
195	/* Linux: */
196	NEMEXITTYPE_INTERNAL_ERROR_EMULATION,
197	NEMEXITTYPE_INTERNAL_ERROR_FATAL,
198	NEMEXITTYPE_INTERRUPTED,
199	NEMEXITTYPE_FAILED_ENTRY,
200
201	/* End of valid types. */
202	NEMEXITTYPE_END
203	} NEMEXITTYPE;
204
205
206	/**
207	* NEM VM Instance data.
208	*/
209	typedef struct NEM
210	{
211	/** NEM_MAGIC. */
212	uint32_t u32Magic;
213
214	/** Set if enabled. */
215	bool fEnabled;
216	/** Set if long mode guests are allowed. */
217	bool fAllow64BitGuests;
218	/** Set when the debug facility has breakpoints/events enabled that requires
219	* us to use the debug execution loop. */
220	bool fUseDebugLoop;
221
222	#ifdef VBOX_VMM_TARGET_ARMV8
223	/** The PPI interrupt number of the vTimer. */
224	uint32_t u32GicPpiVTimer;
225	#endif
226
227	#if defined(RT_OS_LINUX)
228	/** The '/dev/kvm' file descriptor. */
229	int32_t fdKvm;
230	/** The KVM_CREATE_VM file descriptor. */
231	int32_t fdVm;
232
233	/** KVM_GET_VCPU_MMAP_SIZE. */
234	uint32_t cbVCpuMmap;
235	/** KVM_CAP_NR_MEMSLOTS. */
236	uint32_t cMaxMemSlots;
237	# ifdef RT_ARCH_ARM64
238	/** KVM_CAP_ARM_VM_IPA_SIZE. */
239	uint32_t cIpaBits;
240	# else
241	/** KVM_CAP_X86_ROBUST_SINGLESTEP. */
242	bool fRobustSingleStep;
243	# endif
244
245	/** Hint where there might be a free slot. */
246	uint16_t idPrevSlot;
247	/** Memory slot ID allocation bitmap. */
248	uint64_t bmSlotIds[_32K / 8 / sizeof(uint64_t)];
249
250	#elif defined(RT_OS_WINDOWS)
251	/** Set if we've created the EMTs. */
252	bool fCreatedEmts : 1;
253	# ifdef VBOX_VMM_TARGET_ARMV8
254	bool fHypercallExit : 1;
255	bool fGpaAccessFaultExit : 1;
256	/** Cache line flush size as a power of two. */
257	uint8_t cPhysicalAddressWidth;
258	# elif defined(VBOX_VMM_TARGET_X86)
259	/** WHvRunVpExitReasonX64Cpuid is supported. */
260	bool fExtendedMsrExit : 1;
261	/** WHvRunVpExitReasonX64MsrAccess is supported. */
262	bool fExtendedCpuIdExit : 1;
263	/** WHvRunVpExitReasonException is supported. */
264	bool fExtendedXcptExit : 1;
265	# ifdef NEM_WIN_WITH_A20
266	/** Set if we've started more than one CPU and cannot mess with A20. */
267	bool fA20Fixed : 1;
268	/** Set if A20 is enabled. */
269	bool fA20Enabled : 1;
270	# endif
271	# endif
272	/** The reported CPU vendor. */
273	CPUMCPUVENDOR enmCpuVendor;
274	/** Cache line flush size as a power of two. */
275	uint8_t cCacheLineFlushShift;
276	/** The result of WHvCapabilityCodeProcessorFeatures. */
277	union
278	{
279	/** 64-bit view. */
280	uint64_t u64;
281	# ifdef _WINHVAPIDEFS_H_
282	/** Interpreed features. */
283	WHV_PROCESSOR_FEATURES u;
284	# endif
285	} uCpuFeatures;
286
287	/** The partition handle. */
288	# ifdef _WINHVAPIDEFS_H_
289	WHV_PARTITION_HANDLE
290	# else
291	RTHCUINTPTR
292	# endif
293	hPartition;
294	/** The device handle for the partition, for use with Vid APIs or direct I/O
295	* controls. */
296	RTR3PTR hPartitionDevice;
297
298	/** Number of currently mapped pages. */
299	uint32_t volatile cMappedPages;
300	uint32_t u32Padding;
301	STAMCOUNTER StatMapPage;
302	STAMCOUNTER StatUnmapPage;
303	STAMCOUNTER StatMapPageFailed;
304	STAMCOUNTER StatUnmapPageFailed;
305	STAMPROFILE StatProfMapGpaRange;
306	STAMPROFILE StatProfUnmapGpaRange;
307	STAMPROFILE StatProfMapGpaRangePage;
308	STAMPROFILE StatProfUnmapGpaRangePage;
309
310	/** Statistics updated by NEMR0UpdateStatistics. */
311	struct
312	{
313	uint64_t cPagesAvailable;
314	uint64_t cPagesInUse;
315	} R0Stats;
316
317	# ifdef VBOX_VMM_TARGET_ARMV8
318	/** Re-distributor memory region for all vCPUs. */
319	RTGCPHYS GCPhysMmioBaseReDist;
320	/** Number of breakpoints supported (for syncing registers). */
321	uint32_t cBreakpoints;
322	/** Number of watchpoints supported (for syncing registers). */
323	uint32_t cWatchpoints;
324	# endif
325
326	#elif defined(RT_OS_DARWIN)
327	/** Set if we've created the EMTs. */
328	bool fCreatedEmts : 1;
329	/** Set if hv_vm_create() was called successfully. */
330	bool fCreatedVm : 1;
331	/** Set if EL2 is enabled. */
332	bool fEl2Enabled : 1;
333	# ifdef VBOX_VMM_TARGET_ARMV8
334	/** @name vTimer related state.
335	* @{ */
336	/** The counter frequency in Hz as obtained from CNTFRQ_EL0. */
337	uint64_t u64CntFrqHz;
338	/** The vTimer offset programmed. */
339	uint64_t u64VTimerOff;
340	/** Dirty tracking slots. */
341	NEMHVMMIO2REGION aMmio2DirtyTracking[8];
342	/** The vCPU config. */
343	hv_vcpu_config_t hVCpuCfg;
344	/** @} */
345	# elif defined(VBOX_VMM_TARGET_X86)
346	/** Set if hv_vm_space_create() was called successfully. */
347	bool fCreatedAsid : 1;
348	/** Set if Last Branch Record (LBR) is enabled. */
349	bool fLbr;
350	/** The ASID for this VM (only valid if fCreatedAsid is true). */
351	hv_vm_space_t uVmAsid;
352	/** Number of mach time units per NS, for hv_vcpu_run_until(). */
353	uint64_t cMachTimePerNs;
354	/** Pause-loop exiting (PLE) gap in ticks. */
355	uint32_t cPleGapTicks;
356	/** Pause-loop exiting (PLE) window in ticks. */
357	uint32_t cPleWindowTicks;
358
359	/** The host LBR TOS (top-of-stack) MSR id. */
360	uint32_t idLbrTosMsr;
361	/** The host LBR select MSR id. */
362	uint32_t idLbrSelectMsr;
363	/** The host last event record from IP MSR id. */
364	uint32_t idLerFromIpMsr;
365	/** The host last event record to IP MSR id. */
366	uint32_t idLerToIpMsr;
367
368	/** The first valid host LBR branch-from-IP stack range. */
369	uint32_t idLbrFromIpMsrFirst;
370	/** The last valid host LBR branch-from-IP stack range. */
371	uint32_t idLbrFromIpMsrLast;
372
373	/** The first valid host LBR branch-to-IP stack range. */
374	uint32_t idLbrToIpMsrFirst;
375	/** The last valid host LBR branch-to-IP stack range. */
376	uint32_t idLbrToIpMsrLast;
377
378	/** The first valid host LBR info stack range. */
379	uint32_t idLbrInfoMsrFirst;
380	/** The last valid host LBR info stack range. */
381	uint32_t idLbrInfoMsrLast;
382	# endif /* VBOX_VMM_TARGET_X86 */
383
384	STAMCOUNTER StatMapPage;
385	STAMCOUNTER StatUnmapPage;
386	STAMCOUNTER StatMapPageFailed;
387	STAMCOUNTER StatUnmapPageFailed;
388	#endif /* RT_OS_DARWIN */
389	} NEM;
390	/** Pointer to NEM VM instance data. */
391	typedef NEM *PNEM;
392
393	/** NEM::u32Magic value. */
394	#define NEM_MAGIC UINT32_C(0x004d454e)
395	/** NEM::u32Magic value after termination. */
396	#define NEM_MAGIC_DEAD UINT32_C(0xdead1111)
397
398
399	/**
400	* NEM VMCPU Instance data.
401	*/
402	typedef struct NEMCPU
403	{
404	/** NEMCPU_MAGIC. */
405	uint32_t u32Magic;
406	/** Whether \#UD needs to be intercepted and presented to GIM. */
407	bool fGIMTrapXcptUD : 1;
408	/** Whether \#GP needs to be intercept for mesa driver workaround. */
409	bool fTrapXcptGpForLovelyMesaDrv: 1;
410	/** Whether we should use the debug loop because of single stepping or special
411	* debug breakpoints / events are armed. */
412	bool fUseDebugLoop : 1;
413	/** Whether we're executing a single instruction. */
414	bool fSingleInstruction : 1;
415	/** Set if we using the debug loop and wish to intercept RDTSC. */
416	bool fDebugWantRdTscExit : 1;
417	/** Whether we are currently executing in the debug loop.
418	* Mainly for assertions. */
419	bool fUsingDebugLoop : 1;
420	/** Set if we need to clear the trap flag because of single stepping. */
421	bool fClearTrapFlag : 1;
422	/** Whether we're using the hyper DR7 or guest DR7. */
423	bool fUsingHyperDR7 : 1;
424	/** Whether \#DE needs to be intercepted for GIM. */
425	bool fGCMTrapXcptDE : 1;
426
427	#if defined(RT_OS_LINUX)
428	uint8_t abPadding[3];
429	/** The KVM VCpu file descriptor. */
430	int32_t fdVCpu;
431	/** Pointer to the KVM_RUN data exchange region. */
432	R3PTRTYPE(struct kvm_run *) pRun;
433	# ifdef VBOX_VMM_TARGET_ARMV8
434	/** The IRQ device levels from device_irq_level. */
435	uint64_t fIrqDeviceLvls;
436	/** Status of the IRQ line when last seen. */
437	bool fIrqLastSeen;
438	/** Status of the FIQ line when last seen. */
439	bool fFiqLastSeen;
440	# elif defined(VBOX_VMM_TARGET_X86)
441	/** The MSR_IA32_APICBASE value known to KVM. */
442	uint64_t uKvmApicBase;
443	# endif
444
445	/** @name Statistics
446	* @{ */
447	STAMCOUNTER StatExitTotal;
448	STAMCOUNTER StatExitIo;
449	STAMCOUNTER StatExitMmio;
450	STAMCOUNTER StatExitSetTpr;
451	STAMCOUNTER StatExitTprAccess;
452	STAMCOUNTER StatExitRdMsr;
453	STAMCOUNTER StatExitWrMsr;
454	STAMCOUNTER StatExitIrqWindowOpen;
455	STAMCOUNTER StatExitHalt;
456	STAMCOUNTER StatExitIntr;
457	STAMCOUNTER StatExitHypercall;
458	STAMCOUNTER StatExitDebug;
459	STAMCOUNTER StatExitBusLock;
460	STAMCOUNTER StatExitInternalErrorEmulation;
461	STAMCOUNTER StatExitInternalErrorFatal;
462	# if 0
463	STAMCOUNTER StatExitCpuId;
464	STAMCOUNTER StatExitUnrecoverable;
465	STAMCOUNTER StatGetMsgTimeout;
466	STAMCOUNTER StatStopCpuSuccess;
467	STAMCOUNTER StatStopCpuPending;
468	STAMCOUNTER StatStopCpuPendingAlerts;
469	STAMCOUNTER StatStopCpuPendingOdd;
470	STAMCOUNTER StatCancelChangedState;
471	STAMCOUNTER StatCancelAlertedThread;
472	# endif
473	STAMCOUNTER StatBreakOnCancel;
474	STAMCOUNTER StatBreakOnFFPre;
475	STAMCOUNTER StatBreakOnFFPost;
476	STAMCOUNTER StatBreakOnStatus;
477	STAMCOUNTER StatFlushExitOnReturn;
478	STAMCOUNTER StatFlushExitOnReturn1Loop;
479	STAMCOUNTER StatFlushExitOnReturn2Loops;
480	STAMCOUNTER StatFlushExitOnReturn3Loops;
481	STAMCOUNTER StatFlushExitOnReturn4PlusLoops;
482	STAMCOUNTER StatImportOnDemand;
483	STAMCOUNTER StatImportOnReturn;
484	STAMCOUNTER StatImportOnReturnSkipped;
485	STAMCOUNTER StatImportPendingInterrupt;
486	STAMCOUNTER StatExportPendingInterrupt;
487	STAMCOUNTER StatQueryCpuTick;
488	/** @} */
489
490
491	#elif defined(RT_OS_WINDOWS)
492	# ifdef VBOX_VMM_TARGET_X86
493	/** The current state of the interrupt windows (NEM_WIN_INTW_F_XXX). */
494	uint8_t fCurrentInterruptWindows;
495	/** The desired state of the interrupt windows (NEM_WIN_INTW_F_XXX). */
496	uint8_t fDesiredInterruptWindows;
497	/** Last copy of HV_X64_VP_EXECUTION_STATE::InterruptShadow. */
498	bool fLastInterruptShadow : 1;
499	uint32_t uPadding;
500	/** The VID_MSHAGN_F_XXX flags.
501	* Either VID_MSHAGN_F_HANDLE_MESSAGE \| VID_MSHAGN_F_GET_NEXT_MESSAGE or zero. */
502	uint32_t fHandleAndGetFlags;
503	/** What VidMessageSlotMap returns and is used for passing exit info. */
504	RTR3PTR pvMsgSlotMapping;
505	/** The windows thread handle. */
506	RTR3PTR hNativeThreadHandle;
507	# endif
508
509	/** @name Statistics
510	* @{ */
511	STAMCOUNTER StatExitPortIo;
512	STAMCOUNTER StatExitMemUnmapped;
513	STAMCOUNTER StatExitMemIntercept;
514	STAMCOUNTER StatExitHalt;
515	STAMCOUNTER StatExitInterruptWindow;
516	STAMCOUNTER StatExitCpuId;
517	STAMCOUNTER StatExitMsr;
518	STAMCOUNTER StatExitException;
519	STAMCOUNTER StatExitExceptionBp;
520	STAMCOUNTER StatExitExceptionDb;
521	STAMCOUNTER StatExitExceptionGp;
522	STAMCOUNTER StatExitExceptionGpMesa;
523	STAMCOUNTER StatExitExceptionUd;
524	STAMCOUNTER StatExitExceptionUdHandled;
525	STAMCOUNTER StatExitUnrecoverable;
526	STAMCOUNTER StatGetMsgTimeout;
527	STAMCOUNTER StatStopCpuSuccess;
528	STAMCOUNTER StatStopCpuPending;
529	STAMCOUNTER StatStopCpuPendingAlerts;
530	STAMCOUNTER StatStopCpuPendingOdd;
531	STAMCOUNTER StatCancelChangedState;
532	STAMCOUNTER StatCancelAlertedThread;
533	STAMCOUNTER StatBreakOnCancel;
534	STAMCOUNTER StatBreakOnFFPre;
535	STAMCOUNTER StatBreakOnFFPost;
536	STAMCOUNTER StatBreakOnStatus;
537	STAMCOUNTER StatImportOnDemand;
538	STAMCOUNTER StatImportOnReturn;
539	STAMCOUNTER StatImportOnReturnSkipped;
540	STAMCOUNTER StatQueryCpuTick;
541	/** @} */
542
543	#elif defined(RT_OS_DARWIN)
544	# ifdef VBOX_VMM_TARGET_ARMV8
545	/** The vCPU handle associated with the EMT executing this vCPU. */
546	hv_vcpu_t hVCpu;
547	/** Pointer to the exit information structure. */
548	hv_vcpu_exit_t *pHvExit;
549	/** Flag whether an event is pending. */
550	bool fEventPending;
551	/** Flag whether the vTimer got activated and is masked. */
552	bool fVTimerActivated;
553	/** Flag whether to update the vTimer offset. */
554	bool fVTimerOffUpdate;
555	/** Flag whether the ID registers were synced to the guest context
556	* (for first guest exec call on the EMT after loading the saved state). */
557	bool fIdRegsSynced;
558
559	# elif defined(VBOX_VMM_TARGET_X86)
560	/** The vCPU handle associated with the EMT executing this vCPU. */
561	hv_vcpuid_t hVCpuId;
562
563	/** @name State shared with the VT-x code.
564	* @{ */
565	/** An additional error code used for some gurus. */
566	uint32_t u32HMError;
567	/** The last exit-to-ring-3 reason. */
568	int32_t rcLastExitToR3;
569	/** CPU-context changed flags (see HM_CHANGED_xxx). */
570	uint64_t fCtxChanged;
571
572	/** The guest VMCS information. */
573	VMXVMCSINFO VmcsInfo;
574
575	/** VT-x data. */
576	struct HMCPUVMX
577	{
578	/** @name Guest information.
579	* @{ */
580	/** Guest VMCS information shared with ring-3. */
581	VMXVMCSINFOSHARED VmcsInfo;
582	/** Nested-guest VMCS information shared with ring-3. */
583	VMXVMCSINFOSHARED VmcsInfoNstGst;
584	/** Whether the nested-guest VMCS was the last current VMCS (shadow copy for ring-3).
585	* @see HMR0PERVCPU::vmx.fSwitchedToNstGstVmcs */
586	bool fSwitchedToNstGstVmcsCopyForRing3;
587	/** Whether the static guest VMCS controls has been merged with the
588	* nested-guest VMCS controls. */
589	bool fMergedNstGstCtls;
590	/** Whether the nested-guest VMCS has been copied to the shadow VMCS. */
591	bool fCopiedNstGstToShadowVmcs;
592	/** Whether flushing the TLB is required due to switching to/from the
593	* nested-guest. */
594	bool fSwitchedNstGstFlushTlb;
595	/** Alignment. */
596	bool afAlignment0[4];
597	/** Cached guest APIC-base MSR for identifying when to map the APIC-access page. */
598	uint64_t u64GstMsrApicBase;
599	/** @} */
600
601	/** @name Error reporting and diagnostics.
602	* @{ */
603	/** VT-x error-reporting (mainly for ring-3 propagation). */
604	struct
605	{
606	RTCPUID idCurrentCpu;
607	RTCPUID idEnteredCpu;
608	RTHCPHYS HCPhysCurrentVmcs;
609	uint32_t u32VmcsRev;
610	uint32_t u32InstrError;
611	uint32_t u32ExitReason;
612	uint32_t u32GuestIntrState;
613	} LastError;
614	/** @} */
615	} vmx;
616
617	/** Event injection state. */
618	HMEVENT Event;
619
620	/** Current shadow paging mode for updating CR4.
621	* @todo move later (@bugref{9217}). */
622	PGMMODE enmShadowMode;
623	uint32_t u32TemporaryPadding;
624
625	/** The PAE PDPEs used with Nested Paging (only valid when
626	* VMCPU_FF_HM_UPDATE_PAE_PDPES is set). */
627	X86PDPE aPdpes[4];
628	/** Pointer to the VMX statistics. */
629	PVMXSTATISTICS pVmxStats;
630	# endif /* VBOX_VMM_TARGET_X86 */
631
632	/** @name Statistics
633	* @{ */
634	STAMCOUNTER StatExitAll;
635	STAMCOUNTER StatBreakOnCancel;
636	STAMCOUNTER StatBreakOnFFPre;
637	STAMCOUNTER StatBreakOnFFPost;
638	STAMCOUNTER StatBreakOnStatus;
639	STAMCOUNTER StatImportOnDemand;
640	STAMCOUNTER StatImportOnReturn;
641	STAMCOUNTER StatImportOnReturnSkipped;
642	STAMCOUNTER StatQueryCpuTick;
643	# ifdef VBOX_WITH_STATISTICS
644	STAMPROFILEADV StatProfGstStateImport;
645	STAMPROFILEADV StatProfGstStateExport;
646	# endif
647	/** @} */
648
649	/** @} */
650	#endif /* RT_OS_DARWIN */
651	} NEMCPU;
652	/** Pointer to NEM VMCPU instance data. */
653	typedef NEMCPU *PNEMCPU;
654
655	/** NEMCPU::u32Magic value. */
656	#define NEMCPU_MAGIC UINT32_C(0x4d454e20)
657	/** NEMCPU::u32Magic value after termination. */
658	#define NEMCPU_MAGIC_DEAD UINT32_C(0xdead2222)
659
660
661	#ifdef IN_RING0
662	# ifdef RT_OS_WINDOWS
663	/**
664	* Windows: Hypercall input/ouput page info.
665	*/
666	typedef struct NEMR0HYPERCALLDATA
667	{
668	/** Host physical address of the hypercall input/output page. */
669	RTHCPHYS HCPhysPage;
670	/** Pointer to the hypercall input/output page. */
671	uint8_t *pbPage;
672	/** Handle to the memory object of the hypercall input/output page. */
673	RTR0MEMOBJ hMemObj;
674	} NEMR0HYPERCALLDATA;
675	/** Pointer to a Windows hypercall input/output page info. */
676	typedef NEMR0HYPERCALLDATA *PNEMR0HYPERCALLDATA;
677	# endif /* RT_OS_WINDOWS */
678
679	/**
680	* NEM GVMCPU instance data.
681	*/
682	typedef struct NEMR0PERVCPU
683	{
684	uint32_t uDummy;
685	} NEMR0PERVCPU;
686
687	/**
688	* NEM GVM instance data.
689	*/
690	typedef struct NEMR0PERVM
691	{
692	uint32_t uDummy;
693	} NEMR0PERVM;
694
695	#endif /* IN_RING*/
696
697
698	#ifdef IN_RING3
699
700	int nemR3DisableCpuIsaExt(PVM pVM, const char *pszIsaExt);
701
702	int nemR3NativeInit(PVM pVM, bool fFallback, bool fForced);
703	int nemR3NativeInitAfterCPUM(PVM pVM);
704	int nemR3NativeInitCompleted(PVM pVM, VMINITCOMPLETED enmWhat);
705	int nemR3NativeTerm(PVM pVM);
706	void nemR3NativeReset(PVM pVM);
707	void nemR3NativeResetCpu(PVMCPU pVCpu, bool fInitIpi);
708	VBOXSTRICTRC nemR3NativeRunGC(PVM pVM, PVMCPU pVCpu);
709	bool nemR3NativeCanExecuteGuest(PVM pVM, PVMCPU pVCpu);
710	bool nemR3NativeSetSingleInstruction(PVM pVM, PVMCPU pVCpu, bool fEnable);
711
712	/** GIC API is currently implemented in NEM rather than in GIC. */
713	VMM_INT_DECL(int) NEMR3GicSetSpi(PVMCC pVM, uint32_t uIntId, bool fAsserted);
714	VMM_INT_DECL(int) NEMR3GicSetPpi(PVMCPUCC pVCpu, uint32_t uIntId, bool fAsserted);
715	VMM_INT_DECL(VBOXSTRICTRC) NEMR3GicReadSysReg(PVMCPUCC pVCpu, uint32_t u32Reg, uint64_t *pu64Value);
716	VMM_INT_DECL(VBOXSTRICTRC) NEMR3GicWriteSysReg(PVMCPUCC pVCpu, uint32_t u32Reg, uint64_t u64Value);
717
718	/**
719	* Forced flag notification call from VMEmt.h.
720	*
721	* This is only called when pVCpu is in the VMCPUSTATE_STARTED_EXEC_NEM state.
722	*
723	* @param pVM The cross context VM structure.
724	* @param pVCpu The cross context virtual CPU structure of the CPU
725	* to be notified.
726	* @param fFlags Notification flags, VMNOTIFYFF_FLAGS_XXX.
727	*/
728	void nemR3NativeNotifyFF(PVM pVM, PVMCPU pVCpu, uint32_t fFlags);
729
730	/**
731	* Called by NEMR3NotifyDebugEventChanged() to let the native backend take the final decision
732	* on whether to switch to the debug loop.
733	*
734	* @returns Final flag whether to switch to the debug loop.
735	* @param pVM The VM cross context VM structure.
736	* @param fUseDebugLoop The current value determined by NEMR3NotifyDebugEventChanged().
737	* @thread EMT(0)
738	*/
739	DECLHIDDEN(bool) nemR3NativeNotifyDebugEventChanged(PVM pVM, bool fUseDebugLoop);
740
741
742	/**
743	* Called by NEMR3NotifyDebugEventChangedPerCpu() to let the native backend take the final decision
744	* on whether to switch to the debug loop.
745	*
746	* @returns Final flag whether to switch to the debug loop.
747	* @param pVM The VM cross context VM structure.
748	* @param pVCpu The cross context virtual CPU structure of the calling EMT.
749	* @param fUseDebugLoop The current value determined by NEMR3NotifyDebugEventChangedPerCpu().
750	*/
751	DECLHIDDEN(bool) nemR3NativeNotifyDebugEventChangedPerCpu(PVM pVM, PVMCPU pVCpu, bool fUseDebugLoop);
752
753	#endif /* IN_RING3 */
754
755	void nemHCNativeNotifyHandlerPhysicalRegister(PVMCC pVM, PGMPHYSHANDLERKIND enmKind, RTGCPHYS GCPhys, RTGCPHYS cb);
756	void nemHCNativeNotifyHandlerPhysicalModify(PVMCC pVM, PGMPHYSHANDLERKIND enmKind, RTGCPHYS GCPhysOld,
757	RTGCPHYS GCPhysNew, RTGCPHYS cb, bool fRestoreAsRAM);
758	int nemHCNativeNotifyPhysPageAllocated(PVMCC pVM, RTGCPHYS GCPhys, RTHCPHYS HCPhys, uint32_t fPageProt,
759	PGMPAGETYPE enmType, uint8_t *pu2State);
760
761
762	#ifdef RT_OS_WINDOWS
763	/** Maximum number of pages we can map in a single NEMR0MapPages call. */
764	# define NEM_MAX_MAP_PAGES ((HOST_PAGE_SIZE - RT_UOFFSETOF(HV_INPUT_MAP_GPA_PAGES, PageList)) / sizeof(HV_SPA_PAGE_NUMBER))
765	/** Maximum number of pages we can unmap in a single NEMR0UnmapPages call. */
766	# define NEM_MAX_UNMAP_PAGES 4095
767
768	#endif
769	/** @} */
770
771	RT_C_DECLS_END
772
773	#endif /* !VMM_INCLUDED_SRC_include_NEMInternal_h */
774

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

source: vbox/trunk/src/VBox/VMM/include/NEMInternal.h@ 107381

Download in other formats: