/** @file * VM - The Virtual Machine, data. */ /* * Copyright (C) 2006 InnoTek Systemberatung GmbH * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License as published by the Free Software Foundation, * in version 2 as it comes in the "COPYING" file of the VirtualBox OSE * distribution. VirtualBox OSE is distributed in the hope that it will * be useful, but WITHOUT ANY WARRANTY of any kind. * * If you received this file as part of a commercial VirtualBox * distribution, then only the terms of your commercial VirtualBox * license agreement apply instead of the previous paragraph. */ #ifndef __VBox_vm_h__ #define __VBox_vm_h__ #include #include #include #include #include /** @defgroup grp_vm The Virtual Machine * @{ */ /** The name of the Guest Context VMM Core module. */ #define VMMGC_MAIN_MODULE_NAME "VMMGC.gc" /** The name of the Ring 0 Context VMM Core module. */ #define VMMR0_MAIN_MODULE_NAME "VMMR0.r0" /** VM Forced Action Flags. * * Use the VM_FF_SET() and VM_FF_CLEAR() macros to change the force * action mask of a VM. * * @{ */ /** This action forces the VM to service check and pending interrups on the APIC. */ #define VM_FF_INTERRUPT_APIC BIT(0) /** This action forces the VM to service check and pending interrups on the PIC. */ #define VM_FF_INTERRUPT_PIC BIT(1) /** This action forces the VM to schedule and run pending timer (TM). */ #define VM_FF_TIMER BIT(2) /** PDM Queues are pending. */ #define VM_FF_PDM_QUEUES BIT(3) /** PDM DMA transfers are pending. */ #define VM_FF_PDM_DMA BIT(4) /** PDM critical section unlocking is pending, process promptly upon return to R3. */ #define VM_FF_PDM_CRITSECT BIT(5) /** This action forces the VM to call DBGF so DBGF can service debugger * requests in the emulation thread. * This action flag stays asserted till DBGF clears it.*/ #define VM_FF_DBGF BIT(8) /** This action forces the VM to service pending requests from other * thread or requests which must be executed in another context. */ #define VM_FF_REQUEST BIT(9) /** Terminate the VM immediately. */ #define VM_FF_TERMINATE BIT(10) /** Reset the VM. (postponed) */ #define VM_FF_RESET BIT(11) /** This action forces the VM to resync the page tables before going * back to execute guest code. (GLOBAL FLUSH) */ #define VM_FF_PGM_SYNC_CR3 BIT(16) /** Same as VM_FF_PGM_SYNC_CR3 except that global pages can be skipped. * (NON-GLOBAL FLUSH) */ #define VM_FF_PGM_SYNC_CR3_NON_GLOBAL BIT(17) /** Check the interupt and trap gates */ #define VM_FF_TRPM_SYNC_IDT BIT(18) /** Check Guest's TSS ring 0 stack */ #define VM_FF_SELM_SYNC_TSS BIT(19) /** Check Guest's GDT table */ #define VM_FF_SELM_SYNC_GDT BIT(20) /** Check Guest's LDT table */ #define VM_FF_SELM_SYNC_LDT BIT(21) /** Inhibit interrupts pending. See EMGetInhibitInterruptsPC(). */ #define VM_FF_INHIBIT_INTERRUPTS BIT(22) /** CSAM needs to scan the page that's being executed */ #define VM_FF_CSAM_SCAN_PAGE BIT(24) /** CSAM needs to flush a code page that has been modified. */ #define VM_FF_CSAM_FLUSH_DIRTY_PAGE BIT(25) /** Force return to Ring-3. */ #define VM_FF_TO_R3 BIT(28) /** Suspend the VM - debug only. */ #define VM_FF_DEBUG_SUSPEND BIT(31) /** Externally forced actions. Used to quit the idle/wait loop. */ #define VM_FF_EXTERNAL_SUSPENDED_MASK (VM_FF_TERMINATE | VM_FF_DBGF | VM_FF_REQUEST) /** Externally forced actions. Used to quit the idle/wait loop. */ #define VM_FF_EXTERNAL_HALTED_MASK (VM_FF_TERMINATE | VM_FF_DBGF | VM_FF_TIMER | VM_FF_INTERRUPT_APIC | VM_FF_INTERRUPT_PIC | VM_FF_REQUEST | VM_FF_PDM_QUEUES | VM_FF_PDM_DMA) /** High priority pre-execution actions. */ #define VM_FF_HIGH_PRIORITY_PRE_MASK (VM_FF_TERMINATE | VM_FF_DBGF | VM_FF_INTERRUPT_APIC | VM_FF_INTERRUPT_PIC | VM_FF_TIMER | VM_FF_DEBUG_SUSPEND \ | VM_FF_PGM_SYNC_CR3 | VM_FF_PGM_SYNC_CR3_NON_GLOBAL | VM_FF_SELM_SYNC_TSS | VM_FF_TRPM_SYNC_IDT | VM_FF_SELM_SYNC_GDT | VM_FF_SELM_SYNC_LDT) /** High priority pre raw-mode execution mask. */ #define VM_FF_HIGH_PRIORITY_PRE_RAW_MASK (VM_FF_PGM_SYNC_CR3 | VM_FF_PGM_SYNC_CR3_NON_GLOBAL | VM_FF_SELM_SYNC_TSS | VM_FF_TRPM_SYNC_IDT | VM_FF_SELM_SYNC_GDT | VM_FF_SELM_SYNC_LDT | VM_FF_INHIBIT_INTERRUPTS) /** High priority post-execution actions. */ #define VM_FF_HIGH_PRIORITY_POST_MASK (VM_FF_PDM_CRITSECT|VM_FF_CSAM_FLUSH_DIRTY_PAGE) /** Normal priority post-execution actions. */ #define VM_FF_NORMAL_PRIORITY_POST_MASK (VM_FF_TERMINATE | VM_FF_DBGF | VM_FF_RESET | VM_FF_CSAM_SCAN_PAGE) /** Normal priority actions. */ #define VM_FF_NORMAL_PRIORITY_MASK (VM_FF_REQUEST | VM_FF_PDM_QUEUES | VM_FF_PDM_DMA) /** Flags to check before resuming guest execution. */ #define VM_FF_RESUME_GUEST_MASK (VM_FF_TO_R3) /** All the forced flags. */ #define VM_FF_ALL_MASK (~0U) /** All the forced flags. */ #define VM_FF_ALL_BUT_RAW_MASK (~(VM_FF_HIGH_PRIORITY_PRE_RAW_MASK | VM_FF_CSAM_FLUSH_DIRTY_PAGE | VM_FF_PDM_CRITSECT)) /** @} */ /** @def VM_FF_SET * Sets a force action flag. * * @param pVM VM Handle. * @param fFlag The flag to set. */ #if 1 # define VM_FF_SET(pVM, fFlag) ASMAtomicOrU32(&(pVM)->fForcedActions, (fFlag)) #else # define VM_FF_SET(pVM, fFlag) \ do { ASMAtomicOrU32(&(pVM)->fForcedActions, (fFlag)); \ RTLogPrintf("VM_FF_SET : %08x %s - %s(%d) %s\n", (pVM)->fForcedActions, #fFlag, __FILE__, __LINE__, __FUNCTION__); \ } while (0) #endif /** @def VM_FF_CLEAR * Clears a force action flag. * * @param pVM VM Handle. * @param fFlag The flag to clear. */ #if 1 # define VM_FF_CLEAR(pVM, fFlag) ASMAtomicAndU32(&(pVM)->fForcedActions, ~(fFlag)) #else # define VM_FF_CLEAR(pVM, fFlag) \ do { ASMAtomicAndU32(&(pVM)->fForcedActions, ~(fFlag)); \ RTLogPrintf("VM_FF_CLEAR: %08x %s - %s(%d) %s\n", (pVM)->fForcedActions, #fFlag, __FILE__, __LINE__, __FUNCTION__); \ } while (0) #endif /** @def VM_FF_ISSET * Checks if a force action flag is set. * * @param pVM VM Handle. * @param fFlag The flag to check. */ #define VM_FF_ISSET(pVM, fFlag) (((pVM)->fForcedActions & (fFlag)) == (fFlag)) /** @def VM_FF_ISPENDING * Checks if one or more force action in the specified set is pending. * * @param pVM VM Handle. * @param fFlags The flags to check for. */ #define VM_FF_ISPENDING(pVM, fFlags) ((pVM)->fForcedActions & (fFlags)) /** @def VM_IS_EMT * Checks if the current thread is the emulation thread (EMT). * * @remark The ring-0 variation will need attention if we expand the ring-0 * code to let threads other than EMT mess around with the VM. */ #ifdef IN_GC # define VM_IS_EMT(pVM) true #elif defined(IN_RING0) # define VM_IS_EMT(pVM) true #else # define VM_IS_EMT(pVM) ((pVM)->NativeThreadEMT == RTThreadNativeSelf()) #endif /** @def VM_ASSERT_EMT * Asserts that the current thread IS the emulation thread (EMT). */ #ifdef IN_GC # define VM_ASSERT_EMT(pVM) Assert(VM_IS_EMT(pVM)) #elif defined(IN_RING0) # define VM_ASSERT_EMT(pVM) Assert(VM_IS_EMT(pVM)) #else # define VM_ASSERT_EMT(pVM) \ AssertMsg(VM_IS_EMT(pVM), \ ("Not emulation thread! Thread=%RTnthrd ThreadEMT=%RTnthrd\n", RTThreadNativeSelf(), pVM->NativeThreadEMT)) #endif /** * Asserts that the current thread is NOT the emulation thread. */ #define VM_ASSERT_OTHER_THREAD(pVM) \ AssertMsg(!VM_IS_EMT(pVM), ("Not other thread!!\n")) /** This is the VM structure. * * It contains (nearly?) all the VM data which have to be available in all * contexts. Even if it contains all the data the idea is to use APIs not * to modify all the members all around the place. Therefore we make use of * unions to hide everything which isn't local to the current source module. * This means we'll have to pay a little bit of attention when adding new * members to structures in the unions and make sure to keep the padding sizes * up to date. * * Run tstVMStructSize after update! */ typedef struct VM { /** The state of the VM. * This field is read only to everyone except the VM and EM. */ VMSTATE enmVMState; /** Forced action flags. * See the VM_FF_* \#defines. Updated atomically. */ volatile uint32_t fForcedActions; /** Physical address (real) of this structure. */ RTHCPHYS HCPhysVM; /** Session handle. For use when calling SUPR0 APIs. */ HCPTRTYPE(PSUPDRVSESSION) pSession; /** Pointer to the next VM. * We keep a per process list of VM for the event that a process could * contain more than one VM. */ HCPTRTYPE(struct VM *) pNext; /** Host Context VM Pointer. * @obsolete don't use in new code! */ HCPTRTYPE(struct VM *) pVMHC; /** Ring-3 Host Context VM Pointer. */ R3PTRTYPE(struct VM *) pVMR3; /** Ring-0 Host Context VM Pointer. */ R0PTRTYPE(struct VM *) pVMR0; /** Guest Context VM Pointer. */ GCPTRTYPE(struct VM *) pVMGC; /** @name Public VMM Switcher APIs * @{ */ /** * Assembly switch entry point for returning to host context. * This function will clean up the stack frame. * * @param eax The return code, register. * @param Ctx The guest core context. * @remark Assume interrupts disabled. */ RTGCPTR pfnVMMGCGuestToHostAsmGuestCtx/*(int32_t eax, CPUMCTXCORE Ctx)*/; /** * Assembly switch entry point for returning to host context. * * This is an alternative entry point which we'll be using when the we have the * hypervisor context and need to save that before going to the host. * * This is typically useful when abandoning the hypervisor because of a trap * and want the trap state to be saved. * * @param eax The return code, register. * @param ecx Pointer to the hypervisor core context, register. * @remark Assume interrupts disabled. */ RTGCPTR pfnVMMGCGuestToHostAsmHyperCtx/*(int32_t eax, PCPUMCTXCORE ecx)*/; /** * Assembly switch entry point for returning to host context. * * This is an alternative to the two *Ctx APIs and implies that the context has already * been saved, or that it's just a brief return to HC and that the caller intends to resume * whatever it is doing upon 'return' from this call. * * @param eax The return code, register. * @remark Assume interrupts disabled. */ RTGCPTR pfnVMMGCGuestToHostAsm/*(int32_t eax)*/; /** @} */ /** @name Various VM data owned by VM. * @{ */ /** The thread handle of the emulation thread. * Use the VM_IS_EMT() macro to check if executing in EMT. */ RTTHREAD ThreadEMT; /** The native handle of ThreadEMT. Getting the native handle * is generally faster than getting the IPRT one (except on OS/2 :-). */ RTNATIVETHREAD NativeThreadEMT; /** @} */ /** @name Various items that are frequently accessed. * @{ */ /** Raw ring-3 indicator. */ bool fRawR3Enabled; /** Raw ring-0 indicator. */ bool fRawR0Enabled; /** PATM enabled flag. * This is placed here for performance reasons. */ bool fPATMEnabled; /** CSAM enabled flag. * This is placed here for performance reasons. */ bool fCSAMEnabled; /** Hardware VM support is available and enabled. * This is placed here for performance reasons. */ bool fHWACCMEnabled; /** @} */ /* padding to make gnuc put the StatQemuToGC where msc does. */ #if HC_ARCH_BITS == 32 uint32_t padding0; #endif /** Profiling the total time from Qemu to GC. */ STAMPROFILEADV StatTotalQemuToGC; /** Profiling the total time from GC to Qemu. */ STAMPROFILEADV StatTotalGCToQemu; /** Profiling the total time spent in GC. */ STAMPROFILEADV StatTotalInGC; /** Profiling the total time spent not in Qemu. */ STAMPROFILEADV StatTotalInQemu; /** Profiling the VMMSwitcher code for going to GC. */ STAMPROFILEADV StatSwitcherToGC; /** Profiling the VMMSwitcher code for going to HC. */ STAMPROFILEADV StatSwitcherToHC; STAMPROFILEADV StatSwitcherSaveRegs; STAMPROFILEADV StatSwitcherSysEnter; STAMPROFILEADV StatSwitcherDebug; STAMPROFILEADV StatSwitcherCR0; STAMPROFILEADV StatSwitcherCR4; STAMPROFILEADV StatSwitcherJmpCR3; STAMPROFILEADV StatSwitcherRstrRegs; STAMPROFILEADV StatSwitcherLgdt; STAMPROFILEADV StatSwitcherLidt; STAMPROFILEADV StatSwitcherLldt; STAMPROFILEADV StatSwitcherTSS; /* padding - the unions must be aligned on 32 bytes boundraries. */ uint32_t padding[HC_ARCH_BITS == 32 ? 4 : 6]; /** CPUM part. */ union { #ifdef __CPUMInternal_h__ struct CPUM s; #endif char padding[HC_ARCH_BITS == 32 ? 3424 : 3552]; /* multiple of 32 */ } cpum; /** VMM part. */ union { #ifdef __VMMInternal_h__ struct VMM s; #endif char padding[1024]; /* multiple of 32 */ } vmm; /** PGM part. */ union { #ifdef __PGMInternal_h__ struct PGM s; #endif char padding[50*1024]; /* multiple of 32 */ } pgm; /** HWACCM part. */ union { #ifdef __HWACCMInternal_h__ struct HWACCM s; #endif char padding[1024]; /* multiple of 32 */ } hwaccm; /** TRPM part. */ union { #ifdef __TRPMInternal_h__ struct TRPM s; #endif char padding[5344]; /* multiple of 32 */ } trpm; /** SELM part. */ union { #ifdef __SELMInternal_h__ struct SELM s; #endif char padding[544]; /* multiple of 32 */ } selm; /** MM part. */ union { #ifdef __MMInternal_h__ struct MM s; #endif char padding[128]; /* multiple of 32 */ } mm; /** CFGM part. */ union { #ifdef __CFGMInternal_h__ struct CFGM s; #endif char padding[32]; /* multiple of 32 */ } cfgm; /** PDM part. */ union { #ifdef __PDMInternal_h__ struct PDM s; #endif char padding[1024]; /* multiple of 32 */ } pdm; /** IOM part. */ union { #ifdef __IOMInternal_h__ struct IOM s; #endif char padding[4544]; /* multiple of 32 */ } iom; /** PATM part. */ union { #ifdef __PATMInternal_h__ struct PATM s; #endif char padding[768]; /* multiple of 32 */ } patm; /** CSAM part. */ union { #ifdef __CSAMInternal_h__ struct CSAM s; #endif char padding[3328]; /* multiple of 32 */ } csam; /** EM part. */ union { #ifdef __EMInternal_h__ struct EM s; #endif char padding[1344]; /* multiple of 32 */ } em; /** TM part. */ union { #ifdef __TMInternal_h__ struct TM s; #endif char padding[768]; /* multiple of 32 */ } tm; /** DBGF part. */ union { #ifdef __DBGFInternal_h__ struct DBGF s; #endif char padding[HC_ARCH_BITS == 32 ? 1888 : 1920]; /* multiple of 32 */ } dbgf; /** STAM part. */ union { #ifdef __STAMInternal_h__ struct STAM s; #endif char padding[32]; /* multiple of 32 */ } stam; /** SSM part. */ union { #ifdef __SSMInternal_h__ struct SSM s; #endif char padding[32]; /* multiple of 32 */ } ssm; /** VM part. */ union { #ifdef __VMInternal_h__ struct VMINT s; #endif char padding[640]; /* multiple of 32 */ } vm; /** REM part. */ union { #ifdef __REMInternal_h__ struct REM s; #endif char padding[HC_ARCH_BITS == 32 ? 0x6b00 : 0xbf00]; /* multiple of 32 */ } rem; } VM; /** Pointer to a VM. */ #ifndef __VBox_types_h__ typedef struct VM *PVM; #endif #ifdef IN_GC __BEGIN_DECLS /** The VM structure. * This is imported from the VMMGCBuiltin module, i.e. it's a one * of those magic globals which we should avoid using. */ extern DECLIMPORT(VM) g_VM; __END_DECLS #endif /** @} */ #endif