cpum.h@ 67989

Last change on this file since 67989 was 67943, checked in by vboxsync, 7 years ago
cpum.h: Fixes crash, follow up fixes to r116929
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 69.8 KB

Line
1	/** @file
2	* CPUM - CPU Monitor(/ Manager).
3	*/
4
5	/*
6	* Copyright (C) 2006-2016 Oracle Corporation
7	*
8	* This file is part of VirtualBox Open Source Edition (OSE), as
9	* available from http://www.virtualbox.org. This file is free software;
10	* you can redistribute it and/or modify it under the terms of the GNU
11	* General Public License (GPL) as published by the Free Software
12	* Foundation, in version 2 as it comes in the "COPYING" file of the
13	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15	*
16	* The contents of this file may alternatively be used under the terms
17	* of the Common Development and Distribution License Version 1.0
18	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19	* VirtualBox OSE distribution, in which case the provisions of the
20	* CDDL are applicable instead of those of the GPL.
21	*
22	* You may elect to license modified versions of this file under the
23	* terms and conditions of either the GPL or the CDDL or both.
24	*/
25
26	#ifndef ___VBox_vmm_cpum_h
27	#define ___VBox_vmm_cpum_h
28
29	#include <iprt/x86.h>
30	#include <VBox/types.h>
31	#include <VBox/vmm/cpumctx.h>
32	#include <VBox/vmm/stam.h>
33	#include <VBox/vmm/vmapi.h>
34
35	RT_C_DECLS_BEGIN
36
37	/** @defgroup grp_cpum The CPU Monitor / Manager API
38	* @ingroup grp_vmm
39	* @{
40	*/
41
42	/**
43	* CPUID feature to set or clear.
44	*/
45	typedef enum CPUMCPUIDFEATURE
46	{
47	CPUMCPUIDFEATURE_INVALID = 0,
48	/** The APIC feature bit. (Std+Ext)
49	* Note! There is a per-cpu flag for masking this CPUID feature bit when the
50	* APICBASE.ENABLED bit is zero. So, this feature is only set/cleared
51	* at VM construction time like all the others. This didn't used to be
52	* that way, this is new with 5.1. */
53	CPUMCPUIDFEATURE_APIC,
54	/** The sysenter/sysexit feature bit. (Std) */
55	CPUMCPUIDFEATURE_SEP,
56	/** The SYSCALL/SYSEXIT feature bit (64 bits mode only for Intel CPUs). (Ext) */
57	CPUMCPUIDFEATURE_SYSCALL,
58	/** The PAE feature bit. (Std+Ext) */
59	CPUMCPUIDFEATURE_PAE,
60	/** The NX feature bit. (Ext) */
61	CPUMCPUIDFEATURE_NX,
62	/** The LAHF/SAHF feature bit (64 bits mode only). (Ext) */
63	CPUMCPUIDFEATURE_LAHF,
64	/** The LONG MODE feature bit. (Ext) */
65	CPUMCPUIDFEATURE_LONG_MODE,
66	/** The PAT feature bit. (Std+Ext) */
67	CPUMCPUIDFEATURE_PAT,
68	/** The x2APIC feature bit. (Std) */
69	CPUMCPUIDFEATURE_X2APIC,
70	/** The RDTSCP feature bit. (Ext) */
71	CPUMCPUIDFEATURE_RDTSCP,
72	/** The Hypervisor Present bit. (Std) */
73	CPUMCPUIDFEATURE_HVP,
74	/** The MWait Extensions bits (Std) */
75	CPUMCPUIDFEATURE_MWAIT_EXTS,
76	/** 32bit hackishness. */
77	CPUMCPUIDFEATURE_32BIT_HACK = 0x7fffffff
78	} CPUMCPUIDFEATURE;
79
80	/**
81	* CPU Vendor.
82	*/
83	typedef enum CPUMCPUVENDOR
84	{
85	CPUMCPUVENDOR_INVALID = 0,
86	CPUMCPUVENDOR_INTEL,
87	CPUMCPUVENDOR_AMD,
88	CPUMCPUVENDOR_VIA,
89	CPUMCPUVENDOR_CYRIX,
90	CPUMCPUVENDOR_UNKNOWN,
91	/** 32bit hackishness. */
92	CPUMCPUVENDOR_32BIT_HACK = 0x7fffffff
93	} CPUMCPUVENDOR;
94
95
96	/**
97	* X86 and AMD64 CPU microarchitectures and in processor generations.
98	*
99	* @remarks The separation here is sometimes a little bit too finely grained,
100	* and the differences is more like processor generation than micro
101	* arch. This can be useful, so we'll provide functions for getting at
102	* more coarse grained info.
103	*/
104	typedef enum CPUMMICROARCH
105	{
106	kCpumMicroarch_Invalid = 0,
107
108	kCpumMicroarch_Intel_First,
109
110	kCpumMicroarch_Intel_8086 = kCpumMicroarch_Intel_First,
111	kCpumMicroarch_Intel_80186,
112	kCpumMicroarch_Intel_80286,
113	kCpumMicroarch_Intel_80386,
114	kCpumMicroarch_Intel_80486,
115	kCpumMicroarch_Intel_P5,
116
117	kCpumMicroarch_Intel_P6_Core_Atom_First,
118	kCpumMicroarch_Intel_P6 = kCpumMicroarch_Intel_P6_Core_Atom_First,
119	kCpumMicroarch_Intel_P6_II,
120	kCpumMicroarch_Intel_P6_III,
121
122	kCpumMicroarch_Intel_P6_M_Banias,
123	kCpumMicroarch_Intel_P6_M_Dothan,
124	kCpumMicroarch_Intel_Core_Yonah, /*< Core, also known as Enhanced Pentium M. /
125
126	kCpumMicroarch_Intel_Core2_First,
127	kCpumMicroarch_Intel_Core2_Merom = kCpumMicroarch_Intel_Core2_First,
128	kCpumMicroarch_Intel_Core2_Penryn,
129
130	kCpumMicroarch_Intel_Core7_First,
131	kCpumMicroarch_Intel_Core7_Nehalem = kCpumMicroarch_Intel_Core7_First,
132	kCpumMicroarch_Intel_Core7_Westmere,
133	kCpumMicroarch_Intel_Core7_SandyBridge,
134	kCpumMicroarch_Intel_Core7_IvyBridge,
135	kCpumMicroarch_Intel_Core7_Haswell,
136	kCpumMicroarch_Intel_Core7_Broadwell,
137	kCpumMicroarch_Intel_Core7_Skylake,
138	kCpumMicroarch_Intel_Core7_Cannonlake,
139	kCpumMicroarch_Intel_Core7_End,
140
141	kCpumMicroarch_Intel_Atom_First,
142	kCpumMicroarch_Intel_Atom_Bonnell = kCpumMicroarch_Intel_Atom_First,
143	kCpumMicroarch_Intel_Atom_Lincroft, /*< Second generation bonnell (44nm). /
144	kCpumMicroarch_Intel_Atom_Saltwell, /*< 32nm shrink of Bonnell. /
145	kCpumMicroarch_Intel_Atom_Silvermont, /*< 22nm /
146	kCpumMicroarch_Intel_Atom_Airmount, /*< 14nm /
147	kCpumMicroarch_Intel_Atom_Goldmont, /*< 14nm /
148	kCpumMicroarch_Intel_Atom_Unknown,
149	kCpumMicroarch_Intel_Atom_End,
150
151	kCpumMicroarch_Intel_P6_Core_Atom_End,
152
153	kCpumMicroarch_Intel_NB_First,
154	kCpumMicroarch_Intel_NB_Willamette = kCpumMicroarch_Intel_NB_First, /*< 180nm /
155	kCpumMicroarch_Intel_NB_Northwood, /*< 130nm /
156	kCpumMicroarch_Intel_NB_Prescott, /*< 90nm /
157	kCpumMicroarch_Intel_NB_Prescott2M, /*< 90nm /
158	kCpumMicroarch_Intel_NB_CedarMill, /*< 65nm /
159	kCpumMicroarch_Intel_NB_Gallatin, /*< 90nm Xeon, Pentium 4 Extreme Edition ("Emergency Edition"). /
160	kCpumMicroarch_Intel_NB_Unknown,
161	kCpumMicroarch_Intel_NB_End,
162
163	kCpumMicroarch_Intel_Unknown,
164	kCpumMicroarch_Intel_End,
165
166	kCpumMicroarch_AMD_First,
167	kCpumMicroarch_AMD_Am286 = kCpumMicroarch_AMD_First,
168	kCpumMicroarch_AMD_Am386,
169	kCpumMicroarch_AMD_Am486,
170	kCpumMicroarch_AMD_Am486Enh, /*< Covers Am5x86 as well. /
171	kCpumMicroarch_AMD_K5,
172	kCpumMicroarch_AMD_K6,
173
174	kCpumMicroarch_AMD_K7_First,
175	kCpumMicroarch_AMD_K7_Palomino = kCpumMicroarch_AMD_K7_First,
176	kCpumMicroarch_AMD_K7_Spitfire,
177	kCpumMicroarch_AMD_K7_Thunderbird,
178	kCpumMicroarch_AMD_K7_Morgan,
179	kCpumMicroarch_AMD_K7_Thoroughbred,
180	kCpumMicroarch_AMD_K7_Barton,
181	kCpumMicroarch_AMD_K7_Unknown,
182	kCpumMicroarch_AMD_K7_End,
183
184	kCpumMicroarch_AMD_K8_First,
185	kCpumMicroarch_AMD_K8_130nm = kCpumMicroarch_AMD_K8_First, /*< 130nm Clawhammer, Sledgehammer, Newcastle, Paris, Odessa, Dublin /
186	kCpumMicroarch_AMD_K8_90nm, /*< 90nm shrink /
187	kCpumMicroarch_AMD_K8_90nm_DualCore, /*< 90nm with two cores. /
188	kCpumMicroarch_AMD_K8_90nm_AMDV, /*< 90nm with AMD-V (usually) and two cores (usually). /
189	kCpumMicroarch_AMD_K8_65nm, /*< 65nm shrink. /
190	kCpumMicroarch_AMD_K8_End,
191
192	kCpumMicroarch_AMD_K10,
193	kCpumMicroarch_AMD_K10_Lion,
194	kCpumMicroarch_AMD_K10_Llano,
195	kCpumMicroarch_AMD_Bobcat,
196	kCpumMicroarch_AMD_Jaguar,
197
198	kCpumMicroarch_AMD_15h_First,
199	kCpumMicroarch_AMD_15h_Bulldozer = kCpumMicroarch_AMD_15h_First,
200	kCpumMicroarch_AMD_15h_Piledriver,
201	kCpumMicroarch_AMD_15h_Steamroller, /*< Yet to be released, might have different family. /
202	kCpumMicroarch_AMD_15h_Excavator, /*< Yet to be released, might have different family. /
203	kCpumMicroarch_AMD_15h_Unknown,
204	kCpumMicroarch_AMD_15h_End,
205
206	kCpumMicroarch_AMD_16h_First,
207	kCpumMicroarch_AMD_16h_End,
208
209	kCpumMicroarch_AMD_Zen_First,
210	kCpumMicroarch_AMD_Zen_Ryzen = kCpumMicroarch_AMD_Zen_First,
211	kCpumMicroarch_AMD_Zen_End,
212
213	kCpumMicroarch_AMD_Unknown,
214	kCpumMicroarch_AMD_End,
215
216	kCpumMicroarch_VIA_First,
217	kCpumMicroarch_Centaur_C6 = kCpumMicroarch_VIA_First,
218	kCpumMicroarch_Centaur_C2,
219	kCpumMicroarch_Centaur_C3,
220	kCpumMicroarch_VIA_C3_M2,
221	kCpumMicroarch_VIA_C3_C5A, /*< 180nm Samuel - Cyrix III, C3, 1GigaPro. /
222	kCpumMicroarch_VIA_C3_C5B, /*< 150nm Samuel 2 - Cyrix III, C3, 1GigaPro, Eden ESP, XP 2000+. /
223	kCpumMicroarch_VIA_C3_C5C, /*< 130nm Ezra - C3, Eden ESP. /
224	kCpumMicroarch_VIA_C3_C5N, /*< 130nm Ezra-T - C3. /
225	kCpumMicroarch_VIA_C3_C5XL, /*< 130nm Nehemiah - C3, Eden ESP, Eden-N. /
226	kCpumMicroarch_VIA_C3_C5P, /*< 130nm Nehemiah+ - C3. /
227	kCpumMicroarch_VIA_C7_C5J, /*< 90nm Esther - C7, C7-D, C7-M, Eden, Eden ULV. /
228	kCpumMicroarch_VIA_Isaiah,
229	kCpumMicroarch_VIA_Unknown,
230	kCpumMicroarch_VIA_End,
231
232	kCpumMicroarch_Cyrix_First,
233	kCpumMicroarch_Cyrix_5x86 = kCpumMicroarch_Cyrix_First,
234	kCpumMicroarch_Cyrix_M1,
235	kCpumMicroarch_Cyrix_MediaGX,
236	kCpumMicroarch_Cyrix_MediaGXm,
237	kCpumMicroarch_Cyrix_M2,
238	kCpumMicroarch_Cyrix_Unknown,
239	kCpumMicroarch_Cyrix_End,
240
241	kCpumMicroarch_NEC_First,
242	kCpumMicroarch_NEC_V20 = kCpumMicroarch_NEC_First,
243	kCpumMicroarch_NEC_V30,
244	kCpumMicroarch_NEC_End,
245
246	kCpumMicroarch_Unknown,
247
248	kCpumMicroarch_32BitHack = 0x7fffffff
249	} CPUMMICROARCH;
250
251
252	/** Predicate macro for catching netburst CPUs. */
253	#define CPUMMICROARCH_IS_INTEL_NETBURST(a_enmMicroarch) \
254	((a_enmMicroarch) >= kCpumMicroarch_Intel_NB_First && (a_enmMicroarch) <= kCpumMicroarch_Intel_NB_End)
255
256	/** Predicate macro for catching Core7 CPUs. */
257	#define CPUMMICROARCH_IS_INTEL_CORE7(a_enmMicroarch) \
258	((a_enmMicroarch) >= kCpumMicroarch_Intel_Core7_First && (a_enmMicroarch) <= kCpumMicroarch_Intel_Core7_End)
259
260	/** Predicate macro for catching Atom CPUs, Silvermont and upwards. */
261	#define CPUMMICROARCH_IS_INTEL_SILVERMONT_PLUS(a_enmMicroarch) \
262	((a_enmMicroarch) >= kCpumMicroarch_Intel_Atom_Silvermont && (a_enmMicroarch) <= kCpumMicroarch_Intel_Atom_End)
263
264	/** Predicate macro for catching AMD Family OFh CPUs (aka K8). */
265	#define CPUMMICROARCH_IS_AMD_FAM_0FH(a_enmMicroarch) \
266	((a_enmMicroarch) >= kCpumMicroarch_AMD_K8_First && (a_enmMicroarch) <= kCpumMicroarch_AMD_K8_End)
267
268	/** Predicate macro for catching AMD Family 10H CPUs (aka K10). */
269	#define CPUMMICROARCH_IS_AMD_FAM_10H(a_enmMicroarch) ((a_enmMicroarch) == kCpumMicroarch_AMD_K10)
270
271	/** Predicate macro for catching AMD Family 11H CPUs (aka Lion). */
272	#define CPUMMICROARCH_IS_AMD_FAM_11H(a_enmMicroarch) ((a_enmMicroarch) == kCpumMicroarch_AMD_K10_Lion)
273
274	/** Predicate macro for catching AMD Family 12H CPUs (aka Llano). */
275	#define CPUMMICROARCH_IS_AMD_FAM_12H(a_enmMicroarch) ((a_enmMicroarch) == kCpumMicroarch_AMD_K10_Llano)
276
277	/** Predicate macro for catching AMD Family 14H CPUs (aka Bobcat). */
278	#define CPUMMICROARCH_IS_AMD_FAM_14H(a_enmMicroarch) ((a_enmMicroarch) == kCpumMicroarch_AMD_Bobcat)
279
280	/** Predicate macro for catching AMD Family 15H CPUs (bulldozer and it's
281	* decendants). */
282	#define CPUMMICROARCH_IS_AMD_FAM_15H(a_enmMicroarch) \
283	((a_enmMicroarch) >= kCpumMicroarch_AMD_15h_First && (a_enmMicroarch) <= kCpumMicroarch_AMD_15h_End)
284
285	/** Predicate macro for catching AMD Family 16H CPUs. */
286	#define CPUMMICROARCH_IS_AMD_FAM_16H(a_enmMicroarch) \
287	((a_enmMicroarch) >= kCpumMicroarch_AMD_16h_First && (a_enmMicroarch) <= kCpumMicroarch_AMD_16h_End)
288
289
290
291	/**
292	* CPUID leaf.
293	*
294	* @remarks This structure is used by the patch manager and is therefore
295	* more or less set in stone.
296	*/
297	typedef struct CPUMCPUIDLEAF
298	{
299	/** The leaf number. */
300	uint32_t uLeaf;
301	/** The sub-leaf number. */
302	uint32_t uSubLeaf;
303	/** Sub-leaf mask. This is 0 when sub-leaves aren't used. */
304	uint32_t fSubLeafMask;
305
306	/** The EAX value. */
307	uint32_t uEax;
308	/** The EBX value. */
309	uint32_t uEbx;
310	/** The ECX value. */
311	uint32_t uEcx;
312	/** The EDX value. */
313	uint32_t uEdx;
314
315	/** Flags. */
316	uint32_t fFlags;
317	} CPUMCPUIDLEAF;
318	#ifndef VBOX_FOR_DTRACE_LIB
319	AssertCompileSize(CPUMCPUIDLEAF, 32);
320	#endif
321	/** Pointer to a CPUID leaf. */
322	typedef CPUMCPUIDLEAF *PCPUMCPUIDLEAF;
323	/** Pointer to a const CPUID leaf. */
324	typedef CPUMCPUIDLEAF const *PCCPUMCPUIDLEAF;
325
326	/** @name CPUMCPUIDLEAF::fFlags
327	* @{ */
328	/** Indicates working intel leaf 0xb where the lower 8 ECX bits are not modified
329	* and EDX containing the extended APIC ID. */
330	#define CPUMCPUIDLEAF_F_INTEL_TOPOLOGY_SUBLEAVES RT_BIT_32(0)
331	/** The leaf contains an APIC ID that needs changing to that of the current CPU. */
332	#define CPUMCPUIDLEAF_F_CONTAINS_APIC_ID RT_BIT_32(1)
333	/** The leaf contains an OSXSAVE which needs individual handling on each CPU. */
334	#define CPUMCPUIDLEAF_F_CONTAINS_OSXSAVE RT_BIT_32(2)
335	/** The leaf contains an APIC feature bit which is tied to APICBASE.EN. */
336	#define CPUMCPUIDLEAF_F_CONTAINS_APIC RT_BIT_32(3)
337	/** Mask of the valid flags. */
338	#define CPUMCPUIDLEAF_F_VALID_MASK UINT32_C(0xf)
339	/** @} */
340
341	/**
342	* Method used to deal with unknown CPUID leaves.
343	* @remarks Used in patch code.
344	*/
345	typedef enum CPUMUNKNOWNCPUID
346	{
347	/** Invalid zero value. */
348	CPUMUNKNOWNCPUID_INVALID = 0,
349	/** Use given default values (DefCpuId). */
350	CPUMUNKNOWNCPUID_DEFAULTS,
351	/** Return the last standard leaf.
352	* Intel Sandy Bridge has been observed doing this. */
353	CPUMUNKNOWNCPUID_LAST_STD_LEAF,
354	/** Return the last standard leaf, with ecx observed.
355	* Intel Sandy Bridge has been observed doing this. */
356	CPUMUNKNOWNCPUID_LAST_STD_LEAF_WITH_ECX,
357	/** The register values are passed thru unmodified. */
358	CPUMUNKNOWNCPUID_PASSTHRU,
359	/** End of valid value. */
360	CPUMUNKNOWNCPUID_END,
361	/** Ensure 32-bit type. */
362	CPUMUNKNOWNCPUID_32BIT_HACK = 0x7fffffff
363	} CPUMUNKNOWNCPUID;
364	/** Pointer to unknown CPUID leaf method. */
365	typedef CPUMUNKNOWNCPUID *PCPUMUNKNOWNCPUID;
366
367
368	/**
369	* MSR read functions.
370	*/
371	typedef enum CPUMMSRRDFN
372	{
373	/** Invalid zero value. */
374	kCpumMsrRdFn_Invalid = 0,
375	/** Return the CPUMMSRRANGE::uValue. */
376	kCpumMsrRdFn_FixedValue,
377	/** Alias to the MSR range starting at the MSR given by
378	* CPUMMSRRANGE::uValue. Must be used in pair with
379	* kCpumMsrWrFn_MsrAlias. */
380	kCpumMsrRdFn_MsrAlias,
381	/** Write only register, GP all read attempts. */
382	kCpumMsrRdFn_WriteOnly,
383
384	kCpumMsrRdFn_Ia32P5McAddr,
385	kCpumMsrRdFn_Ia32P5McType,
386	kCpumMsrRdFn_Ia32TimestampCounter,
387	kCpumMsrRdFn_Ia32PlatformId, /*< Takes real CPU value for reference. /
388	kCpumMsrRdFn_Ia32ApicBase,
389	kCpumMsrRdFn_Ia32FeatureControl,
390	kCpumMsrRdFn_Ia32BiosSignId, /*< Range value returned. /
391	kCpumMsrRdFn_Ia32SmmMonitorCtl,
392	kCpumMsrRdFn_Ia32PmcN,
393	kCpumMsrRdFn_Ia32MonitorFilterLineSize,
394	kCpumMsrRdFn_Ia32MPerf,
395	kCpumMsrRdFn_Ia32APerf,
396	kCpumMsrRdFn_Ia32MtrrCap, /*< Takes real CPU value for reference. /
397	kCpumMsrRdFn_Ia32MtrrPhysBaseN, /*< Takes register number. /
398	kCpumMsrRdFn_Ia32MtrrPhysMaskN, /*< Takes register number. /
399	kCpumMsrRdFn_Ia32MtrrFixed, /*< Takes CPUMCPU offset. /
400	kCpumMsrRdFn_Ia32MtrrDefType,
401	kCpumMsrRdFn_Ia32Pat,
402	kCpumMsrRdFn_Ia32SysEnterCs,
403	kCpumMsrRdFn_Ia32SysEnterEsp,
404	kCpumMsrRdFn_Ia32SysEnterEip,
405	kCpumMsrRdFn_Ia32McgCap,
406	kCpumMsrRdFn_Ia32McgStatus,
407	kCpumMsrRdFn_Ia32McgCtl,
408	kCpumMsrRdFn_Ia32DebugCtl,
409	kCpumMsrRdFn_Ia32SmrrPhysBase,
410	kCpumMsrRdFn_Ia32SmrrPhysMask,
411	kCpumMsrRdFn_Ia32PlatformDcaCap,
412	kCpumMsrRdFn_Ia32CpuDcaCap,
413	kCpumMsrRdFn_Ia32Dca0Cap,
414	kCpumMsrRdFn_Ia32PerfEvtSelN, /*< Range value indicates the register number. /
415	kCpumMsrRdFn_Ia32PerfStatus, /*< Range value returned. /
416	kCpumMsrRdFn_Ia32PerfCtl, /*< Range value returned. /
417	kCpumMsrRdFn_Ia32FixedCtrN, /*< Takes register number of start of range. /
418	kCpumMsrRdFn_Ia32PerfCapabilities, /*< Takes reference value. /
419	kCpumMsrRdFn_Ia32FixedCtrCtrl,
420	kCpumMsrRdFn_Ia32PerfGlobalStatus, /*< Takes reference value. /
421	kCpumMsrRdFn_Ia32PerfGlobalCtrl,
422	kCpumMsrRdFn_Ia32PerfGlobalOvfCtrl,
423	kCpumMsrRdFn_Ia32PebsEnable,
424	kCpumMsrRdFn_Ia32ClockModulation, /*< Range value returned. /
425	kCpumMsrRdFn_Ia32ThermInterrupt, /*< Range value returned. /
426	kCpumMsrRdFn_Ia32ThermStatus, /*< Range value returned. /
427	kCpumMsrRdFn_Ia32Therm2Ctl, /*< Range value returned. /
428	kCpumMsrRdFn_Ia32MiscEnable, /*< Range value returned. /
429	kCpumMsrRdFn_Ia32McCtlStatusAddrMiscN, /*< Takes bank number. /
430	kCpumMsrRdFn_Ia32McNCtl2, /*< Takes register number of start of range. /
431	kCpumMsrRdFn_Ia32DsArea,
432	kCpumMsrRdFn_Ia32TscDeadline,
433	kCpumMsrRdFn_Ia32X2ApicN,
434	kCpumMsrRdFn_Ia32DebugInterface,
435	kCpumMsrRdFn_Ia32VmxBase, /*< Takes real value as reference. /
436	kCpumMsrRdFn_Ia32VmxPinbasedCtls, /*< Takes real value as reference. /
437	kCpumMsrRdFn_Ia32VmxProcbasedCtls, /*< Takes real value as reference. /
438	kCpumMsrRdFn_Ia32VmxExitCtls, /*< Takes real value as reference. /
439	kCpumMsrRdFn_Ia32VmxEntryCtls, /*< Takes real value as reference. /
440	kCpumMsrRdFn_Ia32VmxMisc, /*< Takes real value as reference. /
441	kCpumMsrRdFn_Ia32VmxCr0Fixed0, /*< Takes real value as reference. /
442	kCpumMsrRdFn_Ia32VmxCr0Fixed1, /*< Takes real value as reference. /
443	kCpumMsrRdFn_Ia32VmxCr4Fixed0, /*< Takes real value as reference. /
444	kCpumMsrRdFn_Ia32VmxCr4Fixed1, /*< Takes real value as reference. /
445	kCpumMsrRdFn_Ia32VmxVmcsEnum, /*< Takes real value as reference. /
446	kCpumMsrRdFn_Ia32VmxProcBasedCtls2, /*< Takes real value as reference. /
447	kCpumMsrRdFn_Ia32VmxEptVpidCap, /*< Takes real value as reference. /
448	kCpumMsrRdFn_Ia32VmxTruePinbasedCtls, /*< Takes real value as reference. /
449	kCpumMsrRdFn_Ia32VmxTrueProcbasedCtls, /*< Takes real value as reference. /
450	kCpumMsrRdFn_Ia32VmxTrueExitCtls, /*< Takes real value as reference. /
451	kCpumMsrRdFn_Ia32VmxTrueEntryCtls, /*< Takes real value as reference. /
452	kCpumMsrRdFn_Ia32VmxVmFunc, /*< Takes real value as reference. /
453
454	kCpumMsrRdFn_Amd64Efer,
455	kCpumMsrRdFn_Amd64SyscallTarget,
456	kCpumMsrRdFn_Amd64LongSyscallTarget,
457	kCpumMsrRdFn_Amd64CompSyscallTarget,
458	kCpumMsrRdFn_Amd64SyscallFlagMask,
459	kCpumMsrRdFn_Amd64FsBase,
460	kCpumMsrRdFn_Amd64GsBase,
461	kCpumMsrRdFn_Amd64KernelGsBase,
462	kCpumMsrRdFn_Amd64TscAux,
463
464	kCpumMsrRdFn_IntelEblCrPowerOn,
465	kCpumMsrRdFn_IntelI7CoreThreadCount,
466	kCpumMsrRdFn_IntelP4EbcHardPowerOn,
467	kCpumMsrRdFn_IntelP4EbcSoftPowerOn,
468	kCpumMsrRdFn_IntelP4EbcFrequencyId,
469	kCpumMsrRdFn_IntelP6FsbFrequency, /*< Takes real value as reference. /
470	kCpumMsrRdFn_IntelPlatformInfo,
471	kCpumMsrRdFn_IntelFlexRatio, /*< Takes real value as reference. /
472	kCpumMsrRdFn_IntelPkgCStConfigControl,
473	kCpumMsrRdFn_IntelPmgIoCaptureBase,
474	kCpumMsrRdFn_IntelLastBranchFromToN,
475	kCpumMsrRdFn_IntelLastBranchFromN,
476	kCpumMsrRdFn_IntelLastBranchToN,
477	kCpumMsrRdFn_IntelLastBranchTos,
478	kCpumMsrRdFn_IntelBblCrCtl,
479	kCpumMsrRdFn_IntelBblCrCtl3,
480	kCpumMsrRdFn_IntelI7TemperatureTarget, /*< Range value returned. /
481	kCpumMsrRdFn_IntelI7MsrOffCoreResponseN,/*< Takes register number. /
482	kCpumMsrRdFn_IntelI7MiscPwrMgmt,
483	kCpumMsrRdFn_IntelP6CrN,
484	kCpumMsrRdFn_IntelCpuId1FeatureMaskEcdx,
485	kCpumMsrRdFn_IntelCpuId1FeatureMaskEax,
486	kCpumMsrRdFn_IntelCpuId80000001FeatureMaskEcdx,
487	kCpumMsrRdFn_IntelI7SandyAesNiCtl,
488	kCpumMsrRdFn_IntelI7TurboRatioLimit, /*< Returns range value. /
489	kCpumMsrRdFn_IntelI7LbrSelect,
490	kCpumMsrRdFn_IntelI7SandyErrorControl,
491	kCpumMsrRdFn_IntelI7VirtualLegacyWireCap,/*< Returns range value. /
492	kCpumMsrRdFn_IntelI7PowerCtl,
493	kCpumMsrRdFn_IntelI7SandyPebsNumAlt,
494	kCpumMsrRdFn_IntelI7PebsLdLat,
495	kCpumMsrRdFn_IntelI7PkgCnResidencyN, /*< Takes C-state number. /
496	kCpumMsrRdFn_IntelI7CoreCnResidencyN, /*< Takes C-state number. /
497	kCpumMsrRdFn_IntelI7SandyVrCurrentConfig,/*< Takes real value as reference. /
498	kCpumMsrRdFn_IntelI7SandyVrMiscConfig, /*< Takes real value as reference. /
499	kCpumMsrRdFn_IntelI7SandyRaplPowerUnit, /*< Takes real value as reference. /
500	kCpumMsrRdFn_IntelI7SandyPkgCnIrtlN, /*< Takes real value as reference. /
501	kCpumMsrRdFn_IntelI7SandyPkgC2Residency, /*< Takes real value as reference. /
502	kCpumMsrRdFn_IntelI7RaplPkgPowerLimit, /*< Takes real value as reference. /
503	kCpumMsrRdFn_IntelI7RaplPkgEnergyStatus, /*< Takes real value as reference. /
504	kCpumMsrRdFn_IntelI7RaplPkgPerfStatus, /*< Takes real value as reference. /
505	kCpumMsrRdFn_IntelI7RaplPkgPowerInfo, /*< Takes real value as reference. /
506	kCpumMsrRdFn_IntelI7RaplDramPowerLimit, /*< Takes real value as reference. /
507	kCpumMsrRdFn_IntelI7RaplDramEnergyStatus,/*< Takes real value as reference. /
508	kCpumMsrRdFn_IntelI7RaplDramPerfStatus, /*< Takes real value as reference. /
509	kCpumMsrRdFn_IntelI7RaplDramPowerInfo, /*< Takes real value as reference. /
510	kCpumMsrRdFn_IntelI7RaplPp0PowerLimit, /*< Takes real value as reference. /
511	kCpumMsrRdFn_IntelI7RaplPp0EnergyStatus, /*< Takes real value as reference. /
512	kCpumMsrRdFn_IntelI7RaplPp0Policy, /*< Takes real value as reference. /
513	kCpumMsrRdFn_IntelI7RaplPp0PerfStatus, /*< Takes real value as reference. /
514	kCpumMsrRdFn_IntelI7RaplPp1PowerLimit, /*< Takes real value as reference. /
515	kCpumMsrRdFn_IntelI7RaplPp1EnergyStatus, /*< Takes real value as reference. /
516	kCpumMsrRdFn_IntelI7RaplPp1Policy, /*< Takes real value as reference. /
517	kCpumMsrRdFn_IntelI7IvyConfigTdpNominal, /*< Takes real value as reference. /
518	kCpumMsrRdFn_IntelI7IvyConfigTdpLevel1, /*< Takes real value as reference. /
519	kCpumMsrRdFn_IntelI7IvyConfigTdpLevel2, /*< Takes real value as reference. /
520	kCpumMsrRdFn_IntelI7IvyConfigTdpControl,
521	kCpumMsrRdFn_IntelI7IvyTurboActivationRatio,
522	kCpumMsrRdFn_IntelI7UncPerfGlobalCtrl,
523	kCpumMsrRdFn_IntelI7UncPerfGlobalStatus,
524	kCpumMsrRdFn_IntelI7UncPerfGlobalOvfCtrl,
525	kCpumMsrRdFn_IntelI7UncPerfFixedCtrCtrl,
526	kCpumMsrRdFn_IntelI7UncPerfFixedCtr,
527	kCpumMsrRdFn_IntelI7UncCBoxConfig,
528	kCpumMsrRdFn_IntelI7UncArbPerfCtrN,
529	kCpumMsrRdFn_IntelI7UncArbPerfEvtSelN,
530	kCpumMsrRdFn_IntelI7SmiCount,
531	kCpumMsrRdFn_IntelCore2EmttmCrTablesN, /*< Range value returned. /
532	kCpumMsrRdFn_IntelCore2SmmCStMiscInfo,
533	kCpumMsrRdFn_IntelCore1ExtConfig,
534	kCpumMsrRdFn_IntelCore1DtsCalControl,
535	kCpumMsrRdFn_IntelCore2PeciControl,
536	kCpumMsrRdFn_IntelAtSilvCoreC1Recidency,
537
538	kCpumMsrRdFn_P6LastBranchFromIp,
539	kCpumMsrRdFn_P6LastBranchToIp,
540	kCpumMsrRdFn_P6LastIntFromIp,
541	kCpumMsrRdFn_P6LastIntToIp,
542
543	kCpumMsrRdFn_AmdFam15hTscRate,
544	kCpumMsrRdFn_AmdFam15hLwpCfg,
545	kCpumMsrRdFn_AmdFam15hLwpCbAddr,
546	kCpumMsrRdFn_AmdFam10hMc4MiscN,
547	kCpumMsrRdFn_AmdK8PerfCtlN,
548	kCpumMsrRdFn_AmdK8PerfCtrN,
549	kCpumMsrRdFn_AmdK8SysCfg, /*< Range value returned. /
550	kCpumMsrRdFn_AmdK8HwCr,
551	kCpumMsrRdFn_AmdK8IorrBaseN,
552	kCpumMsrRdFn_AmdK8IorrMaskN,
553	kCpumMsrRdFn_AmdK8TopOfMemN,
554	kCpumMsrRdFn_AmdK8NbCfg1,
555	kCpumMsrRdFn_AmdK8McXcptRedir,
556	kCpumMsrRdFn_AmdK8CpuNameN,
557	kCpumMsrRdFn_AmdK8HwThermalCtrl, /*< Range value returned. /
558	kCpumMsrRdFn_AmdK8SwThermalCtrl,
559	kCpumMsrRdFn_AmdK8FidVidControl, /*< Range value returned. /
560	kCpumMsrRdFn_AmdK8FidVidStatus, /*< Range value returned. /
561	kCpumMsrRdFn_AmdK8McCtlMaskN,
562	kCpumMsrRdFn_AmdK8SmiOnIoTrapN,
563	kCpumMsrRdFn_AmdK8SmiOnIoTrapCtlSts,
564	kCpumMsrRdFn_AmdK8IntPendingMessage,
565	kCpumMsrRdFn_AmdK8SmiTriggerIoCycle,
566	kCpumMsrRdFn_AmdFam10hMmioCfgBaseAddr,
567	kCpumMsrRdFn_AmdFam10hTrapCtlMaybe,
568	kCpumMsrRdFn_AmdFam10hPStateCurLimit, /*< Returns range value. /
569	kCpumMsrRdFn_AmdFam10hPStateControl, /*< Returns range value. /
570	kCpumMsrRdFn_AmdFam10hPStateStatus, /*< Returns range value. /
571	kCpumMsrRdFn_AmdFam10hPStateN, /*< Returns range value. This isn't an register index! /
572	kCpumMsrRdFn_AmdFam10hCofVidControl, /*< Returns range value. /
573	kCpumMsrRdFn_AmdFam10hCofVidStatus, /*< Returns range value. /
574	kCpumMsrRdFn_AmdFam10hCStateIoBaseAddr,
575	kCpumMsrRdFn_AmdFam10hCpuWatchdogTimer,
576	kCpumMsrRdFn_AmdK8SmmBase,
577	kCpumMsrRdFn_AmdK8SmmAddr,
578	kCpumMsrRdFn_AmdK8SmmMask,
579	kCpumMsrRdFn_AmdK8VmCr,
580	kCpumMsrRdFn_AmdK8IgnNe,
581	kCpumMsrRdFn_AmdK8SmmCtl,
582	kCpumMsrRdFn_AmdK8VmHSavePa,
583	kCpumMsrRdFn_AmdFam10hVmLockKey,
584	kCpumMsrRdFn_AmdFam10hSmmLockKey,
585	kCpumMsrRdFn_AmdFam10hLocalSmiStatus,
586	kCpumMsrRdFn_AmdFam10hOsVisWrkIdLength,
587	kCpumMsrRdFn_AmdFam10hOsVisWrkStatus,
588	kCpumMsrRdFn_AmdFam16hL2IPerfCtlN,
589	kCpumMsrRdFn_AmdFam16hL2IPerfCtrN,
590	kCpumMsrRdFn_AmdFam15hNorthbridgePerfCtlN,
591	kCpumMsrRdFn_AmdFam15hNorthbridgePerfCtrN,
592	kCpumMsrRdFn_AmdK7MicrocodeCtl, /*< Returns range value. /
593	kCpumMsrRdFn_AmdK7ClusterIdMaybe, /*< Returns range value. /
594	kCpumMsrRdFn_AmdK8CpuIdCtlStd07hEbax,
595	kCpumMsrRdFn_AmdK8CpuIdCtlStd06hEcx,
596	kCpumMsrRdFn_AmdK8CpuIdCtlStd01hEdcx,
597	kCpumMsrRdFn_AmdK8CpuIdCtlExt01hEdcx,
598	kCpumMsrRdFn_AmdK8PatchLevel, /*< Returns range value. /
599	kCpumMsrRdFn_AmdK7DebugStatusMaybe,
600	kCpumMsrRdFn_AmdK7BHTraceBaseMaybe,
601	kCpumMsrRdFn_AmdK7BHTracePtrMaybe,
602	kCpumMsrRdFn_AmdK7BHTraceLimitMaybe,
603	kCpumMsrRdFn_AmdK7HardwareDebugToolCfgMaybe,
604	kCpumMsrRdFn_AmdK7FastFlushCountMaybe,
605	kCpumMsrRdFn_AmdK7NodeId,
606	kCpumMsrRdFn_AmdK7DrXAddrMaskN, /*< Takes register index. /
607	kCpumMsrRdFn_AmdK7Dr0DataMatchMaybe,
608	kCpumMsrRdFn_AmdK7Dr0DataMaskMaybe,
609	kCpumMsrRdFn_AmdK7LoadStoreCfg,
610	kCpumMsrRdFn_AmdK7InstrCacheCfg,
611	kCpumMsrRdFn_AmdK7DataCacheCfg,
612	kCpumMsrRdFn_AmdK7BusUnitCfg,
613	kCpumMsrRdFn_AmdK7DebugCtl2Maybe,
614	kCpumMsrRdFn_AmdFam15hFpuCfg,
615	kCpumMsrRdFn_AmdFam15hDecoderCfg,
616	kCpumMsrRdFn_AmdFam10hBusUnitCfg2,
617	kCpumMsrRdFn_AmdFam15hCombUnitCfg,
618	kCpumMsrRdFn_AmdFam15hCombUnitCfg2,
619	kCpumMsrRdFn_AmdFam15hCombUnitCfg3,
620	kCpumMsrRdFn_AmdFam15hExecUnitCfg,
621	kCpumMsrRdFn_AmdFam15hLoadStoreCfg2,
622	kCpumMsrRdFn_AmdFam10hIbsFetchCtl,
623	kCpumMsrRdFn_AmdFam10hIbsFetchLinAddr,
624	kCpumMsrRdFn_AmdFam10hIbsFetchPhysAddr,
625	kCpumMsrRdFn_AmdFam10hIbsOpExecCtl,
626	kCpumMsrRdFn_AmdFam10hIbsOpRip,
627	kCpumMsrRdFn_AmdFam10hIbsOpData,
628	kCpumMsrRdFn_AmdFam10hIbsOpData2,
629	kCpumMsrRdFn_AmdFam10hIbsOpData3,
630	kCpumMsrRdFn_AmdFam10hIbsDcLinAddr,
631	kCpumMsrRdFn_AmdFam10hIbsDcPhysAddr,
632	kCpumMsrRdFn_AmdFam10hIbsCtl,
633	kCpumMsrRdFn_AmdFam14hIbsBrTarget,
634
635	kCpumMsrRdFn_Gim,
636
637	/** End of valid MSR read function indexes. */
638	kCpumMsrRdFn_End
639	} CPUMMSRRDFN;
640
641	/**
642	* MSR write functions.
643	*/
644	typedef enum CPUMMSRWRFN
645	{
646	/** Invalid zero value. */
647	kCpumMsrWrFn_Invalid = 0,
648	/** Writes are ignored, the fWrGpMask is observed though. */
649	kCpumMsrWrFn_IgnoreWrite,
650	/** Writes cause GP(0) to be raised, the fWrGpMask should be UINT64_MAX. */
651	kCpumMsrWrFn_ReadOnly,
652	/** Alias to the MSR range starting at the MSR given by
653	* CPUMMSRRANGE::uValue. Must be used in pair with
654	* kCpumMsrRdFn_MsrAlias. */
655	kCpumMsrWrFn_MsrAlias,
656
657	kCpumMsrWrFn_Ia32P5McAddr,
658	kCpumMsrWrFn_Ia32P5McType,
659	kCpumMsrWrFn_Ia32TimestampCounter,
660	kCpumMsrWrFn_Ia32ApicBase,
661	kCpumMsrWrFn_Ia32FeatureControl,
662	kCpumMsrWrFn_Ia32BiosSignId,
663	kCpumMsrWrFn_Ia32BiosUpdateTrigger,
664	kCpumMsrWrFn_Ia32SmmMonitorCtl,
665	kCpumMsrWrFn_Ia32PmcN,
666	kCpumMsrWrFn_Ia32MonitorFilterLineSize,
667	kCpumMsrWrFn_Ia32MPerf,
668	kCpumMsrWrFn_Ia32APerf,
669	kCpumMsrWrFn_Ia32MtrrPhysBaseN, /*< Takes register number. /
670	kCpumMsrWrFn_Ia32MtrrPhysMaskN, /*< Takes register number. /
671	kCpumMsrWrFn_Ia32MtrrFixed, /*< Takes CPUMCPU offset. /
672	kCpumMsrWrFn_Ia32MtrrDefType,
673	kCpumMsrWrFn_Ia32Pat,
674	kCpumMsrWrFn_Ia32SysEnterCs,
675	kCpumMsrWrFn_Ia32SysEnterEsp,
676	kCpumMsrWrFn_Ia32SysEnterEip,
677	kCpumMsrWrFn_Ia32McgStatus,
678	kCpumMsrWrFn_Ia32McgCtl,
679	kCpumMsrWrFn_Ia32DebugCtl,
680	kCpumMsrWrFn_Ia32SmrrPhysBase,
681	kCpumMsrWrFn_Ia32SmrrPhysMask,
682	kCpumMsrWrFn_Ia32PlatformDcaCap,
683	kCpumMsrWrFn_Ia32Dca0Cap,
684	kCpumMsrWrFn_Ia32PerfEvtSelN, /*< Range value indicates the register number. /
685	kCpumMsrWrFn_Ia32PerfStatus,
686	kCpumMsrWrFn_Ia32PerfCtl,
687	kCpumMsrWrFn_Ia32FixedCtrN, /*< Takes register number of start of range. /
688	kCpumMsrWrFn_Ia32PerfCapabilities,
689	kCpumMsrWrFn_Ia32FixedCtrCtrl,
690	kCpumMsrWrFn_Ia32PerfGlobalStatus,
691	kCpumMsrWrFn_Ia32PerfGlobalCtrl,
692	kCpumMsrWrFn_Ia32PerfGlobalOvfCtrl,
693	kCpumMsrWrFn_Ia32PebsEnable,
694	kCpumMsrWrFn_Ia32ClockModulation,
695	kCpumMsrWrFn_Ia32ThermInterrupt,
696	kCpumMsrWrFn_Ia32ThermStatus,
697	kCpumMsrWrFn_Ia32Therm2Ctl,
698	kCpumMsrWrFn_Ia32MiscEnable,
699	kCpumMsrWrFn_Ia32McCtlStatusAddrMiscN, /*< Takes bank number. /
700	kCpumMsrWrFn_Ia32McNCtl2, /*< Takes register number of start of range. /
701	kCpumMsrWrFn_Ia32DsArea,
702	kCpumMsrWrFn_Ia32TscDeadline,
703	kCpumMsrWrFn_Ia32X2ApicN,
704	kCpumMsrWrFn_Ia32DebugInterface,
705
706	kCpumMsrWrFn_Amd64Efer,
707	kCpumMsrWrFn_Amd64SyscallTarget,
708	kCpumMsrWrFn_Amd64LongSyscallTarget,
709	kCpumMsrWrFn_Amd64CompSyscallTarget,
710	kCpumMsrWrFn_Amd64SyscallFlagMask,
711	kCpumMsrWrFn_Amd64FsBase,
712	kCpumMsrWrFn_Amd64GsBase,
713	kCpumMsrWrFn_Amd64KernelGsBase,
714	kCpumMsrWrFn_Amd64TscAux,
715	kCpumMsrWrFn_IntelEblCrPowerOn,
716	kCpumMsrWrFn_IntelP4EbcHardPowerOn,
717	kCpumMsrWrFn_IntelP4EbcSoftPowerOn,
718	kCpumMsrWrFn_IntelP4EbcFrequencyId,
719	kCpumMsrWrFn_IntelFlexRatio,
720	kCpumMsrWrFn_IntelPkgCStConfigControl,
721	kCpumMsrWrFn_IntelPmgIoCaptureBase,
722	kCpumMsrWrFn_IntelLastBranchFromToN,
723	kCpumMsrWrFn_IntelLastBranchFromN,
724	kCpumMsrWrFn_IntelLastBranchToN,
725	kCpumMsrWrFn_IntelLastBranchTos,
726	kCpumMsrWrFn_IntelBblCrCtl,
727	kCpumMsrWrFn_IntelBblCrCtl3,
728	kCpumMsrWrFn_IntelI7TemperatureTarget,
729	kCpumMsrWrFn_IntelI7MsrOffCoreResponseN, /*< Takes register number. /
730	kCpumMsrWrFn_IntelI7MiscPwrMgmt,
731	kCpumMsrWrFn_IntelP6CrN,
732	kCpumMsrWrFn_IntelCpuId1FeatureMaskEcdx,
733	kCpumMsrWrFn_IntelCpuId1FeatureMaskEax,
734	kCpumMsrWrFn_IntelCpuId80000001FeatureMaskEcdx,
735	kCpumMsrWrFn_IntelI7SandyAesNiCtl,
736	kCpumMsrWrFn_IntelI7TurboRatioLimit,
737	kCpumMsrWrFn_IntelI7LbrSelect,
738	kCpumMsrWrFn_IntelI7SandyErrorControl,
739	kCpumMsrWrFn_IntelI7PowerCtl,
740	kCpumMsrWrFn_IntelI7SandyPebsNumAlt,
741	kCpumMsrWrFn_IntelI7PebsLdLat,
742	kCpumMsrWrFn_IntelI7SandyVrCurrentConfig,
743	kCpumMsrWrFn_IntelI7SandyVrMiscConfig,
744	kCpumMsrWrFn_IntelI7SandyRaplPowerUnit, /*< R/O but found writable bits on a Silvermont CPU here. /
745	kCpumMsrWrFn_IntelI7SandyPkgCnIrtlN,
746	kCpumMsrWrFn_IntelI7SandyPkgC2Residency, /*< R/O but found writable bits on a Silvermont CPU here. /
747	kCpumMsrWrFn_IntelI7RaplPkgPowerLimit,
748	kCpumMsrWrFn_IntelI7RaplDramPowerLimit,
749	kCpumMsrWrFn_IntelI7RaplPp0PowerLimit,
750	kCpumMsrWrFn_IntelI7RaplPp0Policy,
751	kCpumMsrWrFn_IntelI7RaplPp1PowerLimit,
752	kCpumMsrWrFn_IntelI7RaplPp1Policy,
753	kCpumMsrWrFn_IntelI7IvyConfigTdpControl,
754	kCpumMsrWrFn_IntelI7IvyTurboActivationRatio,
755	kCpumMsrWrFn_IntelI7UncPerfGlobalCtrl,
756	kCpumMsrWrFn_IntelI7UncPerfGlobalStatus,
757	kCpumMsrWrFn_IntelI7UncPerfGlobalOvfCtrl,
758	kCpumMsrWrFn_IntelI7UncPerfFixedCtrCtrl,
759	kCpumMsrWrFn_IntelI7UncPerfFixedCtr,
760	kCpumMsrWrFn_IntelI7UncArbPerfCtrN,
761	kCpumMsrWrFn_IntelI7UncArbPerfEvtSelN,
762	kCpumMsrWrFn_IntelCore2EmttmCrTablesN,
763	kCpumMsrWrFn_IntelCore2SmmCStMiscInfo,
764	kCpumMsrWrFn_IntelCore1ExtConfig,
765	kCpumMsrWrFn_IntelCore1DtsCalControl,
766	kCpumMsrWrFn_IntelCore2PeciControl,
767
768	kCpumMsrWrFn_P6LastIntFromIp,
769	kCpumMsrWrFn_P6LastIntToIp,
770
771	kCpumMsrWrFn_AmdFam15hTscRate,
772	kCpumMsrWrFn_AmdFam15hLwpCfg,
773	kCpumMsrWrFn_AmdFam15hLwpCbAddr,
774	kCpumMsrWrFn_AmdFam10hMc4MiscN,
775	kCpumMsrWrFn_AmdK8PerfCtlN,
776	kCpumMsrWrFn_AmdK8PerfCtrN,
777	kCpumMsrWrFn_AmdK8SysCfg,
778	kCpumMsrWrFn_AmdK8HwCr,
779	kCpumMsrWrFn_AmdK8IorrBaseN,
780	kCpumMsrWrFn_AmdK8IorrMaskN,
781	kCpumMsrWrFn_AmdK8TopOfMemN,
782	kCpumMsrWrFn_AmdK8NbCfg1,
783	kCpumMsrWrFn_AmdK8McXcptRedir,
784	kCpumMsrWrFn_AmdK8CpuNameN,
785	kCpumMsrWrFn_AmdK8HwThermalCtrl,
786	kCpumMsrWrFn_AmdK8SwThermalCtrl,
787	kCpumMsrWrFn_AmdK8FidVidControl,
788	kCpumMsrWrFn_AmdK8McCtlMaskN,
789	kCpumMsrWrFn_AmdK8SmiOnIoTrapN,
790	kCpumMsrWrFn_AmdK8SmiOnIoTrapCtlSts,
791	kCpumMsrWrFn_AmdK8IntPendingMessage,
792	kCpumMsrWrFn_AmdK8SmiTriggerIoCycle,
793	kCpumMsrWrFn_AmdFam10hMmioCfgBaseAddr,
794	kCpumMsrWrFn_AmdFam10hTrapCtlMaybe,
795	kCpumMsrWrFn_AmdFam10hPStateControl,
796	kCpumMsrWrFn_AmdFam10hPStateStatus,
797	kCpumMsrWrFn_AmdFam10hPStateN,
798	kCpumMsrWrFn_AmdFam10hCofVidControl,
799	kCpumMsrWrFn_AmdFam10hCofVidStatus,
800	kCpumMsrWrFn_AmdFam10hCStateIoBaseAddr,
801	kCpumMsrWrFn_AmdFam10hCpuWatchdogTimer,
802	kCpumMsrWrFn_AmdK8SmmBase,
803	kCpumMsrWrFn_AmdK8SmmAddr,
804	kCpumMsrWrFn_AmdK8SmmMask,
805	kCpumMsrWrFn_AmdK8VmCr,
806	kCpumMsrWrFn_AmdK8IgnNe,
807	kCpumMsrWrFn_AmdK8SmmCtl,
808	kCpumMsrWrFn_AmdK8VmHSavePa,
809	kCpumMsrWrFn_AmdFam10hVmLockKey,
810	kCpumMsrWrFn_AmdFam10hSmmLockKey,
811	kCpumMsrWrFn_AmdFam10hLocalSmiStatus,
812	kCpumMsrWrFn_AmdFam10hOsVisWrkIdLength,
813	kCpumMsrWrFn_AmdFam10hOsVisWrkStatus,
814	kCpumMsrWrFn_AmdFam16hL2IPerfCtlN,
815	kCpumMsrWrFn_AmdFam16hL2IPerfCtrN,
816	kCpumMsrWrFn_AmdFam15hNorthbridgePerfCtlN,
817	kCpumMsrWrFn_AmdFam15hNorthbridgePerfCtrN,
818	kCpumMsrWrFn_AmdK7MicrocodeCtl,
819	kCpumMsrWrFn_AmdK7ClusterIdMaybe,
820	kCpumMsrWrFn_AmdK8CpuIdCtlStd07hEbax,
821	kCpumMsrWrFn_AmdK8CpuIdCtlStd06hEcx,
822	kCpumMsrWrFn_AmdK8CpuIdCtlStd01hEdcx,
823	kCpumMsrWrFn_AmdK8CpuIdCtlExt01hEdcx,
824	kCpumMsrWrFn_AmdK8PatchLoader,
825	kCpumMsrWrFn_AmdK7DebugStatusMaybe,
826	kCpumMsrWrFn_AmdK7BHTraceBaseMaybe,
827	kCpumMsrWrFn_AmdK7BHTracePtrMaybe,
828	kCpumMsrWrFn_AmdK7BHTraceLimitMaybe,
829	kCpumMsrWrFn_AmdK7HardwareDebugToolCfgMaybe,
830	kCpumMsrWrFn_AmdK7FastFlushCountMaybe,
831	kCpumMsrWrFn_AmdK7NodeId,
832	kCpumMsrWrFn_AmdK7DrXAddrMaskN, /*< Takes register index. /
833	kCpumMsrWrFn_AmdK7Dr0DataMatchMaybe,
834	kCpumMsrWrFn_AmdK7Dr0DataMaskMaybe,
835	kCpumMsrWrFn_AmdK7LoadStoreCfg,
836	kCpumMsrWrFn_AmdK7InstrCacheCfg,
837	kCpumMsrWrFn_AmdK7DataCacheCfg,
838	kCpumMsrWrFn_AmdK7BusUnitCfg,
839	kCpumMsrWrFn_AmdK7DebugCtl2Maybe,
840	kCpumMsrWrFn_AmdFam15hFpuCfg,
841	kCpumMsrWrFn_AmdFam15hDecoderCfg,
842	kCpumMsrWrFn_AmdFam10hBusUnitCfg2,
843	kCpumMsrWrFn_AmdFam15hCombUnitCfg,
844	kCpumMsrWrFn_AmdFam15hCombUnitCfg2,
845	kCpumMsrWrFn_AmdFam15hCombUnitCfg3,
846	kCpumMsrWrFn_AmdFam15hExecUnitCfg,
847	kCpumMsrWrFn_AmdFam15hLoadStoreCfg2,
848	kCpumMsrWrFn_AmdFam10hIbsFetchCtl,
849	kCpumMsrWrFn_AmdFam10hIbsFetchLinAddr,
850	kCpumMsrWrFn_AmdFam10hIbsFetchPhysAddr,
851	kCpumMsrWrFn_AmdFam10hIbsOpExecCtl,
852	kCpumMsrWrFn_AmdFam10hIbsOpRip,
853	kCpumMsrWrFn_AmdFam10hIbsOpData,
854	kCpumMsrWrFn_AmdFam10hIbsOpData2,
855	kCpumMsrWrFn_AmdFam10hIbsOpData3,
856	kCpumMsrWrFn_AmdFam10hIbsDcLinAddr,
857	kCpumMsrWrFn_AmdFam10hIbsDcPhysAddr,
858	kCpumMsrWrFn_AmdFam10hIbsCtl,
859	kCpumMsrWrFn_AmdFam14hIbsBrTarget,
860
861	kCpumMsrWrFn_Gim,
862
863	/** End of valid MSR write function indexes. */
864	kCpumMsrWrFn_End
865	} CPUMMSRWRFN;
866
867	/**
868	* MSR range.
869	*/
870	typedef struct CPUMMSRRANGE
871	{
872	/** The first MSR. [0] */
873	uint32_t uFirst;
874	/** The last MSR. [4] */
875	uint32_t uLast;
876	/** The read function (CPUMMSRRDFN). [8] */
877	uint16_t enmRdFn;
878	/** The write function (CPUMMSRWRFN). [10] */
879	uint16_t enmWrFn;
880	/** The offset of the 64-bit MSR value relative to the start of CPUMCPU.
881	* UINT16_MAX if not used by the read and write functions. [12] */
882	uint16_t offCpumCpu;
883	/** Reserved for future hacks. [14] */
884	uint16_t fReserved;
885	/** The init/read value. [16]
886	* When enmRdFn is kCpumMsrRdFn_INIT_VALUE, this is the value returned on RDMSR.
887	* offCpumCpu must be UINT16_MAX in that case, otherwise it must be a valid
888	* offset into CPUM. */
889	uint64_t uValue;
890	/** The bits to ignore when writing. [24] */
891	uint64_t fWrIgnMask;
892	/** The bits that will cause a GP(0) when writing. [32]
893	* This is always checked prior to calling the write function. Using
894	* UINT64_MAX effectively marks the MSR as read-only. */
895	uint64_t fWrGpMask;
896	/** The register name, if applicable. [40] */
897	char szName[56];
898
899	#ifdef VBOX_WITH_STATISTICS
900	/** The number of reads. */
901	STAMCOUNTER cReads;
902	/** The number of writes. */
903	STAMCOUNTER cWrites;
904	/** The number of times ignored bits were written. */
905	STAMCOUNTER cIgnoredBits;
906	/** The number of GPs generated. */
907	STAMCOUNTER cGps;
908	#endif
909	} CPUMMSRRANGE;
910	#ifndef VBOX_FOR_DTRACE_LIB
911	# ifdef VBOX_WITH_STATISTICS
912	AssertCompileSize(CPUMMSRRANGE, 128);
913	# else
914	AssertCompileSize(CPUMMSRRANGE, 96);
915	# endif
916	#endif
917	/** Pointer to an MSR range. */
918	typedef CPUMMSRRANGE *PCPUMMSRRANGE;
919	/** Pointer to a const MSR range. */
920	typedef CPUMMSRRANGE const *PCCPUMMSRRANGE;
921
922
923	/**
924	* CPU features and quirks.
925	* This is mostly exploded CPUID info.
926	*/
927	typedef struct CPUMFEATURES
928	{
929	/** The CPU vendor (CPUMCPUVENDOR). */
930	uint8_t enmCpuVendor;
931	/** The CPU family. */
932	uint8_t uFamily;
933	/** The CPU model. */
934	uint8_t uModel;
935	/** The CPU stepping. */
936	uint8_t uStepping;
937	/** The microarchitecture. */
938	#ifndef VBOX_FOR_DTRACE_LIB
939	CPUMMICROARCH enmMicroarch;
940	#else
941	uint32_t enmMicroarch;
942	#endif
943	/** The maximum physical address with of the CPU. */
944	uint8_t cMaxPhysAddrWidth;
945	/** Alignment padding. */
946	uint8_t abPadding[1];
947	/** Max size of the extended state (or FPU state if no XSAVE). */
948	uint16_t cbMaxExtendedState;
949
950	/** Supports MSRs. */
951	uint32_t fMsr : 1;
952	/** Supports the page size extension (4/2 MB pages). */
953	uint32_t fPse : 1;
954	/** Supports 36-bit page size extension (4 MB pages can map memory above
955	* 4GB). */
956	uint32_t fPse36 : 1;
957	/** Supports physical address extension (PAE). */
958	uint32_t fPae : 1;
959	/** Page attribute table (PAT) support (page level cache control). */
960	uint32_t fPat : 1;
961	/** Supports the FXSAVE and FXRSTOR instructions. */
962	uint32_t fFxSaveRstor : 1;
963	/** Supports the XSAVE and XRSTOR instructions. */
964	uint32_t fXSaveRstor : 1;
965	/** The XSAVE/XRSTOR bit in CR4 has been set (only applicable for host!). */
966	uint32_t fOpSysXSaveRstor : 1;
967	/** Supports MMX. */
968	uint32_t fMmx : 1;
969	/** Supports AMD extensions to MMX instructions. */
970	uint32_t fAmdMmxExts : 1;
971	/** Supports SSE. */
972	uint32_t fSse : 1;
973	/** Supports SSE2. */
974	uint32_t fSse2 : 1;
975	/** Supports SSE3. */
976	uint32_t fSse3 : 1;
977	/** Supports SSSE3. */
978	uint32_t fSsse3 : 1;
979	/** Supports SSE4.1. */
980	uint32_t fSse41 : 1;
981	/** Supports SSE4.2. */
982	uint32_t fSse42 : 1;
983	/** Supports AVX. */
984	uint32_t fAvx : 1;
985	/** Supports AVX2. */
986	uint32_t fAvx2 : 1;
987	/** Supports AVX512 foundation. */
988	uint32_t fAvx512Foundation : 1;
989	/** Supports RDTSC. */
990	uint32_t fTsc : 1;
991	/** Intel SYSENTER/SYSEXIT support */
992	uint32_t fSysEnter : 1;
993	/** First generation APIC. */
994	uint32_t fApic : 1;
995	/** Second generation APIC. */
996	uint32_t fX2Apic : 1;
997	/** Hypervisor present. */
998	uint32_t fHypervisorPresent : 1;
999	/** MWAIT & MONITOR instructions supported. */
1000	uint32_t fMonitorMWait : 1;
1001	/** MWAIT Extensions present. */
1002	uint32_t fMWaitExtensions : 1;
1003	/** Supports CMPXCHG16B in 64-bit mode. */
1004	uint32_t fMovCmpXchg16b : 1;
1005	/** Supports CLFLUSH. */
1006	uint32_t fClFlush : 1;
1007	/** Supports CLFLUSHOPT. */
1008	uint32_t fClFlushOpt : 1;
1009
1010	/** Supports AMD 3DNow instructions. */
1011	uint32_t f3DNow : 1;
1012	/** Supports the 3DNow/AMD64 prefetch instructions (could be nops). */
1013	uint32_t f3DNowPrefetch : 1;
1014
1015	/** AMD64: Supports long mode. */
1016	uint32_t fLongMode : 1;
1017	/** AMD64: SYSCALL/SYSRET support. */
1018	uint32_t fSysCall : 1;
1019	/** AMD64: No-execute page table bit. */
1020	uint32_t fNoExecute : 1;
1021	/** AMD64: Supports LAHF & SAHF instructions in 64-bit mode. */
1022	uint32_t fLahfSahf : 1;
1023	/** AMD64: Supports RDTSCP. */
1024	uint32_t fRdTscP : 1;
1025	/** AMD64: Supports MOV CR8 in 32-bit code (lock prefix hack). */
1026	uint32_t fMovCr8In32Bit : 1;
1027	/** AMD64: Supports XOP (similar to VEX3/AVX). */
1028	uint32_t fXop : 1;
1029
1030	/** Indicates that FPU instruction and data pointers may leak.
1031	* This generally applies to recent AMD CPUs, where the FPU IP and DP pointer
1032	* is only saved and restored if an exception is pending. */
1033	uint32_t fLeakyFxSR : 1;
1034
1035	/** AMD64: Supports AMD SVM. */
1036	uint32_t fSvm : 1;
1037
1038	/** Support for Intel VMX. */
1039	uint32_t fVmx : 1;
1040
1041	/** Alignment padding / reserved for future use. */
1042	uint32_t fPadding : 23;
1043
1044	/** SVM: Supports Nested-paging. */
1045	uint32_t fSvmNestedPaging : 1;
1046	/** SVM: Support LBR (Last Branch Record) virtualization. */
1047	uint32_t fSvmLbrVirt : 1;
1048	/** SVM: Supports SVM lock. */
1049	uint32_t fSvmSvmLock : 1;
1050	/** SVM: Supports Next RIP save. */
1051	uint32_t fSvmNextRipSave : 1;
1052	/** SVM: Supports TSC rate MSR. */
1053	uint32_t fSvmTscRateMsr : 1;
1054	/** SVM: Supports VMCB clean bits. */
1055	uint32_t fSvmVmcbClean : 1;
1056	/** SVM: Supports Flush-by-ASID. */
1057	uint32_t fSvmFlusbByAsid : 1;
1058	/** SVM: Supports decode assist. */
1059	uint32_t fSvmDecodeAssist : 1;
1060	/** SVM: Supports Pause filter. */
1061	uint32_t fSvmPauseFilter : 1;
1062	/** SVM: Supports Pause filter threshold. */
1063	uint32_t fSvmPauseFilterThreshold : 1;
1064	/** SVM: Supports AVIC (Advanced Virtual Interrupt Controller). */
1065	uint32_t fSvmAvic : 1;
1066	/** SVM: Padding / reserved for future features. */
1067	uint32_t fSvmPadding0 : 21;
1068	/** SVM: Maximum supported ASID. */
1069	uint32_t uSvmMaxAsid;
1070
1071	/** @todo VMX features. */
1072	uint32_t auPadding[1];
1073	} CPUMFEATURES;
1074	#ifndef VBOX_FOR_DTRACE_LIB
1075	AssertCompileSize(CPUMFEATURES, 32);
1076	#endif
1077	/** Pointer to a CPU feature structure. */
1078	typedef CPUMFEATURES *PCPUMFEATURES;
1079	/** Pointer to a const CPU feature structure. */
1080	typedef CPUMFEATURES const *PCCPUMFEATURES;
1081
1082
1083	#ifndef VBOX_FOR_DTRACE_LIB
1084
1085	/** @name Guest Register Getters.
1086	* @{ */
1087	VMMDECL(void) CPUMGetGuestGDTR(PVMCPU pVCpu, PVBOXGDTR pGDTR);
1088	VMMDECL(RTGCPTR) CPUMGetGuestIDTR(PVMCPU pVCpu, uint16_t *pcbLimit);
1089	VMMDECL(RTSEL) CPUMGetGuestTR(PVMCPU pVCpu, PCPUMSELREGHID pHidden);
1090	VMMDECL(RTSEL) CPUMGetGuestLDTR(PVMCPU pVCpu);
1091	VMMDECL(RTSEL) CPUMGetGuestLdtrEx(PVMCPU pVCpu, uint64_t pGCPtrBase, uint32_t pcbLimit);
1092	VMMDECL(uint64_t) CPUMGetGuestCR0(PVMCPU pVCpu);
1093	VMMDECL(uint64_t) CPUMGetGuestCR2(PVMCPU pVCpu);
1094	VMMDECL(uint64_t) CPUMGetGuestCR3(PVMCPU pVCpu);
1095	VMMDECL(uint64_t) CPUMGetGuestCR4(PVMCPU pVCpu);
1096	VMMDECL(uint64_t) CPUMGetGuestCR8(PVMCPU pVCpu);
1097	VMMDECL(int) CPUMGetGuestCRx(PVMCPU pVCpu, unsigned iReg, uint64_t *pValue);
1098	VMMDECL(uint32_t) CPUMGetGuestEFlags(PVMCPU pVCpu);
1099	VMMDECL(uint32_t) CPUMGetGuestEIP(PVMCPU pVCpu);
1100	VMMDECL(uint64_t) CPUMGetGuestRIP(PVMCPU pVCpu);
1101	VMMDECL(uint32_t) CPUMGetGuestEAX(PVMCPU pVCpu);
1102	VMMDECL(uint32_t) CPUMGetGuestEBX(PVMCPU pVCpu);
1103	VMMDECL(uint32_t) CPUMGetGuestECX(PVMCPU pVCpu);
1104	VMMDECL(uint32_t) CPUMGetGuestEDX(PVMCPU pVCpu);
1105	VMMDECL(uint32_t) CPUMGetGuestESI(PVMCPU pVCpu);
1106	VMMDECL(uint32_t) CPUMGetGuestEDI(PVMCPU pVCpu);
1107	VMMDECL(uint32_t) CPUMGetGuestESP(PVMCPU pVCpu);
1108	VMMDECL(uint32_t) CPUMGetGuestEBP(PVMCPU pVCpu);
1109	VMMDECL(RTSEL) CPUMGetGuestCS(PVMCPU pVCpu);
1110	VMMDECL(RTSEL) CPUMGetGuestDS(PVMCPU pVCpu);
1111	VMMDECL(RTSEL) CPUMGetGuestES(PVMCPU pVCpu);
1112	VMMDECL(RTSEL) CPUMGetGuestFS(PVMCPU pVCpu);
1113	VMMDECL(RTSEL) CPUMGetGuestGS(PVMCPU pVCpu);
1114	VMMDECL(RTSEL) CPUMGetGuestSS(PVMCPU pVCpu);
1115	VMMDECL(uint64_t) CPUMGetGuestFlatPC(PVMCPU pVCpu);
1116	VMMDECL(uint64_t) CPUMGetGuestFlatSP(PVMCPU pVCpu);
1117	VMMDECL(uint64_t) CPUMGetGuestDR0(PVMCPU pVCpu);
1118	VMMDECL(uint64_t) CPUMGetGuestDR1(PVMCPU pVCpu);
1119	VMMDECL(uint64_t) CPUMGetGuestDR2(PVMCPU pVCpu);
1120	VMMDECL(uint64_t) CPUMGetGuestDR3(PVMCPU pVCpu);
1121	VMMDECL(uint64_t) CPUMGetGuestDR6(PVMCPU pVCpu);
1122	VMMDECL(uint64_t) CPUMGetGuestDR7(PVMCPU pVCpu);
1123	VMMDECL(int) CPUMGetGuestDRx(PVMCPU pVCpu, uint32_t iReg, uint64_t *pValue);
1124	VMMDECL(void) CPUMGetGuestCpuId(PVMCPU pVCpu, uint32_t iLeaf, uint32_t iSubLeaf,
1125	uint32_t pEax, uint32_t pEbx, uint32_t pEcx, uint32_t pEdx);
1126	VMMDECL(uint64_t) CPUMGetGuestEFER(PVMCPU pVCpu);
1127	VMMDECL(VBOXSTRICTRC) CPUMQueryGuestMsr(PVMCPU pVCpu, uint32_t idMsr, uint64_t *puValue);
1128	VMMDECL(VBOXSTRICTRC) CPUMSetGuestMsr(PVMCPU pVCpu, uint32_t idMsr, uint64_t uValue);
1129	VMMDECL(CPUMCPUVENDOR) CPUMGetGuestCpuVendor(PVM pVM);
1130	VMMDECL(CPUMCPUVENDOR) CPUMGetHostCpuVendor(PVM pVM);
1131	/** @} */
1132
1133	/** @name Guest Register Setters.
1134	* @{ */
1135	VMMDECL(int) CPUMSetGuestGDTR(PVMCPU pVCpu, uint64_t GCPtrBase, uint16_t cbLimit);
1136	VMMDECL(int) CPUMSetGuestIDTR(PVMCPU pVCpu, uint64_t GCPtrBase, uint16_t cbLimit);
1137	VMMDECL(int) CPUMSetGuestTR(PVMCPU pVCpu, uint16_t tr);
1138	VMMDECL(int) CPUMSetGuestLDTR(PVMCPU pVCpu, uint16_t ldtr);
1139	VMMDECL(int) CPUMSetGuestCR0(PVMCPU pVCpu, uint64_t cr0);
1140	VMMDECL(int) CPUMSetGuestCR2(PVMCPU pVCpu, uint64_t cr2);
1141	VMMDECL(int) CPUMSetGuestCR3(PVMCPU pVCpu, uint64_t cr3);
1142	VMMDECL(int) CPUMSetGuestCR4(PVMCPU pVCpu, uint64_t cr4);
1143	VMMDECL(int) CPUMSetGuestDR0(PVMCPU pVCpu, uint64_t uDr0);
1144	VMMDECL(int) CPUMSetGuestDR1(PVMCPU pVCpu, uint64_t uDr1);
1145	VMMDECL(int) CPUMSetGuestDR2(PVMCPU pVCpu, uint64_t uDr2);
1146	VMMDECL(int) CPUMSetGuestDR3(PVMCPU pVCpu, uint64_t uDr3);
1147	VMMDECL(int) CPUMSetGuestDR6(PVMCPU pVCpu, uint64_t uDr6);
1148	VMMDECL(int) CPUMSetGuestDR7(PVMCPU pVCpu, uint64_t uDr7);
1149	VMMDECL(int) CPUMSetGuestDRx(PVMCPU pVCpu, uint32_t iReg, uint64_t Value);
1150	VMM_INT_DECL(int) CPUMSetGuestXcr0(PVMCPU pVCpu, uint64_t uNewValue);
1151	VMMDECL(int) CPUMSetGuestEFlags(PVMCPU pVCpu, uint32_t eflags);
1152	VMMDECL(int) CPUMSetGuestEIP(PVMCPU pVCpu, uint32_t eip);
1153	VMMDECL(int) CPUMSetGuestEAX(PVMCPU pVCpu, uint32_t eax);
1154	VMMDECL(int) CPUMSetGuestEBX(PVMCPU pVCpu, uint32_t ebx);
1155	VMMDECL(int) CPUMSetGuestECX(PVMCPU pVCpu, uint32_t ecx);
1156	VMMDECL(int) CPUMSetGuestEDX(PVMCPU pVCpu, uint32_t edx);
1157	VMMDECL(int) CPUMSetGuestESI(PVMCPU pVCpu, uint32_t esi);
1158	VMMDECL(int) CPUMSetGuestEDI(PVMCPU pVCpu, uint32_t edi);
1159	VMMDECL(int) CPUMSetGuestESP(PVMCPU pVCpu, uint32_t esp);
1160	VMMDECL(int) CPUMSetGuestEBP(PVMCPU pVCpu, uint32_t ebp);
1161	VMMDECL(int) CPUMSetGuestCS(PVMCPU pVCpu, uint16_t cs);
1162	VMMDECL(int) CPUMSetGuestDS(PVMCPU pVCpu, uint16_t ds);
1163	VMMDECL(int) CPUMSetGuestES(PVMCPU pVCpu, uint16_t es);
1164	VMMDECL(int) CPUMSetGuestFS(PVMCPU pVCpu, uint16_t fs);
1165	VMMDECL(int) CPUMSetGuestGS(PVMCPU pVCpu, uint16_t gs);
1166	VMMDECL(int) CPUMSetGuestSS(PVMCPU pVCpu, uint16_t ss);
1167	VMMDECL(void) CPUMSetGuestEFER(PVMCPU pVCpu, uint64_t val);
1168	VMMR3_INT_DECL(void) CPUMR3SetGuestCpuIdFeature(PVM pVM, CPUMCPUIDFEATURE enmFeature);
1169	VMMR3_INT_DECL(void) CPUMR3ClearGuestCpuIdFeature(PVM pVM, CPUMCPUIDFEATURE enmFeature);
1170	VMMR3_INT_DECL(bool) CPUMR3GetGuestCpuIdFeature(PVM pVM, CPUMCPUIDFEATURE enmFeature);
1171	VMMDECL(bool) CPUMSetGuestCpuIdPerCpuApicFeature(PVMCPU pVCpu, bool fVisible);
1172	VMMDECL(void) CPUMSetGuestCtx(PVMCPU pVCpu, const PCPUMCTX pCtx);
1173	VMM_INT_DECL(void) CPUMGuestLazyLoadHiddenCsAndSs(PVMCPU pVCpu);
1174	VMM_INT_DECL(void) CPUMGuestLazyLoadHiddenSelectorReg(PVMCPU pVCpu, PCPUMSELREG pSReg);
1175	VMMR0_INT_DECL(void) CPUMR0SetGuestTscAux(PVMCPU pVCpu, uint64_t uValue);
1176	VMMR0_INT_DECL(uint64_t) CPUMR0GetGuestTscAux(PVMCPU pVCpu);
1177	/** @} */
1178
1179
1180	/** @name Misc Guest Predicate Functions.
1181	* @{ */
1182	VMMDECL(bool) CPUMIsGuestIn16BitCode(PVMCPU pVCpu);
1183	VMMDECL(bool) CPUMIsGuestIn32BitCode(PVMCPU pVCpu);
1184	VMMDECL(bool) CPUMIsGuestIn64BitCode(PVMCPU pVCpu);
1185	VMMDECL(bool) CPUMIsGuestNXEnabled(PVMCPU pVCpu);
1186	VMMDECL(bool) CPUMIsGuestPageSizeExtEnabled(PVMCPU pVCpu);
1187	VMMDECL(bool) CPUMIsGuestPagingEnabled(PVMCPU pVCpu);
1188	VMMDECL(bool) CPUMIsGuestR0WriteProtEnabled(PVMCPU pVCpu);
1189	VMMDECL(bool) CPUMIsGuestInRealMode(PVMCPU pVCpu);
1190	VMMDECL(bool) CPUMIsGuestInRealOrV86Mode(PVMCPU pVCpu);
1191	VMMDECL(bool) CPUMIsGuestInProtectedMode(PVMCPU pVCpu);
1192	VMMDECL(bool) CPUMIsGuestInPagedProtectedMode(PVMCPU pVCpu);
1193	VMMDECL(bool) CPUMIsGuestInLongMode(PVMCPU pVCpu);
1194	VMMDECL(bool) CPUMIsGuestInPAEMode(PVMCPU pVCpu);
1195	VMM_INT_DECL(bool) CPUMIsGuestInRawMode(PVMCPU pVCpu);
1196	/** @} */
1197
1198	/** @name Nested Hardware-Virtualization Helpers.
1199	* @{ */
1200	VMM_INT_DECL(bool) CPUMCanSvmNstGstTakePhysIntr(PCCPUMCTX pCtx);
1201	VMM_INT_DECL(bool) CPUMCanSvmNstGstTakeVirtIntr(PCCPUMCTX pCtx);
1202	VMM_INT_DECL(uint8_t) CPUMGetSvmNstGstInterrupt(PCCPUMCTX pCtx);
1203	/** @} */
1204
1205	#ifndef VBOX_WITHOUT_UNNAMED_UNIONS
1206
1207	/**
1208	* Tests if the guest is running in real mode or not.
1209	*
1210	* @returns true if in real mode, otherwise false.
1211	* @param pCtx Current CPU context.
1212	*/
1213	DECLINLINE(bool) CPUMIsGuestInRealModeEx(PCPUMCTX pCtx)
1214	{
1215	return !(pCtx->cr0 & X86_CR0_PE);
1216	}
1217
1218	/**
1219	* Tests if the guest is running in real or virtual 8086 mode.
1220	*
1221	* @returns @c true if it is, @c false if not.
1222	* @param pCtx Current CPU context.
1223	*/
1224	DECLINLINE(bool) CPUMIsGuestInRealOrV86ModeEx(PCPUMCTX pCtx)
1225	{
1226	return !(pCtx->cr0 & X86_CR0_PE)
1227	\|\| pCtx->eflags.Bits.u1VM; /* Cannot be set in long mode. Intel spec 2.3.1 "System Flags and Fields in IA-32e Mode". */
1228	}
1229
1230	/**
1231	* Tests if the guest is running in virtual 8086 mode.
1232	*
1233	* @returns @c true if it is, @c false if not.
1234	* @param pCtx Current CPU context.
1235	*/
1236	DECLINLINE(bool) CPUMIsGuestInV86ModeEx(PCPUMCTX pCtx)
1237	{
1238	return (pCtx->eflags.Bits.u1VM == 1);
1239	}
1240
1241	/**
1242	* Tests if the guest is running in paged protected or not.
1243	*
1244	* @returns true if in paged protected mode, otherwise false.
1245	* @param pCtx Current CPU context.
1246	*/
1247	DECLINLINE(bool) CPUMIsGuestInPagedProtectedModeEx(PCPUMCTX pCtx)
1248	{
1249	return (pCtx->cr0 & (X86_CR0_PE \| X86_CR0_PG)) == (X86_CR0_PE \| X86_CR0_PG);
1250	}
1251
1252	/**
1253	* Tests if the guest is running in long mode or not.
1254	*
1255	* @returns true if in long mode, otherwise false.
1256	* @param pCtx Current CPU context.
1257	*/
1258	DECLINLINE(bool) CPUMIsGuestInLongModeEx(PCPUMCTX pCtx)
1259	{
1260	return (pCtx->msrEFER & MSR_K6_EFER_LMA) == MSR_K6_EFER_LMA;
1261	}
1262
1263	VMM_INT_DECL(bool) CPUMIsGuestIn64BitCodeSlow(PCPUMCTX pCtx);
1264
1265	/**
1266	* Tests if the guest is running in 64 bits mode or not.
1267	*
1268	* @returns true if in 64 bits protected mode, otherwise false.
1269	* @param pCtx Current CPU context.
1270	*/
1271	DECLINLINE(bool) CPUMIsGuestIn64BitCodeEx(PCPUMCTX pCtx)
1272	{
1273	if (!(pCtx->msrEFER & MSR_K6_EFER_LMA))
1274	return false;
1275	if (!CPUMSELREG_ARE_HIDDEN_PARTS_VALID(NULL, &pCtx->cs))
1276	return CPUMIsGuestIn64BitCodeSlow(pCtx);
1277	return pCtx->cs.Attr.n.u1Long;
1278	}
1279
1280	/**
1281	* Tests if the guest has paging enabled or not.
1282	*
1283	* @returns true if paging is enabled, otherwise false.
1284	* @param pCtx Current CPU context.
1285	*/
1286	DECLINLINE(bool) CPUMIsGuestPagingEnabledEx(PCPUMCTX pCtx)
1287	{
1288	return !!(pCtx->cr0 & X86_CR0_PG);
1289	}
1290
1291	/**
1292	* Tests if the guest is running in PAE mode or not.
1293	*
1294	* @returns true if in PAE mode, otherwise false.
1295	* @param pCtx Current CPU context.
1296	*/
1297	DECLINLINE(bool) CPUMIsGuestInPAEModeEx(PCPUMCTX pCtx)
1298	{
1299	/* Intel mentions EFER.LMA and EFER.LME in different parts of their spec. We shall use EFER.LMA rather
1300	than EFER.LME as it reflects if the CPU has entered paging with EFER.LME set. */
1301	return ( (pCtx->cr4 & X86_CR4_PAE)
1302	&& CPUMIsGuestPagingEnabledEx(pCtx)
1303	&& !(pCtx->msrEFER & MSR_K6_EFER_LMA));
1304	}
1305
1306	/**
1307	* Tests is if the guest has AMD SVM enabled or not.
1308	*
1309	* @returns true if SMV is enabled, otherwise false.
1310	* @param pCtx Current CPU context.
1311	*/
1312	DECLINLINE(bool) CPUMIsGuestSvmEnabled(PCCPUMCTX pCtx)
1313	{
1314	return RT_BOOL(pCtx->msrEFER & MSR_K6_EFER_SVME);
1315	}
1316
1317	#ifndef IN_RC
1318	/**
1319	* Checks if the guest VMCB has the specified ctrl/instruction intercept active.
1320	*
1321	* @returns @c true if in intercept is set, @c false otherwise.
1322	* @param pCtx Pointer to the context.
1323	* @param fIntercept The SVM control/instruction intercept,
1324	* see SVM_CTRL_INTERCEPT_*.
1325	*/
1326	DECLINLINE(bool) CPUMIsGuestSvmCtrlInterceptSet(PCCPUMCTX pCtx, uint64_t fIntercept)
1327	{
1328	PCSVMVMCB pVmcb = pCtx->hwvirt.svm.CTX_SUFF(pVmcb);
1329	return pVmcb && (pVmcb->ctrl.u64InterceptCtrl & fIntercept);
1330	}
1331
1332	/**
1333	* Checks if the guest VMCB has the specified CR read intercept
1334	* active.
1335	*
1336	* @returns @c true if in intercept is set, @c false otherwise.
1337	* @param pCtx Pointer to the context.
1338	* @param uCr The CR register number (0 to 15).
1339	*/
1340	DECLINLINE(bool) CPUMIsGuestSvmReadCRxInterceptSet(PCCPUMCTX pCtx, uint8_t uCr)
1341	{
1342	PCSVMVMCB pVmcb = pCtx->hwvirt.svm.CTX_SUFF(pVmcb);
1343	return pVmcb && (pVmcb->ctrl.u16InterceptRdCRx & (1 << uCr));
1344	}
1345
1346	/**
1347	* Checks if the guest VMCB has the specified CR write intercept
1348	* active.
1349	*
1350	* @returns @c true if in intercept is set, @c false otherwise.
1351	* @param pCtx Pointer to the context.
1352	* @param uCr The CR register number (0 to 15).
1353	*/
1354	DECLINLINE(bool) CPUMIsGuestSvmWriteCRxInterceptSet(PCCPUMCTX pCtx, uint8_t uCr)
1355	{
1356	PCSVMVMCB pVmcb = pCtx->hwvirt.svm.CTX_SUFF(pVmcb);
1357	return pVmcb && (pVmcb->ctrl.u16InterceptWrCRx & (1 << uCr));
1358	}
1359
1360	/**
1361	* Checks if the guest VMCB has the specified DR read intercept
1362	* active.
1363	*
1364	* @returns @c true if in intercept is set, @c false otherwise.
1365	* @param pCtx Pointer to the context.
1366	* @param uDr The DR register number (0 to 15).
1367	*/
1368	DECLINLINE(bool) CPUMIsGuestSvmReadDRxInterceptSet(PCCPUMCTX pCtx, uint8_t uDr)
1369	{
1370	PCSVMVMCB pVmcb = pCtx->hwvirt.svm.CTX_SUFF(pVmcb);
1371	return pVmcb && (pVmcb->ctrl.u16InterceptRdDRx & (1 << uDr));
1372	}
1373
1374	/**
1375	* Checks if the guest VMCB has the specified DR write intercept
1376	* active.
1377	*
1378	* @returns @c true if in intercept is set, @c false otherwise.
1379	* @param pCtx Pointer to the context.
1380	* @param uDr The DR register number (0 to 15).
1381	*/
1382	DECLINLINE(bool) CPUMIsGuestSvmWriteDRxInterceptSet(PCCPUMCTX pCtx, uint8_t uDr)
1383	{
1384	PCSVMVMCB pVmcb = pCtx->hwvirt.svm.CTX_SUFF(pVmcb);
1385	return pVmcb && (pVmcb->ctrl.u16InterceptWrDRx & (1 << uDr));
1386	}
1387
1388	/**
1389	* Checks if the guest VMCB has the specified exception
1390	* intercept active.
1391	*
1392	* @returns true if in intercept is active, false otherwise.
1393	* @param pCtx Pointer to the context.
1394	* @param uVector The exception / interrupt vector.
1395	*/
1396	DECLINLINE(bool) CPUMIsGuestSvmXcptInterceptSet(PCCPUMCTX pCtx, uint8_t uVector)
1397	{
1398	Assert(uVector < 32);
1399	PCSVMVMCB pVmcb = pCtx->hwvirt.svm.CTX_SUFF(pVmcb);
1400	return pVmcb && (pVmcb->ctrl.u32InterceptXcpt & (UINT32_C(1) << uVector));
1401	}
1402	#endif /* !IN_RC */
1403
1404	/**
1405	* Checks if we are executing inside an SVM nested hardware-virtualized guest.
1406	*
1407	* @returns true if in SVM nested-guest mode, false otherwise.
1408	* @param pCtx Pointer to the context.
1409	*/
1410	DECLINLINE(bool) CPUMIsGuestInSvmNestedHwVirtMode(PCCPUMCTX pCtx)
1411	{
1412	/*
1413	* With AMD-V, the VMRUN intercept is a pre-requisite to entering SVM guest-mode.
1414	* See AMD spec. 15.5 "VMRUN instruction" subsection "Canonicalization and Consistency Checks".
1415	*/
1416	#ifndef IN_RC
1417	PCSVMVMCB pVmcb = pCtx->hwvirt.svm.CTX_SUFF(pVmcb);
1418	return pVmcb && (pVmcb->ctrl.u64InterceptCtrl & SVM_CTRL_INTERCEPT_VMRUN);
1419	#else
1420	RT_NOREF(pCtx);
1421	return false;
1422	#endif
1423	}
1424
1425	/**
1426	* Checks if we are executing inside a VMX nested hardware-virtualized guest.
1427	*
1428	* @returns true if in VMX nested-guest mode, false otherwise.
1429	* @param pCtx Pointer to the context.
1430	*/
1431	DECLINLINE(bool) CPUMIsGuestInVmxNestedHwVirtMode(PCCPUMCTX pCtx)
1432	{
1433	/** @todo Intel. */
1434	RT_NOREF(pCtx);
1435	return false;
1436	}
1437
1438	/**
1439	* Checks if we are executing inside a nested hardware-virtualized guest.
1440	*
1441	* @returns true if in SVM/VMX nested-guest mode, false otherwise.
1442	* @param pCtx Pointer to the context.
1443	*/
1444	DECLINLINE(bool) CPUMIsGuestInNestedHwVirtMode(PCCPUMCTX pCtx)
1445	{
1446	return CPUMIsGuestInSvmNestedHwVirtMode(pCtx) \|\| CPUMIsGuestInVmxNestedHwVirtMode(pCtx);
1447	}
1448	#endif /* VBOX_WITHOUT_UNNAMED_UNIONS */
1449
1450	/** @} */
1451
1452
1453	/** @name Hypervisor Register Getters.
1454	* @{ */
1455	VMMDECL(RTSEL) CPUMGetHyperCS(PVMCPU pVCpu);
1456	VMMDECL(RTSEL) CPUMGetHyperDS(PVMCPU pVCpu);
1457	VMMDECL(RTSEL) CPUMGetHyperES(PVMCPU pVCpu);
1458	VMMDECL(RTSEL) CPUMGetHyperFS(PVMCPU pVCpu);
1459	VMMDECL(RTSEL) CPUMGetHyperGS(PVMCPU pVCpu);
1460	VMMDECL(RTSEL) CPUMGetHyperSS(PVMCPU pVCpu);
1461	#if 0 /* these are not correct. */
1462	VMMDECL(uint32_t) CPUMGetHyperCR0(PVMCPU pVCpu);
1463	VMMDECL(uint32_t) CPUMGetHyperCR2(PVMCPU pVCpu);
1464	VMMDECL(uint32_t) CPUMGetHyperCR3(PVMCPU pVCpu);
1465	VMMDECL(uint32_t) CPUMGetHyperCR4(PVMCPU pVCpu);
1466	#endif
1467	/** This register is only saved on fatal traps. */
1468	VMMDECL(uint32_t) CPUMGetHyperEAX(PVMCPU pVCpu);
1469	VMMDECL(uint32_t) CPUMGetHyperEBX(PVMCPU pVCpu);
1470	/** This register is only saved on fatal traps. */
1471	VMMDECL(uint32_t) CPUMGetHyperECX(PVMCPU pVCpu);
1472	/** This register is only saved on fatal traps. */
1473	VMMDECL(uint32_t) CPUMGetHyperEDX(PVMCPU pVCpu);
1474	VMMDECL(uint32_t) CPUMGetHyperESI(PVMCPU pVCpu);
1475	VMMDECL(uint32_t) CPUMGetHyperEDI(PVMCPU pVCpu);
1476	VMMDECL(uint32_t) CPUMGetHyperEBP(PVMCPU pVCpu);
1477	VMMDECL(uint32_t) CPUMGetHyperESP(PVMCPU pVCpu);
1478	VMMDECL(uint32_t) CPUMGetHyperEFlags(PVMCPU pVCpu);
1479	VMMDECL(uint32_t) CPUMGetHyperEIP(PVMCPU pVCpu);
1480	VMMDECL(uint64_t) CPUMGetHyperRIP(PVMCPU pVCpu);
1481	VMMDECL(uint32_t) CPUMGetHyperIDTR(PVMCPU pVCpu, uint16_t *pcbLimit);
1482	VMMDECL(uint32_t) CPUMGetHyperGDTR(PVMCPU pVCpu, uint16_t *pcbLimit);
1483	VMMDECL(RTSEL) CPUMGetHyperLDTR(PVMCPU pVCpu);
1484	VMMDECL(RTGCUINTREG) CPUMGetHyperDR0(PVMCPU pVCpu);
1485	VMMDECL(RTGCUINTREG) CPUMGetHyperDR1(PVMCPU pVCpu);
1486	VMMDECL(RTGCUINTREG) CPUMGetHyperDR2(PVMCPU pVCpu);
1487	VMMDECL(RTGCUINTREG) CPUMGetHyperDR3(PVMCPU pVCpu);
1488	VMMDECL(RTGCUINTREG) CPUMGetHyperDR6(PVMCPU pVCpu);
1489	VMMDECL(RTGCUINTREG) CPUMGetHyperDR7(PVMCPU pVCpu);
1490	VMMDECL(void) CPUMGetHyperCtx(PVMCPU pVCpu, PCPUMCTX pCtx);
1491	VMMDECL(uint32_t) CPUMGetHyperCR3(PVMCPU pVCpu);
1492	/** @} */
1493
1494	/** @name Hypervisor Register Setters.
1495	* @{ */
1496	VMMDECL(void) CPUMSetHyperGDTR(PVMCPU pVCpu, uint32_t addr, uint16_t limit);
1497	VMMDECL(void) CPUMSetHyperLDTR(PVMCPU pVCpu, RTSEL SelLDTR);
1498	VMMDECL(void) CPUMSetHyperIDTR(PVMCPU pVCpu, uint32_t addr, uint16_t limit);
1499	VMMDECL(void) CPUMSetHyperCR3(PVMCPU pVCpu, uint32_t cr3);
1500	VMMDECL(void) CPUMSetHyperTR(PVMCPU pVCpu, RTSEL SelTR);
1501	VMMDECL(void) CPUMSetHyperCS(PVMCPU pVCpu, RTSEL SelCS);
1502	VMMDECL(void) CPUMSetHyperDS(PVMCPU pVCpu, RTSEL SelDS);
1503	VMMDECL(void) CPUMSetHyperES(PVMCPU pVCpu, RTSEL SelDS);
1504	VMMDECL(void) CPUMSetHyperFS(PVMCPU pVCpu, RTSEL SelDS);
1505	VMMDECL(void) CPUMSetHyperGS(PVMCPU pVCpu, RTSEL SelDS);
1506	VMMDECL(void) CPUMSetHyperSS(PVMCPU pVCpu, RTSEL SelSS);
1507	VMMDECL(void) CPUMSetHyperESP(PVMCPU pVCpu, uint32_t u32ESP);
1508	VMMDECL(int) CPUMSetHyperEFlags(PVMCPU pVCpu, uint32_t Efl);
1509	VMMDECL(void) CPUMSetHyperEIP(PVMCPU pVCpu, uint32_t u32EIP);
1510	VMM_INT_DECL(void) CPUMSetHyperState(PVMCPU pVCpu, uint32_t u32EIP, uint32_t u32ESP, uint32_t u32EAX, uint32_t u32EDX);
1511	VMMDECL(void) CPUMSetHyperDR0(PVMCPU pVCpu, RTGCUINTREG uDr0);
1512	VMMDECL(void) CPUMSetHyperDR1(PVMCPU pVCpu, RTGCUINTREG uDr1);
1513	VMMDECL(void) CPUMSetHyperDR2(PVMCPU pVCpu, RTGCUINTREG uDr2);
1514	VMMDECL(void) CPUMSetHyperDR3(PVMCPU pVCpu, RTGCUINTREG uDr3);
1515	VMMDECL(void) CPUMSetHyperDR6(PVMCPU pVCpu, RTGCUINTREG uDr6);
1516	VMMDECL(void) CPUMSetHyperDR7(PVMCPU pVCpu, RTGCUINTREG uDr7);
1517	VMMDECL(void) CPUMSetHyperCtx(PVMCPU pVCpu, const PCPUMCTX pCtx);
1518	VMMDECL(int) CPUMRecalcHyperDRx(PVMCPU pVCpu, uint8_t iGstReg, bool fForceHyper);
1519	/** @} */
1520
1521	VMMDECL(void) CPUMPushHyper(PVMCPU pVCpu, uint32_t u32);
1522	VMMDECL(int) CPUMQueryHyperCtxPtr(PVMCPU pVCpu, PCPUMCTX *ppCtx);
1523	VMMDECL(PCPUMCTX) CPUMGetHyperCtxPtr(PVMCPU pVCpu);
1524	VMMDECL(PCCPUMCTXCORE) CPUMGetHyperCtxCore(PVMCPU pVCpu);
1525	VMMDECL(PCPUMCTX) CPUMQueryGuestCtxPtr(PVMCPU pVCpu);
1526	VMMDECL(PCCPUMCTXCORE) CPUMGetGuestCtxCore(PVMCPU pVCpu);
1527	VMM_INT_DECL(int) CPUMRawEnter(PVMCPU pVCpu);
1528	VMM_INT_DECL(int) CPUMRawLeave(PVMCPU pVCpu, int rc);
1529	VMMDECL(uint32_t) CPUMRawGetEFlags(PVMCPU pVCpu);
1530	VMMDECL(void) CPUMRawSetEFlags(PVMCPU pVCpu, uint32_t fEfl);
1531
1532	/** @name Changed flags.
1533	* These flags are used to keep track of which important register that
1534	* have been changed since last they were reset. The only one allowed
1535	* to clear them is REM!
1536	* @{
1537	*/
1538	#define CPUM_CHANGED_FPU_REM RT_BIT(0)
1539	#define CPUM_CHANGED_CR0 RT_BIT(1)
1540	#define CPUM_CHANGED_CR4 RT_BIT(2)
1541	#define CPUM_CHANGED_GLOBAL_TLB_FLUSH RT_BIT(3)
1542	#define CPUM_CHANGED_CR3 RT_BIT(4)
1543	#define CPUM_CHANGED_GDTR RT_BIT(5)
1544	#define CPUM_CHANGED_IDTR RT_BIT(6)
1545	#define CPUM_CHANGED_LDTR RT_BIT(7)
1546	#define CPUM_CHANGED_TR RT_BIT(8) /*@< Currently unused. /
1547	#define CPUM_CHANGED_SYSENTER_MSR RT_BIT(9)
1548	#define CPUM_CHANGED_HIDDEN_SEL_REGS RT_BIT(10) /*@< Currently unused. /
1549	#define CPUM_CHANGED_CPUID RT_BIT(11)
1550	#define CPUM_CHANGED_ALL ( CPUM_CHANGED_FPU_REM \
1551	\| CPUM_CHANGED_CR0 \
1552	\| CPUM_CHANGED_CR4 \
1553	\| CPUM_CHANGED_GLOBAL_TLB_FLUSH \
1554	\| CPUM_CHANGED_CR3 \
1555	\| CPUM_CHANGED_GDTR \
1556	\| CPUM_CHANGED_IDTR \
1557	\| CPUM_CHANGED_LDTR \
1558	\| CPUM_CHANGED_TR \
1559	\| CPUM_CHANGED_SYSENTER_MSR \
1560	\| CPUM_CHANGED_HIDDEN_SEL_REGS \
1561	\| CPUM_CHANGED_CPUID )
1562	/** @} */
1563
1564	VMMDECL(void) CPUMSetChangedFlags(PVMCPU pVCpu, uint32_t fChangedAdd);
1565	VMMR3DECL(uint32_t) CPUMR3RemEnter(PVMCPU pVCpu, uint32_t *puCpl);
1566	VMMR3DECL(void) CPUMR3RemLeave(PVMCPU pVCpu, bool fNoOutOfSyncSels);
1567	VMMDECL(bool) CPUMSupportsXSave(PVM pVM);
1568	VMMDECL(bool) CPUMIsHostUsingSysEnter(PVM pVM);
1569	VMMDECL(bool) CPUMIsHostUsingSysCall(PVM pVM);
1570	VMMDECL(bool) CPUMIsGuestFPUStateActive(PVMCPU pVCpu);
1571	VMMDECL(bool) CPUMIsGuestFPUStateLoaded(PVMCPU pVCpu);
1572	VMMDECL(bool) CPUMIsHostFPUStateSaved(PVMCPU pVCpu);
1573	VMMDECL(bool) CPUMIsGuestDebugStateActive(PVMCPU pVCpu);
1574	VMMDECL(bool) CPUMIsGuestDebugStateActivePending(PVMCPU pVCpu);
1575	VMMDECL(void) CPUMDeactivateGuestDebugState(PVMCPU pVCpu);
1576	VMMDECL(bool) CPUMIsHyperDebugStateActive(PVMCPU pVCpu);
1577	VMMDECL(bool) CPUMIsHyperDebugStateActivePending(PVMCPU pVCpu);
1578	VMMDECL(uint32_t) CPUMGetGuestCPL(PVMCPU pVCpu);
1579	VMMDECL(CPUMMODE) CPUMGetGuestMode(PVMCPU pVCpu);
1580	VMMDECL(uint32_t) CPUMGetGuestCodeBits(PVMCPU pVCpu);
1581	VMMDECL(DISCPUMODE) CPUMGetGuestDisMode(PVMCPU pVCpu);
1582	VMMDECL(uint32_t) CPUMGetGuestMxCsrMask(PVM pVM);
1583	VMMDECL(uint64_t) CPUMGetGuestScalableBusFrequency(PVM pVM);
1584	VMMDECL(int) CPUMQueryValidatedGuestEfer(PVM pVM, uint64_t uCr0, uint64_t uOldEfer, uint64_t uNewEfer,
1585	uint64_t *puValidEfer);
1586
1587	/** @name Typical scalable bus frequency values.
1588	* @{ */
1589	/** Special internal value indicating that we don't know the frequency.
1590	* @internal */
1591	#define CPUM_SBUSFREQ_UNKNOWN UINT64_C(1)
1592	#define CPUM_SBUSFREQ_100MHZ UINT64_C(100000000)
1593	#define CPUM_SBUSFREQ_133MHZ UINT64_C(133333333)
1594	#define CPUM_SBUSFREQ_167MHZ UINT64_C(166666666)
1595	#define CPUM_SBUSFREQ_200MHZ UINT64_C(200000000)
1596	#define CPUM_SBUSFREQ_267MHZ UINT64_C(266666666)
1597	#define CPUM_SBUSFREQ_333MHZ UINT64_C(333333333)
1598	#define CPUM_SBUSFREQ_400MHZ UINT64_C(400000000)
1599	/** @} */
1600
1601
1602	#ifdef IN_RING3
1603	/** @defgroup grp_cpum_r3 The CPUM ring-3 API
1604	* @{
1605	*/
1606
1607	VMMR3DECL(int) CPUMR3Init(PVM pVM);
1608	VMMR3DECL(int) CPUMR3InitCompleted(PVM pVM, VMINITCOMPLETED enmWhat);
1609	VMMR3DECL(void) CPUMR3LogCpuIds(PVM pVM);
1610	VMMR3DECL(void) CPUMR3Relocate(PVM pVM);
1611	VMMR3DECL(int) CPUMR3Term(PVM pVM);
1612	VMMR3DECL(void) CPUMR3Reset(PVM pVM);
1613	VMMR3DECL(void) CPUMR3ResetCpu(PVM pVM, PVMCPU pVCpu);
1614	VMMDECL(bool) CPUMR3IsStateRestorePending(PVM pVM);
1615	VMMR3DECL(void) CPUMR3SetHWVirtEx(PVM pVM, bool fHWVirtExEnabled);
1616	VMMR3DECL(int) CPUMR3SetCR4Feature(PVM pVM, RTHCUINTREG fOr, RTHCUINTREG fAnd);
1617
1618	VMMR3DECL(int) CPUMR3CpuIdInsert(PVM pVM, PCPUMCPUIDLEAF pNewLeaf);
1619	VMMR3DECL(int) CPUMR3CpuIdGetLeaf(PVM pVM, PCPUMCPUIDLEAF pLeaf, uint32_t uLeaf, uint32_t uSubLeaf);
1620	VMMR3DECL(CPUMMICROARCH) CPUMR3CpuIdDetermineMicroarchEx(CPUMCPUVENDOR enmVendor, uint8_t bFamily,
1621	uint8_t bModel, uint8_t bStepping);
1622	VMMR3DECL(const char *) CPUMR3MicroarchName(CPUMMICROARCH enmMicroarch);
1623	VMMR3DECL(int) CPUMR3CpuIdCollectLeaves(PCPUMCPUIDLEAF ppaLeaves, uint32_t pcLeaves);
1624	VMMR3DECL(int) CPUMR3CpuIdDetectUnknownLeafMethod(PCPUMUNKNOWNCPUID penmUnknownMethod, PCPUMCPUID pDefUnknown);
1625	VMMR3DECL(const char *) CPUMR3CpuIdUnknownLeafMethodName(CPUMUNKNOWNCPUID enmUnknownMethod);
1626	VMMR3DECL(CPUMCPUVENDOR) CPUMR3CpuIdDetectVendorEx(uint32_t uEAX, uint32_t uEBX, uint32_t uECX, uint32_t uEDX);
1627	VMMR3DECL(const char *) CPUMR3CpuVendorName(CPUMCPUVENDOR enmVendor);
1628	VMMR3DECL(uint32_t) CPUMR3DeterminHostMxCsrMask(void);
1629
1630	VMMR3DECL(int) CPUMR3MsrRangesInsert(PVM pVM, PCCPUMMSRRANGE pNewRange);
1631
1632	# if defined(VBOX_WITH_RAW_MODE) \|\| defined(DOXYGEN_RUNNING)
1633	/** @name APIs for the CPUID raw-mode patch (legacy).
1634	* @{ */
1635	VMMR3_INT_DECL(RCPTRTYPE(PCCPUMCPUID)) CPUMR3GetGuestCpuIdPatmDefRCPtr(PVM pVM);
1636	VMMR3_INT_DECL(uint32_t) CPUMR3GetGuestCpuIdPatmStdMax(PVM pVM);
1637	VMMR3_INT_DECL(uint32_t) CPUMR3GetGuestCpuIdPatmExtMax(PVM pVM);
1638	VMMR3_INT_DECL(uint32_t) CPUMR3GetGuestCpuIdPatmCentaurMax(PVM pVM);
1639	VMMR3_INT_DECL(RCPTRTYPE(PCCPUMCPUID)) CPUMR3GetGuestCpuIdPatmStdRCPtr(PVM pVM);
1640	VMMR3_INT_DECL(RCPTRTYPE(PCCPUMCPUID)) CPUMR3GetGuestCpuIdPatmExtRCPtr(PVM pVM);
1641	VMMR3_INT_DECL(RCPTRTYPE(PCCPUMCPUID)) CPUMR3GetGuestCpuIdPatmCentaurRCPtr(PVM pVM);
1642	/** @} */
1643	# endif
1644
1645	/** @} */
1646	#endif /* IN_RING3 */
1647
1648	#ifdef IN_RC
1649	/** @defgroup grp_cpum_rc The CPUM Raw-mode Context API
1650	* @{
1651	*/
1652
1653	/**
1654	* Calls a guest trap/interrupt handler directly
1655	*
1656	* Assumes a trap stack frame has already been setup on the guest's stack!
1657	* This function does not return!
1658	*
1659	* @param pRegFrame Original trap/interrupt context
1660	* @param selCS Code selector of handler
1661	* @param pHandler GC virtual address of handler
1662	* @param eflags Callee's EFLAGS
1663	* @param selSS Stack selector for handler
1664	* @param pEsp Stack address for handler
1665	*/
1666	DECLASM(void) CPUMGCCallGuestTrapHandler(PCPUMCTXCORE pRegFrame, uint32_t selCS, RTRCPTR pHandler,
1667	uint32_t eflags, uint32_t selSS, RTRCPTR pEsp);
1668
1669	/**
1670	* Call guest V86 code directly.
1671	*
1672	* This function does not return!
1673	*
1674	* @param pRegFrame Original trap/interrupt context
1675	*/
1676	DECLASM(void) CPUMGCCallV86Code(PCPUMCTXCORE pRegFrame);
1677
1678	VMMDECL(int) CPUMHandleLazyFPU(PVMCPU pVCpu);
1679	VMMDECL(uint32_t) CPUMRCGetGuestCPL(PVMCPU pVCpu, PCPUMCTXCORE pRegFrame);
1680	#ifdef VBOX_WITH_RAW_RING1
1681	VMMDECL(void) CPUMRCRecheckRawState(PVMCPU pVCpu, PCPUMCTXCORE pCtxCore);
1682	#endif
1683	VMMRCDECL(void) CPUMRCProcessForceFlag(PVMCPU pVCpu);
1684
1685	/** @} */
1686	#endif /* IN_RC */
1687
1688	#ifdef IN_RING0
1689	/** @defgroup grp_cpum_r0 The CPUM ring-0 API
1690	* @{
1691	*/
1692	VMMR0_INT_DECL(int) CPUMR0ModuleInit(void);
1693	VMMR0_INT_DECL(int) CPUMR0ModuleTerm(void);
1694	VMMR0_INT_DECL(int) CPUMR0InitVM(PVM pVM);
1695	DECLASM(void) CPUMR0RegisterVCpuThread(PVMCPU pVCpu);
1696	DECLASM(void) CPUMR0TouchHostFpu(void);
1697	VMMR0_INT_DECL(int) CPUMR0Trap07Handler(PVM pVM, PVMCPU pVCpu);
1698	VMMR0_INT_DECL(int) CPUMR0LoadGuestFPU(PVM pVM, PVMCPU pVCpu);
1699	VMMR0_INT_DECL(bool) CPUMR0FpuStateMaybeSaveGuestAndRestoreHost(PVMCPU pVCpu);
1700	VMMR0_INT_DECL(int) CPUMR0SaveHostDebugState(PVM pVM, PVMCPU pVCpu);
1701	VMMR0_INT_DECL(bool) CPUMR0DebugStateMaybeSaveGuestAndRestoreHost(PVMCPU pVCpu, bool fDr6);
1702	VMMR0_INT_DECL(bool) CPUMR0DebugStateMaybeSaveGuest(PVMCPU pVCpu, bool fDr6);
1703
1704	VMMR0_INT_DECL(void) CPUMR0LoadGuestDebugState(PVMCPU pVCpu, bool fDr6);
1705	VMMR0_INT_DECL(void) CPUMR0LoadHyperDebugState(PVMCPU pVCpu, bool fDr6);
1706	#ifdef VBOX_WITH_VMMR0_DISABLE_LAPIC_NMI
1707	VMMR0_INT_DECL(void) CPUMR0SetLApic(PVMCPU pVCpu, uint32_t iHostCpuSet);
1708	#endif
1709
1710	/** @} */
1711	#endif /* IN_RING0 */
1712
1713	/** @defgroup grp_cpum_rz The CPUM raw-mode and ring-0 context API
1714	* @{
1715	*/
1716	VMMRZ_INT_DECL(void) CPUMRZFpuStatePrepareHostCpuForUse(PVMCPU pVCpu);
1717	VMMRZ_INT_DECL(void) CPUMRZFpuStateActualizeForRead(PVMCPU pVCpu);
1718	VMMRZ_INT_DECL(void) CPUMRZFpuStateActualizeForChange(PVMCPU pVCpu);
1719	VMMRZ_INT_DECL(void) CPUMRZFpuStateActualizeSseForRead(PVMCPU pVCpu);
1720	VMMRZ_INT_DECL(void) CPUMRZFpuStateActualizeAvxForRead(PVMCPU pVCpu);
1721	/** @} */
1722
1723
1724	#endif /* !VBOX_FOR_DTRACE_LIB */
1725	/** @} */
1726	RT_C_DECLS_END
1727
1728
1729	#endif
1730

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

source: vbox/trunk/include/VBox/vmm/cpum.h@ 67989

Download in other formats: