vmm.h revision 277360
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: head/sys/amd64/include/vmm.h 277360 2015-01-19 06:53:31Z neel $
27 */
28
29#ifndef _VMM_H_
30#define	_VMM_H_
31
32#include <x86/segments.h>
33
34enum vm_suspend_how {
35	VM_SUSPEND_NONE,
36	VM_SUSPEND_RESET,
37	VM_SUSPEND_POWEROFF,
38	VM_SUSPEND_HALT,
39	VM_SUSPEND_TRIPLEFAULT,
40	VM_SUSPEND_LAST
41};
42
43/*
44 * Identifiers for architecturally defined registers.
45 */
46enum vm_reg_name {
47	VM_REG_GUEST_RAX,
48	VM_REG_GUEST_RBX,
49	VM_REG_GUEST_RCX,
50	VM_REG_GUEST_RDX,
51	VM_REG_GUEST_RSI,
52	VM_REG_GUEST_RDI,
53	VM_REG_GUEST_RBP,
54	VM_REG_GUEST_R8,
55	VM_REG_GUEST_R9,
56	VM_REG_GUEST_R10,
57	VM_REG_GUEST_R11,
58	VM_REG_GUEST_R12,
59	VM_REG_GUEST_R13,
60	VM_REG_GUEST_R14,
61	VM_REG_GUEST_R15,
62	VM_REG_GUEST_CR0,
63	VM_REG_GUEST_CR3,
64	VM_REG_GUEST_CR4,
65	VM_REG_GUEST_DR7,
66	VM_REG_GUEST_RSP,
67	VM_REG_GUEST_RIP,
68	VM_REG_GUEST_RFLAGS,
69	VM_REG_GUEST_ES,
70	VM_REG_GUEST_CS,
71	VM_REG_GUEST_SS,
72	VM_REG_GUEST_DS,
73	VM_REG_GUEST_FS,
74	VM_REG_GUEST_GS,
75	VM_REG_GUEST_LDTR,
76	VM_REG_GUEST_TR,
77	VM_REG_GUEST_IDTR,
78	VM_REG_GUEST_GDTR,
79	VM_REG_GUEST_EFER,
80	VM_REG_GUEST_CR2,
81	VM_REG_GUEST_PDPTE0,
82	VM_REG_GUEST_PDPTE1,
83	VM_REG_GUEST_PDPTE2,
84	VM_REG_GUEST_PDPTE3,
85	VM_REG_GUEST_INTR_SHADOW,
86	VM_REG_LAST
87};
88
89enum x2apic_state {
90	X2APIC_DISABLED,
91	X2APIC_ENABLED,
92	X2APIC_STATE_LAST
93};
94
95#define	VM_INTINFO_VECTOR(info)	((info) & 0xff)
96#define	VM_INTINFO_DEL_ERRCODE	0x800
97#define	VM_INTINFO_RSVD		0x7ffff000
98#define	VM_INTINFO_VALID	0x80000000
99#define	VM_INTINFO_TYPE		0x700
100#define	VM_INTINFO_HWINTR	(0 << 8)
101#define	VM_INTINFO_NMI		(2 << 8)
102#define	VM_INTINFO_HWEXCEPTION	(3 << 8)
103#define	VM_INTINFO_SWINTR	(4 << 8)
104
105#ifdef _KERNEL
106
107#define	VM_MAX_NAMELEN	32
108
109struct vm;
110struct vm_exception;
111struct vm_memory_segment;
112struct seg_desc;
113struct vm_exit;
114struct vm_run;
115struct vhpet;
116struct vioapic;
117struct vlapic;
118struct vmspace;
119struct vm_object;
120struct vm_guest_paging;
121struct pmap;
122
123typedef int	(*vmm_init_func_t)(int ipinum);
124typedef int	(*vmm_cleanup_func_t)(void);
125typedef void	(*vmm_resume_func_t)(void);
126typedef void *	(*vmi_init_func_t)(struct vm *vm, struct pmap *pmap);
127typedef int	(*vmi_run_func_t)(void *vmi, int vcpu, register_t rip,
128				  struct pmap *pmap, void *rendezvous_cookie,
129				  void *suspend_cookie);
130typedef void	(*vmi_cleanup_func_t)(void *vmi);
131typedef int	(*vmi_get_register_t)(void *vmi, int vcpu, int num,
132				      uint64_t *retval);
133typedef int	(*vmi_set_register_t)(void *vmi, int vcpu, int num,
134				      uint64_t val);
135typedef int	(*vmi_get_desc_t)(void *vmi, int vcpu, int num,
136				  struct seg_desc *desc);
137typedef int	(*vmi_set_desc_t)(void *vmi, int vcpu, int num,
138				  struct seg_desc *desc);
139typedef int	(*vmi_get_cap_t)(void *vmi, int vcpu, int num, int *retval);
140typedef int	(*vmi_set_cap_t)(void *vmi, int vcpu, int num, int val);
141typedef struct vmspace * (*vmi_vmspace_alloc)(vm_offset_t min, vm_offset_t max);
142typedef void	(*vmi_vmspace_free)(struct vmspace *vmspace);
143typedef struct vlapic * (*vmi_vlapic_init)(void *vmi, int vcpu);
144typedef void	(*vmi_vlapic_cleanup)(void *vmi, struct vlapic *vlapic);
145
146struct vmm_ops {
147	vmm_init_func_t		init;		/* module wide initialization */
148	vmm_cleanup_func_t	cleanup;
149	vmm_resume_func_t	resume;
150
151	vmi_init_func_t		vminit;		/* vm-specific initialization */
152	vmi_run_func_t		vmrun;
153	vmi_cleanup_func_t	vmcleanup;
154	vmi_get_register_t	vmgetreg;
155	vmi_set_register_t	vmsetreg;
156	vmi_get_desc_t		vmgetdesc;
157	vmi_set_desc_t		vmsetdesc;
158	vmi_get_cap_t		vmgetcap;
159	vmi_set_cap_t		vmsetcap;
160	vmi_vmspace_alloc	vmspace_alloc;
161	vmi_vmspace_free	vmspace_free;
162	vmi_vlapic_init		vlapic_init;
163	vmi_vlapic_cleanup	vlapic_cleanup;
164};
165
166extern struct vmm_ops vmm_ops_intel;
167extern struct vmm_ops vmm_ops_amd;
168
169int vm_create(const char *name, struct vm **retvm);
170void vm_destroy(struct vm *vm);
171int vm_reinit(struct vm *vm);
172const char *vm_name(struct vm *vm);
173int vm_malloc(struct vm *vm, vm_paddr_t gpa, size_t len);
174int vm_map_mmio(struct vm *vm, vm_paddr_t gpa, size_t len, vm_paddr_t hpa);
175int vm_unmap_mmio(struct vm *vm, vm_paddr_t gpa, size_t len);
176void *vm_gpa_hold(struct vm *, vm_paddr_t gpa, size_t len, int prot,
177		  void **cookie);
178void vm_gpa_release(void *cookie);
179int vm_gpabase2memseg(struct vm *vm, vm_paddr_t gpabase,
180	      struct vm_memory_segment *seg);
181int vm_get_memobj(struct vm *vm, vm_paddr_t gpa, size_t len,
182		  vm_offset_t *offset, struct vm_object **object);
183boolean_t vm_mem_allocated(struct vm *vm, vm_paddr_t gpa);
184int vm_get_register(struct vm *vm, int vcpu, int reg, uint64_t *retval);
185int vm_set_register(struct vm *vm, int vcpu, int reg, uint64_t val);
186int vm_get_seg_desc(struct vm *vm, int vcpu, int reg,
187		    struct seg_desc *ret_desc);
188int vm_set_seg_desc(struct vm *vm, int vcpu, int reg,
189		    struct seg_desc *desc);
190int vm_run(struct vm *vm, struct vm_run *vmrun);
191int vm_suspend(struct vm *vm, enum vm_suspend_how how);
192int vm_inject_nmi(struct vm *vm, int vcpu);
193int vm_nmi_pending(struct vm *vm, int vcpuid);
194void vm_nmi_clear(struct vm *vm, int vcpuid);
195int vm_inject_extint(struct vm *vm, int vcpu);
196int vm_extint_pending(struct vm *vm, int vcpuid);
197void vm_extint_clear(struct vm *vm, int vcpuid);
198struct vlapic *vm_lapic(struct vm *vm, int cpu);
199struct vioapic *vm_ioapic(struct vm *vm);
200struct vhpet *vm_hpet(struct vm *vm);
201int vm_get_capability(struct vm *vm, int vcpu, int type, int *val);
202int vm_set_capability(struct vm *vm, int vcpu, int type, int val);
203int vm_get_x2apic_state(struct vm *vm, int vcpu, enum x2apic_state *state);
204int vm_set_x2apic_state(struct vm *vm, int vcpu, enum x2apic_state state);
205int vm_apicid2vcpuid(struct vm *vm, int apicid);
206int vm_activate_cpu(struct vm *vm, int vcpu);
207cpuset_t vm_active_cpus(struct vm *vm);
208cpuset_t vm_suspended_cpus(struct vm *vm);
209struct vm_exit *vm_exitinfo(struct vm *vm, int vcpuid);
210void vm_exit_suspended(struct vm *vm, int vcpuid, uint64_t rip);
211void vm_exit_rendezvous(struct vm *vm, int vcpuid, uint64_t rip);
212void vm_exit_astpending(struct vm *vm, int vcpuid, uint64_t rip);
213
214/*
215 * Rendezvous all vcpus specified in 'dest' and execute 'func(arg)'.
216 * The rendezvous 'func(arg)' is not allowed to do anything that will
217 * cause the thread to be put to sleep.
218 *
219 * If the rendezvous is being initiated from a vcpu context then the
220 * 'vcpuid' must refer to that vcpu, otherwise it should be set to -1.
221 *
222 * The caller cannot hold any locks when initiating the rendezvous.
223 *
224 * The implementation of this API may cause vcpus other than those specified
225 * by 'dest' to be stalled. The caller should not rely on any vcpus making
226 * forward progress when the rendezvous is in progress.
227 */
228typedef void (*vm_rendezvous_func_t)(struct vm *vm, int vcpuid, void *arg);
229void vm_smp_rendezvous(struct vm *vm, int vcpuid, cpuset_t dest,
230    vm_rendezvous_func_t func, void *arg);
231
232static __inline int
233vcpu_rendezvous_pending(void *rendezvous_cookie)
234{
235
236	return (*(uintptr_t *)rendezvous_cookie != 0);
237}
238
239static __inline int
240vcpu_suspended(void *suspend_cookie)
241{
242
243	return (*(int *)suspend_cookie);
244}
245
246/*
247 * Return 1 if device indicated by bus/slot/func is supposed to be a
248 * pci passthrough device.
249 *
250 * Return 0 otherwise.
251 */
252int vmm_is_pptdev(int bus, int slot, int func);
253
254void *vm_iommu_domain(struct vm *vm);
255
256enum vcpu_state {
257	VCPU_IDLE,
258	VCPU_FROZEN,
259	VCPU_RUNNING,
260	VCPU_SLEEPING,
261};
262
263int vcpu_set_state(struct vm *vm, int vcpu, enum vcpu_state state,
264    bool from_idle);
265enum vcpu_state vcpu_get_state(struct vm *vm, int vcpu, int *hostcpu);
266
267static int __inline
268vcpu_is_running(struct vm *vm, int vcpu, int *hostcpu)
269{
270	return (vcpu_get_state(vm, vcpu, hostcpu) == VCPU_RUNNING);
271}
272
273#ifdef _SYS_PROC_H_
274static int __inline
275vcpu_should_yield(struct vm *vm, int vcpu)
276{
277	return (curthread->td_flags & (TDF_ASTPENDING | TDF_NEEDRESCHED));
278}
279#endif
280
281void *vcpu_stats(struct vm *vm, int vcpu);
282void vcpu_notify_event(struct vm *vm, int vcpuid, bool lapic_intr);
283struct vmspace *vm_get_vmspace(struct vm *vm);
284int vm_assign_pptdev(struct vm *vm, int bus, int slot, int func);
285int vm_unassign_pptdev(struct vm *vm, int bus, int slot, int func);
286struct vatpic *vm_atpic(struct vm *vm);
287struct vatpit *vm_atpit(struct vm *vm);
288struct vpmtmr *vm_pmtmr(struct vm *vm);
289struct vrtc *vm_rtc(struct vm *vm);
290
291/*
292 * Inject exception 'vector' into the guest vcpu. This function returns 0 on
293 * success and non-zero on failure.
294 *
295 * Wrapper functions like 'vm_inject_gp()' should be preferred to calling
296 * this function directly because they enforce the trap-like or fault-like
297 * behavior of an exception.
298 *
299 * This function should only be called in the context of the thread that is
300 * executing this vcpu.
301 */
302int vm_inject_exception(struct vm *vm, int vcpuid, int vector, int err_valid,
303    uint32_t errcode, int restart_instruction);
304
305/*
306 * This function is called after a VM-exit that occurred during exception or
307 * interrupt delivery through the IDT. The format of 'intinfo' is described
308 * in Figure 15-1, "EXITINTINFO for All Intercepts", APM, Vol 2.
309 *
310 * If a VM-exit handler completes the event delivery successfully then it
311 * should call vm_exit_intinfo() to extinguish the pending event. For e.g.,
312 * if the task switch emulation is triggered via a task gate then it should
313 * call this function with 'intinfo=0' to indicate that the external event
314 * is not pending anymore.
315 *
316 * Return value is 0 on success and non-zero on failure.
317 */
318int vm_exit_intinfo(struct vm *vm, int vcpuid, uint64_t intinfo);
319
320/*
321 * This function is called before every VM-entry to retrieve a pending
322 * event that should be injected into the guest. This function combines
323 * nested events into a double or triple fault.
324 *
325 * Returns 0 if there are no events that need to be injected into the guest
326 * and non-zero otherwise.
327 */
328int vm_entry_intinfo(struct vm *vm, int vcpuid, uint64_t *info);
329
330int vm_get_intinfo(struct vm *vm, int vcpuid, uint64_t *info1, uint64_t *info2);
331
332enum vm_reg_name vm_segment_name(int seg_encoding);
333
334struct vm_copyinfo {
335	uint64_t	gpa;
336	size_t		len;
337	void		*hva;
338	void		*cookie;
339};
340
341/*
342 * Set up 'copyinfo[]' to copy to/from guest linear address space starting
343 * at 'gla' and 'len' bytes long. The 'prot' should be set to PROT_READ for
344 * a copyin or PROT_WRITE for a copyout.
345 *
346 * Returns 0 on success.
347 * Returns 1 if an exception was injected into the guest.
348 * Returns -1 otherwise.
349 *
350 * The 'copyinfo[]' can be passed to 'vm_copyin()' or 'vm_copyout()' only if
351 * the return value is 0. The 'copyinfo[]' resources should be freed by calling
352 * 'vm_copy_teardown()' after the copy is done.
353 */
354int vm_copy_setup(struct vm *vm, int vcpuid, struct vm_guest_paging *paging,
355    uint64_t gla, size_t len, int prot, struct vm_copyinfo *copyinfo,
356    int num_copyinfo);
357void vm_copy_teardown(struct vm *vm, int vcpuid, struct vm_copyinfo *copyinfo,
358    int num_copyinfo);
359void vm_copyin(struct vm *vm, int vcpuid, struct vm_copyinfo *copyinfo,
360    void *kaddr, size_t len);
361void vm_copyout(struct vm *vm, int vcpuid, const void *kaddr,
362    struct vm_copyinfo *copyinfo, size_t len);
363
364int vcpu_trace_exceptions(struct vm *vm, int vcpuid);
365#endif	/* KERNEL */
366
367#define	VM_MAXCPU	16			/* maximum virtual cpus */
368
369/*
370 * Identifiers for optional vmm capabilities
371 */
372enum vm_cap_type {
373	VM_CAP_HALT_EXIT,
374	VM_CAP_MTRAP_EXIT,
375	VM_CAP_PAUSE_EXIT,
376	VM_CAP_UNRESTRICTED_GUEST,
377	VM_CAP_ENABLE_INVPCID,
378	VM_CAP_MAX
379};
380
381enum vm_intr_trigger {
382	EDGE_TRIGGER,
383	LEVEL_TRIGGER
384};
385
386/*
387 * The 'access' field has the format specified in Table 21-2 of the Intel
388 * Architecture Manual vol 3b.
389 *
390 * XXX The contents of the 'access' field are architecturally defined except
391 * bit 16 - Segment Unusable.
392 */
393struct seg_desc {
394	uint64_t	base;
395	uint32_t	limit;
396	uint32_t	access;
397};
398#define	SEG_DESC_TYPE(access)		((access) & 0x001f)
399#define	SEG_DESC_DPL(access)		(((access) >> 5) & 0x3)
400#define	SEG_DESC_PRESENT(access)	(((access) & 0x0080) ? 1 : 0)
401#define	SEG_DESC_DEF32(access)		(((access) & 0x4000) ? 1 : 0)
402#define	SEG_DESC_GRANULARITY(access)	(((access) & 0x8000) ? 1 : 0)
403#define	SEG_DESC_UNUSABLE(access)	(((access) & 0x10000) ? 1 : 0)
404
405enum vm_cpu_mode {
406	CPU_MODE_REAL,
407	CPU_MODE_PROTECTED,
408	CPU_MODE_COMPATIBILITY,		/* IA-32E mode (CS.L = 0) */
409	CPU_MODE_64BIT,			/* IA-32E mode (CS.L = 1) */
410};
411
412enum vm_paging_mode {
413	PAGING_MODE_FLAT,
414	PAGING_MODE_32,
415	PAGING_MODE_PAE,
416	PAGING_MODE_64,
417};
418
419struct vm_guest_paging {
420	uint64_t	cr3;
421	int		cpl;
422	enum vm_cpu_mode cpu_mode;
423	enum vm_paging_mode paging_mode;
424};
425
426/*
427 * The data structures 'vie' and 'vie_op' are meant to be opaque to the
428 * consumers of instruction decoding. The only reason why their contents
429 * need to be exposed is because they are part of the 'vm_exit' structure.
430 */
431struct vie_op {
432	uint8_t		op_byte;	/* actual opcode byte */
433	uint8_t		op_type;	/* type of operation (e.g. MOV) */
434	uint16_t	op_flags;
435};
436
437#define	VIE_INST_SIZE	15
438struct vie {
439	uint8_t		inst[VIE_INST_SIZE];	/* instruction bytes */
440	uint8_t		num_valid;		/* size of the instruction */
441	uint8_t		num_processed;
442
443	uint8_t		addrsize:4, opsize:4;	/* address and operand sizes */
444	uint8_t		rex_w:1,		/* REX prefix */
445			rex_r:1,
446			rex_x:1,
447			rex_b:1,
448			rex_present:1,
449			repz_present:1,		/* REP/REPE/REPZ prefix */
450			repnz_present:1,	/* REPNE/REPNZ prefix */
451			opsize_override:1,	/* Operand size override */
452			addrsize_override:1,	/* Address size override */
453			segment_override:1;	/* Segment override */
454
455	uint8_t		mod:2,			/* ModRM byte */
456			reg:4,
457			rm:4;
458
459	uint8_t		ss:2,			/* SIB byte */
460			index:4,
461			base:4;
462
463	uint8_t		disp_bytes;
464	uint8_t		imm_bytes;
465
466	uint8_t		scale;
467	int		base_register;		/* VM_REG_GUEST_xyz */
468	int		index_register;		/* VM_REG_GUEST_xyz */
469	int		segment_register;	/* VM_REG_GUEST_xyz */
470
471	int64_t		displacement;		/* optional addr displacement */
472	int64_t		immediate;		/* optional immediate operand */
473
474	uint8_t		decoded;	/* set to 1 if successfully decoded */
475
476	struct vie_op	op;			/* opcode description */
477};
478
479enum vm_exitcode {
480	VM_EXITCODE_INOUT,
481	VM_EXITCODE_VMX,
482	VM_EXITCODE_BOGUS,
483	VM_EXITCODE_RDMSR,
484	VM_EXITCODE_WRMSR,
485	VM_EXITCODE_HLT,
486	VM_EXITCODE_MTRAP,
487	VM_EXITCODE_PAUSE,
488	VM_EXITCODE_PAGING,
489	VM_EXITCODE_INST_EMUL,
490	VM_EXITCODE_SPINUP_AP,
491	VM_EXITCODE_DEPRECATED1,	/* used to be SPINDOWN_CPU */
492	VM_EXITCODE_RENDEZVOUS,
493	VM_EXITCODE_IOAPIC_EOI,
494	VM_EXITCODE_SUSPENDED,
495	VM_EXITCODE_INOUT_STR,
496	VM_EXITCODE_TASK_SWITCH,
497	VM_EXITCODE_MONITOR,
498	VM_EXITCODE_MWAIT,
499	VM_EXITCODE_SVM,
500	VM_EXITCODE_MAX
501};
502
503struct vm_inout {
504	uint16_t	bytes:3;	/* 1 or 2 or 4 */
505	uint16_t	in:1;
506	uint16_t	string:1;
507	uint16_t	rep:1;
508	uint16_t	port;
509	uint32_t	eax;		/* valid for out */
510};
511
512struct vm_inout_str {
513	struct vm_inout	inout;		/* must be the first element */
514	struct vm_guest_paging paging;
515	uint64_t	rflags;
516	uint64_t	cr0;
517	uint64_t	index;
518	uint64_t	count;		/* rep=1 (%rcx), rep=0 (1) */
519	int		addrsize;
520	enum vm_reg_name seg_name;
521	struct seg_desc seg_desc;
522};
523
524enum task_switch_reason {
525	TSR_CALL,
526	TSR_IRET,
527	TSR_JMP,
528	TSR_IDT_GATE,	/* task gate in IDT */
529};
530
531struct vm_task_switch {
532	uint16_t	tsssel;		/* new TSS selector */
533	int		ext;		/* task switch due to external event */
534	uint32_t	errcode;
535	int		errcode_valid;	/* push 'errcode' on the new stack */
536	enum task_switch_reason reason;
537	struct vm_guest_paging paging;
538};
539
540struct vm_exit {
541	enum vm_exitcode	exitcode;
542	int			inst_length;	/* 0 means unknown */
543	uint64_t		rip;
544	union {
545		struct vm_inout	inout;
546		struct vm_inout_str inout_str;
547		struct {
548			uint64_t	gpa;
549			int		fault_type;
550		} paging;
551		struct {
552			uint64_t	gpa;
553			uint64_t	gla;
554			int		cs_d;		/* CS.D */
555			struct vm_guest_paging paging;
556			struct vie	vie;
557		} inst_emul;
558		/*
559		 * VMX specific payload. Used when there is no "better"
560		 * exitcode to represent the VM-exit.
561		 */
562		struct {
563			int		status;		/* vmx inst status */
564			/*
565			 * 'exit_reason' and 'exit_qualification' are valid
566			 * only if 'status' is zero.
567			 */
568			uint32_t	exit_reason;
569			uint64_t	exit_qualification;
570			/*
571			 * 'inst_error' and 'inst_type' are valid
572			 * only if 'status' is non-zero.
573			 */
574			int		inst_type;
575			int		inst_error;
576		} vmx;
577		/*
578		 * SVM specific payload.
579		 */
580		struct {
581			uint64_t	exitcode;
582			uint64_t	exitinfo1;
583			uint64_t	exitinfo2;
584		} svm;
585		struct {
586			uint32_t	code;		/* ecx value */
587			uint64_t	wval;
588		} msr;
589		struct {
590			int		vcpu;
591			uint64_t	rip;
592		} spinup_ap;
593		struct {
594			uint64_t	rflags;
595		} hlt;
596		struct {
597			int		vector;
598		} ioapic_eoi;
599		struct {
600			enum vm_suspend_how how;
601		} suspended;
602		struct vm_task_switch task_switch;
603	} u;
604};
605
606/* APIs to inject faults into the guest */
607void vm_inject_fault(void *vm, int vcpuid, int vector, int errcode_valid,
608    int errcode);
609
610static __inline void
611vm_inject_ud(void *vm, int vcpuid)
612{
613	vm_inject_fault(vm, vcpuid, IDT_UD, 0, 0);
614}
615
616static __inline void
617vm_inject_gp(void *vm, int vcpuid)
618{
619	vm_inject_fault(vm, vcpuid, IDT_GP, 1, 0);
620}
621
622static __inline void
623vm_inject_ac(void *vm, int vcpuid, int errcode)
624{
625	vm_inject_fault(vm, vcpuid, IDT_AC, 1, errcode);
626}
627
628static __inline void
629vm_inject_ss(void *vm, int vcpuid, int errcode)
630{
631	vm_inject_fault(vm, vcpuid, IDT_SS, 1, errcode);
632}
633
634void vm_inject_pf(void *vm, int vcpuid, int error_code, uint64_t cr2);
635
636int vm_restart_instruction(void *vm, int vcpuid);
637
638#endif	/* _VMM_H_ */
639