vmcs.h revision 262352
1/*-
2 * Copyright (c) 2011 NetApp, Inc.
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED.  IN NO EVENT SHALL NETAPP, INC OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 * $FreeBSD: stable/10/sys/amd64/vmm/intel/vmcs.h 262352 2014-02-23 01:34:40Z jhb $
27 */
28
29#ifndef _VMCS_H_
30#define	_VMCS_H_
31
32#ifdef _KERNEL
33struct vmcs {
34	uint32_t	identifier;
35	uint32_t	abort_code;
36	char		_impl_specific[PAGE_SIZE - sizeof(uint32_t) * 2];
37};
38CTASSERT(sizeof(struct vmcs) == PAGE_SIZE);
39
40/* MSR save region is composed of an array of 'struct msr_entry' */
41struct msr_entry {
42	uint32_t	index;
43	uint32_t	reserved;
44	uint64_t	val;
45
46};
47
48int vmcs_set_msr_save(struct vmcs *vmcs, u_long g_area, u_int g_count);
49int	vmcs_set_defaults(struct vmcs *vmcs, u_long host_rip, u_long host_rsp,
50			  uint64_t eptp,
51			  uint32_t pinbased_ctls, uint32_t procbased_ctls,
52			  uint32_t procbased_ctls2, uint32_t exit_ctls,
53			  uint32_t entry_ctls, u_long msr_bitmap,
54			  uint16_t vpid);
55int	vmcs_getreg(struct vmcs *vmcs, int running, int ident, uint64_t *rv);
56int	vmcs_setreg(struct vmcs *vmcs, int running, int ident, uint64_t val);
57int	vmcs_getdesc(struct vmcs *vmcs, int ident,
58		     struct seg_desc *desc);
59int	vmcs_setdesc(struct vmcs *vmcs, int ident,
60		     struct seg_desc *desc);
61
62static __inline uint64_t
63vmcs_read(uint32_t encoding)
64{
65	int error;
66	uint64_t val;
67
68	error = vmread(encoding, &val);
69	KASSERT(error == 0, ("vmcs_read(%u) error %d", encoding, error));
70	return (val);
71}
72
73static __inline void
74vmcs_write(uint32_t encoding, uint64_t val)
75{
76	int error;
77
78	error = vmwrite(encoding, val);
79	KASSERT(error == 0, ("vmcs_write(%u) error %d", encoding, error));
80}
81
82#define	vmexit_instruction_length()	vmcs_read(VMCS_EXIT_INSTRUCTION_LENGTH)
83#define	vmcs_guest_rip()		vmcs_read(VMCS_GUEST_RIP)
84#define	vmcs_instruction_error()	vmcs_read(VMCS_INSTRUCTION_ERROR)
85#define	vmcs_exit_reason()		(vmcs_read(VMCS_EXIT_REASON) & 0xffff)
86#define	vmcs_exit_qualification()	vmcs_read(VMCS_EXIT_QUALIFICATION)
87#define	vmcs_guest_cr3()		vmcs_read(VMCS_GUEST_CR3)
88#define	vmcs_gpa()			vmcs_read(VMCS_GUEST_PHYSICAL_ADDRESS)
89#define	vmcs_gla()			vmcs_read(VMCS_GUEST_LINEAR_ADDRESS)
90#define	vmcs_idt_vectoring_info()	vmcs_read(VMCS_IDT_VECTORING_INFO)
91#define	vmcs_idt_vectoring_err()	vmcs_read(VMCS_IDT_VECTORING_ERROR)
92
93#endif	/* _KERNEL */
94
95#define	VMCS_INITIAL			0xffffffffffffffff
96
97#define	VMCS_IDENT(encoding)		((encoding) | 0x80000000)
98/*
99 * VMCS field encodings from Appendix H, Intel Architecture Manual Vol3B.
100 */
101#define	VMCS_INVALID_ENCODING		0xffffffff
102
103/* 16-bit control fields */
104#define	VMCS_VPID			0x00000000
105
106/* 16-bit guest-state fields */
107#define	VMCS_GUEST_ES_SELECTOR		0x00000800
108#define	VMCS_GUEST_CS_SELECTOR		0x00000802
109#define	VMCS_GUEST_SS_SELECTOR		0x00000804
110#define	VMCS_GUEST_DS_SELECTOR		0x00000806
111#define	VMCS_GUEST_FS_SELECTOR		0x00000808
112#define	VMCS_GUEST_GS_SELECTOR		0x0000080A
113#define	VMCS_GUEST_LDTR_SELECTOR	0x0000080C
114#define	VMCS_GUEST_TR_SELECTOR		0x0000080E
115
116/* 16-bit host-state fields */
117#define	VMCS_HOST_ES_SELECTOR		0x00000C00
118#define	VMCS_HOST_CS_SELECTOR		0x00000C02
119#define	VMCS_HOST_SS_SELECTOR		0x00000C04
120#define	VMCS_HOST_DS_SELECTOR		0x00000C06
121#define	VMCS_HOST_FS_SELECTOR		0x00000C08
122#define	VMCS_HOST_GS_SELECTOR		0x00000C0A
123#define	VMCS_HOST_TR_SELECTOR		0x00000C0C
124
125/* 64-bit control fields */
126#define	VMCS_IO_BITMAP_A		0x00002000
127#define	VMCS_IO_BITMAP_B		0x00002002
128#define	VMCS_MSR_BITMAP			0x00002004
129#define	VMCS_EXIT_MSR_STORE		0x00002006
130#define	VMCS_EXIT_MSR_LOAD		0x00002008
131#define	VMCS_ENTRY_MSR_LOAD		0x0000200A
132#define	VMCS_EXECUTIVE_VMCS		0x0000200C
133#define	VMCS_TSC_OFFSET			0x00002010
134#define	VMCS_VIRTUAL_APIC		0x00002012
135#define	VMCS_APIC_ACCESS		0x00002014
136#define	VMCS_EPTP			0x0000201A
137
138/* 64-bit read-only fields */
139#define	VMCS_GUEST_PHYSICAL_ADDRESS	0x00002400
140
141/* 64-bit guest-state fields */
142#define	VMCS_LINK_POINTER		0x00002800
143#define	VMCS_GUEST_IA32_DEBUGCTL	0x00002802
144#define	VMCS_GUEST_IA32_PAT		0x00002804
145#define	VMCS_GUEST_IA32_EFER		0x00002806
146#define	VMCS_GUEST_IA32_PERF_GLOBAL_CTRL 0x00002808
147#define	VMCS_GUEST_PDPTE0		0x0000280A
148#define	VMCS_GUEST_PDPTE1		0x0000280C
149#define	VMCS_GUEST_PDPTE2		0x0000280E
150#define	VMCS_GUEST_PDPTE3		0x00002810
151
152/* 64-bit host-state fields */
153#define	VMCS_HOST_IA32_PAT		0x00002C00
154#define	VMCS_HOST_IA32_EFER		0x00002C02
155#define	VMCS_HOST_IA32_PERF_GLOBAL_CTRL	0x00002C04
156
157/* 32-bit control fields */
158#define	VMCS_PIN_BASED_CTLS		0x00004000
159#define	VMCS_PRI_PROC_BASED_CTLS	0x00004002
160#define	VMCS_EXCEPTION_BITMAP		0x00004004
161#define	VMCS_PF_ERROR_MASK		0x00004006
162#define	VMCS_PF_ERROR_MATCH		0x00004008
163#define	VMCS_CR3_TARGET_COUNT		0x0000400A
164#define	VMCS_EXIT_CTLS			0x0000400C
165#define	VMCS_EXIT_MSR_STORE_COUNT	0x0000400E
166#define	VMCS_EXIT_MSR_LOAD_COUNT	0x00004010
167#define	VMCS_ENTRY_CTLS			0x00004012
168#define	VMCS_ENTRY_MSR_LOAD_COUNT	0x00004014
169#define	VMCS_ENTRY_INTR_INFO		0x00004016
170#define	VMCS_ENTRY_EXCEPTION_ERROR	0x00004018
171#define	VMCS_ENTRY_INST_LENGTH		0x0000401A
172#define	VMCS_TPR_THRESHOLD		0x0000401C
173#define	VMCS_SEC_PROC_BASED_CTLS	0x0000401E
174#define	VMCS_PLE_GAP			0x00004020
175#define	VMCS_PLE_WINDOW			0x00004022
176
177/* 32-bit read-only data fields */
178#define	VMCS_INSTRUCTION_ERROR		0x00004400
179#define	VMCS_EXIT_REASON		0x00004402
180#define	VMCS_EXIT_INTERRUPTION_INFO	0x00004404
181#define	VMCS_EXIT_INTERRUPTION_ERROR	0x00004406
182#define	VMCS_IDT_VECTORING_INFO		0x00004408
183#define	VMCS_IDT_VECTORING_ERROR	0x0000440A
184#define	VMCS_EXIT_INSTRUCTION_LENGTH	0x0000440C
185#define	VMCS_EXIT_INSTRUCTION_INFO	0x0000440E
186
187/* 32-bit guest-state fields */
188#define	VMCS_GUEST_ES_LIMIT		0x00004800
189#define	VMCS_GUEST_CS_LIMIT		0x00004802
190#define	VMCS_GUEST_SS_LIMIT		0x00004804
191#define	VMCS_GUEST_DS_LIMIT		0x00004806
192#define	VMCS_GUEST_FS_LIMIT		0x00004808
193#define	VMCS_GUEST_GS_LIMIT		0x0000480A
194#define	VMCS_GUEST_LDTR_LIMIT		0x0000480C
195#define	VMCS_GUEST_TR_LIMIT		0x0000480E
196#define	VMCS_GUEST_GDTR_LIMIT		0x00004810
197#define	VMCS_GUEST_IDTR_LIMIT		0x00004812
198#define	VMCS_GUEST_ES_ACCESS_RIGHTS	0x00004814
199#define	VMCS_GUEST_CS_ACCESS_RIGHTS	0x00004816
200#define	VMCS_GUEST_SS_ACCESS_RIGHTS	0x00004818
201#define	VMCS_GUEST_DS_ACCESS_RIGHTS	0x0000481A
202#define	VMCS_GUEST_FS_ACCESS_RIGHTS	0x0000481C
203#define	VMCS_GUEST_GS_ACCESS_RIGHTS	0x0000481E
204#define	VMCS_GUEST_LDTR_ACCESS_RIGHTS	0x00004820
205#define	VMCS_GUEST_TR_ACCESS_RIGHTS	0x00004822
206#define	VMCS_GUEST_INTERRUPTIBILITY	0x00004824
207#define	VMCS_GUEST_ACTIVITY		0x00004826
208#define VMCS_GUEST_SMBASE		0x00004828
209#define	VMCS_GUEST_IA32_SYSENTER_CS	0x0000482A
210#define	VMCS_PREEMPTION_TIMER_VALUE	0x0000482E
211
212/* 32-bit host state fields */
213#define	VMCS_HOST_IA32_SYSENTER_CS	0x00004C00
214
215/* Natural Width control fields */
216#define	VMCS_CR0_MASK			0x00006000
217#define	VMCS_CR4_MASK			0x00006002
218#define	VMCS_CR0_SHADOW			0x00006004
219#define	VMCS_CR4_SHADOW			0x00006006
220#define	VMCS_CR3_TARGET0		0x00006008
221#define	VMCS_CR3_TARGET1		0x0000600A
222#define	VMCS_CR3_TARGET2		0x0000600C
223#define	VMCS_CR3_TARGET3		0x0000600E
224
225/* Natural Width read-only fields */
226#define	VMCS_EXIT_QUALIFICATION		0x00006400
227#define	VMCS_IO_RCX			0x00006402
228#define	VMCS_IO_RSI			0x00006404
229#define	VMCS_IO_RDI			0x00006406
230#define	VMCS_IO_RIP			0x00006408
231#define	VMCS_GUEST_LINEAR_ADDRESS	0x0000640A
232
233/* Natural Width guest-state fields */
234#define	VMCS_GUEST_CR0			0x00006800
235#define	VMCS_GUEST_CR3			0x00006802
236#define	VMCS_GUEST_CR4			0x00006804
237#define	VMCS_GUEST_ES_BASE		0x00006806
238#define	VMCS_GUEST_CS_BASE		0x00006808
239#define	VMCS_GUEST_SS_BASE		0x0000680A
240#define	VMCS_GUEST_DS_BASE		0x0000680C
241#define	VMCS_GUEST_FS_BASE		0x0000680E
242#define	VMCS_GUEST_GS_BASE		0x00006810
243#define	VMCS_GUEST_LDTR_BASE		0x00006812
244#define	VMCS_GUEST_TR_BASE		0x00006814
245#define	VMCS_GUEST_GDTR_BASE		0x00006816
246#define	VMCS_GUEST_IDTR_BASE		0x00006818
247#define	VMCS_GUEST_DR7			0x0000681A
248#define	VMCS_GUEST_RSP			0x0000681C
249#define	VMCS_GUEST_RIP			0x0000681E
250#define	VMCS_GUEST_RFLAGS		0x00006820
251#define	VMCS_GUEST_PENDING_DBG_EXCEPTIONS 0x00006822
252#define	VMCS_GUEST_IA32_SYSENTER_ESP	0x00006824
253#define	VMCS_GUEST_IA32_SYSENTER_EIP	0x00006826
254
255/* Natural Width host-state fields */
256#define	VMCS_HOST_CR0			0x00006C00
257#define	VMCS_HOST_CR3			0x00006C02
258#define	VMCS_HOST_CR4			0x00006C04
259#define	VMCS_HOST_FS_BASE		0x00006C06
260#define	VMCS_HOST_GS_BASE		0x00006C08
261#define	VMCS_HOST_TR_BASE		0x00006C0A
262#define	VMCS_HOST_GDTR_BASE		0x00006C0C
263#define	VMCS_HOST_IDTR_BASE		0x00006C0E
264#define	VMCS_HOST_IA32_SYSENTER_ESP	0x00006C10
265#define	VMCS_HOST_IA32_SYSENTER_EIP	0x00006C12
266#define	VMCS_HOST_RSP			0x00006C14
267#define	VMCS_HOST_RIP			0x00006c16
268
269/*
270 * VM instruction error numbers
271 */
272#define	VMRESUME_WITH_NON_LAUNCHED_VMCS	5
273
274/*
275 * VMCS exit reasons
276 */
277#define EXIT_REASON_EXCEPTION		0
278#define EXIT_REASON_EXT_INTR		1
279#define EXIT_REASON_TRIPLE_FAULT	2
280#define EXIT_REASON_INIT		3
281#define EXIT_REASON_SIPI		4
282#define EXIT_REASON_IO_SMI		5
283#define EXIT_REASON_SMI			6
284#define EXIT_REASON_INTR_WINDOW		7
285#define EXIT_REASON_NMI_WINDOW		8
286#define EXIT_REASON_TASK_SWITCH		9
287#define EXIT_REASON_CPUID		10
288#define EXIT_REASON_GETSEC		11
289#define EXIT_REASON_HLT			12
290#define EXIT_REASON_INVD		13
291#define EXIT_REASON_INVLPG		14
292#define EXIT_REASON_RDPMC		15
293#define EXIT_REASON_RDTSC		16
294#define EXIT_REASON_RSM			17
295#define EXIT_REASON_VMCALL		18
296#define EXIT_REASON_VMCLEAR		19
297#define EXIT_REASON_VMLAUNCH		20
298#define EXIT_REASON_VMPTRLD		21
299#define EXIT_REASON_VMPTRST		22
300#define EXIT_REASON_VMREAD		23
301#define EXIT_REASON_VMRESUME		24
302#define EXIT_REASON_VMWRITE		25
303#define EXIT_REASON_VMXOFF		26
304#define EXIT_REASON_VMXON		27
305#define EXIT_REASON_CR_ACCESS		28
306#define EXIT_REASON_DR_ACCESS		29
307#define EXIT_REASON_INOUT		30
308#define EXIT_REASON_RDMSR		31
309#define EXIT_REASON_WRMSR		32
310#define EXIT_REASON_INVAL_VMCS		33
311#define EXIT_REASON_INVAL_MSR		34
312#define EXIT_REASON_MWAIT		36
313#define EXIT_REASON_MTF			37
314#define EXIT_REASON_MONITOR		39
315#define EXIT_REASON_PAUSE		40
316#define EXIT_REASON_MCE			41
317#define EXIT_REASON_TPR			43
318#define EXIT_REASON_APIC		44
319#define EXIT_REASON_GDTR_IDTR		46
320#define EXIT_REASON_LDTR_TR		47
321#define EXIT_REASON_EPT_FAULT		48
322#define EXIT_REASON_EPT_MISCONFIG	49
323#define EXIT_REASON_INVEPT		50
324#define EXIT_REASON_RDTSCP		51
325#define EXIT_REASON_VMX_PREEMPT		52
326#define EXIT_REASON_INVVPID		53
327#define EXIT_REASON_WBINVD		54
328#define EXIT_REASON_XSETBV		55
329
330/*
331 * VMCS interrupt information fields
332 */
333#define	VMCS_INTERRUPTION_INFO_VALID	(1U << 31)
334#define	VMCS_INTERRUPTION_INFO_HW_INTR	(0 << 8)
335#define	VMCS_INTERRUPTION_INFO_NMI	(2 << 8)
336
337/*
338 * VMCS IDT-Vectoring information fields
339 */
340#define	VMCS_IDT_VEC_VALID		(1U << 31)
341#define	VMCS_IDT_VEC_ERRCODE_VALID	(1 << 11)
342
343/*
344 * VMCS Guest interruptibility field
345 */
346#define	VMCS_INTERRUPTIBILITY_STI_BLOCKING	(1 << 0)
347#define	VMCS_INTERRUPTIBILITY_MOVSS_BLOCKING	(1 << 1)
348#define	VMCS_INTERRUPTIBILITY_SMI_BLOCKING	(1 << 2)
349#define	VMCS_INTERRUPTIBILITY_NMI_BLOCKING	(1 << 3)
350
351/*
352 * Exit qualification for EXIT_REASON_INVAL_VMCS
353 */
354#define	EXIT_QUAL_NMI_WHILE_STI_BLOCKING	3
355
356/*
357 * Exit qualification for EPT violation
358 */
359#define	EPT_VIOLATION_DATA_READ		(1UL << 0)
360#define	EPT_VIOLATION_DATA_WRITE	(1UL << 1)
361#define	EPT_VIOLATION_INST_FETCH	(1UL << 2)
362#define	EPT_VIOLATION_GPA_READABLE	(1UL << 3)
363#define	EPT_VIOLATION_GPA_WRITEABLE	(1UL << 4)
364#define	EPT_VIOLATION_GPA_EXECUTABLE	(1UL << 5)
365#define	EPT_VIOLATION_GLA_VALID		(1UL << 7)
366#define	EPT_VIOLATION_XLAT_VALID	(1UL << 8)
367
368#endif
369