HWVMXR0.h revision c58f1213e628a545081c70e26c6b67a841cff880
/* $Id$ */
/** @file
* HM VMX (VT-x) - Internal header file.
*/
/*
* Copyright (C) 2006-2013 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* General Public License (GPL) 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.
*/
#ifndef ___HWVMXR0_h
#define ___HWVMXR0_h
/** @defgroup grp_vmx_int Internal
* @ingroup grp_vmx
* @internal
* @{
*/
/* Read cache indices. */
#define VMX_VMCS_GUEST_RIP_CACHE_IDX 0
#define VMX_VMCS_GUEST_RSP_CACHE_IDX 1
#define VMX_VMCS_GUEST_RFLAGS_CACHE_IDX 2
#define VMX_VMCS_CTRL_CR0_READ_SHADOW_CACHE_IDX 4
#define VMX_VMCS_GUEST_CR0_CACHE_IDX 5
#define VMX_VMCS_CTRL_CR4_READ_SHADOW_CACHE_IDX 6
#define VMX_VMCS_GUEST_CR4_CACHE_IDX 7
#define VMX_VMCS_GUEST_DR7_CACHE_IDX 8
#define VMX_VMCS32_GUEST_SYSENTER_CS_CACHE_IDX 9
#define VMX_VMCS_GUEST_SYSENTER_EIP_CACHE_IDX 10
#define VMX_VMCS_GUEST_SYSENTER_ESP_CACHE_IDX 11
#define VMX_VMCS32_GUEST_GDTR_LIMIT_CACHE_IDX 12
#define VMX_VMCS_GUEST_GDTR_BASE_CACHE_IDX 13
#define VMX_VMCS32_GUEST_IDTR_LIMIT_CACHE_IDX 14
#define VMX_VMCS_GUEST_IDTR_BASE_CACHE_IDX 15
#define VMX_VMCS16_GUEST_FIELD_CS_CACHE_IDX 16
#define VMX_VMCS32_GUEST_CS_LIMIT_CACHE_IDX 17
#define VMX_VMCS_GUEST_CS_BASE_CACHE_IDX 18
#define VMX_VMCS32_GUEST_CS_ACCESS_RIGHTS_CACHE_IDX 19
#define VMX_VMCS16_GUEST_FIELD_DS_CACHE_IDX 20
#define VMX_VMCS32_GUEST_DS_LIMIT_CACHE_IDX 21
#define VMX_VMCS_GUEST_DS_BASE_CACHE_IDX 22
#define VMX_VMCS32_GUEST_DS_ACCESS_RIGHTS_CACHE_IDX 23
#define VMX_VMCS16_GUEST_FIELD_ES_CACHE_IDX 24
#define VMX_VMCS32_GUEST_ES_LIMIT_CACHE_IDX 25
#define VMX_VMCS_GUEST_ES_BASE_CACHE_IDX 26
#define VMX_VMCS32_GUEST_ES_ACCESS_RIGHTS_CACHE_IDX 27
#define VMX_VMCS16_GUEST_FIELD_FS_CACHE_IDX 28
#define VMX_VMCS32_GUEST_FS_LIMIT_CACHE_IDX 29
#define VMX_VMCS_GUEST_FS_BASE_CACHE_IDX 30
#define VMX_VMCS32_GUEST_FS_ACCESS_RIGHTS_CACHE_IDX 31
#define VMX_VMCS16_GUEST_FIELD_GS_CACHE_IDX 32
#define VMX_VMCS32_GUEST_GS_LIMIT_CACHE_IDX 33
#define VMX_VMCS_GUEST_GS_BASE_CACHE_IDX 34
#define VMX_VMCS32_GUEST_GS_ACCESS_RIGHTS_CACHE_IDX 35
#define VMX_VMCS16_GUEST_FIELD_SS_CACHE_IDX 36
#define VMX_VMCS32_GUEST_SS_LIMIT_CACHE_IDX 37
#define VMX_VMCS_GUEST_SS_BASE_CACHE_IDX 38
#define VMX_VMCS32_GUEST_SS_ACCESS_RIGHTS_CACHE_IDX 39
#define VMX_VMCS16_GUEST_FIELD_TR_CACHE_IDX 40
#define VMX_VMCS32_GUEST_TR_LIMIT_CACHE_IDX 41
#define VMX_VMCS_GUEST_TR_BASE_CACHE_IDX 42
#define VMX_VMCS32_GUEST_TR_ACCESS_RIGHTS_CACHE_IDX 43
#define VMX_VMCS16_GUEST_FIELD_LDTR_CACHE_IDX 44
#define VMX_VMCS32_GUEST_LDTR_LIMIT_CACHE_IDX 45
#define VMX_VMCS_GUEST_LDTR_BASE_CACHE_IDX 46
#define VMX_VMCS32_RO_EXIT_REASON_CACHE_IDX 48
#define VMX_VMCS32_RO_VM_INSTR_ERROR_CACHE_IDX 49
#define VMX_VMCS32_RO_EXIT_INSTR_LENGTH_CACHE_IDX 50
#define VMX_VMCS32_RO_EXIT_INSTR_INFO_CACHE_IDX 52
#define VMX_VMCS_RO_EXIT_QUALIFICATION_CACHE_IDX 54
#define VMX_VMCS32_RO_IDT_INFO_CACHE_IDX 55
#define VMX_VMCS32_RO_IDT_ERROR_CODE_CACHE_IDX 56
#define VMX_VMCS_GUEST_CR3_CACHE_IDX 57
#ifdef IN_RING0
/**
* Enters the VT-x session.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VM CPU.
* @param pCpu Pointer to the CPU info struct.
*/
/**
* Leaves the VT-x session.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VMCPU.
* @param pCtx Pointer to the guest CPU context.
*/
VMMR0DECL(int) VMXR0EnableCpu(PHMGLOBLCPUINFO pCpu, PVM pVM, void *pvPageCpu, RTHCPHYS pPageCpuPhys, bool fEnabledBySystem);
/**
* Deactivates VT-x on the current CPU.
*
* @returns VBox status code.
* @param pCpu Pointer to the CPU info struct.
* @param pvPageCpu Pointer to the global CPU page.
* @param pPageCpuPhys Physical address of the global CPU page.
*/
/**
* Does Ring-0 per VM VT-x initialization.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
*/
/**
* Does Ring-0 per VM VT-x termination.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
*/
/**
* Sets up VT-x for the specified VM.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
*/
/**
* Save the host state.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VMCPU.
*/
/**
* Loads the guest state.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VMCPU.
* @param pCtx Pointer to the guest CPU context.
*/
/**
* Runs guest code in a VT-x VM.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VMCPU.
* @param pCtx Pointer to the guest CPU context.
*/
# if HC_ARCH_BITS == 32 && defined(VBOX_WITH_64_BITS_GUESTS) && !defined(VBOX_WITH_HYBRID_32BIT_KERNEL)
/**
* Executes the specified handler in 64-bit mode.
*
* @returns VBox status code.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VMCPU.
* @param pCtx Pointer to the guest CPU context.
* @param pfnHandler Pointer to the RC handler function.
* @param cbParam Number of parameters.
* @param paParam Array of 32-bit parameters.
*/
VMMR0DECL(int) VMXR0Execute64BitsHandler(PVM pVM, PVMCPU pVCpu, PCPUMCTX pCtx, RTRCPTR pfnHandler, uint32_t cbParam,
# endif
do \
{ \
{ \
/* Must override this or else VT-x will fail with invalid guest state errors. */ \
/** @todo we shouldn't have to do this, if it is not 0xf3 it means we screwed up elsewhere (recompiler). */ \
/** @todo VT-x docs explicitly mentions 0xF3. Why not just val = 0xf3 ??. */ \
} \
else \
if ( CPUMIsGuestInRealModeEx(pCtx) \
{ \
/** @todo shouldn't the 'if' condition above check for 'pRealModeTSS' ? */ \
/* Must override this or else VT-x will fail with invalid guest state errors. */ \
val = 0xf3; \
} \
else \
) \
{ \
} \
else \
\
} while (0)
do \
{ \
} while (0)
/* Don't read from the cache in this macro; used only in case of failure where the cache is out of sync. */
do \
{ \
} while (0)
/**
* Cache VMCS writes for performance reasons (Darwin) and for running 64 bits
* guests on 32-bit hosts.
*
* @param pVCpu Pointer to the VMCPU.
* @param idxField VMCS field index.
* @param u64Val 16, 32 or 64 bits value.
*/
#ifdef VMX_USE_CACHED_VMCS_ACCESSES
/**
* Return value of cached VMCS read for performance reasons (Darwin) and for running 64 bits guests on 32 bits hosts.
*
* @param pVCpu Pointer to the VMCPU.
* @param idxField VMCS cache index (not VMCS field index!)
* @param pVal 16, 32 or 64 bits value.
*/
{
return VINF_SUCCESS;
}
#endif
/**
* Return value of cached VMCS read for performance reasons (Darwin) and for
* running 64 bits guests on 32-bit hosts.
*
* @param idxField VMCS field index.
* @param pVal Value pointer (out).
*/
#ifdef VMX_USE_CACHED_VMCS_ACCESSES
#else
#endif
/**
* Setup cached VMCS for performance reasons (Darwin) and for running 64-bit
* guests on 32-bit hosts.
*
* @param pCache The cache.
* @param idxField VMCS field index.
*/
{ \
}
{ \
}
/**
* Prepares for and executes VMLAUNCH (32-bit guest mode).
*
* @returns VBox status code.
* @param pCtx Pointer to the guest CPU context.
* @param pCache Pointer to the VMCS cache.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VMCPU.
*/
DECLASM(int) VMXR0StartVM32(RTHCUINT fResume, PCPUMCTX pCtx, PVMCSCACHE pCache, PVM pVM, PVMCPU pVCpu);
/**
* Prepares for and executes VMLAUNCH (64-bit guest mode).
*
* @returns VBox status code.
* @param pCtx Pointer to the guest CPU context.
* @param pCache Pointer to the VMCS cache.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VMCPU.
*/
DECLASM(int) VMXR0StartVM64(RTHCUINT fResume, PCPUMCTX pCtx, PVMCSCACHE pCache, PVM pVM, PVMCPU pVCpu);
# if HC_ARCH_BITS == 32 && defined(VBOX_WITH_64_BITS_GUESTS) && !defined(VBOX_WITH_HYBRID_32BIT_KERNEL)
/**
* Prepares for and executes VMLAUNCH (64-bit guest mode).
*
* @returns VBox status code
* @param pCtx Pointer to the guest CPU context.
* @param pCache Pointer to the VMCS cache.
* @param pVM Pointer to the VM.
* @param pVCpu Pointer to the VMCPU.
*/
DECLASM(int) VMXR0SwitcherStartVM64(RTHCUINT fResume, PCPUMCTX pCtx, PVMCSCACHE pCache, PVM pVM, PVMCPU pVCpu);
# endif
#endif /* IN_RING0 */
/** @} */
#endif /* ___HWVMXR0_h */